icon: ''
import_code: " "
extra:
  en: |

    ```html
      <group>
        <x-address title="title" v-model="value"></x-address>
      </group>
    ```

    ``` js
    import { XAddress } from 'vux'

    // you can import built-in data
    import { XAddress, ChinaAddressV3Data } from 'vux'

    // if you need older data
    import { XAddress, ChinaAddressV1Data } from 'vux'
    ```

    <p class="tip">
    you can view source data at [src/datas](https://github.com/airyland/vux/tree/v2/src/datas).
    </p>

    <p class="tip">`x-address` should be used in `Group`</p>

  zh-CN: |
    ```html
      <group>
        <x-address title="title" v-model="value"></x-address>
      </group>
    ```
    import { XAddress } from 'vux'
tags:
  en:
    - form
    - address
  zh-CN:
    - 地址
    - 省市
extends:
  - popup-picker
props:
  raw-value:
    type: Boolean
    default: false
    en: if the initial value is `string value` instead of `id value`
    zh-CN: 指定初始化时绑定的数据是否为文本(即省市名，而不是id)类型，即对于非id值组件内部会转换为id。如果是异步设置value，只能使用id赋值。
  title:
    type: String
    default: ''
    en: label text
    zh-CN: 表单标题
  value:
    type: Array
    default: ''
    en: 'form value, use `v-model` for binding'
    zh-CN: '表单值, 使用`v-model`绑定'
  list:
    type: Array
    default: ''
    en: address data
    zh-CN: 地址列表, 可以引入内置地址数据或者用自己的数据，但是需要按照一致的数据结构。
  inline-desc:
    type: String
    default: ''
    en: description text below label
    zh-CN: 标题下的描述
  placeholder:
    type: String
    default: ''
    en: placeholder
    zh-CN: 没有值时的提示文字
  hide-district:
    type: Boolean
    default: false
    en: if hide district column
    zh-CN: 是否隐藏区，即只显示省份和城市
  value-text-align:
    type: String
    default: right
    en: 'align setting of `value`'
    zh-CN: 'value 对齐方式(text-align)'
  show-second-name:
    type: Boolean
    en: Specifies the second column value of the display text that cannot be set at the same time as show-name
    zh-CN: 指定显示文字的第二列值，不能与show-name同时设置
    version: 1.3.7
events:
  on-hide:
    params: true或者false
    en: emits when being closed
    zh-CN: 关闭后触发，当非确定时，参数为false，反之为true
  on-show:
    en: emits when being open
    zh-CN: 显示时触发
  on-change:
    params: 改变地址的值，是一个Object对象
    en: The value is triggered when it changes, and the parameter is the changed value
    zh-CN: 值改变的时候触发，参数为改变的值`{city:"上海市市辖区",cityCode:"310100",district:"黄浦区",districtCode:"310101",province:"上海市",provinceCode:"310000"}`
    version: 1.3.7
changes:
  v1.3.5:
    en:
     - '[fix] Fix the selected value and trigger the value change logic at the same time'
    zh-CN:
     - '[fix] 修复选中值相同时触发值变化逻辑'
  v1.3.7:
    en:
     - '[feature] Add the show-second-name attribute, and the on-change event'
    zh-CN:
     - '[feature] 新增show-second-name属性，on-change事件'