You need to enable JavaScript to run this app. 不使用Oracle官方模板创建Oracle JET单页应用 求点击标题/div加载模块指引
优惠活动
大模型
产品
解决方案
定价
更多

不使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.22 15:15:08