Loader 加载器
Feedback
展示型
简介
一个可视化的加载布局工具组件,将旋转的 Spinner 元素与配套的 status 消息文本配对。主要用于在布局区块内的服务端获取、文件操作、状态转换或内容处理状态期间管理用户预期。
Loader 组件已作为 loader 区块完全集成到 Page Builder 中,使内容作者和开发者能够直接在 CMS 页面模式中轻松配置可视状态文本和加载器对齐方式。
用法
以下示例展示了内容编辑者如何绑定和构建交互式加载器。
1. 标准居中状态加载器
一个带有标准状态文本的经典加载指示器,适用于主要面板条目、内容更新或懒加载区块。
{
"type": "loader",
"text": "Loading workspace data...",
"spinnerPlacement": "start"
}
Loading workspace data...
2. 带尾部加载器(尾部对齐)
将视觉加载器对齐在状态消息之后,为卡片底部或内联按钮操作提供替代的视觉流。
{
"type": "loader",
"text": "Please wait while we process your request",
"spinnerPlacement": "end"
}
Please wait while we process your request
属性
| 属性 | CMS 字段类型 | 默认值 | 描述 / 支持选项 |
|---|---|---|---|
状态文本 (text) | string | - | 显示在旋转加载器旁边的消息文本。 |
加载器位置 (spinnerPlacement) | select | "start" | 加载器相对于伴随文本的对齐方式。 • 选项: "start"、"end"。 |
开发者说明与无障碍
- 免水合(仅静态): Loader 是一个纯展示性的布局辅助组件,被指定为仅静态组件(
Tier 3)。它编译为标准服务端 HTML/CSS 标记,完全不含任何交互式客户端 JavaScript。 - WAI-ARIA 合规: 在底层,该组件专为辅助技术设计,以适当的实时区域或忙碌容器参数编译(例如父容器上的
aria-busy="true"、role="status"),确保对正在进行的后台活动进行顺畅的播报。