From a54e681e85a42a197a925473a6f2772a7a7e6a0d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tu=C4=9F=C3=A7e=20K=C3=BC=C3=A7=C3=BCko=C4=9Flu?=
 <tugcekucukoglu.860@gmail.com>
Date: Thu, 21 Apr 2022 14:35:14 +0300
Subject: [PATCH] Accessibility added

---
 src/views/accessibility/AccessibilityDemo.vue | 264 +++++++++++++++---
 1 file changed, 222 insertions(+), 42 deletions(-)

diff --git a/src/views/accessibility/AccessibilityDemo.vue b/src/views/accessibility/AccessibilityDemo.vue
index daf1531d1..65da07a83 100644
--- a/src/views/accessibility/AccessibilityDemo.vue
+++ b/src/views/accessibility/AccessibilityDemo.vue
@@ -1,44 +1,226 @@
 <template>
     <div>
+        <div class="content-section introduction">
+            <div class="feature-intro">
+                <h1>Accessibility</h1>
+                <p>An introduction to accessibility and how it translates to Vue UI Components.</p>
+            </div>
+        </div>
+
         <div class="content-section documentation">
-            <h1>Accessibility</h1>
-            <p>UI Components for everyone with full support for Web Content Accessibility Guidelines (WCAG).</p>
+            <p class="line-height-3 bg-indigo-600 text-white p-3 text-lg" style="border-radius:10px">Accessibility is a majorn concern of the Prime UI libraries and PrimeVue is no exception. <a href="https://www.primetek.com.tr" class="text-white">PrimeTek</a> teams have initiated a significant process to review and enhance the accessibility features of the components. This guide
+                documents the foundation of the general guidelines that PrimeVue will follow and each component documentation will have a separate <b>Accessibility</b> section that states the keyboard support, screen reader compatibility, the implementation details along
+                    with tips to achieve WCAG compliancy. This work has been initiated in Q2 2022 and planned to be completed by early Q3. PrimeVue will be the reference implementation which then will be ported to PrimeFaces, PrimeNG and PrimeReact. 
+            </p>
+            
+            <h3>Introduction</h3>
+            <p>According to the World Health Organization, 15% of the world population has a disability to some degree. As a result,
+                accessibility features in any context such as a ramp for wheelchair users or a multimedia with captions are crucial to ensure content can be consumed by anyone.</p>
+
+            <h5>Disabilities</h5>
+            <p>Types of disabilities are diverse so you need to know your audience well and how they interact with the content created. There four main categories;</p>
+            
+            <h6>Visual Impairments</h6>
+            <p>Blindness, low-level vision or color blindness are the common types of visual impairments. Screen magnifiers and the color blind mode
+                are usually built-in features of the browsers whereas for people who rely on screen readers, page developers are required to make sure
+                content is readable by the readers. Popular readers are <a href="https://www.nvaccess.org" alt="NVDA Reader">NVDA</a>, <a href="https://www.freedomscientific.com/Products/software/JAWS/" alt="JAWS Reader">JAWS</a> and <a href="https://www.chromevox.com" alt="ChromeVox Reader">ChromeVox</a>. 
+            </p>
+
+            <h6>Hearing Impairments</h6>
+            <p>Deafness or hearing loss refers to the inability to hear sounds totally or partially. People with hearing impairments use assistive devices however
+                it may not be enough when interacting with a web page. Common implementation is providing textual alternatives, transcripts and captions for content with audio.
+            </p>
+
+            <h6>Mobility Impairments</h6>
+            <p>People with mobility impairments have disabilities related to movement due to loss of a limb, paralysis or other varying reasons. Assistive technologies like
+                a head pointer is a device to interact with a screen whereas keyboard or a trackpad remain as solutions for people who are not able to utilize a mouse.
+            </p>
+
+            <h6>Cognitive Impairments</h6>
+            <p>Cognitive impairments have a wider range that includes people with learning disabilities, depression and dyslexia. A well designed content also leads
+                to better user experience for people without disabilities so designing for cognitive impairments result in better design for any user.
+            </p>
+
+            <h3>Web Content</h3>
+            <p>Correct page structure with the aid of assistive technologies are the core ingridients for an accessible web content. 
+                HTML is based on an accessible foundation, form controls can be used by keyboard by default and semantic HTML is easier to be processed by a screen reader.</p>
 
             <h5>WCAG</h5>
