星火 2.0 开发文档

主题

GameUI.DesignSystem ​

DesignColors 仅客户端 ​

命名空间 GameUI.DesignSystem

csharp
public static class DesignColors

现代化设计系统颜色 - 基于Material Design 3和现代UI趋势

字段 ​

Primary 仅客户端 ​

csharp
public static readonly Color Primary

主色 - 现代蓝色

PrimaryDark 仅客户端 ​

csharp
public static readonly Color PrimaryDark

主色变体 - 深蓝色

PrimaryLight 仅客户端 ​

csharp
public static readonly Color PrimaryLight

主色变体 - 浅蓝色

PrimarySurface 仅客户端 ​

csharp
public static readonly Color PrimarySurface

主色表面 - 极浅蓝色

Secondary 仅客户端 ​

csharp
public static readonly Color Secondary

辅助色 - 现代紫色

SecondaryDark 仅客户端 ​

csharp
public static readonly Color SecondaryDark

辅助色变体 - 深紫色

SecondaryLight 仅客户端 ​

csharp
public static readonly Color SecondaryLight

辅助色变体 - 浅紫色

SecondarySurface 仅客户端 ​

csharp
public static readonly Color SecondarySurface

辅助色表面 - 极浅紫色

Tertiary 仅客户端 ​

csharp
public static readonly Color Tertiary

第三色 - 现代青色

TertiaryDark 仅客户端 ​

csharp
public static readonly Color TertiaryDark

第三色变体 - 深青色

TertiaryLight 仅客户端 ​

csharp
public static readonly Color TertiaryLight

第三色变体 - 浅青色

TertiarySurface 仅客户端 ​

csharp
public static readonly Color TertiarySurface

第三色表面 - 极浅青色

Success 仅客户端 ​

csharp
public static readonly Color Success

成功色 - 现代绿色

Warning 仅客户端 ​

csharp
public static readonly Color Warning

警告色 - 现代橙色

Error 仅客户端 ​

csharp
public static readonly Color Error

错误色 - 现代红色

Info 仅客户端 ​

csharp
public static readonly Color Info

信息色 - 现代青色

Background 仅客户端 ​

csharp
public static readonly Color Background

背景色 - 浅灰色

Surface 仅客户端 ​

csharp
public static readonly Color Surface

表面色 - 白色

SurfaceVariant 仅客户端 ​

csharp
public static readonly Color SurfaceVariant

表面变体 - 浅灰色

SurfaceContainer 仅客户端 ​

csharp
public static readonly Color SurfaceContainer

表面容器 - 极浅灰色

SurfaceContainerHigh 仅客户端 ​

csharp
public static readonly Color SurfaceContainerHigh

表面容器高 - 浅灰色

SurfaceContainerHighest 仅客户端 ​

csharp
public static readonly Color SurfaceContainerHighest

表面容器最高 - 中灰色

SurfaceContainerLow 仅客户端 ​

csharp
public static readonly Color SurfaceContainerLow

表面容器低 - 极浅灰色

SurfaceContainerLowest 仅客户端 ​

csharp
public static readonly Color SurfaceContainerLowest

表面容器最低 - 白色

OnPrimary 仅客户端 ​

csharp
public static readonly Color OnPrimary

主文本色 - 深灰色

OnSecondary 仅客户端 ​

csharp
public static readonly Color OnSecondary

辅助文本色 - 白色

OnSurface 仅客户端 ​

csharp
public static readonly Color OnSurface

表面文本色 - 深灰色

OnBackground 仅客户端 ​

csharp
public static readonly Color OnBackground

背景文本色 - 深灰色

OnSurfaceVariant 仅客户端 ​

csharp
public static readonly Color OnSurfaceVariant

次要文本色 - 中灰色

OnSuccess 仅客户端 ​

csharp
public static readonly Color OnSuccess

成功文本色 - 白色

OnWarning 仅客户端 ​

csharp
public static readonly Color OnWarning

警告文本色 - 深灰色

OnError 仅客户端 ​

csharp
public static readonly Color OnError

错误文本色 - 白色

