changelog.md 6.4 KB
0.6.2（2026-08-17）
澄清 uni_modules 插件重新安装、更新及安装方式切换的影响范围。
0.6.1（2026-08-16）
更新插件示例工程
Changelog
本项目的显著变更会记录在此文件中，版本号遵循 Semantic Versioning。
Unreleased
0.6.0（2026-08-16）
Added
- dcloud: 将插件市场发布迁移为 uni_modules。
- core: 完善过滤与选中行为。
Fixed
- package: 收紧公开子路径导出。
- build: 强化文档和 README 构建校验。
docs: 修复文档开发进程退出码与端口解析。
0.5.1 - 2026-08-14
Fixed
- 修复 npm 安装使用时具名插槽在 IDE 中无法识别的问题，并保留
$props/ JSX 事件回调的 payload 类型。
0.5.0 - 2026-08-13
Fixed
- docs: 修正文档演示入口。
0.4.2 - 2026-08-12
Fixed
- 修复微信、支付宝小程序中节点选中或反选时，选中态样式触发页面抖动的问题。
- 修复小程序中点击复选框时事件继续冒泡，导致选中或反选偶发无效的问题；开启
check-on-click-node后，点击节点标签也可稳定切换选中状态。
0.4.1 - 2026-08-11
Fixed
- 兼容带 emoji 前缀的提交信息。
0.4.0 - 2026-08-11
Added
- 为
check-change事件 payload 增加halfCheckedKeys/halfCheckedNodes字段，便于直接读取父子联动模式下的半选状态。 - 为
filter-change事件 payload 增加matchedKeys/matchedNodes字段，区分直接命中节点与包含祖先后代的最终可见节点。 - 新增
check-on-click-leaf属性，支持仅点击叶子节点行时切换选中状态，默认false。 - 新增
accordion属性，支持手风琴模式（展开节点时自动收起同级已展开节点），默认false。 - 新增
empty-filter插槽，用于筛选无结果时的专用空状态，未提供时自动回退到empty插槽。
Changed
- 优化默认、图标、标签和尾部插槽的回退渲染，仅在提供对应插槽时进入插槽分支，避免小程序生成无内容的插槽节点。
- 基础示例与 playground 不再默认开启
expand-on-click-node，默认演示与组件一致的箭头展开交互，同时保留实时切换入口。
Fixed
- 修复
default-expanded-keys指定后代节点时未自动展开所有祖先的问题。 - 新增
default-expand-parent属性控制是否自动展开祖先，默认true（保持修复后的行为）。 - 修复小程序中箭头或选择控件点击继续冒泡到节点行，导致展开、选中和
node-click行为相互冲突的问题。
Tests
- 补充箭头与选择控件快速连续点击的组件回归测试，确保嵌套控件行为不会误触发节点行交互。
0.3.2 - 2026-08-04
Fixed
- 修复 GitHub Pages 示例预览 404。
0.3.1 - 2026-08-01
Fixed
- 修复在线演示未使用 hash 路由导致页面直达失败的问题，并补充 Netlify 部署回退配置。
0.3.0 - 2026-08-01
Changed
- 新增
packDisabledKey/pack-disabled-key规范命名，并暂时保留旧packDisabledkey/pack-disabledkey作为废弃别名。 - 优化选中事件 payload 构建与受控
v-model等价回流，避免重复遍历和不必要的全量选中态重放。 - 为组件公开实例方法增加
UniTreeViewExposed编译期一致性校验，并补充懒加载公开方法的行为说明。 - 明确
uni-tree-view/shared继续提供共享运行时工具，并清理 resolver 中无关的模板注释。
Fixed
- 修复全选、清空、父子联动和受控值回放可能绕过
checked-disabled改变禁用节点状态的问题。 - 修复
mitt通配监听器未接收事件类型的问题。
Tests
- 补充整行点击组合行为、空状态插槽、关键词高亮、普通模式滚动、属性兼容迁移、受控行为切换和共享工具契约测试。
0.2.0 - 2026-07-31
Changed
- 规范组件内部 SCSS 元素类与状态类命名，保留
nodeClass公开样式入口不变。
Tests
- 按结构与展开、选择、懒加载拆分树状态测试，并补齐组件公开事件 payload 的集成链路验证。
0.1.0 - 2026-07-30
Fixed
- npm 发布迁移到 GitHub Actions Trusted Publishing，并支持手动重试已有发布标签。
- 规范 npm 包仓库元数据，并升级 Release workflow 的 Node 环境 Action 至 v7，消除 npm 11 发布警告。
0.0.9 - 2026-07-29
Fixed
- 修复 GitHub Actions 发布标签校验脚本被 shell 提前解析导致发布中断的问题。
- 发布前预检变更日志，并在 bumpp 执行失败且尚未创建提交时自动恢复被修改的跟踪文件。
0.0.8 - 2026-07-29
Added
- 节点整行选择与整行展开开关。
- 增加
node-class一级属性，作为每个节点行的外部样式入口。 - 自定义过滤方法、关键词高亮和空状态插槽。
- scrollToKey、懒加载错误事件和重试方法。
- 大数据虚拟渲染演示和多平台构建说明。
Changed
- Breaking: 选择入口由
showCheckbox更名为selectable，选择控件位置由checkboxPlacement更名为selectionPlacement，旧属性不再保留。 - Breaking: 选中与展开事件统一为
check-change和expand-change，选中事件类型更名为TreeCheckChangePayload。 treeProps只负责id、label、children、disabled、leaf、append、icon数据字段映射；节点行样式统一通过一级nodeClass属性传入。- 优化移动端按压反馈、选择区域、选中态和加载状态。
- 优化文档站示例页实时预览布局：宽屏挂载到右侧栏，窄屏以可折叠卡片展示。
- 文档预览 playground 改用项目 Logo，并移除 H5 路由固定 base 以适配文档内嵌预览。
- Playground 迁移到 Wot UI v2；核心组件仍保持零 Wot UI 依赖。
Removed
- 移除
field、labelField、valueField、childrenField、disabledField、leafField、appendField、iconField等旧字段映射属性，统一使用treeProps。 - 移除
defaultExpandedIds展开别名，统一使用defaultExpandedKeys。 - 移除
change、checked、updated、expand、goChild等历史事件别名。 - 移除
treeProps.class样式映射，改用nodeClass。
Fixed
- 禁用且已选节点继续使用禁用样式。
- 补齐懒加载旋转动画和失败后的重试状态。