docs(spec-language): name the hintText selector's host divergence

The line said the key matches placeholder alone, which is true of the web
runtime and not of the tree, where it resolves against the derived
attribute. A spec author reading it wrote a selector that matched on one
host and not the other.
This commit is contained in:
pj committed 2026-08-18 16:11:45 +05:30
1 parent 15126c291d
commit c8fcc21e6b
1 file changed
+6 -1
+6 -1
View File
@@ -156,7 +156,12 @@ Fields available on every element returned by `find` / `findAll`:
markup writes (`attrs["data-cents"]`, not `attrs.cents`). markup writes (`attrs["data-cents"]`, not `attrs.cents`).
- `attrs.hintText` names an editable field the way a user reads it: its - `attrs.hintText` names an editable field the way a user reads it: its
`aria-label`, the `<label>` bound to it, its `placeholder`, then its `name`. `aria-label`, the `<label>` bound to it, its `placeholder`, then its `name`.
The `hintText` selector key still matches the `placeholder` attribute alone. The `hintText` selector key does not read that ladder on both hosts: the
accessibility tree resolves it against the derived attribute above, and the
web runtime resolves it against `placeholder` alone. A field labelled by
`aria-label` or a bound `<label>` therefore answers to `{hintText: "Email"}`
in one and not the other. Select such a field by `attrs.hintText` until the
two agree.
### KMP (Kotlin Multiplatform) ### KMP (Kotlin Multiplatform)