Skip to content

Vue 2.7 兼容说明 ​

vue-layerx@1.1+ 同包支持 Vue 2.7 与 Vue 3.3+(peerDependencies: ^2.7 || ^3.3)。公开 API 同名同形;日常 open / close / confirm / defineLayer / LayerTemplate / bindHost 在正确配置 model 与容器的前提下,体感应与 Vue 3 基本一致。

已知行为差仅下表几项;Vue 2.7 关键路径由独立集成测试与 CI 门禁覆盖。

安装 ​

bash
pnpm add vue-layerx
# peer: vue@^2.7 或 vue@^3.3
ts
import { createLayer } from 'vue-layerx'

不要使用子路径(无 vue-layerx/vue2)。应用侧请 dedupe vue,避免双副本导致 provide / 全局插件丢失。

与 Vue 3 的主要差异 ​

场景Vue 3Vue 2.7
默认容器 modelmodelValue + update:modelValuevalue + input(其它名仍走 update:${model})
打开后换 container.componentTeleport park,content 可保留无 Teleport → 嵌套 diff 自然 remount,content 状态丢失
LayerNoContainer同构 Teleport + props 投影扁平 h(content) + 同样全投影
Host / providecreateApp + appContext 桥接宿主 Vue.extend + parent: proxy
内部树Teleport → 容器 default 锚点content 直接在容器 default 插槽
类型收窄更强同包 d.ts 编译可用 + happy path;不要求与 Vue 3 同等拒绝强度

容器 model ​

默认与 Vue 3 对齐:Vue 3 → modelValue;Vue 2.7 → value(flat 更新键 onInput → 平台 input)。Element UI Dialog 等用 visible 时需显式声明:

ts
// Vue 2.7 默认(可省略)
const usePopup = createLayer(MyPopup)

// Element UI Dialog
const useDialog = createLayer(ElDialog, { model: 'visible' })

append-to-body ​

与 Vue 3 + Element Plus 相同:容器若 append-to-body,会出现 body 上双挂(LayerApp 根 + Dialog 传送),可接受;一般无感。

官方示例 ​

bash
pnpm demos:vue2   # Vue 2.7 + Element UI,默认 :5174
pnpm demos:vue3   # Vue 3 + Element Plus,默认 :5173(短名 demos)

见仓库 demos-vue2/(model: 'visible'、LayerTemplate、confirm)与 demos-vue3/。文档站导航 Demos 可打开已部署版本(/demos/vue2/、/demos/vue3/)。

测试与保障 ​

Vue 2.7 集成测独立 workspace(tests-vue2),只消费发布产物 dist,覆盖公开 API 关键路径:打开/关闭、confirm、closeOn、响应式配置、model、Host、defineLayer、LayerTemplate、LayerNoContainer、SSR 跳过 mount,以及入口在 Vue 2.7 下可解析。配置合并等共享逻辑由单元测试与 Vue 3 集成共同覆盖(不要求与 Vue 3 用例条数全量对等)。

bash
pnpm build
pnpm test:integration:vue2   # dist 门禁(公开 API 关键路径)

详见 TESTING.md 与文档站 测试与覆盖率。

维护策略 ​

Vue 2 已 EOL。本库将 Vue 2.7 作为正式运行时目标 持续修复兼容问题,但不承诺与 Vue 3 完全相同的支持年限。工程决策背景见 ADR 0008。

MIT Licensed