鸿蒙PC 窗口与桌面基础交互实战:用 ArkUI 三栏弹性骨架,把截图标注工作台做成桌面级工具
鸿蒙PC 窗口与桌面基础交互实战:用 ArkUI 三栏弹性骨架,把截图标注工作台做成桌面级工具
欢迎加入开源鸿蒙PC社区: https://harmonypc.csdn.net/
欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper
前言:手机应用的界面只有一块「几乎不变」的屏幕,鸿蒙PC 的界面却同时有三样会变的东西:窗口可以被鼠标拖着改大小、指针可以停在任意一个像素上、用户会同时开着 IDE 和文档并在多个窗口之间来回切。本文不空谈「桌面适配」,而是拆一个真实跑在鸿蒙PC 上的小工具「鉴屏 · Scrimark」——一个给截图做矩形圈选、箭头指引、隐私模糊与批注确认的三栏工作台。它只用 ArkUI 声明式框架与 ArkTS 写成,没有一行三方 UI 依赖,却把三件桌面交互的硬骨头都碰了一遍:固定栏与弹性栏的宽度预算、指针坐标落在哪个坐标系、以及「胶片带 → 画布 → 标注清单」三段主从关系如何只认一个事实源。文中所有代码都逐行核对自配套工程
Scrimark_ohos,五张截图是鸿蒙PC 真机的整屏截图(系统状态栏、Dock 与托盘同时入镜);同时也会如实写出这份演示原型里真实存在的三处缺陷,以及把它们改对的增量代码。
关键词:鸿蒙PC、鸿蒙 PC、开源鸿蒙PC、窗口与桌面基础交互、ArkUI、ArkTS、声明式 UI 框架、三栏布局、layoutWeight、指针坐标、主从联动、2in1 自由窗口、window 模块、AppStorage、AtomGit。
一、边界先行:五张截图、一个工程、一份演示数据
写桌面交互的文章,最容易犯的错是「把设计稿当实机、把占位图当截图能力、把一次点击当交互闭环」。所以开头先把三件事的边界摊开讲清楚。
第一,五张图都是鸿蒙PC 的完整桌面,不是应用窗口的裁剪图。 每张图顶部都是鸿蒙PC 的系统状态栏(左侧日期与时间「11月15日 下午10:25」,右侧一排托盘图标),底部是系统 Dock(搜索、文件、图库、应用市场、音乐、浏览器、微信等),中间才是运行中的「鉴屏」。这种取景是刻意的:只要系统 Dock 与状态栏同时入镜,读者不需要相信作者的任何一句话,就能确认这是鸿蒙PC,而不是某个把任务栏画得像桌面的网页。
第二,配套工程是一套「桌面工作台原型」,不是系统级截图工具。 工程目录 项目源码/Scrimark_ohos,AppScope/app.json5 里 bundleName 为 com.scrimark.studio,vendor Scrimark Lab,versionCode 1000000,versionName 1.0.0;entry/src/main/module.json5 只声明 deviceTypes: ['2in1'],EntryAbility 挂了 entity.system.home 与 action.system.home(可被设为桌面启动器);build-profile.json5 中 compatibleSdkVersion 与 targetSdkVersion 都是 26.0.0(HarmonyOS,API 26)。全工程只有 6 个 .ets 文件、约 22 KB:pages/Index.ets(433 行,页面骨架与全部交互)、common/Models.ets(数据模型与 5 条演示数据)、common/Theme.ets(色板与字号阶梯)、components/KindBadge.ets(工具图标)、components/MarkRow.ets(清单行)、entryability/EntryAbility.ets(二十来行入口)。没有三方库,没有网络请求,oh-package.json5 里 license 为 Apache-2.0。
第三,界面里那 5 张「截图」是渐变占位,不是真实屏幕捕获。 左侧胶片带的缩略图由 ShotItem.bgA / bgB 两个色值线性渐变画出,画布里的四个「幽灵方块」是四个 52×52、白色 14% 透明度的圆角矩形,用来示意真实截图里的表单项。这是演示原型的取舍:把「截图来源」抽象成一对色值,才能在没有系统截图权限、没有相册读写的环境里稳定复现同一套布局与交互。若要把原型做成能用的工具,正确方向是 window.Window.snapshot() 取窗口 PixelMap,再交给图库或文件系统落盘——这是后话,不属于当前工程的已完成能力。
还有一处必须先承认:entry/src/main/ets/entryability/EntryAbility.ets 全文只有二十来行,做的事就是 windowStage.loadContent('pages/Index', ...) 加两句 hilog,没有调用任何窗口属性 API。截图里那个可以最大化、可以悬浮在 IDE 之上的窗口,完全来自 2in1 设备形态与系统默认窗口装饰,应用自己没有写一行窗口控制代码。这不是缺陷,而是本文的叙述顺序:先把「内容区里的桌面交互」做对(第三到七章),再把「窗口本身」接进来(第八章,五十来行可粘贴的增量代码)。
边界讲清楚之后,问题反而更聚焦:当窗口宽度是一条连续信号、指针位置是一条精确坐标、用户注意力在三个面板之间跳转时,一个鸿蒙PC 应用靠什么保证「所见即所点、所点即所改」?
二、逐张读图:鸿蒙PC 桌面上的五帧
图 1:全屏工作台,三栏与两条横向带

