Skip to content

Commit 23d6d0b

Browse files
committed
deploy: 5aa1796
1 parent 6afa0b2 commit 23d6d0b

File tree

335 files changed

+3256
-2438
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

335 files changed

+3256
-2438
lines changed

en/about/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -160,7 +160,7 @@ <h1>About</h1>
160160
<p>Documentation under the <a href="https://github.com/Orange-OpenSource/a11y-guidelines/blob/master/LICENSE">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>
161161
<p>The Orange logo and some images or screenshots are property of Orange:</p>
162162
<p>Copyright (C) 2016 - 2025 Orange SA All rights reserved</p>
163-
<h2 id="cookie-management" class="h2-focus">Cookie management <a class="header-anchor" href="#cookie-management" id="heading-895" aria-labelledby="heading-895">#</a></h2>
163+
<h2 id="cookie-management" class="h2-focus">Cookie management <a class="header-anchor" href="#cookie-management" id="heading-896" aria-labelledby="heading-896">#</a></h2>
164164
<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>
165165

166166
</main>

en/accessibility-user-testing/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -157,7 +157,7 @@
157157

158158
<main id="main-content" class="container-lg pt-4" role="main">
159159
<h1>Orange digital accessibility guidelines</h1>
160-
<h2 id="accessibility-user-testing" class="h2-focus">Accessibility user testing <a class="header-anchor" href="#accessibility-user-testing" id="heading-896" aria-labelledby="heading-896">#</a></h2>
160+
<h2 id="accessibility-user-testing" class="h2-focus">Accessibility user testing <a class="header-anchor" href="#accessibility-user-testing" id="heading-895" aria-labelledby="heading-895">#</a></h2>
161161
<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>
162162
<p>Once the application is compliant or mostly compliant with guidelines, experts can complete their audit with tests performed by users with disabilities.</p>
163163
<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>

