HTMLObjectElement: setCustomValidity() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die setCustomValidity() Methode des HTMLObjectElement Interface setzt eine benutzerdefinierte Fehlermeldung für das Element.

Syntax

setCustomValidity(errorMessage)

Parameter

errorMessage: Die Nachricht, die für Validitätsfehler verwendet werden soll.

In diesem Beispiel übergeben wir die ID eines Eingabeelements und setzen je nach fehlendem, zu niedrigem oder zu hohem Wert unterschiedliche Fehlermeldungen. Beachten Sie, dass die Nachricht nicht sofort angezeigt wird. Ein Versuch, das Formular abzusenden, zeigt die Nachricht an, oder Sie können die reportValidity() Methode auf dem Element aufrufen.

function validate(inputID) {
  const input = document.getElementById(inputID);
  const validityState = input.validity;

  if (validityState.valueMissing) {
    input.setCustomValidity("You gotta fill this out, yo!");
  } else if (validityState.rangeUnderflow) {
    input.setCustomValidity("We need a higher number!");
  } else if (validityState.rangeOverflow) {
    input.setCustomValidity("Thats too high!");
  } else {
    input.setCustomValidity("");
  }

  input.reportValidity();
}

Es ist wichtig, die Nachricht auf eine leere Zeichenkette zu setzen, wenn keine Fehler vorliegen. Solange die Fehlermeldung nicht leer ist, wird das Formular die Validierung nicht bestehen und nicht gesendet werden.