鸿蒙 PC 上的 React Native 备件台账,筛掉一半记录后怎样回到原来的物料
框架与适配:React Native for OpenHarmony 适配
一张备件台账可能有几十行。用户进详情复核后,返回列表是为了接着看旁边的记录;在此期间若筛选条件变化,用旧的滚动偏移就未必回到原物料附近。这里给每条物料一个可核对的编号,用邻近行证明 React Native 页面恢复的是谁。
从维修仓接到的任务是找 SP-040,打开详情核对一次,再返回到它附近。我把它做成鸿蒙 PC 上的一次 React Native 台账巡检,给每一步都留了一个邻居。全表里 SP-040 下面是 SP-041,筛掉待入库项以后,下面换成 SP-042。比起盯住滚动条,读这两个编号更容易看出程序是否回到了正确位置。
SP-040 的三次定位
第一次,八十条记录里找第四十条

鸿蒙 PC 模拟器全屏,React Native 台账从 80 条备件定位到 SP-040
React Native 的 scrollToIndex 可以接收新的下标。这个演示把每行高度固定为 58 个布局单位,分隔线放在行内,getItemLayout 的步长和实际行高度一致。这样从 SP-001 跳到尚未渲染的 SP-040 时,FlatList 可以预先计算偏移量。以后如果把分隔线单独放到 ItemSeparatorComponent,那部分高度也要计入偏移。 React Native FlatList 文档
React Native 的 FlatList 只需要知道目标在当前数组里的位置。八十个编号中每个偶数编号在库,定位按钮第一次会把 SP-040 换算为下标 39。行高固定为 58,分隔线画在行内。这样列表可以在目标还未渲染时计算位置。要把行内分隔线挪到组件外,偏移公式也得随实际高度改;设备的桌面分辨率与这里的布局单位是两套量。
第二次,筛选只留下四十条

