跳转到内容

公共 UI 组件与主题桥:buttonClassName – useThemeService

本页由当前 SDK 声明自动生成。 导入入口:@woohaa3/ui。

返回接口索引

buttonClassName · color · font · generationParameterError · radius · shadow · space · theme · useAppTheme · useDialogSurfaceContext · useOptionalAppTheme · useOptionalUiContext · usePortalContainer · usePortalContainerFor · useThemeService

buttonClassName

生成统一 ui-button class(业务可传 className 追加布局类)。

export function buttonClassName(base: string, options: { size?: ButtonSize; tone?: ButtonTone; className?: string; }): string;

关联类型:ButtonSize · ButtonTone

color

颜色访问器:只返回 var(--app-*),保证组件不持有独立品牌色。

export const color: { readonly panel: "var(--app-web-panel)"; readonly surface: "var(--app-web-surface)"; readonly surfaceHover: "var(--app-web-elevated)"; readonly chip: "var(--app-web-panel)"; readonly accent: "var(--app-interaction-accent)"; readonly accentWarm: "var(--app-status-danger)"; readonly text: "var(--app-web-text-primary)"; readonly textMuted: "var(--app-web-text-muted)"; readonly textFaint: "var(--app-web-text-muted)"; readonly border: "var(--app-web-border)"; readonly borderStrong: "var(--app-web-border-strong)"; readonly backdrop: "var(--app-web-backdrop)"; };

font

export const font: { readonly family: "\"Noto Sans SC\", \"Noto Sans\", system-ui, -apple-system, \"Segoe UI\", sans-serif"; readonly sizeSm: "13px"; readonly sizeBase: "16px"; readonly sizeLg: "18px"; readonly sizeTitle: "22px"; };

generationParameterError

export function generationParameterError(field: GenerationParameterField, values: Record<string, unknown>): string;

关联类型:GenerationParameterField

radius

export const radius: { readonly panel: "22px"; readonly page: "26px"; readonly card: "14px"; readonly chip: "22px"; };

成员说明:

  • panel:ComposerBar / hud chips
  • page:InspectorPanel
  • card:Inner cards, inputs

shadow

export const shadow: { readonly panel: "0 6px 22px var(--app-web-shadow)"; readonly card: "0 3px 10px var(--app-web-shadow)"; };

space

export const space: { readonly xs: "6px"; readonly sm: "10px"; readonly md: "16px"; readonly lg: "26px"; };

theme

export const theme: { readonly color: { readonly panel: "var(--app-web-panel)"; readonly surface: "var(--app-web-surface)"; readonly surfaceHover: "var(--app-web-elevated)"; readonly chip: "var(--app-web-panel)"; readonly accent: "var(--app-interaction-accent)"; readonly accentWarm: "var(--app-status-danger)"; readonly text: "var(--app-web-text-primary)"; readonly textMuted: "var(--app-web-text-muted)"; readonly textFaint: "var(--app-web-text-muted)"; readonly border: "var(--app-web-border)"; readonly borderStrong: "var(--app-web-border-strong)"; readonly backdrop: "var(--app-web-backdrop)"; }; readonly radius: { readonly panel: "22px"; readonly page: "26px"; readonly card: "14px"; readonly chip: "22px"; }; readonly shadow: { readonly panel: "0 6px 22px var(--app-web-shadow)"; readonly card: "0 3px 10px var(--app-web-shadow)"; }; readonly space: { readonly xs: "6px"; readonly sm: "10px"; readonly md: "16px"; readonly lg: "26px"; }; readonly font: { readonly family: "\"Noto Sans SC\", \"Noto Sans\", system-ui, -apple-system, \"Segoe UI\", sans-serif"; readonly sizeSm: "13px"; readonly sizeBase: "16px"; readonly sizeLg: "18px"; readonly sizeTitle: "22px"; }; };

useAppTheme

读取当前主题 snapshot(必须位于 ThemeProvider 内)。

export function useAppTheme(): AppThemeSnapshot;

关联类型:AppThemeSnapshot

useDialogSurfaceContext

从 Host context 读取模态策略(standalone 时返回 null)。

export function useDialogSurfaceContext(): DialogSurfaceContextValue | null;

关联类型:DialogSurfaceContextValue

useOptionalAppTheme

可选读取:不在 Provider 内时返回 null(组件可脱离主题独立渲染)。

export function useOptionalAppTheme(): AppThemeSnapshot | null;

关联类型:AppThemeSnapshot

useOptionalUiContext

读取 UiProvider context(可选:未挂载时返回 null,primitive 回退到 document.body)。

export function useOptionalUiContext(): UiContextValue | null;

关联类型:UiContextValue

usePortalContainer

读取 portal container(不强制要求 Provider;缺失时返回 null)。

export function usePortalContainer(): HTMLElement | null;

usePortalContainerFor

派生某层级的 portal container(当前实现共享同一 root,保留扩展点)。

export function usePortalContainerFor(_layer: PortalLayer): HTMLElement | null;

关联类型:PortalLayer

useThemeService

读取主题 Service(showcase / 主题切换 UI 用)。

export function useThemeService<T extends ThemeSource = ThemeSource>(): T;

关联类型:ThemeSource