ContextQMD
Back to Content

HTMLFieldSetElement: setCustomValidity() method

files/en-us/web/api/htmlfieldsetelement/setcustomvalidity/index.md

latest1.8 KB
Original Source

{{ APIRef("HTML DOM") }}

The setCustomValidity() method of the {{DOMxRef("HTMLFieldSetElement")}} interface sets the custom validity message for the {{htmlelement("fieldset")}} element. Use the empty string to indicate that the element does not have a custom validity error.

The <fieldset> element is not a candidate for constraint validation. The {{DOMxRef("HTMLFieldSetElement.reportValidity()", "reportValidity()")}} method will not cause the custom error message to be displayed to the user, but does set the {{DOMxRef("ValidityState.customError", "customError")}} property of the element's {{DOMxRef("ValidityState")}} object to true and the {{DOMxRef("ValidityState.valid", "valid")}} property to false.

Syntax

js-nolint
setCustomValidity(string)

Parameters

  • string
    • : The string containing the error message. The empty string removes any custom validity errors.

Return value

None ({{jsxref("undefined")}}).

Examples

js
const errorFieldSet = document.getElementById("checkErrors");
const errors = issuesToReport();
if (errors) {
  errorFieldSet.setCustomValidity("There is an error");
} else {
  errorFieldSet.setCustomValidity("");
}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also