开发预览更新于 2026-05-10

PhoneInput 电话号码输入

国家码下拉 + 号码输入。内置 12 个常见国家，可通过 countries 覆盖。

基础用法

国家码段独立背景，下拉支持模糊搜索。本组件不做 E.164 校验，由消费方接 libphonenumber 等库。

CN · 138 0013 8000

<CfPhoneInput v-model="phone" v-model:country="country" />

<CfPhoneInput value={phone} onChange={setPhone} country={country} onCountryChange={setCountry} />

error 切红边，disabled 整体灰化。

<CfPhoneInput v-model="v" :error="true" />
<CfPhoneInput v-model="v" disabled />

<CfPhoneInput value={v} onChange={setV} error />
<CfPhoneInput value={v} onChange={setV} disabled />

属性	类型	默认值	说明
`modelValue` / `value`	`string`	`''`	国内号码段
`country`	`string`	`'CN'`	ISO 3166-1 alpha-2
`countries`	`CountryCode[]`	`defaultCountries`（12 项）	自定义国家列表
`size` / `placeholder` / `disabled` / `error`

CountryCode = { code: string; dial: string; label: string }