Re: Can I make a suggestion for permalinks within the W3C spec docs?

Bryan, you do not need to jump around at all. Just right click on the 
permalink and choose "save link location". jaws+9,a and you are done if 
using Firefox.

I really like the permalinks in the current spec; they are easy to read 
and understand. For example, the label for the permalink for the roles 
model in the referenced draft is:
"Permalink for roles"
And it points to:
http://w3c.github.io/aria/aria/aria.html#roles

The label is very concise.

The one thing that would improve accessibility is to put the permalink 
outside of the heading tag. I hate hearing the permalink announced when 
browsing by heading; it is distracting. 

Matt King
IBM Senior Technical Staff Member
I/T Chief Accessibility Strategist
IBM BT/CIO - Global Workforce and Web Process Enablement 
Phone: (503) 578-2329, Tie line: 731-7398
mattking@us.ibm.com



From:   Shane McCarron <shane@aptest.com>
To:     Bryan Garaventa <bryan.garaventa@ssbbartgroup.com>, 
Cc:     "W3C WAI Protocols & Formats" <public-pfwg@w3.org>
Date:   04/09/2015 04:41 PM
Subject:        Re: Can I make a suggestion for permalinks within the W3C 
spec docs?
Sent by:        ahby@aptest.com



Yes.  In general we try to avoid doing things dynamically in specs once 
they are published.  I will bring this up with the PF Editors

On Thu, Apr 9, 2015 at 5:47 PM, Bryan Garaventa <
bryan.garaventa@ssbbartgroup.com> wrote:
Sorry, correction, was in a hurry… You would need the baseURL within 
aria-label.
 
$(function(){
var baseURL = document.URL.substring(0, document.URL.indexOf('#')) || 
document.URL;
$('css-selector-to-loop-through-all-permalinks').each(function(){
var lbl = $(this).attr('aria-label');
$(this).attr('aria-label', lbl + ': ' + baseURL + this.href);
});
});
 
 
 
Bryan Garaventa
Senior Accessibility Engineer
SSB BART Group, Inc.
bryan.garaventa@ssbbartgroup.com
415.624.2709 (o)
www.SSBBartGroup.com
 
From: Bryan Garaventa [mailto:bryan.garaventa@ssbbartgroup.com] 
Sent: Thursday, April 09, 2015 3:35 PM
To: Shane McCarron
Cc: W3C WAI Protocols & Formats
Subject: RE: Can I make a suggestion for permalinks within the W3C spec 
docs?
 
If you are using jQuery, you could do something like the following when 
the page loads.
 
$(function(){
var baseURL = document.URL.substring(0, document.URL.indexOf('#'));
$('css-selector-to-loop-through-all-permalinks').each(function(){
var lbl = $(this).attr('aria-label');
$(this).attr('aria-label', lbl + ': ' + this.href);
});
});
 
Then the script automatically adds the correct url and the markup stays 
the same?
 
From: ahby@aptest.com [mailto:ahby@aptest.com] On Behalf Of Shane McCarron
Sent: Thursday, April 09, 2015 2:56 PM
To: Bryan Garaventa
Cc: W3C WAI Protocols & Formats
Subject: Re: Can I make a suggestion for permalinks within the W3C spec 
docs?
 
Hmm.  I am not sure we can *know* the URL.  In that any HTML file may have 
fragment IDs, but the full URL is the basic URL of the document # the 
fragment ID.  Since the documents are static, there isn't a good way to 
put the full URL of the permalink into the aria-label.  If there were an 
href="fragmentID" that would of course be expanded automatically into the 
full URL, but I doubt that helps?
 
On Thu, Apr 9, 2015 at 4:51 PM, Bryan Garaventa <
bryan.garaventa@ssbbartgroup.com> wrote:
Thanks, this is the new markup
 
<a title="Permalink for co-evolution" aria-label="Permalink for 
co-evolution" href="#co-evolution" property="url"><span content="1.4 
Co-Evolution of WAI-ARIA and Host Languages" property="title">§</span></a>
 
The name of the link is better than before, instead of it being “#”, it is 
now “Permalink for co-evolution”.
 
I would still suggest adding the url within the aria-label, simply to 
allow access to the address bar content for non-sighted screen reader 
users without having to jump around so much. This wouldn’t have any visual 
impact at all, and would improve accessibility.
 
From: ahby@aptest.com [mailto:ahby@aptest.com] On Behalf Of Shane McCarron
Sent: Thursday, April 09, 2015 2:40 PM
To: Bryan Garaventa
Cc: W3C WAI Protocols & Formats
Subject: Re: Can I make a suggestion for permalinks within the W3C spec 
docs?
 
Can  you examine the permalinks in the current draft?  These are quite 
different than what is in the last ARIA Recommendation.  I am just 
wondering if we are doing a better job now?
 
For example, this is one 
http://w3c.github.io/aria/aria/aria.html#intro_ria_accessibility

 
On Thu, Apr 9, 2015 at 4:17 PM, Bryan Garaventa <
bryan.garaventa@ssbbartgroup.com> wrote:
Hi,
I've been noticing for a while that the permalinks associated with each 
section are only conveyed as "#" in the virtual buffer when arrowing while 
using JAWS, and based on the markup this makes sense given what the naming 
calculation states.

E.G
http://www.w3.org/TR/wai-aria/roles#button


<a title="Permalink for button" href="roles#button">#</a>

Since I use these all the time when writing reports, I have to do all of 
the following steps just to get the correct url plus content:
1. Activate the link, causing the page to reload.
2. Jump to the address bar (Alt+D)
3. Copy the url then jump away (Alt+Tab) to paste it somewhere.
4. Jump back (Alt+Tab) where I am set back on the address bar.
5. Since I have lost my place in the doc, now I need to press Enter on the 
address bar again to reload the page and move back to the referenced 
section.
6. Navigate down into the content and copy the desired quote for copying 
and pasting elsewhere.

It would be helpful if the permalink was included within the accessible 
name for this link, so I wouldn't need to reload the page twice in my 
effort to copy all of the desired content.

As an example, I've included functionality such as this at
http://whatsock.com/training/#hd7

Which I just copied from the virtual buffer and pasted here.

Markup:

<a title="Permalink: http://whatsock.com/training/#hd7" class="permalink" 
aria-label="Permalink: http://whatsock.com/training/#hd7" href="
http://whatsock.com/training/#hd7"><span aria-hidden="true">#</span></a>

Technically it doesn't need the aria-label, but I added this to jump the 
queue in the naming calculation, and aria-hidden prevents the # from 
hijacking the accessible name over title, which is what is happening for 
the W3C permalinks.

This wouldn't require wide scale editing, I just wrote a JavaScript 
function to do this automatically as a permalink generator, but the 
difference in time it takes me to use this type of information would be 
significantly improved by doing something like this within the specs.

Just a suggestion :)


 
-- 
Shane McCarron
Managing Director, Applied Testing and Technology, Inc.


 
-- 
Shane McCarron
Managing Director, Applied Testing and Technology, Inc.



-- 
Shane McCarron
Managing Director, Applied Testing and Technology, Inc.