witCity 城市选择组件
witCity是一个基于 Element Plus 封装的城市选择组件,支持按省份和按城市两种模式,提供了便捷的城市选择功能。组件内部集成了全国城市数据,支持按字母快速定位城市。
用法实列
vue
<template>
<div>
<witCity v-model="selectedCity" />
<p>选择的城市编码:{{ selectedCity }}</p>
</div>
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const selectedCity = ref('110000') // 默认选择北京
</script>API
| 属性名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
modelValue | [String] | undefined | 城市编码,用于双向绑定,如:'110000'(北京) |
Events
| 事件名 | 描述 | 参数 |
|---|---|---|
update:modelValue | 城市选择变化时触发 | 选择的城市编码 |
TIP
组件内部已集成了全国城市数据,包括省份、城市信息。支持两种选择模式:
- 按省份:先选择省份首字母,再选择具体省份和城市
- 按城市:直接按城市首字母快速定位选择城市
