Visão geral da classificação Web Components

    O componente Classificação Ignite UI for Web Components permite que os usuários visualizem e forneçam comentários.

    Primeiro, você precisa instalar o Ignite UI for Web Components executando o seguinte comando:

    npm install igniteui-webcomponents

    Antes de usá-losIgcRatingComponent, você precisa registrá-los da seguinte forma:

    import { defineComponents, IgcRatingComponent } from "igniteui-webcomponents";
import 'igniteui-webcomponents/themes/light/bootstrap.css';

defineComponents(IgcRatingComponent);

    Para uma introdução completa ao Ignite UI for Web Components, leia o tópico Comecando.

    A maneira mais simples de começar a usar oIgcRatingComponent é a seguinte:

    <igc-rating></igc-rating>

    Isso criará um componente de classificação de cinco estrelas que pode ser usado para inserir e ler dados.

    Using Custom Symbols

    OIgcRatingComponent componente permite que você use símbolos personalizados no lugar dos símbolos padrão de estrela. Se você quiser usar um símbolo diferente, como SVG, ícone ou outro símbolo unicode, deve colocarIgcRatingSymbolComponent componentes entre os colchetes de abertura e fechamento doIgcRatingComponent:

    <igc-rating>
  <igc-rating-symbol> <div>💙</div> <div slot="empty">💙</div> </igc-rating-symbol>
  <igc-rating-symbol> <div>💙</div> <div slot="empty">💙</div> </igc-rating-symbol>
  <igc-rating-symbol> <div>💙</div> <div slot="empty">💙</div> </igc-rating-symbol>
  <igc-rating-symbol> <div>💙</div> <div slot="empty">💙</div> </igc-rating-symbol>
</igc-rating>

    O número de símbolos de classificação entre os colchetes de abertura e fechamento do componente de classificação determina o valor máximo.

    Seleção única

    O componente Ignite UI for Web Components Rating tem um único modo de seleção que permite aos usuários fornecer diferentes ícones/elementos para os diferentes valores de classificação. Nesse caso, apenas um dos ícones/elementos pode ser selecionado e refletir o feedback dado pelo usuário.

    <igc-rating single>
  <igc-rating-symbol> <div>😣</div> <div slot="empty">😣</div> </igc-rating-symbol>
  <igc-rating-symbol> <div>😣</div> <div slot="empty">😣</div> </igc-rating-symbol>
  <igc-rating-symbol> <div>😣</div> <div slot="empty">😣</div> </igc-rating-symbol>
  <igc-rating-symbol> <div>😣</div> <div slot="empty">😣</div> </igc-rating-symbol>
  <igc-rating-symbol> <div>😣</div> <div slot="empty">😣</div> </igc-rating-symbol>
</igc-rating>

    Lembre-se de que ostep atributo não funciona no modo de seleção única.

    Empty & Selected

    O componente Ignite UI for Web Components Rating permite que os usuários usem diferentes ícones/elementos para o estado vazio e selecionado de um único valor de classificação. É obrigatório fornecer 2 ícones para cada slot (vazio e cheio) ao declarar um símbolo, mesmo que sejam iguais. Por exemplo:

    <igc-rating-symbol>
  <igc-icon collection="default" name="bandage"></igc-icon>
  <igc-icon collection="default" name="bacteria" slot="empty"></igc-icon>
</igc-rating-symbol>

    Configuração

    Single

    Ativa osingle modo visual para a avaliação. Útil ao usar símbolos que comunicam valores únicos, como emojis de feedback.

    Value

    Ovalue atributo define o valor atual do componente.

    Label

    Olabel atributo permite definir o valor do rótulo do componente de avaliação.

    Value Format

    Uma cadeia de caracteres de formato que define aria-valuetext. Todas as instâncias dele serão substituídas pelo valor atual do controle. Importante para leitores de tela e útil para localização.

    Max Value

    Omax atributo define o valor máximo permitido do componente de avaliação.

    Step

    Ostep atributo define a fração permitida de passos entre dois símbolos. Útil ao dividir os símbolos de avaliação ao meio.

    Hover Preview

    Ohover-preview atributo faz com que o componente mostre o possível resultado da seleção do usuário ao passar o cursor. É útil quando você quer dar um feedback instantâneo sobre qual valor selecionado pode ser.

    Read-Only

    OreadOnly atributo permite que os usuários definam oIgcRatingComponent modo somente leitura. Esse atributo é útil quando você quer usar o componente apenas para fins informativos.

    Disabled

    Odisabled atributo desativa o componente, tornando impossível selecionar um valor usando mouse ou teclado.

    Methods

    Step Up

    OstepUp método incrementa o valor do componente emn etapas. Determinado pelostep fator.

    Step Down

    OstepDown método diminui o valor do componente emn etapas. Determinado pelostep fator.

    Eventos

    OIgcRatingComponent componente emite dois eventos separados -igcHoverandigcChange.

    Hover Event

    OigcHover evento é acionado ao passar o mouse sobre um símbolo. Ele fornece o valor do símbolo sob o cursor do mouse. Útil para criar etiquetas de valor e leituras personalizadas.

    Change Event

    OigcChange evento é disparado quando o valor selecionado muda.

    Styling

    OIgcRatingComponent componente expõe partes do CSS para quase todos os seus elementos internos. A tabela a seguir lista todas as partes CSS expostas:

    Nome Descrição
    base O wrapper principal que contém todos os elementos de classificação.
    label A parte do rótulo.
    value-label A parte do rótulo de valor.
    symbols Um wrapper para todos os símbolos de classificação.
    symbol A parte do símbolo padrão encapsulado.
    full A parte dos símbolos completos encapsulados.
    empty A parte dos símbolos vazios encapsulados. 
    igc-rating::part(full) {
  color: var(--ig-primary-500)
}

igc-rating::part(empty) {
  color: var(--ig-secondary-200);
}

    API Reference

    Additional Resources