brenofortunato/input-customizer

包含一组自定义文本输入的掩码。

dev-master_bootstrap4 2021-05-18 12:16 UTC

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)。 点击此处 以获取更多信息。