en/articles/accessible-svg/index.html

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -205,21 +205,21 @@ <h1>SVG images accessibility</h1>
205205
<div class="mt-4">
206206
<p>Here are some ideas knowing that the support for browsers and assistive technologies evolves very quickly.</p>
207207
<p>Important: Whatever solution is chosen, as browser support and assistive technologies evolve rapidly, make sure to test your implementations on the configurations most commonly used by your users.</p>
208-
<h2 id="decorative-image" class="h2-focus">Decorative image <a class="header-anchor" href="#decorative-image" id="heading-30" aria-labelledby="heading-30">#</a></h2>
209-
<h3 id="svg-in-an-img-tag">SVG in an <code>img</code> tag <a class="header-anchor" href="#svg-in-an-img-tag" id="heading-31" aria-labelledby="heading-31">#</a></h3>
208+
<h2 id="decorative-image" class="h2-focus">Decorative image <a class="header-anchor" href="#decorative-image" id="heading-15" aria-labelledby="heading-15">#</a></h2>
209+
<h3 id="svg-in-an-img-tag">SVG in an <code>img</code> tag <a class="header-anchor" href="#svg-in-an-img-tag" id="heading-16" aria-labelledby="heading-16">#</a></h3>
210210
<pre><code class="html" title="html">
211211
&lt;img src="XXX.svg" alt="" aria-hidden="true" /&gt;
212212
</code></pre>
213-
<h3 id="inline-svg">Inline SVG <a class="header-anchor" href="#inline-svg" id="heading-32" aria-labelledby="heading-32">#</a></h3>
213+
<h3 id="inline-svg">Inline SVG <a class="header-anchor" href="#inline-svg" id="heading-17" aria-labelledby="heading-17">#</a></h3>
214214
<pre><code class="html" title="html">
215215
&lt;svg aria-hidden="true"&gt;
216216
217217
&lt;/svg&gt;
218218
</code></pre>
219219
<p>In addition, you must make sure that the <code>svg</code> tag or one of its children (<code>&lt;g&gt;</code>,<code>&lt;path&gt;</code>...) does not have any attribute to provide it with an accessible name (<code>title</code>, <code>desc</code>, <code>aria- *</code>, …).</p>
220220
<p>Note: Historically, the <code>focusable=&quot;false&quot;</code> attribute was also required to prevent any focus on the SVG by Internet Explorer and Edge (before Chromium). This is no longer necessary in current browsers (unless your users are still using the older mentioned browsers).</p>
221-
<h2 id="informative-image-without-link-or-button" class="h2-focus">Informative image (without link or button) <a class="header-anchor" href="#informative-image-without-link-or-button" id="heading-33" aria-labelledby="heading-33">#</a></h2>
222-
<h3 id="svg-in-an-img-tag-2">SVG in an <code>img</code> tag <a class="header-anchor" href="#svg-in-an-img-tag-2" id="heading-34" aria-labelledby="heading-34">#</a></h3>
221+
<h2 id="informative-image-without-link-or-button" class="h2-focus">Informative image (without link or button) <a class="header-anchor" href="#informative-image-without-link-or-button" id="heading-18" aria-labelledby="heading-18">#</a></h2>
222+
<h3 id="svg-in-an-img-tag-2">SVG in an <code>img</code> tag <a class="header-anchor" href="#svg-in-an-img-tag-2" id="heading-19" aria-labelledby="heading-19">#</a></h3>
223223
<p>The most effective solution is to use the <code>alt</code> attribute:</p>
224224
<pre><code class="html" title="html">
225225
&lt;img src="XXX.svg" role="img" alt="replacement text"&gt;
@@ -234,7 +234,7 @@ <h3 id="svg-in-an-img-tag-2">SVG in an <code>img</code> tag <a class="header-anc
234234
&lt;img src="XXX.svg" role="img" aria-labelledby="alt-text"&gt;
235235
</code></pre>
236236
<p>Note: Add <code>role=&quot;img&quot;</code> to ensure that the element is properly recognized as an image by assistive technologies.</p>
237-
<h3 id="inline-svg-2">Inline SVG <a class="header-anchor" href="#inline-svg-2" id="heading-35" aria-labelledby="heading-35">#</a></h3>
237+
<h3 id="inline-svg-2">Inline SVG <a class="header-anchor" href="#inline-svg-2" id="heading-20" aria-labelledby="heading-20">#</a></h3>
238238
<p>The best support for SVG is inline display (<code>&lt;svg&gt;</code> tag).</p>
239239
<pre><code class="html" title="html">
240240
&lt;svg role="img"&gt;
@@ -272,7 +272,7 @@ <h3 id="inline-svg-2">Inline SVG <a class="header-anchor" href="#inline-svg-2" i
272272
...
273273
&lt;/svg&gt;
274274
</code></pre>
275-
<h2 id="svg-in-links-or-buttons" class="h2-focus">SVG in links or buttons <a class="header-anchor" href="#svg-in-links-or-buttons" id="heading-36" aria-labelledby="heading-36">#</a></h2>
275+
<h2 id="svg-in-links-or-buttons" class="h2-focus">SVG in links or buttons <a class="header-anchor" href="#svg-in-links-or-buttons" id="heading-21" aria-labelledby="heading-21">#</a></h2>
276276
<p>If it is possible to display text nearby, the best solution is to simply hide the SVG using the <code>aria-hidden</code> attribute:</p>
277277
<pre><code class="html" title="html">
278278
&lt;button&gt;
@@ -319,9 +319,9 @@ <h2 id="svg-in-links-or-buttons" class="h2-focus">SVG in links or buttons <a cla
319319
&lt;svg aria-hidden="true"&gt;&lt;!--...--&gt;&lt;/svg&gt;
320320
&lt;/a&gt;
321321
</code></pre>
322-
<h2 id="last-words" class="h2-focus">Last words ... <a class="header-anchor" href="#last-words" id="heading-37" aria-labelledby="heading-37">#</a></h2>
322+
<h2 id="last-words" class="h2-focus">Last words ... <a class="header-anchor" href="#last-words" id="heading-22" aria-labelledby="heading-22">#</a></h2>
323323
<p>In short, one tip for accessible SVG would be TEST and test again!</p>
324-
<h2 id="webography-articles-that-have-helped-me-a-lot" class="h2-focus">Webography (articles that have helped me a lot) <a class="header-anchor" href="#webography-articles-that-have-helped-me-a-lot" id="heading-38" aria-labelledby="heading-38">#</a></h2>
324+
<h2 id="webography-articles-that-have-helped-me-a-lot" class="h2-focus">Webography (articles that have helped me a lot) <a class="header-anchor" href="#webography-articles-that-have-helped-me-a-lot" id="heading-23" aria-labelledby="heading-23">#</a></h2>
325325
<ul>
326326
<li><a href="https://www.deque.com/blog/creating-accessible-svgs/">Creating Accessible SVGs - Deque</a></li>
327327
<li><a href="https://weboverhauls.github.io/demos/svg/">Accessible SVG test page</a></li>

