公共 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;radius
export const radius: { readonly panel: "22px"; readonly page: "26px"; readonly card: "14px"; readonly chip: "22px"; };成员说明:
panel:ComposerBar / hud chipspage:InspectorPanelcard: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