Skip to main content
Il blocco Cart items è l’elenco degli articoli nel carrello, che renderizza ogni prodotto aggiunto dall’acquirente con immagine, titolo, variante, prezzo, selettore di quantità e controllo di rimozione. È un blocco obbligatorio ed è il contenitore che ospita i sotto-blocchi del carrello (la riga Product, Subscription upgrade e Custom code), fornendo la struttura a cui si agganciano i sotto-blocchi per riga.
Blocco Cart items che mostra gli articoli con immagine del prodotto, titolo, variante, prezzo, selettore di quantità e controllo di rimozione

La riga Product

Dentro Cart items si trova il sotto-blocco Product: la vera e propria riga dell’articolo. È bloccato e viene aggiunto automaticamente, quindi ogni blocco Cart items ha sempre esattamente una riga Product che non puoi rimuovere; gli altri sotto-blocchi si riposizionano intorno a essa. Le sue impostazioni controllano come viene visualizzato il prezzo di ogni riga: La riga stessa renderizza l’immagine del prodotto (con link alla pagina del prodotto quando disponibile), titolo, variante, prezzo ed eventuale prezzo compare-at barrato, un selettore di quantità e un pulsante di rimozione. Le righe bundle mostrano un elenco a scomparsa dei loro componenti.

Stile del testo

La riga Product include una sezione Text nelle sue impostazioni di Design. Usala per controllare la tipografia dei singoli elementi di testo in ogni articolo. Seleziona un elemento di testo dal selettore per regolarne le impostazioni: Gli elementi di testo che puoi stilizzare sono raggruppati per categoria: Product
  • Product title — il nome del prodotto su ogni riga. Supporta anche una famiglia di font personalizzata.
  • Variant — l’etichetta della variante (per esempio, Size: Medium).
  • Subscription plan — l’etichetta del piano in sola lettura mostrata sulle righe in abbonamento.
Pricing
  • Price — il prezzo attuale della riga.
  • Compare-at price — il prezzo originale barrato.
  • Savings — l’etichetta dei risparmi (per esempio, Save $5.00). Solo dimensione e interlinea — grassetto e colore si impostano nel Rich Text Editor sopra.
Bundle
  • Bundle toggle — l’intestazione a scomparsa che espande l’elenco dei componenti di un bundle.
  • Bundle item title — il titolo di ogni componente all’interno di un bundle.
  • Bundle item variant — l’etichetta della variante per ogni componente del bundle.
Lasciare un campo vuoto mantiene il valore predefinito dell’elemento.
Cliccando un elemento di testo direttamente nell’anteprima del carrello lo si evidenzia e si aprono automaticamente i suoi controlli nel pannello.

Design dei tag sconto

La riga Product include una sezione Discount tags nelle sue impostazioni di Design. Usala per stilizzare le etichette a pillola dei tag sconto che appaiono su ogni articolo: Queste impostazioni si applicano solo ai tag sconto degli articoli nel blocco Cart items. I tag dei codici sconto nel blocco Summary si stilizzano separatamente.

I sotto-blocchi e come si posizionano

Cart items è l’unico blocco che ospita sotto-blocchi. I sotto-blocchi vengono renderizzati una volta per riga, dentro ogni riga di prodotto, posizionati rispetto alla riga Product fissata:
  • I sotto-blocchi ordinati prima della riga Product appaiono sopra il contenuto del prodotto in ogni riga.
  • I sotto-blocchi ordinati dopo la riga Product appaiono sotto il contenuto del prodotto in ogni riga.
Quindi un Subscription upgrade posizionato dopo la riga Product appare sotto ogni riga idonea, non una sola volta in fondo all’intero elenco.

Comportamento

  • Quando il carrello non ha articoli, il drawer passa allo stato vuoto e questo blocco non viene mostrato.
  • Viene eseguita una modifica del carrello alla volta. Mentre un aggiornamento di quantità o una rimozione è in corso, i controlli della riga sono disabilitati per mantenere il carrello coerente, poi vengono riabilitati una volta completata la modifica.
  • Abbassare la quantità di una riga sotto 1 la rimuove. Una quantità che il negozio rifiuta (per esempio, oltre le scorte disponibili) viene risincronizzata all’ultimo valore valido.
  • I bundle cambiano come un’unità. Regolare la quantità sulla riga anchor di un bundle scala l’intero bundle in un’unica operazione: se un articolo figlio è incluso in ragione di 3 per anchor, portare l’anchor da 1 a 2 porta quel figlio a 6. Rimuovere l’anchor rimuove tutti i membri del bundle in una volta.
  • Alcuni bundle non possono cambiare quantità. Se uno degli articoli figli di un bundle è incluso con un rapporto frazionario (per esempio 1,5 per anchor), il selettore di quantità su quel bundle è bloccato: i pulsanti +/− e il campo quantità sono entrambi disabilitati, e le quantità digitate non vengono accettate. Il bundle può comunque essere rimosso.
  • Le righe in abbonamento mostrano il loro piano. Quando una riga ha un selling plan e il sotto-blocco Subscription upgrade è disattivato o non aggiunto, la riga Product mostra un’etichetta del piano in sola lettura sotto la variante — per esempio, Delivers every month (save 30%). Quando quel sotto-blocco è abilitato, presenta il piano nel proprio selettore, quindi l’etichetta in sola lettura viene soppressa anziché duplicata.

Posizionamento e limiti

  • Regione: corpo.
  • Massimo: 1 per stato del carrello.
  • Stato: solo carrello pieno.
  • Bloccato e aggiunto per impostazione predefinita. Cart items non può essere rimosso o nascosto, solo riposizionato.

Template personalizzato

Supporta un template personalizzato dalla sua scheda Code, che sostituisce il markup integrato di questo blocco con il tuo JSX. Queste sono le prop che riceve. Il contenitore Cart items non ha un template personalizzato. La riga Product al suo interno sì, ed è la superficie più ricca del carrello: il tuo template viene renderizzato una volta per riga.

Contenuto della riga

price e compareAtPrice sono stringhe formattate; tutto ciò che è su line è in centesimi. Non fare calcoli su price. Calcola a partire da line.finalLinePrice e simili, poi passa il risultato attraverso formatMoney.

Quantità e rimozione

Renderizzare un bundle

Sulla riga anchor di un bundle, bundle.children contiene i suoi contenuti. I figli non appaiono mai come righe autonome, quindi se non li renderizzi l’acquirente non vedrà cosa c’è nel bundle:
La key di un figlio è null per un componente di un bundle nativo Shopify, quindi ripiega sull’indice come sopra.

Design

Personalizza lo stile di questo blocco con la sua sezione Design nel pannello delle impostazioni. Si tratta di override per singolo blocco che si sovrappongono al tuo design globale e vi ricadono quando sono vuoti. Cosa sono le impostazioni di design? Scopri di più qui: Impostazioni di design.