README

帮助用户在文本字段中按模板输入文本。

您可以使用 composer 在您的 CakePHP 应用程序中安装此插件。

推荐使用 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' => '+7(___)___-__-__',

定义可以在模板中输入的值，过滤输入字符

任何值（字母和数字）

'input' => 'all',

仅数字，默认使用

'input' => 'numbers',

仅字母

'input' => 'letters',

如何显示键盘输入的符号

在模板中显示输入符号，替换下划线 (_)，默认使用

'displayInput' => 'full',

输入符号时不显示模板的右侧

'displayInput' => 'right-crop',

在出现或失去焦点时对文本字段内容进行处理（设置模式）

文本字段在失去焦点时清除并显示 "placeholder" 属性的内容，即使输入了部分字符。在获得焦点时，文本字段清除并重新开始输入，默认设置为

'clearFormFocus' => 'y',

在失去焦点时不清除文本字段。如果没有输入任何字符，则显示 "placeholder"。如果输入了部分字符，则保留它们。在文本字段中获得焦点时，从停止输入的地方继续输入

'clearFormFocus' => 'n',

!!! 对于所有模式：如果根据模板输入了所有字符，则在失去焦点或获得焦点时显示输入的文本；

在失去焦点时在文本字段中显示的文本。

'placeholder' => 'Текст',

如果通过 AJAX 请求将网页组件加载到页面中，并且它不是嵌入到另一个网页组件中，在页面加载后将成为带有 <brunov-insert-paginator> 标签的第一级组件，则需要指定参数

'jsajax' => true,

valeriy-brunov / field-simbol-template