mdn/content

HTMLButtonElement - setCustomValidity(): Specify button type availability

Open

#42 234 ouverte le 4 déc. 2025

Voir sur GitHub
 (3 commentaires) (0 réactions) (0 assignés)Markdown (8 900 stars) (22 427 forks)batch import
Content:WebAPIhelp wanted

Description

MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/HTMLButtonElement/setCustomValidity

What specific section or headline is this issue about?

No response

What information was incorrect, unhelpful, or incomplete?

Subsequent to spending a few hours testing and looking for the relevant information, I found out from #dom:mozilla.org that the specification only allows HTMLButtonElement: setCustomValidity() method for button type="submit".

It would be beneficial to include the information on MDN to prevent further confusion.

Similarly, HTMLButtonElement: reportValidity() would benefit from further clarification, as given in HTMLFieldSetElement: reportValidity()

It always returns true because <fieldset> elements are never candidates for constraint validation.

Ref: Constraint validation

What did you expect to see?

A notice to say that method only produces a visual effect for button type="submit"

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

No response

MDN metadata

Guide contributeur

Stack technique
htmljavascript
Domaine
documentation
Type d'issue
documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
under 1 hour
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
clear
Prérequis
Basic knowledge of HTML constraint validation
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
80
Direction de recherche
The issue is to update the MDN documentation for `HTMLButtonElement.setCustomValidity()` to clarify that it only works for `button type="submit"`. The file to edit is `files/en us/web/api/htmlbuttonelement/setcustomvalidity/index.md`. Additionally, consider updating `HTMLButtonElement.reportValidity()` similarly, as mentioned in the issue. Refer to the HTML spec constraint validation section. Test the change by ensuring it aligns with the spec and existing MDN documentation style.