Add some comments

desmosinc · Oct 29, 2024 · bc6d5e6 · bc6d5e6
1 parent 8583e4d
commit bc6d5e6
Show file tree

Hide file tree

Showing 2 changed files with 3 additions and 1 deletion.
diff --git a/src/services/aria.ts b/src/services/aria.ts
@@ -93,6 +93,8 @@ class Aria {
     return this.clear();
   }
 
+  /* Clear out the internal alert message queue.
+   * If opts.emptyContent is set, also clear the rendered text content for the alert element (typically when the focused field has been blurred) so we don't leave stale alert text hanging around. */
   clear(opts?: { emptyContent: boolean }) {
     this.items.length = 0;
     if (opts?.emptyContent) this.span.textContent = '';

diff --git a/src/services/textarea.ts b/src/services/textarea.ts
@@ -229,7 +229,7 @@ class Controller extends Controller_scrollHoriz {
       ? ariaLabel + ':'
       : ariaLabel;
     var mathspeak = ctrlr.root.mathspeak().trim();
-    const emptyContent = !!opts?.emptyContent;
+    const emptyContent = !!opts?.emptyContent; // Set when the focused field has been blurred so alert text is removed when it's no longer needed.
     this.aria.clear({ emptyContent });
 
     if (!!ctrlr.mathspeakSpan) {