ATLCheckbox

Esta molécula é composta por uma checkbox de seleção binária seguida de textos e/ou links.
Para visitar a documentação de design desta molécula, clique aqui.
Exemplo de Uso:
import { ATLCheckbox } from '@appsimples/atlantica-react-native'
...
const useTermsText: CheckboxText[] = [
{ text: 'Li e concordo com os ' },
{ text: 'Termos de Uso ', onPress: onPressUseTerms },
{ text: 'e ' },
{ text: 'Política de Privacidade', onPress: onPressPrivacyPolicy }
]
...
<ATLCheckbox
value={valueCheckbox}
texts={useTermsText}
onChange={onPressCheckbox}
/>
Props
valueonChangetextscomplementaryhorizontalMarginhorizontalPaddingverticalMarginbuttonToggleBasePropslinkLabelBasePropsregularLabelBaseProps
value
Valor da checkbox que corresponde a ela estar tickada (true) ou não (false)
| Tipo | Obrigatório |
|---|---|
| boolean | Não |
onChange
Handler que será chamado quando o usuário mudar o valor da checkbox.
| Tipo | Obrigatório |
|---|---|
| function | Não |
texts
Texto que aparece ao lado do ícone de checkbox.
Esses textos são passados em um array de objetos do tipo CheckboxText. Um objeto deste tipo possui duas propriedades: text (obrigatória) e onPress (opcional).
Caso a propriedade onPress seja passada, o texto será renderizado como um link. Caso contrário, como um texto comum.
| Tipo | Obrigatório |
|---|---|
| CheckboxText[] | 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 |
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 |
horizontalPadding
Essa propriedade deve ser modificada caso seja necessário alterar o espaçamento entre o ícone da checkbox e o texto.
Abaixo temos uma tabela indicando o token ao qual a prop está relacionada e o seu valor padrão.
| Prop | Token | Default Value |
|---|---|---|
| horizontalPadding | SpacingMarginal | 16 |
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 |
buttonToggleBaseProps
Caso seja necessário mudar alguma propriedade base do botão da checkbox, é possível através da modificação das buttonToggleBaseProps.
Abaixo temos uma tabela com todas as props do botão, os tokens aos quais estão relacionadas e o seu valor padrão.
| Props | Token | Default Value |
|---|---|---|
| size | (fixed) | 24 |
| tintColor | ColorPrimary | #A94CC9 |
Para mais informações, acesse ATLButtonToggle.
linkLabelBaseProps
Caso seja necessário mudar alguma propriedade base do átomo de label relativo ao link, é possível através da modificação das linkLabelBaseProps.
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 |
|---|---|---|
| fontFamily | FontFamilyBase | undefined |
| fontSize | FontSizeButton | 12 |
| fontWeight | FontWeightStrong | Bold (700) |
| lineHeight | LineHeightBase | 20 |
| opacity | (fixed) | 1 |
| textAlign | TextAlignmentBody | Left |
| textCase | TextCaseButton | uppercase |
| textColor | ColorPrimary | #A94CC9 |
Para mais informações, acesse ATLLabelBase.
regularLabelBaseProps
Caso seja necessário mudar alguma propriedade base do átomo de label relativo aos textos comuns, é possível através da modificação das regularLabelBaseProps.
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 |
|---|---|---|
| fontFamily | FontFamilyBase | undefined |
| fontSize | FontSizeBody | 14 |
| fontWeight | FontWeightNormal | Regular (400) |
| lineHeight | LineHeightBase | 20 |
| opacity | (fixed) | 1 |
| textAlign | TextAlignmentBody | Left |
| textCase | TextCaseBody | None |
| textColor | ColorDarkNeutral | #212121 |
Para mais informações, acesse ATLLabelBase.
