/[cvs]/nfo/php/libs/com.newsblob.phphtmllib/form/FormElement.inc

Diff of /nfo/php/libs/com.newsblob.phphtmllib/form/FormElement.inc

Parent Directory | Revision Log | View Patch Patch

-revision 1.2 by jonen,
Sat Sep 20 00:18:43 2003 UTC
+revision 1.3 by jonen,
Thu May  6 16:27:22 2004 UTC
 Line 23
   * get_value() - This gets the current
   *   'value' of the FormElement.
   *   NOTE: This can be a 'complex' FormElement
   *         in which it may return an array of
   *         values.
   *
   * set_value() - Set the current value
 Line 31
   *
   * get_label() - returns the label for this
   *   FormElement.
   *
   *
   * @package phpHtmlLib
   * @subpackage FormProcessing
 Line 105 
 class FormElement {
      var $_is_disabled = FALSE;
      /**
       * automatically strip slashes from
       * form values?
       */
      var $_stripslashes = FALSE;
 Line 117 
 class FormElement {
       */
      var $_form_name;
+     /**
+      * This Form Element needs to
+      * propogate some js to the
+      * Form tag's onsubmit attribute
+      *
+      * @var string
+      */
+     var $_has_form_on_submit = false;
+     /**
+      * This holds an array of FormElement objects
+      * that are slaves of this element
+      */
+     var $_slave_elements;
+     /**
+      * The required field string
+      *
+      */
+     var $_required_field_marker = "*";
      /**
       * The constructor
-Line 136 
 class FormElement {
+Line 157 
 class FormElement {
          $this->set_value( $this->get_init_value() );
      }
+     /**
+      * This function will return the
+      * slaves of this element
+      *
+      * @return array of slave elements
+      */
+     function &get_slave_elements() {
+         return $this->_slave_elements;
+     }
+     /**
+      * This function will set the
+      * slaves of this element
+      *
+      * @param array of slave elements (element references &)
+      */
+     function set_slave_elements($slaveElements) {
+         $this->_slave_elements = $slaveElements;
+         $this->set_data_all_slaves( $this->get_value() );
+     }
+     /**
+      * This function will set the
+      * data the parent wants to set for the slave
+      *
+      * @param the slave
+      * @param the value being set for the parent
+      */
+     function set_slave_data(&$slave, $parentValue) {
+         ; //override to set the data for the slave
+     }
      /**
       * This function will return the
-Line 171 
 class FormElement {
+Line 224 
 class FormElement {
          }
      }
      /**
       * This function will set the
       * initial value for the element
-Line 179 
 class FormElement {
+Line 233 
 class FormElement {
       */
      function set_value($value) {
          $this->_value = $value;
+         $this->set_data_all_slaves($value);
+     }
+     /**
+      * This function will call set_slave_data for all slaves
+      * should be called when value of parent changes
+      *
+      * @param string - the current value of parent
+      */
+     function set_data_all_slaves($parentValue){
+         $slaves = &$this->get_slave_elements();
+         $num_slaves = count($slaves);
+         if ($num_slaves) {
+             for($i=0; $i < $num_slaves; $i++){
+                 $this->set_slave_data($slaves[$i], $parentValue);
+             }
+         }
      }
      /**
       * in case anyone in JS land
       * needs the name of the form that
       * this element lives in
       *
       * @param string - the form name
       */
      function set_form_name($name) {
-Line 195 
 class FormElement {
+Line 267 
 class FormElement {
      /**
       * This provides a method
       * for the FormContent
       * to get access to the
       * text associated with a
       * field.  This is only available
       * on FormElements that have text
       * associated with a field.
       * It is used during Confirmation
       *
-      * @param mixed - the value to look up
+      * @param mixed the value to look up
       * @return string - the text associated
       */
-     function get_value_text($value) {
+     function get_value_text() {
          return $this->get_value();
      }
-Line 321 
 class FormElement {
+Line 393 
 class FormElement {
          $this->_style_attributes[$name] = $value;
      }
+     /**
+      * Sets the element's tab index
+      *
+      * @param int the # for the tabindex
+      */
+     function set_tabindex($index) {
+         $this->set_attribute('tabindex', $index);
+     }
+     /**
+      * Gets the current tab index if any
+      *
+      * @return int returns 0 if there is none set.
+      */
+     function get_tabindex() {
+         if (isset($this->_attributes['tabindex'])) {
+             return $this->_attributes['tabindex'];
+         } else {
+             return 0;
+         }
+     }
      /********* Error handling methods *********/
-Line 345 
 class FormElement {
+Line 439 
 class FormElement {
      }
      /**
       * This returns the array of errors
       * for this element
       *
       * @param array of errors
       */
      function get_errors() {
-Line 375 
 class FormElement {
+Line 469 
 class FormElement {
          if ($label==NULL) {
              return $this->_has_error;
          } else {
-             //xxx( $label );
              //they are looking for a specific error
              foreach( $this->_errors as $error) {
                  if ($error['label'] == $label) {
-                     xxx( $error['label'] );
                      return TRUE;
                  }
              }
              return FALSE;
          }
      }
-Line 408 
 class FormElement {
+Line 499 
 class FormElement {
                  $name[$i] = "_";
          }
+         $this->set_element_name($name);
+     }
+     /**
+      * This allows you to force the element
+      * name to whatever you like, so you
+      * don't have to use the default name, which is
+      * generated based on the label.
+      *
+      * @param string the form element's name
+      * @return none
+      */
+     function set_element_name($name) {
          $this->_element_name = $name;
      }
-Line 577 
 class FormElement {
+Line 681 
 class FormElement {
      }
+     /**
+      * This is a method for getting the JS needed
+      * for the form tag's onsubmit attribute.
+      *
+      * @return string
+      */
+     function form_tag_onsubmit() {
+         return '';
+     }
      /********* rendering methods *********/
-Line 587 
 class FormElement {
+Line 702 
 class FormElement {
       * @return string - required symbol
       */
      function get_required_symbol() {
-         return '*';
+         return $this->_required_field_marker;
+     }
+     /**
+      * This allows you to customize the
+      * require string marker
+      *
+      * @param string
+      */
+     function set_required_symbol($symbol) {
+         $this->_required_field_marker;
      }
      /**
-Line 629 
 class FormElement {
+Line 754 
 class FormElement {
       * label object based on the label text
       * and error conditions
       *
+      * @param FormContent object that holds the
+      *        required field marker
       * @return object SPANtag
       */
-     function get_label() {
+     function get_label($form_content=NULL) {
          $label = $this->get_label_text();
+         $text = $label;
-         if ($this->is_required()) $label .= ' ' . $this->get_required_symbol();
+         if ($this->is_required()) {
+             $text .= ' ' .  ($form_content ? $form_content->_required_field_marker :
+                              $this->get_required_symbol());
+         }
-         $span = html_span("formlabel", $label);
+         $span = html_span("formlabel", $text);
-         if ($this->has_error($label)) {
+         if ($this->has_error()) {
              $span->set_tag_attribute("style","color:red;");
          }
-Line 660 
 class FormElement {
+Line 791 
 class FormElement {
          return $span;
      }
+     /**
+      * This method returns the hidden version of this
+      * element for a confirmation page.
+      *
+      * NOTE: This is called by the FormProcessor only.
+      * It shouldn't be called manually.
+      *
+      * @return INPUTtag of type hidden
+      */
+     function get_confirm_element() {
+         $values = $this->get_value();
+         $name = $this->get_element_name();
+         if (is_array($values)) {
+             $c = container();
+             foreach ( $values as $value ) {
+                 $c->add( form_hidden($name, $value ) );
+             }
+             return $c;
+         } else {
+             return form_hidden($name, $this->get_value() );
+         }
+     }
  } // FormElement
  ?>

 Legend:



Removed from v.1.2
 


changed lines


 
Added in v.1.3
 Legend:



Removed from v.1.2
 


changed lines


 
Added in v.1.3
-Removed from v.1.2
+Added in v.1.3

MailToCvsAdmin">MailToCvsAdmin	ViewVC Help
Powered by ViewVC 1.1.26