鸿蒙 PC 开发者社区 · AtomGit 鸿蒙 PC 社区 · Ionic Framework 框架仓 · Cordova OpenHarmony 宿主框架仓

前言

夜班交接单有两处要反复看。一处是设备编号和断电核对,另一处是留给接班人的文字。班组用窄窗并排看其他资料时,同一时间通常只展开一组。录过的字段随上一节收起,接班人还得确认原来的数据有没有丢,以及修改一个条件以后,屏幕上的「已确认」还算不算数。

我在鸿蒙 PC 上做了一个 Ionic 交接检查单,以设备 B-204 为固定样例,交接事项用「到岗后复检西侧围栏」。这次在 MateBook 14 本机装上 1.0.1,做了两次确认。第一次是把两组填完后的正常确认,第二次发生在撤销了断电核对之后。中间那次撤销能看出回执怎么失效。

同一项操作,表单组却收到两种通知

先打开设备状态,点击「填入演示编号 B-204」。右侧马上出现编号,但完成度仍是 0 / 2。设备组必须同时有设备编号和断电核对,编号单独写进去不能过这一关。打开断电开关后才变为 1 / 2。这一步应当更新草稿和预览,原来的设备区仍保持展开。

复测时,我把开关和点击事项标题分成两个动作。ArkWeb 先留下 ignored child change ION-TOGGLE,随后才留下 expanded notes。前一条说明开关的 ionChange 会冒泡到外层,外层把它识别为子控件事件。后一条发生在真的切换到交接事项时。这两条日志很容易在监听器里被误当成同一类变化。日后若给切换分组加焦点移动或滚动,先检查事件目标,再决定是不是要移动页面。

HandoverCheck ignored child change ION-TOGGLE
HandoverCheck expanded notes code present: true isolated: true note present: false

Ionic 的折叠组管理 asset 和 notes。打开哪个区域由 group.value 表达,字段保存在另一个对象。点击完事项标题,状态里依然有编号和断电结果,事项尚未填写。标题的「已填写/待填写」只显示这一组的完成情况,详细内容一直留在预览。这样做可以在保持折叠节省空间的同时,让操作人逐项核对。设计上参考了带简短摘要的折叠标题。GOV.UK 折叠组件

两次确认之间,撤回了一项核对

切到交接事项后点「填入演示事项」,再回到设备状态。编号输入框读回 B-204,开关仍开着。右侧事项与编号同时在,进度是 2 / 2。第一次点「确认交接」后,预览显示「交接已确认 · HB-214」,按钮变成禁用。HB-214 是项目资料里的固定样例号,状态改变表明本次页面确认通过。

保持编号和事项不动,再把断电开关拨回去。刚才的回执消失,设备组显示待填写,预览显示待核对,进度退回 1 / 2。这个现象比回执成功本身更适合查业务错误。如果页面还把旧回执放在底下,接班人会以为新状态已经得到确认。修正开关以后,进度再次变为 2 / 2,但按钮需要再点一次。在现场项目里,应当由实际的交接系统生成回执,并将确认绑定到提交的数据版本。

我在窄窗再点了第二次确认,页面变成上面填表下面预览,仍显示 HB-214。最后结束本应用进程重新启动,新窗口回到未填状态,进度是 0 / 2。文章里的「保留」范围为当前页面内的折叠、展开与窗口变化;测试没有接本地持久化或后台接口。把这两种情形一起复验,可以给应用的实际行为划出边界。

下方保留 1.0.0 的双端录屏与动图。上面的本机状态和截图属于 1.0.1。

MateBook 14 真机从填表到确认。拍到了填写设备编号、核对断电、折叠、填入事项、重新展开和确认结果。平均 9.41 fps,动作段有效帧率 7.91 fps,无音轨。

MateBook Pro 模拟器折叠与读回。展开、折叠和确认结果均可见,平均 3.61 fps,动作段有效帧率 3.50 fps。来自模拟器连续截图,无音轨。

让当前草稿决定按钮、计数和预览

实现里只有一个草稿对象,包含 assetCode、isolated、note。两个文本控件监听 ionInput,断电开关读 ionChange 的 checked。样例按钮写入组件属性后,也主动调用 update;只改输入框外观,右侧通过业务对象计算的预览可能仍然为空。update 比较新旧值,相同就直接返回,发生真实修改才使 confirmed 归为 false,并重新渲染。

render 先去掉两侧空白,再算 assetReady 和 noteReady。设备组只在编号非空且核过断电时算完成,事项组只要求有有效文字。进度还剩多少直接来自这两项。确认按钮禁用条件与两项是否齐全、是否已经确认一起计算,点击回调再查一遍 disabled。对样例而言,这能避免当同一次确认已经显示在界面上时重复操作控件。以后连接后台时,是否允许重试和重复写入仍要由保存接口处理。

<!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="./handover.css">
  <script type="module" src="./ionic/ionic.esm.js"></script>
  <script defer src="./handover.js"></script>
