Research Guides
Test the Reading Path Through a Research Tooltip
A research chart can hide its most important qualification in a tooltip that disappears before a reader finishes it. Checking that the bubble appears is only the beginning. Review whether someone can reach, read and dismiss the extra information without losing their place.
This is a manual interaction-review worksheet for an authorized interface or prototype. It does not describe a verified tooltip feature in Colquhoun.shop or establish overall accessibility conformance.
1. Identify what the popup adds
Choose a specific trigger, such as a metric label or chart marker. Record the underlying value, the additional explanation and whether that explanation is available elsewhere. Note whether the popup contains an essential qualification, a definition or merely supplementary detail.
Keep the trigger and its message together in the test record. Similar-looking markers may display different periods or units, so a screenshot of a generic bubble is not enough to identify the tested case.
2. Check behavior, not just appearance
W3C's Content on Hover or Focus guidance covers additional content triggered by pointer hover or keyboard focus. It sets conditions for dismissal, moving the pointer onto the added content, and keeping it visible. Dismissal has exceptions for input errors or content that does not obscure or replace other content; unmodified browser-controlled presentation is also excepted. W3C: Understanding Content on Hover or Focus
Record each applicable condition separately. A popup that remains visible can still be difficult to dismiss, and a dismissible popup can still vanish when the reader moves toward it. Avoid a single checkbox labeled “tooltip works.”
3. Reproduce the reading task
In an invented chart, hovering over a point reveals “42 visits; incomplete reporting day.” The numeric value remains visible on the chart, but the qualification is available only in the popup. The reviewer moves the pointer toward the explanation and it disappears in the gap between the point and the bubble.
The issue record should include the trigger, the missing qualification, the movement sequence and the tested layout. It should not simply say that the chart is visually confusing. A second reviewer needs enough information to reproduce the specific interruption.
Use harmless sample data for the fixture. Do not include private analytics or customer identifiers in screenshots intended for public bug discussions.
4. Test the other input route and the surrounding page
Try the corresponding keyboard route and record how the additional content is reached. W3C notes that content available on hover should also be available through keyboard focus. Test the actual implementation rather than assuming an information icon supplies both routes.
Check what the popup covers and whether dismissing it leaves the reader at the intended trigger. Review a narrow layout and a longer message, not only the shortest text at a wide viewport. Record magnification or assistive-technology checks separately when performed.
If a qualification is essential to interpreting a figure, consider with the content owner whether it should also be visible in the caption or nearby explanation. That editorial decision complements interaction testing; it does not excuse a broken popup.
5. Keep a trigger-to-message record
- Trigger: page, marker or label and underlying value.
- Message: exact additional information and its importance.
- Routes: hover and keyboard observations.
- Behavior: dismissal, pointer movement and persistence.
- Layout: overlap, message length and tested viewport.
- Retest: corrected behavior and untested conditions.
After an authorized fix, repeat the original reading sequence and confirm that the message still belongs to the correct data point. Moving a popup should not detach its content from the evidence it explains.
A useful completion note describes the verified interaction and its limits. “The sampled explanation can now be reached and dismissed in these tests” is more defensible than declaring every chart accessible because a tooltip was restyled.