ProgressIndicator control
Un control utilizado para crear una experiencia de carga.
Nota
La documentación completa y el código fuente se encuentran en el repositorio de componentes de código GitHub.
Description
Los indicadores de progreso se utilizan para mostrar el estado de finalización de una operación que dura más de dos segundos. Si no se puede determinar el estado de progreso, utilice un Spinner el tipo Indeterminate Indicator en su lugar. Los indicadores de progreso pueden aparecer en un nuevo panel, en una ventana de control flotante, debajo de la interfaz de usuario que inició la operación o pueden incluso reemplazar la interfaz de usuario de inicio, siempre y cuando la IU pueda volver si cancela o detiene la actividad.
Este componente de código proporciona un envoltorio alrededor del control ProgressIndicator de Fluent UI para su uso en aplicaciones de lienzo y páginas personalizadas. Consulte la documentación del componente para conocer las mejores prácticas.
Propiedades
Propiedades importantes
| Property | Descripción |
|---|---|
Label |
Etiqueta opcional para spinner. |
Percentage Complete |
Porcentaje de la operación realizada, en la escala de 0 a 1. Si no se establece, se mostrará el indicador indeterminado. |
TypeOfIndicator |
Especifica el tipo de estilo de indicador. Opciones: Default Indicator o IndeterminateIndicator |
HideProgressState |
Especifique verdadero para ocultar el estado de progreso |
BarHeight |
Especifique la altura de la barra según corresponda |
Propiedades de estilo
| Property | Descripción |
|---|---|
Theme |
Acepta una cadena JSON que se genera usando Diseñador de temas de Fluent UI (windows.net). Si deja esto en blanco, usará el tema predeterminado definido por Power Apps. Para obtener ayuda sobre cómo configurarlo vea Tematización. |
AccessibilityLabel |
aria-label para lectores de pantalla |
Behavior
Mostrar el progreso de carga
Haga que el propio control ProgressIndicator (o la superficie en la que se encuentra) quede visible cuando comienza un proceso; luego, actualice una variable con el valor a medida que se completan los segmentos del proceso. Ocúltela cuando el proceso haya finalizado. Use una variable para controlar la visibilidad del control y actualice los valores entre los bloques de código principal del proceso que necesita indicación.
UpdateContext({ var_showProgress: true , var_progressValue: 0 });
/* Some code ... */
UpdateContext({ var_progressValue: 25 });
/* Some code ... */
UpdateContext({ var_progressValue: 50 });
/* Some code ... */
UpdateContext({ var_progressValue: 75 });
/* Some code ... */
UpdateContext({ var_progressValue: 100 });
Notify("Successfully completed process", NotificationType.Success);
UpdateContext({ var_showProgress: false });
Suministre la variable var_showProgress como el valor de la propiedad Visible de ProgressIndicator (o la superficie que lo contiene), y asigne la variable var_progressValue para la propiedad Value.
Limitaciones
Este componente de lienzo solo se puede usar en aplicaciones de lienzo y páginas personalizadas.