鸿蒙 PC 模拟器全屏,切到 40 条在库备件后保留 SP-040
此时 SP-040 仍要出现,数组下标却变成 19。拿旧的 39 去定位,结果会落到筛选列表尾部。保存的是编号,在新的集合里重新找位置,筛选逻辑便不用猜测删除了多少前面的行。遇到 SP-001 这种已经从结果移除的锚点,代码改用 SP-002。如果窄窗还开着被筛掉的详情,一起收起,避免表和详情各指一件物料。
import React, {useCallback, useLayoutEffect, useRef, useState} from 'react';
import {FlatList, Pressable, StyleSheet, Text, useWindowDimensions, View, type ViewToken} from 'react-native';
const rowHeight = 58;
const stock = Array.from({length: 80}, (_, i) => ({
id: 'SP-' + String(i + 1).padStart(3, '0'),
name: ['定位销', '密封圈', '传动皮带', '滚珠轴承'][i % 4],
available: i % 2 === 1,
}));
type Part = (typeof stock)[number];
const available = stock.filter(row => row.available);
export default function App() {
const {width} = useWindowDimensions();
const compact = width < 700;
const [filtered, setFiltered] = useState(false);
const [anchor, setAnchor] = useState('SP-001');
const [detail, setDetail] = useState<Part | null>(null);
const [position, setPosition] = useState('SP-001');
const rows = filtered ? available : stock;
const list = useRef<FlatList<Part>>(null);
const pending = useRef<{id: string; reason: string} | null>(null);
const viewability = useRef({itemVisiblePercentThreshold: 95});
const onVisible = useCallback(({viewableItems}: {viewableItems: ViewToken<Part>[]}) => {
if (viewableItems[0]?.item) setPosition(viewableItems[0].item.id);
const id = pending.current?.id;
if (id && viewableItems.some(token => token.item.id === id)) {
console.info('UGC_RNOH_ANCHOR visible id=' + id + ' reason=' + pending.current?.reason);
pending.current = null;
}
}, []);
function go(id: string, data: Part[], reason: string) {
const index = data.findIndex(row => row.id === id);
if (index < 0) return;
pending.current = {id, reason};
list.current?.scrollToIndex({index, animated: reason === 'jump'});
console.info('UGC_RNOH_ANCHOR scroll id=' + id + ' index=' + index + ' reason=' + reason);
}
useLayoutEffect(() => {
if (pending.current?.reason !== 'filter') return;
const id = pending.current.id;
const frame = requestAnimationFrame(() => go(id, rows, 'filter'));
return () => cancelAnimationFrame(frame);
}, [rows]);
function toggleFilter() {
const next = !filtered;
const data = next ? available : stock;
const target = data.some(row => row.id === anchor) ? anchor : data[0].id;
pending.current = {id: target, reason: 'filter'};
setAnchor(target);
setFiltered(next);
if (detail && detail.id !== target) setDetail(null);
}
function open(item: Part) {
setAnchor(item.id);
setDetail(item);
console.info('UGC_RNOH_ANCHOR detail id=' + item.id);
}
function close() {
if (!detail) return;
go(detail.id, rows, 'return');
setDetail(null);
console.info('UGC_RNOH_ANCHOR return id=' + detail.id);
}
第三次,窄窗从详情返回

鸿蒙 PC 模拟器窄窗全屏,覆盖式详情显示 SP-040
缩窗前先打开第一行。宽窗右侧显示当前物料,缩窄后详情占据面板区域,列表仍然挂着。点返回时先用当前筛选后的数据重新定位,再移除详情。若当前可见集合没有改变,未必再出现 visible 日志。此时看新画面首行和返回标记,不能要求每次滚动调用都产生一次新的可见回调。

鸿蒙 PC 模拟器全屏,从详情返回,列表继续显示 SP-040
在真机的窄窗详情里,再找一次 SP-040
React Native 工程先用满足要求的 Node 打包台账入口,宿主用 ARM64 目标重新构建。较长的工程路径让 Windows Ninja 报文件名超过 260 字符;把构建移到较短的工作区路径后,原生模块和自动签名 HAP 都生成了。USB 安装、启动并确认已装版本 1.0.0 后,再开始找备件。
| 运行环境 | 设备版本 | 定位对照 |
|---|---|---|
| HUAWEI MateBook 14(MNTXM-24B) | HarmonyOS 7.0.0,软件 7.0.0.115(SP11C00E103R12P2patch01),API 26.0.0,aarch64 | 签名安装,定位 39、筛选定位 19,窄窗详情返回后仍是 SP-040 |
| MateBook Pro 2in1 模拟器 | HarmonyOS 6.1.0,软件 6.1.0.125(SP12DEVC00E47R1P3),API 6.1.1(24),x86_64 | 同一编号的定位流程和演示 GIF |

MateBook 14 真机关于本机全屏,显示软件版本和 API
先点定位,随后切到「仅看在库」,日志的下标从 39 变成 19。打开 SP-040 详情再缩窄窗口,详情占据内容区。点「返回列表」以后,首个完整可见项仍是 SP-040,下面是 SP-042。这个邻居和全表时的 SP-041 不同,也能看出筛选条件没有丢。

MateBook 14 真机全屏,窄窗显示 SP-040 详情和返回入口

MateBook 14 真机全屏,返回列表后首个完整可见条目仍为 SP-040
MateBook 14 真机全屏录屏。定位 SP-040,再把 80 条备件筛到 40 条在库记录,打开 SP-040 详情。拖窄窗口后返回列表,首个完整可见条目仍是 SP-040。原始 MP4 为 2880 × 1920,整段约 60 fps;拖窗段一秒内有 60 个不同画面。
install bundle successfully.
start ability successfully.
versionName: 1.0.0
UGC_RNOH_ANCHOR scroll id=SP-040 index=39 reason=jump
UGC_RNOH_ANCHOR scroll id=SP-040 index=19 reason=filter
UGC_RNOH_ANCHOR scroll id=SP-040 index=19 reason=return
UGC_RNOH_ANCHOR return id=SP-040
右侧详情在窄窗覆盖列表,下面的列表仍在。这部分参考了 Thunderbird 桌面阅读面板的分区,用空间变化决定详情放哪儿。窗口够宽时可以一边看列表一边看详情,窗口变窄后还原同一条记录,核对的是列表的位置与编号是否连续。返回动作若没改变可见范围,不需要等一条额外的可见回调。
| 操作 | 预期 | 本次观察 |
|---|---|---|
| 在全部记录中定位 SP-040 | 以全部列表下标定位 | 请求下标 39,SP-040 进入可见区域 |
| 切到仅看在库 | 保持编号,以筛选后下标定位 | 请求下标 19,屏幕显示 SP-040 |
| 打开详情并拖窄窗口 | 详情仍为同一物料 | 窄窗覆盖区显示 SP-040 |
| 返回列表 | 继续查看同一备件附近的记录 | 日志记录返回 SP-040,列表仍可见 SP-040 |
scroll id=SP-040 index=39 reason=jump
visible id=SP-040 reason=jump
scroll id=SP-040 index=19 reason=filter
visible id=SP-040 reason=filter
detail id=SP-040
scroll id=SP-040 index=19 reason=return
return id=SP-040
我还在鸿蒙 PC 模拟器上给「请求滚到哪里」和「实际看见什么」留了两种记录。发起滚动时打印编号和下标,列表的可见回调再检查目标是否进入可见范围。界面右上角写的是首个达到可见阈值的编号,便于对着全屏截图读结果。退出详情时列表可能已经停在 SP-040,此时可见集合可以保持不变,截图中的首个完整可见编号和返回事件一起说明当前状态。
return (
<View style={s.page}>
<View style={s.top}>
<View style={s.mark}><Text style={s.markText}>库</Text></View>
<View style={s.topLabel}>
<Text style={s.title}>备件台账</Text>
<Text style={s.sub}>维修仓 · 按物料编号定位</Text>
</View>
{!compact && <Text style={s.count}>{rows.length} 条备件</Text>}
</View>
<View style={s.toolbar}>
<Pressable accessibilityRole="button" style={[s.filter, filtered && s.filterOn]} onPress={toggleFilter}>
<Text style={filtered ? s.darkText : s.action}>{filtered ? '显示全部' : '仅看在库'}</Text>
</Pressable>
<Pressable accessibilityRole="button" style={s.filter} onPress={() => {
setAnchor('SP-040');
go('SP-040', rows, 'jump');
}}><Text style={s.action}>定位 SP-040</Text></Pressable>
</View>
<View style={s.panels}>
<View style={s.listBox} accessibilityElementsHidden={compact && !!detail} importantForAccessibility={compact && detail ? 'no-hide-descendants' : 'auto'}>
<View style={s.listHeader}>
<Text style={s.panelTitle}>备件列表</Text>
<Text style={s.sub}>首个完整可见 {position}</Text>
</View>
<FlatList
ref={list} data={rows} keyExtractor={row => row.id} extraData={anchor}
getItemLayout={(_, index) => ({length: rowHeight, offset: rowHeight * index, index})}
onViewableItemsChanged={onVisible} viewabilityConfig={viewability.current}
renderItem={({item}) => (
<Pressable accessibilityRole="button" style={[s.row, item.id === anchor && s.selected]} onPress={() => open(item)}>
<View style={s.rowLabel}><Text style={s.part}>{item.id}</Text><Text numberOfLines={1} style={s.sub}>{item.name}</Text></View>
<Text style={[s.tag, !item.available && s.tagPending]}>{item.available ? '在库' : '待入库'}</Text>
</Pressable>
)}
/>
</View>
{(!compact || detail) && (
<View style={[s.detail, compact && s.overlay]}>
{detail ? <>
<Pressable accessibilityRole="button" style={s.back} onPress={close}><Text style={s.action}>‹ 返回列表</Text></Pressable>
<Text style={s.detailId}>{detail.id}</Text>
<Text style={s.panelTitle}>{detail.name}</Text>
<Text style={s.sub}>{detail.available ? '在库 · 维修仓' : '待入库 · 收货区'}</Text>
</> : <>
<Text style={s.panelTitle}>物料详情</Text>
<Text style={s.sub}>在左边选择一件备件。</Text>
</>}
</View>
)}
</View>
</View>
);
}
const s = StyleSheet.create({
page: {flex: 1, padding: 22, backgroundColor: '#f1f5fa'},
top: {flexDirection: 'row', alignItems: 'center', gap: 13, marginBottom: 15},
mark: {width: 48, height: 48, borderRadius: 14, backgroundColor: '#243c70', alignItems: 'center', justifyContent: 'center'},
markText: {fontSize: 21, color: 'white', fontWeight: '700'},
topLabel: {flex: 1},
title: {fontSize: 28, fontWeight: '700', color: '#172546'},
sub: {fontSize: 13, color: '#526481', marginTop: 3},
count: {fontSize: 14, color: '#425b88'},
toolbar: {flexDirection: 'row', flexWrap: 'wrap', gap: 8, marginBottom: 14},
filter: {paddingVertical: 8, paddingHorizontal: 13, backgroundColor: '#e5edfd', borderRadius: 8},
filterOn: {backgroundColor: '#243c70'},
action: {fontSize: 14, fontWeight: '600', color: '#243c70'},
darkText: {fontSize: 14, fontWeight: '600', color: 'white'},
panels: {flex: 1, flexDirection: 'row', gap: 13, position: 'relative'},
listBox: {flex: 1, minWidth: 0, overflow: 'hidden', borderRadius: 14, backgroundColor: 'white', borderWidth: 1, borderColor: '#dbe3f0'},
listHeader: {flexDirection: 'row', justifyContent: 'space-between', alignItems: 'center', flexWrap: 'wrap', padding: 13, gap: 6, borderBottomWidth: 1, borderColor: '#e5ebf5'},
panelTitle: {fontSize: 17, color: '#1d2d53', fontWeight: '700'},
row: {height: rowHeight, flexDirection: 'row', alignItems: 'center', justifyContent: 'space-between', paddingHorizontal: 14, borderBottomWidth: 1, borderColor: '#e7edf6'},
selected: {backgroundColor: '#edf2ff'},
rowLabel: {flex: 1, minWidth: 0},
part: {fontSize: 15, fontWeight: '700', color: '#253d6a'},
tag: {fontSize: 12, color: '#236340', backgroundColor: '#e6f4eb', borderRadius: 9, paddingHorizontal: 8, paddingVertical: 4},
tagPending: {color: '#795017', backgroundColor: '#fbefda'},
detail: {flex: 0.72, gap: 9, padding: 20, borderRadius: 14, backgroundColor: 'white', borderWidth: 1, borderColor: '#dbe3f0'},
overlay: {position: 'absolute', top: 0, left: 0, right: 0, bottom: 0},
back: {alignSelf: 'flex-start', marginBottom: 14, paddingVertical: 5},
detailId: {fontSize: 30, fontWeight: '700', color: '#1d2d53'},
});

