Bug 269206 - [ui] Tab ordering and focus highlights on the P2 dialogs
Summary: [ui] Tab ordering and focus highlights on the P2 dialogs
Status: RESOLVED FIXED
Alias: None
Product: Equinox
Classification: Eclipse Project
Component: p2 (show other bugs)
Version: 3.4.2   Edit
Hardware: PC Windows XP
: P3 normal (vote)
Target Milestone: 3.5 RC1   Edit
Assignee: Susan McCourt CLA
QA Contact:
URL:
Whiteboard:
Keywords: accessibility
Depends on:
Blocks:
 
Reported: 2009-03-18 11:09 EDT by Oleg Besedin CLA
Modified: 2009-05-11 12:02 EDT (History)
4 users (show)

See Also:
Kevin_McGuire: review+


Attachments
patch that fixes conflicting mnemonics (2.71 KB, patch)
2009-05-05 19:13 EDT, Susan McCourt CLA
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Oleg Besedin CLA 2009-03-18 11:09:07 EDT
It seems that there are a few small twicks that can be done to improve P2 dialogs accessibility:

1) "Install New Software" dialog: tab ordering: read-only "Details" field is included in the tab order.

2) "Install New Software" dialog: tabbing into the tree of available software does not set visible focus highlight on a tree element

3) "Install New Software" dialog: tree of available software should have a label describing what it is with a keyboard accelerator

4) "Install New Software" dialog: hyperlinks for preferences and "already installed" don't have keyboard accelerators

5) "Install New Software" dialog: "More..." hyperlink appearing in the details for some features needs a keyboard accelerator. (Not accessibility related, but that button is a strange beast. Would it make more sense to have it always displayed and enable/disable?)

6) "Install New Software" dialog -> "Next": The dialog title "Review the items to be installed" is incldued in the tab order

7) "Install New Software" dialog -> "Next": Same thing as above about tree element not being highlighted

8) "Install New Software" dialog -> "Next": Same thing as above about tree needing to have a label

9) "Install New Software" dialog -> "Next": Same things as above about "Details" and "More" buttons

10) "Install New Software" dialog -> "Next" -> "Next": Same things as above for the dialog title, should license text be included in the tab order?, tree control needs label

11) "Install/Update" preference page: duplicate keyboard accelerators for "Ask me what to do" and "Apply" buttons

12) "Automatic updates" preference page: duplicate keyboard accelerators for "Download new updates automatically" and "Apply" buttons
Comment 1 Susan McCourt CLA 2009-03-18 11:43:28 EDT
The read only fields included in the tab order are specifically done so for accessibility (screen readers).  So I'm not sure that these would be considered accessibility problems.

None of the links in Eclipse that I know of have keyboard mnemonics (but they should be tabbable) so I don't think this is an issue.

Will fix other problems.



Comment 2 John Arthorne CLA 2009-03-18 12:02:01 EDT
Yes, it would be a problem if those read-only field *weren't* in the tab order.
Comment 3 Susan McCourt CLA 2009-04-23 12:37:35 EDT
investigate for RC1
Comment 4 Susan McCourt CLA 2009-05-05 19:12:00 EDT
Fixing the duplicate mnemonics, but I don't see anything else we should address.

(In reply to comment #0)
> It seems that there are a few small twicks that can be done to improve P2
> dialogs accessibility:
> 
> 1) "Install New Software" dialog: tab ordering: read-only "Details" field is
> included in the tab order.

This is for screen reader support, required for accessibility
> 
> 2) "Install New Software" dialog: tabbing into the tree of available software
> does not set visible focus highlight on a tree element

After doing some digging, I found that this is bug 148364.  I doubt this will ever be fixed and the problem exists across the SDK.  If there were a concerted effort in the SDK to avoid the bug, we could do the same.
> 
> 3) "Install New Software" dialog: tree of available software should have a
> label describing what it is with a keyboard accelerator

This is a filtered tree, and there's no way to insert label text between the filter text and the tree.  Note that the preferences dialog and any other filtered tree dialogs have the same issue, so I'm assuming this is acceptable.  It is reachable through tabbing.
> 
> 4) "Install New Software" dialog: hyperlinks for preferences and "already
> installed" don't have keyboard accelerators

None of the hyperlinks in the SDK have mnemonics.  They are reachable through tabbing.
> 
> 5) "Install New Software" dialog: "More..." hyperlink appearing in the details
> for some features needs a keyboard accelerator. (Not accessibility related, but
> that button is a strange beast. Would it make more sense to have it always
> displayed and enable/disable?)

