Skip to main content

Collection Grid

Quero um grid de coleções escolhidas no Editor. Como implementar?
Referência: seu tema (adaptado do cookbook) Índice: Cookbooks

Contratos utilizados


Objetivo

  1. Merchant seleciona várias coleções (collection_list).
  2. O schema persiste array de ids em settings.collections.
  3. defineSectionData resolve cada id → Collection.
  4. Grid responsivo com imagem, título e URL pública.

Fluxo de dados

Não documente settings.collections como Collection[] — a resolução é explícita no defineSectionData.

Schema + data

Shape público Collection: id, handle, url, title, image — ver collection.mdx.

Render

Grid CSS: grid-template-columns: repeat(auto-fill, minmax(220px, 1fr)).

Comportamento no Editor

  • collection_list: o modal grava collection.id em cada item.
  • Ordem no array = ordem no grid.

Cuidados

  • Id que não existe mais: get pode falhar. Filtre null no loader.
  • Empty state quando nenhuma coleção selecionada.
  • Múltiplas instâncias da section na página: cada uma com seu próprio settings.collections.

Checklist

  • Field collection_list com max
  • defineSectionData com collections.get por id
  • UI usa title, url, image.url apenas
  • Grid responsivo
  • corvex validate passa
Código completo: seu tema (adaptado do cookbook).