鸿蒙 PC 的 Ionic 到货清单,排序后菜单为什么仍要认 RC-305
Ionic Framework的AtomGit上游镜像 · 到货清单完整工程 · 鸿蒙 PC 开发者社区;页面宿主为Cordova OpenHarmony。
先核对回执上的单号
仓库收货时,登记顺序和复核顺序经常不同。到货的三张单按录入时间排好,库管想先处理量大的,就点一次「件数从多到少」。选项还在每行右边,但原来位于第二行的厚板周转箱已经到了第三行。如果弹出来的菜单位置是对的,提交之后变绿的却是另一张单,这次复核就记到了别处。数量统计偏偏仍会从零变一,值班交接时光看右上角很难发现。
在 MateBook 14 上复测时,我把验收条件放在回执里:底部要出现 RC-305,上面也得只有厚板周转箱显示已复核。先不排序,在第二行点「更多」。弹层标题是 RC-305。这次点击取消,回执说状态未变,右上角仍为零。接下来让二十六件的防潮包装袋排第一,十二件的标签纸到第二,七件的厚板周转箱落在最后。现在得从第三行点,菜单仍应指向原来的单号。

确认后的计数从 0/3 到 1/3。切回登记顺序,绿色的「已复核」跟着厚板周转箱回第二行,两边的单没有变化。最后在窄窗里打开同一张单,菜单给出的操作已经变为「改为待复核」。按下后计数回到零,底部写着 RC-305 已恢复待复核。排序阶段、写入阶段和恢复阶段都远离初始页面的默认状态,几张图的对照比只录一次确认更容易看出改动落在哪儿。

| 操作 | 行的顺序 | 实际业务结果 |
| 默认第二行打开再取消 | RC-304、RC-305、RC-306 | 菜单标题 RC-305,0/3 |
| 按件数排序后确认第三行 | RC-306、RC-304、RC-305 | 只有 RC-305 已复核,1/3 |
| 恢复登记顺序 | RC-304、RC-305、RC-306 | 已复核随 RC-305 回到第二行 |
| 窄窗改回待复核 | RC-304、RC-305、RC-306 | 回执指向 RC-305,0/3 |
下方视频和 GIF 保留自此前的真机和模拟器录制,用于连贯地看菜单跟着单号移动。这次本机编译安装的画面见正文全屏图。两个视频的实录帧率见各自图注。
真机到货清单的两次菜单操作。第一次取消,排序移动后第二次打开并写入,再恢复登记顺序。平均 6.14 fps,动作段有效帧率 6.76 fps,无音轨。
模拟器到货清单的同编号操作。平均 3.29 fps,动作段有效帧率 3.44 fps,无音轨。开头和结尾都能看到 RC-305 的行状态。
补录从第二行RC-305的菜单开始,取消后仍为0/3。按件数排序再打开第三行,菜单标题还是RC-305;确认后只有厚板周转箱变为已复核。恢复登记顺序,绿色状态随它回第二行,再从这行改回待复核,计数才归零。每一步都保留了底部对应单号的回执。

采集请求上限60 fps,GIF沿真实可变帧率时序保留151帧、11.96秒,平均12.63 fps。菜单过渡和回执变化均来自实录,没有复制帧或插帧;表格静止时不凭导出参数宣称60个不同业务画面。
同一本机构建目录的1.0.1 HAP已安装到模拟器。重新执行取消、排序、确认、恢复登记与撤回,菜单和回执一直是RC-305,计数0→1→0,两侧其他单均未修改。这次截图替代“模拟器离线”的旧范围;原有视频仍保留它原来的历史批次说明。