It is accessible through tabbing.  Agree it's a strange beast, see 273513.  I added your remark to that bug.
> 
> 6) "Install New Software" dialog -> "Next": The dialog title "Review the items
> to be installed" is incldued in the tab order

This is intentional so that screen readers can read it
> 
> 7) "Install New Software" dialog -> "Next": Same thing as above about tree
> element not being highlighted

bug 148364

> 
> 8) "Install New Software" dialog -> "Next": Same thing as above about tree
> needing to have a label

There are few wizards that will label the main tree when there is only one main control.  Often the wizard description (which is reachable by screen readers) will provide overall context.  
> 
> 9) "Install New Software" dialog -> "Next": Same things as above about
> "Details" and "More" buttons

same response as above

> 
> 10) "Install New Software" dialog -> "Next" -> "Next": Same things as above for
> the dialog title, should license text be included in the tab order?, tree
> control needs label

the license list and license text have a label and both are reachable in the tab order.  Note the license list suffers the same focus indicator problem (bug 148364)
> 
> 11) "Install/Update" preference page: duplicate keyboard accelerators for "Ask
> me what to do" and "Apply" buttons

Fixed.  Good catch

> 
> 12) "Automatic updates" preference page: duplicate keyboard accelerators for
> "Download new updates automatically" and "Apply" buttons
> 

Fixed.  Another good catch.



Comment 5 Susan McCourt CLA 2009-05-05 19:13:46 EDT
Created attachment 134548 [details]
patch that fixes conflicting mnemonics

Kevin, can you please review.

Can you also please read my responses to items 1-10 and let me know if you think any of these should be addressed by p2 in the long run.  If so, I will open separate bugs for those and address after 3.5.  To me, they seem to be things we do all over the place and probably don't need to address unless/until we make some effort across the SDK to fix consistently.
Comment 6 Susan McCourt CLA 2009-05-06 19:57:38 EDT
apparently I did not set review flag :(
Comment 7 Kevin McGuire CLA 2009-05-07 10:08:12 EDT
Reviewed patch.
As I commented, strictly speaking it's not necessary that Cancel have a mneumonic since <escape> always triggers it, but then it doesn't hurt to avoid the conflicts, so +1.
Comment 8 Susan McCourt CLA 2009-05-07 10:28:27 EDT
Kevin, you commented in bug 269079 and approved this one.  Just double checking that you reviewed this one?

(The mnemonic conflics in this bug involve the A in &Apply)
Comment 9 Kevin McGuire CLA 2009-05-07 11:06:52 EDT
(In reply to comment #8)
> Kevin, you commented in bug 269079 and approved this one.  Just double checking
> that you reviewed this one?
> 
> (The mnemonic conflics in this bug involve the A in &Apply)

Ah that was the problem! Had both bugs open, picked the wrong one (meant to +1 the other one).
Comment 10 Kevin McGuire CLA 2009-05-07 11:45:19 EDT
(In reply to comment #4)
> > 1) "Install New Software" dialog: tab ordering: read-only "Details" field is
> > included in the tab order.
> 
> This is for screen reader support, required for accessibility

Yup.  Similarly, in wizards you can back-tab to the description text at the top of the wizard. 

> > 2) "Install New Software" dialog: tabbing into the tree of available software
> > does not set visible focus highlight on a tree element
> 
> After doing some digging, I found that this is bug 148364.  I doubt this will
> ever be fixed and the problem exists across the SDK.  If there were a concerted
> effort in the SDK to avoid the bug, we could do the same.

Wow that's really unfortunate.

> > 3) "Install New Software" dialog: tree of available software should have a
> > label describing what it is with a keyboard accelerator
> 
> This is a filtered tree, and there's no way to insert label text between the
> filter text and the tree.  Note that the preferences dialog and any other
> filtered tree dialogs have the same issue, so I'm assuming this is acceptable. 

Yes, I think it's fine as is.

If we felt though that it wasn't clear what the contents of the tree was, we could improve the wizard heading message "Check the items that you wish to install" to use something other than "items".

> > 4) "Install New Software" dialog: hyperlinks for preferences and "already
> > installed" don't have keyboard accelerators
> 
> None of the hyperlinks in the SDK have mnemonics.  They are reachable through
> tabbing.

That's sufficient and consistent.

Patch looks fine +1



Comment 11 Susan McCourt CLA 2009-05-11 12:02:05 EDT
fixed >20090507.