更新记录

1.0.0（2026-01-05）

1.0.0版本正式发布，欢迎使用

平台兼容性

uni-app(3.7.2)

其他

<button @click="cityPickerRef.open()">选择城市</button>
<godfrey-city-picker
  ref="cityPickerRef"
  mode="province-city-district"
  color="#3686FF"
  :defaultValue="[
    formData.merchantProvince,
    formData.merchantCity,
    formData.merchantDistrict,
  ]"
  @confirm="handleCityPickerConfirm"
/>

const cityPickerRef = ref()
const formData = ref({
  merchantProvince: '广东省',
  merchantCity: '广州市',
  merchantDistrict: '海珠区',
})

// 处理城市选择器确认
async function handleCityPickerConfirm(e) {
  formData.value.merchantProvince = e.value[0];
  formData.value.merchantCity = e.value[1];
  formData.value.merchantDistrict = e.value[2];
}

/** props  */
mode="province-city-district" // 省市区
mode="province-city" // 省市
mode="province" // 省

defaultValue // 初始值，数组格式，根据 mode 确定元素数量
// 例如：mode="province-city-district" 时，defaultValue 为 ['广东省', '广州市', '海珠区']
// 例如：mode="province-city" 时，defaultValue 为 ['广东省', '广州市']
// 例如：mode="province" 时，defaultValue 为 ['广东省']

color="#3686FF" // 选择器主题颜色