MenuArray Element (Data) - Revision history

Colen: /* The "menu_array" Element */

2013-12-20T05:53:39Z

The "menu_array" Element

← Older revision		Revision as of 05:53, 20 December 2013
Line 14:		Line 14:
	\|maxvisible		\|maxvisible
	\|(Optional) Integer – Specifies the maximum number of items that will be visible at one time within the menu when the user opens it for selection. If there are more items to choose from, a scroller will allow the user to access them. Default: "5".		\|(Optional) Integer – Specifies the maximum number of items that will be visible at one time within the menu when the user opens it for selection. If there are more items to choose from, a scroller will allow the user to access them. Default: "5".
			\|-
			\|showlabel
			\|(Optional) Boolean – (iPad only) Indicates whether the label displaying the current selection of the menu should be shown. This is used when you just want the menu control to be used as a button to make a selection which will be displayed some other way. Default: "yes".
	\|-		\|-
	\|}		\|}

Rob at 21:01, 2 December 2008

2008-12-02T21:01:24Z

@@ Line 14: / Line 14: @@
 |maxvisible
 |(Optional) Integer – Specifies the maximum number of items that will be visible at one time within the menu when the user opens it for selection. If there are more items to choose from, a scroller will allow the user to access them. Default: "5".
 |-
 |}

Rob: New page: {{context|Kit Reference|Data File Reference|Portal Element (Data)}} ==The "menu_array" Element== The "menu_array" element allows you to create a menu whose options are dynamically determ...

2008-12-02T07:25:38Z

New page: {{context|Kit Reference|Data File Reference|Portal Element (Data)}} ==The "menu_array" Element== The "menu_array" element allows you to create a menu whose options are dynamically determ...

New page

{{context|Kit Reference|Data File Reference|Portal Element (Data)}}

==The "menu_array" Element==

The "menu_array" element allows you to create a menu whose options are dynamically determined via scripts. These scripts setup the contents of the array that dictates the available options. The complete list of attributes for this element is below.

:{| class="infotable"
|class="leftnormal"|field
|Id – Specifies the unique id of the field whose contents reflect the current selection from the menu. The field must be a text-based field and must exist within the pick/thing associated with the containing template. If this portal is not defined within a template, a menu is not allowed.
|-
|array
|Boolean – Specifies the unique id of the array-based field to be used to drive the available options. The field must be text-based, must be an array, and must exist within the pick/thing associated with the containing template.
|-
|maxvisible
|(Optional) Integer – Specifies the maximum number of items that will be visible at one time within the menu when the user opens it for selection. If there are more items to choose from, a scroller will allow the user to access them. Default: "5".
|-
|}

The "menu_array" element also possesses child elements that define additional facets of the portal. 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"|[[#change|change]]
|An optional "change" element may appear as defined by the given link. This element defines a [[Change Script]] for the portal.
|-
|}

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

The "change" element defines a [[Change Script]] for the portal that is invoked whenever the user selects a new choice from the list of options. This script allows the implications of the new selection to be integrated and the display updated. The complete list of attributes for this element is below.

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

==Example==

The following example demonstrates what an array-based menu portal might look like. All default values are assumed for optional attributes.

<pre>
<portal id="menutext" style="Menu" width="150">
<menu_array field="pwmTextSel" array="pwmList" maxvisible="9"/>
</portal>
</pre>