ATLDateTimePicker
Android | iOS |
---|---|
Essa molécula é utilizada para inserção de dados de data e tempo pelo usuário.
Para visitar a documentação de design desta molécula, clique aqui
Exemplo de uso:
import { ATLDateTimePicker } from '@appsimples/atlantica-react-native/'
...
<ATLDateTimePickerForm
value={dateValue}
onChange={setDateValue}
title={'Data'}
type={DateTimePickerTypeEnum.date}
/>
<ATLDateTimePickerForm
value={timeValue}
onChange={setTimeValue}
title={'Hora'}
type={DateTimePickerTypeEnum.time}
/>
- Obs: Para que o estado inicial seja vazio, é preciso defini-lo como
undefined
. - Obs2: Para mudar a cor dos botões nos dialogs do android, é necessário fazê-lo nativamente.
Props
value
onChange
errorText
helpText
leftIcon
title
showFormattedDate
showFormattedTime
complementary
disabled
required
type
minDate
maxDate
horizontalMargin
verticalMargin
textInputBaseProps
value
Valor de texto que será exibido no input.
Tipo | Obrigatório | |
---|---|---|
Date | undefined | Não |
onChange
Handler que será chamado quando o usuário selecionar um novo valor.
Tipo | Obrigatório |
---|---|
function | Não |
errorText
Texto de erro que, caso fornecido, aparece no lugar do helpText
em vermelho. Também faz com que a linha divisora em baixo do input fique vermelha.
Tipo | Obrigatório |
---|---|
string | Não |
helpText
Texto de ajuda para auxiliar o usuário no fornecimento de informações, aparece à esquerda abaixo da linha.
Tipo | Obrigatório |
---|---|
string | Não |
leftIcon
Ícone decorativo que aparece à esquerda do campo e pode ajudar a indicar seu tipo ou função.
Tipo | Obrigatório |
---|---|
ImageSourcePropType | Não |
title
Título do campo que também serve como placeholder, caso fornecido.
Tipo | Obrigatório |
---|---|
string | Sim |
showFormattedDate
Função que retorna a formatação da data a ser exibida no input. O padrão é DD/MM/AAAA
Tipo | Obrigatório |
---|---|
function | Não |
showFormattedTime
Função que retorna a formatação do tempo a ser exibida no input. O padrão é HH:mm
Tipo | Obrigatório |
---|---|
function | Não |
complementary
Variação complementar da molécula a ser usada quando o fundo da tela é da cor ColorPrimary.
Tipo | Obrigatório |
---|---|
boolean | Não |
disabled
Se for true
, desabilita todas as interações com o componente.
Tipo | Obrigatório |
---|---|
boolean | Não |
required
Se for true
, adiciona um asterisco ao lado do título do campo.
Tipo | Obrigatório |
---|---|
boolean | Não |
type
Existem dois diferentes tipos de picker:
- date
- time
Tipo | Obrigatório |
---|---|
DateTimePickerTypeEnum | Não |
Caso nenhum type seja declarado, a molécula assume sua variação date (1).
minDate
Caso fornecida, não permite inserção de datas menores que ela.
Tipo | Obrigatório |
---|---|
Date | Não |
maxDate
Caso fornecida, não permite inserção de datas maiores que ela.
Tipo | Obrigatório |
---|---|
Date | Não |
horizontalMargin
Essa propriedade deve ser modificada caso seja necessário alterar a margem horizontal externa aos elementos da molécula.
Abaixo temos uma tabela indicando o token ao qual a prop está relacionada e o seu valor padrão.
Prop | Token | Default Value |
---|---|---|
horizontalMargin | SpacingInputMarginHorizontal | 24 |
verticalMargin
Essa propriedade deve ser modificada caso seja necessário alterar a margem vertical externa aos elementos da molécula.
Abaixo temos uma tabela indicando o token ao qual a prop está relacionada e o seu valor padrão.
Prop | Token | Default Value |
---|---|---|
verticalMargin | SpacingBase | 8 |
textInputBaseProps
Caso seja necessário mudar alguma propriedade base do átomo de textInput, é possível através da modificação das textInputBaseProps
.
Abaixo temos uma tabela com todas as props da label, os tokens aos quais estão relacionadas e o seu valor padrão.
Props | Token | Default Value |
---|---|---|
boxColor | ColorDarkNeutral | #212121 |
disabledOpacity | OpacityDisabled | 0.3 |
errorColor | ColorError | #D0021B |
focusColor | ColorFocus | #1E90FF |
labelColor | ColorLightNeutral | #9E9E9E |
leftIconColor | ColorPrimary | #A94CC9 |
Para mais informações, acesse ATLTextInputBase.