Electron 鸿蒙笔记应用实战:把界面从"能看"改到"想看"——一次深色主题重排的完整记录

深色侧栏怎么配、渐变点缀用在哪些位置才不廉价、深浅两个区域的滚动条为什么要分开画——重排一个应用的外观,90% 的决定是"哪里不放颜色"。这篇文章用一个跑在鸿蒙 PC 上的 Electron 笔记应用,把第一版浅色主题的五个具体问题、深色主题的色彩系统、以及那几个只有真机才会暴露的样式坑一次讲透。

欢迎加入开源鸿蒙PC社区:https://harmonypc.csdn.net/
欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper

0. 环境与实测设备

项版本/型号
设备HarmonyOS PC(aarch64),API 26
Electron-OHv40.0.1(预编译 libelectron.so)
页面载体XComponent(SURFACE) 直出 Chromium surface
样式文件style.css(单文件,约 340 行)
字体栈HarmonyOS Sans SC / PingFang SC / Microsoft YaHei
本次改动范围style.css 全量重写,HTML 结构零改动

最后一行值得先讲:这次重排没有动一行 HTML。所有视觉变化都靠 CSS 完成——这既是对第一版结构合理性的确认,也把这次改版的性质钉死了:改版改的是"皮肤",不是"骨架"。结构层的问题(比如后来发现的导航被内容卷走)不是这次的主题,出现了单独修。

1. “都挺好,就是不想多看”——这个问题是怎么找上我的

第一版界面是标准的浅色三段式:白侧栏、白编辑区、浅灰状态栏。功能上没有任何毛病:对比度够、层级清楚、该有的 hover 都有。我自己天天看着也觉得"可以了"。

推翻译场是在给别人看演示的时候。屏幕上投出来,对方的第一反应不是"这应用能干什么",而是"这界面好像在哪见过"。这句话让我意识到问题所在:它是一套没有观点的界面。所有颜色都是"安全"的——白底、灰边、蓝色点缀,挑不出错,也记不住。

我一开始也以为"没毛病"就是好界面的及格线。后来才反应过来:对个人工具来说,界面没有观点 = 应用没有身份。每天打开十次的工具,用户对它的感知一半来自功能,一半来自那一眼视觉印象。第一版把后一半完全放弃了。

还有一个更具体的推动因素:这个应用跑在鸿蒙 PC 上,窗口标题栏、系统菜单栏都是系统绘制的深色调风格,我的白侧栏贴在旁边,像两张纸硬拼在一起——应用和宿主系统没有对话。

所以这个题目的边界很清楚:保持 HTML 骨架和交互行为完全不变,用一套深色主色 + 渐变点缀的 CSS 重写全部视觉,让应用和鸿蒙 PC 的系统观感接上。

拆下来是三件事:

  • 定色彩系统:哪里深、哪里浅、渐变用在哪几个位置;
  • 处理深浅混排:侧栏深、编辑区浅,中间的边界和各自的滚动条怎么协调;
  • 把第一版遗留的样式问题(导航卷走、滚动条突兀)顺手修掉。

下面是干完之后的完整记录,包括我踩的每一个坑。

2. 按老规矩,先给效果再讲原理

请添加图片描述

图1 主界面:深色侧栏 + 白色编辑区 + 深色状态栏

