lib/HTML_Select.php

   1 <?php
   2 /**
   3  * Object-oriented HTML selectbox with validation
   4  *
   5  * @author Ant P <p@cpi.merseine.nu>
   6  * @license http://specialops.ath.cx/repos/so2/trunk/COPYING (New BSD Licence)
   7  * @version 2.15
   8  */
   9 class HTML_Select implements Countable
  10 {
  11     public $name;
  12     public $indent;
  13     public $default;
  14     public $attributes;
  15     private $values = array();
  16
  17     function __construct($name, $indent = 0, $default = null, $attributes = array())
  18     {
  19         $this->indent = $indent;
  20         $this->default = $default;
  21         $this->attributes = $attributes;
  22         $this->attributes['name'] = $name;
  23     }
  24
  25     function add_item($value, $name = '')
  26     {
  27         if ( !$name ) {
  28             $name = $value;
  29         }
  30         $this->values[$name] = $value;
  31     }
  32
  33     function array_fill(array $items)
  34     {
  35         foreach ( $items as $row ) {
  36             if ( is_array($row) ) {
  37                 $this->add_item($row[0], $row[1]);
  38             } else {
  39                 $this->add_item($row);
  40             }
  41         }
  42     }
  43
  44     function set_default($value)
  45     {
  46         $this->default = $value;
  47     }
  48
  49     function check_value(&$value)
  50     {
  51         if ( !isset($value) || !in_array($value, $this->values) ) {
  52             throw new OutOfBoundsException('Bad value given for selectbox "'.$this->attributes['name'].'": '.$value);
  53         }
  54     }
  55
  56     function __toString()
  57     {
  58         $t = str_repeat("  ", $this->indent);
  59
  60         // Concat attributes into a string
  61         $attribs = '';
  62         foreach ( $this->attributes as $name => $value ) {
  63             $attribs .= sprintf(' %s="%s"', $name, $value);
  64         }
  65
  66         // Concat options into another string (how exciting!)
  67         $opts = '';
  68
  69         foreach ( $this->values as $name => $value ) {
  70             $opts .= sprintf('%s  <option value="%s"%s>%s</option>'."\n",
  71                              $t, $value, ( $value == $this->default ? ' selected="selected"' : '' ), $name);
  72         }
  73         return "\n$t<select".$attribs.">\n".$opts.$t."</select>\n$t";
  74     }
  75
  76     public function count()
  77     {
  78         return count($this->values);
  79     }
  80 }
  81 ?>