Ordo UI
PatternsSemantic

StickySaveBar

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

sticky-save-bar@mox-hub/patternsSemanticcanonicalsrc/components/sticky-save-bar.tsx
变体演示sticky-save-bar
有未保存更改

Props API

Prop类型默认值说明
dirty*boolean——
onSave*() => void——
onDiscard*() => void——
saving*booleanfalse—
hint*ReactNode——
labels*Partial<StickySaveBarLabels>——

源码

packages/patterns/src/components/sticky-save-bar.tsx
/**
 * StickySaveBar - 设置页脏状态保存栏(2026-10-01 设置页语义组件批二)
 *
 * 表单变脏(dirty=true)时浮出于滚动容器底部的保存条:说明文本 + 放弃/保存双钮。
 * 收编谱系:设置域三种保存落点并存(页头 Save 钮 git/terminal、控件旁 ai 默认模型、
 * 卡底钮 issue-type-detail)的统一形态,对齐 GitHub/Vercel 设置页惯例。
 * sticky bottom 行为(纯 CSS,无滚动监听):置于页面内容流末尾——内容不足一屏时
 * 停在内容尾部,超一屏滚动时吸附视口底(与 SettingsHeader 吸顶卡同为毛玻璃语言:
 * border + bg-background/85 + backdrop-blur-xs + shadow-xs,出现走 .motion-enter)。
 * dirty=false 时返回 null(不占位)。
 * props 面封闭(G8):不接 className、不透传样式。
 */
import type { ReactNode } from 'react';
import { Button } from '@mox-hub/ui/components/button';
import { usePatternLabels } from '../lib/i18n';

/** 组件内文案缺省(中文常量;消费方经 labels 覆写接入 i18n)。 */
export interface StickySaveBarLabels {
  unsavedChanges: string;
  discardChanges: string;
  save: string;
  saving: string;
}

export const STICKY_SAVE_BAR_DEFAULT_LABELS: StickySaveBarLabels = {
  unsavedChanges: '有未保存更改',
  discardChanges: '放弃更改',
  save: '保存',
  saving: '保存中…',
};

export interface StickySaveBarProps {
  /** 是否有未保存更改(false 渲染 null) */
  dirty: boolean;
  onSave: () => void;
  /** 放弃/重置回调;不传隐藏放弃钮 */
  onDiscard?: () => void;
  /** 保存请求进行中(双钮禁用) */
  saving?: boolean;
  /** 说明文本(缺省「有未保存更改」) */
  hint?: ReactNode;
  /** 文案覆写(默认 zh-CN;主仓 i18n 适配层集中传入 t() 结果)。 */
  labels?: Partial<StickySaveBarLabels>;
}

export function StickySaveBar({
  dirty,
  onSave,
  onDiscard,
  saving = false,
  hint,
  labels,
}: StickySaveBarProps) {
  const D = usePatternLabels('stickySaveBar', STICKY_SAVE_BAR_DEFAULT_LABELS);
  if (!dirty) return null;
  const unsavedChanges = labels?.unsavedChanges ?? D.unsavedChanges;
  const discardChanges = labels?.discardChanges ?? D.discardChanges;
  const save = labels?.save ?? D.save;
  const savingLabel = labels?.saving ?? D.saving;
  return (
    <div
      data-slot="sticky-save-bar"
      className="sticky bottom-4 z-dropdown mt-2 flex justify-center px-4"
    >
      <div className="motion-enter flex items-center gap-3 rounded-lg border border-(--panel-border) bg-(--panel-bg) py-2 ps-4 pe-2 shadow-xs backdrop-blur-(--panel-blur)">
        <span className="text-xs text-muted-foreground">
          {hint ?? unsavedChanges}
        </span>
        <div className="flex shrink-0 items-center gap-2">
          {onDiscard ? (
            <Button type="button" variant="ghost" size="xs" disabled={saving} onClick={onDiscard}>
              {discardChanges}
            </Button>
          ) : null}
          <Button type="button" size="xs" disabled={saving} onClick={onSave}>
            {saving ? savingLabel : save}
          </Button>
        </div>
      </div>
    </div>
  );
}

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

用法说明

设置页脏状态保存栏:dirty 时 sticky 底部浮出,放弃/保存双钮;saving 双钮禁用,文案 labels 可覆写。