Aller au contenu
Installer l’app
Français

Sélecteurs de thème

Tous les sélecteurs que l’app utilise pour trouver des éléments dans votre thème, et les deux façons d’en modifier un.

L’app trouve votre formulaire produit, votre prix, votre sélecteur de variantes et vos lignes de panier à l’aide de sélecteurs CSS. Elle intègre un jeu de sélecteurs optimisé pour chaque thème pris en charge et un jeu par défaut plus large pour les autres, ce qui explique qu’elle fonctionne sur la plupart des thèmes sans aucune aide.

Un thème très personnalisé peut néanmoins placer un élément hors de portée des sélecteurs par défaut. Il existe deux façons d’y remédier, et la première est presque toujours la meilleure.

1. Ajouter l’attribut propre à l’app

Presque tous les sélecteurs commencent par un attribut data-gpo-… qui existe uniquement pour vous servir de point d’accroche. Ajoutez cet attribut à l’élément dans votre thème et l’app le trouve, sans sélecteur à maintenir et sans rien qu’une mise à jour du thème puisse renommer.

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

L’attribut correspondant à chaque sélecteur figure dans les tableaux ci-dessous.

2. Remplacer le sélecteur

Utilisez cette méthode lorsque vous ne pouvez pas modifier le balisage — une section que vous ne contrôlez pas, ou une app qui affiche le formulaire. Définissez-le avant l’exécution du script de l’app, dans theme.liquid au-dessus 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>

Vos valeurs sont fusionnées par-dessus celles de l’app : vous ne remplacez donc que les clés que vous indiquez.

product

Utilisé sur les pages produit, ainsi que dans les sections de produit en vedette ailleurs sur la boutique.

CléAttribut d’accrocheCe que l’app en fait
formdata-gpo-product-formLe formulaire produit. C’est le point d’ancrage de tout le reste — les options y sont affichées et validées à l’envoi. Accepte un tableau, essayé dans l’ordre
addToCartButtondata-gpo-product-atcLe bouton d’ajout au panier. Sert à placer le widget au-dessus, et à bloquer l’envoi en cas d’échec de la validation
paymentButton—Le bouton de paiement accéléré. Masqué sur les produits comportant des options, car il contournerait le formulaire
quantity—Le champ de quantité. Lu pour que la quantité des suppléments puisse suivre celle du produit principal
unitPricedata-gpo-product-unit-priceLe prix affiché. Réécrit à mesure que le client choisit des options payantes
compareAtPricedata-gpo-product-compare-at-priceLe prix barré, mis à jour en même temps
variantSelectordata-gpo-product-variant-selectorLe champ masqué contenant l’identifiant de la variante choisie. Lu pour savoir quelle variante est sélectionnée
variantActivatordata-gpo-product-variant-activatorLes commandes sur lesquelles le client clique pour changer de variante. Surveillées pour que les conditions sur les variantes puissent réagir
variantWrapperdata-gpo-product-variant-wrapperLe bloc contenant les sélecteurs de variantes. Sert à positionner le widget par rapport à eux
imageContainerdata-gpo-product-image-containerLa zone de l’image principale. C’est là que le personnaliseur dessine son aperçu en direct
imagedata-gpo-product-imageL’image principale du produit elle-même
imagesdata-gpo-product-imagesLes images de la galerie, pour le paramètre Appliquer à de l’aperçu
imageButtondata-gpo-product-image-buttonLes miniatures ou flèches de la galerie, surveillées pour que l’aperçu suive l’image affichée
sticky.atcButtondata-gpo-sticky-atcLe bouton d’ajout au panier d’une barre fixe, pour qu’il valide comme le vrai bouton
sticky.variantActivatordata-gpo-sticky-variant-activatorLa commande de variante d’une barre fixe

collection

Utilisé pour les fenêtres d’aperçu rapide sur les pages de collection.

CléAttribut d’accrocheCe que l’app en fait
wrapperdata-gpo-collection-wrapperLa section de collection, la zone que l’app surveille
itemdata-gpo-collection-itemUne fiche produit à l’intérieur
productLinkdata-gpo-collection-productLinkLe lien vers le produit, lu pour savoir à quel produit correspond une fiche
quickViewActivatordata-gpo-collection-qvActivatorLa commande qui ouvre l’aperçu rapide, surveillée pour que l’app sache quand effectuer le rendu
quickViewProductFormdata-gpo-collection-qvFormLe formulaire produit à l’intérieur de l’aperçu rapide, où s’affichent les options

cart

Utilisé sur la page du panier et dans le panier latéral, pour modifier les options et pour garder les lignes de suppléments liées à leur article parent.

CléAttribut d’accrocheCe que l’app en fait
formdata-gpo-cart-formLe formulaire du panier. Accepte un tableau, essayé dans l’ordre
pagevoir ci-dessousLa façon de lire un article sur la page du panier. Accepte un tableau de structures, essayées dans l’ordre
drawervoir ci-dessousLa même chose pour le panier latéral

page et drawer contiennent chacun un lineItem qui décrit les parties d’une ligne de panier :

PartieAttribut d’accroche (page du panier)Description
keydata-gpo-cart-item-keyLa ligne elle-même, qui porte la clé de l’article
imagedata-gpo-cart-item-imageLa miniature de la ligne
detailsdata-gpo-cart-item-detailsLe bloc du titre et des propriétés, où le bouton Modifier les options est ajouté
quantity.wrapperdata-gpo-cart-item-qty-wrapperLa commande de quantité, masquée sur les lignes de suppléments
quantity.inputdata-gpo-cart-item-qtyLe champ de quantité
quantity.decrease / increasedata-gpo-cart-item-qty-decrease / -increaseLes boutons moins et plus
removeButtondata-gpo-cart-item-remove-buttonLe lien de suppression, masqué sur les lignes de suppléments

Le panier latéral utilise les mêmes parties avec data-gpo-drawer-item-… au lieu de data-gpo-cart-item-….

Remarques

  • Les clés qui acceptent un tableau sont essayées dans l’ordre et la première correspondance l’emporte : vous pouvez donc ajouter les vôtres avant les valeurs par défaut plutôt que de les remplacer.
  • Remplacer un sélecteur modifie uniquement l’endroit où l’app cherche. Cela ne change ni ce que les options recueillent ni leur tarification.
  • Un remplacement s’applique à toutes les pages produit de la boutique. Pour un seul produit, ciblez-le dans le sélecteur lui-même.

Cette page vous a-t-elle aidé ?

Signaler un problème