</head>
<body>
<ion-app><ion-content>
  <main>
    <header class="masthead">
      <div><p class="eyebrow">夜班交接 · 库区 B</p><h1>交接检查单</h1></div>
      <p class="reference">HB-214</p>
    </header>
    <div class="workspace">
      <section aria-labelledby="form-title">
        <h2 id="form-title">交接记录</h2>
        <ion-accordion-group id="steps">
          <ion-accordion value="asset">
            <ion-item slot="header" lines="none" id="heading-asset">
              <ion-label>设备状态</ion-label><span id="mark-asset" class="mark" slot="end">待填写</span>
            </ion-item>
            <div slot="content" class="fields">
              <ion-input id="asset-code" label="设备编号" label-placement="stacked" fill="outline" maxlength="24" placeholder="例如 B-204"></ion-input>
              <ion-toggle id="power-isolated">已核对断电</ion-toggle>
              <button class="sample" type="button" id="fill-example">填入演示编号 B-204</button>
            </div>
          </ion-accordion>
          <ion-accordion value="notes">
            <ion-item slot="header" lines="none" id="heading-notes">
              <ion-label>交接事项</ion-label><span id="mark-notes" class="mark" slot="end">待填写</span>
            </ion-item>
            <div slot="content" class="fields">
              <ion-textarea id="notes" label="留给接班组的事项" label-placement="stacked" fill="outline" maxlength="120" rows="2" placeholder="例如 到岗后复检"></ion-textarea>
              <button class="sample" type="button" id="fill-note">填入演示事项</button>
            </div>
          </ion-accordion>
        </ion-accordion-group>
      </section>
      <aside class="receipt" aria-labelledby="preview-title">
        <div class="receipt-head"><h2 id="preview-title">本次交接预览</h2><span id="progress">0 / 2</span></div>
        <dl>
          <div><dt>设备编号</dt><dd id="preview-code">未填</dd></div>
          <div><dt>断电核对</dt><dd id="preview-power">待核对</dd></div>
          <div><dt>交接事项</dt><dd id="preview-note">未填</dd></div>
        </dl>
        <ion-button id="publish" expand="block" disabled>确认交接</ion-button>
        <p id="status" role="status">请填写设备编号、核对断电,再补交接事项。</p>
      </aside>
    </div>
  </main>
</ion-content></ion-app>
</body>
</html>

分组事件的判断放在事件入口。event.target 不等于 group 就直接返回,具体字段在各自的处理函数更新。折叠只管显示哪组,更新草稿不需要改展开项。若后续将一些折叠内容改为在展开时动态创建,重新创建后要从同一草稿把字段填回组件,否则界面与右侧预览就可能产生两份数据。

'use strict';

const byId = (id) => document.getElementById(id);
const group = byId('steps');
const codeInput = byId('asset-code');
const notesInput = byId('notes');
const isolated = byId('power-isolated');
const publish = byId('publish');
const status = byId('status');

const draft = {
  assetCode: '',
  isolated: false,
  note: '',
};
let confirmed = false;

function render() {
  const code = draft.assetCode.trim();
  const note = draft.note.trim();
  const assetReady = Boolean(code && draft.isolated);
  const noteReady = Boolean(note);
  byId('preview-code').textContent = code || '未填';
  byId('preview-power').textContent = draft.isolated ? '已核对' : '待核对';
  byId('preview-note').textContent = note || '未填';
  byId('mark-asset').textContent = assetReady ? '已填写' : '待填写';
  byId('mark-notes').textContent = noteReady ? '已填写' : '待填写';
  byId('progress').textContent = Number(assetReady) + Number(noteReady) + ' / 2';
  publish.disabled = confirmed || !assetReady || !noteReady;
  status.textContent = confirmed ? '交接已确认 · HB-214'
    : assetReady && noteReady ? '两组内容已齐,可确认交接。'
      : '请填写设备编号、核对断电,再补交接事项。';
}

function update(field, value) {
  if (draft[field] === value) {
    return;
  }
  draft[field] = value;
  confirmed = false;
  render();
}

async function start() {
  await Promise.all(['ion-accordion-group', 'ion-input', 'ion-textarea', 'ion-toggle', 'ion-button']
    .map((tag) => customElements.whenDefined(tag)));
  group.value = 'asset';
  codeInput.addEventListener('ionInput', (event) => update('assetCode', event.detail.value || ''));
  notesInput.addEventListener('ionInput', (event) => update('note', event.detail.value || ''));
  isolated.addEventListener('ionChange', (event) => update('isolated', event.detail.checked));
  group.addEventListener('ionChange', (event) => {
    if (event.target !== group) {
      console.info('HandoverCheck ignored child change', event.target.tagName);
      return;
    }
    console.info('HandoverCheck expanded', group.value || 'none',
      'code present:', Boolean(draft.assetCode), 'isolated:', draft.isolated, 'note present:', Boolean(draft.note));
  });
  byId('fill-example').addEventListener('click', () => {
    codeInput.value = 'B-204';
    update('assetCode', codeInput.value);
  });
  byId('fill-note').addEventListener('click', () => {
    notesInput.value = '到岗后复检西侧围栏。';
    update('note', notesInput.value);
  });
  publish.addEventListener('click', () => {
    if (publish.disabled) {
      return;
    }
    confirmed = true;
    render();
    console.info('HandoverCheck confirmed', 'HB-214', 'fields complete');
  });
  render();
  console.info('HandoverCheck ready');
}

