---
title: "Dynamic Inline Filter Catalog"
slug: "dynamic-inline-filter-catalog"
description: "Catalogo de referencia da trilha inline do filtro dinamico em praxis-table, com foco em decisao de uso e dependencia de runtime."
doc_type: "reference"
document_kind: "host-guide"
component: "table"
category: "integration"
audience:
  - "frontend"
  - "host"
  - "architect"
  - "designer"
level: "advanced"
status: "active"
owner: "praxis-ui"
tags:
  - "table"
  - "dynamic-filter"
  - "inline"
  - "catalog"
last_updated: "2026-03-07"
toc: true
sidebar: true
deprecated_paths:
  - "dynamic-filter-inline-catalog.md"
deprecated_slugs:
  - "dynamic-filter-inline-catalog"
related_docs:
  - "dynamic-filter-host-integration-guide"
  - "dynamic-filter-editor-settings-guide"
  - "dynamic-filter-payload-contract"
  - "dynamic-filter-range-filters-guide"
  - "dynamic-fields-inline-filter-catalog"
keywords:
  - "praxis-filter"
  - "inline controls"
  - "toolbar filters"
  - "always visible filters"
---

# Dynamic Inline Filter Catalog

## Objetivo

Mapear a trilha inline do `praxis-table` sem confundir o consumidor com fields de formulario comum.

```mermaid
flowchart LR
    Host["Host define filtros visiveis"] --> Table["praxis-table governa a jornada inline"]
    Table --> Toolbar["toolbar sempre visivel"]
    Table --> Payload["payload emitido para filter"]
    Table --> DynamicFields["dynamic-fields fornece controlType inline"]
    DynamicFields --> Components["componentes compactos e metadata-driven"]
```

## Pre-requisitos

- entendimento basico de `praxis-table`, `praxis-filter` e `@praxisui/dynamic-fields`
- familiaridade com filtros always visible vs painel avancado

## Como ler este catalogo

- `table` e a feature owner da jornada de filtro
- `dynamic-fields` e o owner dos componentes inline
- este documento existe para conectar jornada, UX e integracao host

## Quando usar inline

Prefira filtros inline quando:

- o campo precisa ficar visivel na toolbar;
- a interacao cabe em espaco compacto;
- o resumo do valor continua legivel sem abrir painel avancado;
- o backend ja entende o payload emitido por essa trilha.

## Quando evitar inline

Evite inline quando:

- o campo exige leitura longa ou configuracao extensa;
- o resumo do valor vira ruido (`primeiro +N` sem contexto suficiente);
- o fluxo depende de lookup rico, formulario multi-etapas ou ajuda contextual pesada;
- a acessibilidade degrada por excesso de compactacao.

## Familias principais

### Texto

- `inlineInput`

### Selecao

- `inlineSelect`
- `inlineSearchableSelect`
- `inlineAsyncSelect`
- `inlineMultiSelect`
- `inlineAutocomplete`
- `inlineEntityLookup`

`entityLookup` vindo de metadata canonica e projetado como always visible usa `inlineEntityLookup` na toolbar compacta. O host deve preferir `controlType: "entityLookup"` no schema e reservar `inlineEntityLookup` para overrides visuais explicitos.

### Numero e range

- `inlineNumber`
- `inlineCurrency`
- `inlineCurrencyRange`
- `inlineRange`
- `inlineRating`
- `inlineDistanceRadius`
- `inlineScorePriority`

### Data e tempo

- `inlineDate`
- `inlineDateRange`
- `inlineTime`
- `inlineTimeRange`
- `inlineRelativePeriod`

### Outros especializados

- `inlineTreeSelect`
- `inlinePipelineStatus`
- `inlineSentiment`
- `inlineColorLabel`
- `inlineToggle`

## Fonte de verdade do componente

Para detalhe de cada controlType, shape de valor e metadata:

- consulte [Dynamic Fields Inline Filter Catalog](../../praxis-dynamic-fields/docs/dynamic-fields-inline-filter-catalog.md)

## Fonte de verdade da jornada

Para integracao real do filtro:

- consulte [Dynamic Filter Host Integration Guide](./dynamic-filter-host-integration-guide.md)
- consulte [Dynamic Filter Payload Contract](./dynamic-filter-payload-contract.md)
- consulte [Dynamic Filter Range Filters Guide](./dynamic-filter-range-filters-guide.md)

## Regra editorial

- `dynamic-fields` documenta o componente
- `table` documenta quando ele entra na jornada
- o host decide quais campos ficam sempre visiveis e quais degradam para painel avancado