改完的第一眼:左边是一条深蓝黑的侧栏(#1c2230),右边是纯白编辑区,底部状态栏回到深色——深色出现在首尾,白色夹在中间,整个窗口有了"框住"的层次。应用标题前多了一个蓝紫渐变小方块,列表条目选中时左侧亮起一条蓝光。

这里每一处都不是装饰:

  • 侧栏 #1c2230 而不是纯黑:纯黑(#000000)会让深色区域像"洞",#1c2230 带一点蓝相,是"材质"而不是"空缺"。深色 UI 的第一条经验就是不用纯黑;
  • 渐变只出现在三个位置:标题方块、新建按钮、选中条目。渐变是调料,撒满一盘就成了装修事故;
  • 状态栏回归深色:它和侧栏首尾呼应,白色编辑区变成被"托住"的内容区,而不是漂浮在一片灰白里。

请添加图片描述

图2 登录页:全幅渐变背景 + 白色卡片

登录页是改版幅度最大的地方:原来那个极淡的灰背景换成了全幅蓝紫渐变(135°,从 #4d79ff 到 #9b5cff),白色卡片配深投影浮在上面。登录页是应用唯一适合"铺颜色"的地方——它没有内容,背景就是主角;主界面有内容,背景必须退后。同一个渐变,在登录页是大面积背景,在主界面缩成三个小点缀,这是同一套色彩系统在不同密度页面上的两种剂量。

请添加图片描述

3. 原理:色彩系统先于任何一行 CSS

动笔改样式之前,我在纸上把整个应用的界面按"视觉密度"分了区,然后决定每个区的颜色剂量。这张表是整个改版的纲领:

区域视觉密度颜色策略具体值
侧栏中(导航+列表)深色底,信息用亮灰#1c2230 / 文字 #e9ecf3、#7d8699
编辑区高(长文阅读)纯白底,低对比文字#ffffff / 正文 #2b3038
状态栏低(只读信息)深色底小字,退后#1c2230 / #7d8699
登录页零(无内容)渐变做背景,卡片承载内容#4d79ff → #9b5cff
点缀元素单点渐变,全场三处以内#4d79ff → #6b5cff

颜色剂量的分配原则:视觉密度越高的区域,颜色越少。 长文阅读区任何一点花哨都是干扰;零内容区不放颜色就是浪费。这张表定完之后,写 CSS 的过程几乎没有犹豫——大部分改版做到一半开始"越改越乱",根源就是先写样式后定系统。

第二个原则:深色区域的信息用透明度,不用新颜色。 侧栏里 hover 态是 rgba(255,255,255,0.07),选中态是 rgba(107,141,255,0.22)——都是在深底上叠白色或主题色的透明层,而不是再调两个新灰。深色 UI 里每引入一个实体颜色,色板就多一个需要全局协调的变量;透明度叠加自动继承底色,色板不会失控。

第三,渐变的工程含义是"强调可操作"。三个渐变位置(标题方块、新建按钮、选中条目)里两个是按钮一个是"当前所在",没有一个是纯展示元素。用户看到渐变就知道"这里有交互或者你在这"——颜色在这里承担了功能语义,不只是装饰。

4. 把代码讲透

4.1 深色侧栏:三层文字灰的分工

/* style.css - 深色侧栏(节选) */

#sidebar {
  width: 280px;
  min-width: 230px;
  background: #1c2230;
}

.note-title {
  color: #e9ecf3;        /* 主信息:最亮 */
  font-weight: 500;
}

.note-meta {
  color: #7d8699;        /* 次信息:退后半步 */
  font-size: 11px;
}

#note-list li:hover {
  background: rgba(255, 255, 255, 0.07);
}

#note-list li.active {
  background: rgba(107, 141, 255, 0.22);
  box-shadow: inset 3px 0 0 #6b8dff;   /* 选中条目的蓝光边 */
}

请添加图片描述

侧栏里的文字灰是三个档位:标题前缀和主标题 #f2f4f8、条目标题 #e9ecf3、元信息 #7d8699。三档的亮度差是刻意拉开的:扫视列表时,第一眼抓到的是一列条目标题,元信息自动退成背景纹理。如果三档灰太接近,列表会糊成一团——深色 UI 对灰度层次的要求比浅色 UI 苛刻,因为深底上"发灰"和"看不清"之间的距离很短。

选中态的 inset 3px 0 0 #6b8dff 是个内部阴影技巧:不用 border-left 是因为 border 会改变条目的盒模型宽度,引起内容 3px 抖动;inset 阴影画在盒内,选中态出现和消失,条目本身一个像素都不动。

4.2 深浅边界:编辑区为什么保持纯白

有人建议编辑区也上深色,做成全深主题。我试了半天又退回来了。

原因在内容性质上:这是一个长文编辑器,白底黑字是人类几百年阅读印刷品训练出来的默认舒适区。侧栏是"导航",深色降低它的视觉权重(对,深色让侧栏"退后"了,而不是更醒目);编辑区是"内容",内容区要保持最高可读性。深浅混排不是折衷,是各取所长——深色负责界面 chrome 的安静,白色负责内容的清晰。

深浅交接处只画了一条 1px 的 #e8eaee 边——比两侧都深、比两边的主体都浅的过渡灰。不需要更复杂的处理(阴影、渐变过渡都试过),1px 是两个色块之间最诚实的缝。

4.3 滚动条:深浅两个世界各画各的

/* style.css - 分区滚动条 */

::-webkit-scrollbar {
  width: 8px;
}

#sidebar ::-webkit-scrollbar-thumb {
  background: #3a4356;        /* 深区:亮一点的深灰 */
  border-radius: 4px;
}

#editor ::-webkit-scrollbar-thumb {
  background: #d5d9e0;        /* 浅区:暗一点的浅灰 */
  border-radius: 4px;
}

默认滚动条是系统灰,在深色侧栏里是一条突兀的浅色带——滚动条虽小,它出现在哪一侧就暴露哪个区域的颜色系统没做完。用 #sidebar ::-webkit-scrollbar-thumb 这种作用域选择器,两个区域各配一套:深区里滚动条是"比背景亮一点的深灰",浅区里是"比背景暗一点的浅灰",共同点是永远比所在背景只差一档——滚动条该被看见,但不该被注意到。

4.4 登录页:渐变的剂量控制

/* style.css - 登录页渐变(节选) */

#auth-view {
  background: linear-gradient(135deg, #4d79ff 0%, #6b5cff 55%, #9b5cff 100%);
}

