dniccum/phone-number

A Laravel Nova电话号码字段,支持输入掩码和验证。

v2.3.1 2024-07-15 17:19 UTC

README

Laravel Nova Phone Number Field

Latest Version on Packagist License Total Downloads

一个用于动态输入掩码和附加电话号码验证的Laravel Nova字段。

注意:此字段利用Propaganistas / Laravel-Phone包进行验证。

Image 1

安装

要安装此工具,请使用以下安装代码

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)。有关更多信息,请参阅许可证文件