Skip to main content

Snippets

Snippets são pedaços reutilizáveis de código Liquid que ajudam a manter consistência e reduzir duplicação ao longo do seu tema.

Visão Geral

  • Não são visíveis no editor de tema
  • Ideais para código que é repetido ao longo do seu tema
  • Podem ser pensados como “componentes” ou “partials”
  • Podem ser criados, deletados ou renomeados conforme necessário

Criando Snippets

Snippets são armazenados no diretório snippets/ com extensão .liquid. Por exemplo:

Usando Snippets

Para incluir um snippet em uma seção ou outro snippet, use a tag render:

Passando Variáveis para Snippets

Você pode passar variáveis para snippets ao renderizá-los:
Dentro do snippet, essas variáveis estão disponíveis como variáveis locais:

Valores Padrão

Você pode fornecer valores padrão para variáveis de snippet usando o filtro default:

Casos de Uso Comuns para Snippets

Componentes de UI

  • Botões
  • Cards
  • Elementos de navegação
  • Barras de progresso

Padrões de Conteúdo

  • Listagens de cursos
  • Layouts de módulos
  • Previews de aulas
  • Exibições de informações do usuário

Exemplo: Snippet de Imagem

Um snippet para renderizar imagens consistentemente com carregamento lazy opcional:
Uso:

Melhores Práticas

  • Crie snippets para componentes usados em múltiplos lugares
  • Passe variáveis para snippets para flexibilidade
  • Use convenções de nomenclatura consistentes
  • Mantenha snippets focados em uma única responsabilidade
  • Documente as variáveis esperadas para cada snippet
  • Use valores padrão para parâmetros opcionais