Fonctions JavaScript
La page d’un bundle expose quelques fonctions globales pour les modèles personnalisés créés avec le Créateur de modèles. Elles sont disponibles une fois le bundle chargé.
Fonctions
Section intitulée « Fonctions »canAddVariant()
Section intitulée « canAddVariant() »window.BundleBuilder.canAddVariant(variantId, sectionIndex)Indique si une variante peut être ajoutée au bundle à cet instant, en tenant compte des limites du bundle et de la quantité disponible de la variante.
| Paramètre | Type | Description |
|---|---|---|
variantId |
string |
L’identifiant Shopify de la variante. |
sectionIndex |
string |
L’index de la section qui contient la variante, à partir de 0. |
Renvoie un boolean. Journalise une erreur et renvoie false s’il n’y a pas de section à sectionIndex.
if (window.BundleBuilder.canAddVariant('44012345678901', '0')) { // afficher le bouton d'ajout}showMoreModal()
Section intitulée « showMoreModal() »window.BundleBuilder.showMoreModal(variantId, sectionIndex, canSelectVariant, canAdd)Ouvre la fenêtre de détails d’une variante, avec toutes les images de son produit et sa description.
| Paramètre | Type | Description |
|---|---|---|
variantId |
number |
La variante à afficher. |
sectionIndex |
number |
L’index de la section qui contient la variante, à partir de 0. |
canSelectVariant |
boolean, facultatif |
false masque les sélecteurs de variante. true par défaut. |
canAdd |
boolean, facultatif |
false masque le bouton d’ajout. true par défaut. |
<img src="{{ product.featured_image | image_url: width: 400 }}" onclick="window.BundleBuilder.showMoreModal({{ variant.id }}, {{ forloop.index0 }})">srcset()
Section intitulée « srcset() »window.BundleBuilder.srcset(url)Une valeur d’attribut srcset pour une image hébergée sur le CDN de Shopify, aux largeurs utilisées par Kitenzo. Renvoie une chaîne vide pour toute autre URL.
img.srcset = window.BundleBuilder.srcset(img.src);Après l’ajout au panier
Section intitulée « Après l’ajout au panier »Par défaut, ajouter un bundle au panier envoie le client vers la page du panier. Définissez window.bbAfterAddToCart pour faire autre chose, par exemple ouvrir le tiroir de panier de votre thème.
<script> window.bbAfterAddToCart = function () { // Ouvrez ici le tiroir de panier de votre thème. // Renvoyez { offerReplace: false } pour ne pas proposer le remplacement. };</script>| Valeur renvoyée | Ce qui se passe |
|---|---|
| Rien | Le client reste sur la page, et Kitenzo propose de remplacer le bundle s’il le modifie. |
{ offerReplace: false } |
Le client reste sur la page, et la page du bundle se comporte comme un simple ajout au panier. |
Pour réagir à un ajout sans changer la page où va le client, écoutez plutôt l’événement kitenzo:addtocart:complete. Il est déclenché sur document après chaque ajout réussi, avant toute redirection.
document.addEventListener('kitenzo:addtocart:complete', () => { // par exemple, mettre à jour le nombre d'articles du panier dans l'en-tête});