MenuLiteral Element (Data) - Revision history

Colen: /* The "menu_literal" Element */

2013-12-20T05:53:17Z

The "menu_literal" Element

← Older revision		Revision as of 05:53, 20 December 2013
Line 14:		Line 14:
	\|allowuservalue		\|allowuservalue
	\|(Optional) Boolean – Indicates whether the user is allowed to type in a custom value for use within the menu. If the user does this, the value saved for the menu is simply the text entered by the user. Default: "no".		\|(Optional) Boolean – Indicates whether the user is allowed to type in a custom value for use within the menu. If the user does this, the value saved for the menu is simply the text entered by the user. Default: "no".
			\|-
			\|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:00, 2 December 2008

2008-12-02T21:00:41Z

← Older revision		Revision as of 21:00, 2 December 2008
Line 22:		Line 22:
	\|class="leftnormal"\|[[#choice\|choice]]		\|class="leftnormal"\|[[#choice\|choice]]
	\|One or more "choice" elements must appear as defined by the given link. This element defines the individual options that the user can select from.		\|One or more "choice" elements must appear as defined by the given link. This element defines the individual options that the user can select from.
	\|-
	~~\|[[#change\|change]]~~
	~~\|An optional "change" element may appear as defined by the given link. This element defines a [[Change Script]] for the portal.~~
	\|-		\|-
	\|}		\|}
Line 38:		Line 35:
	\|value		\|value
	\|(Optional) Text – Specifies the text to be tracked internally for this choice. When the user selects the choice, the value is saved into the associated field. If empty, the "display" text is used as the value. If the field used by the menu is value-based, all "value" attributes must be numeric values. Default: Empty.		\|(Optional) Text – Specifies the text to be tracked internally for this choice. When the user selects the choice, the value is saved into the associated field. If empty, the "display" text is used as the value. If the field used by the menu is value-based, all "value" attributes must be numeric values. Default: Empty.
	\|-
	\|}

	~~==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.~~
	\|-		\|-
	\|}		\|}

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

2008-12-02T20:59:51Z

The "choice" Element{{anchor|choice}}

← Older revision		Revision as of 20:59, 2 December 2008
Line 30:		Line 30:
	==The "choice" Element{{anchor\|choice}}==		==The "choice" Element{{anchor\|choice}}==

	The "choice" element defines an option that is listed within the menu for the user to select. Each choice has two facets: the value shown to the user and the value used internally. The complete list of attributes for this element is below.		The "choice" element defines an option that is listed within the menu for the user to select. Each choice has two facets: the value shown to the user and the value used internally. The sequence in which these elements is defined dictates the sequence in which they will be listed for the user. The complete list of attributes for this element is below.

	:{\| class="infotable"		:{\| class="infotable"

Rob: /* The "menu_literal" Element */

2008-12-02T07:21:21Z

The "menu_literal" Element

← Older revision		Revision as of 07:21, 2 December 2008
Line 17:		Line 17:
	\|}		\|}

	The "menu_literal" element also possesses child elements that define ~~additional~~ 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.		The "menu_literal" 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="infotable"

Rob at 07:19, 2 December 2008

2008-12-02T07:19:57Z

← Older revision		Revision as of 07:19, 2 December 2008
Line 7:		Line 7:
	:{\| class="infotable"		:{\| class="infotable"
	\|class="leftnormal"\|field		\|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 ~~value~~-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.		\|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.
	\|-		\|-
	\|maxvisible		\|maxvisible

Rob at 04:18, 2 December 2008

2008-12-02T04:18:02Z

@@ Line 11: / Line 11: @@
 |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_literal" Element== Menus are useful whenever you need the user to select exactly one item from a collectio...

2008-12-02T03:45:42Z

New page: {{context|Kit Reference|Data File Reference|Portal Element (Data)}} ==The "menu_literal" Element== Menus are useful whenever you need the user to select exactly one item from a collectio...

New page

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

==The "menu_literal" Element==

Menus are useful whenever you need the user to select exactly one item from a collection of options. The role of the "menu_literal" element is to allow you to specify a fixed set of options to choose from. An classic example is the selection of gender on the "Personal" tab, where a menu allows the user to select either male or female. 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 value-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.
|-
|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".
|-
|}

==Example==

The following example demonstrates what a literal menu portal might look like. All default values are assumed for optional attributes.

<pre>
<portal id="gender" style="menuNormal">
<menu_literal field="perGender">
<choice value="0" display="Gender: Male"/>
<choice value="1" display="Gender: Female"/>
</menu_literal>
</portal>
</pre>