PaymentRequest: shippingaddresschange-Ereignis
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Das Ereignis shippingaddresschange wird an das PaymentRequest-Objekt gesendet, wenn der Benutzer eine Lieferadresse auswählt oder Angaben zu seiner Lieferadresse ändert.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergereicht.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("shippingaddresschange", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
onshippingaddresschange = (event) => { }
Ereignistyp
Ein PaymentRequestUpdateEvent. Erbt von Event.
Hinweise zur Verwendung
Je nach Browser können die Angaben zur Lieferadresse aus Datenschutzgründen teilweise verborgen werden. Das bedeutet, dass Inhalte der PaymentAddress, die die Lieferadresse enthält, verändert, unkenntlich gemacht oder vollständig weggelassen werden können. So wird verhindert, dass der Benutzer ohne seine Zustimmung identifiziert wird. Wenn er sich dafür entscheidet, dass Sie ihm Produkte zusenden, benötigen Sie seine Adresse.
Beispiel
In diesem Beispiel wird ein Handler für das Ereignis shippingaddresschange eingerichtet, der überprüft, ob die Adresse die Anforderungen der Webanwendung erfüllt.
const paymentRequest = new PaymentRequest(methodData, details, options);
paymentRequest.addEventListener("shippingaddresschange", (event) => {
const detailsUpdate = checkAddress(paymentRequest.shippingAddress);
event.updateWith(detailsUpdate);
});
function checkAddress(theAddress) {
const detailsUpdate = {};
// Check the address, return an object with any changes or errors.
return detailsUpdate;
}
Sie können einen Handler für shippingaddresschange auch über die Event-Handler-Eigenschaft onshippingaddresschange einrichten. Beachten Sie jedoch, dass dadurch gegebenenfalls andere über onshippingaddresschange hinzugefügte Event-Listener ersetzt werden:
paymentRequest.onshippingaddresschange = (event) => {
const detailsUpdate = checkAddress(paymentRequest.shippingAddress);
event.updateWith(detailsUpdate);
};