void start();

Ionic 折叠组件的槽位和交互文档

在 MateBook 14 装出这份检查单

项目里有 Cordova 的鸿蒙宿主和 entry,Ionic Core 组件、样式和业务脚本最后从 entry 包内加载。拿到项目源码后,在 MateBook 14 的 DevEco Studio 终端解包,使用 npm pack 取 8.8.19 版本。只抽取 dist/ionic、CSS 和许可证,放到 www/ionic,页面依其相对路径加载。然后在本机运行 OhPM、Hvigor。完整构建日志中有 Cordova 原生模块与 ArkTS 入口,也能看到资源进入 HAP。首轮 43 项任务用时 17.333 秒。

tar -xzf ionic-accordion-form-source.tar.gz
cd IonicAccordionForm
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
app_www=entry/src/main/resources/rawfile/www
mkdir -p "$app_www/ionic"
cp -R package/dist/ionic/. "$app_www/ionic/"
cp package/css/ionic.bundle.css package/LICENSE "$app_www/ionic/"
ohpm install --all
hvigorw --mode module -p product=default -p module=entry@default -p buildMode=debug assembleHap --no-daemon
ls -l entry/build/default/outputs/default/*.hap

本机第一次用「此电脑」运行时,系统拒绝未签名包,输出 9568320。由 DevEco 的签名配置生成调试签名,随后重新组装,签名包 entry-default-signed.hap 为 25,578,293 字节。对准 MateBook 14 安装该包并启动 EntryAbility,从设备回读包名 com.aasd23.ugcionicaccordion,versionName 1.0.1,versionCode 1000001。项目原始的 1.0.0 可能仍在设备上,签名成功后尤其需要核对实际安装版本,才能把后续日志与本次源码对应起来。

验证环境

实际值

开发、编译、签名及实测

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,Node.js 24.18.1,Ionic Core 8.8.19,Cordova OpenHarmony 宿主

工程目标

2in1,目标与兼容 HarmonyOS 6.1.1(API 24),本机调试签名 HAP

旧版模拟器对照

MateBook Pro 2in1,配置 HarmonyOS 6.1.1(API 24),运行镜像 OpenHarmony-6.1.1.125,x86_64,原录屏版本 1.0.0

还有个容易错判的时间点是窗口刚打开。本次签名安装以后,EntryAbility 已经启动,第一帧白底上还看不到 Ionic 的控件,随后才渲染出两张卡片。应等交接表单显示、初始进度为 0 / 2,再开始点开关。脚本用 customElements.whenDefined 等页面依赖的组件注册,再设置默认展开的 asset、绑定事件和做第一次 render。如果在未注册时就把组的初始值或输入事件当成业务失败,排查会落到错误的一层。把「应用已启动」「组件已注册」「表单已能操作」分开记录,能更快找到问题。

本机装完后我还专门核对了一个界面细节。宽窗的两个区域能同时看到,窄窗把按钮和状态提示放到了预览卡的末尾。屏幕首屏可能只露出按钮,没有露出确认结果。我向下滚动,把回执完整滚进取景区,然后读取 HB-214。实际验收应在这里读取按钮下方的结果,再修改断电开关看变化;左侧标题上的 HB-214 只是单据标签,表单没完成时也会出现。

FAQ

顶部写了 HB-214,怎么知道真的确认过? 顶部是示例检查单编号。确认以预览底部出现交接已确认、按钮禁用为准。设备开关改回未核对后,顶部仍保留编号,底部的确认提示应该消失。

点击「填入演示编号」后,为什么还是 0 / 2? 编号只是设备组的一部分。打开断电开关会变为 1 / 2。事项写完才是两组都达到确认条件。做自己的验收数据时,要分别检查每个组最少满足什么,不能看到有文本就当组完成。

以后怎么支持退出后恢复? 当前草稿只在 JavaScript 页面里,结束进程后已复测回到 0 / 2。若要加入恢复,需选择明确的本地存储或服务接口,并决定保存草稿与确认记录的时机。重新启动要分别检查读取到的字段、确认状态和故障恢复,不能把折叠显示继续当作存盘依据。

总结

这一轮最容易误会的地方是同一个窗口里的三种状态。折叠决定现在展开哪一组,草稿决定预览显示哪些字段,确认只在当前数据满足两组条件时成立。照着填完、撤销核对、重新确认、重开应用的顺序走一遍,就能看清每项状态变化发生在哪里。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