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.

Sign up for GitHub

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

initial draft for role="generic" issue #699 #805

Merged
merged 9 commits into from
Jul 24, 2019
Merged

initial draft for role="generic" issue #699 #805

Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
1f2dcec
generic role (without aria-textseparation)
carmacleod Jun 12, 2019
9e12247
- split intro sentence into 2 sentences
carmacleod Jun 27, 2019
5466773
Add HTML before "Custom Elements"
carmacleod Jun 27, 2019
25fec15
Delete "superclass"
carmacleod Jun 28, 2019
3e4b951
Simplify note
carmacleod Jul 18, 2019
c926215
Differentiate from presentation
carmacleod Jul 18, 2019
5649673
Uncomment "Prohibited States and Properties" in table
carmacleod Jul 18, 2019
d970423
Remove "note" and use normative SHOULD NOT
carmacleod Jul 19, 2019
3e48334
remove aria-hidden (i.e. doesn't differentiate from role presentation)
carmacleod Jul 19, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 92 additions & 1 deletion index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -672,7 +672,7 @@ <h3>Widget Roles</h3>
</ul>
</section>
<section id="document_structure_roles">
<h3>Document Structure</h3>
<h3>Document Structure Roles</h3>
<p>The following <a>roles</a> describe structures that organize content in a page. Document structures are not usually interactive.</p>
<ul>
<li><rref>application</rref></li>
Expand All @@ -691,6 +691,7 @@ <h3>Document Structure</h3>
<li><rref>emphasis</rref></li>
<li><rref>feed</rref></li>
<li><rref>figure</rref></li>
<li><rref>generic</rref></li>
<li><rref>group</rref></li>
<li><rref>heading</rref></li>
<li><rref>img</rref></li>
Expand Down Expand Up @@ -3270,6 +3271,96 @@ <h2>Definition of Roles</h2>
</tbody>
</table>
</div>
<div class="role" id="generic">
<rdef>generic</rdef>
<div class="role-description">
<p>A nameless container <a>element</a> that has no semantic meaning on its own.</p>
<p>Contrast with <rref>group</rref>, which semantically groups its descendants in a named container.</p>
<p>A <code>generic</code> can provide a limited number of accessible states and properties for its descendants, such as <pref>aria-live</pref> attributes. This differentiates it from the <rref>presentation</rref> role.</p>
<p>The <code>generic</code> role is intended for implementors of User Agents. Authors SHOULD NOT use this role in content.</p>
<p class="ednote">A triage of global properties is pending. This will reduce the number of inherited states and properties in the characteristics table below. For details, see <a href="https://github.com/w3c/aria/issues/999">issue #999</a>.</p>
</div>
<table class="role-features">
<caption>Characteristics:</caption>
<thead>
<tr>
<th scope="col">Characteristic</th>
<th scope="col">Value</th>
</tr>
</thead>
<tbody>
<tr>
<th class="role-abstract-head" scope="row">Is Abstract:</th>
<td class="role-abstract"> </td>
</tr>
<tr>
<th class="role-parent-head" scope="row">Superclass Role:</th>
<td class="role-parent"><rref>structure</rref></td>
</tr>
<tr>
<th class="role-children-head" scope="row">Subclass Roles:</th>
<td class="role-children">Placeholder</td>
</tr>
<tr>
<th class="role-base-head" scope="row">Base Concept:</th>
<td class="role-base"> </td>
</tr>
<tr>
<th class="role-related-head" scope="row">Related Concepts:</th>
<td class="role-related"><a href="https://www.w3.org/TR/html/grouping-content.html#the-div-element"><abbr title="Hypertext Markup Language">HTML</abbr> <code>div</code></a>, <a href="https://www.w3.org/TR/html/textlevel-semantics.html#the-span-element"><abbr title="Hypertext Markup Language">HTML</abbr> <code>span</code></a></td>
</tr>
<tr>
<th class="role-scope-head" scope="row">Required Context Role:</th>
<td class="role-scope"> </td>
</tr>
<tr>
<th class="role-mustcontain-head" scope="row">Required Owned Elements:</th>
<td class="role-mustcontain"> </td>
</tr>
<tr>
<th class="role-required-properties-head">Required States and Properties:</th>
<td class="role-required-properties"> </td>
</tr>
<tr>
<th class="role-properties-head" scope="row">Supported States and Properties:</th>
<td class="role-properties"> </td>
</tr>
<tr>
<th class="role-inherited-head" scope="row">Inherited States and Properties:</th>
<td class="role-inherited">Placeholder</td>
carmacleod marked this conversation as resolved.
Show resolved Hide resolved
</tr>
<tr>
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
<td class="role-disallowed">
<ul>
<li><pref>aria-label</pref></li>
<li><pref>aria-labelledby</pref></li>
</ul>
</td>
</tr>
<tr>
<th class="role-namefrom-head" scope="row">Name From:</th>
<td class="role-namefrom">prohibited</td>
</tr>
<tr>
<th class="role-namerequired-head" scope="row">Accessible Name Required:</th>
<td class="role-namerequired"> </td>
</tr>
<tr>
<th class="role-namerequired-inherited-head" scope="row">Inherits Name Required:</th>
<td class="role-namerequired-inherited"> </td>
</tr>
<tr>
<th class="role-childpresentational-head" scope="row">Children Presentational:</th>
<td class="role-childpresentational"> </td>
</tr>
<tr>
<th class="role-presentational-inherited-head" scope="row">Inherits Presentational:</th>
<td class="role-presentational-inherited"> </td>
</tr>
</tbody>
</table>
</div>
<div class="role" id="grid">
<rdef>grid</rdef>
<div class="role-description">
Expand Down