TextBlock Design Token

TextBlock 是 Avalonia TextBlock 的轻量包装，不使用组件级 Design Token。它没有 ControlDesignToken 子类，没有 TokenResourceScopeProvider，也不通过 RegisterTokenResourceScope 注册 Token 作用域。

样式来源

TextBlock 的视觉属性来自以下几个层次：

1. Avalonia 全局 TextBlock 样式

Avalonia 框架为 TextBlock 提供了默认的字体族、字体大小、前景色等全局样式。AtomUI 的主题系统会通过全局样式覆盖这些默认值。

2. 父控件主题上下文

当 TextBlock 被嵌入其他控件的模板中时（如 Separator 标题、Tag 文本、FormItem 标签等），其样式由父控件的 ControlTheme 通过模板选择器（/template/）控制。例如：

<!-- 在 Separator 主题中，标题 TextBlock 的字号由 Separator Token 控制 -->
<Style Selector="^:is(atom|Separator) /template/ TextBlock#PART_Title">
    <Setter Property="FontSize" Value="{atom:SharedTokenResource FontSizeLG}" />
</Style>

3. 使用处直接设置

在 AXAML 中直接使用 atom:TextBlock 时，可通过属性或 Style 自由设置视觉属性：

<atom:TextBlock Text="Hello"
                FontSize="16"
                Foreground="{atom:SharedTokenResource ColorText}" />

可用的全局 SharedToken

虽然 TextBlock 没有组件级 Token，但可以在使用处通过 {atom:SharedTokenResource} 引用全局 Token 来保持主题一致性：

Token 资源键	典型用途
`ColorText`	主要文本颜色
`ColorTextSecondary`	次要文本颜色
`ColorTextTertiary`	第三级文本颜色
`ColorTextDisabled`	禁用态文本颜色
`ColorTextHeading`	标题文本颜色
`ColorLink`	链接文本颜色
`ColorError`	错误文本颜色
`ColorWarning`	警告文本颜色
`ColorSuccess`	成功文本颜色
`FontSize`	标准字号（14px）
`FontSizeSM`	小号字号（12px）
`FontSizeLG`	大号字号（16px）
`FontSizeXL`	特大号字号（20px）
`LineHeight`	标准行高

示例：在自定义样式中使用 Token

<!-- 通过 Token 保持主题一致性 -->
<atom:TextBlock Text="Secondary text"
                Foreground="{atom:SharedTokenResource ColorTextSecondary}"
                FontSize="{atom:SharedTokenResource FontSizeSM}" />

<!-- 在 Style 中引用 Token -->
<Style Selector="atom|TextBlock.description">
    <Setter Property="Foreground" Value="{atom:SharedTokenResource ColorTextTertiary}" />
    <Setter Property="FontSize" Value="{atom:SharedTokenResource FontSizeSM}" />
</Style>

2.6 KiB Raw Blame History Unescape Escape