.auth-card {
  box-shadow: 0 24px 64px rgba(23, 32, 64, 0.35);
}

#btn-auth-submit {
  background: linear-gradient(135deg, #4d79ff, #6b5cff);
}

登录页的渐变和按钮的渐变取的是同一条色带的两个片段——大背景用三段(蓝→蓝紫→紫),按钮用前两段(蓝→蓝紫)。这样按钮在背景上是"同一族的颜色",协调感是血缘带来的,不是碰巧。

卡片投影用了 35% 透明度的深蓝黑(rgba(23,32,64,.35))而不是纯黑:投影的颜色应该带环境的色相。纯黑投影在渐变背景上会显脏,同色相的深投影看起来是"卡片悬浮在渐变上方",纯黑看起来是"卡片下面有个洞"。

135deg 这个角度也值得一句:斜向渐变比水平或垂直更"活",但超过 45° 的斜度(如 160°)会让渐变看起来像出错。135° 是"有方向感但不奇怪"的甜蜜点。

4.5 一个必须重申的旧坑:display:flex 盖过 hidden

/* style.css - 文件末尾,保留第一版的修正 */

#app[hidden],
#auth-view[hidden] {
  display: none;
}

这两行是第一版就踩过的坑,这次重写样式时差点又丢掉。登录和主界面的切换靠 HTML 的 hidden 属性,而 #app 和 #auth-view 都设了 display: flex——CSS 类选择器的优先级会盖过 hidden 属性自带的 UA 样式 display: none,结果是两个视图同时显示,界面完全错乱。必须显式写 #app[hidden] { display: none; } 压回去。

改版时这条规则差点被当成"旧代码"清掉,幸好收尾自检时看见了。样式文件里最容易被误删的,就是那些"看起来多余"的兼容规则——它们存在的理由不在样式里,在交互逻辑里。

5. 我踩过的坑(每一条都有真实出处)

坑一:渐变撒多了,界面像 KTV。 中间版本我把筛选胶囊、笔记时间戳、状态栏文字都加上了渐变或亮色,截图发朋友,回复是"挺花的"。全部收回,只留三个位置。渐变的可用额度是"全场三处",超过就开始消耗 instead of 建立辨识度。

坑二:选中条目的 border-left 引起内容抖动。 第一版蓝光边用 border-left: 3px solid 实现,选中/取消选中时条目内容横向跳 3px——盒模型变了。换成 box-shadow: inset 后内容零移动。选中态必须做到"出现即无布局变化",任何抖动都会让列表显得廉价。

坑三:深色侧栏里的默认滚动条。 忘了处理滚动条样式时,深色侧栏右侧挂着一条系统浅灰滚动条,非常扎眼。用分区选择器补了深浅两套。教训已经写进 4.3:改主题时滚动条是最后一个想起、第一个穿帮的地方。

坑四:纯黑投影显脏。 登录卡片第一版用 rgba(0,0,0,.3),在渐变背景上投影发黑发死。换成带色相的 rgba(23,32,64,.35) 后卡片"浮"起来了。投影颜色跟环境色相走,这是渐变背景上投影的唯一正确画法。

坑五:差点删掉 hidden 兼容规则。 4.5 节的旧坑,重写样式时差点复发。现在我把它写在文件最末尾并带注释,作为样式文件的"最后一条防线"。每个样式文件都应该保留一个"别删这段"注释区,给未来的自己。

坑六:字体栈没有真的生效在鸿蒙上。 HarmonyOS Sans SC 写在第一位,但我没有证据确认 Chromium 拿到了这个字体(HAP 的字体注册链路没有验证过)。当前的视觉观感达标,但严格说这个字体栈的第一位是"声明",不是"事实"——真机上实际命中的可能是后两位之一。诚实记下,待真机用 DevTools 的 computed style 验证。

6. 现在怎么用:边界与收尾

这次改版的全部产出是一个 style.css 文件,HTML 和 JS 零改动。换到别的 Electron 项目,可复用的是那张"区域×密度×策略"的表和三条原则(密度越高颜色越少 / 深区信息用透明度 / 渐变只给可操作元素),具体色值要按你的主题色重调。

硬限制列一下,免得读者踩到同一堵墙:

  • 深色 UI 不用纯黑做底,带色相的深色(#1c2230 这类)才是"材质";
  • 渐变全场最多三处,且只给可操作或"当前所在"元素;
  • 选中态不用 border(会抖动内容),用 inset box-shadow;
  • 滚动条按深浅分区各画一套,色值永远只和所在背景差一档;
  • 渐变背景上的投影带环境色相,不用纯黑;
  • display: flex 与 hidden 属性的冲突规则必须显式压掉,这是每个 flex 布局文件的必写项;
  • 字体栈第一位在鸿蒙上是否真正命中,需要真机 DevTools 验证,不能想当然。
Logo

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

更多推荐