Skip to content

Commit 8ace7de

Browse files
committed
update semantic query notes
1 parent 8d0906d commit 8ace7de

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

docs/guide-which-query.md

+5-3
Original file line numberDiff line numberDiff line change
@@ -22,11 +22,13 @@ possible. With this in mind, we recommend this order of priority:
2222
preference for non-form elements.
2323
1. `getByDisplayValue`: The current value of a form element can be useful
2424
when navigating a page with filled-in values.
25-
1. **Semantic Queries** HTML5 and ARIA compliant selectors
25+
1. **Semantic Queries** HTML5 and ARIA compliant selectors. Note that the user
26+
experience of interacting with these attributes varies greatly across
27+
browsers and assistive technology.
2628
1. `getByAltText`: If your element is one which supports `alt` text (`img`,
2729
`area`, and `input`), then you can use this to find that element.
28-
1. `getByTitle`: The title attribute is usually more accessible by screen
29-
readers than mouse/visual users
30+
1. `getByTitle`: The title attribute is not consistently read by
31+
screenreaders, and is not visible by default for sighted users
3032
1. `getByRole`: This can be used to select dialog boxes and other
3133
difficult-to-capture elements in a more semantic way
3234
1. **Test IDs**

0 commit comments

Comments
 (0)