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 shippingaddresschange-Ereignis wird an das PaymentRequest-Objekt gesendet, wenn der Benutzer eine Versandadresse auswählt oder Details seiner Versandadresse ändert.
Dieses Ereignis kann nicht abgebrochen werden und löst keine Bubbling aus.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("shippingaddresschange", (event) => { })
onshippingaddresschange = (event) => { }
Ereignistyp
Ein PaymentRequestUpdateEvent, das von Event erbt.
Nutzungshinweise
Abhängig vom Browser können die Informationen zur Versandadresse aus Datenschutzgründen redigiert werden. Das heißt, die PaymentAddress, die die Versandadresse enthält, kann in einigen Teilen ihres Inhalts geändert, verdeckt oder vollständig weggelassen sein, um zu verhindern, dass der Benutzer ohne seine Zustimmung identifiziert wird (da Sie, wenn sie sich entscheiden, dass Sie Produkte an sie versenden sollen, ihre Adresse benötigen).
Beispiel
In diesem Beispiel wird ein Handler für das shippingaddresschange-Ereignis eingerichtet, um zu validieren, dass die Adresse die von der Webanwendung festgelegten Anforderungen 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 auch einen Handler für shippingaddresschange mit der onshippingaddresschange-Ereignis-Handler-Eigenschaft festlegen:
paymentRequest.onshippingaddresschange = (event) => {
const detailsUpdate = checkAddress(paymentRequest.shippingAddress);
event.updateWith(detailsUpdate);
};