Yii. Маска ввода. Поле CMaskedTextField

CMaskedTextField генерирует текстовое поле с маской ввода. Это поле помогает пользователю вводить данные, соответствующие необходимому формату данных.
Виджет реализован на основе JQuery-плагина http://digitalbush.com/projects/masked-input-plugin.

Вызов осуществляется следующим образом.

<?php
$this->widget('CMaskedTextField', array(
'model' => $model,// модель
'attribute' => 'aluguel', // атрибут модели
'mask' => '9.999,99', // маска ввода
'htmlOptions' => array('size' => 6)
));
?>

Маска ввода (параметр mask) представляет из себя строку, состоящую из спецсимволов. Следующие символы являются предопределенными:

• a: трактуется как буквенный символ из диапазона (A-Z,a-z)
• 9: трактуется как числовой символ (0-9)
• *: трактуется как алфавитно-цифровой символ (A-Z,a-z,0-9)
• ?: все, что идет после этого символа, является необязательным для ввода со стороны пользователя.

Дополнительные символы могут быть определены путем указания свойства charMap. Это свойство представляет из себя массив сопоставления символов маски и соответствующих шаблонов. Например, array('~'=>'[+-]') определяет, что символ ~ ожидает ввода + или -.

<?php
$this-<widget('CMaskedTextField', array(
'model' => $model,
'attribute' => 'aluguel',
'mask' => '9.999,99',
'charMap' => array('.'=>'[\.]' , ','=>'[,]'),
'htmlOptions' => array('size' => 6)));
?>