鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗

欢迎加入开源鸿蒙 PC 社区

欢迎在 PC 社区平台申请新建项目

框架与适配 · Ionic Framework 源码镜像 · Cordova OpenHarmony 容器

AtomGit 文章与演示素材

前言

巡检员在设备页录入一半编号,要缩窄窗口给资料腾位置。Ionic 这时会把常驻目录切成覆盖菜单。真正要保住的是编号和当前页的状态。用户应该能从窄窗菜单进交接记录确认刚才那台设备,再回巡检页继续填。

这篇用同一个 Ionic 页面实例跨过 730 CSS 像素的布局条件。开发时曾遇到目录收走以后菜单按钮也消失的问题。下面先看按钮是怎样恢复的,再拿本机签名安装的程序做两轮对照,观察同一会话和关闭重开分别会发生什么。

第一次把巡检台拖窄,目录没了,菜单按钮也没了。鸿蒙 PC 模拟器的日志已经写了 wide=false,表单里还有 DEV-042。这个组合把排查范围缩到了 Ionic 的导航入口。应用知道自己进了窄窗,用户却找不到走进交接页的路。

断点已经触发,按钮去了哪儿

第一次缩窄后找不到菜单入口,怎么定位? 首轮测试的日志已经报告 wide=false,草稿也还在,但鸿蒙 PC 窄窗的工具栏没有显示原来使用的 ion-menu-button,交接步骤因此无法继续。复测时改用原生按钮,以同一布局状态控制显隐,点击调用 Ionic 的 menu.open()。改完后,交接页和返回页都记录到 DEV-042。

鸿蒙 PC 模拟器全屏,窄窗打开覆盖式巡检菜单

我把原来的 ion-menu-button 换成普通按钮,显示条件直接跟随布局事件。点击它再调用 Ionic 菜单自己的 open()。这使两项工作可以独立检查。先拖窗看按钮是否出现,再点按钮看覆盖菜单能否打开。原来的失败记录只有宽度状态,没有进入交接的事件。修过后,两个证据都有了。

Ionic 的 ion-split-pane 接受一段媒体查询。我这里把 when 写成 (min-width: 730px),看的是 WebView 内容区域宽度。桌面模拟器总分辨率会保持不变,真正拖动的是应用窗口,窗框也会占去一部分宽度。复现时如果只看模拟器的 3120×2080,很难判断为什么侧栏忽然变成覆盖菜单。要对的是布局事件和 WebView 的视口。 Ionic Split Pane 文档

复制代码
<!doctype html>
<html lang="zh-CN" mode="md">
<head>
  <meta charset="utf-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <title>设备巡检台</title>
  <link rel="stylesheet" href="./ionic/ionic.bundle.css" />
  <link rel="stylesheet" href="./css/split.css" />
  <script type="module" src="./ionic/ionic.esm.js"></script>
  <script defer src="./js/split.js"></script>
</head>
<body>
<ion-app>
  <ion-split-pane id="split" when="(min-width: 730px)" content-id="primary">
    <ion-menu id="menu" content-id="primary" type="overlay">
      <ion-content>
        <nav aria-label="巡检目录" class="nav">
          <div class="brand"><span class="brand-mark">巡</span><b>设备巡检台</b></div>
          <ion-item id="inspection-link" button detail="false" lines="none" aria-current="page">设备检查</ion-item>
          <ion-item id="handoff-link" button detail="false" lines="none">交接记录</ion-item>
        </nav>
      </ion-content>
    </ion-menu>
    <div class="ion-page" id="primary">
      <ion-header class="ion-no-border">
        <ion-toolbar>
          <ion-buttons slot="start"><button id="open-menu" type="button" aria-label="打开巡检目录" hidden>☰</button></ion-buttons>
          <ion-title>运维工作台</ion-title>
        </ion-toolbar>
      </ion-header>
      <ion-content>
        <main>
          <p id="layout" class="layout"></p>
          <section id="inspection" aria-labelledby="inspection-title">
            <h1 id="inspection-title">设备检查</h1>
            <p class="description">填入巡检点位上的设备编号,交接前可随时回来补写。</p>
            <div class="card">
              <ion-input id="draft" label="设备编号" label-placement="stacked" fill="outline" placeholder="例如 DEV-042"></ion-input>
              <p id="draft-status" class="muted">设备编号待填写</p>
            </div>
          </section>
          <section id="handoff" aria-labelledby="handoff-title" hidden>
            <h1 id="handoff-title">交接记录</h1>
            <div class="card">
              <p class="muted">本次巡检设备</p>
              <p id="handoff-id" class="handoff-id">待填写</p>
            </div>
          </section>
        </main>
      </ion-content>
    </div>
  </ion-split-pane>
