ATLActionListCard
Esta molécula foi desenhada para compor uma listagem de itens, contendo ações adjascentes em forma de botões e/ou Icones com ação.
Para visitar a documentação de design desta molécula, clique aqui.
Exemplo de uso:
import { ATLActionListCard } from '@appsimples/atlantica-react-native'
...
<ATLActionListCard
icon={icon}
itemTitle={'Item da Lista'}
itemDescription={'Este item é muito bom para você!'}
titleActionButton={'Quero!'}
onPressActionButton={onPressActionButton}
/>
<ATLActionListCard
icon={icon}
itemTitle={'Item da Lista'}
itemDescription={'Este item é muito bom para você!'}
titleActionButton={'Quero!'}
onPressActionButton={onPressActionButton}
isActionButtonOutlined
/>
<ATLActionListCard
icon={icon}
itemTitle={'Item da Lista'}
itemDescription={'Este item é muito bom para você!'}
titleActionButton={'Quero!'}
firstIconButtonImage={firstIcon}
secondIconButtonImage={secondIcon}
onPressFirstIconButton={onPressFirstIconButton}
onPressSecondIconButton={onPressSecondIconButton}
/>
<ATLActionListCard
icon={icon}
itemTitle={'Item da Lista'}
itemDescription={'Este item é muito bom para você!'}
checkboxValue={true}
checkboxOnChange={checkboxOnChange}
/>
O código acima gera as seguintes quatro primeiras moléculas da lista à seguir. Para gerar as demais, basta não passar o parâmetro icon
:
Para renderizar a molécula com o botão de ação, é preciso passar as props titleActionButton
e onPressActionButton
Para renderizar a molécula com os botões de ícone, é preciso passar as props: firstIconButtonImage
, secondIconButtonImage
, onPressFirstIconButton
e onPressSecondIconButton
Para renderizar a molécula com a checkbox, é preciso passar as props checkboxValue
e checkboxOnChange
Props
checkboxValue
checkboxOnChange
icon
itemDescription
itemTitle
firstIconButtonImage
secondIconButtonImage
titleActionButton
onPressActionButton
onPressFirstIconButton
onPressOverflowButton
onPressSecondIconButton
isActionButtonOutlined
horizontalMargin
horizontalPaddingAction
horizontalPaddingIcon
verticalMargin
buttonBaseProps
checkboxToggleBaseProps
descriptionLabelBaseProps
dividerBaseProps
iconBaseProps
iconButtonBaseProps
overflowIconButtonBaseProps
titleLabelBaseProps
checkboxValue
Valor da checkbox que corresponde a ela estar tickada (true
) ou não (false
).
Tipo | Obrigatório |
---|---|
boolean | Não |
A prop não é obrigatória mas para renderizar a checkbox é necessário preenchê-la juntamente com checkboxOnChange
.
checkboxOnChange
Handler que será chamado quando o usuário mudar o valor da checkbox ao pressioná-la.
Tipo | Obrigatório |
---|---|
function | Não |
A prop não é obrigatória mas para renderizar a checkbox é necessário preenchê-la juntamente com checkboxValue
.
icon
Se o parâmetro for passado, renderiza um ícone do lado esquerdo da molécula.
Tipo | Obrigatório |
---|---|
ImageSourcePropType | Não |
A prop não é obrigatória mas para renderizar o ícone é necessário preenchê-la.
itemDescription
Segunda linha de texto que mostra a descrição do item.
Tipo | Obrigatório |
---|---|
string | Não |
A prop não é obrigatória mas para renderizar o texto é necessário preenchê-la.
itemTitle
Primeira linha de texto relativa ao título do item.
Tipo | Obrigatório |
---|---|
string | Sim |
firstIconButtonImage
Ícone que aparece dentro do primeiro botão na variação da molécula que possui 2 botões.
Tipo | Obrigatório |
---|---|
ImageSourcePropType | Não |
A prop não é obrigatória mas para renderizar o par de botões é necessário preenchê-la juntamente com: secondIconButtonImage
, onPressFirstIconButton
e onPressSecondIconButton
.
secondIconButtonImage
Ícone que aparece dentro do segundo botão na variação da molécula que possui 2 botões.
Tipo | Obrigatório |
---|---|
ImageSourcePropType | Não |
A prop não é obrigatória mas para renderizar o par de botões é necessário preenchê-la juntamente com: firstIconButtonImage
, onPressFirstIconButton
e onPressSecondIconButton
.
titleActionButton
Texto que aparece dentro do botão de ação.
Tipo | Obrigatório |
---|---|
string | Não |
A prop não é obrigatória mas para renderizar o botão é necessário preenchê-la juntamente com onPressActionButton
.
onPressActionButton
Handler que será chamado quando o usuário apertar o botão de ação.
Tipo | Obrigatório |
---|---|
function | Não |
A prop não é obrigatória mas para renderizar o botão é necessário preenchê-la juntamente com titleActionButton
.
onPressFirstIconButton
Handler que será chamado quando o usuário apertar o primeiro botão de ícone.
Tipo | Obrigatório |
---|---|
function | Não |
A prop não é obrigatória mas para renderizar o par de botões é necessário preenchê-la juntamente com: firstIconButtonImage
, secondIconButtonImage
e onPressSecondIconButton
.
onPressOverflowButton
Handler que será chamado quando o usuário apertar o botão de overflow.
Tipo | Obrigatório |
---|---|
function | Não |
A prop não é obrigatória mas para renderizar o botão de overflow é necessário preenchê-la.
onPressSecondIconButton
Handler que será chamado quando o usuário apertar o segundo botão de ícone.
Tipo | Obrigatório |
---|---|
function | Não |
A prop não é obrigatória mas para renderizar o par de botões é necessário preenchê-la juntamente com: firstIconButtonImage
, secondIconButtonImage
e onPressFirstIconButton
.
isActionButtonOutlined
Determina se o botão de ação é da variação outlined
ou não.
Na primeira molécula da imagem, vemos a variação com botão normal e, na segunda, com botão outlined
.
Tipo | Obrigatório |
---|---|
boolean | Não |
isOverflowIconVertical
Determina se a orientação do ícone de overflow é vertical ou horizontal.
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 | SpacingMarginal | 16 |
horizontalPaddingAction
Essa propriedade deve ser modificada caso seja necessário alterar o espaçamento horizontal entre os elementos de ação da molécula 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 |
---|---|---|
horizontalPaddingAction | SpacingMarginal | 16 |
horizontalPaddingIcon
Essa propriedade deve ser modificada caso seja necessário alterar o espaçamento horizontal entre o ícone da esquerda e o texto 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 |
---|---|---|
horizontalPaddingIcon | SpacingBase | 8 |
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 |
buttonBaseProps
Caso seja necessário mudar alguma propriedade base do átomo de botão de ação, é possível através da modificação das buttonBaseProps
.
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 |
---|---|---|
borderColor | ColorPrimary | #A94CC9 |
borderRadius | BorderRadiusButton | 10 |
borderWidth | BorderWidthButton | 1 |
buttonColor | ColorPrimary | #A94CC9 |
buttonHeight | HeightButtonAuxiliary | 32 |
disabledOpacity | OpacityDisabled | 0.3 |
fontFamily | FontFamilyBase | undefined |
fontSize | FontSizeButton | 12 |
fontWeight | FontWeightStrong | Bold (700) |
iconPadding | SpacingBase | 8 |
iconSize | SizeButtonIcon | 24 |
textCase | TextCaseButton | Uppercase |
textColorOutlined | ColorPrimary | #A94CC9 |
textColorRegular | ColorComplementary | #FFFFFF |
Para mais informações, acesse ATLButtonBase.
checkboxToggleBaseProps
Props | Token | Default Value |
---|---|---|
size | SizeIconBase | 24 |
tintColor | ColorPrimary | #A94CC9 |
Para mais informações, acesse ATLButtonToggleBase.
descriptionLabelBaseProps
Caso seja necessário mudar alguma propriedade base do átomo de label correspondente à descrição do item, é possível através da modificação das descriptionLabelBaseProps
.
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 |
multilineLimit | MultilineLimitBody | undefined |
opacity | (fixed) | 1 |
textAlign | TextAlignmentBody | Left |
textCase | TextCaseBody | None |
textColor | ColorDarkNeutral | #212121 |
Para mais informações, acesse ATLLabelBase.
dividerBaseProps
Caso seja necessário mudar alguma propriedade base do átomo de divisor, é possível através da modificação das dividerBaseProps
.
Abaixo temos uma tabela com todas as props do divisor, os tokens aos quais estão relacionadas e o seu valor padrão.
Props | Token | Default Value |
---|---|---|
color | ColorSurfaceLightNeutral | #9E9E9E |
height | HeightDividerRegular | 1 |
Para mais informações, acesse ATLDividerBase.
iconBaseProps
Caso seja necessário mudar alguma propriedade base do átomo de ícone na esquerda da molécula, é possível através da modificação das iconBaseProps
.
Abaixo temos uma tabela com todas as props do ícone, os tokens aos quais estão relacionadas e o seu valor padrão.
Props | Token | Default Value |
---|---|---|
opacity | (fixed) | 1 |
size | SizeIconBase | 24 |
tintColor | ColorMediumNeutral | #464646 |
Para mais informações, acesse ATLIconBase.
iconButtonBaseProps
Caso seja necessário mudar alguma propriedade base dos átomos de botão com ícone, é possível através da modificação das iconButtonBaseProps
.
Abaixo temos uma tabela com todas as props do iconButton, os tokens aos quais estão relacionadas e o seu valor padrão.
Props | Token | Default Value |
---|---|---|
buttonBorderColor | ColorPrimary | #A94CC9 |
buttonBorderWidth | (fixed) | 1 |
buttonColor | ColorNone | transparent |
buttonSize | HeightButtonBase | 32 |
iconColor | ColorPrimary | #A94CC9 |
iconSize | SizeIconAuxiliary | 16 |
Para mais informações, acesse ATLIconButtonBase.
overflowIconButtonBaseProps
Caso seja necessário mudar alguma propriedade base do átomo de ícone correspondente ao overflow, é possível através da modificação das overflowIconButtonBaseProps
.
Abaixo temos uma tabela com todas as props do ícone, os tokens aos quais estão relacionadas e o seu valor padrão.
Props | Token | Default Value |
---|---|---|
buttonBorderColor | ColorNone | transparent |
buttonBorderWidth | (fixed) | 0 |
buttonColor | ColorNone | transparent |
buttonSize | HeightButtonBase | 32 |
iconColor | ColorDarkNeutral | #212121 |
iconSize | SizeIconBase | 24 |
Para mais informações, acesse ATLIconButtonBase.
titleLabelBaseProps
Caso seja necessário mudar alguma propriedade base do átomo de label relativo ao título do item, é possível através da modificação das titleLabelBaseProps
.
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 | FontFamilyBrand | undefined |
fontSize | FontSizeHeading | 16 |
fontWeight | FontWeightStrong | Bold (700) |
lineHeight | LineHeightTitle | 24 |
multilineLimit | MultilineLimitTitle | 1 |
opacity | (fixed) | 1 |
textAlign | TextAlignmentHeading | left |
textCase | TextCaseHighlight | none |
textColor | ColorPrimary | #A94CC9 |
Para mais informações, acesse ATLLabelBase.