WordPress.org

Make WordPress Core

Opened 3 years ago

Last modified 5 months ago

#36715 new enhancement

Contextual help to describe what roles are

Reported by: ericlewis Owned by:
Milestone: Priority: normal
Severity: normal Version:
Component: Users Keywords:
Focuses: ui Cc:
PR Number:

Description

Roles are not exactly self-explaining "What's the difference between a contributor and an author?" is probably a confusing question for new users.

We have help text to describe what roles are in the Help dropdown on the Add New User page, but it's rather out of the way.

I'd like to suggest moving this help text closer to its context, in the form of a tooltip next to the Role dropdown in the Add New User form.

Change History (5)

#1 follow-up: @DrewAPicture
3 years ago

  • Focuses accessibility added

Do we have reliably accessible methods for using tooltips with contextual help text?

The only tooltips I think I've seen in core are in the image editor, for instance. Input from @afercia here would be useful.

#2 in reply to: ↑ 1 ; follow-up: @afercia
3 years ago

Replying to DrewAPicture:

The only tooltips I think I've seen in core are in the image editor, for instance. Input from @afercia here would be useful.

Right. We've discussed a bit tooltips in the accessibility team and I think I can say we see them as something to (maybe) implement just for UI controls represented with icons. So in this case they would be used just to convey a very short, informative, text about the control purpose. Not to convey a big chunk of text like a Help text. There are ways to build accessible tooltips, see for example the GitHub ones:

https://cldup.com/YeRLlgnhxd.png

I agree the current Help tabs would need some re-thinking :) and maybe a way to programmatically open a specific Help tab.

This ticket was mentioned in Slack in #accessibility by afercia. View the logs.


3 years ago

#4 in reply to: ↑ 2 @SergeyBiryukov
3 years ago

Replying to afercia:

I agree the current Help tabs would need some re-thinking :) and maybe a way to programmatically open a specific Help tab.

Related: #21583

#5 @afercia
3 years ago

  • Focuses accessibility removed

Not sure this specific Role dropdown has an accessibility issue, but I'd agree the Help tab has room for accessibility improvements :) Removing the accessibility focus from this ticket and going to add it on #21583.

Note: See TracTickets for help on using tickets.