260fbefd7c0d072086bcd5c4db64d8ce049fa7f4
[timetracker.git] / WEB-INF / lib / form / FormElement.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 // FromElement is the base class for controls on forms.
30 class FormElement {
31   var $id = '';         // Control id.
32   var $name;            // Control name.
33   var $form_name = '';  // Form name the control is in.
34   var $value = '';      // Value of the control.
35   var $size = '';       // Control size.
36   var $max_length = ''; // Max length of text in control.
37   var $on_change = '';  // What happens when value of control changes.
38   var $on_click = '';   // What happens when the control is clicked.
39   var $label = '';      // Optional label for control.
40   var $style = '';      // Control style.
41   var $enabled = true;  // Whether the control is enabled.
42   var $class = 'FormElement'; // Class name for the element.
43
44   function __construct() {
45   }
46
47   function getClass() { return $this->class; }
48
49   // TODO: refactoring ongoing down from here.
50         function setName($name) { $this->name = $name; }
51         function getName()      { return $this->name; }
52         
53         function setFormName($name) { $this->form_name = $name; }
54         function getFormName()  { return $this->form_name; }
55         
56         function setValue($value) { $this->value = $value; }
57         function getValue() { return $this->value; }
58         
59         function setValueSafe($value) { $this->value = $value;}
60         function getValueSafe() { return $this->value; }
61
62         function setId($id) { $this->id = $id;  }
63         function getId() { return $this->id; }
64         
65         function setSize($value) { $this->size = $value; }
66         function getSize() { return $this->size; }
67
68         function setLabel($label) { $this->label = $label; }
69         function getLabel() { return $this->label; }
70         
71         function setMaxLength($value) { $this->max_length = $value; }
72         function getMaxLength() { return $this->max_length; }
73
74         function setStyle($value) { $this->style = $value; }
75         function getStyle() { return $this->style; }
76
77         function setEnabled($flag) { $this->enabled = $flag; }
78         function isEnabled() { return $this->enabled; }
79         
80         function setOnChange($str) { $this->on_change = $str; }
81         function setOnClick($str) { $this->on_click = $str; }
82
83         function setLocalization($i18n) {
84         }
85         
86         function toStringControl()      {
87                 return "";
88         }
89
90         function toStringLabel() {
91             return "<label for=\"" . $this->id . "\">" . $this->label . "</label>";
92         }
93         
94         function toArray() {
95             return array(
96                      "label"=>$this->toStringLabel(),
97                      "control"=>$this->toStringControl()
98                    );
99         }
100
101 }