📄 bk_select.html
字号:
<html><head><title>BabelKit HTML Select Element Methods</title><link rel="STYLESHEET" type="text/css" href="main.css"></head><!-- Copyright (C) 2003 John Gorman <jgorman@webbysoft.com> http://www.webbysoft.com/babelkit--><body bgcolor="#F0FFFF" text="#000000" link="#873852" vlink="#873852" alink="#B52E2E"><center><table width="600"><tr><td><div align="right">[<a href="bk_read.html">Code Descriptions</a>][<a href="index.html">Index</a>][<a href="bk_set.html">Code Sets</a>]</div><center><h2><a href="http://www.webbysoft.com/babelkit">BabelKit</a>HTML Select Element Methods</h2></center>These methods return a string containing HTML codefor various types of select boxes.<p>Deprecated codes are not offered as new user choices butare displayed if already selected in the data.<p>If the data contains codes for which there is no code valuethe raw data values are displayed. Submittinga form without making changes will always will keepthe data unchanged whether or not the code descriptionsexist and whether or not the selections are deprecated.<a name="common"></a><h3>Common Options</h3>Each of the select methods takes two standard parameters:the code set and the language to display in. Extra optionscan be passed in as name - value pairs.<p>The following four options are common to all of the HTMLselect methods. Here is an example using all of them:<pre><b># PHP</b>print $babelkit->select('day', $lang, array( 'var_name' => 'start_day', 'value' => $start_day, 'default' => 1, 'subset' => array( 1, 2, 3, 4, 5 ), 'options' => 'onchange="submit()"' ));</pre><pre><b># Perl</b>print $babelkit->select('day', $lang, var_name => 'start_day', value => $start_day, default => 1, subset => [ 1, 2, 3, 4, 5 ], options => 'onchange="submit()"' );</pre><pre><b># HTML</b><select name="start_day" onchange="submit()"><option value="1" selected>Montag<option value="2">Dienstag<option value="3">Mittwoch<option value="4">Donnerstag<option value="5">Freitag</select></pre><h4>'var_name' => 'start_day'</h4>The HTML select methods all declare a form variablename which will hold the value(s) that the user selects.'var_name' defaults to $code_set. For example, a selectelement displaying 'day' code set choices willby default return the user selection in the 'day' variable.<p>In the example above the programmer has specified thatthe user selection will be returned in the 'start_day'form variable.<p>Multi-value select elements will return the selectedvalues in an array variable. For example, a "select multiple"element will by default return multiple user day selectionsin the 'day[]' variable. Specify multivalue formvariable names *without* the '[]' at the end. For example,specify 'sick_days' instead of 'sick_days[]'.<h4>'value' => $start_day</h4>If you specify a 'value' option, that value will always be used.Select multiple value methods will expect 'value' tobe an array.<p>If a 'value' parameter is not passed in, BabelKit looksat the incoming form variable for the value to use.<p>In PHP, the value is found like this:<pre>$value = $_POST ? $_POST[$var_name] : $_GET[$var_name];</pre><p>Perl gives the programmer control over the parsing ofthe GET and POST information. As a result, it is theprogrammer's responsibility to tell BabelKit how toget those values. See the <a href="bk_new_perl.html">Perl Handle Creation</a> page to see how this is done.Or simply pass the value using the 'value' option.<h4>'default' => 1</h4>If no 'value' is specified, and no value is found inthe incoming form variable, then BabelKit will useany optional 'default' value specified. In theexample above the default is the code for Monday.<h4>'subset' => $show_these_codes</h4>It is sometimes the case that we only want to displaya subset of all possible codes for the user toselect from. In the example above we constrainthe user choices to the codes for Monday - Fridayand return the choice in the 'start_day' form variable.<h4>'options' => 'onchange="submit()"'</h4>You can select select options using the optional'options' option. Separate multiple optionswith spaces.<a name="single"></a><h3>HTML Select Single Value Methods</h3>The following two single value HTML select methods acceptthe common options listed above plus some method specific options.<h4>select()</h4><pre><b># PHP</b>$html = $babelkit->select($code_set, $code_lang, array( 'select_prompt' => 'Code set description?', 'blank_prompt' => 'None' ));</pre><pre><b># Perl</b>$html = $babelkit->select($code_set, $code_lang, select_prompt => 'Code set description?', blank_prompt => 'None' );</pre><p>select() prepares a "drop down" HTML select elementfor user selection of a single value.<p>'select_prompt' is the name to show if there is no initial selection.It defaults to the code set description and a question mark.<p>'blank_prompt' is the name to show to blank out a selection.If none is provided it is not possible for the user toblank out an initial selection.<h4>radio()</h4><pre><b># PHP</b>$html = $babelkit->radio($code_set, $code_lang, array( 'sep' => "<br>\n", 'blank_prompt' => 'None' ));</pre><pre><b># Perl</b>$html = $babelkit->radio($code_set, $code_lang, sep => "<br>\n", blank_prompt => 'None' );</pre><p>radio() prepares HTML radio box elements foruser selection of a single value.<p>'blank_prompt' is the name to show to blank out a selection.If none is provided it is not possible for the user toblank out an initial selection.<p>'sep' is the string to insert between radioboxelements. It defaults to "<br>\n".<a name="multiple"></a><h3>HTML Select Multiple Value Methods</h3>The following two multiple value HTML select methods acceptthe common options listed above some method specific options.These accept and produce multiple values so do not forgetto pass in an array value.<h4>multiple()</h4><pre><b># PHP</b>$html = $babelkit->multiple($code_set, $code_lang, array( 'size' => 10 ));</pre><pre><b># Perl</b>$html = $babelkit->multiple($code_set, $code_lang, size => 10 );</pre>multiple() prepares a select multiple HTML element.<p>'size' is optional and gives the maximum number of elementsto scroll.<h4>checkbox()</h4><pre><b># PHP</b>$html = $babelkit->checkbox($code_set, $code_lang, array( 'sep' => "<br>\n" ));</pre><pre><b># Perl</b>$html = $babelkit->checkbox($code_set, $code_lang, sep => "<br>\n" );</pre>checkbox() prepares multiple checkbox elements for multipleuser selections.<p>'sep' is the string to insert between checkboxelements. It defaults to "<br>\n".<p><div align="right">[<a href="bk_read.html">Code Descriptions</a>][<a href="index.html">Index</a>][<a href="bk_set.html">Code Sets</a>]</div></td></tr></table></center></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -