Skip to main content
Le bloc Cart items est la liste des lignes d’articles du panier, affichant chaque produit ajouté par l’acheteur avec son image, son titre, sa variante, son prix, son sélecteur de quantité et son contrôle de suppression. C’est un bloc obligatoire, et c’est le conteneur qui héberge les sous-blocs du panier (la ligne Product, Subscription upgrade et Custom code), fournissant la structure à laquelle les sous-blocs par ligne s’attachent.
Bloc Cart items affichant les lignes d'articles avec image produit, titre, variante, prix, sélecteur de quantité et contrôle de suppression

La ligne Product

À l’intérieur de Cart items se trouve le sous-bloc Product : la véritable ligne d’article. Il est verrouillé et ajouté automatiquement, de sorte que chaque bloc Cart items contient toujours exactement une ligne Product que vous ne pouvez pas supprimer ; vous repositionnez les autres sous-blocs autour d’elle. Ses paramètres contrôlent la façon dont le prix de chaque ligne est affiché : La ligne elle-même affiche l’image du produit (avec un lien vers la page produit lorsqu’elle est disponible), le titre, la variante, le prix et tout prix comparé barré, un sélecteur de quantité et un bouton de suppression. Les lignes de bundle affichent une liste dépliable de leurs composants.

Style du texte

La ligne Product comprend une section Text dans ses paramètres Design. Utilisez-la pour contrôler la typographie de chaque élément de texte dans chaque ligne d’article. Sélectionnez un élément de texte dans le sélecteur pour ajuster ses paramètres : Les éléments de texte que vous pouvez styliser sont regroupés par catégorie : Product
  • Product title — le nom du produit sur chaque ligne. Prend également en charge une famille de police personnalisée.
  • Variant — le libellé de la variante (par exemple, Size: Medium).
  • Subscription plan — le libellé de plan en lecture seule affiché sur les lignes d’abonnement.
Pricing
  • Price — le prix actuel de la ligne.
  • Compare-at price — le prix d’origine barré.
  • Savings — le libellé des économies (par exemple, Save $5.00). Uniquement la taille et l’interligne — le gras et la couleur sont définis dans l’éditeur de texte enrichi ci-dessus.
Bundle
  • Bundle toggle — l’en-tête dépliable qui déploie la liste des composants d’un bundle.
  • Bundle item title — le titre de chaque composant à l’intérieur d’un bundle.
  • Bundle item variant — le libellé de variante pour chaque composant de bundle.
Laisser un champ vide conserve la valeur par défaut de l’élément.
Cliquer directement sur un élément de texte dans l’aperçu du panier le met en surbrillance et ouvre automatiquement ses contrôles dans le panneau.

Design des étiquettes de remise

La ligne Product comprend une section Discount tags dans ses paramètres Design. Utilisez-la pour styliser les pastilles d’étiquettes de remise qui apparaissent sur chaque ligne d’article : Ces paramètres s’appliquent uniquement aux étiquettes de remise des lignes d’articles dans le bloc Cart items. Les étiquettes de codes de réduction du bloc Summary sont stylisées séparément.

Les sous-blocs et leur positionnement

Cart items est le seul bloc qui héberge des sous-blocs. Les sous-blocs s’affichent une fois par ligne, à l’intérieur de chaque ligne de produit, positionnés par rapport à la ligne Product épinglée :
  • Les sous-blocs ordonnés avant la ligne Product apparaissent au-dessus du contenu produit dans chaque ligne.
  • Les sous-blocs ordonnés après la ligne Product apparaissent en dessous du contenu produit dans chaque ligne.
Ainsi, un Subscription upgrade placé après la ligne Product s’affiche sous chaque ligne éligible, et non une seule fois en bas de toute la liste.

Comportement

  • Lorsque le panier ne contient aucun article, le tiroir bascule vers l’état vide et ce bloc n’est pas affiché.
  • Une seule modification du panier s’exécute à la fois. Pendant qu’une mise à jour de quantité ou une suppression est en cours, les contrôles de la ligne sont désactivés pour garder le panier cohérent, puis réactivés une fois la modification effectuée.
  • Faire passer la quantité d’une ligne sous 1 la supprime. Une quantité rejetée par la boutique (par exemple, au-delà du stock disponible) se resynchronise sur la dernière valeur valide.
  • Les bundles changent d’un bloc. Ajuster la quantité sur la ligne d’ancrage d’un bundle met à l’échelle tout le bundle en une seule opération — si un composant est inclus à raison de 3 par ancre, faire passer l’ancre de 1 à 2 fait passer ce composant à 6. Supprimer l’ancre supprime tous les membres du bundle en une fois.
  • Certains bundles ne peuvent pas être requantifiés. Si l’un des composants d’un bundle est inclus à un taux fractionnaire (1,5 par ancre, par exemple), le sélecteur de quantité de ce bundle est verrouillé : les boutons +/− et le champ de quantité sont tous deux désactivés, et les quantités saisies ne sont pas acceptées. Le bundle peut toujours être supprimé.
  • Les lignes d’abonnement affichent leur plan. Lorsqu’une ligne a un plan de vente et que le sous-bloc Subscription upgrade est désactivé ou non ajouté, la ligne Product affiche un libellé de plan en lecture seule sous la variante — par exemple, Delivers every month (save 30%). Lorsque ce sous-bloc est activé, il présente le plan dans son propre sélecteur, de sorte que le libellé en lecture seule est supprimé plutôt que dupliqué.

Placement et limites

  • Région : corps.
  • Maximum : 1 par état de panier.
  • État : panier rempli uniquement.
  • Verrouillé et ajouté par défaut. Cart items ne peut être ni supprimé ni masqué, seulement repositionné.

Modèle personnalisé

Prend en charge un modèle personnalisé depuis son onglet Code, qui remplace le rendu intégré de ce bloc par votre JSX. Voici les props qu’il reçoit. Le conteneur Cart items n’a pas de modèle personnalisé. La ligne Product à l’intérieur en a un, et c’est la surface la plus riche du panier : votre modèle s’affiche une fois par ligne.

Contenu de la ligne

price et compareAtPrice sont des chaînes formatées ; tout sur line est en centimes. Ne faites pas de calculs sur price. Calculez à partir de line.finalLinePrice et compagnie, puis passez le résultat dans formatMoney.

Quantité et suppression

Afficher un bundle

Sur la ligne d’ancrage d’un bundle, bundle.children contient son contenu. Les composants n’apparaissent jamais comme des lignes à part entière, donc si vous ne les affichez pas, l’acheteur ne verra pas ce que contient le bundle :
La key d’un composant est null pour un composant de bundle natif Shopify, alors utilisez l’index en repli comme ci-dessus.

Design

Stylisez ce bloc avec sa section Design dans le panneau de paramètres. Il s’agit de remplacements par bloc qui se superposent à votre design global et y reviennent lorsqu’ils sont vides. Que sont les paramètres de design ? En savoir plus ici : Paramètres de design.