Ordo UI
组件Feedback

Spinner

@mox-hub/ui 组件 · Feedback · canonical

spinner@mox-hub/uiFeedbackcanonicalsrc/components/spinner.tsx
变体演示spinner

Props API

Prop类型默认值说明
size*SpinnerSize"md"—
label*string——
className*string——

源码

packages/ui/src/components/spinner.tsx
import { useMessages } from "../i18n"
import { cn } from "../lib/utils"
import { Loader2Icon } from "lucide-react"

export type SpinnerSize = "sm" | "md" | "lg" | "xl"

export interface SpinnerProps extends React.ComponentProps<"svg"> {
  size?: SpinnerSize
  label?: string
}

const sizeMap: Record<SpinnerSize, string> = {
  sm: "size-4",
  md: "size-5",
  lg: "size-6",
  xl: "size-8",
}

function Spinner({ size = "md", label, className, ...props }: SpinnerProps) {
  const M = useMessages()
  return (
    <Loader2Icon
      role="status"
      aria-label={label ?? M.spinner.label}
      data-slot="spinner"
      data-size={size}
      className={cn(sizeMap[size], "animate-spin text-current", className)}
      {...props}
    />
  )
}

export { Spinner }

可访问性与 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。

用法说明

小型加载指示器,size 控制尺寸;按钮内加载用 Spinner 配合 disabled。