valeriy-brunov / field-simbol-template
Помогает пользователю вводить текст по шаблону в текстовом поле. По умолчанию установлен шаблон ввода номера сотового телефона.
Installs: 0
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Language:JavaScript
Type:cakephp-plugin
Requires
- php: >=7.2
- cakephp/cakephp: 4.4.*
- valeriy-brunov/web-component: ^1.0
Requires (Dev)
- phpunit/phpunit: ^8.5 || ^9.3
README
Что может этот плагин?
Помогает пользователю вводить текст по шаблону в текстовом поле.
Установка
Вы можете установить этот плагин в свое приложение CakePHP с помощью composer.
Рекомендуемый способ установки пакетов composer - это:
composer require valeriy-brunov/field-simbol-template
composer dumpautoload
bin/cake plugin load Field-simbol-template
Использовать
<?= $this->Webcomp->fieldSimbolTemplate() ?>
Настройки:
Настройки указываются ввиде массива:
<?php echo $this->Webcomp->fieldSimbolTemplate([ 'template' => '__/__', ... ]); ?>
template
Строка, содержащая шаблон для ввода текста. Символ подчёркивания (_) в шаблоне используется для замены символами ввода. По умолчанию используется шаблон ввода номера сотового телефона:
'template' => '+7(___)___-__-__',
input
Определяет какие значение можно вводить в шаблон, фильтрует ввод символов при вводе:
Любые значения (буквы и цифры):
'input' => 'all',
Только цифры, используется по умолчанию:
'input' => 'numbers',
Только буквы:
'input' => 'letters',
displayInput
Как отображает ввод символов с клавиатуры:
Показывать ввод символов в шаблоне, заменяя символ подчёркивания (_), используется по умолчанию:
'displayInput' => 'full',
Не показывать правую часть шаблона при вводе символов:
'displayInput' => 'right-crop',
clearFormFocus
Что делать с содержимым текстового поля при появление или потери фокуса (устанавливает режимы):
Текстовое поле "при потери фокуса" очищается и показывается содержимое атрибута "placeholder", даже если часть символов введена. "При возникновение фокуса" текстовое поле очищается и набор начинается заново, установлен по умолчанию:
'clearFormFocus' => 'y',
Текстовое поле не очищается "при потери фокуса". Если не набрано ни единого символа, показывается "placeholder". Если введены часть символов, они остаются. "При появление фокуса" в текстовом поле, набор продолжается с того места, где остановился набор символов:
'clearFormFocus' => 'n',
!!! Для всех режимов: если введены все символы в соответствии с шаблоном, то при "потери фокуса" или "появление фокуса" набранный текст отображается;
placeholder
Текст, который отобразится в текстовом поле при потери фокуса.
'placeholder' => 'Текст',
jsajax
Если веб-компонент загружается на страницу при помощи AJAX-запроса и не является вложенным в другой
веб-компонент, а после загрузки страницы будет на первом уровне с тегом <brunov-insert-paginator>
, то
необходимо указать параметр:
'jsajax' => true,