</ion-app>
</body>
</html>

检查入口时,用的是 WebView 内容宽度而不是模拟器的物理屏幕宽度。在同一张 3120 × 2080 的桌面上拖窗,视口会过 730 CSS 像素,屏幕分辨率不会变。倘若宽窗总出现菜单按钮,先确认实际视口到线了,再检查组件已初始化、两个 content-id 指向同一个内容区,以及配置有没有沿用默认断点。

草稿留在原来的输入框里

ion-menu 和 ion-split-pane 都用 content-id="primary" 指向同一个内容区,工具栏里的按钮跟随当前布局状态显示,点击后调用已关联菜单的 open()。跨过断点后,Ionic 负责改变目录显示方式。脚本只读取 ionSplitPaneVisible 的结果来更新提示。设备检查和交接记录通过 hidden 控制可见性,输入组件始终留在同一棵 DOM 里;窄窗选完目录项后,再由代码收起覆盖菜单。这里用同一份输入作为草稿来源,窗口布局的切换不会重建设备编号控件。

页面脚本先等 ion-split-pane、ion-menu 和 ion-input 完成注册和初始化,再监听它们的事件。直接在文档刚解析时读取 draft.value,容易把组件未就绪时的空值当成草稿丢失。这里把同一值同步到巡检页的草稿提示和交接页摘要,两处都读取原输入。复现时可先用不同编号核对切页是否更新摘要,再返回输入框继续修改,避免只看一个静态标题就推断草稿已经同步。

复制代码
(async () => {
  const pane = document.querySelector('#split');
  const menu = document.querySelector('#menu');
  const openMenu = document.querySelector('#open-menu');
  const draft = document.querySelector('#draft');
  const layout = document.querySelector('#layout');
  const status = document.querySelector('#draft-status');
  const handoffId = document.querySelector('#handoff-id');
  const nav = {
    inspection: document.querySelector('#inspection-link'),
    handoff: document.querySelector('#handoff-link'),
  };
  await Promise.all([customElements.whenDefined('ion-split-pane'),
    customElements.whenDefined('ion-menu'), customElements.whenDefined('ion-input')]);
  await Promise.all([pane.componentOnReady(), menu.componentOnReady(), draft.componentOnReady()]);
  let section = 'inspection';
  let wide = matchMedia(pane.getAttribute('when')).matches;

  function render(reason) {
    const value = String(draft.value ?? '');
    openMenu.hidden = wide;
    layout.textContent = wide ? '目录常驻' : '目录可从菜单打开';
    status.textContent = value ? '当前草稿 · ' + value : '设备编号待填写';
    handoffId.textContent = value || '待填写';
    document.querySelector('#inspection').hidden = section !== 'inspection';
    document.querySelector('#handoff').hidden = section !== 'handoff';
    for (const [name, link] of Object.entries(nav)) {
      if (name === section) link.setAttribute('aria-current', 'page');
      else link.removeAttribute('aria-current');
    }
    console.info('UGC_IONIC_INSPECT reason=' + reason + ' wide=' + wide
      + ' section=' + section + ' value=' + value);
  }

  pane.addEventListener('ionSplitPaneVisible', event => {
    wide = event.detail.visible;
    render('layout');
  });
  draft.addEventListener('ionInput', () => render('input'));
  for (const [name, link] of Object.entries(nav)) {
    link.addEventListener('click', async () => {
      section = name;
      render('navigate');
      if (!wide) await menu.close();
    });
  }
  openMenu.addEventListener('click', async () => { if (!wide) await menu.open(); });
  render('ready');
})();

鸿蒙 PC 模拟器全屏,宽窗输入 DEV-042,左侧目录常驻

