PhoneField
PhoneField 组件是一个带有区号的电话输入框。
预览

示例代码
render('Checkout::Dynamic::Render', () => {
return <PhoneField label="Phone" value="1 (555) 555-5555" />;
});
PhoneFieldProps
提示
标注 ? 的属性为可选,未标注 ? 的属性为必选。
label
string
字段标签,也被用作字段为空时的占位符。
accessibilityDescription?
string
设置该组件的标签,将用于屏幕阅读器中帮助客户理解组件的功能。更多内容可见 Accessible description。
autocomplete?
boolean | Autocomplete
控制字段内容的提示是否显示。当设置为 true 时,表示该字段使用浏览器记录的内容进行自动填充。当设置为 false 时,表示永远不保存内容。注意在某些浏览器下自动填充功能无法保证默认关闭状态,因此不要过度依赖不传值时的默认表现。或者,你可以提供一个 Autocomplete 对象,配置你希望在此字段中输入的特定数据。
disabled?
boolean
字段是否可以修改。true 为不可修改,false 为可修改。
error?
string
向客户展示的错误信息。若配置该传参,组件将会标红显示,并展示错误信息。
icon?
IconSource
在字段的开始或结尾渲染的图标。默认情况下将在开始处呈现。
id?
string
用于标识当前组件的唯一标识符。如果未设置 ID,则会使用全局唯一值,全局唯一值为组件内部自行创建的 ID。
maxLength?
number
指定允许的最大字符数。
name?
string
当前组件的名称标识。
readonly?
boolean
是否只读。true 为只读,false 为可编辑。
required?
boolean
字段是否需要值。true 为需要,false 为不需要。该字段旨在添加语义值,不会自动出现错误提示。如果要在该字段为空时显示错误,可以使用 error 属性。
value?
string
字段的当前值。如果省略,该字段将为空。你应该根据 onChange 回调更新此值。
areaCode?
string
默认值:+1
指定区号。
defaultAreaCode?
string
默认区号。
defaultValue?
string
默认值:''
默认值。
onChange?
(value: { phoneNumber: string; areaCode: string }) => void
当完成编辑字段或按下国家下拉列表时的回调。
onInput?
(value: string) => void
当客户在字段中进行任何更改时(包括在下拉列表中选择国家)的回调。
onFocus?
() => void
输入聚焦时的回调。
onBlur?
() => void
移除焦点时的回调。
onKeyDown?
(event: React.KeyboardEvent<HTMLInputElement>)=>void
点击键盘时的回调。
类型说明
Autocomplete
{group?: AutocompleteGroup, field: AutocompleteField}
AutocompleteGroup
shipping
billing
location
AutocompleteField
参考 autofill field。
IconSource
search
arrowDown
arrowUp
arrowLeft
arrowRight
calendar
cart
dot
down
up
right
left
close
closeFill
discount
info
infoFill
lock
minus
plus
success
successFill
store
spin
bag
question
email
phone
share
giftcard
more
timer
hook
ship
location
eyeOpen
eyeClose
menu
parcel
copy
这篇文章对你有帮助吗?