window.aftersell.cart.actions.
Les actions s’exécutent après que le panier est prêt, à l’intérieur de
ready() ou d’un gestionnaire d’événement.Avant le chargement du panier, les actions sont des stubs. Chacune émet un avertissement dans la console nommant l’action, par exemple
cart.actions.addItem() called before the cart loaded, et ne fait rien. Les actions asynchrones résolvent quand même une Promise, donc une chaîne .then() s’exécute normalement au lieu de lever une exception ; getCart() renvoie null et formatMoney() renvoie une chaîne vide.Rien ne casse si vous en appelez une trop tôt, mais rien ne se passe non plus. Surveillez cet avertissement dans la console lorsqu’une action semble ne rien faire.Ouvrent ou ferment le tiroir du panier. Les deux sont synchrones et ne prennent aucun argument.
Renvoie l’objet cart actuel, ou
null avant son chargement. Le résultat est une copie, donc le muter ne changera pas le vrai panier.
getCart() y est redondant.
Formate un montant en unités mineures selon le format monétaire de votre boutique. Chaque prix dans le SDK est en centimes, c’est donc ainsi que vous en transformez un en quelque chose d’affichable.
configure({ money_format }).
Les actions sur les articles identifient une ligne par sa
key Shopify, pas par l’ID de variante, car un panier peut contenir la même variante sur plusieurs lignes avec des propriétés différentes. Lisez-la depuis getCart().items[n].key.quantity vaut 1 par défaut. Se résout une fois le panier stabilisé.
0 supprime la ligne.
cart_updated parce que la vérification > 1 est fausse au second passage. Consultez les deux règles.
Change la variante d’une ligne tout en conservant sa quantité et ses propriétés. Utile pour un sélecteur de taille ou de parfum à l’intérieur du panier.
key et atterrit à la fin du panier. Relisez getCart() ensuite plutôt que de réutiliser la clé que vous avez passée.
Recharge le panier depuis Shopify. Utilisez-la après qu’un élément extérieur au SDK a modifié le panier sans que le tiroir ne s’en aperçoive.
- Les actions asynchrones se résolvent lorsque le changement est stabilisé. En attendre une vous permet de séquencer du travail après que le panier a réellement été mis à jour.
getCart()renvoie une copie. La muter ne fait rien au vrai panier.- Il n’y a pas d’action pour les codes de réduction. Les codes appliqués sont lisibles sur le panier (
discountCodes,totalDiscount) et par ligne (discountAllocations) ; les acheteurs les appliquent via le bloc Discount code. - Il n’y a pas d’action pour les attributs de panier ou les notes. Les attributs sont lisibles sur l’objet cart ; les acheteurs écrivent des notes via le bloc Notes.
- Pour masquer une ligne plutôt que de la supprimer, utilisez
registerLineTransform. La suppression modifie le total de l’acheteur ; le masquage non.
- Objet cart : ce que
getCart()renvoie. - Événements : quand exécuter ces actions.
- Hooks : modifiez le rendu d’une ligne au lieu de modifier le panier.
- Cas d’usage : des solutions complètes aux demandes courantes.