dniccum / phone-number
A Laravel Nova电话号码字段,支持输入掩码和验证。
Requires
- php: ^8.0|^8.2
- laravel/framework: ^9.0|^10.0|^11.0
- laravel/nova: ^4.33
- nova-kit/nova-packages-tool: ^1.0
- propaganistas/laravel-phone: ^5.2
- dev-master
- v2.3.1
- v2.3.0
- v2.2.3
- v2.2.2
- v2.2.1
- v2.2.0
- v2.1.0
- v2.0.0
- v1.1.2
- v1.1.1
- v1.1.0
- v1.0.8
- v1.0.7
- v1.0.6.1
- v1.0.6
- v1.0.5
- 1.0.4
- v1.0.3
- v1.0.2
- v1.0.1
- v1.0.0
- dev-dependabot/npm_and_yarn/express-4.21.0
- dev-dependabot/npm_and_yarn/micromatch-4.0.8
- dev-dependabot/npm_and_yarn/webpack-5.94.0
- dev-feature/laravel-upgrade-without-nova-upgrade
This package is auto-updated.
Last update: 2024-09-21 06:24:39 UTC
README
一个用于动态输入掩码和附加电话号码验证的Laravel Nova字段。
注意:此字段利用Propaganistas / Laravel-Phone包进行验证。
安装
要安装此工具,请使用以下安装代码
composer require dniccum/phone-number
代码
要使用此字段,请将以下代码添加到您的Nova资源中。由于这是一个字段,可以应用所有默认字段属性。
use Dniccum\PhoneNumber\PhoneNumber; PhoneNumber::make('Phone Number')
选项
为了支持多种电话号码类型和格式,此字段提供多种输入掩码和验证方法。
默认值
format
PhoneNumber::make('Phone Number') ->format('###-###-####')
类型:字符串
默认值 (###) ###-####
这是javascript控制输入掩码将使用的值;并且根据字段的配置,占位符文本。要表示数字,请使用井号(#)符号。
注意:可以在输入中包含其他类型的内容,如电话分机。
PhoneNumber::make('Phone Number') ->format('###-###-#### ext ####')
但是,内置的电话号码验证将失败,因为这从技术上讲是一个无效的电话号码。为了防止验证失败,可以像这样关闭电话号码验证
PhoneNumber::make('Phone Number') ->format('###-###-####') ->disableValidation()
placeholder
PhoneNumber::make('Phone Number') ->placeholder('Personal Home Number')
类型:字符串
默认:[字段名称]
如果您想覆盖Nova提供的默认占位符(字段名称),请使用简单字符串。
注意:如果您使用输入的掩码通过useMaskPlaceholder
方法来覆盖占位符,则不起作用。
useMaskPlaceholder
PhoneNumber::make('Phone Number') ->useMaskPlaceholder()
类型:布尔值
默认:false
这将告诉字段用->format()
方法中的输入掩码替换输入的占位符。
country
PhoneNumber::make('Phone Number') ->country('CA')
类型:字符串
默认:US
这告诉字段使用哪种电话号码验证。要定义验证类型,请定义一个ISO 3166-1 alpha-2兼容的国家代码。
此处只能定义一个国家。如果您想定义多个,请参阅->countries()
方法。
注意:此字段利用Propaganistas / Laravel-Phone包进行验证。
countries
PhoneNumber::make('Phone Number') ->countries(['US', 'CA'])
类型:字符串数组
默认:US
如果您想定义多个国家进行验证,请定义基于字符串的ISO 3166-1 alpha-2兼容国家代码数组。
注意:此字段利用Propaganistas / Laravel-Phone包进行验证。
linkOnIndex
PhoneNumber::make('Phone Number') ->linkOnIndex()
类型:布尔值
默认:false
在索引视图中将电话号码渲染为可点击的链接。
linkOnDetail
PhoneNumber::make('Phone Number') ->linkOnDetail()
类型:布尔值
默认:false
在详细视图中将电话号码渲染为可点击的链接。
鸣谢
许可证
MIT许可证(MIT)。有关更多信息,请参阅许可证文件。