鸿蒙 PC 模拟器实录,跳转、筛选、打开详情、缩窗与返回
录屏保留 80 个不同画面,共 12.43 秒。缩窄和拉宽窗口的连续变化段约为 18.8 和 18.1 帧/秒。
复测前把 bundle 做对
| 项目 | 本次环境 |
|---|---|
| 开发机 | Windows,DevEco Studio 6.1.1.300,前端 Node.js 24.19.0 |
| 运行端 | MateBook Pro 2in1 模拟器,HarmonyOS 6.1.0,软件 6.1.0.125 (SP12DEVC00E47R1P3),API 24,x86_64 |
| 框架与目标 | React Native 0.84.1,RNOH 0.84.4,HarmonyOS SDK 6.1.1(24) |
| 产物 | 未签名调试 HAP,使用模拟器验证离线启动、列表和详情交互 |

开发机原生 DevEco Studio 关于窗口

MateBook Pro 模拟器原生关于本机,保留系统栏和完整软件版本
为什么换回 DevEco 自带的 Node 后,连 Metro 配置都打不开? 本机自带的是 Node 18.20.1,这个 React Native 工程声明需要 22.11.0 或以上。我第一次误把 DevEco 的 Node 放到前面,Metro 配置在调用 configs.toReversed 时抛出错误。前端打包改用本机 Node 24.19.0 后生成了新 bundle。鸿蒙侧继续用 DevEco 现有工具构建 HAP。
Metro 报错时先读实际用于打包的 Node 版本。这个问题发生在 Windows 开发机上,还没进入鸿蒙 PC 的运行阶段。资源版切回 DevEco 打 HAP,安装以后从包内读 bundle,运行这套台账时不需要一直启动 Metro。若启动后显示的是别的页面,先比前端资源和 HAP 的更新时间,再核对入口指向的文件。
在项目根目录把演示入口放到 App.tsx,使用满足项目版本要求的 Node 打出 bundle.harmony.js,检查文件确实进入鸿蒙模块的 resources/rawfile。鸿蒙 PC 这次让页面入口从资源加载 bundle,安装前再核对 HAP 的目标架构和目标设备。运行时可以用 hilog 搜索 UGC_RNOH_ANCHOR 对照下标和可见记录。
node ./node_modules/react-native/cli.js bundle-harmony --dev false --minify false
./harmony/build.ps1

