Visão geral do progresso linear Web Components
O componente Linear Progress Indicator Ignite UI for Web Components fornece um indicador visual do processo de um aplicativo conforme ele muda. O indicador IgcLinearProgressComponent
atualiza sua aparência conforme seu estado muda. Além disso, você pode estilizar esse componente com uma escolha de cores em listras ou sólidos.
Web Components Linear Progress Example
Usage
Primeiro, você precisa instalar o Ignite UI for Web Components executando o seguinte comando:
npm install igniteui-webcomponents
Antes de usar o IgcLinearProgressComponent
, você precisa registrá-lo da seguinte maneira:
import {defineComponents, IgcLinearProgressComponent} from 'igniteui-webcomponents';
import 'igniteui-webcomponents/themes/light/bootstrap.css';
defineComponents(IgcLinearProgressComponent);
Para uma introdução completa ao Ignite UI for Web Components, leia o tópico Introdução.
A maneira mais simples de começar a usar o IgcLinearProgressComponent
é a seguinte:
<igc-linear-progress value="100"></igc-linear-progress>
Progress Types
Você pode definir o tipo do seu indicador, usando o variant
atributo. Existem cinco tipos de indicadores de progresso linear -primário (padrão), erro, sucesso, informações e aviso.
<igc-linear-progress value="100" variant="success"></igc-linear-progress>
Striped Progress
Você pode tornar o indicador listrado, usando a striped
propriedade:
Indeterminate Progress
Se você quiser acompanhar um processo que não é determinado com precisão, poderá definir a indeterminate
propriedade.
Animation Duration
A animationDuration
propriedade é usada para especificar quanto tempo o ciclo de animação deve levar. Ele assume como valor um número que representa a duração da animação em milissegundos.
<igc-linear-progress animation-duration="5000" indeterminate></igc-linear-progress>
Text Properties
Você pode alinhar o valor padrão, usando a labelAlign
propriedade. Os valores permitidos são superior, inferior, início superior, extremidade superior, início inferior e extremidade inferior.
Para ocultar o rótulo padrão do indicador de progresso, use o hideLabel
atributo.
A labelFormat
propriedade pode ser usada para personalizar o IgcLinearProgressComponent
rótulo padrão.
O exemplo a seguir demonstra a configuração acima:
Dynamic Progress
Você pode alterar dinamicamente o valor do indicador de progresso usando controles externos como botões. Para conseguir isso, podemos vincular o valor a uma propriedade de classe:
Styling
O IgcLinearProgressComponent
componente expõe partes CSS para quase todos os seus elementos internos:
Nome | Descrição |
---|---|
track |
Área de trilha do anel de progresso. |
fill |
A área do indicador de progresso. |
striped |
O indicador de progresso listrado. |
label |
O rótulo do indicador de progresso. |
value |
O valor do rótulo de progresso. |
indeterminate |
O estado indeterminado do progresso. |
primary |
O indicador de progresso do estado primário. |
danger |
O estado de erro do indicador de progresso. |
warning |
O estado de alerta do indicador de progresso. |
info |
O estado das informações do indicador de progresso. |
success |
O estado de sucesso do indicador de progresso. |
Usando essas partes CSS, temos controle quase total do estilo Linear Progress.
igc-linear-progress::part(track){
background-color: var(--ig-gray-300)
}
igc-linear-progress::part(fill){
background-color: var(--ig-primary-300)
}
igc-linear-progress::part(label){
color: var(--ig-primary-300)
}