不使用Oracle官方模板创建Oracle JET单页应用 求点击标题/div加载模块指引
Oracle JET 无官方模板下 自定义元素触发模块加载的实现方案
前置必查配置(绝大多数实现失效来源于此处)
- 未正确引入JET核心依赖:不使用官方模板时,需通过模块加载器显式引入
ojs/ojcore、ojs/ojrouter、ojs/ojmodule相关依赖映射,不可依赖脚手架自动生成的依赖配置 - oj-module组件未绑定路由适配器:oj-module本身不感知路由状态,必须通过CoreRouter提供的
createModuleAdapter返回的配置对象完成动态绑定,无法通过静态属性配置实现模块切换 - 路由初始化时机错误:需在
oj.Context.ready()事件触发完成后,再执行路由初始化、事件绑定逻辑,否则会出现组件未渲染、事件绑定失效的问题
分步可落地实现代码
1. 页面结构声明
直接使用普通HTML元素作为触发入口,无需绑定JET专用导航组件:
<!-- 普通headers/div作为触发元素 --> <h2 id="dashboardTrigger" style="cursor: pointer">仪表盘</h2> <div id="userMgmtTrigger" style="cursor: pointer">用户管理</div> <!-- 承载动态模块的oj-module容器 --> <oj-module id="moduleContainer" style="min-height: 400px"></oj-module>
2. CoreRouter路由初始化
在JET上下文就绪回调中完成路由配置,核心逻辑是将oj-module容器与路由的模块适配器绑定:
oj.Context.ready().then(() => { // 初始化根路由,采用hash模式适配单页无刷新场景 const router = CoreRouter.createRouter({ dashboard: { value: "dashboard" }, user: { value: "userManagement" } }, { urlAdapter: new CoreRouter.HashUrlAdapter() }); // 获取oj-module容器,绑定路由提供的模块适配器 const moduleContainer = document.getElementById("moduleContainer"); moduleContainer.config = router.createModuleAdapter({ // 按项目实际目录约定匹配视图、ViewModel路径 viewPath: (state) => `views/${state.value}.html`, viewModelPath: (state) => `viewModels/${state.value}` }); // 启动路由,设置默认加载模块 router.go("dashboard"); // 路由实例挂载到全局,供触发元素调用 window.appRouter = router; });
3. 普通元素的点击事件绑定
直接使用原生DOM事件绑定跳转逻辑,无需依赖JET组件的事件机制:
// 绑定普通标题触发跳转 document.getElementById("dashboardTrigger").addEventListener("click", () => { window.appRouter.go("dashboard"); }); // 绑定普通div触发跳转 document.getElementById("userMgmtTrigger").addEventListener("click", () => { window.appRouter.go("user"); });
常见失效场景排查
- 路由URL正常变化但模块无渲染:检查是否将
createModuleAdapter的返回值正确赋值给oj-module的config属性,若直接给config赋值静态路径,路由状态变化时容器不会响应内容切换 - 点击事件无响应:检查事件绑定逻辑是否在
oj.Context.ready()回调内执行,若在DOM加载初期就绑定事件,此时oj-module组件尚未完成渲染,绑定逻辑会失效 - 模块加载报路径错误:检查
viewPath、viewModelPath的路径大小写、目录结构是否与实际文件完全匹配,JET的模块加载为严格路径匹配,任意路径偏差都会导致加载失败
内容的提问来源于stack exchange,提问作者Uruk
相关产品推荐
相关产品推荐

