Spinner 控制

用于创建加载体验的控件。

备注

GitHub 代码组件存储库中的完整文档和源代码。

Spinner 控件。

说明

Spinner 是一个经过动画处理的圆圈轮廓,向用户指示事情正在处理。 它会在流程不确定任务需要多长时间时出现,成为 ProgressIndicator 控件的不确定版本。

Spinner 的大小可以变化,可以嵌于内容中或居中放置。 Spinner 通常在处理或提交操作后出现。 它们不易被察觉,通常不会占用太多空间,但作为已完成任务的过渡。

此代码组件提供了一个围绕 Fluent UI Spinner 控件的包装器,用于画布和自定义页面。 请参阅组件文档了解最佳做法。

键属性

属性 说明
Label Spinner 的可选标签。
SpinnerSize 要呈现的 Spinner 的大小。 选择项:xSmallSmallMediumLarge
SpinnerAlignment Spinner 在控件边界内的对齐方式。 选择项:LeftCenterRight
LabelPosition 可选择将 Spinner 标签放到特定位置。 选择项:BottomTopLeftRight

样式属性

属性 说明
Theme 接受使用 Fluent UI 主题设计器 (windows.net) 生成的 JSON 字符串。 将此属性留空将使用 Power Apps 定义的默认主题。 有关如何配置的指导,请参阅主题化
AccessibilityLabel 屏幕阅读器 aria 标签

示例

加载时显示 Spinner

在流程开始时使 Spinner 控件可见,然后在流程完成时将其隐藏。

使用变量控制 Spinner 的可见性,并更新流程代码块前后的值。

UpdateContext({ var_showLoader: true });

/* Some code ... */

UpdateContext({ var_showLoader: false });

然后,提供 var_showLoader 变量作为 Spinner 的 IsLoading 属性的值。

限制

此代码组件只能在画布应用和自定义页面中使用。