英文 changelog 内容请访问 CHANGELOG
3.6.2 (2026-10-20)
- 行政区划数据更新至
2026年10月20日版本
3.6.1 (2026-08-30)
- 补充导出类型
3.6.0 (2026-08-30)
- 行政区划数据更新至
2026年08月30日版本 - 使用 typescript 重构
- 核心数据调度优化效率
- 乡镇级别数据加载增加 loading 状态显示
RegionColumns增加headerprop,用于设置标题栏显示RegionSelects与RegionColumns滚动定位应用上下边距显示
- 已选中的项目再次选择时,不触发内部数据处理
3.5.2 (2026-04-02)
- 行政区划数据更新两江新区乡镇数据
3.5.1 (2026-03-27)
- 行政区划数据更新至
2026年03月25日版本
3.5.0 (2025-10-11)
v-dropdown升级至v3.5.1版本- 行政区划数据更新至
2025年10月09日版本 - 新增
autoSelectFirstprop,用于选择级别时,所有下级行政级别均自动选择第一个项目,应用于Selects、Group、Columns系列组件 - 直辖市、直筒子市与省辖县等特殊情况只有单一下级数据时,自动选择该项目
- 添加
separatorprop,设置级别文本间的分隔符
- 核心数据应用队列处理
3.4.1 (2025-03-09)
v-dropdown升级至v3.3.0版本
3.4.0 (2025-03-04)
v-dropdown升级至v3.2.0版本- 行政区划数据更新至
2025年02月26日 - 新增
RegionDropdown组件,用于为Group、Columns与CityPicker的核心模块组件提供下拉列表能力 - 组件移除
RegionGroupCoreRegionFullGroupCoreRegionColumnsCoreRegionFullColumnsCore
RegionSelects、RegionGroup、RegionColumns与RegionCityPicker组件新增names的v-model属性,用于返回选择的行政区划名称- 各核心模块组件移除
adjust事件
3.3.0 (2024-09-26)
RegionCityPicker新增清除选择项目图标按钮- 部分组件添加选中项目滚动定位功能
3.2.1 (2024-09-23)
- dts 文档补充对
scoped slots插槽输出数据的描述 - group 清空图标的样式优化
- 乡镇级别初始化选中状态有概率失败
3.2.0 (2024-09-21)
- 优化性能,减少不必要的渲染与数据加载
- 原有组件将作为 3 级行政级别组件使用,新增
Full系列 4 级行政级别组件,以按需使用,避免不需要使用 4 级行政级别时,组件体积过大 - 移除
resetapi, 需要清空选择内容时,请将v-model绑定的值设置为各级别均为undefined的对象
3.1.0 (2024-07-10)
RegionText添加数据变更响应- 更新数据源
RegionSelects空列表未显示占位文字
3.0.0 (2023-09-24)
- 重构
RegionCityPicker排版结构与样式
3.0.0-beta.4 (2023-09-19)
- 更新
v-dropdown至v3.0.0 - 重构
RegionCityPicker与RegionSelects结构,使其更多功能可测试化
- 更新
.d.ts文档
3.0.0-beta.3 (2023-03-04)
- 修复
Group模式的乡/镇/街道级别列表数据加载有概率错误
3.0.0-beta.2 (2023-03-04)
- 增加对
window对象的判断,解决在非浏览器环境中打包失败
3.0.0-beta.1 (2023-03-02)
- 使用 vue3 composition api 重构
v-region - 工具链从
webpack更换为vite - 单元测试库从
mocha更换为vitest RegionGroupCore与RegionColumnsCore核心模块增加complete事件,响应所有有效级别选择完成操作- 下拉列表形态模块
RegionGroup、RegionColumns与RegionCityPicker均增加visible-change事件,响应下拉层打开/关闭状态 - 移除
Group模式搜索功能