Source for file jFormsBuilderBase.class.php

Documentation is available at jFormsBuilderBase.class.php

1. <?php
2. /**
3. * @package     jelix
4. * @subpackage  forms
5. * @author      Laurent Jouanneau
6. * @contributor Loic Mathaud, Dominique Papin
7. * @copyright   2006-2007 Laurent Jouanneau, 2007 Dominique Papin
8. * @copyright   2007 Loic Mathaud
9. * @link        http://www.jelix.org
10. * @licence     http://www.gnu.org/licenses/lgpl.html GNU Lesser General Public Licence, see LICENCE file
11. */
12.  
13. /**
14.  * base class of all builder form classes generated by the jform compiler.
15.  *
16.  * a builder form class is a class which help to generate a form for the output
17.  * (html form for example)
18.  * @package     jelix
19.  * @subpackage  forms
20.  */
21. abstract class jFormsBuilderBase {
22.     /**
23.      * a form object
24.      * @var jFormsBase 
25.      */
26.     protected $_form;
27.  
28.     /**
29.      * the action selector
30.      * @var string 
31.      */
32.     protected $_action;
33.  
34.     /**
35.      * params for the action
36.      * @var array 
37.      */
38.     protected $_actionParams = array();
39.  
40.     /**
41.      * form name
42.      */
43.     protected $_name;
44.  
45.     protected $_endt = '/>';
46.     /**
47.      * @param jFormsBase $form a form object
48.      */
49.     public function __construct($form){
50.         $this->_form = $form;
51.     }
52.  
53.     /**
54.      * @param string $action action selector where form will be submit
55.      * @param array $actionParams  parameters for the action
56.      */
57.     public function setAction( $action, $actionParams){
58.         $this->_action = $action;
59.         $this->_actionParams = $actionParams;
60.         $this->_name = jFormsBuilderBase::generateFormName($this->_form->getSelector());
61.         if($GLOBALS['gJCoord']->response!= null && $GLOBALS['gJCoord']->response->getType() == 'html'){
62.             $this->_endt = ($GLOBALS['gJCoord']->response->isXhtml()?'/>':'>');
63.         }
64.     }
65.  
66.     public function getName(){ return  $this->_name; }
67.  
68.     /**
69.      * called during the meta content processing in templates
70.      * This method should set things on the response, like adding
71.      * css styles, javascript links etc.
72.      * @param jTpl $tpl the template object
73.      */
74.     abstract public function outputMetaContent($tpl);
75.  
76.     /**
77.      * output the header content of the form
78.      * @param array $params some parameters, depending of the type of builder
79.      */
80.     abstract public function outputHeader($params);
81.  
82.     /**
83.      * output the footer content of the form
84.      */
85.     abstract public function outputFooter();
86.  
87.     /**
88.      * displays all the form. outputMetaContent, outputHeader and outputFooters are also called
89.      * @since 1.1
90.      */
91.     abstract public function outputAllControls();
92.  
93.     /**
94.      * displays the content corresponding of the given control
95.      * @param jFormsControl $ctrl the control to display
96.      * @param array $attributes  attribute to add on the generated code (html attributes for example)
97.      */
98.     abstract public function outputControl($ctrl, $attributes=array());
99.  
100.     /**
101.      * displays the label corresponding of the given control
102.      * @param jFormsControl $ctrl the control to display
103.      */
104.     abstract public function outputControlLabel($ctrl);
105.  
106.     /**
107.      * generates a name for the form
108.      */
109.     protected static function generateFormName($sel){
110.         static $forms = array();
111.         $name = 'jforms_'.str_replace('~','_',$sel);
112.         if (isset($forms[$sel])) {
113.             return $name.(++$forms[$sel]);
114.         } else 
115.             $forms[$sel] = 0;
116.         return $name;
117.     }
118. }

Documentation generated on Mon, 19 Sep 2011 14:12:40 +0200 by phpDocumentor 1.4.3