en/articles/accessible-table/index.html

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -196,29 +196,29 @@ <h1>Tables in accessibility</h1>
196196

197197

198198
<div class="mt-4">
199-
<h2 id="general-presentation" class="h2-focus">General presentation <a class="header-anchor" href="#general-presentation" id="heading-15" aria-labelledby="heading-15">#</a></h2>
199+
<h2 id="general-presentation" class="h2-focus">General presentation <a class="header-anchor" href="#general-presentation" id="heading-24" aria-labelledby="heading-24">#</a></h2>
200200
<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>
201201
<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>
202202
<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>
203203
<p>In the rest of this article, we will see the main rules to follow to obtain an accessible table.</p>
204-
<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-16" aria-labelledby="heading-16">#</a></h3>
204+
<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-25" aria-labelledby="heading-25">#</a></h3>
205205
<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>
206206
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>
207-
<h4 id="example-caption">Example <code>caption</code> <a class="header-anchor" href="#example-caption" id="heading-17" aria-labelledby="heading-17">#</a></h4>
207+
<h4 id="example-caption">Example <code>caption</code> <a class="header-anchor" href="#example-caption" id="heading-26" aria-labelledby="heading-26">#</a></h4>
208208
<pre><code class="html">
209209
&lt;table&gt;
210210
&lt;caption&gt;Time planning 2022&lt;/caption&gt;
211211
[...]
212212
&lt;/table&gt;
213213
</code></pre>
214-
<h4 id="example-html-title">Example HTML title <a class="header-anchor" href="#example-html-title" id="heading-18" aria-labelledby="heading-18">#</a></h4>
214+
<h4 id="example-html-title">Example HTML title <a class="header-anchor" href="#example-html-title" id="heading-27" aria-labelledby="heading-27">#</a></h4>
215215
<pre><code class="html">
216216
&lt;h2&gt;Time planning 2022&lt;/h2&gt;
217217
&lt;table&gt;
218218
[...]
219219
&lt;/table&gt;
220220
</code></pre>
221-
<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-19" aria-labelledby="heading-19">#</a></h3>
221+
<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-28" aria-labelledby="heading-28">#</a></h3>
222222
<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>
223223
It will programmatically link a description to your table.</p>
224224
<pre><code class="html">
@@ -232,8 +232,8 @@ <h3 id="add-a-description-for-complex-table">Add a description for complex table
232232
&lt;/table&gt;
233233
</code></pre>
234234
<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>
235-
<h3 id="identify-your-table-headers">Identify your table headers <a class="header-anchor" href="#identify-your-table-headers" id="heading-20" aria-labelledby="heading-20">#</a></h3>
236-
<h4 id="scope-attribute">Scope attribute <a class="header-anchor" href="#scope-attribute" id="heading-21" aria-labelledby="heading-21">#</a></h4>
235+
<h3 id="identify-your-table-headers">Identify your table headers <a class="header-anchor" href="#identify-your-table-headers" id="heading-29" aria-labelledby="heading-29">#</a></h3>
236+
<h4 id="scope-attribute">Scope attribute <a class="header-anchor" href="#scope-attribute" id="heading-30" aria-labelledby="heading-30">#</a></h4>
237237
<p>To help assistive technology users, you must identify table headings, whether for rows or columns.<br>
238238
To identify these table headers, you must use the <code>th</code> tag, which must never be empty.</p>
239239
<p>Once the headers are created, the data cells must be associated with the headers on which they rely.<br>
@@ -242,7 +242,7 @@ <h4 id="scope-attribute">Scope attribute <a class="header-anchor" href="#scope-a
242242
<li><code>&lt;th scope="col"&gt;</code> for a column header</li>
243243
<li><code>&lt;th scope="row"&gt;</code> for a row header</li>
244244
</ul>
245-
<h4 id="id-and-header-attributes">Id and header attributes <a class="header-anchor" href="#id-and-header-attributes" id="heading-22" aria-labelledby="heading-22">#</a></h4>
245+
<h4 id="id-and-header-attributes">Id and header attributes <a class="header-anchor" href="#id-and-header-attributes" id="heading-31" aria-labelledby="heading-31">#</a></h4>
246246
<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>
247247
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>
248248
<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>
@@ -251,16 +251,16 @@ <h4 id="id-and-header-attributes">Id and header attributes <a class="header-anch
251251
<li>The table has column/row headings that change within the table.</li>
252252
<li>A data cell with three or more related headers (often linked to header cells that are merged)</li>
253253
</ul>
254-
<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-23" aria-labelledby="heading-23">#</a></h3>
254+
<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-32" aria-labelledby="heading-32">#</a></h3>
255255
<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>
256-
<h4 id="nvda">NVDA <a class="header-anchor" href="#nvda" id="heading-24" aria-labelledby="heading-24">#</a></h4>
256+
<h4 id="nvda">NVDA <a class="header-anchor" href="#nvda" id="heading-33" aria-labelledby="heading-33">#</a></h4>
257257
<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>
258258
<p>Once inside a table, there are several shortcuts to move around easily.</p>
259259
<ul>
260260
<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>
261261
<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>
262262
</ul>
263-
<h4 id="jaws">Jaws <a class="header-anchor" href="#jaws" id="heading-25" aria-labelledby="heading-25">#</a></h4>
263+
<h4 id="jaws">Jaws <a class="header-anchor" href="#jaws" id="heading-34" aria-labelledby="heading-34">#</a></h4>
264264
<p>For Jaws, you have to use the <kbd>Y</kbd> key and <kbd>Shift + Y</kbd> to navigate between tables.<br>
265265
To browse in tables, there are several shortcuts:</p>
266266
<ul>
@@ -270,9 +270,9 @@ <h4 id="jaws">Jaws <a class="header-anchor" href="#jaws" id="heading-25" aria-la
270270
<li><kbd>Insert + shift + up arrow</kbd> reads the entire line.</li>
271271
<li><kbd>Insert + shift + num pad 5</kbd> reads the entire column.</li>
272272
</ul>
273-
<h2 id="table-example" class="h2-focus">Table example <a class="header-anchor" href="#table-example" id="heading-26" aria-labelledby="heading-26">#</a></h2>
273+
<h2 id="table-example" class="h2-focus">Table example <a class="header-anchor" href="#table-example" id="heading-35" aria-labelledby="heading-35">#</a></h2>
274274
<p>We will now show you examples of accessible tables.</p>
275-
<h3 id="simple-table">Simple table <a class="header-anchor" href="#simple-table" id="heading-27" aria-labelledby="heading-27">#</a></h3>
275+
<h3 id="simple-table">Simple table <a class="header-anchor" href="#simple-table" id="heading-36" aria-labelledby="heading-36">#</a></h3>
276276
<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>
277277
<table class="table">
278278
<caption class="h4">People with their professional activity</caption>
@@ -332,7 +332,7 @@ <h3 id="simple-table">Simple table <a class="header-anchor" href="#simple-table"
332332
</code></pre>
333333
<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>
334334
<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>
335-
<h3 id="tables-with-two-headers">Tables with Two Headers <a class="header-anchor" href="#tables-with-two-headers" id="heading-28" aria-labelledby="heading-28">#</a></h3>
335+
<h3 id="tables-with-two-headers">Tables with Two Headers <a class="header-anchor" href="#tables-with-two-headers" id="heading-37" aria-labelledby="heading-37">#</a></h3>
336336
<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>
337337
<p>This table requires two headers, one for the days of the week and another for the time slot.</p>
338338
<table class="table">
@@ -398,7 +398,7 @@ <h3 id="tables-with-two-headers">Tables with Two Headers <a class="header-anchor
398398
&lt;/tr&gt;
399399
[...]
400400
</code></pre>
401-
<h3 id="complex-table">Complex table <a class="header-anchor" href="#complex-table" id="heading-29" aria-labelledby="heading-29">#</a></h3>
401+
<h3 id="complex-table">Complex table <a class="header-anchor" href="#complex-table" id="heading-38" aria-labelledby="heading-38">#</a></h3>
402402
<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>
403403
<p>Since the table is complex, we can add a description to help users understand the table.</p>
404404
<p class="border-top border-light" id="tblDesc">Tables for calculating the compliance rate of a website.<br/>

0 commit comments

Comments
 (0)