-            <p>The Web Content Accessibility Guidelines (WCAG) are part of a series of web accessibility guidelines published by the Web Accessibility Initiative (WAI)
-                of the World Wide Web Consortium (W3C), the main international standards organization for the Internet.</p>
+            <p><a href="https://www.w3.org/WAI/standards-guidelines/wcag/" alt="WCAG Website">WCAG</a> refers to <strong>Web Content Accessibility Guideline</strong>, a standard managed by the WAI (Web Accessibility Initiative) of W3C (World Wide Web Consortium). 
+            WCAG consists of recommendations for making the web content more accessible. PrimeVue components aim high level of WCAG compliancy in the near future.</p>
 
-            <h5>Accessible Components</h5>
-            <p>PrimeVue components are implemented based on the WCAG guidelines and follow the best practices outlined here.</p>
-            <ul>
-                <li>Utilize semantic HTML where suitable.</li>
-                <li>Use ARIA roles and attributes to describe an element.</li>
-                <li>Prefer elements that are keyboard accessible by default such as a button instead of a clickable div.</li>
-                <li>Implement keyboard navigation for list elements.</li>
-                <li>Use colors to support the suggested contrast ratios e.g. WCAG Level AAA requires a contrast ratio of at least 7:1 for normal text and 4.5:1 for large text.</li>
-                <li>Avoid colors that produce optical vibrations against a dark background, which can induce eye strain.</li>
-            </ul>
+            <p>Various countries around the globe have governmental policies regarding web accessibility as well. Most well known of these are <a href="https://www.section508.gov/manage/laws-and-policies/">Section 508</a> in the US and <a href="https://digital-strategy.ec.europa.eu/en/policies/web-accessibility">Web Accessibility Directive</a> of the European Union.</p>
 
