Orders 7877 accessibility returns entry points - #2725
Conversation
There was a problem hiding this comment.
Pull request overview
Improves accessibility for “Return Items” entry points on account order list and order details by ensuring a more logical focus/reading order and providing more descriptive, translatable accessible names for return links/buttons.
Changes:
- Reorders the orders list DOM so the order title/link precedes the status/return action (better focus order), with SCSS updates to preserve the visual layout.
- Adds unique
aria-labelvalues (via a newlang/en.jsonkey) to “Return Items” links/buttons that include the order number. - Updates the in-repo accessibility skill documentation with reduced-motion guidance.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| templates/pages/account/orders/details.html | Adds an order-specific aria-label to the return button on order details. |
| templates/components/account/orders-list.html | Moves order title ahead of status/return action in DOM and adds an order-specific aria-label to the return link. |
| lang/en.json | Introduces a new translatable string for the order-specific return aria-label. |
| assets/scss/components/stencil/account/_account.scss | Adds an override class to keep the order status block positioned correctly after DOM reordering. |
| .claude/skills/accessibility/SKILL.md | Adds guidance about prefers-reduced-motion expectations. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
b5887f4 to
2bf9552
Compare
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes and found 1 potential issue.
❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.
Reviewed by Cursor Bugbot for commit 2bf9552. Configure here.
2bf9552 to
3668a6d
Compare
5b74b7d
into
feature/PROJECT-7525-new-returns-flow

What?
Accessibility for returns entry points on order list and order details page
Requirements
Tickets / Documentation
ORDERS-7877
Screenshots (if appropriate)
Before changes (Navigation goes to returns link first and then to order ID):
Screen.Recording.2026-08-12.at.1.42.06.pm.mov
After changes(UI remains same with fixes to aria-labels and navigation improvements):
Note
Low Risk
Template, CSS layout, and i18n-only accessibility fixes with no auth, data, or behavioral logic changes. Visual layout is preserved via flex, but focus order and screen-reader naming should be spot-checked.
Overview
Improves accessibility of returns entry points on the orders list and order details pages (ORDERS-7877).
On the orders list, the order title link is moved before the status/return block in the DOM so keyboard focus reaches the order first (WCAG 2.4.3), while a new
.account-product-headingflex row keeps the visual layout. Return links on both the list and details pages get an order-scopedaria-labelvia the newreturn_items_forstring.Also clarifies in the accessibility skill that
prefers-reduced-motiontargets substantial/auto-playing motion, not transient loading spinners.Reviewed by Cursor Bugbot for commit 3668a6d. Bugbot is set up for automated code reviews on this repo. Configure here.