全局样式¶
Style 把一组属性起个名字,让多个节点共享同一套外观。它只有属性,没有子节点,也不能运行事件脚本,因此可以安全地当作“外观模板”。
定义与使用¶
Style Surface {
background: #2C2F33;
radius: 6;
padding: 10;
}
Style DangerButton extends Surface {
background: #8A3B3B;
color: #FFE4E4;
hover-background: #9E4646;
pressed-background: #743131;
}
Container {
class: Surface;
height: 60;
Label { text: "普通面板"; }
}
Button {
text: "删除";
class: DangerButton;
height: 32;
}
class: 与 style: 是同义指令,值都可以写一个或多个样式名,用空格或逗号分隔:
Button { class: DangerButton, Compact; text: "删除"; }
Button { style: DangerButton Compact; text: "删除"; }
多个样式按书写顺序叠加,后面的覆盖前面的:
// Compact 先应用,DangerButton 后应用并覆盖同名属性
Button { class: Compact DangerButton; text: "删除"; }
指令本身有固定顺序:style 列出的样式先应用,class 列出的后应用。混用两者时以 class 为准。
名称规范化¶
样式名在匹配时忽略大小写、连字符和下划线:
DangerButton、danger-button、danger_button 指向同一个样式。
属性键不会自动转换
名称规范化只作用于样式名,以及“谁覆盖谁”的优先级判断。属性键本身仍必须是规范写法(小写、连字符),例如 margin-left。写成 marginLeft 不会被识别为间距属性。
继承链¶
extends 形成单继承链:
Style Base { padding: 8; radius: 4; color: #DDD; }
Style Panel extends Base { background: #26282B; }
Style Window extends Panel { border-width: 1; border-color: #3A3D41; }
应用 Window 时,属性按 Base → Panel → Window 的顺序叠加,越靠后优先级越高。
| 情形 | 结果 |
|---|---|
| 基样式不存在 | 错误 unknown style 'X' |
| 循环继承(直接或间接) | 错误 style 'X' extends itself |
| 继承链超过 32 层 | 错误 styles nest too deeply |
| 重复定义同名样式 | 警告 duplicate style ...; the last one wins |
与节点属性的优先级¶
同一节点上,最终优先级从低到高:
style:中的样式(按书写顺序)class:中的样式(按书写顺序)- 节点内联属性
内联属性覆盖样式,且跨类别生效:内联绑定可以覆盖样式里的字面值,内联字面值也可以覆盖样式里的绑定。
Style Card { background: #2C2F33; }
Card { class: Card; background: @highlighted ? "#3A4A2C" : "#2C2F33"; }
这里 background 的样式值让位给内联绑定。
属性覆盖的比较会忽略连字符,因此 margin-left 与 marginLeft 被视为同一个键;但如上文所述,非规范键仍会在应用阶段报未知属性。
样式里的绑定与模板¶
样式值同样支持 @ 绑定和 {{ }} 模板:
Var accent: "#498FC3";
Style AccentText {
color: @accent;
}
Style Status {
text: "{{@statusText}}";
}
- 绑定在节点构建时挂到控件上,之后随
DataStore刷新。 - 无法在样式中写事件脚本;写了会报错
styles cannot run scripts。 - 样式值中的
$变量在编译期展开。
状态外观¶
常用控件状态通过专用属性表达,而不是伪类选择器:
| 属性 | 作用 |
|---|---|
hover-background |
悬停时的背景 |
pressed-background |
按下时的背景 |
disabled-background |
禁用时的背景 |
disabled-opacity |
禁用时的整体不透明度 |
Style MenuButton {
background: #33363A;
color: #E6E6E6;
hover-background: #40454A;
pressed-background: #2A2D31;
disabled-background: #2A2A2A;
disabled-opacity: .5;
radius: 4;
}
把状态色写成 none 可以清除之前样式给出的值,恢复默认行为:
Style FlatButton extends MenuButton {
hover-background: none;
pressed-background: none;
}
状态色只覆盖背景
hover-background/pressed-background/disabled-background 只影响填充色。需要更复杂的悬停皮肤(描边、图标、滑块)请使用 Part 装饰层。
状态色是瞬时切换的
悬停、按下和禁用状态色直接替换填充色,不参与 transition 插值。想让颜色平滑变化,请用绑定或 @state ? a : b 驱动普通 background,详见动画与过渡。
样式不向下继承¶
样式只作用于写了 class:/style: 的那个节点,不会自动传给子节点:
Container {
class: Surface;
Label { text: "文字颜色需要自己设置"; } // 不继承 Surface 的 color
}
需要子节点也使用样式时,逐个标注,或把标题做成 Component 统一封装。
作用域与可见性¶
- 样式只在定义它的
.sil文档内可见。 - 不能跨文件引用样式。
- 不支持后代选择器、伪类、媒体查询或条件样式块。
- 条件外观用绑定或
@state ? a : b表达,见响应式绑定。
组织建议¶
- 先定义一套基础令牌样式(间距、圆角、字号),再定义业务样式继承它们。
- 颜色尽量走
Var,方便整体换肤:
Var bg: "#23262A";
Var fg: "#E4E6E8";
Var accent: "#498FC3";
Style Surface { background: $bg; color: $fg; radius: 6; }
Style Primary extends Surface { background: $accent; color: "#FFFFFF"; }
- 状态色与
transition放在同一套样式里,避免某个按钮漏掉过渡动画。 - 不要为了少写一个属性制造过深的继承链;两三层足够。