CHANGELOG.md

Changelog

Please refer to CHANGELOG-CN for Chinese changelog

3.5.2 (2026-04-02)

Features

• Administrative division data updated for Liangjiang New Area townships

3.5.1 (2026-03-27)

Features

• Administrative division data updated to 2026-03-25

3.5.0 (2025-10-11)

Features

• Upgraded v-dropdown to version v3.5.1
• Administrative division data updated to 2025-10-09
• Added autoSelectFirst prop to automatically select the first item for all subordinate administrative levels when selecting a level. This applies to the Selects, Group, and Columns components
• Automatically select the item when only a single subordinate level is available, such as for municipalities, direct-controlled sub-cities, and provincial counties
• Added the separator prop to set the separator between level text

Refactor

• Core Data uses queue processing

3.4.1 (2025-03-09)

Features

• Upgraded v-dropdown to version v3.3.0

3.4.0 (2025-03-04)

Features

• Upgraded v-dropdown to version v3.2.0
• Administrative division data updated to 2025-02-26
• Added RegionDropdown component to provide dropdown list capabilities for core module components like Group, Columns, and CityPicker
• Component removals:
  • RegionGroupCore
  • RegionFullGroupCore
  • RegionColumnsCore
  • RegionFullColumnsCore
• Added names v-model property to RegionSelects, RegionGroup, RegionColumns, and RegionCityPicker components for returning selected administrative division names
• Removed adjust event from all core module components

3.3.0 (2024-09-26)

Features

• RegionCityPicker component add remove all button
• Some components add the function of scrolling and positioning selected items

3.2.1 (2024-09-23)

Features

• dts adds the description of the output data of scoped slots slots
• Optimize the style of group clear icon

Bug Fixes

• There is a probability that the initialization of the selected state at the town level will fail

3.2.0 (2024-09-21)

Features

• Optimize performance and reduce unnecessary rendering and data loading
• The original components will be used as level 3 administrative level components, and the new Full series of level 4 administrative level components will be added to use them on demand to avoid the components being too large when level 4 administrative level is not needed
• Removed reset api. When you need to clear the selection, please set the value of v-model binding to an object with undefined at all levels

3.1.0 (2024-07-10)

Features

• RegionText adds data change response
• Update region data source

Bug Fixes

• RegionSelects Empty list does not display placeholder text

3.0.0 (2023-09-24)

Features

• Refactor the layout structure and style of RegionCityPicker

3.0.0-beta.4 (2023-09-19)

Features

• Upgrade v-dropdown to v3.0.0
• Refactor the RegionCityPicker and RegionSelects structures to make more functions testable

Bug Fixes

• Update .d.ts document

3.0.0-beta.3 (2023-03-04)

Bug Fixes

• Fix data loading of town level list in Group mode has a probability error

3.0.0-beta.2 (2023-03-04)

Bug Fixes

• Increase the judgment of window object to solve the packaging failure in non-browser environment

3.0.0-beta.1 (2023-03-02)

Features

• Refactor v-region with vue3 composition api
• Change module bundler library from webpack to vite
• Change unit test library from mocha to vitest
• RegionGroupCore and RegionColumnsCore core modules add complete events in response to all available region level selection completion
• The RegionGroup, RegionColumns and RegionCityPicker modules add visible-change events in response to the open/close state of the dropdown layer
• Remove the search module from the Group mode