form.cmaskedtextfield.txt

Использование виджета CMaskedTextField
=========================

Для повышения удобства и наглядности ввода значения в поле может послужить виджет [CMaskedTextField].
В качестве примера рассмотрим поле для ввода телефонного номера.

Зачастую, номер телефона (вместе с кодом) вводится в одно текстовое поле.
И, если не добавить подсказку о том, в каком формате следует указать свой телефон,
то посетитель может довольно долго подбирать корректный вариант.

Чтобы помочь посетителю сайта с вводом правильного значения, которое пройдёт валидацию,
и сэкономить его время, на помощь придёт виджет [CMaskedTextField].

В представлении запишем:

~~~
[php]
<div class="row">
	<?php echo $form->labelEx($model,'phone'); ?>
	<?php
		$this->widget('CMaskedTextField', array(
			'model' => $model,
			'attribute' => 'phone',
			'mask' => '+7-999-999-9999',
			'placeholder' => '*',
			'completed' => 'function(){console.log("ok");}',
		));
		?>
	<?php echo $form->error($model,'phone'); ?>
</div>
~~~

- `mask`: маска ввода,
- `placeholder`: символы до ввода значений пользователем, в данном случае: `*`,
- `completed`: JavaScript функция, которая срабатывает после завершения ввода пользователем.


В модели будем проверять введённое значение по регулярному выражению:

~~~
[php]
array(
	'phone',
	'match',
	'pattern' => '/^((\+?7)(-?\d{3})-?)?(\d{3})(-?\d{4})$/',
	'message' => 'Некорректный формат поля {attribute}'
),
~~~

`{attribute}` заменяется именем поля при возникновении в данном поле ошибки.


Кстати, [regexlib.com](http://regexlib.com) — сайт с примерами регулярных выражений на все случаи жизни.

Стоит изучить
-------------
 - [CMaskedTextField](http://www.yiiframework.com/doc/api/CMaskedTextField).

---
 - `Автор`: Сергей Жолобов, Xpycm ([monoray.ru](http://monoray.ru/)).