全局样式存放整个项目共用的样式取值。颜色、字号、排版这类反复出现的设置只需定义一次,不必逐个组件重复填写。本文介绍它的概念、设置方法和使用时的注意事项。
概述
项目设计总在重复:许多面板用同一个背景色,许多标签用同一个文字颜色。没有全局样式时,这些取值要在检查器里逐个组件填写,换一次主题就得一个个改。
全局样式位于单组件属性的下层,作为共用的基线:
| 层级 | 作用范围 | 在哪里修改 |
|---|---|---|
| 全局样式 | 整个项目共用的取值 | 全局样式编辑器(见下文) |
| 组件属性 | 单个选中组件自己的取值 | 检查器 |
适合的使用场景:
- 所有界面保持一致的视觉风格。
- 共用取值改一处即可生效,免去逐个组件修改。
- 多个界面复用同一套外观时,减少重复的属性设置。
使用指南
- 打开全局样式编辑器。
- 设置共用的样式取值。可编辑的属性跟随当前激活的 LVGL 运行时版本,与检查器解析属性定义的方式一致,参见动态 LVGL 版本。
- 在画布上选中组件,确认共用取值已经生效。
- 进入预览查看效果,再到代码查看器或代码生成的输出中核对最终取值。
注意事项
anyui-LIVE目前不支持全局组件与高阶组件,全局样式只是项目级的样式取值,并不是可复用的组件,参见介绍。- 不要把全局样式编辑器与设置里的 全局对齐 混为一谈,后者控制的是画布的对齐行为。
- 组件上显式设置过的属性,优先级高于全局取值;改动全局样式不会覆盖这些组件自己的设置。
- 文字样式要以能渲染出字形为前提:颜色和字号再合适,字体缺少对应字形也显示不出来,需要先准备好字体库,参见字体库。
- 生成代码反映的是最终解析出的样式。
generated/目录由工具自动生成,不要手工修改;要调整样式,请在编辑器中改好后重新生成,参见代码生成。