鸿蒙 PC 模拟器全屏,拖窄后目录收起,设备编号仍在输入框内

填上 DEV-042 以后再拖窗口。宽窗与窄窗里都是同一份输入,因此这次没必要在每次折叠时另存再读回。脚本分别记住当前选中的页面和侧栏状态。进交接时右侧读出已有编号,返回时原输入框重新可见。假如页面改用会销毁组件的路由,草稿就需要搬到两个页面都能读取的状态层,再做同一套对照。

鸿蒙 PC 模拟器全屏,进入交接页后看到同一个设备编号

鸿蒙 PC 模拟器全屏,回到设备检查并重新拉宽窗口

交接记录能读到什么

从 MateBook 14 刚安装的 1.0.1 开始。在宽窗的设备检查页输入 DEV-MB14-042,然后缩窄到目录收起。设备编号和输入框下面的草稿提示仍显示相同内容。工具栏同时出现菜单按钮。

MateBook 14 真机窄窗全屏。常驻目录收起,输入值和菜单入口都在。

用新出现的按钮打开菜单,选「交接记录」。菜单收起,页面显示的设备编号仍是 DEV-MB14-042。再开菜单并返回「设备检查」,输入框仍有原值。两次导航发生在同一个进程,日志写出页名、布局状态和当时的值。

MateBook 14 真机窄窗全屏。交接记录读到了相同设备编号。

MateBook 14 真机窄窗全屏。返回设备检查,输入框保留之前输入。

复制代码
49651 navigate wide=false section=handoff value=DEV-MB14-042
49651 navigate wide=false section=inspection value=DEV-MB14-042
51087 ready wide=true section=inspection value=

拉宽以后目录重新常驻,草稿也还在。我再完全结束应用并重开,新进程的输入区是空的,日志在 ready 后也记录了空值。两个结果分别验证了同一会话的输入保留,以及进程退出时该版本的草稿边界。

MateBook 14 真机全屏。恢复宽窗后目录重新展开,草稿仍在。

MateBook 14 真机全屏。退出重开后的新进程使用空白设备输入框。

下方保留此前真机的连贯录屏,编号是 DEV-042。本轮用 DEV-MB14-042 重走流程,并补拍了完全退出后的结果。

下面的表格保留此前 MateBook Pro 2in1 模拟器的测试。模拟器中输入的编号为 DEV-042,真机本轮的编号为 DEV-MB14-042。

模拟器操作 预期 记录
在宽窗键入 DEV-042 目录常驻,输入框有草稿 宽窗日志带 DEV-042
把应用窗口拖窄 菜单改用覆盖式打开 布局事件报告宽窗为 false,草稿仍在
从菜单进入交接记录 交接页显示当前编号 窄窗导航日志带 DEV-042
回到设备检查,拉宽窗口 输入仍在,目录恢复常驻 返回和拉宽日志保留同一编号

宽窗常驻目录让读者同时看到当前位置和切换入口。窄窗覆盖菜单选中目的页后收起,让当前任务回到主内容区。目录可以切换呈现方式,所以复测还要看草稿归属,确认导航结构改变以后输入值仍由同一个页面管理。

模拟器连续录屏,显示宽窗填写、缩窗、进出交接页和拉宽

上方 GIF 是此前模拟器的菜单切换对照。本机重新签名安装后的操作见前面的实测图和日志。

在鸿蒙电脑装好这份巡检目录

在鸿蒙版 DevEco Studio 打开 IonicSplitDraft。巡检页和交接记录在 entry/src/main/resources/rawfile/www/index.html,布局切换和草稿同步在同目录的 js/split.js。Ionic 8.8.19 的模块、分块和样式从 npm 在这台鸿蒙电脑取得。Cordova 14.0.2 提供 WebView 宿主,OpenSSL 库属于适配依赖。

复制代码
npm pack --ignore-scripts @ionic/core@8.8.19
tar -xzf ionic-core-8.8.19.tgz package/dist/ionic package/css/ionic.bundle.css package/LICENSE
mkdir -p entry/src/main/resources/rawfile/www/ionic
cp -R package/dist/ionic/. entry/src/main/resources/rawfile/www/ionic/
cp package/css/ionic.bundle.css package/LICENSE entry/src/main/resources/rawfile/www/ionic/
ohpm install --all
hvigorw --mode module -p product=default -p module=entry@default -p buildMode=debug assembleHap --no-daemon

