SuperAPI AI 工具集

sgds-components-spinner

通用与其它

查看项目

更新于 10-15 21:54

技能介绍

用途:<sgds-spinner> 是 SGDS 标准加载指示器,用于告知内容正在加载或操作正在进行。安装与框架集成(React 19+ 与 React ≤18、Vue、Angular)参见 sgds-components-setup。

主要能力与用法:通过 tone 选择色调:brand(默认,浅色背景)、neutral(中性)、inverse(深色背景)、fixed-light、fixed-dark(固定明暗,不受主题影响)。通过 size 选择尺寸:xs、sm(文本内或紧凑 UI)、md(默认)、lg、xl(突出加载态)。可通过 label 设置可见文字标签,配合 orientation 控制位置:默认 vertical(标签在下方),horizontal(标签在旁侧)。

示例:<sgds-spinner></sgds-spinner>;<sgds-spinner label="Loading..."></sgds-spinner>;<sgds-spinner label="Loading..." orientation="horizontal"></sgds-spinner>;<sgds-spinner tone="inverse"></sgds-spinner>(需置于深色背景);<sgds-spinner size="xs"></sgds-spinner> 等。

限制:variant 已弃用,应始终使用 tone,不要建议 variant="primary" 或 variant="neutral"。该组件不暴露自定义属性或 CSS 部件,不支持样式修改,无插槽、无事件、无公开方法。tone="inverse" 与 tone="fixed-light" 仅适用于深色背景,需说明背景色要求。<sgds-spinner> 被 <sgds-button loading>、<sgds-input loading>、<sgds-select loading> 内部使用,此类场景应建议直接使用对应组件的 loading 属性,而非插入独立 spinner。价格为资料未提供。