OnInfo 仅客户端 ​

csharp
public static readonly Color OnInfo

信息文本色 - 白色

Outline 仅客户端 ​

csharp
public static readonly Color Outline

边框色 - 浅灰色

Divider 仅客户端 ​

csharp
public static readonly Color Divider

分隔线色 - 浅灰色

OutlineVariant 仅客户端 ​

csharp
public static readonly Color OutlineVariant

边框变体 - 中灰色

Hover 仅客户端 ​

csharp
public static readonly Color Hover

悬停色 - 极浅主色

Pressed 仅客户端 ​

csharp
public static readonly Color Pressed

按下色 - 浅主色

Focus 仅客户端 ​

csharp
public static readonly Color Focus

焦点色 - 主色

Disabled 仅客户端 ​

csharp
public static readonly Color Disabled

禁用色 - 浅灰色

ScrollBar 仅客户端 ​

csharp
public static readonly Color ScrollBar

滚动条色 - 中灰色

ScrollBarHover 仅客户端 ​

csharp
public static readonly Color ScrollBarHover

滚动条悬停色 - 深灰色

Transparent 仅客户端 ​

csharp
public static readonly Color Transparent

透明色

Black 仅客户端 ​

csharp
public static readonly Color Black

黑色

White 仅客户端 ​

csharp
public static readonly Color White

白色

DesignTokens 仅客户端 ​

命名空间 GameUI.DesignSystem

csharp
public static class DesignTokens

UI设计系统常量 - 提供标准化的间距、尺寸、颜色等设计令牌 这些常量基于现代UI设计原则，确保界面的一致性和美观性

备注

尺寸和字号使用 UI 设计坐标，随设计画布缩放；不等同于操作系统 DIP/sp 或屏幕像素。 这些值保留兼容默认，项目应按目标窗口和移动设备选择可读字号。

字段 ​

BaseUnit 仅客户端 ​

csharp
public const float BaseUnit

基础间距单位 - 8px，符合8点网格系统

SpacingXS 仅客户端 ​

csharp
public const float SpacingXS

超小间距 - 4px

SpacingS 仅客户端 ​

csharp
public const float SpacingS

小间距 - 8px

SpacingM 仅客户端 ​

csharp
public const float SpacingM

中等间距 - 16px

SpacingL 仅客户端 ​

csharp
public const float SpacingL

大间距 - 24px

SpacingXL 仅客户端 ​

csharp
public const float SpacingXL

超大间距 - 32px

SpacingXXL 仅客户端 ​

csharp
public const float SpacingXXL

巨大间距 - 48px

BaseFontSize 仅客户端 ​

csharp
public const int BaseFontSize

兼容基础字号 - 16 个设计单位，不作为所有画布和设备的推荐正文大小

FontSizeXXL 仅客户端 ​

csharp
public const float FontSizeXXL

超大标题 - 32 个设计单位

FontSizeXL 仅客户端 ​

csharp
public const float FontSizeXL

大标题 - 24 个设计单位

FontSizeL 仅客户端 ​

csharp
public const float FontSizeL

标题 - 20 个设计单位

FontSizeM 仅客户端 ​

csharp
public const float FontSizeM

副标题 - 18 个设计单位

FontSizeS 仅客户端 ​

csharp
public const float FontSizeS

正文 - 16 个设计单位 (兼容默认)

FontSizeXS 仅客户端 ​

csharp
public const float FontSizeXS

小字 - 14 个设计单位

FontSizeXXS 仅客户端 ​

csharp
public const float FontSizeXXS

超小字 - 12 个设计单位

RadiusNone 仅客户端 ​

csharp
public const float RadiusNone

无圆角

RadiusS 仅客户端 ​

csharp
public const float RadiusS

小圆角 - 4px

RadiusM 仅客户端 ​

csharp
public const float RadiusM

中等圆角 - 8px

RadiusL 仅客户端 ​

csharp
public const float RadiusL

大圆角 - 12px

RadiusXL 仅客户端 ​

csharp
public const float RadiusXL

超大圆角 - 16px

RadiusRound 仅客户端 ​

