框架与适配 · Ionic Framework 源码镜像 · Cordova OpenHarmony 容器
前言
在仓库出库台,复核员可能连续处理多笔出库单,有时左手拿着纸单,右手只按 Tab 和 Enter。第 #041 单有 12 件货,复核员先打开确认窗核对目的地。如果没有看清,就取消一次,回到单据页再开。这个过程中要检查两件独立的事:取消时单据仍然待复核,关掉弹窗以后手指再按一次 Enter 就能继续。
本文在鸿蒙 PC 上用 Ionic 负责弹窗的开关、焦点圈定和关闭事件,Cordova 把页面装进鸿蒙应用。下面先把同一张单据走两遍,再看为什么界面亮着一个焦点轮廓,键盘却未必能接着用。最后给出 MateBook 14 从取源码到签名安装的复现步骤。
按键实测从出库单 #041 开始
本轮对刚安装的鸿蒙 PC 应用进行验证。让页面接收键盘,Tab 切到「打开确认」,按 Enter,观察焦点轮廓落在「取消」。在弹窗打开后不再点击页面,用 Enter 取消,再用同一个键打开。下一轮在弹窗内按 Tab 移到「确认」,最后按 Enter 完成出库。

MateBook 14 真机全屏。Ionic 弹窗打开后,初始焦点落在取消。

MateBook 14 真机全屏。首次按 Enter 后仍待复核,焦点回到打开确认。

MateBook 14 真机全屏。重新打开并确认以后,出库单 #041 已出库。
两条日志记录的是关闭后的状态。取消和确认共用同一条焦点恢复路径,选择的关闭角色只影响业务结果。第二次打开是另一项检查,即页面拿回来的焦点确实能触发确认窗。
role=cancel focus=open approved=false width=1103
role=confirm focus=open approved=true width=1103
role=cancel focus=open approved=true width=543
把窗口缩到 543 后,又打开一次并取消。页面保留刚才已经确认的状态,焦点仍能回到原按钮。这个窄窗用例验证的是取消本次弹窗,前一次已经发生的出库保持原状。视口宽度取自页面脚本,读数和桌面屏幕的像素分辨率分别记录。

