@mamba/range
v12.1.0
Published
O módulo `Range` pode ser usado para representar um valor dentro de um intervalo, que pode ser alterado a partir dos botões nas laterais.
Downloads
102
Keywords
Readme
Range
O módulo Range
pode ser usado para representar um valor dentro de um intervalo, que pode ser alterado a partir dos botões nas laterais.
| Propriedades | Descrição | Tipo | Padrão |
| :----------- | :----------------------------------------------------------------- | :---------------- | :---------- |
| value | valor escolhido | int
| 50
|
| step | intervalo entre valores | int
| 10
|
| max | valor máximo | int
| 100
|
| min | valor mínimo | int
| 0
|
| mainColor | cor do progresso e botões | string
(hex) | #3da10f
|
| barColor | cor de fundo | string
(hex) | #000
|
| textColor | cor do texto | string
(hex) | #404040
|
| icon | ícone que será apresentado ao lado do texto | string
| undefined
|
| unit | unidade de valor | string
(%,x...) | undefined
|
| validation | função de validação que impede mudança de valor caso retorne falso | function
| undefined
|
Eventos
<Range ... on:event="..."/>
| Eventos | Disparado quando ... | Tipo |
| --------- | -------------------- | --------------- |
| decrement | O valor é decrescido | function(int)
|
| increment | O valor é aumentado | function(int)
|
Métodos
increment()
Aumenta em uma unidade do Step
o valor atual do Range
.
decrement()
Diminui em uma unidade do Step
o valor atual do Range
.
Validação
Às vezes o valor mínimo e máximo de um intervalo não representa, de fato, o valor mínimo/máximo que o usuário pode selecionar. Para estes casos, é possível usar a prop validation
para validar o novo valor. Basta passar uma função que receberá o novo possível valor.
<Range validation="{rangeValidation}" />
<script>
export {
components: {
Range: '@mamba/range',
},
data() {
return {
/** Limita o valor entre 20 e 80 */
rangeValidation: value => value >= 20 && value <= 80,
};
},
}
</script>