-            <h5>Utility CSS Classes</h5>
-            <div class="doc-tablewrapper">
-                <table class="doc-table">
-                    <thead>
-                        <tr>
-                            <th>Name</th>
-                            <th>Description</th>
-                        </tr>
-                    </thead>
-                    <tbody>
-                        <tr>
-                            <td>p-sr-only</td>
-                            <td>Element becomes visually hidden however accessibility is still available.</td>
-                        </tr>
-                        <tr>
-                            <td>p-link</td>
-                            <td>Renders a button as a link.</td>
-                        </tr>
-                    </tbody>
-                </table>
+            <h5>Form Controls</h5>
+            <p>Native form elements should be preferred instead of elements that are meant for other purposes like presentation. As an example, button below is 
+                rendered as a form control by the browser, can receive focus via tabbing and can be used with space key as well to trigger.
+            </p>
+<pre v-code.script><code>
+&lt;button @click="onButtonClick(event)"&gt;Click&lt;/button&gt;
+
+</code></pre>
+
+            <p>On the other hand, a fancy css based button using a div has no keyboard or screen reader support.</p>
+<pre v-code.script><code>
+&lt;button class="fancy-button" @click="onButtonClick(event)"&gt;Click&lt;/button&gt;
+
+</code></pre>
+
+            <p><i>tabindex</i> is required to make a div element accessible in addition to use a keydown to bring the keyboard support back. To avoid the overload and implementing
+                functionality that is already provided by the browser, native form controls should be preferred.</p>
+<pre v-code.script><code>
+&lt;div class="fancy-button" @click="onClick(event)" @keydown="onKeyDown(event)" tabindex="0"&gt;Click&lt;/div&gt;
+
+</code></pre>
+
+            <h5>Relations</h5>
+            <p>Form components must be related to another element that describes what the form element is used for. This is usually achieved with the <i>label</i> element.</p>
+<pre v-code.script><code>
+&lt;label for="myinput"&gt;Username:&lt;/label&gt;
+&lt;input id="myinput" type="text" name="username" /&gt;
+
+</code></pre>
+
+            <h5>Semantic HTML</h5>
+            <p>HTML offers various element to organize content on a web page that screen readers are aware of. Preferring Semantic HTML for good semantics provide out of the box support
+                for reader which is not possible when regular <i>div</i> elements with classes are used. Consider the following example that do not mean too much for readers.
+            </p>
+<pre v-code.script><code>
+&lt;div class="header"&gt;
+    &lt;div class="header-text"&gt;Header&lt;/div&gt;
+&lt;/div&gt;
+
+&lt;div class="nav"&gt;&lt;/div&gt;
+
+&lt;div class="main"&gt;
+    &lt;div class="content"&gt;
+    &lt;/div&gt;
+
+    &lt;div class="sidebar"&gt;
+    &lt;/div&gt;
+&lt;/div&gt;
+
+&lt;div class="footer"&gt;
+&lt;/div&gt;
+
+</code></pre>
+
+            <p>Same layout can be achieved using the semantic elements with screen reader support built-in.</p>
+<pre v-code.script><code>
+&lt;header&gt;
+    &lt;h1&gt;Header&lt;/h1&gt;
+&lt;/header&gt;
+
+&lt;nav&gt;&lt;/nav&gt;
+
+&lt;main&gt;
+    &lt;article&gt;&lt;/article&gt;
+
+    &lt;aside&gt;&lt;/aside&gt;
+&lt;/main&gt;
+
+&lt;footer&gt;
+&lt;/footer&gt;
+
+</code></pre>
+
+            <h5>WAI-ARIA</h5>
+            <p>ARIA refers to "Accessible Rich Internet Applications" is a suite to fill the gap where semantic HTML is inadequate. These cases
+                are mainly related to rich UI components/widgets. Although browser support for rich UI components such as a datepicker or colorpicker has been improved over the past years
+                many web developers still utilize UI components derived from standard HTML elements created by them or by other projects like PrimeVue. These
+                types of components must provide keyboard and screen reader support, the latter case is where the WAI-ARIA is utilized. 
+            </p>
+            <p>ARIA consists of roles, properties and attributes. <b>Roles</b> define what the element is mainly used for e.g. <i>checkbox</i>, <i>dialog</i>, <i>tablist</i> whereas
+            <b>States</b> and <b>Properties</b> define the metadata of the element like <i>aria-checked</i>, <i>aria-disabled</i>.</p>
+
+            <p>Consider the following case of a native checkbox. It has built-in keyboard and screen reader support.</p>
+<pre v-code.script><code>
+&lt;input type="checkbox" value="Prime" name="ui" checked&gt;
+
+</code></pre>
+
+            <p>A fancy checkbox with css animations might look more appealing but accessibility might be lacking. Checkbox below
+                may display a checked font icon with animations however it is not tabbable, cannot be checked with space key and cannot be read by a reader.
+            </p>
+<pre v-code.script><code>
+&lt;div class="fancy-checkbox"&gt;
+    &lt;i class="checked-icon" v-if="checked"&gt;&lt;/i&gt;
+&lt;/div&gt;
+
+</code></pre>
+
+            <p>One alternative is using ARIA roles for readers and use javascript for keyboard support. Notice the usage of <i>aria-labelledby</i> as a replacement of the <i>label</i> tag with htmlFor.</p>
+<pre v-code.script><code>
+&lt;span id="chk-label"&gt;Remember Me&lt;/span&gt;
+&lt;div class="fancy-checkbox" role="checkbox" aria-checked="false" tabindex="0" aria-labelledby="chk-label"
+    @click="toggle" @keydown="onKeyDown(event)"&gt;
+    &lt;i class="checked-icon" v-if="checked"&gt;&lt;/i&gt;
+&lt;/div&gt;
+
+</code></pre>
+
+            <p>However the best practice is combining semantic HTML for accessibility while keeping the design for UX. This approach
+                involves hiding a native checkbox for accessibility and using javascript events to update its state. Notice the usage of <i>p-sr-only</i>
+                that hides the elements from the user but not from the screen reader.
+            </p>
+<pre v-code.script><code>
+&lt;label for="chkbox"&gt;Remember Me&lt;/label&gt;
+&lt;div class="fancy-checkbox" @click="toggle"&gt;
+    &lt;input class="p-sr-only" type="checkbox" id="chkbox" @focus="updateParentVisuals" @blur="updateParentVisuals"
+        @keydown="onKeyDown(event)"&gt;
+    &lt;i class="checked-icon" v-if="checked"&gt;&lt;/i&gt;
+&lt;/div&gt;
+
+</code></pre>
+
+            <p>A working sample is the PrimeVue checkbox that is tabbable, keyboard accessible and is compliant with a screen reader. Instead of ARIA
+                roles it relies on a hidden native checkbox.
+            </p>
+
+            <div class="flex align-items-center">
+                <label for="binary" class="mr-2">Remember Me</label>
+                <Checkbox id="binary" binary v-model="checked" />
+            </div>
+
+            <h5>Colors</h5>
+            <p>Colors on a web page should aim a contrast ratio of at least <strong>4.5:1</strong> and consider a selection of colors that do not
+            cause vibration.</p>
+
+            <h6>Good Contrast</h6>
+            <p>Color contrast between the background and the foreground content should be sufficient enough to ensure readability. Example below displays two cases with good and bad samples.</p>
+
+            <div class="flex">
+                <div class="h-8rem w-8rem flex justify-content-center align-items-center mr-5 font-bold bg-blue-600" style="border-radius:10px">
+                    <span class="text-white">GOOD</span>
+                </div>
+                <div class="h-8rem w-8rem flex justify-content-center align-items-center mr-5 font-bold bg-blue-400" style="border-radius:10px">
+                    <span class="text-white">BAD</span>
+                </div>
+            </div>
+
+            <h6>Vibration</h6>
+            <p>Color vibration is leads to an illusion of motion due to choosing colors that have low visibility against each other. Color combinations
+                need to be picked with caution to avoid vibration.
+            </p>
+
+            <div class="flex">
+                <div class="h-8rem w-8rem flex justify-content-center align-items-center mr-5 font-bold bg-pink-500" style="border-radius:10px">
+                    <span class="text-blue-500">VIBRATE</span>
+                </div>
+            </div>
+
+            <h6>Dark Mode</h6>
+            <p>Highly saturated colors should be avoided when used within a dark design scheme as they cause eye strain. Instead desaturated colors should be preferred.</p>
+            
+            <div class="flex">
+                <div class="h-8rem w-8rem flex flex-column justify-content-center align-items-center mr-5 font-bold bg-gray-900" style="border-radius:10px">
+                    <span class="text-indigo-500">Indigo 500</span>
+                    <i class="text-indigo-500 pi pi-times-circle mt-3 text-xl"></i>
+                </div>
+                <div class="h-8rem w-8rem flex flex-column justify-content-center align-items-center mr-5 font-bold bg-gray-900" style="border-radius:10px">
+                    <span class="text-indigo-200">Indigo 200</span>
+                    <i class="text-indigo-200 pi pi-check-circle mt-3 text-xl"></i>
+                </div>
             </div>
         </div>
     </div>
@@ -46,12 +228,10 @@
 
 <script>
 export default {
-
+    data() {
+        return {
+            checked: false
+        }
+    }
 }
-</script>
-
-<style scoped>
-li {
-    line-height: 1.5;
-}
-</style>
+</script>
\ No newline at end of file