# Fonctions JavaScript

Fonctions et points d'extension disponibles sur la page du bundle, pour les modèles personnalisés du Créateur de modèles.

La page d'un bundle expose quelques fonctions globales pour les modèles personnalisés créés avec le [Créateur de modèles](https://admin.shopify.com/apps/bundlebuilder/app/settings/editor). Elles sont disponibles une fois le bundle chargé.

:::note
Le Créateur de modèles demande une bonne connaissance de Liquid et de JavaScript. Si vous préférez ne pas l'écrire vous-même, un expert Shopify peut s'en charger.
:::

## Fonctions

### `canAddVariant()`

```js
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`.

```js
if (window.BundleBuilder.canAddVariant('44012345678901', '0')) {
  // afficher le bouton d'ajout
}
```

### `showMoreModal()`

```js
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. |

```html
<img
  src="{{ product.featured_image | image_url: width: 400 }}"
  onclick="window.BundleBuilder.showMoreModal({{ variant.id }}, {{ forloop.index0 }})"
>
```

### `srcset()`

```js
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.

```js
img.srcset = window.BundleBuilder.srcset(img.src);
```

## 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.

:::caution
Rester sur la page du bundle peut dérouter les clients : les changements qu'ils y font ne modifient pas le bundle déjà dans leur panier. Quand la fonction s'exécute, Kitenzo propose de remplacer le bundle du panier si le client le modifie.
:::

```html title="Modèle de la page du bundle"
<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.

```js
document.addEventListener('kitenzo:addtocart:complete', () => {
  // par exemple, mettre à jour le nombre d'articles du panier dans l'en-tête
});
```
