Saltar para o conteúdo principal
Studio Help · Blocos

Componente Snippet

O bloco Snippet foi pensado para reutilizar estruturas já criadas na área Conteúdo > Snippet, permitindo associar o mesmo conteúdo a uma ou várias páginas sem duplicação manual. A lógica deste componente começa fora da página: primeiro cria-se o snippet, depois seleciona-se esse snippet no bloco.


Informações gerais

O bloco Snippet funciona como uma ponte entre uma página e um conteúdo reutilizável criado previamente no backoffice. Em vez de escrever ou montar a mesma estrutura várias vezes, a equipa cria um snippet autónomo, guarda-o na área de conteúdo e depois apenas o associa onde for necessário.


Este bloco pode incluir:


  • seleção de um Content Snippet já criado em Conteúdo > Snippet
  • reutilização do mesmo snippet em várias páginas ou contextos
  • controlo estrutural através de Skin, Disabled block, Block ID e Extra Class
  • ajustes de Margin e Padding para encaixe visual na página
  • controlo de Animation on/off e Scroll animation type

Utiliza este componente quando existe conteúdo recorrente, blocos editoriais replicados, estruturas de campanha reaproveitáveis, combinações de vários blocos que devem ser mantidas num só ponto, ou quando faz sentido centralizar a manutenção para reduzir erros e trabalho duplicado.


Exemplos visuais do bloco

3 momentos-chave do fluxo de snippet

O bloco Snippet tem uma particularidade importante: o conteúdo não nasce dentro da página. Os três exemplos abaixo são simulações visuais da lógica do componente, mostrando a criação do snippet, a sua associação e o efeito de reutilização em vários contextos.

Conteúdo > Snippet
Ativo
Artistas em destaque

Bloco curatorial preparado para múltiplas páginas de coleção.

ENMuseu
Rascunho
Convite evento

Estrutura modular ainda em validação antes da publicação.

DraftEvento

Exemplo 01 - Biblioteca de snippets reutilizáveis

Simulação da área de snippets já organizados por objetivo. A lógica começa sempre aqui: o conteúdo é construído, nomeado e guardado antes de ser chamado em qualquer página.

Bloco Snippet
Newsletter verão
Associado
Pré-visualização do conteúdo reutilizado
Campanha com estrutura partilhada

O editor seleciona um snippet existente e a página passa a renderizar esse conteúdo sem o recriar manualmente.

Galeria Hero + 3 imagens
Texto editorial Introdução e contexto
CTA Botão para próxima ação

Exemplo 02 - Seleção do snippet dentro da página

Simulação do momento em que o snippet é associado ao bloco. O editor escolhe um registo no campo Content Snippet e a estrutura reutilizada fica imediatamente disponível no layout.

Reutilização transversal
Campanha Artistas 2026

Uma alteração no snippet original propaga-se pelas páginas onde está associado.

Home Página inicial
Landing Campanha
Coleção Detalhe de artista

Exemplo 03 - O mesmo snippet em várias páginas

Simulação do benefício principal do componente: um único snippet pode servir vários contextos. A manutenção acontece numa só origem, enquanto cada página conserva apenas os ajustes estruturais do bloco.

Quando usar / Quando evitar

Reutilização com controlo central

Quando usar

  • Quando o mesmo conjunto de blocos precisa de aparecer em várias páginas
  • Quando queres centralizar atualizações num único ponto de manutenção
  • Para áreas recorrentes como campanhas, newsletters, convites, módulos editoriais ou secções institucionais
  • Quando faz sentido separar a criação do conteúdo da sua associação às páginas

Quando evitar

  • Quando o conteúdo é único de uma só página e não será reutilizado
  • Quando cada instância precisa de variações locais significativas
  • Quando a equipa precisa de editar diretamente o conteúdo dentro da própria página
  • Quando a reutilização pode criar dependências difíceis de gerir sem nomenclatura clara
!
Neste caso: editar o snippet original altera todas as páginas onde ele está associado. Isso é uma vantagem quando a intenção é centralizar, mas exige atenção para evitar alterações inesperadas em contextos já publicados.

Como usar na prática

Fluxo recomendado de trabalho

