WEB-INF/lib/form/Combobox.class.php

   1 <?php
   2 // +----------------------------------------------------------------------+
   3 // | Anuko Time Tracker
   4 // +----------------------------------------------------------------------+
   5 // | Copyright (c) Anuko International Ltd. (https://www.anuko.com)
   6 // +----------------------------------------------------------------------+
   7 // | LIBERAL FREEWARE LICENSE: This source code document may be used
   8 // | by anyone for any purpose, and freely redistributed alone or in
   9 // | combination with other software, provided that the license is obeyed.
  10 // |
  11 // | There are only two ways to violate the license:
  12 // |
  13 // | 1. To redistribute this code in source form, with the copyright
  14 // |    notice or license removed or altered. (Distributing in compiled
  15 // |    forms without embedded copyright notices is permitted).
  16 // |
  17 // | 2. To redistribute modified versions of this code in *any* form
  18 // |    that bears insufficient indications that the modifications are
  19 // |    not the work of the original author(s).
  20 // |
  21 // | This license applies to this document only, not any other software
  22 // | that it may be combined with.
  23 // |
  24 // +----------------------------------------------------------------------+
  25 // | Contributors:
  26 // | https://www.anuko.com/time_tracker/credits.htm
  27 // +----------------------------------------------------------------------+
  28
  29 import('form.FormElement');
  30
  31 //  name        CDATA          #IMPLIED  -- field name --
  32 //  size        NUMBER         #IMPLIED  -- rows visible --
  33 //  multiple    (multiple)     #IMPLIED  -- default is single selection --
  34 //  disabled    (disabled)     #IMPLIED  -- unavailable in this context --
  35 //  tabindex    NUMBER         #IMPLIED  -- position in tabbing order --
  36 //  onfocus     %Script;       #IMPLIED  -- the element got the focus --
  37 //  onblur      %Script;       #IMPLIED  -- the element lost the focus --
  38 //  onchange    %Script;       #IMPLIED  -- the element value was changed --
  39
  40 class Combobox extends FormElement {
  41     var $mMultiple      = false;
  42     var $mOptions       = array();
  43     var $mOptionsEmpty  = array();
  44     var $mCompareOn = "key"; // or "value"
  45     var $mDataDeep = 1;
  46     var $mDataKeys = array();
  47     var $cClassName     = "Combobox";
  48
  49         function Combobox($name,$value="")
  50         {
  51                 $this->mName                    = $name;
  52                 $this->mValue                   = $value;
  53         }
  54
  55         function setMultiple($value)    { $this->mMultiple = $value; }
  56         function isMultiple() { return $this->mMultiple; }
  57
  58         function setData($value)        { $this->mOptions = $value; }
  59         function getData() { return $this->mOptions; }
  60
  61         function setDataDefault($value) { $this->mOptionsEmpty = $value; }
  62         function getDataDefault() { return $this->mOptionsEmpty; }
  63
  64         function setDataKeys($keys)     { $this->mDataKeys = $keys; $this->mDataDeep = 2; }
  65         function getDataKeys() { return $this->mDataKeys; }
  66
  67
  68         function toStringControl()      {
  69                 if (!$this->isRenderable()) return "";
  70
  71             if ($this->mId=="") $this->mId = $this->mName;
  72
  73                 $html = "\n\t<select";
  74                 $html .= " name=\"$this->mName\" id=\"$this->mId\"";
  75
  76                 if ($this->mSize!="")
  77                   $html .= " size=\"$this->mSize\"";
  78
  79                 if ($this->mMultiple)
  80                   $html .= " multiple";
  81
  82                 if ($this->mTabindex!="")
  83                    $html .= " tabindex=\"$this->mTabindex\"";
  84
  85                 if ($this->mOnChange!="")
  86                    $html .= " onchange=\"$this->mOnChange\"";
  87
  88                 if ($this->mStyle!="")
  89                    $html .= " style=\"$this->mStyle\"";
  90
  91                 $html .= ">\n";
  92                 if (is_array($this->mOptionsEmpty) && (count($this->mOptionsEmpty) > 0))
  93                 foreach ($this->mOptionsEmpty as $key=>$value) {
  94                         $html .= "<option value=\"".$key."\"";
  95                         if (($this->mValue == $value) && ($this->mValue != '')) $html .= " selected";
  96                         $html .= ">".$value."</option>\n";
  97                 }
  98                 if (is_array($this->mOptions) && (count($this->mOptions) > 0))
  99                 foreach ($this->mOptions as $key=>$value) {
 100
 101                         if ($this->mDataDeep>1) {
 102                                 $key = $value[$this->mDataKeys[0]];
 103                                 $value = $value[$this->mDataKeys[1]];
 104                         }
 105                         $html .= "<option value=\"".$key."\"";
 106                         if (($this->mValue == $key) && ($this->mValue != '')) $html .= " selected";
 107                         $html .= ">".htmlspecialchars($value)."</option>\n";
 108                 }
 109
 110                 $html .= "</select>";
 111
 112                 return $html;
 113         }
 114 }
 115 ?>