code/.docs/prototype_Global/function_helma.Html.prototype.dropDown.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
   2 <html>
   3
   4 <head>
   5         <title></title>
   6         <style type="text/css">
   7
   8         body, p, td, th, li {
   9                 font-family: verdana, sans-serif;
  10                 font-size: 10pt;
  11         }
  12
  13         big.top {
  14                 font-size: 18pt;
  15                 font-weight: bold;
  16         }
  17
  18         big {
  19                 font-size: 13pt;
  20                 font-weight: bold;
  21         }
  22
  23         a {
  24                 font-weight:bold;
  25                 color: #cc3333;
  26                 text-decoration:none;
  27         }
  28         a:hover {
  29                 text-decoration:underline;
  30         }
  31
  32         .navig  {
  33                 font-size: 9px;
  34                 text-decoration: none;
  35                 font-weight:normal;
  36         }
  37
  38         li {
  39                 padding-bottom: 5px;
  40         }
  41
  42
  43         .mainbox        {
  44                 border-color:#999999;
  45                 padding-top:5px;
  46                 padding-bottom:5px;
  47                 border-bottom-width:1px;
  48                 border-bottom-style:dotted;
  49         }
  50
  51         .headline {
  52                 font-weight:bold;
  53                 background:#dfdfdf;
  54                 border-color:#999999;
  55                 padding-top:5px;
  56                 padding-bottom:5px;
  57         }
  58
  59         </style>
  60 </head>
  61
  62 <body>
  63
  64 <table width="90%" border="0" cellspacing="1" cellpadding="5">
  65 <tr>
  66         <td class="headline">
  67         <big><tt>Global.helma.Html.prototype.dropDown&nbsp;(param,&nbsp;options,&nbsp;selectedValue,&nbsp;firstOption)</tt></big><br>
  68         </td>
  69 </tr>
  70
  71 <tr>
  72         <td class="mainbox">
  73         Renders a x/html drop down select box <br><br>
  74
  75         <ul>
  76                 <li><b>Parameter</b> <code>{Object}</code>:<br/>
  77 param An object containing the tag attributes<li><b>Parameter</b> <code>{Array}</code>:<br/>
  78 options Either an array of strings, an array with several <code>{value: v, display: d}</code> objects, or a collection of <code>["value", "display"]</code> arrays in an array<li><b>Parameter</b> <code>{String}</code>:<br/>
  79 selectedValue The value to pre-select<li><b>Parameter</b> <code>{String}</code>:<br/>
  80 firstOption An optional first option to display in the select box (this option will always have no value)
  81
  82
  83
  84
  85
  86         </ul>
  87         </td>
  88 </tr>
  89 </table>
  90
  91 <table width="90%" border="0" cellspacing="1" cellpadding="5">
  92 <tr>
  93         <td>Sourcecode in /root/helma-1.6.1/modules/helma/Html.js:
  94         <pre><font color="#aaaaaa">463:</font>   helma.Html.prototype.dropDown = function(param, options, selectedValue, firstOption) {
  95 <font color="#aaaaaa">464:</font>       if (!param) {
  96 <font color="#aaaaaa">465:</font>           res.write(<font color="#9999aa">&quot;[Html.dropDown: insufficient arguments]&quot;</font>);
  97 <font color="#aaaaaa">466:</font>           return;
  98 <font color="#aaaaaa">467:</font>       }
  99 <font color="#aaaaaa">468:</font>       var attr = Object.prototype.reduce.call(param);
 100 <font color="#aaaaaa">469:</font>       if (!attr.size)
 101 <font color="#aaaaaa">470:</font>           attr.size = 1;
 102 <font color="#aaaaaa">471:</font>       this.openTag(<font color="#9999aa">&quot;select&quot;</font>, attr);
 103 <font color="#aaaaaa">472:</font>      res.write(<font color="#9999aa">&quot;\n &quot;</font>);
 104 <font color="#aaaaaa">473:</font>      if (firstOption) {
 105 <font color="#aaaaaa">474:</font>          this.openTag(<font color="#9999aa">&quot;option&quot;</font>, {value: <font color="#9999aa">&quot;&quot;</font>});
 106 <font color="#aaaaaa">475:</font>          res.write(firstOption);
 107 <font color="#aaaaaa">476:</font>          this.closeTag(<font color="#9999aa">&quot;option&quot;</font>);
 108 <font color="#aaaaaa">477:</font>          res.write(<font color="#9999aa">&quot;\n &quot;</font>);
 109 <font color="#aaaaaa">478:</font>      }
 110 <font color="#aaaaaa">479:</font>      for (var i in options) {
 111 <font color="#aaaaaa">480:</font>          var attr = new Object();
 112 <font color="#aaaaaa">481:</font>          var display = <font color="#9999aa">&quot;&quot;</font>;
 113 <font color="#aaaaaa">482:</font>          if ((options[i] instanceof Array) &amp;&amp; options[i].length &gt; 0) {
 114 <font color="#aaaaaa">483:</font>  <font color="#33aa00">            // option is an array
 115 <font color="#aaaaaa">484:</font>  </font>            attr.value = options[i][0];
 116 <font color="#aaaaaa">485:</font>              display = options[i][1];
 117 <font color="#aaaaaa">486:</font>          } else if (options[i].value != null &amp;&amp; options[i].display != null) {
 118 <font color="#aaaaaa">487:</font>  <font color="#33aa00">            // option is an object
 119 <font color="#aaaaaa">488:</font>  </font>            attr.value = options[i].value;
 120 <font color="#aaaaaa">489:</font>              if (options[i][<font color="#9999aa">&quot;class&quot;</font>] != null) {
 121 <font color="#aaaaaa">490:</font>                 attr[<font color="#9999aa">&quot;class&quot;</font>] = options[i][<font color="#9999aa">&quot;class&quot;</font>];
 122 <font color="#aaaaaa">491:</font>              }
 123 <font color="#aaaaaa">492:</font>              display = options[i].display;
 124 <font color="#aaaaaa">493:</font>          } else {
 125 <font color="#aaaaaa">494:</font>  <font color="#33aa00">            // assume option is a string
 126 <font color="#aaaaaa">495:</font>  </font>            attr.value = i;
 127 <font color="#aaaaaa">496:</font>              display = options[i];
 128 <font color="#aaaaaa">497:</font>          }
 129 <font color="#aaaaaa">498:</font>          if (helma.Html.isSelected(attr.value, selectedValue))
 130 <font color="#aaaaaa">499:</font>              attr.selected = <font color="#9999aa">&quot;selected&quot;</font>;
 131 <font color="#aaaaaa">500:</font>          this.openTag(<font color="#9999aa">&quot;option&quot;</font>, attr);
 132 <font color="#aaaaaa">501:</font>          res.write(display);
 133 <font color="#aaaaaa">502:</font>          this.closeTag(<font color="#9999aa">&quot;option&quot;</font>);
 134 <font color="#aaaaaa">503:</font>          res.write(<font color="#9999aa">&quot;\n &quot;</font>);
 135 <font color="#aaaaaa">504:</font>      }
 136 <font color="#aaaaaa">505:</font>      this.closeTag(<font color="#9999aa">&quot;select&quot;</font>);
 137 <font color="#aaaaaa">506:</font>      res.write(<font color="#9999aa">&quot;\n &quot;</font>);
 138 <font color="#aaaaaa">507:</font>      return;
 139 <font color="#aaaaaa">508:</font>  }
 140 </pre>
 141         </td>
 142 </tr>
 143
 144 </table>
 145
 146
 147
 148
 149
 150 </body>
 151 </html>