brenofortunato / input-customizer
包含一组自定义文本输入的掩码。
dev-master_bootstrap4
2021-05-18 12:16 UTC
Requires
- php: >=7.0
This package is auto-updated.
Last update: 2024-09-18 19:28:04 UTC
README
包含一组用于自定义文本输入的掩码。
安装
您正在阅读Bootstrap 4的说明,要查看Bootstrap 3的说明,请点击此处。
要安装,请使用以下命令
composer require brenofortunato/input-customizer
然后发布资源
php artisan vendor:publish --provider="BrenoFortunato\InputCustomizer\InputCustomizerServiceProvider"
初始配置
在您想要使用掩码的视图中,例如 layouts/app.blade.php,在 head 标签的末尾添加以下内容
<head> ... @include("vendor.input-customizer.masks") @stack("css") </head>
以及,在 body 标签的末尾
<body> ... @stack("js") </body>
请确保 jQuery v3.5.1 或更高版本已存在于 body 中。
使用方法
要应用掩码,只需将其作为类添加到 文本输入框 上,例如
<input class="form-control money-mask" name="price" type="text">
或在 blade 中
{!! Form::text('price', null, ['class' => 'form-control money-mask']) !!}
掩码
可用的掩码有
- money-mask
> R$ 99.999.999.999.999,99
- float-mask
> 999.999,99
- double-mask
> 99.999.999.999.999,99
- integer-mask
> 999.999
- zero-to-ten-mask
> 0 > 10
- percentage-mask
> 0 > 100
- latitude-mask
> -90 > 90
- longitude-mask
> -180 > 180
- document-mask
> 999.999.999-99 > 99.999.999/9999-99
- cpf-mask
> 999.999.999-99
- cnpj-mask
> 99.999.999/9999-99
- national-id-mask
> 99.999.999-9 > AA-99.999.999
- phone-mask
> (99) 9999-9999 > (99) 99999-9999
- datetime-mask
> 01/01/0001 00:00 > 31/12/9999 23:59 > Ao enviar o formulário, será automaticamente formatado para YYYY-MM-DD HH:mm:00
- datetime-blockpast-mask
> 01/01/0001 00:00 (a partir da data atual) > 31/12/9999 23:59 > Ao enviar o formulário, será automaticamente formatado para YYYY-MM-DD HH:mm:00
- datetime-blockfuture-mask
> 01/01/0001 00:00 > 31/12/9999 23:59 (até a data atual) > Ao enviar o formulário, será automaticamente formatado para YYYY-MM-DD HH:mm:00
- date-mask
> 01/01/0001 > 31/12/9999 > Ao enviar o formulário, será automaticamente formatado para YYYY-MM-DD 00:00:00
- date-blockpast-mask
> 01/01/0001 (a partir da data atual) > 31/12/9999 > Ao enviar o formulário, será automaticamente formatado para YYYY-MM-DD 00:00:00
- date-blockfuture-mask
> 01/01/0001 > 31/12/9999 (até a data atual) > Ao enviar o formulário, será automaticamente formatado para YYYY-MM-DD 00:00:00
- time-mask
> 00:00 > 23:59 > Ao enviar o formulário, será automaticamente completado com a data atual no formato YYYY-MM-DD HH:mm:00
- time-blockpast-mask
> 00:00 (a partir da hora atual) > 23:59 > Ao enviar o formulário, será automaticamente completado com a data atual no formato YYYY-MM-DD HH:mm:00
- time-blockfuture-mask
> 00:00 > 23:59 (até a hora atual) > Ao enviar o formulário, será automaticamente completado com a data atual no formato YYYY-MM-DD HH:mm:00
- two-digits-day-mask
> 01 > 31
- two-digits-month-mask
> 01 > 12
- two-digits-year-mask
> 01 > 99
- two-digits-month-year-mask
> 01/01 > 12/99
- two-digits-month-year-blockpast-mask
> 01/01 (a partir da data atual) > 12/99
- two-digits-month-year-blockfuture-mask
> 01/01 > 12/99 (até a data atual)
- duration-mask
> 00:00:00 > 23:59:59
- time-interval-mask
> 99:99 - 99:99 > 99:99 - 99:99; 99:99 - 99:99 > 99:99 - 99:99; 99:99 - 99:99; 99:99 - 99:99; ...
- vehicle-plate-mask
> AAA-9999
- zipcode-mask
> 99999-999
- state-mask
> AA
- credit-card-mask
> 9999-999999-9999 > 9999-999999-99999 > 9999-9999-9999-9999
- card-cvv-mask
> 999 > 9999
附加功能
将以下类添加到 select 中以禁用第一个选项
- first-disabled
更新
如果您之前已添加此包,则必须强制更新资源以获取新掩码
php artisan vendor:publish --provider="BrenoFortunato\InputCustomizer\InputCustomizerServiceProvider" --force
此命令将覆盖 resources/views/vendor/input-customizer/masks.blade.php 中的文件,因此不要编辑它。如果您想添加自己的掩码,请按照下一节中的说明操作。
自定义掩码
要添加自己的掩码,在初始配置的视图中(例如,layouts/app.blade.php),使用以下模板
<script type="text/javascript"> $(document).on("focus", ".name-mask", function(){ $(this).inputmask("replace-with-type", {options}); }); </script>
有关更多说明,请参阅以下文档: RobinHerbots/Inputmask。
问题解决
在初始配置的视图中(例如,layouts/app.blade.php)请确保 没有 包含以下插件的 JavaScript 和 CSS
- Moment
- Daterangepicker
- Inputmask
- jQuery MaskMoney
- SweetAlert2
此外,请确保已将 jQuery v3.5.1 或更高版本包含在上述视图中。
感谢
非常感谢 fpviviani 开发了一些掩码。
许可证
MIT 许可证 (MIT)。 点击此处 以获取更多信息。