@8wave/ai-elements 0.121.0-beta.59 → 0.121.0-beta.60
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -949,7 +949,9 @@ The snapshot reads the page as a screen reader would: visible elements only, eac
|
|
|
949
949
|
as a line with its role, its accessible name, its state and a reference the action tools use.
|
|
950
950
|
|
|
951
951
|
- Names come from `aria-label`, `aria-labelledby`, the `<label>` of a field, `alt`,
|
|
952
|
-
`placeholder` and `title`, then the element's text.
|
|
952
|
+
`placeholder` and `title`, then the element's text. A field with none of these takes the
|
|
953
|
+
`<label>` written beside it and tied to nothing (no `for`, no control inside), when it is the
|
|
954
|
+
only one before the field in the nearest container that holds one: a guess, so tie your labels.
|
|
953
955
|
- Open shadow roots and slotted content are read. Elements hidden from the user are skipped
|
|
954
956
|
(in browsers with `Element.checkVisibility`, which every current browser has).
|
|
955
957
|
- Never read: `script`, `style`, `svg`, `canvas`, `iframe`, `object`, `embed`, `video`, `audio`,
|
|
@@ -967,6 +969,10 @@ as a line with its role, its accessible name, its state and a reference the acti
|
|
|
967
969
|
select) reads with the choice it shows, as the user sees it on the closed box:
|
|
968
970
|
`combobox "Role" value="User"`. Its value is empty while it shows a placeholder, which the
|
|
969
971
|
widget tells from the options of the list it controls (`aria-controls`), none `aria-selected`.
|
|
972
|
+
- A combobox field that opens a list as the user types (`aria-expanded="true"` and
|
|
973
|
+
`aria-controls` or `aria-owns` on its list, as react-select does): the agent writes the text,
|
|
974
|
+
the result shows the list with its options, and the agent picks one with a click. The fields
|
|
975
|
+
after it in the same `page_fill` wait, since writing one would close the list.
|
|
970
976
|
- While your page has a modal `<dialog>` open (`showModal()`), a snapshot of the page reads that
|
|
971
977
|
dialog only, and says so: the rest of the page is inert for the user until it closes.
|
|
972
978
|
- A field says the language of its text (`lang it`) when it, or a container of it below `<html>`,
|
|
@@ -994,7 +1000,9 @@ Other sensitive fields must be marked by your site, or listed in **Excluded area
|
|
|
994
1000
|
|
|
995
1001
|
At **Page control**, a card in the chat asks the user before:
|
|
996
1002
|
|
|
997
|
-
- a click on a submit button, or Enter in a field that submits its form
|
|
1003
|
+
- a click on a submit button, or Enter in a field that submits its form (not in a combobox with
|
|
1004
|
+
its list open, where Enter picks an option: the form is not sent, and a submit your own handler
|
|
1005
|
+
of the key starts with `requestSubmit()` or a click on the button is stopped). The card lists the
|
|
998
1006
|
filled fields of the form with their values, leaving out the ones the agent never reads: first
|
|
999
1007
|
every field whose value changed since the agent first read the form, whether the agent wrote it
|
|
1000
1008
|
or your page did (after a dialog of yours, say), a long one from where it changed, then the
|