diff --git a/core/src/components.d.ts b/core/src/components.d.ts index 1b083ee765..2d6f41368b 100644 --- a/core/src/components.d.ts +++ b/core/src/components.d.ts @@ -644,7 +644,7 @@ export namespace Components { */ "name": string; /** - * If `true`, the user must fill in a value before submitting a form. + * If true, screen readers will announce it as a required field. This property works only for accessibility purposes, it will not prevent the form from submitting if the value is invalid. */ "required": boolean; "setFocus": () => Promise; @@ -5440,7 +5440,7 @@ declare namespace LocalJSX { */ "onIonFocus"?: (event: IonCheckboxCustomEvent) => void; /** - * If `true`, the user must fill in a value before submitting a form. + * If true, screen readers will announce it as a required field. This property works only for accessibility purposes, it will not prevent the form from submitting if the value is invalid. */ "required"?: boolean; /** diff --git a/core/src/components/checkbox/checkbox.tsx b/core/src/components/checkbox/checkbox.tsx index e9771e4f28..dcea4876d7 100644 --- a/core/src/components/checkbox/checkbox.tsx +++ b/core/src/components/checkbox/checkbox.tsx @@ -99,7 +99,9 @@ export class Checkbox implements ComponentInterface { @Prop() alignment?: 'start' | 'center'; /** - * If `true`, the user must fill in a value before submitting a form. + * If true, screen readers will announce it as a required field. This property + * works only for accessibility purposes, it will not prevent the form from + * submitting if the value is invalid. */ @Prop() required = false;