-
Notifications
You must be signed in to change notification settings - Fork 29
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
Editorial for "More details" in collapsible Head #266
Comments
One could consider it as reading "More details (in addition to the title / status / date) below"? :) I think SUMMARY is intended to represent the contents of the DETAILS, not be an action button label, so I would prefer to keep it as something that works similar to a heading... |
We're currently using “More details about this document” which I think works okay. @koalie what do you think, is it okay or do you think we can do better? :) |
I personally continue to be fooled into thinking there is more to reveal, by a summary that reads "More details" both in expanded and collapsed states. (Think about USB-A where I get to plug it 3 times almost all of the times. It's a similar UX for me.) Good point about the semantics of summary/details; I had never thought about that. For me it probably has to do with the arrow icons next to "summary". I think the arrows give me the sense of an action button. Perhaps it would not, if it were "+"/"-". Also, if I am the only one in over 15 months who said anything about it, it probably is your cue that it's okay as is. Thanks for circling back! Feel free to close the issue as WONTFIX. |
Feel free to reopen in new ideas come up. |
I also think this is a bit strange, and several people in another thread feel the same way. However, if most people think this is okay, I won't insist. When I translate specifications into other languages, I usually don't translate this phrase literally, but use phrases like "About this document". |
I have a couple of concrete suggestions to fix this:
Thanks! |
Updating the summary text should be fairly easy. However, changing the default detail/summary marker could result in some accessibility issue as described in a blog post from @scottaohara |
I chatted recently on social media about this (or rather, watched as experts took the ball and ran with it) and Eric Eggert confirmed that for the WAI subsite, these considerations had been taken into account. I looked and found a different way to show "+"/"-" next to each other and the other one being striked-through even, for example in this article, if you want to see how it's done. |
In the p2021 mockups, I love the collapsible Head but I'm bothered by the fact that '"More details" about this document' reads "More details" both when the block is expanded and collapsed (given that it cleverly uses the last state chosen in browser.)
Unless as Denis suggests (in IRC) there's an easy way to update the wording depending on the state with javascript, I suggest to use "Toggle" instead of "More details", so that it's agnostic of the state.
The proposed snippet is:
<summary>Toggle details about this document</summary>
The text was updated successfully, but these errors were encountered: