chore: add example to JSDoc for getAriaValue (#9692)

mikeharv · web-flow · commit 5bc04b64357f · 2026-04-08T16:12:00.000-04:00
diff --git a/packages/blockly/core/field.ts b/packages/blockly/core/field.ts
@@ -329,6 +329,11 @@ export abstract class Field<T = any>
    * 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.
    *

Original file line number	Diff line number	Diff line change
`@@ -329,6 +329,11 @@ export abstract class Field<T = any>`
`329`	`329`	`* entirely when there may be a better contextual placeholder to use, instead,`
`330`	`330`	`* specific to the field.`
`331`	`331`	`*`
	`332`	`+ * For example, a text input field may have a value of null when empty. To`
	`333`	`+ * avoid hiding this field from screen reader, implementations should ensure`
	`334`	`+ * that if the value is null, this function would return an appropriate,`
	`335`	`+ * localized value such as "empty text".`
	`336`	`+ *`
`332`	`337`	`* Implementations are responsible for, and encouraged to, return a localized`
`333`	`338`	`* version of the ARIA representation of the field's value.`
`334`	`339`	`*`