From f5b1b93edd1052e155bb509674aa23644c12ad9e Mon Sep 17 00:00:00 2001 From: Mike Harvey <43474485+mikeharv@users.noreply.github.com> Date: Wed, 8 Apr 2026 15:18:52 -0400 Subject: [PATCH] chore: add example to JSDoc for getAriaValue --- packages/blockly/core/field.ts | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/packages/blockly/core/field.ts b/packages/blockly/core/field.ts index 2ecef1681e3..9f6792ebb06 100644 --- a/packages/blockly/core/field.ts +++ b/packages/blockly/core/field.ts @@ -329,6 +329,11 @@ export abstract class Field * entirely when there may be a better contextual placeholder to use, instead, * specific to the field. * + * For example, a text input field may have a value of null when empty. To + * avoid hiding this field from screen reader, implementations should ensure + * that if the value is null, this function would return an appropriate, + * localized value such as "empty text". + * * Implementations are responsible for, and encouraged to, return a localized * version of the ARIA representation of the field's value. *