Spinner 控制
用于创建加载体验的控件。
备注
GitHub 代码组件存储库中的完整文档和源代码。
说明
Spinner 是一个经过动画处理的圆圈轮廓,向用户指示事情正在处理。 它会在流程不确定任务需要多长时间时出现,成为 ProgressIndicator 控件的不确定版本。
Spinner 的大小可以变化,可以嵌于内容中或居中放置。 Spinner 通常在处理或提交操作后出现。 它们不易被察觉,通常不会占用太多空间,但作为已完成任务的过渡。
此代码组件提供了一个围绕 Fluent UI Spinner 控件的包装器,用于画布和自定义页面。 请参阅组件文档了解最佳做法。
键属性
属性 | 说明 |
---|---|
Label |
Spinner 的可选标签。 |
SpinnerSize |
要呈现的 Spinner 的大小。 选择项:xSmall 、Small 、Medium 、Large |
SpinnerAlignment |
Spinner 在控件边界内的对齐方式。 选择项:Left 、Center 、Right |
LabelPosition |
可选择将 Spinner 标签放到特定位置。 选择项:Bottom 、Top 、Left 、Right |
样式属性
属性 | 说明 |
---|---|
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
属性的值。
限制
此代码组件只能在画布应用和自定义页面中使用。