Pular para o conteúdo
Instalar aplicação
Português (Portugal)

Seletores do tema

Todos os seletores que a aplicação utiliza para encontrar elementos no seu tema e as duas formas de alterar um deles.

A aplicação encontra o formulário do produto, o preço, o seletor de variantes e as linhas do carrinho através de seletores CSS. Inclui um conjunto ajustado para cada tema suportado e um conjunto predefinido abrangente para os restantes, e é por isso que funciona na maioria dos temas sem ajuda.

Um tema muito personalizado pode, ainda assim, colocar algo onde os seletores predefinidos não chegam. Há duas formas de resolver isso, e a primeira é quase sempre a melhor.

1. Adicione o atributo próprio da aplicação

Quase todos os seletores começam por um atributo data-gpo-… que existe apenas como ponto de ligação para si. Coloque esse atributo no elemento do seu tema e a aplicação encontra-o, sem nenhum seletor para manter e sem nada que uma atualização do tema possa mudar de nome.

<form action="/cart/add" method="post" data-gpo-product-form>
…
<button type="submit" data-gpo-product-atc>Add to cart</button>
</form>

O atributo de cada seletor está nas tabelas abaixo.

2. Substitua o seletor

Utilize esta opção quando não consegue editar o código HTML — uma secção que não controla, ou uma aplicação que renderiza o formulário. Defina-o antes de o script da aplicação ser executado, em theme.liquid, acima de </body>:

<script>
window.GPOConfigs = window.GPOConfigs || {};
window.GPOConfigs.theme = window.GPOConfigs.theme || {};
window.GPOConfigs.theme.product = {
...(window.GPOConfigs.theme.product || {}),
form: ['#my-product-form'],
addToCartButton: '.my-atc-button'
};
</script>

Os seus valores são unidos sobre os da aplicação, por isso só substitui as chaves que indicar.

product

Utilizado nas páginas de produto e nas secções de produto em destaque noutras páginas.

ChaveAtributo de ligaçãoO que a aplicação faz com ele
formdata-gpo-product-formO formulário do produto. É a âncora de tudo o resto — as opções são renderizadas nele e validadas no envio. Aceita uma matriz, testada por ordem
addToCartButtondata-gpo-product-atcO botão de adicionar ao carrinho. Utilizado para colocar o widget acima dele e para bloquear o envio quando a validação falha
paymentButton—O botão de pagamento acelerado. Ocultado nos produtos com opções, porque ignoraria o formulário
quantity—O campo de quantidade. Lido para que as quantidades dos suplementos possam acompanhar a quantidade do produto principal
unitPricedata-gpo-product-unit-priceO preço apresentado. Reescrito à medida que o cliente escolhe opções com preço
compareAtPricedata-gpo-product-compare-at-priceO preço de comparação, atualizado em conjunto com ele
variantSelectordata-gpo-product-variant-selectorO campo oculto que contém o id da variante escolhida. Lido para saber que variante está selecionada
variantActivatordata-gpo-product-variant-activatorOs controlos em que o cliente clica para mudar de variante. Observados para que as condições de variantes possam reagir
variantWrapperdata-gpo-product-variant-wrapperO bloco que contém os seletores de variantes. Utilizado para posicionar o widget em relação a eles
imageContainerdata-gpo-product-image-containerA área da imagem principal. É onde o Personalizador desenha a pré-visualização em tempo real
imagedata-gpo-product-imageA própria imagem principal do produto
imagesdata-gpo-product-imagesAs imagens da galeria, para a configuração Aplicar a da pré-visualização
imageButtondata-gpo-product-image-buttonAs miniaturas ou setas da galeria, observadas para que a pré-visualização acompanhe a imagem apresentada
sticky.atcButtondata-gpo-sticky-atcO botão de adicionar ao carrinho numa barra fixa, para que seja validado como o botão real
sticky.variantActivatordata-gpo-sticky-variant-activatorO controlo de variantes numa barra fixa

collection

Utilizado nas janelas de visualização rápida das páginas de coleção.

ChaveAtributo de ligaçãoO que a aplicação faz com ele
wrapperdata-gpo-collection-wrapperA secção da coleção, a área que a aplicação observa
itemdata-gpo-collection-itemUm cartão de produto dentro dela
productLinkdata-gpo-collection-productLinkA ligação para o produto, lida para saber a que produto corresponde um cartão
quickViewActivatordata-gpo-collection-qvActivatorO controlo que abre a visualização rápida, observado para que a aplicação saiba quando renderizar
quickViewProductFormdata-gpo-collection-qvFormO formulário do produto dentro da visualização rápida, onde ficam as opções

cart

Utilizado na página do carrinho e no carrinho lateral, para editar opções e para manter as linhas de suplementos associadas ao respetivo artigo principal.

ChaveAtributo de ligaçãoO que a aplicação faz com ele
formdata-gpo-cart-formO formulário do carrinho. Aceita uma matriz, testada por ordem
pagever abaixoComo ler um artigo na página do carrinho. Aceita uma matriz de estruturas, testadas por ordem
drawerver abaixoO mesmo para o carrinho lateral

page e drawer contêm, cada um, um lineItem que descreve as partes de uma linha do carrinho:

ParteAtributo de ligação (página do carrinho)O que é
keydata-gpo-cart-item-keyA própria linha, que contém a chave do artigo
imagedata-gpo-cart-item-imageA miniatura da linha
detailsdata-gpo-cart-item-detailsO bloco do título e das propriedades, onde é adicionado Editar opções
quantity.wrapperdata-gpo-cart-item-qty-wrapperO controlo de quantidade, ocultado nas linhas de suplementos
quantity.inputdata-gpo-cart-item-qtyO campo de quantidade
quantity.decrease / increasedata-gpo-cart-item-qty-decrease / -increaseOs botões de menos e de mais
removeButtondata-gpo-cart-item-remove-buttonA ligação de remover, ocultada nas linhas de suplementos

O carrinho lateral utiliza as mesmas partes com data-gpo-drawer-item-… em vez de data-gpo-cart-item-….

Notas

  • As chaves que aceitam uma matriz são testadas por ordem e a primeira correspondência prevalece, por isso pode adicionar as suas à frente das predefinidas em vez de as substituir.
  • Substituir um seletor altera apenas onde a aplicação procura. Não altera o que as opções recolhem nem como lhes é atribuído o preço.
  • Uma substituição aplica-se a todas as páginas de produto da loja. Para um só produto, direcione-a no próprio seletor.

Esta página foi útil?

Comunicar um problema