NPM 包 Vue-Citys-Picker 使用教程

阅读时长 7 分钟读完

Vue-Citys-Picker 是一个基于 Vue.js 的城市选择器组件,它可以帮助前端开发者快速地实现省市区三级联动选择器,使用起来非常方便。本文将详细介绍如何安装和使用这个组件以及示例代码。

安装

使用 npm 安装 Vue-Citys-Picker

使用

全局组件

在 main.js 中引入 Vue-Citys-Picker 组件并注册为全局组件:

在组件中使用:

局部组件

如果只需要在某些组件中使用 Vue-Citys-Picker,可以在这些组件中引入该组件:

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

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

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

配置

Vue-Citys-Picker 支持多种配置选项,下面是示例代码:

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

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

------ ------- -
  ----------- -
    --------------
  --
  ------ -
    ------ -
      -------------- ---
      --------- ------
      ----- ---
      --------- ------- -- ------
      --------- ------- -- ------
      ----------- ------- -- ------
      --------------- ----- -- -----------------
    -
  --
  -------- -
    --------------------------- -
      --------------------------
    -
  -
-
---------
  • v-model:选择的城市列表
  • :disabled:是否禁用选择器
  • :class:样式类名
  • :data:城市数据,数组类型
  • :prov-prop:省份属性名称
  • :city-prop:城市属性名称
  • :region-prop:地区属性名称
  • :change-on-select:当选择省份或城市时是否立即更新数据
  • @change:选中城市时触发的事件

示例代码

下面是一个简单的示例代码,展示了如何使用 Vue-Citys-Picker 选择城市:

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

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

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

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

结语

Vue-Citys-Picker 是一个非常好用的城市选择器组件,它提供了丰富的 API 和配置选项,可以在许多场景中使用。本文介绍了如何安装和使用 Vue-Citys-Picker 以及示例代码,希望能够对你有所帮助。

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

纠错
反馈