Example: Form definition using fluent interfaces

1. 1: <?php
2. 2:  
3. 3: /**
4. 4:  * Nette\Forms example 2
5. 5:  *
6. 6:  * - form definition using fluent interfaces
7. 7:  * - form groups usage
8. 8:  * - default rendering
9. 9:  */
10. 10:  
11. 11:  
12. 12: require '../../Nette/loader.php';
13. 13:  
14. 14:  
15. 15:  
16. 16: Debug::enable();
17. 17:  
18. 18:  
19. 19: $countries = array(
20. 20:     'Select your country',
21. 21:     'Europe' => array(
22. 22:         'CZ' => 'Czech Republic',
23. 23:         'FR' => 'France',
24. 24:         'DE' => 'Germany',
25. 25:         'GR' => 'Greece',
26. 26:         'HU' => 'Hungary',
27. 27:         'IE' => 'Ireland',
28. 28:         'IT' => 'Italy',
29. 29:         'NL' => 'Netherlands',
30. 30:         'PL' => 'Poland',
31. 31:         'SK' => 'Slovakia',
32. 32:         'ES' => 'Spain',
33. 33:         'CH' => 'Switzerland',
34. 34:         'UA' => 'Ukraine',
35. 35:         'GB' => 'United Kingdom',
36. 36:     ),
37. 37:     'AU' => 'Australia',
38. 38:     'CA' => 'Canada',
39. 39:     'EG' => 'Egypt',
40. 40:     'JP' => 'Japan',
41. 41:     'US' => 'United States',
42. 42:     '?'  => 'other',
43. 43: );
44. 44:  
45. 45: $sex = array(
46. 46:     'm' => 'male',
47. 47:     'f' => 'female',
48. 48: );
49. 49:  
50. 50:  
51. 51:  
52. 52: // Step 1: Define form with validation rules
53. 53: $form = new Form;
54. 54:  
55. 55: // group Personal data
56. 56: $form->addGroup('Personal data')
57. 57:     ->setOption('description', 'We value your privacy and we ensure that the information you give to us will not be shared to other entities.');
58. 58:  
59. 59: $form->addText('name', 'Your name:', 35)
60. 60:     ->addRule(Form::FILLED, 'Enter your name');
61. 61:  
62. 62: $form->addText('age', 'Your age:', 5)
63. 63:     ->addRule(Form::FILLED, 'Enter your age')
64. 64:     ->addRule(Form::INTEGER, 'Age must be numeric value')
65. 65:     ->addRule(Form::RANGE, 'Age must be in range from %d to %d', array(10, 100));
66. 66:  
67. 67: $form->addRadioList('gender', 'Your gender:', $sex);
68. 68:  
69. 69: $form->addText('email', 'E-mail:', 35)
70. 70:     ->setEmptyValue('@')
71. 71:     ->addCondition(Form::FILLED) // conditional rule: if is email filled, ...
72. 72:         ->addRule(Form::EMAIL, 'Incorrect E-mail Address'); // ... then check email
73. 73:  
74. 74:  
75. 75: // group Shipping address
76. 76: $form->addGroup('Shipping address')
77. 77:     ->setOption('embedNext', TRUE);
78. 78:  
79. 79: $form->addCheckbox('send', 'Ship to address')
80. 80:     ->addCondition(Form::EQUAL, TRUE) // conditional rule: if is checkbox checked...
81. 81:         ->toggle('sendBox'); // toggle div #sendBox
82. 82:  
83. 83:  
84. 84: // subgroup
85. 85: $form->addGroup()
86. 86:     ->setOption('container', Html::el('div')->id('sendBox'));
87. 87:  
88. 88: $form->addText('street', 'Street:', 35);
89. 89:  
90. 90: $form->addText('city', 'City:', 35)
91. 91:     ->addConditionOn($form['send'], Form::EQUAL, TRUE)
92. 92:         ->addRule(Form::FILLED, 'Enter your shipping address');
93. 93:  
94. 94: $form->addSelect('country', 'Country:', $countries)
95. 95:     ->skipFirst()
96. 96:     ->addConditionOn($form['send'], Form::EQUAL, TRUE)
97. 97:         ->addRule(Form::FILLED, 'Select your country');
98. 98:  
99. 99:  
100. 100: // group Your account
101. 101: $form->addGroup('Your account');
102. 102:  
103. 103: $form->addPassword('password', 'Choose password:', 20)
104. 104:     ->addRule(Form::FILLED, 'Choose your password')
105. 105:     ->addRule(Form::MIN_LENGTH, 'The password is too short: it must be at least %d characters', 3);
106. 106:  
107. 107: $form->addPassword('password2', 'Reenter password:', 20)
108. 108:     ->addConditionOn($form['password'], Form::VALID)
109. 109:         ->addRule(Form::FILLED, 'Reenter your password')
110. 110:         ->addRule(Form::EQUAL, 'Passwords do not match', $form['password']);
111. 111:  
112. 112: $form->addFile('avatar', 'Picture:')
113. 113:     ->addCondition(Form::FILLED)
114. 114:         ->addRule(Form::MIME_TYPE, 'Uploaded file is not image', 'image/*');
115. 115:  
116. 116: $form->addHidden('userid');
117. 117:  
118. 118: $form->addTextArea('note', 'Comment:', 30, 5);
119. 119:  
120. 120:  
121. 121: // group for buttons
122. 122: $form->addGroup();
123. 123:  
124. 124: $form->addSubmit('submit1', 'Send');
125. 125:  
126. 126:  
127. 127:  
128. 128: // Step 2: Check if form was submitted?
129. 129: if ($form->isSubmitted()) {
130. 130:  
131. 131:     // Step 2c: Check if form is valid
132. 132:     if ($form->isValid()) {
133. 133:         echo '<h2>Form was submitted and successfully validated</h2>';
134. 134:  
135. 135:         $values = $form->getValues();
136. 136:         Debug::dump($values);
137. 137:  
138. 138:         // this is the end, my friend :-)
139. 139:         if (empty($disableExit)) exit;
140. 140:     }
141. 141:  
142. 142: } else {
143. 143:     // not submitted, define default values
144. 144:     $defaults = array(
145. 145:         'name'    => 'John Doe',
146. 146:         'userid'  => 231,
147. 147:         'country' => 'CZ', // Czech Republic
148. 148:     );
149. 149:  
150. 150:     $form->setDefaults($defaults);
151. 151: }
152. 152:  
153. 153:  
154. 154:  
155. 155: // Step 3: Render form
156. 156: ?>
157. 157: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
158. 158: <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
159. 159: <head>
160. 160:     <meta http-equiv="content-type" content="text/html; charset=utf-8" />
161. 161:     <meta http-equiv="content-language" content="en" />
162. 162:  
163. 163:     <title>Nette\Forms example 2 | Nette Framework</title>
164. 164:  
165. 165:     <style type="text/css">
166. 166:     <!--
167. 167:     .required {
168. 168:         color: darkred
169. 169:     }
170. 170:  
171. 171:     fieldset {
172. 172:         padding: .5em;
173. 173:         margin: .3em 0;
174. 174:         background: #EAF3FA;
175. 175:         border: 1px solid #b2d1eb;
176. 176:     }
177. 177:  
178. 178:     input.button {
179. 179:         font-size: 120%;
180. 180:     }
181. 181:  
182. 182:     th {
183. 183:         width: 8em;
184. 184:         text-align: right;
185. 185:     }
186. 186:     -->
187. 187:     </style>
188. 188: </head>
189. 189:  
190. 190: <body>
191. 191:     <h1>Nette\Forms example 2</h1>
192. 192:  
193. 193:     <?php echo $form ?>
194. 194: </body>
195. 195: </html>