Built on WIX Headless

Docs Recursos Busca e filtros

Busca e filtros

Deixe os visitantes buscar e filtrar conteúdo CMS em Table, Repeater, Calendar, Media Gallery e Slideshow no Wix Harmony com o CMS for Harmony.

Table, Repeater, Calendar, Chart, Media Gallery e Slideshow oferecem busca e filtros voltados ao visitante para que coleções grandes continuem usáveis no site ao vivo.

Recursos de filtro

  • Condições de correspondência por filtro: equals, not equals, contains, starts/ends with, greater/less than ou between
  • Vários filtros no mesmo campo
  • Controles de intervalo para data e número
  • Show filter vs Choose value: mostrar um controle ao visitante, ou sempre aplicar um valor fixo sem UI
  • Campos Reference e Multi-reference: equals / not equals, ou includes / includes all, com opções da coleção relacionada — escolha um Display field para os rótulos das opções
  • Campos Color: filtrar com Color swatches (e outros controles de escolha)
  • Chrome de busca e filtro estilizado com fontes do site

Dependent filters

Ative Dependent filter em um filtro de escolha para limitar suas opções aos valores que ainda existem depois de aplicar a busca e os filtros listados acima deste. Coloque os filtros pai mais acima na lista para que os filhos filtrem em cascata corretamente.

This Page slug {#this-page-slug}

Em um filtro de campo Reference ou Multi-reference no modo Choose value, escolha This Page slug em vez de um item relacionado fixo. O widget resolve o item da página dinâmica atual a partir da URL (ou o mesmo item de amostra que o Dynamic Page mostra no Preview / Editor) e aplica esse item como valor do filtro.

Use para que uma lista, galeria, gráfico ou calendário relacionados em uma página de item mostrem só linhas ligadas ao item aberto — sem fixar um id de referência.

ComportamentoDetalhe
Site ao vivoLê o slug do item na URL do Page path / campo de correspondência configurado
Preview / EditorUsa o primeiro item de amostra quando o canvas não tem URL de item
Slug não resolvidoAplica uma correspondência vazia para a exibição não mostrar todos os itens

Funciona em Table, Repeater, Slideshow, Media Gallery, Calendar, Chart, Dynamic Page (filtros de campo) e Harmony Repeater. As Filter options do Form em Reference / Multi-reference podem usar o mesmo This Page slug — veja Form.

Intervalos de data relativos {#relative-date-ranges}

Em campos DATE ou DATETIME no modo Choose value, defina Value type como Relative range em vez de datas fixas. O widget aplica o intervalo no site ao vivo (sem controle para o visitante).

IntervaloO que inclui
TodayO dia calendário atual
Next 7 daysHoje mais os 6 dias seguintes (7 dias no total)
Next 30 daysHoje mais os 29 dias seguintes
This calendar weekSete dias a partir do dia escolhido em Week starts on (domingo a sábado)
This calendar monthDo primeiro ao último dia do mês calendário atual

Dica: Para semanas de eventos de sexta a quinta, use Between, Relative range → This calendar week e Week starts on → Friday.

Limites de data (fuso horário) {#relative-date-timezone}

Com Relative range, Date boundaries define o fuso de «hoje» e meia-noite:

OpçãoComportamento
Visitor’s device (padrão)Calendário do navegador do visitante.
Site timezoneFuso em Settings → Website settings → Time zone no Wix (ex.: America/Denver). Mesmo corte para todos, com horário de verão.
Fixed timezoneZona IANA no menu (ex.: GMT-6 — America/Denver).

O painel mostra pré-visualização ao vivo após definir intervalo, Week starts on e Date boundaries.

Eventos regionais: Prefira Site timezone (ou Fixed timezone da sua cidade) em filtros semanais e «só futuros».

Condições: Between + This calendar week para a semana inteira; On or after + Today inclui hoje; After + Today exclui hoje.

Funciona em Table, Repeater, Calendar, Chart, Media Gallery e Slideshow com Wix CMS e bancos de dados externos. Filtros Choose value relativos não entram na URL quando Add as URL query params está ativo.

Add as URL query params

Ative Add as URL query params para manter busca e filtros na URL da página, para que os visitantes possam compartilhar ou salvar visualizações filtradas. Funciona com Wix CMS e bancos de dados externos (Google Sheets, Airtable, Notion).

Filters display

Defina Filters display como Top (acima do conteúdo) ou Side (barra lateral esquerda; volta para o topo em layouts estreitos).

Observações

  • No Calendar, a busca olha os campos Title e Details.
  • No Slideshow, a busca usa os campos Title / Text / Button label quando mapeados.
  • Você pode filtrar por campos que não estão mostrados na exibição.
  • Busca, ordenação, Dependent filters e Add as URL query params funcionam com Wix CMS e conexões a bancos de dados externos.
  • A v6.0 mudou como busca e filtros de Table e Repeater são armazenados. Após uma atualização importante, confira novamente as configurações de filtro nos widgets existentes.
  • Dynamic Page compartilha opções de formatação relacionadas (como expressões de valor), mas não inclui busca/filtros para visitantes.

Configure os filtros no painel de cada widget depois de conectar uma coleção — procure Search & filters, incluindo Show search bar, Show filters button, Filters display, Add as URL query params e Dependent filter por filtro.

FAQ

Which widgets support search and filters?

Table, Repeater, Calendar, Chart, Media Gallery, and Slideshow (plus Harmony Repeater).

What is This Page slug?

A Choose value option on Reference / Multi-reference filters that tracks the current dynamic-page item — see This Page slug.

Do filters work with Google Sheets?

Yes on supported display widgets connected to an external database.