更新日志

查看功能、修复和兼容性变化。升级已有项目时，参考迁移指南。

2.2.1

Patch Changes

• #17 81a6e26 Thanks @UzkiS! - 普通方向导航使用单次遍历选择目标，减少候选排序与中间数组；调试与文档继续使用同一打分规则展示完整分析，保持跨组锚点和并列顺序的行为一致。

  附带可独立复制的 Vue 2.7 完整示例，提供 Vite 现代开发、webpack 旧设备开发与 ES5 构建；加入真实 Chromium 30 的生产、开发和热更新回归。完善中英文接入与迁移指南、TypeScript 示例、项目首页与 SEO，并统一演示和完整示例的白粉视觉风格。

2.2.0

Minor Changes

• #10 9142fa3 Thanks @UzkiS! - 完成 TV 导航、焦点恢复、滚动与旧设备兼容的本轮更新。

  • 新增 navigate(direction)：虚拟遥控器等输入方式与方向键使用相同的方向事件和 .prevent 拦截；原有 move() 继续用于直接移动焦点。
  • 保存焦点路径，修复元素卸载或替换后组进出事件失配；焦点失效时优先在仍有效的原分组内恢复，避免穿透弹窗。被禁用的当前项仍可作为移动起点。
  • 组内没有方向目标时逐层派发组级方向事件；跨层候选并列时用当前焦点项的位置裁决。
  • 滚动与导航组解耦：v-epg-scroll 标记实际滚动容器，支持横向、纵向、嵌套容器及 nearest、start、center 对齐；scrollViewport 显式控制文档视口。滚动默认关闭，修复 CSS 缩放下的距离换算。
  • 修复旧内核缺失 KeyboardEvent.code 时无法回退到数字键值的问题，增加 Tizen 与 webOS 返回键；在可编辑元素中把文字、Backspace 和左右方向键交给浏览器。
  • pause() 可独立释放多处暂停；debug 模式输出逐层导航候选，关闭时避免构造日志数据。
  • 更新 Vue 2.7 事件写法、运行时依赖、滚动与性能指南；重整文档导航，加入使用真实库行为的交互 SVG 演示，并修复手机版演示布局。
  • 补充 Vue 2.7 与 Vue 3 的场景测试、类型测试及滚动测试；对 WebView 30 的兼容边界和性能实测方法作出说明。

2.0.0

Major Changes

• #4 8da5da2 Thanks @UzkiS! - 2.0 完整重构。升级前请阅读迁移指南。

  • 移除 vue-demi，零运行时依赖；最低支持 Vue 2.7，产物为 ES2015（兼容 webpack 4 与老旧机顶盒浏览器）
  • 事件改为原生 CustomEvent 并统一加上 epg- 前缀（epg-focus、epg-blur、epg-enter、epg-leave、epg-up 等），用 .prevent 取消默认移动；新增分组的 epg-leave
  • 新增 disabled 选项、插件安装选项、全局属性 $epg、move() 等方法的布尔返回值
  • 修复：元素隐藏或被 KeepAlive 缓存后焦点卡死、分组成员快照过期、卸载分组时可能误删其他分组、重渲染冲掉焦点 class、position: fixed 被误判为隐藏、嵌套 onBack 互相覆盖、Escape 不触发返回等问题
  • API 统一命名（如 getFocusClass、findTarget、getNodeByElement、setKeyAction），完整对照见迁移指南
  • 文档迁移至 GitHub Pages：https://uzkis.github.io/vuEPG/

1.2.2

• 1.x 维护补丁，保留原有 API 与 Vue 2/3 使用方式。
• 修复 Vue 3 中分组 @enter 覆盖 @right、条目 @enter 覆盖 @click 的问题。
• 修复卸载分组时误删其他分组、动态新增的子项无法通过方向键到达，以及移动到空分组时抛错的问题。
• 修复 position: fixed 元素被误判为隐藏、导入时覆盖 document.onkeydown，以及 Escape 不触发返回的问题。
• 补充 Vue 2.7 和 Vue 3 回归测试，更新 1.x 文档。

安装：pnpm add vuepg@^1.2.2。npm 的 legacy 标签指向此版本，latest 仍指向 2.x。

1.2.1

• 更新作者信息与构建脚本

1.2.0

• 新增 back()，可手动触发返回处理

1.1.0

• 新增 pause() / resume()，暂停与恢复按键响应

1.0.0

• 首个正式版本
• 移除对 vue-epg 旧写法的兼容支持