Ordo UI
PatternsFeedback

GlobalLoadingState

@mox-hub/patterns 模式 · Feedback · canonical

global-loading-state@mox-hub/patternsFeedbackcanonicalsrc/components/global-loading-state.tsx
变体演示global-loading-state

Props API

Prop类型默认值说明
active*boolean——
mode*LoadingMode——
message*string——

源码

packages/patterns/src/components/global-loading-state.tsx
import { LoadingOverlay, type LoadingMode } from "./loading-overlay"
import { usePatternLabels } from "../lib/i18n"

/* ============================================
   GlobalLoadingState — 全局加载状态(纯展示)

   库内不依赖 @tanstack/react-query:由消费方把「是否有在途请求」折算成
   active 传入。ordo 侧适配层用 useIsFetching() 计算 active,并保留
   原 GlobalLoadingState 的 query-cache 对账逻辑。
   ============================================ */

export interface GlobalLoadingStateProps {
  /** 是否有在途请求 / 全局加载中 */
  active: boolean
  /** 展示模式,透传 LoadingOverlay */
  mode?: LoadingMode
  /** aria-label 文案(bar 模式仅作无障碍名) */
  message?: string
}

export function GlobalLoadingState({
  active,
  mode,
  message,
}: GlobalLoadingStateProps) {
  const D = usePatternLabels("globalLoadingState", { message: "加载中" })
  return <LoadingOverlay visible={active} mode={mode} message={message ?? D.message} />
}

可访问性与 RTL

  • 键盘:交互件保留:focus-visible焦点环;浮层支持 Escape 关闭与焦点归还,菜单 / 页签按 Base UI 约定支持方向键。 筛选菜单、拖拽排序、执行树与模型 listbox 等关键键盘流由 Playwright 断言覆盖,见规范示例 · 交互与可访问性。
  • RTL:间距、对齐与方向性图标使用逻辑属性 (ms-* /text-start /rtl:-scale-x-100);通过 ThemeProvider 或I18nProvider 的direction="rtl"驱动,`lint:rtl` 会拦截新增物理类。
  • 文案:优先用组件labels /translate /translator props,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。
  • 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。

用法说明

全局加载态纯展示件:active/mode/message 投影到 LoadingOverlay;query 连接器留在消费方适配层。