@berlitz/phone-input

中文文档
2.2.3发布于 2025/04/21MITCommonJS近 30 天下载 1793

Max 设计系统的电话输入组件

中文使用文档
文档目录4 节
  1. 何时使用此组件
  2. 安装
  3. 道具
  4. 使用量

电话输入 npm version

Berlitz 电话输入是一个文本输入字段,它包含每个可用的国家代码.

何时使用此组件

输入任何类型的电话号码

安装

yarn add @berlitz/phone-input

道具

所有来自@berlitz/ 输入组件的道具以及来自反应- 电话- 数字- 输入的道具

Prop类型需求默认页:1
描述字符串
自动补全字符串
按钮布尔在输入右边添加箭头按钮
默认值字符串
已禁用布尔
编号字符串
无效布尔
名称字符串页:1
布莱尔种子
变化种子
点击种子在可选按钮上附加 Click 处理器
占位符字符串譬如"输入电话号码"
所需经费布尔
类型字符串页:1
价值字符串
国家字符串比如"非盟"
显示 InitialValueAs 本地数字布尔真实
标签对象自定义翻译(包括国名).
元数据对象自定义 libphone number -js "metadata".
国际Icon节点自定义“ 国际” 图标
数字 输入元件节点自定义电话号码 组件
国家选择组件节点自定义国家部分

参见 反应 - 电话 - 数字输入 需要更多信息

使用量

import React from 'react'
import PhoneInput from '@berlitz/phone-input'
const MyApp = () => (
  <PhoneInput
    placeholder="Enter phone number"
    country="AU"
    displayInitialValueAsLocalNumber
  />
)

版本与发布记录

@berlitz/phone-input 共发布 21 个版本,首次发布于 2019/12/06;过去 12 个月发布了 0 个版本。

版本发布日期距今
2.2.3latest2025/04/211.5 年前
2.2.22025/04/171.6 年前
2.2.12025/04/161.6 年前
2.2.02025/04/161.6 年前
2.1.6-test.25canary2022/01/244 年前
2.1.52021/09/205 年前

关于 @berlitz/phone-input 的常见问题

@berlitz/phone-input 是什么?

Max 设计系统的电话输入组件

如何安装 @berlitz/phone-input?

在项目目录运行 npm install @berlitz/phone-input,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(16.13.1)、styled-components(5.2.3)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@berlitz/phone-input 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/berlitz__phone-input 是否存在。

@berlitz/phone-input 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@berlitz/phone-input 可以商用吗?

@berlitz/phone-input 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@berlitz/phone-input 的下载量有多少?

根据 npm 官方下载统计,@berlitz/phone-input 在 2026/10/08 – 2026/11/06 这 30 天内被下载 1,793 次,日均约 60 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@berlitz/phone-input 还在维护吗?

最新版本 2.2.3 发布于 2025/04/21(1.5 年前);至今共发布 21 个版本,其中过去 12 个月发布了 0 个;首次发布于 2019/12/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。