README

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

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

安装

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

composer require dniccum/phone-number

版本说明

随着新 占位符方法 的引入，此包现在需要 Nova 版本 3.9 或更高。

如果您正在使用 Laravel Nova < 3.9，请使用以下命令安装此包：

composer require dniccum/phone-number:~1.0.0

代码

要使用此字段，请将以下代码添加到您的 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

在详细视图中将电话号码渲染为可点击的链接。

鸣谢

• Doug Niccum
• Braden Keith
• lintaba
• Maxim Kot

许可证

麻省理工学院许可证（MIT）。有关更多信息，请参阅许可文件。