Skip to content

SelectCity 城市选择器

省市区其他数据来源 https://github.com/modood/Administrative-divisions-of-China

参数

参数说明类型可选值默认值
modelValue / v-model绑定值array
data城市数据array默认 pca 省市区
title标题string请选择所在地区
labelKey显示关键字stringname
valueKey值关键字stringname
placeholder占位文本string请选择所在地区
separator分隔符boolean" - "

事件

事件名称说明回调参数
change绑定值变化时触发的事件value

示例

基础用法

html
<cl-select-city v-model="v1" />

省市区乡镇 4 级

html
<template>
	<cl-select-city v-model="v2" :data="CityPcas" placeholder="省市区县、乡镇" />
</template>

<script lang="ts" setup>
	import CityPcas from "../static/city-pcas.json";
</script>

自定义

html
<cl-select-city v-model="v3">
	<template #default="{ selection }">
		<cl-row :margin="[0, 0, 20, 0]" v-if="selection.length">
			<cl-tag v-for="item in selection" plain round :key="item.code">{{ item.name }}</cl-tag>
		</cl-row>

		<cl-button round>选择所在地区</cl-button>
	</template>
</cl-select-city>