Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Accordion Example: Roles, States, and Properties table incorrectly says the header control uses an <a> element #475

Closed
pudgereyem opened this issue Oct 11, 2017 · 4 comments
Labels
Example Page Related to a page containing an example implementation of a pattern Feedback Issue raised by or for collecting input from people outside APG task force

Comments

@pudgereyem
Copy link
Contributor

DISCLAIMER
This is my first contact with this repository. Please correct me if I'm missunderstanding stuff. :)
It would be nice to contribute, and this seems like a good start.

Issue

The Accordion Example uses <button/>, but the documentation tells us that it uses an <a/> (anchor) element

Solution

Change the Documentation in https://github.com/w3c/aria-practices/blob/master/examples/accordion/accordion.html to use <button> instead of <a>.

I would like to open up a PR for this, but please answer to this issue if you'd like.

Background / Discussion

I looked through the activity in this github project to understand the current status. Below is what I found. I wrote this down for myself to get a bit of context.

@mcking65
Copy link
Contributor

@pudgereyem commented:

This is my first contact with this repository. Please correct me if I'm missunderstanding stuff. :)
It would be nice to contribute, and this seems like a good start.

Victor, thank you for both catching this error and offering to help!!

I haven't put this in the readme yet, but it is a good idea to raise an issue or comment in an issue, as you did, before going through the work of changing code and submitting a PR. That will help ensure you aren't working on something that someone else is already in the process of changing. It can also make sure that your fix is aligned with the spec, task force objectives, etc.

That said, if you see anything in our current milestone
that might interest you, please comment in the issue and say so!

The Accordion Example uses   , but the documentation tells us that it uses an    (anchor) element.

Excellent catch!

@mcking65 mcking65 added Example Page Related to a page containing an example implementation of a pattern documentation Feedback Issue raised by or for collecting input from people outside APG task force labels Oct 11, 2017
@mcking65 mcking65 added this to the 3Q17 Working Draft milestone Oct 11, 2017
@mcking65 mcking65 changed the title Accordion Example: Update Documentation Accordion Example: Roles, States, and Properties table incorrectly says the header control uses an <a> element Oct 11, 2017
@pudgereyem
Copy link
Contributor Author

Hey @mcking65, thanks for the warm welcome!

I will definitely check out https://github.com/w3c/aria-practices/milestone/6, and see if I can be of any help. I'm not that "experienced" with a11y, so contributing to this project would be a great learning experience for me.

Cheers!

mcking65 pushed a commit that referenced this issue Oct 11, 2017
…k (pull #477)

For issue #475, fix the roles, states, and properties table of the accordion example page.
Remove row for the button role on the `<a>` element and change the element column to button for the attributes applied to the button.
@mcking65
Copy link
Contributor

Fixed with 424facf. Thank you @pudgereyem!

@pudgereyem
Copy link
Contributor Author

@mcking65 I'm using this issue to ask two questions.

  1. When using the Accordion Example, I don't experience the expected behaviour of Control + Page Down and Control + Page Up in Chrome. What happens is that it switches to the Next / Previous Tab in Chrome instead. It works in Safari. Nothing happens in Firefox for me. What should I make of this? What browser is best to test my work on?

  2. The other question is a bit noobish, maybe I should find this information by googling. What "command" would someone using a screen reader use, if he or she would like to read the text in a panel that he or she just opened?

Cheers!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Example Page Related to a page containing an example implementation of a pattern Feedback Issue raised by or for collecting input from people outside APG task force
Development

No branches or pull requests

2 participants