DevEco Studio 原生编辑区,React Native 鸿蒙入口包含 2in1 声明
后台编辑区的同步提示与本次命令行出包是两条记录。前端用 Node 24 生成 JS 资源,宿主用 DevEco 的工具打 HAP;资源版从 rawfile 加载,不需要打开 Metro。实际复测到的窗口和日志均来自这份离线包。
node ./node_modules/react-native/cli.js bundle-harmony --dev false --minify false
./harmony/build.ps1
& $hdc -t $target install $hap
& $hdc -t $target shell 'aa start -b com.nutpi.myapplication -a EntryAbility'
& $hdc -t $target shell 'hilog -x'
其中 hdc 使用 DevEco SDK 工具,target 选已启动的模拟器,hap 指向 harmony 下本次 assembleHap 产物。初次运行如果显示另一个页面,先查资源文件的更新时间,再检查包内文件和宿主入口,避免拿旧版台账复测。
行名换行之后,为什么刚好总差一条? 排查时先看请求日志里的 ID 和下标。两者正确的话,再量实际行高和分隔线占用。固定 58 的前提是每一行都一样长,鸿蒙 PC 窄窗里的长物料名也只能占一行。多行名称可移到详情,或另行设计测量。后一个方案没有在这次台账中运行。
全表的下标 39 和在库表的下标 19,在 MateBook 14 与模拟器上都对应 SP-040。真机窄窗退出详情以后,也回到这个编号。这里保住的是一次工作中的位置,关进程后能否恢复筛选和锚点,取决于另行设计的存储规则。
更多推荐

所有评论(0)