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适配。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