handling-colors
ReactUMG 颜色/色彩类型速查。在设置背景色、前景色、透明度、ColorAndOpacity、BrushColor、ForegroundColor 等颜色属性时激活。帮助区分 SlateColor(嵌套结构)和 LinearColor(直接结构)的正确用法,以及 ColorUseRule 的必要性。
📖 中文导读:ReactUMG 颜色/色彩类型速查。在设置背景色、前景色、透明度、ColorAndOpacity、BrushColor、ForegroundColor 等颜色属性时激活。帮助区分 SlateColor(嵌套结构)和 LinearColor(直接结构)的正确用法,以及 ColorUseRule 的必要性。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: handling-colors description: ReactUMG 颜色/色彩类型速查。在设置背景色、前景色、透明度、ColorAndOpacity、BrushColor、ForegroundColor 等颜色属性时激活。帮助区分 SlateColor(嵌套结构)和 LinearColor(直接结构)的正确用法,以及 ColorUseRule 的必要性。
ReactUMG 颜色类型速查
两种颜色类型
| 类型 | 结构 | 示例 |
|---|---|---|
| SlateColor | {SpecifiedColor: {R, G, B, A}} |
嵌套结构 |
| LinearColor | {R, G, B, A} |
直接结构 |
属性 → 类型映射
| 组件 | 属性 | 类型 |
|---|---|---|
| TextBlock | ColorAndOpacity |
SlateColor |
| TextBlock | ShadowColorAndOpacity |
LinearColor |
| Border | BrushColor |
LinearColor |
| Border | ContentColorAndOpacity |
LinearColor |
| Image | ColorAndOpacity |
LinearColor |
| Button | ForegroundColor (in style) |
SlateColor |
| WidgetStyle | ForegroundColor |
SlateColor |
| WidgetStyle | FocusedForegroundColor |
SlateColor |
正确用法
// SlateColor(嵌套)
<TextBlock
ColorAndOpacity={{
SpecifiedColor: {R: 0.9, G: 0.95, B: 1, A: 1}
}}
/>
// LinearColor(直接)
<Border
BrushColor={{R: 0.05, G: 0.08, B: 0.1, A: 0.95}}
/>
⚠️ 关键规则:ColorUseRule
WidgetStyle 中的颜色必须加 ColorUseRule: 0
// ✅ 正确
WidgetStyle={{
ForegroundColor: {
SpecifiedColor: {R: 0.5, G: 0.5, B: 0.5, A: 1},
ColorUseRule: 0 // 必须!
}
}}
// ❌ 错误(颜色不会生效)
WidgetStyle={{
ForegroundColor: {
SpecifiedColor: {R: 0.5, G: 0.5, B: 0.5, A: 1}
// 缺少 ColorUseRule: 0
}
}}
快速判断方法
查看 IDE 错误信息:
"R does not exist in type RecursivePartial<SlateColor>"→ 用 SlateColor"SpecifiedColor does not exist in type RecursivePartial<LinearColor>"→ 用 LinearColor