$Web_Sel

From m204wiki
Revision as of 21:38, 21 February 2011 by Admin (talk | contribs) (1 revision)
Jump to navigation Jump to search

<section begin="desc" />Build select options from global select element, selected is string<section end="desc" />


$Web_Sel inserts into the Web output stream the options list of an HTML<select> element. The options list is taken from a global select element created by $WEB_SAVE_SEL, and the selected option (that is, the one that is highlighted on the HTML page) is specified by a character string. An overview of the $WEB_SEL_x functions is provided in $Web_Selp.

Syntax

<section begin="syntax" /> %RC = $Web_Sel(global_name, selected_value, - option_keywords) <section end="syntax" />


$Web_Sel is a callable $function (see Calling Sirius Mods $functions).

$Web_Sel takes three arguments and returns a string; for some types of errors, the current User Language request is cancelled.




global_name The name of the global select element containing the values and descriptions for the options list. The global select element with this name must have been created by $Web_Save_Sel. This is a required argument.
selected_value A string which, if equal to one of the values in the options list, specifies the item that is selected in the displayed options list. This does not allow multiple item selection in a <select&thinsp.multiple> element. This an optional argument. If this argument is omitted, or if the string is not equal to the value of any of the options in the global select element, then none of the <option> elements in the list contain the selected attribute. As explained in $Web_Selp, the default selected option depends on the type of <select> element: <select&thinsp.multiple> has no default; for non-multiple, the first item in the options list is the default selected element.
option_keywords
A string of blank-separated keywords specifying special processing for this $function. Any of the following is valid:
NOCAN Don't cancel request if global_name not found
NOENDSEL Don't end list of options with </select>
NOENDS Synonym for NOENDSEL
ENDOPT End each option with </option>


This an optional argument.

specified.
Code Meaning
null The operation completed successfully.
1 Global_name not a saved global select element, and NOCAN option
Any other error results in cancellation of the User Language request.

$WEB_SEL return values


See $Web_Selp for an extended example which includes use of $Web_Sel.