npm 包 vue-intl-tel-input 使用教程

阅读时长 8 分钟读完

简介

vue-intl-tel-input 是一个基于 Vue.js 的国际电话号码输入组件,支持多种国际号码格式,如:美国 (USA) +1、中国 (China) +86 等。该组件依赖于 Google 的 libphonenumber 库,以提供一致和可靠的电话号码解析和验证。

安装

通过 npm 安装:

使用

假设你的 Vue.js 项目的入口文件为 main.js,那么你可以按照如下方式引入 vue-intl-tel-input 组件:

在你的模板中使用 vue-intl-tel-input 组件:

-- -------------------- ---- -------
----------
  -----
    ------ ----------------------
    ------------------- -------- -------------------- --
  ------
-----------

--------
------ ------- -
  -------- -
    ----------- ------------- -------- -
      ------------------------ --------
    -
  -
-
---------

参数

vue-intl-tel-input 支持以下参数:

参数 类型 默认值 说明
value String 与 input 元素的 value 属性相同。要实现双向绑定,需要同时在组件中发送 @input 事件并更新此属性
defaultCountry String "us" 默认国家码,例如 "us"、"cn"
autoPlaceholder Bool true 是否根据所选国家显示默认的占位符
inputOptions Object {} 传递给 input 元素的其他属性,例如:{ placeholder: "Enter a phone number" }
required Bool false 是否为必填字段
disabled Bool false 是否禁用组件
readonly Bool false 是否只读?
//下列属性是针对区号的,只有当 prop enableAreaCode 为 true 时才会生效
enableAreaCode Bool true 是否开启区号选择功能
areaCodeOptions Array [] 区号选项数组,例如:[{ label: "中国 +86", value: "cn" }, { label: "美国 +1", value: "us" }]。label 为显示名称,value 为国家码
areaCodeValue String 已选择的区号的值。要实现双向绑定,需要同时在组件中发送 @input 事件并更新此属性

事件

vue-intl-tel-input 支持以下事件:

事件 返回值 说明
input (phoneNumber, isValid) => 当用户输入或选择电话号码并验证通过时触发。 phoneNumber 参数是标准化的电话号码,isValid 参数为布尔型
countryChosen (countryCode) => 当用户根据触发选择一个国家码时触发。countryCode 参数是用户选择的国家码

例如:

-- -------------------- ---- -------
------------------- -------------------- ------------------------------------ --

--------
------ ------- -
  -------- -
    ----------- ------------- -------- -
      ------------------------ --------
    --
    ------------------- ------------- -
      ------------------------
    -
  -
-
---------

示例代码

下面是一个完整的例子:

-- -------------------- ---- -------
----------
  -----
    ------ ----------------------
    -------------------
      --------
      ---------------------
      -------------------------
      ------------------------
      ------------------------------------
      --------------------
      ------------------------------------
    --
    ------- --------------------------------
  ------
-----------

--------
------ ------- -
  ---- -- -
    ------ -
      ------------ ---
      -------- ------
      ---------------- -
        - ------ --- ---- ------ ---- --
        - ------ --- ----- ------ ---- --
        - ------ ---- ---- ------ ---- -
      -
    -
  --
  -------- -
    ----------- ------------- -------- -
      ---------------- - -----------
      ------------ - -------
    --
    ------------------- ------------- -
      ---------------------- ------------
    -
  -
-
---------

以上就是 vue-intl-tel-input 组件的详细使用教程,希望对你有所帮助!

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005535981e8991b448d0932

纠错
反馈