Thanks Alex! I have made some updates to the spec text in response to your feedback, I have also added other content.
http://stevefaulkner.github.io/webcomponents/spec/custom/#semantics please review, thanks! -- Regards SteveF HTML 5.1 <http://www.w3.org/html/wg/drafts/html/master/> On 9 December 2014 at 17:29, Alexander Surkov <surkov.alexan...@gmail.com> wrote: > > Hi. Some feedback per Steve's request on WAI group. > > * "but for the semantics to be formally expressed, developers must convey > the role, states and properties of the element to browser APIs." It's not > clear what role, states and properties is. It'd be good to develop this > sentence by mentioning ARIA techniques. Also it might be not clear what > browser APIs are. Perhaps I wouldn't even mention a11y APIs since this info > is rather for browser developers and may sound confusing for web authors. > > * I don't think that any focusable element should get its name from its > subtree. For example, tree control name is not a concatenation of subtrees > of its item. I think role should define whether the element should grab its > name from the subtree or not. > > <taco-button tabindex="0">Eat Me</taco-button> > > * "The addition of a tabindex > <http://www.w3.org/TR/html/editing.html#attr-tabindex> attribute to the > *taco-button* element" > > I think taco-button should be left for examples, but all rules should be > worded in generic terms. For example, the sentence above would be "The > addition of tabindex attribute to the custom element" and then give a > markup example for taco-button. > > * "The addition of keyboard event handlers to the *taco-button* element > provides the means for keyboard users to operate the control, but does not > convey the presence of the functionality." > > I think I miss the idea of this sentence because the topic is about > semantics of custom elements and thus it's not clear with me where > functionality is supposed to be here. > > * "The addition of an ARIA role="button" > <http://rawgit.com/w3c/aria/master/aria/aria.html#button> conveys the > *taco-button* element's role semantics" > > It'd be good to generalize it and give this sentence as an example. It'd > be good to mention other ARIA button related attributes. > > Thanks. > Alexander. > > > On Tue, Dec 9, 2014 at 4:23 AM, Steve Faulkner <faulkner.st...@gmail.com> > wrote: > >> Hi PF! >> >> FYI >> >> I have been getting some accessibility related content into the custom >> elements spec >> >> http://w3c.github.io/webcomponents/spec/custom/#semantics >> >> please provide feedback on bug >> https://www.w3.org/Bugs/Public/enter_bug.cgi?comment=&blocked=14968&short_desc=[Custom]%3A%20&product=WebAppsWG&component=Component%20Model >> >> or to webapps list http://lists.w3.org/Archives/Public/public-webapps/ >> -- >> >> Regards >> >> SteveF >> HTML 5.1 <http://www.w3.org/html/wg/drafts/html/master/> >> > >