Layout Element (Data) - Revision history

Colen: /* The "templateref" Element{{anchor|templateref}} */

2011-03-08T17:15:28Z

The "templateref" Element{{anchor|templateref}}

← Older revision		Revision as of 17:15, 8 March 2011
Line 73:		Line 73:
	\|thing		\|thing
	\|(Optional) Id – Specifies the unique id of the thing or pick that is associated with this template. The given object is used with the template when determining the contents of fields and such. If empty, no thing/pick is associated with the template, which means that the template cannot contain any portals that utilize a field reference. Default: Empty.		\|(Optional) Id – Specifies the unique id of the thing or pick that is associated with this template. The given object is used with the template when determining the contents of fields and such. If empty, no thing/pick is associated with the template, which means that the template cannot contain any portals that utilize a field reference. Default: Empty.
			\|-
			\|dynamic
			\|(Optional) Boolean – Instead of specifying a thing, you can flag a template as "dynamic". This means that instead of using a specific pick, the template uses the "dynamic pick" to as its context, for determining field contents and so on. The dynamic pick is only set if the layout is used on a form that's summoned via a pick (usually by clicking a button on a template for that pick); it is set to the pick from which the form was summoned. Default: "no".
	\|-		\|-
	\|ispick		\|ispick

Rob: /* The "live" Element{{anchor|live}} */

2008-12-04T09:38:42Z

The "live" Element{{anchor|live}}

← Older revision		Revision as of 09:38, 4 December 2008
Line 40:		Line 40:
	:{\| class="infotable"		:{\| class="infotable"
	\|class="leftnormal"\|PCDATA		\|class="leftnormal"\|PCDATA
	\|~~Script~~ – Specifies the code comprising the Live tag expression.		\|TagExpr – Specifies the code comprising the Live tag expression.
	\|-		\|-
	\|}		\|}

Rob at 11:12, 3 December 2008

2008-12-03T11:12:29Z

← Older revision		Revision as of 11:12, 3 December 2008
Line 70:		Line 70:
	\|reference		\|reference
	\|(Optional) Id – Specifies the alternate unique id to be used when referencing this template within the Position script. This makes it possible to re-use the same template more than once within the same layout, giving each instance a different logical id. If empty, the reference id is simply the template id. Default: Empty.		\|(Optional) Id – Specifies the alternate unique id to be used when referencing this template within the Position script. This makes it possible to re-use the same template more than once within the same layout, giving each instance a different logical id. If empty, the reference id is simply the template id. Default: Empty.
			\|-
			\|thing
			\|(Optional) Id – Specifies the unique id of the thing or pick that is associated with this template. The given object is used with the template when determining the contents of fields and such. If empty, no thing/pick is associated with the template, which means that the template cannot contain any portals that utilize a field reference. Default: Empty.
			\|-
			\|ispick
			\|(Optional) Boolean – Indicates whether the template is associated with a pick or a thing. If a pick, the first pick within the container that based on the specified thing is used. Default: "yes".
	\|-		\|-
	\|taborder		\|taborder

Rob at 10:44, 3 December 2008

2008-12-03T10:44:13Z

@@ Line 41: / Line 41: @@
 |class="leftnormal"|PCDATA
 |Script – Specifies the code comprising the Live tag expression.
 |-
 |}

Rob: New page: {{context|Kit Reference|Data File Reference}} ==The "layout" Element== Layouts contain an assortment of portals and templates that serve a unified purpose when presenting information...

2008-12-03T10:35:38Z

New page: {{context|Kit Reference|Data File Reference}} ==The "layout" Element== Layouts contain an assortment of portals and templates that serve a unified purpose when presenting information...

New page

{{context|Kit Reference|Data File Reference}}

==The "layout" Element==

[[Layouts]] contain an assortment of portals and templates that serve a unified purpose when presenting information to the user. Each layout is specified through the use of a "layout" element. The complete list of attributes for this element is below.

:{| class="infotable"
|class="leftnormal"|id
|Id – Specifies the unique id of the layout. This id is used in all references to the layout.
|-
|marginhorz
|(Optional) Integer – Specifies the margin gap included at both ends along the horizontal axis. The usable width of the layout is the actual width minus double the horizontal margin. Default: "0".
|-
|marginvert
|(Optional) Integer – Specifies the margin gap included at both ends along the vertical axis. The usable height of the layout is the actual height minus double the vertical margin. Default: "0".
|-
|}

The "layout" element also possesses child elements that define various facets of the layout. The list of these child elements is below and must appear in the order shown. Click on the link to access the details for each element.

:{| class="infotable"
|class="leftnormal"|[[#live|live]]
|An optional "live" element may appear as defined by the given link. This element defines a [[Live Tag Expression]] that determines whether the template is shown to the user.
|-
|[[#portalref|portalref]]
|Zero or more "portalref" elements may appear as defined by the given link. This element specifies the individual portals which are utilized within the layout.
|-
|[[#templateref|templateref]]
|Zero or more "templateref" elements may appear as defined by the given link. This element specifies the individual templates which are utilized within the layout.
|-
|[[#position|position]]
|An optional "position" element may appear as defined by the given link. This element defines a [[Position Script]] through which the portals are sized and positioned within the template.
|-
|}

==The "live" Element{{anchor|live}}==

The "live" element defines a [[Live Tag Expression]] for the layout, which determines whether the layout is shown. The tag expression is compared against the tags assigned to the container associated with the layout (e.g. the actor). If the tag expression is satisfied, the layout is visible, else it is hidden. The complete list of attributes for this element is below.

:{| class="infotable"
|class="leftnormal"|PCDATA
|Script – Specifies the code comprising the Live tag expression.
|-
|}

==The "position" Element{{anchor|position}}==

The "position" element defines a [[Position Script]] for the layout, which performs all the appropriate sizing and positioning of the contained portals and templates within the region of the layout. The complete list of attributes for this element is below.

:{| class="infotable"
|class="leftnormal"|PCDATA
|Script – Specifies the code comprising the Position script.
|-
|}

==Example==

The following example demonstrates what a "layout" element might look like. All default values are assumed for optional attributes.

<pre>
<layout id="journal">
<portalref portal="jrTitle"/>
<portalref portal="journal" taborder="10"/>
<templateref template="jrHeader" thing="actor"/>
<position>
~configure whether our header is visible or not
~Note: If the header is non-visible, no space is allotted for it below.
template[jrHeader].visible = 1

~position the title at the top, followed by the template, and then the table
perform portal[jrTitle].autoplace
perform template[jrHeader].autoplace[6]
perform portal[journal].autoplace[9]
</position>
</layout>
</pre>