1: <?php
2:
3: 4: 5: 6: 7: 8: 9: 10: 11:
12:
13:
14:
15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37:
38: abstract class NFormControl extends NComponent implements IFormControl
39: {
40:
41: public static $idMask = 'frm%s-%s';
42:
43:
44: public $caption;
45:
46:
47: protected $value;
48:
49:
50: protected $control;
51:
52:
53: protected $label;
54:
55:
56: private $errors = array();
57:
58:
59: private $disabled = FALSE;
60:
61:
62: private $htmlId;
63:
64:
65: private $htmlName;
66:
67:
68: private $rules;
69:
70:
71: private $translator = TRUE;
72:
73:
74: private $options = array();
75:
76:
77:
78: 79: 80:
81: public function __construct($caption = NULL)
82: {
83: $this->monitor('NForm');
84: parent::__construct();
85: $this->control = NHtml::el('input');
86: $this->label = NHtml::el('label');
87: $this->caption = $caption;
88: $this->rules = new NRules($this);
89: }
90:
91:
92:
93: 94: 95: 96: 97:
98: protected function attached($form)
99: {
100: if (!$this->disabled && $form instanceof NForm && $form->isAnchored() && $form->isSubmitted()) {
101: $this->htmlName = NULL;
102: $this->loadHttpData();
103: }
104: }
105:
106:
107:
108: 109: 110: 111: 112:
113: public function getForm($need = TRUE)
114: {
115: return $this->lookup('NForm', $need);
116: }
117:
118:
119:
120: 121: 122: 123:
124: public function getHtmlName()
125: {
126: if ($this->htmlName === NULL) {
127: $name = str_replace(self::NAME_SEPARATOR, '][', $this->lookupPath('NForm'), $count);
128: if ($count) {
129: $name = substr_replace($name, '', strpos($name, ']'), 1) . ']';
130: }
131: if (is_numeric($name) || in_array($name, array('attributes','children','elements','focus','length','reset','style','submit','onsubmit'))) {
132: $name .= '_';
133: }
134: $this->htmlName = $name;
135: }
136: return $this->htmlName;
137: }
138:
139:
140:
141: 142: 143: 144: 145:
146: public function setHtmlId($id)
147: {
148: $this->htmlId = $id;
149: return $this;
150: }
151:
152:
153:
154: 155: 156: 157:
158: public function getHtmlId()
159: {
160: if ($this->htmlId === FALSE) {
161: return NULL;
162:
163: } elseif ($this->htmlId === NULL) {
164: $this->htmlId = sprintf(self::$idMask, $this->getForm()->getName(), $this->lookupPath('NForm'));
165: }
166: return $this->htmlId;
167: }
168:
169:
170:
171: 172: 173: 174: 175: 176:
177: public function setAttribute($name, $value = TRUE)
178: {
179: $this->control->$name = $value;
180: return $this;
181: }
182:
183:
184:
185: 186: 187: 188: 189: 190: 191: 192: 193:
194: public function setOption($key, $value)
195: {
196: if ($value === NULL) {
197: unset($this->options[$key]);
198:
199: } else {
200: $this->options[$key] = $value;
201: }
202: return $this;
203: }
204:
205:
206:
207: 208: 209: 210: 211: 212:
213: final public function getOption($key, $default = NULL)
214: {
215: return isset($this->options[$key]) ? $this->options[$key] : $default;
216: }
217:
218:
219:
220: 221: 222: 223:
224: final public function getOptions()
225: {
226: return $this->options;
227: }
228:
229:
230:
231:
232:
233:
234:
235: 236: 237: 238: 239:
240: public function setTranslator(ITranslator $translator = NULL)
241: {
242: $this->translator = $translator;
243: return $this;
244: }
245:
246:
247:
248: 249: 250: 251:
252: final public function getTranslator()
253: {
254: if ($this->translator === TRUE) {
255: return $this->getForm(FALSE) ? $this->getForm()->getTranslator() : NULL;
256: }
257: return $this->translator;
258: }
259:
260:
261:
262: 263: 264: 265: 266: 267:
268: public function translate($s, $count = NULL)
269: {
270: $translator = $this->getTranslator();
271: return $translator === NULL || $s == NULL ? $s : $translator->translate($s, $count);
272: }
273:
274:
275:
276:
277:
278:
279:
280: 281: 282: 283: 284:
285: public function setValue($value)
286: {
287: $this->value = $value;
288: return $this;
289: }
290:
291:
292:
293: 294: 295: 296:
297: public function getValue()
298: {
299: return $this->value;
300: }
301:
302:
303:
304: 305: 306: 307:
308: public function isFilled()
309: {
310: return (string) $this->getValue() !== '';
311: }
312:
313:
314:
315: 316: 317: 318: 319:
320: public function setDefaultValue($value)
321: {
322: $form = $this->getForm(FALSE);
323: if (!$form || !$form->isAnchored() || !$form->isSubmitted()) {
324: $this->setValue($value);
325: }
326: return $this;
327: }
328:
329:
330:
331: 332: 333: 334:
335: public function loadHttpData()
336: {
337: $path = explode('[', strtr(str_replace(array('[]', ']'), '', $this->getHtmlName()), '.', '_'));
338: $this->setValue(NArrays::get($this->getForm()->getHttpData(), $path, NULL));
339: }
340:
341:
342:
343: 344: 345: 346: 347:
348: public function setDisabled($value = TRUE)
349: {
350: $this->disabled = (bool) $value;
351: return $this;
352: }
353:
354:
355:
356: 357: 358: 359:
360: public function isDisabled()
361: {
362: return $this->disabled;
363: }
364:
365:
366:
367:
368:
369:
370:
371: 372: 373: 374:
375: public function getControl()
376: {
377: $this->setOption('rendered', TRUE);
378:
379: $control = clone $this->control;
380: $control->name = $this->getHtmlName();
381: $control->disabled = $this->disabled;
382: $control->id = $this->getHtmlId();
383: $control->required = $this->isRequired();
384:
385: $rules = self::exportRules($this->rules);
386: $rules = substr(json_encode($rules), 1, -1);
387: $rules = preg_replace('#"([a-z0-9]+)":#i', '$1:', $rules);
388: $rules = preg_replace('#(?<!\\\\)"([^\\\\\',]*)"#i', "'$1'", $rules);
389: $control->data('nette-rules', $rules ? $rules : NULL);
390:
391: return $control;
392: }
393:
394:
395:
396: 397: 398: 399: 400:
401: public function getLabel($caption = NULL)
402: {
403: $label = clone $this->label;
404: $label->for = $this->getHtmlId();
405: if ($caption !== NULL) {
406: $label->setText($this->translate($caption));
407:
408: } elseif ($this->caption instanceof NHtml) {
409: $label->add($this->caption);
410:
411: } else {
412: $label->setText($this->translate($this->caption));
413: }
414: return $label;
415: }
416:
417:
418:
419: 420: 421: 422:
423: final public function getControlPrototype()
424: {
425: return $this->control;
426: }
427:
428:
429:
430: 431: 432: 433:
434: final public function getLabelPrototype()
435: {
436: return $this->label;
437: }
438:
439:
440:
441:
442:
443:
444:
445: 446: 447: 448: 449: 450: 451:
452: public function addRule($operation, $message = NULL, $arg = NULL)
453: {
454: $this->rules->addRule($operation, $message, $arg);
455: return $this;
456: }
457:
458:
459:
460: 461: 462: 463: 464: 465:
466: public function addCondition($operation, $value = NULL)
467: {
468: return $this->rules->addCondition($operation, $value);
469: }
470:
471:
472:
473: 474: 475: 476: 477: 478: 479:
480: public function addConditionOn(IFormControl $control, $operation, $value = NULL)
481: {
482: return $this->rules->addConditionOn($control, $operation, $value);
483: }
484:
485:
486:
487: 488: 489:
490: final public function getRules()
491: {
492: return $this->rules;
493: }
494:
495:
496:
497: 498: 499: 500: 501:
502: final public function setRequired($message = NULL)
503: {
504: return $this->addRule(NForm::FILLED, $message);
505: }
506:
507:
508:
509: 510: 511: 512:
513: final public function isRequired()
514: {
515: foreach ($this->rules as $rule) {
516: if ($rule->type === NRule::VALIDATOR && !$rule->isNegative && $rule->operation === NForm::FILLED) {
517: return TRUE;
518: }
519: }
520: return FALSE;
521: }
522:
523:
524:
525: 526: 527:
528: protected static function exportRules($rules)
529: {
530: $payload = array();
531: foreach ($rules as $rule) {
532: if (!is_string($op = $rule->operation)) {
533: $op = callback($op);
534: if (!$op->isStatic()) {
535: continue;
536: }
537: }
538: if ($rule->type === NRule::VALIDATOR) {
539: $item = array('op' => ($rule->isNegative ? '~' : '') . $op, 'msg' => $rules->formatMessage($rule, FALSE));
540:
541: } elseif ($rule->type === NRule::CONDITION) {
542: $item = array(
543: 'op' => ($rule->isNegative ? '~' : '') . $op,
544: 'rules' => self::exportRules($rule->subRules),
545: 'control' => $rule->control->getHtmlName()
546: );
547: if ($rule->subRules->getToggles()) {
548: $item['toggle'] = $rule->subRules->getToggles();
549: }
550: }
551:
552: if (is_array($rule->arg)) {
553: foreach ($rule->arg as $key => $value) {
554: $item['arg'][$key] = $value instanceof IFormControl ? (object) array('control' => $value->getHtmlName()) : $value;
555: }
556: } elseif ($rule->arg !== NULL) {
557: $item['arg'] = $rule->arg instanceof IFormControl ? (object) array('control' => $rule->arg->getHtmlName()) : $rule->arg;
558: }
559:
560: $payload[] = $item;
561: }
562: return $payload;
563: }
564:
565:
566:
567:
568:
569:
570:
571: 572: 573: 574: 575: 576:
577: public static function validateEqual(IFormControl $control, $arg)
578: {
579: $value = $control->getValue();
580: foreach ((is_array($value) ? $value : array($value)) as $val) {
581: foreach ((is_array($arg) ? $arg : array($arg)) as $item) {
582: if ((string) $val === (string) ($item instanceof IFormControl ? $item->value : $item)) {
583: return TRUE;
584: }
585: }
586: }
587: return FALSE;
588: }
589:
590:
591:
592: 593: 594: 595: 596:
597: public static function validateFilled(IFormControl $control)
598: {
599: return $control->isFilled();
600: }
601:
602:
603:
604: 605: 606: 607: 608:
609: public static function validateValid(IFormControl $control)
610: {
611: return $control->rules->validate(TRUE);
612: }
613:
614:
615:
616: 617: 618: 619: 620:
621: public function addError($message)
622: {
623: if (!in_array($message, $this->errors, TRUE)) {
624: $this->errors[] = $message;
625: }
626: $this->getForm()->addError($message);
627: }
628:
629:
630:
631: 632: 633: 634:
635: public function getErrors()
636: {
637: return $this->errors;
638: }
639:
640:
641:
642: 643: 644:
645: public function hasErrors()
646: {
647: return (bool) $this->errors;
648: }
649:
650:
651:
652: 653: 654:
655: public function cleanErrors()
656: {
657: $this->errors = array();
658: }
659:
660: }
661: