Skip to content

List

O componente List é utilizado para exibir uma listagem de itens com um título e um conteúdo, permitindo personalização através de slots.



Quando usar:

  • Para exibir listas de itens com título e conteúdo de forma padronizada.
  • Quando for necessário permitir a personalização da exibição dos itens através de slots.
  • Para criar listagens interativas em aplicações web e mobile.

Quando não usar:

  • Se a lista precisar ter uma estrutura altamente customizada e dinâmica, onde um componente mais flexível como um table ou grid seria mais adequado.
  • Quando não há necessidade de interação ou personalização dos itens exibidos.

Uso

js
<CdsList
	:items
	:clickable="false"
>
	<template #actions>
		<CdsIconButton icon="edit-outline" />
	</template>
</CdsList>

Preview

Goku o maior de todos os tempos
Todo mundo sabe que ele é o mais forte do mundo (não é atoa o filme 2)
Invejosos dirão que é o Gohan
Mas também todo mundo sabe que ele é um banana depois da saga do Cell
Todo mundo gosta do Vegeta
Claro que sim, não tem como não gostar
Mostrar log

Props

Nome
Tipo
Default
Opções
Descrição
* items (required)array[] -- Lista de itens a serem exibidos no componente. Cada item deve seguir o formato padrão: ```js { title: 'Título do item', content: 'Conteúdo do item' } ``` Esse formato permite o uso da listagem no layout padrão, onde cada item será exibido com um título e um conteúdo. Caso deseje utilizar uma estrutura personalizada, você pode fornecer os itens no formato desejado e personalizar a exibição dentro do slot `item`.
variantstring'blue'green
teal
blue
indigo
violet
pink
red
orange
amber
dark
A variante de cor do título são 10 variantes implementadas: 'green', 'teal', 'blue', 'indigo', 'violet', 'pink', 'red', 'orange','amber' e 'white'.
clickablebooleanfalse -- Indica se o componente deve ser clicável ou não.
paddingstring'7, 3' -- Define o valor do padding do item da lista. Os valores são múltiplos de 4px separados por vírgula para vertical e horizontal (ex: '2, 4').

Eventos

Nome
Descrição
@clickEvento que indica que um item da listagem foi clicado. A prop __clickable__ tem que estar definida como __true__.

Slots

Nome
Descrição
#itemSlot utilizado para renderização de conteúdo de listagem.
#actionsSlot utilizado para renderização de botões de ação para listagem desktop.

Última atualização:

Released under the Apache-2.0 License.