图 1 鸿蒙PC 真机完整桌面:顶部系统状态栏,底部系统 Dock;前台「鉴屏」为最大化窗口,自上而下是品牌顶栏、标签筛选带、三栏主体(胶片带 / 画布 / 标注工具与清单),最底部一行灰色提示条
图 1 是全屏态,也是这套界面信息密度最高的一帧。结构自外向内分四层。
第一层是系统给的窗口装饰:左上角窗口标题「鉴屏」,右上角最小化、最大化、关闭三枚按钮。应用没有自绘标题栏,拖拽移动、双击最大化、边缘缩放全部交给鸿蒙PC 窗口管理器——这是 2in1 上最省力也最不容易与系统手势打架的做法。很多桌面应用喜欢自绘标题栏,结果双击标题栏不最大化、拖到屏幕边缘不触发分屏,用户第一分钟就会觉得「这不是个正经桌面软件」。
第二层是品牌顶栏:左侧「鉴屏 · Scrimark」22 号加粗标题,下面一行 12 号灰色副标题「截图标注与批注工作台 · 演示原型」;右侧两组读数——青柠色「5 / 截图」与橙色「6 / 待确认标注」,中间用一条 30 高竖分隔线隔开。把「有多少张截图、有多少条待确认」做成常驻读数,是桌面工作台跟手机应用最直观的差别:手机一屏只干一件事,桌面一屏要同时回答「我在哪、还有多少没干完」。
第三层是标签筛选带:白底、下边框一条浅灰线,左侧小字「标签筛选」,右侧五枚胶囊 chip——全部、UI 评审、缺陷报告、操作指引、公告配图。「全部」处于深灰选中态,右侧四枚是浅灰未选态。这排 chip 的实际高度只有 5+5+约 16 ≈ 26 vp,却是整个界面的「入口开关」:它决定左侧胶片带显示几条,后面第五章会讲它和中栏选中态之间有多容易打架。
第四层是三栏主体。左栏「胶片带」固定 250 vp 宽,白卡圆角 14,内部纵向滚动五张缩略卡:设置页_深色模式切换、桌面_小组件长按态、导出对话框_三栏布局、首页横幅_活动期、列表页_空态占位,每张卡有渐变缩略图、左上角「待确认 N」小徽标、标题、时间与标注数。当前选中的「列表页_空态占位」用 2 vp 深墨描边加浅黄底标出,这是左栏唯一的选中态;筛选带里的选中态则用深灰底表示,两套视觉语言互不干扰。
中栏是弹性画布:标题行左边是截图名「列表页_空态占位」,右边是尺寸「1440×900」与绿色标签徽标「缺陷报告」;下面是一整块圆角 12 的深色画布,用 160° 线性渐变模拟截图底图,中央偏下四个幽灵方块,画布上有两枚标注:橙色实线框「R5 空态插图」(待确认)与青色圆角批注「N4 文案缺失」(待确认)。画布下方一行灰字:「提示:画布点击位置为演示占位取点,标注框尺寸由当前工具默认值决定」——这句话很诚实,它承认了坐标映射是「演示占位」,第四章会把它彻底改对。
右栏固定 280 vp 宽:上半是标注工具六宫格(矩形、箭头、画笔 / 模糊、批注、颜色轮),当前工具用深灰底加白字;下半是「标注清单」,右上角橙色「待确认 6」,下面只有两行清单卡(R5、N4),每行有彩色圆点、标题、作者与状态、右侧一枚未勾选的圆形 Checkbox。清单卡用浅橙底加橙色边框表示「待确认」,与顶栏的橙色读数呼应。
这一帧最值得抄走的不是配色,而是横向信息的组织方式:品牌顶栏放全局读数,筛选带放过滤入口,三栏放「源 → 内容 → 操作」。用户在桌面上的视线是横向扫的,把「全局」放最上面、「局部」放两侧、「操作对象」放中间,符合鼠标从左上到右下的阅读惯性。
图 2:自由窗口、IDE 同框,画布被压窄的证据

图 2 鸿蒙PC 真机完整桌面:背景是 DevEco Studio 打开 Scrimark_ohos 工程(左侧工程树、右侧编译输出),前台「鉴屏」是一个未最大化的自由窗口,只有系统默认标题栏、没有自绘标题栏,画布被两侧固定栏压得更窄,底部灰色提示文案换行成两行
图 2 是全文最关键的一张「真机证据」:背景里能看到 DevEco Studio 的工程树——Scrimark_ohos、AppScope、entry、hvigor、oh-package.json5、build-profile.json5;前台是同一个工程的运行界面。左边 IDE 在写,右边应用在跑,这是鸿蒙PC 上最典型的开发姿态,也是「应用窗口是系统里的一等公民」的直观说明。
这张图还暴露了一个纯桌面才有的现象:窗口没有最大化时,三栏的宽度分配立刻变得紧张。左右两条固定栏(250 + 280)不动,中栏 layoutWeight(1) 只能吃剩下的空间,画布被压成一个偏窄的竖长方形,底部提示文案从一行变成两行。界面没有崩,但「画布是主角」的视觉权重被两侧栏抢走了。这不是 bug,而是固定栏优先的布局策略在窄窗口下的必然结果:ArkUI 的 Row 里,带固定宽度的子节点先拿走自己的尺寸,带 layoutWeight 的子节点只分剩余空间。剩余空间一旦小于画布的可用下限,被牺牲的一定是画布,而不是固定栏。
所以「窗口与桌面基础交互」的第一个工程问题不是动效,而是最小可用窗口宽度:三栏全展开到底需要多少 vp?低于这个值该折叠谁?第三章给出算式。
图 3:主从切换之后,清单全部定稿

图 3 鸿蒙PC 真机完整桌面:胶片带选中「导出对话框_三栏布局」,画布切换为墨绿渐变,三枚标注 R3 / A2 / N3 全部为已定稿态,右侧清单三行全部勾选,右上角仍然写着「待确认 6」
图 3 演示的是「主从切换」:在左栏点击第三张卡,中栏标题、尺寸、标签徽标、画布底色、标注集合、右栏清单会在同一帧内整体换掉。五个位置同时变,用户却感觉是「一个动作」——这正是主从布局的价值:选择是唯一入口,其余全是派生。
这一帧里 R3 步骤一、A2 步骤二、N3 勾选导出项三枚标注均为青色实线/圆角批注,右侧清单三行都打了勾,作者写着「周原 · 已定稿」「沈望 · 已定稿」。工具盘里「批注」是深灰选中态,说明用户刚用批注工具加过 N3。
但请注意右上角:三行全部已定稿,面板右上角仍然写着橙色的「待确认 6」。这不是我看错,而是 totalOpen() 统计的是全部 5 张截图的待确认总数,而清单只列当前这一张的标注。全屏时这个数字差别不明显,用户一旦开始逐张确认,就会觉得「勾了三个怎么还是 6」。这是一个真实的计数口径缺陷,第六章给出改法:顶栏保留全局数,面板改成「本图 x / 全部 y」两个读数。
图 4:标签筛选把胶片带从 5 张收窄到 2 张

