StepperInput Deprecated
StepperInputs são inputs numéricos com botões de incremento e decremento sempre visíveis.
Quando usar:
- For necessário precisar de um input do tipo número.
- O número a ser adicionado ao StepperInput for pequeno ou de poucos dígitos.
Quando não usar:
- O dado a ser utilizado no componente não for numérico.
- O dado a ser utilizado no componente for muito grande.
- O dado a ser utilizado no componente não for incremental.
Observações:
- A propriedade
width
não tem efeito quando a propriedademobile
está configurada paratrue
.
⚠️ Esse componente vai ser substituído pelo NumberInput nas próximas versões do Cuida, que vai absorver suas funcionalidades
Uso
js
<CdsStepperInput
variant="green"
size="md"
text="Lorem Ipsum"
@click="stepperInputClick = true"
/>
Preview
Props
Nome | Tipo | Default | Opções | Descrição |
---|---|---|---|---|
min | number|string | Number.MIN_SAFE_INTEGER | -- | Especifica o menor valor que o StepperInput deve aceitar. |
max | number|string | Number.MAX_SAFE_INTEGER | -- | Especifica o menor valor que o StepperInput deve aceitar. |
step | number | 1 | -- | Indica passo usado no incremento e decremento do valor do StepperInput. |
label | string | 'Label' | -- | A label do StepperInput. |
required | boolean | false | -- | Exibe asterisco indicativo de campo obrigatório. |
width Deprecated | string | 'default' | thin default wide fluid | Define a largura do StepperInput. As opções são 'thin', 'default', 'wide' e 'fluid'. |
fluid | boolean | false | -- | Indica se o componente deverá ocupar 100% da largura disponível. |
disabled | boolean | false | -- | Desabilita o StepperInput. |
state | string | 'default' | default valid invalid | Especifica o estado do StepperInput. As opções são 'default', 'valid' e 'invalid'. |
errorMessage | string | 'Valor inválido' | -- | Especifica a mensagem de erro, que será exibida caso o estado seja inválido |
mobile | boolean | false | -- | Indica se o componente deve ter sua apresentação ajustada a aplicações móveis. |
suffix | string | '' | -- | Quando ativo adiciona sufixo que indica ao usuário que ele está manipulando dados com caracterísitcas específicas, como porcentagem, milhares, pesos, etc. |
Eventos
Nome | Descrição |
---|---|
@invalid-number | Evento emitido quando o valor do modelValue está fora dos limites definidos pelas props `min` e `max`. |
@step-out-of-bounds | Evento emitido quando o valor da prop `Step` está fora dos limites definidos pelas props `min` e `max`. |
Slots
Nome | Descrição |
---|---|
#label | |
#suffix | Slot e prop de mesmo nome utilizados para adicionar sufixo ao stepperInput. O valor padrão é `%`. O valor passado por slot tem maior precedência que o valor enviado para a prop. |