TaxonomyList
TaxonomyList mostra os termos de uma taxonomia: categorias ou tags. Cada termo tem o nome, o endereço (slug) em código e a contagem de posts que o usam. Nas categorias, os termos com pai ficam aninhados sob o pai. Nas tags, a lista é plana.
Quando usar
Seção intitulada “Quando usar”Use para listar categorias ou tags numa tela sua. O componente é só de leitura; os nomes podem virar links com hrefFor.
Regras de exibição:
- A contagem diz «1 post» ou «N posts» (
ui/panel/taxonomy-list.ts:28). - Uma categoria cujo pai não existe na lista vira um termo de topo. Um ciclo de pais é cortado no ponto em que fecha, e cada ciclo abre no primeiro termo (
ui/panel/taxonomy-list.ts:31a:41). - Tags não têm pai: a lista de tags é sempre plana (
ui/panel/taxonomy-list.ts:36). - Sem termos, a lista vira um
EmptyStatecom «Nenhuma categoria ainda.» ou «Nenhuma tag ainda.» (ui/panel/taxonomy-list.ts:23a:26). - Sem
hrefFor, o nome é texto puro. Com ele, o nome é um link para o endereço que a função devolver (ui/panel/taxonomy-list.ts:20).
Onde aparece no painel
Seção intitulada “Onde aparece no painel”Nenhuma tela do painel pronto usa TaxonomyList: o componente é exportado para módulos e extensões (ui/panel/index.ts:101). As listas de categorias e tags do painel são tabelas DataTable, montadas pelas coleções em panel/collections/routes.ts:367. O blog pronto também não o usa: nenhum arquivo de templates/blog importa TaxonomyList.
Variantes e propriedades
Seção intitulada “Variantes e propriedades”TaxonomyList
Pasta: ui/panel
Variantes
| Id | Variante | Tom |
|---|---|---|
taxonomy-list-categorias-light | categorias | light |
taxonomy-list-tags-light | tags | light |
Propriedades
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
kind | "categorias" | "tags" | Sim | — |
items | readonly TaxonomyTerm[] | Sim | — |
hrefFor | (slug: string) => string | Não | Target of a term name; without it the names are plain text. |
Captura
Seção intitulada “Captura”A primeira variante do catálogo, as categorias com hierarquia, em 1280 px:
A mesma variante em 360 px:
ui/panel/taxonomy-list.ts:TaxonomyList,TaxonomyTermeTaxonomyListProps.ui/panel/taxonomy-list.gallery.ts: as variantes do catálogo (categorias e tags).