Criar o snippet

  • Entrar em Conteúdo > Snippet
  • Criar um novo registo com nome, idioma e descrição
  • Confirmar o estado ativo antes de o reutilizar

Montar a estrutura

  • Usar Adicionar Bloco dentro da estrutura do snippet
  • Compor o conteúdo exatamente como deve ser reutilizado
  • Guardar o snippet já com a sua lógica final

Associar na página

  • Inserir o bloco Snippet na página
  • Selecionar o registo certo no campo Content Snippet
  • Evitar selecionar snippets provisórios ou mal identificados

Validar e manter

  • Testar o resultado final em todas as páginas onde o snippet aparece
  • Atualizar o snippet original sempre que a mudança deve ser transversal
  • Usar nomes consistentes para facilitar futuras associações
Boa prática: usa o snippet como unidade reutilizável e não como atalho para esconder conteúdo desorganizado. Quanto mais clara for a lógica de criação e nomenclatura, mais fácil será manter o sistema.

Criar o snippet base

Antes da associação à página

Criação de um novo snippet com nome, idioma, descrição e estrutura da página

A criação do snippet acontece fora da página. É aqui que o conteúdo é nomeado, descrito, ativado e montado através da sua própria estrutura de blocos.

Dados base

  • Nome identifica o snippet no seletor do bloco
  • Descrição ajuda a contextualizar o objetivo do conteúdo
  • Convém usar convenções claras e reconhecíveis pela equipa

Idioma e estado

  • Linguagens define a variante em que o snippet é criado
  • Ativo controla se o snippet pode ser utilizado
  • Em sites multilingue, o idioma deve estar coerente com a página de destino

Estrutura da página

  • Adicionar Bloco permite compor o snippet internamente
  • Podes criar snippets simples ou estruturas mais completas
  • Guardar o snippet é obrigatório antes de o associar noutra página

Configuração do conteúdo do bloco

Selecionar o snippet certo

Campo Content Snippet para associar um snippet já criado à página

Na página, o bloco Snippet não serve para escrever conteúdo novo. O seu papel é selecionar um snippet já existente e renderizar essa estrutura no contexto atual.

Content Snippet

  • O campo principal é um seletor de snippets disponíveis
  • Escolhes aqui o registo criado anteriormente em Conteúdo > Snippet
  • Um bom nome facilita muito a associação correta

Lógica de associação

  • O bloco apenas referencia o conteúdo, não o duplica
  • Se o snippet mudar, todas as páginas associadas refletem essa alteração
  • Esta lógica torna o bloco especialmente útil para manutenção centralizada

Configurações avançadas do bloco

Estrutura, espaçamentos e animação

Configurações avançadas do bloco Snippet

Estas opções controlam a presença do bloco Snippet na página, sem alterar a estrutura interna do snippet já criado.

Estrutura

  • Skin define a variante visual do bloco
  • Disabled block desativa a renderização sem apagar a configuração
  • Block ID e Extra Class ajudam em âncoras e ajustes técnicos

Espaçamentos

  • Margin controla o espaço exterior do bloco
  • Padding controla o espaço interior do bloco
  • Estes campos servem para integrar o snippet no ritmo da página

Animação

  • Animation on/off ativa ou desativa a entrada animada
  • Scroll animation type escolhe o efeito aplicado
  • A animação deve reforçar a leitura, não competir com o conteúdo do snippet

Boas práticas de manutenção

Clareza, reutilização e controlo

Organização

  • Dá ao snippet um nome específico e fácil de reconhecer
  • Usa descrições que expliquem onde e para que o snippet existe
  • Evita nomes genéricos como “Teste” ou “Bloco Novo” em snippets de produção
  • Se o site for multilingue, mantém a lógica por idioma bem separada

Governação

  • Confirma quem é responsável por atualizar snippets reutilizados em várias páginas
  • Valida o impacto antes de alterar um snippet já publicado
  • Testa sempre as páginas associadas quando houver mudanças estruturais
  • Evita usar snippets quando a necessidade é apenas local e pontual
!
Atenção: o bloco Snippet é excelente para reutilização, mas isso significa que uma alteração aparentemente pequena pode ter um efeito transversal. Sempre que possível, documenta internamente onde cada snippet está a ser usado.

Guias relacionados

Blocos que costumam beneficiar de reutilização