csharp
public const float RadiusRound

圆形 - 50%

ElevationNone 仅客户端 ​

csharp
public const int ElevationNone

无阴影

ElevationS 仅客户端 ​

csharp
public const int ElevationS

轻微阴影 - Z轴层级1

ElevationM 仅客户端 ​

csharp
public const int ElevationM

中等阴影 - Z轴层级2

ElevationL 仅客户端 ​

csharp
public const int ElevationL

明显阴影 - Z轴层级3

ElevationXL 仅客户端 ​

csharp
public const int ElevationXL

强烈阴影 - Z轴层级4

DurationFast 仅客户端 ​

csharp
public const int DurationFast

快速动画 - 150ms

DurationNormal 仅客户端 ​

csharp
public const int DurationNormal

标准动画 - 300ms

DurationSlow 仅客户端 ​

csharp
public const int DurationSlow

慢速动画 - 500ms

BreakpointSmall 仅客户端 ​

csharp
public const float BreakpointSmall

小屏幕断点 - 480px

BreakpointMedium 仅客户端 ​

csharp
public const float BreakpointMedium

中等屏幕断点 - 768px

BreakpointLarge 仅客户端 ​

csharp
public const float BreakpointLarge

大屏幕断点 - 1024px

BreakpointXLarge 仅客户端 ​

csharp
public const float BreakpointXLarge

超大屏幕断点 - 1440px

ContainerCompact 仅客户端 ​

csharp
public const float ContainerCompact

紧凑容器最大宽度 - 320px

ContainerStandard 仅客户端 ​

csharp
public const float ContainerStandard

标准容器最大宽度 - 480px

ContainerComfortable 仅客户端 ​

csharp
public const float ContainerComfortable

宽松容器最大宽度 - 640px

ContainerFull 仅客户端 ​

csharp
public const float ContainerFull

全宽容器

ButtonHeightS 仅客户端 ​

csharp
public const float ButtonHeightS

小按钮高度 - 32px

ButtonHeightM 仅客户端 ​

csharp
public const float ButtonHeightM

标准按钮高度 - 40px

ButtonHeightL 仅客户端 ​

csharp
public const float ButtonHeightL

大按钮高度 - 48px

ButtonHeightXL 仅客户端 ​

csharp
public const float ButtonHeightXL

超大按钮高度 - 56px

InputHeightS 仅客户端 ​

csharp
public const float InputHeightS

小输入框高度 - 32px

InputHeightM 仅客户端 ​

csharp
public const float InputHeightM

标准输入框高度 - 40px

InputHeightL 仅客户端 ​

csharp
public const float InputHeightL

大输入框高度 - 48px

InputWidthS 仅客户端 ​

csharp
public const float InputWidthS

小输入框宽度 - 200px

InputWidthM 仅客户端 ​

csharp
public const float InputWidthM

标准输入框宽度 - 280px

InputWidthL 仅客户端 ​

csharp
public const float InputWidthL

大输入框宽度 - 360px

InputPaddingHorizontal 仅客户端 ​

csharp
public const float InputPaddingHorizontal

输入框水平内边距 - 16px

InputPaddingVertical 仅客户端 ​

csharp
public const float InputPaddingVertical

输入框垂直内边距 - 12px

IconS 仅客户端 ​

csharp
public const float IconS

小图标 - 16px

IconM 仅客户端 ​

csharp
public const float IconM

标准图标 - 24px

IconL 仅客户端 ​

csharp
public const float IconL

大图标 - 32px

IconXL 仅客户端 ​

csharp
public const float IconXL

超大图标 - 48px

ListItemHeightS 仅客户端 ​

csharp
public const float ListItemHeightS

紧凑列表项高度 - 32px

ListItemHeight 仅客户端 ​

csharp
public const float ListItemHeight

标准列表项高度 - 48px

ListItemHeightL 仅客户端 ​

csharp
public const float ListItemHeightL

大列表项高度 - 64px

ListItemHeightXL 仅客户端 ​

csharp
public const float ListItemHeightXL

带缩略图的列表项高度 - 72px