菜单开在哪里,数据改到哪里
界面有两套坐标。一个是窗口上的按钮,每次点下「更多」时就在眼前。另一个是收货单的标识,排序前后都保持原样。Ionic 的弹层用前一套坐标。这个页面给 ion-popover 配置 reference 为 trigger、side 为 bottom、alignment 为 end。点击回调拿到的事件交给 present,组件再按当前触发元素和可用空间摆放。窄窗口里不用给弹层单独算一组屏幕偏移。
页面的复核操作用另一套坐标。每张单在 start 中创建自己的卡片和按钮,点击回调捕获 node.id。render 需要改变屏幕上的顺序时,先对数组副本排序,再根据编号取出已经存在的节点。把一个已存在的节点 append 到容器末尾会移动它。循环完以后,卡片和按钮按新的排列显示,按钮绑定的编号没有改。保存原有节点也让这段演示可以直接观察第二行到第三行的迁移。
共享弹层在打开前暂存 selectedId,显示该单编号和对应的操作。只有一个弹层时,这个暂存值就是打开期间的提交目标。弹层还在显示时,其他行的打开请求会提前返回。关闭事件清空它,后续点击才可以接入另一张单。确认回调先拿到实际记录对象,再收起弹层。因此即使关闭事件随后清空 selectedId,回执仍能从已经取到的对象显示编号。
<!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="./receiving.css">
<script type="module" src="./ionic/ionic.esm.js"></script>
<script defer src="./receiving.js"></script>
</head>
<body>
<ion-app>
<ion-content>
<main>
<header><div><p>西区库房 / 白班</p><h1>到货复核</h1></div><strong id="total">0 / 3 已复核</strong></header>
<div class="sorting">
<h2>到货清单</h2>
<button id="sort" type="button" disabled>件数从多到少</button>
</div>
<div id="rows"></div>
<p id="notice" role="status">正在准备菜单。</p>
</main>
</ion-content>
<ion-popover id="review-menu" side="bottom" alignment="end" reference="trigger" show-backdrop="false" aria-label="到货复核选项">
<div class="menu">
<p id="active-id"></p>
<button id="mark" type="button">标为已复核</button>
<button id="cancel" type="button">取消</button>
</div>
</ion-popover>
</ion-app>
</body>
</html>
'use strict';
const nodes = [
{ id: 'RC-304', title: '标签纸补货', units: 12, reviewed: false },
{ id: 'RC-305', title: '厚板周转箱', units: 7, reviewed: false },
{ id: 'RC-306', title: '防潮包装袋', units: 26, reviewed: false },
];
const byId = (id) => document.getElementById(id);
const rows = byId('rows');
const sort = byId('sort');
const menu = byId('review-menu');
const notice = byId('notice');
let selectedId = '';
let orderByUnits = false;
const buttons = new Map();
function render() {
const ordered = orderByUnits ? [...nodes].sort((a, b) => b.units - a.units || a.id.localeCompare(b.id)) : nodes;
for (const node of ordered) {
const card = buttons.get(node.id);
card.querySelector('.state').textContent = node.reviewed ? '已复核' : '待复核';
card.classList.toggle('reviewed', node.reviewed);
rows.appendChild(card);
}
byId('total').textContent = nodes.filter((node) => node.reviewed).length + ' / ' + nodes.length + ' 已复核';
sort.textContent = orderByUnits ? '恢复登记顺序' : '件数从多到少';
}
async function openMenu(id, click) {
if (selectedId) {
return;
}
const node = nodes.find((item) => item.id === id);
if (!node) {
return;
}
selectedId = id;
byId('active-id').textContent = id;
byId('mark').textContent = node.reviewed ? '改为待复核' : '标为已复核';
try {
await menu.present(click);
console.info('ReceivingReview opened', id);
} catch (error) {
notice.textContent = '菜单打开失败。';
selectedId = '';
console.error('ReceivingReview presentation failed', String(error));
}
}
async function start() {
await customElements.whenDefined('ion-popover');
for (const node of nodes) {
const card = document.createElement('article');
card.className = 'row';
const summary = document.createElement('div');
const title = document.createElement('h3');
title.textContent = node.title;
const caption = document.createElement('p');
caption.textContent = node.id + ' · ' + node.units + ' 件';
summary.append(title, caption);
const state = document.createElement('span');
state.className = 'state';
const trigger = document.createElement('button');
trigger.type = 'button';
trigger.textContent = '更多';
trigger.setAttribute('aria-label', node.id + ' 更多操作');
trigger.addEventListener('click', (event) => { void openMenu(node.id, event); });
card.append(summary, state, trigger);
buttons.set(node.id, card);
}
menu.addEventListener('ionPopoverDidDismiss', () => {
selectedId = '';
});
byId('cancel').addEventListener('click', () => {
notice.textContent = selectedId + ' · 已取消,状态未变。';
void menu.dismiss(undefined, 'cancel');
});
byId('mark').addEventListener('click', async () => {
const node = nodes.find((item) => item.id === selectedId);
if (!node) {
return;
}
node.reviewed = !node.reviewed;
await menu.dismiss(undefined, 'apply');
render();
notice.textContent = node.id + (node.reviewed ? ' · 已标为已复核。' : ' · 已恢复待复核。');
console.info('ReceivingReview applied', node.id, 'reviewed=' + node.reviewed);
});
sort.addEventListener('click', () => {
orderByUnits = !orderByUnits;
render();
console.info('ReceivingReview sort', orderByUnits ? 'units' : 'arrival');
});
render();
sort.disabled = false;
notice.textContent = '从对应行的「更多」打开复核选项。';
}
void start();
应用日志可以确认先后顺序。下面几行来自重新打开应用后的实际操作。第一次出现 opened 后点了取消,所以下一条有业务意义的记录是切换件数排序。第二次出现 opened 后按确认,才有 applied。缩窄窗口后的恢复操作在另一轮日志留下 reviewed=false。应用只保存了当前页面内存里的复核值,日志不代表已更新库存系统。
ReceivingReview opened RC-305
ReceivingReview sort units
ReceivingReview opened RC-305
ReceivingReview applied RC-305 reviewed=true
ReceivingReview sort arrival
ReceivingReview applied RC-305 reviewed=false

