*/ class LSformElement { var $name; var $label; var $params; var $values = array(); var $_required = false; var $_freeze = false; /** * Constructeur * * Cette methode construit l'objet et définis sa configuration de base. * * @author Benjamin Renard * * @param[in] &$form [required] LSform L'objet LSform parent * @param[in] $name [required] string Le nom de référence de l'élément * @param[in] $label [required] string Le label de l'élément * @param[in] $params mixed Paramètres supplémentaires * * @retval true */ function LSformElement (&$form, $name, $label, $params){ $this -> name = $name; $this -> label = $label; $this -> params = $params; $this -> form = $form; return true; } /** * Définis la valeur de l'élément * * Cette méthode définis la valeur de l'élément * * @author Benjamin Renard * * @param[in] [required] string or array La futur valeur de l'élément * * @retval boolean Retourne True */ function setValue($data) { if (!is_array($data)) { $data=array($data); } $this -> values = $data; return true; } /** * Ajoute une valeur à l'élément * * Cette méthode ajoute une valeur à l'élément * * @author Benjamin Renard * * @param[in] [required] string or array La futur valeur de l'élément * * @retval void */ function addValue($data) { if (is_array($data)) { $this -> values = array_merge($this -> values, $data); } else { $this -> values[] = $data; } } /** * Test si l'élément est éditable * * Cette méthode test si l'élément est éditable * * @retval boolean */ function isFreeze(){ return $this -> _freeze; } /* * Freeze l'élément * * Rend l'élément non-editable * * @retval void */ function freeze() { $this -> _freeze = true; } /* * Défini la propriété required de l'élément. * * param[in] $isRequired boolean true si l'élément est requis, false sinon * * @retval void */ function setRequired($isRequired=true) { $this -> _required = $isRequired; } /* * Test si l'élément est requis * * Cette méthode test si l'élément est requis * * @retval boolean */ function isRequired(){ return $this -> _required; } /** * Affiche le label de l'élement * * @retval void */ function displayLabel() { if ($this -> isRequired()) { $required=" *"; } else { $required=""; } echo "\t\t".$this -> getLabel()."$required\n"; } /** * Recupère la valeur de l'élement passée en POST * * Cette méthode vérifie la présence en POST de la valeur de l'élément et la récupère * pour la mettre dans le tableau passer en paramètre avec en clef le nom de l'élément * * @param[] array Pointeur sur le tableau qui recupèrera la valeur. * * @retval boolean true si la valeur est présente en POST, false sinon */ function getPostData(&$return) { if($this -> params['form'][$this -> form -> idForm] != 1) { return true; } if (isset($_POST[$this -> name])) { if(!is_array($_POST[$this -> name])) { $_POST[$this -> name] = array($_POST[$this -> name]); } foreach($_POST[$this -> name] as $key => $val) { if (!empty($val)) { $return[$this -> name][$key] = $val; } } return true; } return; } /** * Retourne le label de l'élement * * Retourne $this -> label, ou $this -> params['label'], ou $this -> name * * @retval string Le label de l'élément */ function getLabel() { if ($this -> label != "") { return $this -> label; } else if ($this -> params['label']) { return $this -> params['label']; } else { return $this -> name; } } } ?>