用途:为 Odoo 主题开发提供 SCSS 变量参考,整理字体、配色与网站全局配置三类核心变量系统的写法。
加载顺序:主题的 primary_variables.scss 通过 prepend 先于 Odoo 核心变量加载,因此主题中不能用 map-merge() 合并核心变量,否则报未定义变量错误;主题应改用 $o-website-values-palettes 的 'color-palettes-name' 指定配色。
字体:$o-theme-font-configs 中每项含 'family'(CSS 字体族列表,必填)与 'url'(只填 Google Fonts 查询参数,不含完整 URL,必填),可选 'properties' 按别名(base、headings、navbar、buttons)覆盖。字重写法如 'Poppins:300,300i,400,400i',数字后加 i 表示斜体;多词字体用加号连接,如 'Open+Sans:300,400,700',支持阿拉伯语等 RTL 字体。
配色:$o-color-palettes 定义五个语义色 o-color-1 至 o-color-5,分别对应主色、次要色、浅背景、白色与深色,并映射到 o_cc1 至 o_cc5 组合类。此 map-merge 仅在非主题模块可用。
全局配置:$o-website-values-palettes 提供 115 项以上键,覆盖字体与字号、行高、边距、按钮、输入框、页头、页脚、链接与布局、配色渐变等。常用键包括 font、headings-font、font-size-base、btn-border-radius、header-template、header-links-style、footer-template、link-underline、layout 等。另可用 $o-theme-h1-font-size-multiplier 等乘数调整标题字号。
限制:具体可用值以对应 Odoo 版本为准;资料未提供安装命令、收费方式与平台要求。