MateBook 14 真机全屏。视口宽 543 时再次取消,出库状态保留且焦点恢复。
按钮为什么会从 DOM 里消失
我先在最小版里试过把按钮写进普通 HTML 的 template。Ionic 弹窗能出现,但它的内容空白,控制台在注册按钮处理函数时返回 Cannot set properties of null。这一版直接在 ion-modal 里放静态子节点。页面等到组件定义完成,再等 componentOnReady() 返回后启用按钮。页面结构和确认窗的布局参考了 Atlassian 的确认对话框示例,标题、说明和操作区分别呈现。
我把页面里用于显示结果的节点和负责确认的节点分开。先从当前文档找外层的 Ionic 弹窗,再从弹窗子树找两枚按钮。样式单独负责把按钮放在右侧以及画出焦点轮廓。这样调试空弹窗时,可以先检查节点是否真的存在,再检查它可不可见。避免在一段连事件都还没注册的代码上反复调颜色和焦点。
index.html
<!doctype html>
<html lang="zh-CN">
<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/approval.css">
<script type="module" src="ionic/ionic.esm.js"></script>
<script defer src="js/index.js"></script>
</head>
<body>
<ion-app>
<ion-header class="ion-no-border">
<ion-toolbar><ion-title>仓库作业台</ion-title></ion-toolbar>
</ion-header>
<ion-content>
<main>
<header class="order-heading">
<div><p class="eyebrow">出库复核</p><h1>出库单 #041</h1></div>
<span id="order-state" class="order-state">待复核</span>
</header>
<dl class="details">
<div><dt>发货仓</dt><dd>东区一号仓</dd></div>
<div><dt>目的地</dt><dd>设备维护中心</dd></div>
<div><dt>出库数量</dt><dd>12 件</dd></div>
</dl>
<section class="order-action" aria-label="出库操作">
<div><h2>确认出库</h2><p id="status" role="status">正在加载组件</p></div>
<button id="open" class="primary" type="button" disabled>打开确认</button>
</section>
<ion-modal id="approval" aria-labelledby="dialog-title" backdrop-dismiss="false">
<div class="dialog">
<p class="eyebrow">出库单 #041</p>
<h2 id="dialog-title">确认这笔出库?</h2>
<p>确认后,12 件备件将标记为已出库。</p>
<div class="dialog-actions">
<button id="cancel" class="secondary" type="button">取消</button>
<button id="confirm" class="primary" type="button">确认出库</button>
</div>
</div>
</ion-modal>
</main>
</ion-content>
</ion-app>
</body>
</html>
css/approval.css
:root { color-scheme: light; font-family: system-ui, sans-serif; color: #17252f; }
ion-toolbar { --background: #12332f; --color: #f6fffc; --min-height: 57px; }
ion-content { --background: #eef4f2; }
main { width: min(820px, calc(100% - 48px)); margin: 46px auto; }
h1, h2, p, dl, dd { margin: 0; }
h1 { font-size: clamp(30px, 5vw, 44px); line-height: 1.15; }
h2 { font-size: 20px; }
.order-heading, .order-action { display: flex; align-items: center; justify-content: space-between; gap: 16px; }
.eyebrow { margin-bottom: 8px; font-size: 13px; font-weight: 700; color: #32685f; }
.order-state { background: #f6e8cc; color: #674718; padding: 7px 11px; border-radius: 20px; white-space: nowrap; }
.order-state.confirmed { background: #d7eee5; color: #154e41; }
.details { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); margin: 24px 0 14px; }
.details div { padding: 15px; border-top: 1px solid #c8d9d3; }
dt { color: #486158; font-size: 13px; }
dd { margin-top: 7px; font-size: 18px; font-weight: 650; }
.order-action { padding: 22px; background: #fff; border: 1px solid #d6e5df; border-radius: 14px; }
#status, .dialog > p:not(.eyebrow) { margin-top: 8px; color: #486158; line-height: 1.55; }
button { border: 1px solid transparent; border-radius: 8px; padding: 9px 15px; font: inherit; font-weight: 650; white-space: nowrap; cursor: pointer; }
button:focus-visible { outline: 3px solid #32685f; outline-offset: 3px; }
button:disabled { opacity: .55; }
.primary { color: #fff; background: #20594f; }
.secondary { color: #20594f; border-color: #c8d9d3; background: #f4f8f6; }
ion-modal { --width: min(460px, calc(100% - 30px)); --height: auto; --border-radius: 15px; --backdrop-opacity: .35; }
.dialog { padding: 27px; }
.dialog h2 { font-size: 25px; }
.dialog-actions { display: flex; justify-content: flex-end; gap: 10px; margin-top: 25px; }
@media (max-width: 570px) {
main { width: calc(100% - 28px); margin: 24px auto; }
.details div { padding: 12px 6px; }
.details dd { font-size: 15px; }
.order-action { align-items: flex-start; flex-direction: column; padding: 15px; }
}
看到关闭事件,还得再等一次画面更新
按钮显示出来以后,还有第二个问题。最小版在 ionModalDidDismiss 里立即调用 open.focus(),实测取消后日志还显示 focus=confirm,确认后则显示 focus=cancel。这说明在读取焦点的那一刻,它仍在弹窗内部。最终将恢复动作放进 requestAnimationFrame,在下一帧请求将焦点还给触发按钮。复测时两个关闭分支都得到 focus=open。相关事件见 Ionic Modal 文档。
这里有两个时序。打开之后,ionModalDidPresent 负责把键盘交给取消按钮,让 Enter 默认执行保守的操作。关闭时先取 role,只有确认才修改出库状态。真正把键盘交回页面发生在后一帧,焦点和结果日志跟着这次调用一起读。日后往弹窗里加别的操作时,把这个顺序留着。即使新增一种关闭方式,取消类动作也可以沿用恢复焦点的部分。
复现这个问题时,我会让打开确认的按钮和弹窗里的确认按钮分别带可辨认的焦点样式。只看弹窗消失之前的轮廓,很容易把关闭动画期间的状态当作最终结果。应用在关闭事件之后等一帧,再把焦点交回打开按钮。日志就放在焦点设置之后,读取活动元素和页面状态,避免只纪录一次调用。测试时也得分清浏览器已经收到了回车和窗口管理器刚把焦点切给应用这两件事。初次运行如果按键没有任何反应,先激活应用窗口,用 Tab 确认焦点进入网页,再从待复核的订单开始计数。重新做一次的时候仍用同一张单,才能对照取消和确认到底改动了哪些状态。
js/index.js
(async () => {
const modal = document.querySelector('#approval');
const open = document.querySelector('#open');
const status = document.querySelector('#status');
const state = document.querySelector('#order-state');
let approved = false;
await customElements.whenDefined('ion-modal');
await modal.componentOnReady();
open.disabled = false;
status.textContent = '等待复核。';
open.addEventListener('click', () => modal.present());
modal.querySelector('#cancel').addEventListener('click', () => modal.dismiss(null, 'cancel'));
modal.querySelector('#confirm').addEventListener('click', () => modal.dismiss(null, 'confirm'));
modal.addEventListener('ionModalDidPresent', () => modal.querySelector('#cancel').focus());
modal.addEventListener('ionModalDidDismiss', event => {
const role = event.detail.role;
if (role === 'confirm') {
approved = true;
state.textContent = '已出库';
state.classList.add('confirmed');
}
requestAnimationFrame(() => {
open.focus({ preventScroll: true });
status.textContent = role === 'confirm' ? '已确认出库。' : '已关闭确认窗,出库状态未变化。';
console.info('UGC_IONIC_MODAL role=' + role + ' focus=' + document.activeElement.id
+ ' approved=' + approved + ' width=' + window.innerWidth);
});
});
})();

模拟器实录,键盘打开、取消、重新打开并确认,随后拖动窗口
下方是此前在 MateBook 14 录制的键盘演示,依次展示取消、重新打开和确认出库。本轮本机重建对应上面几张全屏图、项目截图和真实日志。

此前 GIF 留作窗口布局对照。取消与确认后焦点恢复以本轮的键盘复测和日志为准。
在鸿蒙电脑备齐 Ionic 页面,再生成安装包
在鸿蒙版 DevEco Studio 中打开 IonicApprovalFocus。工程包含 Ionic 页面和 Cordova 宿主源码,宿主的 ARM 与 x86 OpenSSL 库是适配依赖。本轮在 MateBook 14 上重新编译应用和宿主,在同一台电脑用 npm 获取 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 本机编辑和构建、调试签名和安装、宽窄窗键盘对照 |
| 工程构建 | Ionic 8.8.19,Cordova 14.0.2,目标和最低兼容 API 均为 24 | npm 取 Ionic 静态资源,OHPM 安装鸿蒙依赖,Hvigor 组装 HAP |
| 此前模拟器对照 | MateBook Pro 2in1,软件版本 6.1.0.125(SP12DEVC00E47R1P3),API 24,x86_64 | 验证 Ionic 弹窗、返回焦点与 1101 宽视口 |
在鸿蒙版 DevEco Studio 中打开工程目录。入口页面是 entry/src/main/resources/rawfile/www/index.html,它从同一个目录下的 ionic/ 读组件模块和样式。打开 IDE 的终端切到工程根目录,保留完整的模块目录和相对路径。Ionic 的入口会加载其他模块块文件,所以只拿入口或样式出来,包即使能生成,弹窗也可能无法初始化。
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

MateBook 14 本机终端中,Ionic Approval Focus 的 43 项构建任务执行完成。
第一次组装耗时 17 秒 74 毫秒。初次构建用于确认 Web 资源和原生宿主能打包,正式复测还要走本机签名。用 IDE 打开 AppScope 和入口模块的字符串资源,将 app_name 和 EntryAbility_label 改为 Ionic Approval Desk,应用包名保留 com.aasd23.ugcionicprobe,并把版本号设置为 1.0.1、版本代码设置为 1000001。这样安装日志和桌面窗口可以对应到这次重建的应用。
在 DevEco Studio 项目结构打开 Signing Configs,使用已登录的开发者账号为当前包名生成调试签名。等同步完成,把运行目标设为「此电脑」并运行。IDE 本机再次构建并生成 entry-default-signed.hap,随后安装到当前 MateBook 14,启动 EntryAbility。安装后的版本用设备包管理结果核对。读者换用自己的应用标识时,请同步调整签名配置再运行。本篇以签名、安装和业务验收为交付范围。

MateBook 14 本机 DevEco Studio 打开实际工程,运行目标为此电脑,控制台可见 signed HAP 安装和启动。

MateBook 14 真机关于本机全屏。型号、完整系统版本和 API 用于核对环境。

此前运行的 MateBook Pro 2in1 模拟器关于本机全屏,作为 API 24 兼容性对照。
这次在鸿蒙 PC 模拟器里,两条键盘结果都出自网页视口宽 1101 的窗口。复现时可以先保持这个宽度,测试完键盘,再把窗口拖窄。单据上半部用三列展示发货仓、目的地和数量。窄窗下主要变化在操作区,提示和按钮从同一行改成上下排列。鸿蒙 PC 桌面上的窗口尺寸和网页内部的视口宽度分别读取,写断点时用后者。

鸿蒙 PC 模拟器全屏,Ionic 审单页缩窗后仍保留单据状态和操作入口
FAQ
焦点轮廓出现了,可以跳过第二次打开吗? 轮廓能告诉我样式画在哪个控件上,日志能查当时的活动元素,下一次 Enter 才能验证那枚按钮继续接受键盘输入。三条证据出自同一轮操作时,才能把关闭后那一步说清楚。
刷新页面还能看到已出库吗? 这个示例把结果放在内存里,刷新后从初始单据再开始。鸿蒙 PC 上实际接入出库接口时,还要增加接口确认、重复提交和失败回退的测试。宽窗里验证过的焦点恢复也需要在真机键盘上另测。
总结
Ionic 弹窗的两个关闭角色最终都交还焦点,于是复核员可以连着做取消、重开和确认。实测把输入动作、单据变化和活动元素放在一起看,能定位是页面焦点断了,还是业务状态更新错了。这个做法也适用于面向键盘操作的退料确认和巡检确认。换成异步出库接口时,应单独验证请求失败和回焦之后的重试。
转载自 CSDN-专业IT技术社区



