anyuianyui
anyui-LIVE
anyui
反馈问题
  • English
  • 中文
anyui-LIVE
anyui
反馈问题
  • English
  • 中文
  • 介绍

    • 介绍
  • 快速开始

    • 快速开始
  • 工作区

    • 工作区
  • 编辑器

    • 概览
    • 工具栏
    • 导航器
    • 检查器
    • 状态栏
    • 设置
    • 画布
    • 预览
    • 资源管理
    • 代码查看器
    • 历史面板
  • 智能体
  • 桌面版
  • 主题

    • 图片
    • 字体库
    • 布局
    • 全局样式
    • 动态 LVGL 版本
    • 动态显示尺寸变更
    • 重置屏幕尺寸
    • 代码生成
    • 移植
    • 模拟器
    • 国际化
  • 常见问题

全局样式存放整个项目共用的样式取值。颜色、字号、排版这类反复出现的设置只需定义一次,不必逐个组件重复填写。本文介绍它的概念、设置方法和使用时的注意事项。

概述

项目设计总在重复:许多面板用同一个背景色,许多标签用同一个文字颜色。没有全局样式时,这些取值要在检查器里逐个组件填写,换一次主题就得一个个改。

全局样式位于单组件属性的下层,作为共用的基线:

层级作用范围在哪里修改
全局样式整个项目共用的取值全局样式编辑器(见下文)
组件属性单个选中组件自己的取值检查器

适合的使用场景:

  • 所有界面保持一致的视觉风格。
  • 共用取值改一处即可生效,免去逐个组件修改。
  • 多个界面复用同一套外观时,减少重复的属性设置。

使用指南

  1. 打开全局样式编辑器。
  2. 设置共用的样式取值。可编辑的属性跟随当前激活的 LVGL 运行时版本,与检查器解析属性定义的方式一致,参见动态 LVGL 版本。
  3. 在画布上选中组件,确认共用取值已经生效。
  4. 进入预览查看效果,再到代码查看器或代码生成的输出中核对最终取值。

注意事项

  • anyui-LIVE 目前不支持全局组件与高阶组件,全局样式只是项目级的样式取值,并不是可复用的组件,参见介绍。
  • 不要把全局样式编辑器与设置里的 全局对齐 混为一谈,后者控制的是画布的对齐行为。
  • 组件上显式设置过的属性,优先级高于全局取值;改动全局样式不会覆盖这些组件自己的设置。
  • 文字样式要以能渲染出字形为前提:颜色和字号再合适,字体缺少对应字形也显示不出来,需要先准备好字体库,参见字体库。
  • 生成代码反映的是最终解析出的样式。generated/ 目录由工具自动生成,不要手工修改;要调整样式,请在编辑器中改好后重新生成,参见代码生成。

相关指南

  • 检查器 - 单个组件的属性编辑。
  • 画布 - 在界面上查看样式效果。
  • 字体库 - 文字样式涉及的字体配置。
  • 布局 - 使用弹性布局排列子组件。
  • 动态 LVGL 版本 - 运行时版本决定可用的属性。
  • 代码生成 - 样式如何进入生成代码。
Prev
布局
Next
动态 LVGL 版本