Skip to content

Commit

Permalink
deploy: 62e5b05
Browse files Browse the repository at this point in the history
  • Loading branch information
MewenLeHo committed Jan 9, 2025
1 parent 9d4e51c commit f48942c
Show file tree
Hide file tree
Showing 295 changed files with 2,049 additions and 2,049 deletions.
2 changes: 1 addition & 1 deletion en/about/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -160,7 +160,7 @@ <h1>About</h1>
<p>Documentation under the <a href="https://github.com/Orange-OpenSource/a11y-guidelines/blob/master/LICENCE">CC BY SA 3.0 licence</a>, source code of this site and examples are available <a href="https://github.com/Orange-OpenSource/a11y-guidelines">on GitHub</a>.</p>
<p>The Orange logo and some images or screenshots are property of Orange:</p>
<p>Copyright (C) 2016 - 2025 Orange SA All rights reserved</p>
<h2 id="cookie-management" class="h2-focus">Cookie management <a class="header-anchor" href="#cookie-management" id="heading-793" aria-labelledby="heading-793">#</a></h2>
<h2 id="cookie-management" class="h2-focus">Cookie management <a class="header-anchor" href="#cookie-management" id="heading-792" aria-labelledby="heading-792">#</a></h2>
<p>You can change your preferences at any time directly from the <a role="button" href="javascript:tarteaucitron.userInterface.openPanel();">Cookie Management Panel</a>.</p>

</main>
Expand Down
2 changes: 1 addition & 1 deletion en/accessibility-user-testing/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -157,7 +157,7 @@

<main id="main-content" class="container-lg pt-4" role="main">
<h1>Orange digital accessibility guidelines</h1>
<h2 id="accessibility-user-testing" class="h2-focus">Accessibility user testing <a class="header-anchor" href="#accessibility-user-testing" id="heading-794" aria-labelledby="heading-794">#</a></h2>
<h2 id="accessibility-user-testing" class="h2-focus">Accessibility user testing <a class="header-anchor" href="#accessibility-user-testing" id="heading-791" aria-labelledby="heading-791">#</a></h2>
<p>In order to evaluate the accessibility of a site, application, or product, accessibility experts conduct audits with the objective to check their compliance against standard or best practices rules (<abbr>WCAG</abbr> 2.1 Level AA for web).</p>
<p>Once the application is compliant or mostly compliant with guidelines, experts can complete their audit with tests performed by users with disabilities.</p>
<p>In ergonomics: «User testing is the main method for evaluating the user experience in an iterative process. The evaluation relies on the observation of users performing a set of tasks while interacting with a system. Data collected regarding their behavior, reactions and performances provide information about strengths and weaknesses of the evaluated system, as well as about the experience of users.» (translated from <a href="http://tecfaetu.unige.ch/etu-maltt/xerneas/jaquiet7/tests_utilisateurs_(Lallemand2016).pdf" title="Méthodes de design UX (french PDF file)" aria-label="Méthodes de design UX (french PDF file)">Méthodes de design UX</a>. Carine Lallemand &amp; Guillaume Gronier. Eyrolles, 2016).<br>
Expand Down
30 changes: 15 additions & 15 deletions en/articles/accessible-table/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -186,29 +186,29 @@ <h1>Tables in accessibility</h1>
<time class="text-muted" datetime="2022-04-15T00:00:00.000Z">April 15, 2022</time>