AvatarS 仅客户端 ​

csharp
public const float AvatarS

小头像 - 24px

AvatarM 仅客户端 ​

csharp
public const float AvatarM

标准头像 - 40px

AvatarL 仅客户端 ​

csharp
public const float AvatarL

大头像 - 56px

AvatarXL 仅客户端 ​

csharp
public const float AvatarXL

超大头像 - 80px

DialogWidthS 仅客户端 ​

csharp
public const float DialogWidthS

小对话框宽度 - 280px

DialogWidthM 仅客户端 ​

csharp
public const float DialogWidthM

标准对话框宽度 - 400px

DialogWidthL 仅客户端 ​

csharp
public const float DialogWidthL

大对话框宽度 - 560px

AppBarHeight 仅客户端 ​

csharp
public const float AppBarHeight

顶部导航栏高度 - 56px

BottomNavHeight 仅客户端 ​

csharp
public const float BottomNavHeight

底部导航栏高度 - 56px

SidebarWidthCollapsed 仅客户端 ​

csharp
public const float SidebarWidthCollapsed

侧边栏宽度（折叠） - 72px

SidebarWidthExpanded 仅客户端 ​

csharp
public const float SidebarWidthExpanded

侧边栏宽度（展开） - 256px

TouchTargetMin 仅客户端 ​

csharp
public const float TouchTargetMin

最小触摸目标尺寸 - 44px（iOS标准）

TouchTargetRecommended 仅客户端 ​

csharp
public const float TouchTargetRecommended

推荐触摸目标尺寸 - 48px（Material标准）

ResponsiveBreakpoint 仅客户端 ​

命名空间 GameUI.DesignSystem

csharp
public enum ResponsiveBreakpoint

响应式断点枚举

枚举值 ​

  • XSmall — 超小屏幕 - < 480px
  • Small — 小屏幕 - 480px - 768px
  • Medium — 中等屏幕 - 768px - 1024px
  • Large — 大屏幕 - 1024px - 1440px
  • XLarge — 超大屏幕 - >= 1440px

ResponsiveButtonSize 仅客户端 ​

命名空间 GameUI.DesignSystem

csharp
public enum ResponsiveButtonSize

响应式按钮尺寸枚举

枚举值 ​

  • Small — 小按钮 - 32px
  • Medium — 标准按钮 - 40px
  • Large — 大按钮 - 48px
  • XLarge — 超大按钮 - 56px

ResponsiveContainerSize 仅客户端 ​

命名空间 GameUI.DesignSystem

csharp
public enum ResponsiveContainerSize

响应式容器尺寸枚举

枚举值 ​

  • Compact — 紧凑容器 - 320px
  • Standard — 标准容器 - 480px
  • Comfortable — 宽松容器 - 640px
  • Full — 全宽容器

ResponsiveInputSize 仅客户端 ​

命名空间 GameUI.DesignSystem

csharp
public enum ResponsiveInputSize

响应式输入框尺寸枚举

枚举值 ​

  • Small — 小输入框 - 32px高, 200px宽
  • Medium — 标准输入框 - 40px高, 280px宽
  • Large — 大输入框 - 48px高, 360px宽

ResponsiveVisibility 仅客户端 ​

命名空间 GameUI.DesignSystem

csharp
public enum ResponsiveVisibility

响应式可见性枚举

枚举值 ​

  • Always — 始终显示
  • XSmallOnly — 仅超小屏幕显示
  • SmallOnly — 仅小屏幕显示
  • MediumOnly — 仅中等屏幕显示
  • LargeOnly — 仅大屏幕显示
  • XLargeOnly — 仅超大屏幕显示
  • SmallAndUp — 小屏幕及以上显示
  • MediumAndUp — 中等屏幕及以上显示
  • LargeAndUp — 大屏幕及以上显示
  • XLargeAndUp — 超大屏幕及以上显示
  • SmallAndDown — 小屏幕及以下显示
  • MediumAndDown — 中等屏幕及以下显示
  • LargeAndDown — 大屏幕及以下显示
  • XLargeAndDown — 超大屏幕及以下显示