图 4 鸿蒙PC 真机完整桌面:顶部「缺陷报告」chip 为深灰选中态,胶片带只剩「桌面_小组件长按态」与「列表页_空态占位」两张,中栏画布为紫色渐变,标注 R2 抖动区域、P1 轨迹圈选、N2 缺少删除确认均为待确认
图 4 是筛选生效的一帧。「缺陷报告」被选中后,左栏只剩两张卡,数量从 5 变 2,滚动条消失,卡片间距不变。这里有一个很容易忽略的交互细节:筛选改变的只是「可选集合」,不应该改变「当前选中项」——除非当前选中项被筛掉了。图 4 里中栏仍然是「桌面_小组件长按态」,因为这张卡恰好属于缺陷报告,选择得以保留;如果用户先选「设置页」(UI 评审),再切到「缺陷报告」,activeId 仍然指向一张已经不在列表里的截图,中栏会继续显示它,左栏却找不到任何选中态。这个「列表里没有、画布上却有」的状态,是主从布局最常见的失配,第五章给出 applyFilter() 的修法。
图 4 的画布是紫色渐变(#4A3F55 → #241E2C),三枚标注分别是橙色矩形「R2 抖动区域」、酸黄画笔圈选「P1 轨迹圈选」、青色批注「N2 缺少删除确认」,作者分别是沈望与林可。三种标注用三种颜色区分「谁提的、什么类型」,这在评审场景里比在清单里读一行文字快得多——桌面屏幕大,信息可以并行铺开,这是鸿蒙PC 相比手机最大的交互红利。
图 5:切回「全部」,胶片带恢复 5 张

图 5 鸿蒙PC 真机完整桌面:同一张截图、同一组标注,唯一变化是筛选带回到「全部」,胶片带重新铺满 5 张卡,选中态仍停在「桌面_小组件长按态」
图 5 与图 4 是同一张截图、同一组标注,唯一变量是筛选 chip 从「缺陷报告」切回「全部」。左栏从 2 张恢复 5 张,选中态仍然稳定停在第二张。这一对前后帧是本文唯一的「对照实验」:它证明了筛选只影响集合,不影响选择——前提是代码真的这么写。Index.ets 里的 filterChip 只干了一件事 this.tagFilter = idx,没有去校准 activeId,所以这次恰好正确,下次就可能失配。
把五张图连起来读,一条桌面交互的因果链就出来了:窗口(图 2 的自由窗口)决定内容区有多宽 → 内容区的三栏骨架决定画布有多大 → 画布的坐标系决定点击落在哪里 → 主从选择决定改哪一张 → 清单与计数决定改到什么程度算完成。 后面五章就按这条链条逐段拆。
三、三栏骨架:固定 + 弹性 + 可折叠
Index.ets 的 build() 是一条很长的 Column:顶栏、筛选带、主体三栏、底部提示。真正决定桌面观感的是主体那一层 Row,代码原文如下(省略了内部子节点):
// entry/src/main/ets/pages/Index.ets
Row({ space: 14 }) {
Column() { /* 胶片带:标题 + Scroll + ForEach 缩略卡 */ }
.width(250)
.height('100%')
.padding(14)
.backgroundColor(Pal.card)
.borderRadius(14)
Column({ space: 10 }) { /* 画布:标题行 + Stack + 提示条 */ }
.layoutWeight(1)
.height('100%')
Column({ space: 12 }) { /* 标注工具 + 标注清单 */ }
.width(280)
.height('100%')
.padding(16)
.backgroundColor(Pal.card)
.borderRadius(14)
}
.width('100%')
.layoutWeight(1)
.padding(16)
.backgroundColor(Pal.canvas)
.alignItems(VerticalAlign.Top)
这段二十来行的骨架,藏着三个桌面布局的判断。
判断一:两侧固定、中间弹性。 左栏 250 是「一列 96 高缩略图 + 两行文字」的最小可读宽度;右栏 280 是「两列工具按钮 + 一行清单」的最小可点宽度。这两个数字不是审美,是内容决定的。中栏必须弹性,因为画布是唯一「越宽越有用」的区域——用户拖大窗口,期望的是图变大,而不是工具栏变宽。
判断二:间距与内边距也要计入宽度预算。 三栏之间有 space: 14 两段,外层 padding(16) 两段:14×2 + 16×2 = 60 vp。所以三栏骨架的「非画布开销」是 250 + 280 + 60 = 590 vp。若给画布留 320 vp 的可用下限(再小就无法容纳一枚 22% 宽、带文字的标注框),三栏全展开的物理下限就是 910 vp。
// entry/src/main/ets/common/Theme.ets(建议新增的布局常量)
export const RAIL_LEFT: number = 250; // 胶片带
export const RAIL_RIGHT: number = 280; // 标注工具 + 清单
export const RAIL_GAP: number = 14; // 两段间距
export const STAGE_PAD: number = 16; // 外层内边距
export const CANVAS_MIN: number = 320; // 画布可用下限
export function minWindowW(): number {
return RAIL_LEFT + RAIL_RIGHT + RAIL_GAP * 2 + STAGE_PAD * 2 + CANVAS_MIN; // 910
}
写成函数而不是写死 910,是因为四个常量任何一个调整,下限都要跟着变。把「预算」写成算式,是桌面布局最便宜的一种自我文档化。
判断三:固定栏不会给弹性栏让位。 这是 ArkUI 的布局语义,也是很多移动端开发者第一次做桌面布局时最不适应的地方:Row 先满足固定宽度的子节点,再把剩余宽度分给 layoutWeight 的子节点。窗口窄到 700 vp 时,两侧栏仍然各拿 250 与 280,中栏只剩 700 - 590 = 110 vp,画布变成一个细条,标注框文字被裁掉,点击落点全挤在一起。界面「没报错」,但对桌面用户来说已经不可用。
所以窗口与桌面基础交互的第一条硬规则是:要么给窗口设最小尺寸,要么在窄窗口下主动折叠一栏,二者至少做一件。 图 2 正是没做这两件事时的样子——它还能用,只是因为窗口大约还有一千多 vp 的宽度,画布被压窄但没压死。
折叠策略要选「信息密度最低」的一栏。本工程选择折叠右栏(标注工具 + 清单):左栏承载「源」,中栏承载「对象」,右栏承载「操作」,而操作可以在选中标注后以浮层或底部抽屉补上;反过来若折叠左栏,用户就失去了切换截图的入口,损失更大。第八章给出折叠所需的条件渲染代码。
四、指针落点:windowX 和 x 不是同一个坐标系
桌面交互跟触屏交互最本质的差别,不是「能不能 hover」,而是指针位置可以被复现、被记录、被断言。触屏上「点歪了」用户自己再点一次;桌面上同一坐标点两次必须落在同一个语义对象上,否则自动化、批注、协作全都不成立。
先看工程里这段真实的点击回调:
// entry/src/main/ets/pages/Index.ets(改造前)
Stack() {
/* 渐变底图、幽灵方块、ForEach 标注 */
}
.width('100%')
.layoutWeight(1)
.borderRadius(12)
.clip(true)
.onClick((ev: ClickEvent) => {
let area = ev.windowX;
this.addMark(20 + (Math.floor(area) % 50), 20 + (Math.floor(ev.y) % 40));
})
这段回调里有三个问题。
问题一:混用两个坐标系。 ClickEvent 同时提供三类坐标:x / y 是相对于被点击组件左上角的局部坐标;windowX / windowY 是相对于窗口内容区的坐标;displayX / displayY 是相对于整块屏幕的坐标。上面的代码用 windowX 当横坐标、用 y 当纵坐标,等于把窗口坐标系的 x 和组件坐标系的 y 拼在一起。用户把窗口往右拖 200 vp,同一处点击就会被记成偏右 200 的位置;而两者的原点、量纲都不同,拼出来的点没有任何几何意义。
问题二:% 50 不是比例,是取模。 标注位置本该是「画布内百分比」,代码却用 windowX % 50 得到 0–49 的整数,再加 20,于是横坐标永远落在 20%–69%,与画布真实宽度无关。画布 1400 宽和 320 宽,点同一个位置会得到不同的相对落点;点最左边和最右边,可能落到同一个值。这类「看起来在归一化、其实在截断」的写法,比直接写死坐标更难排查,因为它的输出永远是合法范围内的数字,不会报错。
问题三:w / h 是死字段。 MarkItem 里有 w: 22, h: 16,但渲染时只用了 .position({ x: m.x + '%', y: m.y + '%' }),标注框的实际尺寸由内部文字与 padding(4) 撑开,w / h 从未参与布局。也就是说,数据模型宣称「标注框是 22% × 16%」,界面却给出一个随文案长度变化的框。这种「模型与渲染不一致」在演示里无伤大雅,在协作里就是灾难:A 看到的框和 B 看到的框不一样大。
改法分三步:拿局部坐标、换成百分比、把尺寸真正交给模型。
// entry/src/main/ets/pages/Index.ets(改造后)
@State canvasW: number = 1;
@State canvasH: number = 1;
@State pointerX: number = 0;
@State pointerY: number = 0;
private addMarkAt(localX: number, localY: number): void {
const pctX = (localX / Math.max(1, this.canvasW)) * 100;
const pctY = (localY / Math.max(1, this.canvasH)) * 100;
this.addMark(pctX, pctY);
}
Stack() {
/* ... 同上 ... */
}
.onAreaChange((_old: Area, now: Area) => {
this.canvasW = now.width as number; // Area.width 是 Length,需断言成 number
this.canvasH = now.height as number;
})
.onMouseMove((ev: MouseEvent) => {
this.pointerX = Math.round(ev.x); // 桌面专属:状态栏显示指针位置
this.pointerY = Math.round(ev.y);
})
.onClick((ev: ClickEvent) => {
this.addMarkAt(ev.x, ev.y); // x / y 才是组件内局部坐标
})
标注节点上补两行,让 w / h 真正生效,并且点击标注时不要冒泡成「再加一个标注」:
Column({ space: 4 }) {
Text(m.label).fontSize(F.caption).maxLines(1)
}
.width(m.w + '%')
.height(m.h + '%')
.position({ x: m.x + '%', y: m.y + '%' })
.hitTestBehavior(HitTestMode.Block)
.onClick((ev: ClickEvent) => {
ev.stopPropagation(); // 阻止冒泡到画布
})
hitTestBehavior(HitTestMode.Block) 与 stopPropagation() 是两道保险:前者让标注节点自己吃掉命中测试,后者兜住事件冒泡。只写其中一道也能工作,但两道都写,行为最可预测。这里还有一个必须承认的边界:百分比定位 + 固定像素文字,标注框的右边缘在下限画布(320 vp)里仍可能溢出,因为文字宽度不随百分比缩放。彻底的做法是把标注框内容改成固定比例缩放(scale + constraintSize),或者在 addMark() 里按「最坏标签宽度 ÷ 画布宽度」动态收窄 x 的上限——本文的改造版取的是后者的保守简化值:x 钳在 4%–76%、y 钳在 4%–72%。
最后一个桌面细节值得单独说:onMouseMove 把指针 vp 坐标写进底栏,是「桌面感」最廉价的来源。用户在拖框、对齐、量间距时,会本能地找一个数值确认;触屏应用没有这个需求,因为它没有悬停态。给指针一个可读的读数,等于告诉用户「这个界面知道你的鼠标在哪」。
五、主从联动:activeId 必须是唯一事实源
三栏布局最容易出问题的地方不是样式,而是「谁是选中项」这件事被存了几份。本工程里与主从关系相关的只有三个状态:activeId(当前截图)、tagFilter(当前标签,-1 表示全部)、tool(当前工具)。设计上很干净,但筛选与选择之间的约束没有写进代码。
先看现状:
// entry/src/main/ets/pages/Index.ets(改造前)
@State shots: ShotItem[] = ShotStore.shots;
@State activeId: string = ShotStore.shots[0].id;
@State tagFilter: number = -1;
private filtered(): ShotItem[] {
if (this.tagFilter < 0) {
return this.shots;
}
let out: ShotItem[] = [];
for (let s of this.shots) {
if (s.tag === this.tags[this.tagFilter]) {
out.push(s);
}
}
return out;
}
@Builder
filterChip(name: string, idx: number) {
Text(name)
/* ...样式... */
.onClick(() => {
this.tagFilter = idx; // 只改筛选,不校准 activeId
})
}
问题在最后一行:tagFilter 变了,activeId 没变。用户选中「设置页」(UI 评审)后切到「缺陷报告」,左栏只剩两张卡、两张卡都没有选中描边,中栏却继续渲染「设置页」的画布与清单。用户此时的心理活动是「我筛选了,为什么还看着一张不在列表里的图」,而代码里没有任何一处会报错——这就是桌面端最典型的「状态一致但不自洽」。
修法不是加一个 if,而是把「筛选」升级成一个事务:改筛选、校验选择、必要时回退到列表首项。
// entry/src/main/ets/pages/Index.ets(改造后)
private filtered(idx: number): ShotItem[] {
if (idx < 0) {
return this.shots;
}
const want: ShotTag = this.tags[idx];
const out: ShotItem[] = [];
for (let s of this.shots) {
if (s.tag === want) {
out.push(s);
}
}
return out;
}
private applyFilter(idx: number): void {
this.tagFilter = idx;
const list = this.filtered(idx);
if (list.length === 0) {
this.activeId = ''; // 空集合:中栏显示空态,而不是最后一张图
return;
}
let keep: boolean = false;
for (let s of list) {
if (s.id === this.activeId) {
keep = true;
}
}
if (!keep) {
this.activeId = list[0].id; // 选择跟随筛选
}
}
@Builder
filterChip(name: string, idx: number) {
Text(name)
/* ...样式... */
.onClick(() => {
this.applyFilter(idx); // 唯一入口
})
}
filtered() 从「读 this.tagFilter」改成「接收参数」,看着只是签名变化,实则消除了一个隐患:筛选函数不再隐式依赖全局状态,applyFilter() 里先算集合还是先改状态都不影响结果,也就不会出现「用旧筛选算新集合」的时序错位。ArkUI 的状态更新是批处理式的,这种隐式依赖在简单页面里通常察觉不到,一旦同一帧内有多个状态变更就会冒出来。
this.tags[idx] 也有讲究。tags 是 private tags: ShotTag[] = ['UI评审', '缺陷报告', '操作指引', '公告配图'],tagFilter 存的是数组下标。这带来两个脆弱点:一是数组顺序一旦调整,所有历史状态与持久化数据都会指向错误标签;二是 -1 这个哨兵值没有任何类型保护,写成 -2 也不会报错,只是永远筛不出东西。更稳的做法是让 tagFilter 直接存 ShotTag | '',空字符串表示全部:
@State tagFilter: ShotTag | '' = '';
private filtered(): ShotItem[] {
if (this.tagFilter === '') {
return this.shots;
}
const out: ShotItem[] = [];
for (let s of this.shots) {
if (s.tag === this.tagFilter) {
out.push(s);
}
}
return out;
}
这样 filterChip 只需要传标签本身,不再传下标,ForEach(this.tags, ...) 的第二个参数 i 也可以删掉;相应地,applyFilter 里先赋值再调用 this.filtered() 即可,校验逻辑不变。数据即契约:状态里存业务值,不存它在某个数组里的位置。
还有一个桌面规模的细节:左栏 ForEach(this.filtered(), ...) 每次筛选都会整块重建,键是 s.id + this.tagFilter.toString()。5 张截图时没问题;真实工具里一个人可能有 5000 张截图,这时应该换成 LazyForEach + IDataSource,并给 Scroll 设 cachedCount(6),让屏幕外的缩略卡不参与构建。从 ForEach 迁到 LazyForEach 的代价主要是数据源要包一层 BasicDataSource,收益是滚动时不再一次性创建全部节点——这在鸿蒙PC 的鼠标滚轮高频率滚动下尤其明显。
六、待确认闭环:清单行、计数口径与不可变更新
右栏的「标注清单」是这个工作台唯一有「完成」语义的地方。每行是一个 MarkRow,核心代码只有 40 行:
// entry/src/main/ets/components/MarkRow.ets
@Component
export struct MarkRow {
@Prop item: MarkItem | null = null;
onToggle: (id: string) => void = () => {};
build() {
if (this.item !== null) {
Row({ space: 10 }) {
Circle().width(10).height(10).fill(this.item!.color).margin({ top: 2 })
Column({ space: 2 }) {
Text(this.item!.label).fontSize(F.sub).fontColor(Pal.ink)
Text(this.item!.author + (this.item!.state === 'draft' ? ' · 待确认' : ' · 已定稿'))
.fontSize(F.caption)
.fontColor(this.item!.state === 'draft' ? Pal.signal : Pal.teal)
}
.alignItems(HorizontalAlign.Start)
.layoutWeight(1)
Checkbox()
.select(this.item!.state === 'done')
.selectedColor(Pal.teal)
.onChange(() => {
this.onToggle(this.item!.id);
})
}
.width('100%')
.padding(10)
.borderRadius(10)
.backgroundColor(this.item!.state === 'draft' ? Pal.signalSoft : Pal.card)
.border({ width: 1, color: this.item!.state === 'draft' ? Pal.signal : Pal.line })
}
}
}
这里有三个 ArkUI 状态管理的要点,每一个都在桌面长清单里会被放大。
要点一:@Prop 是深拷贝。 MarkRow 拿到的是 MarkItem 的一份副本,子组件改它不会影响父数组。所以勾选动作不能写在子组件里,必须通过 onToggle 回调交还给页面——页面才是数据的 owner。很多「勾了没反应」的 bug,根因就是在子组件里改了 @Prop 对象字段,父数组岿然不动。
要点二:ForEach 的键必须包含状态。 页面里这一行是:
ForEach(this.activeShot().markList, (m: MarkItem) => {
MarkRow({ item: m, onToggle: (mid: string) => { this.toggleMark(mid); } })
}, (m: MarkItem) => m.id + m.state)
键是 m.id + m.state,不是 m.id。因为 toggleMark() 是就地改字段:
private toggleMark(mid: string): void {
let shot = this.activeShot();
for (let m of shot.markList) {
if (m.id === mid) {
m.state = m.state === 'draft' ? 'done' : 'draft';
}
}
let copy: ShotItem[] = [];
for (let s of this.shots) {
copy.push(s);
}
this.shots = copy;
}
markList 的引用没变,变的是数组里某个对象的字段。ForEach 只比对键,键一变就重建这一行,Checkbox 的 select 才会跟着新状态重算。如果有人把键「优化」成 m.id,勾选就会变成点了没反应——这不是组件的问题,是 diff 算法按约定工作。
要点三:就地改嵌套数组只是「暂时能跑」。 上面 m.markList.push(item)、m.state = ... 直接改的是 ShotStore.shots 这个模块级静态数组里的对象。this.shots = copy 只换了外层数组的引用,内层引用没动,所以当前这版能刷新,靠的是「外层引用变化触发整页重建」这条粗粒度链路。一旦把清单抽成独立 @Component、用 @Prop marks: MarkItem[] 接收内层数组,父级只换外层引用时子组件不会收到同步——数组引用没变——清单就停在旧内容上。正确地做不可变更新:
// entry/src/main/ets/pages/Index.ets(改造后)
private withMarks(shot: ShotItem, marks: MarkItem[]): ShotItem {
return {
id: shot.id, name: shot.name, source: shot.source, time: shot.time,
size: shot.size, tag: shot.tag, marks: shot.marks, open: shot.open,
bgA: shot.bgA, bgB: shot.bgB, chip: shot.chip, markList: marks
} as ShotItem;
}
private replaceShot(next: ShotItem): void {
const out: ShotItem[] = [];
for (let s of this.shots) {
out.push(s.id === next.id ? next : s);
}
this.shots = out;
}
private addMark(x: number, y: number): void {
const shot = this.activeShot();
const marks: MarkItem[] = shot.markList.slice(0);
const count = marks.length + 1;
const label = this.tool.charAt(0).toUpperCase() + count.toString() + ' ' + ShotStore.kindName(this.tool);
const item: MarkItem = {
id: 'M' + Date.now(), kind: this.tool, label: label,
x: Math.max(4, Math.min(76, x)), y: Math.max(4, Math.min(72, y)),
w: 22, h: 16, color: this.toolColor, author: '我', state: 'draft'
} as MarkItem;
marks.push(item);
this.replaceShot(this.withMarks(shot, marks));
this.flash('已在画布添加「' + label + '」,可在右侧清单确认');
}
对象字面量里逐个字段重建,而不是用展开运算符——ArkTS 对对象展开的支持有限,显式列字段虽然啰嗦,但可读、可静态检查,也能一眼看出「哪些字段是结构性的、哪些是内容性的」。
最后是计数口径。当前 totalOpen() 遍历全部截图,而清单只显示当前截图,于是出现图 3 那种「全部已定稿、右上角还写待确认 6」的割裂。把统计拆成两个函数、并在文案里标明口径:
private openOf(shot: ShotItem): number {
let n = 0;
for (let m of shot.markList) {
if (m.state === 'draft') {
n++;
}
}
return n;
}
private totalOpen(): number {
let n = 0;
for (let s of this.shots) {
n += this.openOf(s);
}
return n;
}
面板标题改成 Text('本图 ' + this.openOf(this.activeShot()).toString() + ' / 全部 ' + this.totalOpen().toString()),顶栏继续显示全局数。一个数字只回答一个问题,这是桌面信息密度的底线:图 1 的面板只有 2 行却写 6,用户就会开始怀疑所有读数。
七、桌面 affordance:悬停、双击、键盘与命中区域
手机应用没有「鼠标停在这里但没点」这个状态,桌面应用每天要处理几万次。悬停反馈做得对,用户会觉得界面「活着」;做得过,用户会觉得界面「在抖」。本工程当前完全没有 hover 与键盘支持——所有交互只有 onClick,这是它离「桌面级工具」最远的一步。
补 hover 只需要几行,关键是「只放大 2%,120ms 缓出」:
// entry/src/main/ets/pages/Index.ets(filmCard 内追加)
@State hoverId: string = '';
.scale({
x: this.hoverId === s.id ? 1.02 : 1,
y: this.hoverId === s.id ? 1.02 : 1
})
.animation({ duration: 120, curve: Curve.EaseOut })
.onHover((isHover: boolean) => {
this.hoverId = isHover ? s.id : '';
})
1.02 倍在 250 vp 宽的卡片上是 5 vp 的位移,肉眼刚好能察觉;1.05 就会让相邻卡片看起来在挤。animation 必须挂在 scale 之后、且作用于同一个节点,否则会变成「瞬移再回弹」。如果不想自己做动效,ArkUI 还提供一行 .hoverEffect(HoverEffect.Highlight),系统会给一个默认的悬停高亮——代价是配色不受控,深色卡上容易糊成一片。
双击进入「重命名」是桌面文件管理器的通用肌肉记忆,本工程可以先用一个 toast 占位,把交互路径打通:
.gesture(
TapGesture({ count: 2 })
.onAction(() => {
this.flash('双击「' + s.name + '」:此处可接重命名弹窗');
})
)
要注意手势与点击的优先级:TapGesture 与 onClick 同时存在时,单击会先触发 onClick,双击要等系统判定「第二次点击是否会来」的窗口结束才触发。如果单击是「切换截图」这种重操作,双击就会显得卡顿。桌面的通用解法是让单击立即生效、双击只做增量动作(重命名、打开详情),不要指望用双击替代单击。
键盘是桌面交互的另一半。鸿蒙PC 有实体键盘,用户在标注工作台里最自然的动作是「选中一条,按 Delete 删掉」。给画布加焦点与按键:
.focusable(true)
.focusOnTouch(true)
.onKeyEvent((ev: KeyEvent) => {
if (ev.type === KeyType.Down && ev.keyCode === KeyCode.KEYCODE_FORWARD_DEL) {
this.dropLastDraft();
return true;
}
return false;
})
dropLastDraft() 用不可变方式删掉当前截图的最后一条待确认标注:
private dropLastDraft(): void {
const shot = this.activeShot();
let cut: number = -1;
for (let i = 0; i < shot.markList.length; i++) {
if (shot.markList[i].state === 'draft') {
cut = i;
}
}
if (cut < 0) {
this.flash('当前截图没有待确认标注');
return;
}
const marks: MarkItem[] = shot.markList.slice(0);
marks.splice(cut, 1);
this.replaceShot(this.withMarks(shot, marks));
this.flash('已移除最后一条待确认标注');
}
三个容易踩的点:KEYCODE_FORWARD_DEL 才是主键盘区那颗 Delete,KEYCODE_DEL 是退格;focusOnTouch(true) 让鼠标点画布时顺带获得焦点,否则用户得先 Tab 一圈;onKeyEvent 要返回 true 表示事件已被消费,返回 false 会继续冒泡给外层容器。
最后是命中区域。桌面以鼠标为主,最小可点目标建议不低于 32 vp;若还要兼顾触屏,尽量做到 40 vp 以上。本工程的工具按钮是两列等分、上下各 8 vp 内边距,高度接近 50 vp(达标);但筛选 chip 的高度只有 5 + 5 + 约 16 = 26 vp,右下角的颜色轮按钮也才 46×32,鼠标勉强够用,手指必然点错。一行改动即可:
Text(name)
.fontSize(F.caption)
.padding({ left: 12, right: 12, top: 7, bottom: 7 }) // 高度提升到约 30–32 vp
命中区域这件事在桌面上还有一个隐藏收益:它同时决定了「误点到相邻元素」的概率。三栏布局里左右两栏的间距只有 14 vp,chip 与卡片的可点区一旦贴边,用户想点 A 却点到 B 的投诉就会源源不断。
八、把窗口接进来:window 模块的四个接点
前面七章都在内容区里打转,因为工程本身没有碰窗口 API。但对「窗口与桌面基础交互」来说,内容区只是结果,窗口才是输入。把窗口接进来只需要四个接点:拿到主窗口、设最小尺寸、监听尺寸变化、监听窗口状态变化。
// entry/src/main/ets/entryability/EntryAbility.ets(增量改造)
import { UIAbility } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window, display } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';
const DOMAIN: number = 0x0000;
const TAG: string = 'ScrimarkAbility';
const KEY_W: string = 'scrimarkWinW';
const KEY_STATUS: string = 'scrimarkWinStatus';
const MIN_W_VP: number = 910;
const MIN_H_VP: number = 560;
export default class EntryAbility extends UIAbility {
private mainWin: window.Window | undefined = undefined;
onWindowStageCreate(windowStage: window.WindowStage): void {
windowStage.loadContent('pages/Index', (err: BusinessError) => {
if (err.code) {
hilog.error(DOMAIN, TAG, 'loadContent failed: %{public}s', JSON.stringify(err));
return;
}
hilog.info(DOMAIN, TAG, 'loadContent ok');
});
const win: window.Window = windowStage.getMainWindowSync();
this.mainWin = win;
// 接点 1:setWindowLimits 的单位是 px,必须自己按屏幕密度换算
const density: number = display.getDefaultDisplaySync().densityPixels;
win.setWindowLimits({
minWidth: Math.round(MIN_W_VP * density),
minHeight: Math.round(MIN_H_VP * density)
}).catch((e: BusinessError) => {
hilog.error(DOMAIN, TAG, 'setWindowLimits failed: %{public}s', e.message);
});
// 接点 2:尺寸变化 -> px 换算成 vp -> 写入 AppStorage
win.on('windowSizeChange', (size: window.Size) => {
AppStorage.setOrCreate<number>(KEY_W, Math.round(size.width / density));
});
// 接点 3:最大化 / 还原 / 分屏 / 最小化
win.on('windowStatusChange', (state: window.WindowStatusType) => {
AppStorage.setOrCreate<number>(KEY_STATUS, state);
});
}
onWindowStageDestroy(): void {
if (this.mainWin !== undefined) {
this.mainWin.off('windowSizeChange');
this.mainWin.off('windowStatusChange');
this.mainWin = undefined;
}
}
}
四个接点里有三个坑,都是实测中常见的。
坑一:setWindowLimits 收的是 px,不是 vp。 参数名只写了 minWidth / minHeight,很容易顺手把 910 填进去。在 100% 缩放的屏幕上 910 px 恰好等于 910 vp,看起来能跑;一旦用户把系统缩放调成 125%,910 px 就等于 728 vp,最小窗口直接小于三栏骨架的下限,画布被压死。正确做法永远是 vp × densityPixels 再取整。反向读取 windowSizeChange 时同理,size.width 是 px,要除以同一个 density 才是 vp。在 ability 里不要依赖 UI 侧的 px2vp(),直接拿 densityPixels 做除法最稳。
坑二:windowSizeChange 是高频回调。 用户拖窗口边缘时,它可能每帧都来一次。每一次都写 AppStorage 都会触发一次布局重算,5 条数据的小页面无感,50 条缩略图就会看到拖拽掉帧。两个低成本优化:一是把宽度按 8 vp 对齐再写入(Math.round(w / 8) * 8),拖拽过程中大量中间值会被合并;二是在页面侧只在「跨过折叠阈值」时才改结构,而不是每个新宽度都改一次。
坑三:监听必须解绑。 on('windowSizeChange') 与 off('windowSizeChange') 必须成对。鸿蒙PC 的窗口生命周期比手机页面长得多——最小化不销毁、切到别的应用不销毁、甚至长时间不用也可能只是挂起。忘记 off 的后果是:窗口重建后旧监听仍然持有旧页面的 this,一次拖拽触发两份回调,表现为「缩放一下,界面闪两下」。
页面侧只需要两个只读属性:
// entry/src/main/ets/pages/Index.ets(页面顶部)
@StorageProp('scrimarkWinW') winW: number = 1280;
@StorageProp('scrimarkWinStatus') winStatus: number = 0;
@StorageProp 是单向同步:AppStorage 变了,页面跟着变;页面改它不会回写 AppStorage。这种单向性在「窗口尺寸」这类系统事实上是优点——应用不该有能力篡改窗口宽度。拿到宽度之后,折叠右栏就是六行条件渲染:
Row({ space: 14 }) {
Column() { /* 胶片带 */ }
.width(this.winW < 1050 ? 84 : 250) // 窄窗收窄为缩略图条,卡片文字省略
.height('100%')
Column({ space: 10 }) { /* 画布 */ }
.layoutWeight(1)
.height('100%')
if (this.winW >= 1050) {
Column({ space: 12 }) { /* 标注工具 + 清单 */ }
.width(280)
.height('100%')
}
}
这里有两个阈值,语义完全不同,不要合并:910 vp 是系统层的硬下限(setWindowLimits 挡住,用户拖不过去),1050 vp 是界面层的折叠阈值(低于它就收起右栏)。折叠阈值必须比硬下限高出一截,中间留出 140 vp 的缓冲带——否则用户拖到 910 时,界面刚好卡在「折叠与不折叠」的边界上,任何一次 1 vp 的抖动都会让右栏闪进闪出,视觉上像在抽搐。
顺带说一个窗口装饰的选择:本工程使用系统默认标题栏,所以 setWindowDecorVisible、setWindowTitleButtonVisible 这些 API 一行都不用写。若要自绘标题栏,就得自己补上「拖拽移动、双击最大化、边缘 resize、按钮悬停态」,还要处理与系统手势的冲突(比如拖到屏幕顶端触发分屏)。在演示原型阶段,这笔投入几乎没有收益;等到要做品牌化窗口时再换,代价也只是集中在一个 ability 文件里。
九、ArkUI 视角:哪些交互契约能跨设备,哪些必须按平台写
前面八章拆的全是「鸿蒙PC 上怎么写」,这一章往上抽一层:这套东西里有多少是 ArkUI 给的,有多少是桌面形态给的?
ArkUI 是鸿蒙原生的声明式 UI 框架,页面由 @Component 结构体 + build() 里的声明式语法描述,状态用 @State / @Prop / @StorageProp / @ObjectLink 驱动,列表用 ForEach / LazyForEach 渲染。它的一个直接好处是:同一份 ArkTS 代码可以面向 2in1、平板与手机,靠 deviceTypes 声明与布局自适应来区分形态,而不是维护三份工程。这也是「跨端」最现实的收益——不是一次编写到处运行,而是一套状态模型、一套数据契约,多处复用。
具体到本工程,能跨设备复用的有三样:
第一是数据模型。MarkItem 的 x / y 是百分比坐标,w / h 在改造后也按百分比解释,两者都不是像素,也不是 vp。百分比坐标在任何尺寸的画布上语义一致:50% 就是「横向正中」,不管画布是 320 vp 还是 1440 vp。如果当初存的是 x: 720 这样的绝对值,窗口一缩放,标注就会整体偏移。这个选择与框架无关,放到别的跨平台框架里也一样成立。
第二是状态跃迁。draft → done 是一个与设备无关的流程;activeId 是唯一选中源,也是一条与设备无关的约束;「筛选只改集合、不改选择」更是纯业务规则。把这些写清楚,比在任何框架里调样式都值钱。
第三是布局常量与断点策略。910 vp 的骨架下限、1050 vp 的折叠阈值、250/280 的固定栏宽,这些数字描述的是「信息密度的物理极限」,而不是某个平台的特性。换到平板上,你只需要把 910 改成平板的分屏宽度,把「折叠右栏」换成「右栏变底部抽屉」,判据本身不动。
必须按平台重写的也有三样:
第一是窗口 API。window.getMainWindowSync()、setWindowLimits()、windowSizeChange、windowStatusChange 是鸿蒙 2in1 的自由窗口能力,手机上没有「可拖拽的窗口」这个概念,平板的分屏也由系统托管。把窗口层单独收在一个 ability 文件里,正是为了让这一层成为唯一需要平台化的部分。
第二是指针事件。onHover、onMouseMove、右键菜单、双击判定,这些只在有鼠标的设备上有意义;触屏要换成 onTouch 与长按。ArkUI 把两套事件都提供了,但「什么时候用哪套」是产品判断:鸿蒙PC 上鼠标是主输入,触屏是补充,所以 hover 必须有,onTouch 可以只做兜底。
第三是系统装饰与截图能力。系统标题栏、窗口按钮、分屏手势、屏幕捕获权限,这些都由平台决定。本工程用渐变占位绕开了截图权限,也把「真实截图」留给下一步:window.Window.snapshot() 拿 PixelMap,再走图库或文件接口落盘。这一步没有平台之外的捷径。
一句话总结这一章:ArkUI 负责「状态怎么变成界面」,桌面形态负责「窗口怎么变成输入」。 把两者混在一起写,代码会变成一堆 if (isPC);把两者分开写,跨设备复用就是自然结果。
十、复现清单与八条踩坑
想在自己的鸿蒙PC 上复现这套工作台,顺序如下:
- DevEco Studio 新建 2in1 工程,
compatibleSdkVersion与targetSdkVersion都填26.0.0,module.json5的deviceTypes只留['2in1']。 - 按
common/Theme.ets建色板与字号常量,按common/Models.ets建MarkItem / ShotItem / ShotStore,先塞 5 条演示数据。 - 写
Index.ets的三栏骨架:250 /layoutWeight(1)/ 280,间距 14,外层 padding 16。 - 把画布的点击落点改成局部坐标百分比(第四章),并在底栏加指针读数。
- 把筛选改成
applyFilter()事务(第五章),确认筛选后activeId一定在列表里。 - 把标注的增删改成不可变更新(第六章),
ForEach键带上state。 - 补 hover、双击、Delete 键与 32 vp 命中区(第七章)。
- 接
window的四个接点(第八章),设最小尺寸、折叠右栏,拖窗口验证不塌。
八条踩坑,按「疼的程度」排序:
- 混用
windowX与x:窗口一动,标注就整体偏;而且不报错,只能靠肉眼发现。 - 固定栏不让位:窗口拖窄时被压死的是画布,
layoutWeight不会让固定栏缩。 - 筛选不校准选择:列表里没有、画布上却有,用户会以为筛选坏了。
- 计数口径不标注:面板写全局数、清单列局部项,勾完还是「待确认 6」。
- 就地改嵌套数组:外层引用换了能刷新,一旦把内层数组以
@Prop传给子组件就失效。 ForEach键漏字段:键只用id,状态变了行不重建,Checkbox 勾了不动。setWindowLimits当 vp 用:100% 缩放时看不出问题,125% 缩放立刻暴露。- 窗口监听不解绑:窗口重建后一次拖拽触发两份回调,表现为「闪两下」。
还有两条工程习惯值得养成:一是所有「魔法数字」都提成常量并写成算式(910 就是 250+280+60+320),二是任何演示占位都在界面上明说(图 1 底部那行灰字就是范例),这两条能让后来者少猜很多。
十一、桌面交互的六条验收标准
最后给一份可以拿去自查的清单。它不依赖具体实现,也不依赖 ArkUI 的版本,任何鸿蒙PC 桌面应用都能套:
一、窗口缩到最小尺寸,界面仍然可用。 最小尺寸不是「不崩就行」,而是「三个面板都还能完成各自的核心动作」。本工程的下限是 910 vp,低于它系统直接不让拖。
二、每一栏的宽度都有来源。 250 是缩略图可读宽,280 是六宫格可点宽,320 是画布可用宽。说不出来源的宽度,早晚会在某个分辨率上翻车。
三、点哪里,改哪里。 点击落点必须用局部坐标换算百分比,并在画布尺寸变化时重新计算;onAreaChange 少写一次,缩放后所有新标注就会偏移。
四、筛选之后,选中项一定在可见集合里。 这是一条硬约束,应该在 applyFilter() 里强制,而不是指望用户先点一下列表。
五、每个数字只有一个口径。 全局数放顶栏、局部数放面板,文案里写清「本图 / 全部」,不要让用户自己做减法。
六、鼠标与键盘都能完成主流程。 纯鼠标能完成「选图 → 加标注 → 确认」;键盘至少能完成「删除最后一条待确认」。只有触屏能完成的流程,在鸿蒙PC 上等于半残。
这六条里,前两条决定「窗口变大变小是否体面」,中间两条决定「交互是否可信」,最后两条决定「它像不像一个桌面软件」。它们跟视觉风格无关,跟框架语法也无关——换成任何跨平台框架,这六条依然成立,只是写法不同。
工程源码建议托管到 AtomGit 的 OpenHarmonyPCDeveloper 组织下,与社区里的其它鸿蒙PC 项目放在一起;本文用到的 Scrimark_ohos 是一份可以直接在 DevEco Studio 里打开的完整工程,改完第八章的四个接点,就能在真机上看到「拖窗口 → 右栏折叠 → 画布变宽 → 标注跟着缩放」这一整条链路。
鸿蒙PC 的窗口与桌面基础交互,说到底不是「把手机界面拉宽」,而是承认三件事:窗口是用户手里的连续变量,指针是精确输入,桌面工作流是并行的。承认了这三件事,ArkUI 的三栏骨架、layoutWeight 的分配规则、window 模块的尺寸回调,才会各就各位;不承认,再漂亮的界面也只是「一个大号手机应用」。
更多推荐




所有评论(0)