不要只拷贝 Ionic 的入口 JS。初始化时会再按相对路径读取子模块,少一个分块就有可能让 ion-menu 迟迟未就绪。装依赖和运行窗口分开判断,先看构建输出,再看页面是否出现两项导航和设备输入区。本机第一轮打包执行 43 项任务,耗时 17 秒 992 毫秒。

MateBook 14 本机终端。IonicSplitDraft 的宿主编译与 HAP 组装完成。

在 DevEco Studio 的项目结构先生成 com.aasd23.ugcionsplit 的调试签名。选择运行目标「此电脑」,构建并安装签名包。之后在设备上核对包名、1.0.1 版本和 1000001 版本代码。看到标题「Ionic 巡检目录」以及「设备巡检」输入区后开始复测。

|-------|----------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------|
| 环境 | 型号、系统与工具 | 本次范围 |
| 开发和安装 | HUAWEI MateBook 14(MNTXM-24B),HarmonyOS 7.0.0,软件版本 7.0.0.115(SP11C00E103R12P2patch01),API 26.0.0,aarch64;鸿蒙版 DevEco Studio 26.0.0.220,目标与兼容 API 24 | 本机取依赖、开发、编译、调试签名安装,检查草稿 |
| 此前模拟器 | MateBook Pro 2in1,软件版本 6.1.0.125(SP12DEVC00E47R1P3),API 24、x86_64 | 原有菜单失效和修复后的窗口变化 |

MateBook 14 真机 DevEco Studio 工程版本、签名 HAP 安装和本机启动日志。

MateBook 14 真机关于本机全屏,系统版本与 API 用作验证依据。

FAQ

日志已经说目录隐藏,为什么还得手动打开菜单? ionSplitPaneVisible 表明页面跨过布局条件,事件本身只更新宽窄状态。页面使用该值控制工具栏按钮是否显示,窄窗由按钮调用 menu.open(),点中目的页再调用 menu.close()。复现时可以观察按钮返回和菜单遮罩消失两个阶段。

设置里的屏幕分辨率要跟断点对得上吗? 断点使用 WebView 内容区的 CSS 像素。同一台设备从宽窗跑到窄窗,显示器的分辨率保持相同,WebView 的内容宽度会变。判断断点以页面状态和事件日志为准,设备像素用于描述截图。

关掉再开能接着填吗? 这版从同一个 ion-input 读取草稿,切换页时只加减隐藏状态。真机重新启动后的新页面没有原有值。要支持隔天续填,应增加以巡检任务为键的持久化,并另做写盘失败、任务变更和重开读回的验收。

总结

Ionic 接管的是侧栏在宽窗与窄窗间的变化。输入框仍留在页面实例里,所以从窄窗菜单切到交接再回到设备检查,编号能对得上。把读回条件写清楚后,维护者就可以分别检验菜单能否操作、草稿能否跨页,以及关闭后是否需要额外保存。

相关推荐
jianqiang.xue1 小时前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai
程序猿追4 小时前
鸿蒙 PC 用 Tauri 迁移配置文件,先保留旧版再写新版
华为·harmonyos
码间留白1 天前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
二流小码农1 天前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
威哥爱编程1 天前
模拟面试智能体开发实战 12:每篇都能跑不等于接起来能跑,端到端联调收官把十一块拼图合成一个能用的智能体
python·agent·harmonyos
威哥爱编程1 天前
模拟面试智能体开发实战 11:报告只躺在后端怎么复盘,把总评搬上手机还要适配大小屏
python·agent·harmonyos
我闪了个去1 天前
一个 Scroll 撑起整个首页:HarmonyOS 7 懒加载布局把网格、瀑布流、吸顶分组装进一次滚动
harmonyos·arkts
二流小码农2 天前
鸿蒙开发:router组件升级,彻底告别手动配置
android·ios·harmonyos
威哥爱编程2 天前
模拟面试智能体开发实战 09:把面试官装进手机,鸿蒙端聊天界面用 SSE 流式输出让回复逐字滚出来
python·agent·harmonyos