组件/Settings 设置中心

Settings 设置中心

分区导航、分组设置行、改动即时保存的设置中心

自 0.6.0BETA

当前组件文档正在开发中

该页面正在持续迁移,示例与 API 可能会继续调整。

用法

分区设置页

改任何一项,页头依次显示「保存中…」与「已保存」。

示例加载中...

概述

Tuff 的设置中心:改动即时保存,页头只显示保存状态,没有「保存」按钮。

  • 改动后页头显示「保存中…」,600ms 内无新改动即变为「已保存 · 刚刚」。
  • 呼出快捷键可录制:组合须含 ⌘、⌃ 或 ⌥,Esc 或点别处取消。
  • 快捷键页可筛选、逐个启停;AI 页的 API Key 默认遮盖(示例值)。
  • 重置、清空剪贴板历史、退出其他设备都先确认。
  • 进入视口后自动演示一次,读者一操作即停止;减少动态效果时直接显示最终状态,并关闭分区切换动画。
  • 宽屏(≥ 960px)右侧出现实时预览;窄屏(< 640px)导航移到顶部,控件换到标签下方。

自定义

  • 接真实存储时,把 watch(settings) 里的计时器换成防抖写入;失败时把状态改为「未保存」并给出重试。
  • 新分区的 TxTabItem 用稳定的英文 name,标签放进 #name 插槽,切换语言时当前分区才不会丢。
  • TxTabs 会卸载切走的面板:值不要存在行组件里,头像的 object URL 也要自己持有一份。
  • TxGroupBlock 统一 collapsible=false(gsap 驱动的展开没有减弱动态效果兜底),也不设会写 localStorage 的 memoryName。
  • 敏感字段放在分组正文,不放进 56px 设置行;TxFlatSelect 就地展开、不 teleport,要避开滚动容器的裁切。

相关组件

区域组件作用
导航TxTabs / TxTabItemGroup / TxTabItem分组的分区导航
页头TxTabs 的 TxTabHeader、TxStatusBadge、TxButton分区标题、保存状态与重置
设置行TxGroupBlock / TxBlockSlot / TxBlockLine固定展开的分组与设置行
通用与 CoreBoxTuffSwitch、TxFlatSelect、TxFlatRadio、TxSlider、TxSelect、TxSegmentedSlider、TxNumberInput、TxInput、TxKbd外观、快捷键与结果设置
快捷键TxSearchInput、TxKbd、TuffSwitch、TxSearchEmpty可筛选、可启停的快捷键
AI 与隐私TxAlert、TxSensitiveInput、TxCheckbox、TxRadioGroup / TxRadio服务商、密钥与隐私选项
账户TxAvatar、TxImageUploader头像、名称、邮箱与套餐
确认框TxModal、TxCheckbox危险操作前的确认
实时预览(宽屏)TxIconChip、手写迷你 CoreBox迷你 CoreBox 预览