<div class="mt-4">
<h2 id="general-presentation" class="h2-focus">General presentation <a class="header-anchor" href="#general-presentation" id="heading-8" aria-labelledby="heading-8">#</a></h2>
<h2 id="general-presentation" class="h2-focus">General presentation <a class="header-anchor" href="#general-presentation" id="heading-13" aria-labelledby="heading-13">#</a></h2>
<p>A table is an arrangement of information in rows and columns containing cells that make it easy to compare and highlight information. They allow tabular information to be presented in a two-dimensional grid, such data is easier to read in tabular form.</p>
<p>This allows a user, who does not have a vision problem, to quickly make visual associations between table data and its table headings.</p>
<p>However, a blind user will not have access to all these relations between the information, it's the reason why it is important that the tables are implemented with the appropriate HTML markup so that they are the most accessible possible for assistive technologies.</p>
<p>In the rest of this article, we will see the main rules to follow to obtain an accessible table.</p>
<h3 id="add-a-captiontitle-to-your-table">Add a caption/title to your table <a class="header-anchor" href="#add-a-captiontitle-to-your-table" id="heading-9" aria-labelledby="heading-9">#</a></h3>
<h3 id="add-a-captiontitle-to-your-table">Add a caption/title to your table <a class="header-anchor" href="#add-a-captiontitle-to-your-table" id="heading-14" aria-labelledby="heading-14">#</a></h3>
<p>It is important to define a title for your table. Concise and relevant, this text will indicate its content as well as the type of data it contains.<br>
It must be associated with the table using the <code>caption</code> element and must be the first element after the opening <code>table</code> tag. You can also use a <code>h1,h2...</code> title placed in the code just before the table as another way to associate a title.</p>
<h4 id="example-caption">Example <code>caption</code> <a class="header-anchor" href="#example-caption" id="heading-10" aria-labelledby="heading-10">#</a></h4>
<h4 id="example-caption">Example <code>caption</code> <a class="header-anchor" href="#example-caption" id="heading-15" aria-labelledby="heading-15">#</a></h4>
<pre><code class="html">
&lt;table&gt;
&lt;caption&gt;Time planning 2022&lt;/caption&gt;
[...]
&lt;/table&gt;
</code></pre>
<h4 id="example-html-title">Example HTML title <a class="header-anchor" href="#example-html-title" id="heading-11" aria-labelledby="heading-11">#</a></h4>
<h4 id="example-html-title">Example HTML title <a class="header-anchor" href="#example-html-title" id="heading-16" aria-labelledby="heading-16">#</a></h4>
<pre><code class="html">
&lt;h2&gt;Time planning 2022&lt;/h2&gt;
&lt;table&gt;
[...]
&lt;/table&gt;
</code></pre>
<h3 id="add-a-description-for-complex-table">Add a description for complex table <a class="header-anchor" href="#add-a-description-for-complex-table" id="heading-12" aria-labelledby="heading-12">#</a></h3>
<h3 id="add-a-description-for-complex-table">Add a description for complex table <a class="header-anchor" href="#add-a-description-for-complex-table" id="heading-17" aria-labelledby="heading-17">#</a></h3>
<p>If you have a complex table and want to provide a more detailed summary, it is recommended to use the ARIA <code>aria-describedby</code> attribute.<br>
It will programmatically link a description to your table.</p>
<pre><code class="html">
Expand All @@ -222,8 +222,8 @@ <h3 id="add-a-description-for-complex-table">Add a description for complex table
&lt;/table&gt;
</code></pre>
<p>There is also the possibility of using the <code>summary</code> attribute to give, in addition, a summary of the contents of a table, however this attribute is no longer part of the HTML 5 specifications and we do not recommend its use.</p>
<h3 id="identify-your-table-headers">Identify your table headers <a class="header-anchor" href="#identify-your-table-headers" id="heading-13" aria-labelledby="heading-13">#</a></h3>
<h4 id="scope-attribute">Scope attribute <a class="header-anchor" href="#scope-attribute" id="heading-14" aria-labelledby="heading-14">#</a></h4>
<h3 id="identify-your-table-headers">Identify your table headers <a class="header-anchor" href="#identify-your-table-headers" id="heading-18" aria-labelledby="heading-18">#</a></h3>
<h4 id="scope-attribute">Scope attribute <a class="header-anchor" href="#scope-attribute" id="heading-19" aria-labelledby="heading-19">#</a></h4>
<p>To help assistive technology users, you must identify table headings, whether for rows or columns.<br>
To identify these table headers, you must use the <code>th</code> tag, which must never be empty.</p>
<p>Once the headers are created, the data cells must be associated with the headers on which they rely.<br>
Expand All @@ -232,7 +232,7 @@ <h4 id="scope-attribute">Scope attribute <a class="header-anchor" href="#scope-a
<li><code>&lt;th scope="col"&gt;</code> for a column header</li>
<li><code>&lt;th scope="row"&gt;</code> for a row header</li>
</ul>
<h4 id="id-and-header-attributes">Id and header attributes <a class="header-anchor" href="#id-and-header-attributes" id="heading-15" aria-labelledby="heading-15">#</a></h4>
<h4 id="id-and-header-attributes">Id and header attributes <a class="header-anchor" href="#id-and-header-attributes" id="heading-20" aria-labelledby="heading-20">#</a></h4>
<p>Some tables are too complex to identify a strict horizontal or vertical association (for example, merged columns or rows) between the header and the data cells.<br>
The <code>scope</code> attribute does not solve this problem. A unique <code>id</code> attribute must be used for each header cell. To link this header to a cell, you must use the <code>headers</code> attribute and adding the required <code>id</code>.</p>
<p>For example, we have two header cells, <code>&lt;th id=&quot;toto&quot;&gt;Toto&lt;/th&gt;</code> and <code>&lt;th id=&quot;tata&quot;&gt;Tata&lt;/ th&gt;</code>, the code to link it to a data cell will be <code>&lt;td headers=&quot;toto tata&quot;&gt;Tota&lt;/td&gt;</code>.</p>
Expand All @@ -241,16 +241,16 @@ <h4 id="id-and-header-attributes">Id and header attributes <a class="header-anch
<li>The table has column/row headings that change within the table.</li>
<li>A data cell with three or more related headers (often linked to header cells that are merged)</li>
</ul>
<h3 id="navigating-a-table-using-nvda-or-jaws">Navigating a table using NVDA or JAWS <a class="header-anchor" href="#navigating-a-table-using-nvda-or-jaws" id="heading-16" aria-labelledby="heading-16">#</a></h3>
<h3 id="navigating-a-table-using-nvda-or-jaws">Navigating a table using NVDA or JAWS <a class="header-anchor" href="#navigating-a-table-using-nvda-or-jaws" id="heading-21" aria-labelledby="heading-21">#</a></h3>
<p>Creating accessible tables will allow consistent reading of these tabular data with a screen reader. To navigate in a table with Jaws or NVDA, there are several specific shortcuts.</p>
<h4 id="nvda">NVDA <a class="header-anchor" href="#nvda" id="heading-17" aria-labelledby="heading-17">#</a></h4>
<h4 id="nvda">NVDA <a class="header-anchor" href="#nvda" id="heading-22" aria-labelledby="heading-22">#</a></h4>
<p>To quickly navigate from table to table in a page, just use the <kbd>t</kbd> key, if you use the <kbd>Shift + t</kbd> shortcut, you navigate in the opposite direction and so we return to the previous table.</p>
<p>Once inside a table, there are several shortcuts to move around easily.</p>
<ul>
<li><kbd>Ctrl + alt + left arrow</kbd> moves to the left column while keeping the same line, <kbd>Ctrl + alt + right arrow</kbd> moves to the column right.</li>
<li><kbd>Ctrl + alt + down arrow</kbd> moves to the next line while staying on the same column, <kbd>Ctrl + alt + up arrow</kbd> moves to the previous line. </li>
</ul>
<h4 id="jaws">Jaws <a class="header-anchor" href="#jaws" id="heading-18" aria-labelledby="heading-18">#</a></h4>
<h4 id="jaws">Jaws <a class="header-anchor" href="#jaws" id="heading-23" aria-labelledby="heading-23">#</a></h4>
<p>For Jaws, you have to use the <kbd>Y</kbd> key and <kbd>Shift + Y</kbd> to navigate between tables.<br>
To browse in tables, there are several shortcuts:</p>
<ul>
Expand All @@ -260,9 +260,9 @@ <h4 id="jaws">Jaws <a class="header-anchor" href="#jaws" id="heading-18" aria-la
<li><kbd>Insert + shift + up arrow</kbd> reads the entire line.</li>
<li><kbd>Insert + shift + num pad 5</kbd> reads the entire column.</li>
</ul>
<h2 id="table-example" class="h2-focus">Table example <a class="header-anchor" href="#table-example" id="heading-19" aria-labelledby="heading-19">#</a></h2>
<h2 id="table-example" class="h2-focus">Table example <a class="header-anchor" href="#table-example" id="heading-24" aria-labelledby="heading-24">#</a></h2>
<p>We will now show you examples of accessible tables.</p>
<h3 id="simple-table">Simple table <a class="header-anchor" href="#simple-table" id="heading-20" aria-labelledby="heading-20">#</a></h3>
<h3 id="simple-table">Simple table <a class="header-anchor" href="#simple-table" id="heading-25" aria-labelledby="heading-25">#</a></h3>
<p>The first example is a table with only headers on the columns, so we use the <code>scope=&quot;row&quot;</code> attribute for assistive technologies to interpret it correctly.</p>
<table class="table">
<caption class="h4">People with their professional activity</caption>
Expand Down Expand Up @@ -322,7 +322,7 @@ <h3 id="simple-table">Simple table <a class="header-anchor" href="#simple-table"
</code></pre>
<p>Like this, it is possible to easily navigate within the table using a screen reader. Also, any cell change from one column, or row, to another, the header will be vocalized.</p>
<p>For example, if we are positioned on the First name column, and we use the shortcut <kbd>Ctrl+alt+right arrow</kbd> to go to the Last name column, NVDA vocalizes &quot;Last Name Column 2 + column text &quot;.</p>
<h3 id="tables-with-two-headers">Tables with Two Headers <a class="header-anchor" href="#tables-with-two-headers" id="heading-21" aria-labelledby="heading-21">#</a></h3>
<h3 id="tables-with-two-headers">Tables with Two Headers <a class="header-anchor" href="#tables-with-two-headers" id="heading-26" aria-labelledby="heading-26">#</a></h3>
<p>In this second example, the table is a planning time allowing you to quickly know whether the store is open or not, depending on the day of the week and the time.</p>
<p>This table requires two headers, one for the days of the week and another for the time slot.</p>
<table class="table">
Expand Down Expand Up @@ -388,7 +388,7 @@ <h3 id="tables-with-two-headers">Tables with Two Headers <a class="header-anchor
&lt;/tr&gt;
[...]
</code></pre>
<h3 id="complex-table">Complex table <a class="header-anchor" href="#complex-table" id="heading-22" aria-labelledby="heading-22">#</a></h3>
<h3 id="complex-table">Complex table <a class="header-anchor" href="#complex-table" id="heading-27" aria-labelledby="heading-27">#</a></h3>
<p>In this example, some given cells have three associated headers, so we have to use the <code>id</code> and <code>headers</code> attributes.</p>
<p>Since the table is complex, we can add a description to help users understand the table.</p>
<p class="border-top border-light" id="tblDesc">Tables for calculating the compliance rate of a website.<br/>
Expand Down
Loading

0 comments on commit f48942c

Please sign in to comment.