# RatingScale
Componente de escala de avaliação que permite ao usuário selecionar um nó de uma escala visual. Ideal para pesquisas de satisfação (NPS, CSAT) e questionários de feedback. Implementa `ControlValueAccessor` para integração com Reactive Forms e Template-Driven Forms.
## Quando usar
- Pesquisas de satisfação com representação visual emocional (ícones de humor)
- Net Promoter Score (NPS) com escala numérica de 0 a 10
- Avaliação de atendimento, suporte ou experiência do usuário
- Formulários de feedback com escalas qualitativas ou quantitativas
## Quando não usar
- Para avaliações com estrelas — use `StarRating`
- Para seleção de uma opção de um conjunto sem representação visual de escala — use `RadioButtonGroup`
- Quando a escala tem mais de 15 itens e o espaço horizontal é limitado
## Instalação
```typescript
import { RatingScaleModule } from '@seniorsistemas/angular-components/rating-scale';
@NgModule({ imports: [RatingScaleModule] })
export class MeuModulo {}
```
## Uso básico
```html
```
## API
### Inputs
| Propriedade | Tipo | Padrão | Obrigatório | Descrição |
|-------------|------|--------|:-----------:|-----------|
| `nodes` | `RatingScaleNode[]` | — | Sim | Lista de nós que compõem a escala. Cada nó é uma opção clicável |
| `startLabel` | `string` | `undefined` | Não | Rótulo exibido abaixo do primeiro nó (extremo negativo) |
| `endLabel` | `string` | `undefined` | Não | Rótulo exibido abaixo do último nó (extremo positivo) |
| `disabled` | `boolean` | `false` | Não | Desabilita o componente, impedindo seleção de qualquer nó |
### Tipos
```typescript
interface RatingScaleNode {
id: string; // Identificador único do nó (obrigatório)
title?: string; // Texto exibido abaixo do ícone
icon?: string; // Classe do ícone Font Awesome (ex: 'fa-smile')
}
```
> O `FormControl` deve ser do tipo `RatingScaleNode`. O componente emite o objeto `RatingScaleNode` completo quando um nó é selecionado.
## Exemplos
### Escala de humor com ícones
```typescript
const nosHumor: RatingScaleNode[] = [
{ id: 'very-happy', title: 'Muito feliz', icon: 'fa-laugh-wink' },
{ id: 'happy', title: 'Feliz', icon: 'fa-smile' },
{ id: 'normal', title: 'Normal', icon: 'fa-meh' },
{ id: 'sad', title: 'Triste', icon: 'fa-sad-tear' },
{ id: 'very-sad', title: 'Muito triste', icon: 'fa-sad-cry' },
];
```
```html
```
### Escala numérica NPS (1 a 10)
```typescript
const nosNPS: RatingScaleNode[] = Array.from({ length: 10 }, (_, i) => ({
id: String(i + 1),
title: String(i + 1),
}));
```
```html
```
### Com valor pré-selecionado
```typescript
this.form = new FormGroup({
avaliacao: new FormControl(nosHumor[1]), // 'Feliz' pré-selecionado
});
```
### Desabilitado (somente leitura)
```html
```
### Apenas ícones (sem títulos nos nós)
```html
```
## Acessibilidade
- Cada nó é um elemento `