Warenkorb-Aktion mit einer Microinteraction bestätigen
Nach einem Klick auf «In den Warenkorb» verarbeitet WooCommerce die Aktion im Hintergrund. Eine Microinteraction zeigt direkt am Button, ob das Produkt gerade hinzugefügt wird oder bereits im Warenkorb liegt.
Ein Klick auf «In den Warenkorb» löst in WooCommerce eine asynchrone Aktion aus. Während dieser Verarbeitung vermittelt das Bedienelement, dass die Eingabe übernommen wurde. Nach erfolgreichem Abschluss bestätigt ein Statuswechsel, dass sich das Produkt im Warenkorb befindet.
Die Microinteraction verbindet diese Zustände im Button. Die Beschriftung wechselt von «In den Warenkorb» über «Wird hinzugefügt» zu «Hinzugefügt». Farbe und Bewegung begleiten die Rückmeldung, während der Text ihre Bedeutung vermittelt.
WooCommerce-Ereignisse für die Rückmeldung nutzen
In klassischen Produktübersichten löst WooCommerce vor der AJAX-Anfrage das Ereignis adding_to_cart aus. Nach einer erfolgreichen Antwort folgt added_to_cart. Die Zustandsanzeige knüpft dadurch an den tatsächlichen Verarbeitungsablauf an.
jQuery( function ( $ ) {
const $status = $( '<span>', {
class: 'screen-reader-text',
'aria-live': 'polite'
} ).appendTo( document.body );
$( document.body )
.on( 'adding_to_cart', function ( event, $button ) {
$button
.data( 'ud-label', $button.text() )
.addClass( 'is-adding' )
.text( 'Wird hinzugefügt' );
} )
.on( 'added_to_cart', function ( event, fragments, hash, $button ) {
if ( ! $button || ! $button.length ) {
return;
}
$button
.removeClass( 'is-adding' )
.addClass( 'is-added' )
.text( 'Hinzugefügt' );
$status.text( 'Produkt wurde dem Warenkorb hinzugefügt.' );
window.setTimeout( function () {
$button
.removeClass( 'is-added' )
.text( $button.data( 'ud-label' ) );
}, 2000 );
} );
} );
Das Skript verändert ausschliesslich den Button, der die jeweilige Aktion ausgelöst hat. Die Bestätigung erscheint nach dem erfolgreichen Hinzufügen. Die ursprüngliche Beschriftung wird gespeichert und nach zwei Sekunden wiederhergestellt.
Eine Live-Region gibt den erfolgreichen Vorgang zusätzlich an assistive Technologien weiter.
Laden und Erfolg visuell unterscheiden
Die beiden Klassen lassen sich über das Theme gestalten. Eine leichte Verschiebung kennzeichnet den Übergang, während Farbe und Schatten den erfolgreichen Zustand sichtbar machen:
.add_to_cart_button {
transition:
transform 180ms ease,
background-color 180ms ease,
box-shadow 180ms ease;
}
.add_to_cart_button.is-adding {
cursor: progress;
opacity: 0.72;
}
.add_to_cart_button.is-added {
background-color: var(--wp--preset--color--highlight-500, #28783e);
box-shadow: 0 8px 24px rgb(40 120 62 / 18%);
transform: translateY(-2px);
}
Die CSS-Variablen können aus der Farbpalette des Themes stammen. Dadurch fügt sich die Rückmeldung in den Shopauftritt ein.
Bewegung individuell berücksichtigen
Der Textwechsel vermittelt die Zustandsinformation auch ohne Animation. Bei aktivierter reduzierter Bewegung entfernt diese Media Query den bewegten Übergang:
@media (prefers-reduced-motion: reduce) {
.add_to_cart_button {
transition: none;
}
.add_to_cart_button.is-added {
transform: none;
}
}
Die textliche Rückmeldung bleibt erhalten, während die zusätzliche Bewegung entfällt.
Klassische und blockbasierte Produktlisten unterscheiden
Das gezeigte JavaScript gilt für klassische AJAX-Warenkorb-Buttons. WooCommerce-Blöcke verwenden native DOM-Ereignisse mit den Namen wc-blocks_adding_to_cart und wc-blocks_added_to_cart.
Bei einer blockbasierten Produktliste wird dieselbe Zustandslogik innerhalb der verwendeten Block-Komponente umgesetzt.
Ergebnis
Warenkorb-Aktionen direkt und verständlich rückmelden
Die Microinteraction macht den Verlauf einer Warenkorb-Aktion im Button sichtbar. Text, Farbe und Bewegung verbinden die Verarbeitung im Hintergrund mit einer verständlichen Rückmeldung im Shop.
Buttonstatus sofort zeigen
Die Beschriftung beschreibt den laufenden Vorgang und den Abschluss direkt am Warenkorb-Button.
Erfolg erst bestätigen
WooCommerce löst die Erfolgsanzeige nach einer erfolgreichen AJAX-Antwort aus.
Bewegung individuell anpassen
Die textliche Rückmeldung bleibt auch bei reduzierter Bewegung vollständig verständlich.