z-uiDesign system
Listas

DataList

O List com toolbar: visões em abas com contagem, busca, filtros por campo com chips removíveis, atualizar, seleção com ações em massa e a consulta salva no navegador. Em modo servidor, só avisa a consulta e mostra o que chegar.

Membros

Busca por nome, e-mail, colunas e valores dos filtros. As visões são abas; cada uma soma seus filtros aos que a pessoa aplicar. A consulta fica salva em persistKey.

  • Marina Coutomarina.couto@exemplo.com.br
    Ativo
  • Rafael Antunesrafael.antunes@exemplo.com.br
    Ativo
  • Lívia Pradolivia.prado@exemplo.com.br
    Convite pendente
  • Otávio Reisotavio.reis@exemplo.com.br
    Ativo
  • Beatriz Lemosbeatriz.lemos@exemplo.com.br
    Ativo
  • Caio Moreiracaio.moreira@exemplo.com.br
    Ativo
  • Helena Duartehelena.duarte@exemplo.com.br
    Bloqueado
  • Igor Fontesigor.fontes@exemplo.com.br
    Convite pendente

8 itens

Uso

<DataList
  aria-label="Membros da conta"
  items={items}
  searchable
  filterFields={[
    { id: "role", label: "Papel", accessor: (item) => item.data.role, options: roles },
  ]}
  views={[{ id: "admins", label: "Administradores", filters: { role: ["admin"] } }]}
  selectable
  bulkActions={[{ label: "Arquivar", onClick: (ids) => archive(ids) }]}
  onRefresh={refetch}
  persistKey="membros"
/>

Props

Aceita também as props do List (layout, groups, renderItem, getMenuItems, enableDnD…).

PropTipoPadrãoDescrição
titlestring"Todos"Nome da primeira aba.
searchable · searchPlaceholderboolean · string—Campo de busca com atraso de 300ms.
filterFieldsDataListFilterField[]—{ id, label, options, accessor }. Várias opções no mesmo campo somam (OU); campos diferentes se cruzam (E).
viewsDataListView[]—{ id, label, filters }. Viram abas com contagem.
selectable · bulkActions · onSelectionChangeboolean · DataListBulkAction[] · (ids) => void—Seleção com marcar todos e barra de ações em massa.
onRefresh · refreshing() => void · boolean—Botão de atualizar com indicador.
actionsReactNode—Ações extras à direita da toolbar.
persistKeystring—Salva visão, busca e filtros no localStorage.
mode · onQueryChange · total"client" | "server" · (query) => void · number"client"No servidor a lista não filtra: avisa a consulta e mostra os itens recebidos.
loadingbooleanfalseEsqueletos no lugar dos cards.