右上角的数字每次都遍历三条单据重新统计。其中没有单独维护一份累加值。取消时既没改记录,也没修改计数。确认后若只显示行上那枚状态标记却没重算计数,库管需要到下一班才可能发现数字对不上。这里在窄窗反向操作一次,可以一起查三个位置:行标记是否回到待复核,右上角是否减一,最后一条回执是否仍属于刚才那张单。商品名、编号和件数保留原值。
实际接入仓储系统时,业务标识还需要明确到一条可更新的记录。当前三张单各只有一行,单号唯一,所以用 RC-305 即可。如果一张收货单拆成多种货号,就得用记录主键或单据与行项目的组合。验证时挑两条件数相同、状态相同但标识不同的记录,也能检查授权变更是否真的命中一条。否则列表排序正确,业务更新仍有可能改了一整张单。
复现这份离线工程
本次从项目源码副本取出 AppScope、entry、cordova 和构建配置,在 MateBook 14 的「文档」下解包。入口页面、复核状态和调用接口都在 entry 的 rawfile/www 中。cordova 模块负责承载页面,Ionic Core 提供弹层和页面容器。原来的网页脚本仍由项目维护。在鸿蒙电脑自己的 DevEco 终端用 npm 下载指定版本的 Ionic Core,把运行目录和样式拷进项目,再让包管理器解析 Cordova 模块和入口依赖。
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
这个做法把网页运行所需的文件一起打进 HAP。安装后的页面从宿主的资源目录加载,不用每次启动时访问 npm。终端构建第一轮实际执行 43 项任务,用了 18.509 秒。日志指出入口和 Cordova 资源同时声明了 page_text_font_size,本次构建保留先声明的资源并继续成功。字号警告和随后设备安装时的签名错误来自不同阶段。要定位菜单缺失,可以先看页面样式,再查本地 ion-popover 是否成功注册,避免把所有现象都归到资源名重复。
在 IDE 中打开同一个工程,目标选「此电脑」。首个未签名包提交到包管理器后报 9568320(no signature file)。我由项目结构为 default 生成本机调试签名,再构建出 entry-default-signed.hap。MateBook 的调试安装接口读取机内这个文件并成功启动 EntryAbility。用包管理器查回包名 com.aasd23.ugcionicrowmenu、版本名 1.0.1 和版本号 1000001 后才开始验收。刚启动时出现过短暂白色窗口,等三张单和启用后的排序按钮都显示再操作。该流程验证到实际安装,没有上传 AppGallery Connect。
| 环境与产物 | 本次实测信息 |
| 鸿蒙电脑 | 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 Core 8.8.19,Cordova OpenHarmony 宿主,编译与兼容 API 24,2in1 |
| HAP | 未签名 25,276,709 字节,签名 25,578,290 字节,实装 1.0.1 |
| 本轮模拟器1.0.1 | MateBook Pro 2in1;配置HarmonyOS6.1.1(API24),实际软件6.1.0.125(SP12DEVC00E47R1P3),API24,x86_64。同一本机构建1.0.1 HAP,排序前后RC-305取消、确认及恢复待复核通过;原视频为历史批次。 |



FAQ|给复测同事的三条定位线索
菜单能显示,如何确认它认的是用户刚点的单。 在默认第二行打开并取消,然后按件数排序,用排到最后的那个按钮再打开。每次先看弹层标题是否都是 RC-305,再看底部回执和排好序的三行。总数可以对,但仍要逐行看谁变绿。组件的锚点行为可对照 Ionic ion-popover 文档。
刚启动时一片空白,要看哪里。 这轮真机首次启动确认到短暂白色窗面,接着三条数据正常显示。排序按钮初始禁用,等 customElements.whenDefined 返回并注册各行回调后才启用。如果表一直进不来,先确认页面与 ionic.esm.js 一起进入 HAP,并看 Web 控制台的加载错误。看到 installed 和 started 只能确认进程起来了。
退到桌面再开,能当作数据持久化验收吗。 在窄窗确认 RC-305 后我结束进程再启动,实测状态回到 0/3、三条均待复核。只把窗口放到后台,原页面可能没有销毁,回来仍有上一笔并不能说明落盘。要把它发展成真实复核台,应让服务端或本地存储接管持久化,复验时同样结束进程,然后从稳定键读回。
把清单交给下一班
实际交接看的是哪张货单已处理。RC-305从第二行到第三行再回来,取消、确认和恢复都有对应回执。修订工程已在文首固定版本目录公开,读者可从业务脚本追到同包的宿主与本机构建说明;框架入口另用于查看Ionic组件和Cordova适配。
更多推荐

所有评论(0)