KotodamaJournal
设计实践心情 · 分明Atelier

低代码:外壳跟文档走,画布才跟预览主题走

组件库文档里的低代码页,在站点亮色模式下出过一幕:中间预览还是深色品牌皮,左边「组件」按钮、工具栏描边钮却几乎融进白底。不是组件丢了,是对比度被主题叠错了。

怎么叠错的

组装器最初用一份全局配置把整页(工具栏、色板、属性、画布)都套进「预览主题」。默认预览偏向深色品牌皮,字色是浅的。面板背景却又取了文档站的亮色底。浅字 + 亮底,按钮只剩一点若有若无的边。

人眼会以为「亮色模式坏了」。其实是编辑器外壳页面预览抢了同一个主题开关。

怎么拆开的

后来拆成两层:

  • 外壳(工具栏、左右面板)跟随文档站明暗,保证在文档里始终可读。
  • 只有中间画布再套所选的预览主题;导出 HTML 仍然按画布主题走。

面板上的原生按钮、输入框改用文档站文字色,不再从预览主题「继承」浅色字。主题下拉里也写明:这是「预览主题」,不动左侧对比度。

一句话

能导出的那一层,可以大胆换皮;住人操作的那一层,必须跟宿主文档同昼夜。两套皮可以并存,不能共一根电线。