Skip to main content
Het Cart items-blok is de lijst met regelitems in de cart, die elk product dat de shopper heeft toegevoegd rendert met afbeelding, titel, variant, prijs, aantal-stepper en verwijderknop. Het is een verplicht blok, en het is de container die de sub-blokken van de cart host (de Product-rij, Subscription upgrade en Custom code), en biedt de structuur waaraan sub-blokken per regel worden vastgemaakt.
Cart items-blok met regelitems met productafbeelding, titel, variant, prijs, aantal-stepper en verwijderknop

De Product-rij

Binnen Cart items zit het Product-sub-blok: de daadwerkelijke regelitemrij. Het is vergrendeld en wordt automatisch toegevoegd, dus elk Cart items-blok heeft altijd precies één Product-rij die je niet kunt verwijderen; je herschikt andere sub-blokken eromheen. De instellingen ervan bepalen hoe de prijzen van elke regel worden weergegeven: De rij zelf rendert de productafbeelding (met link naar de productpagina indien beschikbaar), titel, variant, prijs en een eventuele doorgestreepte compare-at-prijs, een aantal-stepper en een verwijderknop. Bundelregels tonen een uitklaplijst met hun onderdelen.

Tekststijl

De Product-rij bevat een sectie Text in de Design-instellingen. Gebruik deze om de typografie van afzonderlijke tekstelementen in elk regelitem te bepalen. Selecteer een tekstelement uit de kiezer om de instellingen ervan aan te passen: De tekstelementen die je kunt stylen zijn gegroepeerd per categorie: Product
  • Product title — de productnaam op elke regel. Ondersteunt ook een aangepaste font family.
  • Variant — het variantlabel (bijvoorbeeld Size: Medium).
  • Subscription plan — het alleen-lezen planlabel dat op abonnementsregels wordt getoond.
Pricing
  • Price — de huidige prijs van de regel.
  • Compare-at price — de doorgestreepte oorspronkelijke prijs.
  • Savings — het besparingslabel (bijvoorbeeld Save $5.00). Alleen size en line height — bold en color worden ingesteld in de Rich Text Editor hierboven.
Bundle
  • Bundle toggle — de uitklapkop die de onderdelenlijst van een bundel uitklapt.
  • Bundle item title — de titel van elk onderdeel binnen een bundel.
  • Bundle item variant — het variantlabel voor elk bundelonderdeel.
Een veld leeg laten behoudt de standaardwaarde van het element.
Direct op een tekstelement in de cartpreview klikken markeert het en opent de bedieningen automatisch in het paneel.

Design van kortingstags

De Product-rij bevat een sectie Discount tags in de Design-instellingen. Gebruik deze om de kortingstag-pills te stylen die op elk regelitem verschijnen: Deze instellingen gelden alleen voor kortingstags op regelitems in het Cart items-blok. Kortingscodetags in het Summary-blok worden apart gestyled.

Sub-blokken en hoe ze zich positioneren

Cart items is het enige blok dat sub-blokken host. Sub-blokken renderen één keer per regel, binnen elke productrij, gepositioneerd ten opzichte van de vastgezette Product-rij:
  • Sub-blokken die vóór de Product-rij zijn geordend, verschijnen boven de productcontent in elke regel.
  • Sub-blokken die na de Product-rij zijn geordend, verschijnen onder de productcontent in elke regel.
Een Subscription upgrade die na de Product-rij is geplaatst, wordt dus onder elke in aanmerking komende regel getoond, niet één keer onderaan de hele lijst.

Gedrag

  • Wanneer de cart geen items bevat, schakelt de drawer over naar de lege status en wordt dit blok niet getoond.
  • Er loopt één cartwijziging tegelijk. Terwijl een aantal-update of verwijdering bezig is, zijn de bedieningen van de rij uitgeschakeld om de cart consistent te houden, en worden ze weer ingeschakeld zodra de wijziging is afgerond.
  • Het aantal van een regel onder 1 verlagen verwijdert de regel. Een aantal dat de winkel weigert (bijvoorbeeld boven de beschikbare voorraad) wordt teruggezet naar de laatst geldige waarde.
  • Bundels wijzigen als één geheel. Het aanpassen van het aantal op de ankerregel van een bundel schaalt de hele bundel in één bewerking — als een kind is opgenomen met 3 per anker, gaat dat kind van 3 naar 6 wanneer het anker van 1 naar 2 gaat. Het verwijderen van het anker verwijdert alle onderdelen van de bundel tegelijk.
  • Sommige bundels kunnen niet in aantal worden aangepast. Als een van de kinderen van een bundel met een fractionele verhouding is opgenomen (bijvoorbeeld 1,5 per anker), is de aantal-stepper van die bundel vergrendeld: de +/−-knoppen en het aantalveld zijn beide uitgeschakeld, en getypte aantallen worden niet geaccepteerd. De bundel kan nog wel worden verwijderd.
  • Abonnementsregels tonen hun plan. Wanneer een regel een selling plan heeft en het Subscription upgrade-sub-blok is uitgeschakeld of niet toegevoegd, toont de Product-rij een alleen-lezen planlabel onder de variant — bijvoorbeeld Delivers every month (save 30%). Wanneer dat sub-blok is ingeschakeld, presenteert het het plan in zijn eigen kiezer, zodat het alleen-lezen label wordt onderdrukt in plaats van gedupliceerd.

Plaatsing en limieten

  • Regio: midden.
  • Maximum: 1 per cart-status.
  • Status: alleen gevulde cart.
  • Vergrendeld en standaard toegevoegd. Cart items kan niet worden verwijderd of verborgen, alleen verplaatst.

Aangepaste template

Ondersteunt een aangepaste template via het tabblad Code, die de ingebouwde markup van dit blok vervangt door jouw JSX. Dit zijn de props die het ontvangt. De Cart items-container heeft geen aangepaste template. De Product-rij erbinnen wel, en dat is het rijkste vlak in de cart: jouw template rendert één keer per regel.

Regelcontent

price en compareAtPrice zijn geformatteerde strings; alles op line is in centen. Reken niet met price. Bereken vanuit line.finalLinePrice en vergelijkbare velden, en haal het resultaat door formatMoney.

Aantal en verwijderen

Een bundel renderen

Op de ankerregel van een bundel bevat bundle.children de inhoud ervan. Kinderen verschijnen nooit als eigen rijen, dus als je ze niet rendert, ziet de shopper niet wat er in de bundel zit:
De key van een kind is null bij een Shopify native-bundelonderdeel, dus val terug op de index zoals hierboven.

Design

Style dit blok met de sectie Design in het instellingenpaneel. Dit zijn overrides per blok die bovenop je globale design komen en erop terugvallen wanneer ze leeg zijn. Wat zijn designinstellingen? Lees er hier meer over: Designinstellingen.