Skip to content

Commit

Permalink
Merge branch 'main' into patrickhlauke-issue2563
Browse files Browse the repository at this point in the history
  • Loading branch information
@patrickhlauke
patrickhlauke authored Oct 29, 2024
2 parents d92d197 + b99ada8 commit ac9049f
Show file tree
Hide file tree
Showing 11 changed files with 71 additions and 150 deletions.
4 changes: 2 additions & 2 deletions techniques/failures/F52.html
View file
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
<!DOCTYPE html><html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"><head><title>Failure of Success Criterion 3.2.1 and 3.2.5 due to opening a new window as soon as a new page is loaded</title><link rel="stylesheet" type="text/css" href="../../css/editors.css" class="remove"/></head><body><h1>Failure of Success Criterion 3.2.1 and 3.2.5 due to opening a new window as soon as a new page is loaded</h1><section class="meta"><p class="id">ID: F52</p><p class="technology">Technology: failures</p><p class="type">Type: Failure</p></section><section id="applicability"><h2>When to Use</h2>
<!DOCTYPE html><html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"><head><title>Failure of Success Criterion 3.2.5 due to opening a new window as soon as a new page is loaded</title><link rel="stylesheet" type="text/css" href="../../css/editors.css" class="remove"/></head><body><h1>Failure of Success Criterion 3.2.5 due to opening a new window as soon as a new page is loaded</h1><section class="meta"><p class="id">ID: F52</p><p class="technology">Technology: failures</p><p class="type">Type: Failure</p></section><section id="applicability"><h2>When to Use</h2>
<p>Applies when scripting is used to open new windows. </p>
</section><section id="description"><h2>Description</h2>
<p> Some Web sites open a new window when a page is loaded, to advertise a
Expand Down Expand Up @@ -41,4 +41,4 @@ <h3>example commonly used to open new windows when pages are loaded</h3>
</ul></section><section id="resources"><h2>Resources</h2>

</section>
</body></html>
</body></html>
6 changes: 0 additions & 6 deletions techniques/general/G10.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -31,12 +31,6 @@
Using the Java swing classes they are able to create an interface
component that exposes its name and role, is able to be set by AT
and alerts AT to any updates.</li>
<li>A Web page uses an original ActiveX control that is
written in the C++ programming language. The control is written to
explicitly support the Microsoft Active Accessibility (MSAA) API to
expose information about accept commands. The control then interacts
directly with assistive technology running the user agent on systems
that support MSAA.</li>
</ul>
</section><section id="tests"><h2>Tests</h2>
<section class="procedure"><h3>Procedure</h3>
Expand Down
5 changes: 4 additions & 1 deletion techniques/html/H35.html
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
---
obsoleteMessage: The Java-specific <code class="el">applet</code> element is obsolete.
obsoleteMessage: |
The Java-specific <code>applet</code> element is
<a href="https://html.spec.whatwg.org/multipage/obsolete.html#applet">obsolete in the HTML Living Standard</a>.
Use <code>embed</code> or <code>object</code> instead.
obsoleteSince: 20
---
<!DOCTYPE html><html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"><head><title> Providing text alternatives on applet elements </title><link rel="stylesheet" type="text/css" href="../../css/sources.css" class="remove"></link></head><body><h1> Providing text alternatives on <code class="el">applet</code> elements </h1><section class="meta"><p class="id">ID: H35</p><p class="technology">Technology: html</p><p class="type">Type: Technique</p></section><section id="applicability"><h2>When to Use</h2>
Expand Down
6 changes: 5 additions & 1 deletion techniques/html/H45.html
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
---
obsoleteMessage: The <code class="att">longdesc</code> attribute is obsolete and not widely supported.
obsoleteMessage: |
The <code>longdesc</code> attribute is
<a href="https://html.spec.whatwg.org/multipage/obsolete.html#attr-img-longdesc">obsolete in the HTML Living Standard</a>,
and was never widely supported.
Use an <code>a</code> element or an image map to link to the description.
obsoleteSince: 20
---
<!DOCTYPE html><html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"><head><title>Using longdesc</title><link rel="stylesheet" type="text/css" href="../../css/sources.css" class="remove"></link></head><body><h1>Using longdesc</h1><section class="meta"><p class="id">ID: H45</p><p class="technology">Technology: html</p><p class="type">Type: Technique</p></section><section id="applicability"><h2>When to Use</h2>
Expand Down
5 changes: 4 additions & 1 deletion techniques/html/H46.html
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
---
obsoleteMessage: <code class="el">noembed</code> is obsolete. Use <code class="el">object</code> instead when fallback is necessary.
obsoleteMessage: |
<code>noembed</code> is
<a href="https://html.spec.whatwg.org/multipage/obsolete.html#noembed">obsolete in the HTML Living Standard</a>.
Use <code>object</code> instead when fallback is necessary.
obsoleteSince: 20
---
<!DOCTYPE html><html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"><head><title>Using noembed with embed
Expand Down
2 changes: 1 addition & 1 deletion techniques/html/H59.html
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
obsoleteMessage: <code class="att">prev</code> and <code class="att">next</code> typically have no effect on browser navigation controls.
obsoleteMessage: <code>prev</code> and <code>next</code> typically have no effect on browser navigation controls.
obsoleteSince: 20
---
<!DOCTYPE html>
Expand Down
6 changes: 5 additions & 1 deletion techniques/html/H70.html
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
---
obsoleteMessage: The <code class="el">frameset</code> and <code class="el">frame</code> elements are obsolete.
obsoleteMessage: |
The <code>frameset</code> and <code>frame</code> elements are
<a href="https://html.spec.whatwg.org/multipage/obsolete.html#non-conforming-features:frameset">obsolete in the HTML Living Standard</a>.
Either use <code>iframe</code> and CSS instead,
or use server-side includes to generate complete pages with the various invariant parts merged in.
obsoleteSince: 20
---
<!DOCTYPE html><html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"><head><title>Using frame elements to group blocks of repeated material</title><link rel="stylesheet" type="text/css" href="../../css/sources.css" class="remove"></link></head><body><h1>Using frame elements to group blocks of repeated material</h1><section class="meta"><p class="id">ID: H70</p><p class="technology">Technology: html</p><p class="type">Type: Technique</p></section><section id="applicability"><h2>When to Use</h2>
Expand Down
5 changes: 4 additions & 1 deletion techniques/html/H73.html
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
---
obsoleteMessage: The <code class="att">summary</code> attribute is obsolete as of HTML5.
obsoleteMessage: |
The <code>summary</code> attribute is
<a href="https://html.spec.whatwg.org/multipage/obsolete.html#attr-table-summary">obsolete in the HTML Living Standard</a>.
Use one of the <a href="https://html.spec.whatwg.org/multipage/tables.html#table-descriptions-techniques">techniques for describing tables</a> instead.
obsoleteSince: 20
---
<!DOCTYPE html><html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"><head><title>Using the summary attribute of the table element to give an overview of data
Expand Down
175 changes: 40 additions & 135 deletions understanding/20/images-of-text.html
View file
Original file line number Diff line number Diff line change
@@ -1,34 +1,33 @@
<!DOCTYPE html>
<html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta charset="UTF-8"></meta>
<meta charset="UTF-8"/>
<title>Understanding Images of Text</title>
<link rel="stylesheet" type="text/css" href="../../css/sources.css" class="remove"/>
</head>
<body>
<h1>Understanding Images of Text</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Goal</dt><dd>Users can adjust how text is presented.</dd>
<dt>What to do</dt><dd>Use text instead of pictures of text.</dd>
<dt>Why it's important</dt><dd>People cannot alter how text looks in images.</dd>
<dt>Why it's important</dt><dd>People cannot alter how text looks in images.</dd>
</dl>

</section>

<section id="intent">
<h2>Intent of Images of Text</h2>



<p>The intent of this Success Criterion is to encourage authors, who are using technologies
which are capable of achieving their desired default visual presentation, to enable
people who require a particular visual presentation of text to be able to adjust the
text presentation as needed. This includes people who require the text in a particular
font size, foreground and background color, font family, line spacing or alignment.
</p>

<p>If authors can use text to achieve the same visual effect, they should present
the information as text rather than using an image. If for any reason, the author
cannot format the text to get the same effect, the effect won't be reliably presented
Expand All @@ -40,52 +39,43 @@ <h2>Intent of Images of Text</h2>
widely deployed or which the author doesn't have the right to redistribute, or to
ensure that the text would be anti-aliased on all user agents.
</p>

<p>Images of text can also be used where it is possible for users to customize the image
of text to match their requirements.
</p>
<p>The definition of image of text contains the note: Note: This does not include text that is part of a picture that contains significant

<p>The definition of <a>images of text</a> contains the note: This does not include text that is part of a picture that contains significant
other visual content. Examples of such pictures include graphs, screenshots, and diagrams which visually
convey important information through more than just text.
</p>


<p class="note">The Success Criterion is intended to address situations where <a>images of text</a> are used <em>rather than</em> text. Where images of text are used <em>in addition to</em> text to convey the same information, and where both are presented to the user, this Success Criterion is met. This allows authors to convey content using any styling they desire, while also presenting the information in text, which can then be manipulated by users to make it more distinguishable. This is in contrast to <a href="images-of-text-no-exception">1.4.9 Images of Text (No Exception)</a>, which applies to all images of text, regardless of whether or not they are used <em>in addition to</em> text.</p>

<p>Techniques for satisfying this Success Criterion are the same as those for Success
Criterion 1.4.9, except that they only need to apply if the visual presentation can
be achieved with the technologies that the author is using. For Success Criterion
1.4.9, the sufficient techniques would be applied only when the user can customize
the output.
</p>

<p>See also
<a href="images-of-text-no-exception">1.4.9: Images of Text (No Exception)</a>.
the output.
</p>



<p>See also <a href="images-of-text-no-exception">1.4.9 Images of Text (No Exception)</a>.</p>

</section>
<section id="benefits">
<h2>Benefits of Images of Text</h2>


<ul>

<li>People with low vision (who may have trouble reading the text with the authored font
family, size and/or color).
</li>

<li>People with visual tracking problems (who may have trouble reading the text with the
authored line spacing and/or alignment).
</li>

<li>People with cognitive disabilities that affect reading.</li>

</ul>

</section>

<section id="examples">
<h2>Examples of Images of Text</h2>

<dl>
<dt>Styled Headings</dt>
<dd>Rather than using bitmap images to present headings in a specific font and size, an
Expand Down Expand Up @@ -130,139 +120,54 @@ <h2>Examples of Images of Text</h2>
<dt>Customizable font settings in images of text</dt>
<dd>A Web site allows users to specify font settings and all images of text on the site
are then provided based on those settings.</dd>
<dt>The text in an image is also provided as text.</dt>
<dd>A user has to upload an event poster image, which includes text, to their website's events
calendar. The site's CMS (content management system) is limited, and won't allow them to create
a custom HTML/CSS/SVG recreation of the poster. However, in addition to the image, they can add
regular text to the calendar entry, so they post both the poster and the text contained in the image.
This text is shown next to the poster image on the site's calendar page.</dd>
</dl>

</section>

<section id="resources">
<h2>Resources for Images of Text</h2>


<ul>

<li>

<a href="http://alistapart.com/article/cssatten">CSS Web fonts</a>

</li>

<li>

<a href="http://clagnut.com/blog/2042/">Weblog comments: WebKit now supports CSS @font-face rules</a>

</li>

<li>

<a href="http://www.workingwith.me.uk/articles/css/cross-browser-drop-shadows">Creating Cross Browser Compatible CSS Text Shadows</a>

</li>

<li>

<a href="http://www.yourhtmlsource.com/stylesheets/csstext.html">CSS and text</a>

</li>

<li><a href="http://alistapart.com/article/cssatten">CSS Web fonts</a></li>
<li><a href="http://clagnut.com/blog/2042/">Weblog comments: WebKit now supports CSS @font-face rules</a></li>
<li><a href="http://www.workingwith.me.uk/articles/css/cross-browser-drop-shadows">Creating Cross Browser Compatible CSS Text Shadows</a></li>
<li><a href="http://www.yourhtmlsource.com/stylesheets/csstext.html">CSS and text</a></li>
</ul>

</section>

<section id="techniques">
<h2>Techniques for Images of Text</h2>


<section id="sufficient">
<h3>Sufficient Techniques for Images of Text</h3>


<ul>

<li>

<a href="../Techniques/css/C22" class="css">Using CSS to control visual presentation of text</a>

</li>

<li>

<a href="../Techniques/css/C30" class="css">Using CSS to replace text with images of text and providing user interface controls
to switch
</a>

</li>

<li>

<a href="../Techniques/general/G140" class="general">Separating information and structure from presentation so that Web pages can be presented
different ways without losing information
</a>

</li>

<li>

<a href="../Techniques/pdf/PDF7" class="pdf"></a>

</li>

<li><a href="../Techniques/css/C22" class="css">Using CSS to control visual presentation of text</a></li>
<li><a href="../Techniques/css/C30" class="css">Using CSS to replace text with images of text and providing user interface controls to switch</a></li>
<li><a href="../Techniques/general/G140" class="general">Separating information and structure from presentation so that Web pages can be presented different ways without losing information</a></li>
<li><a href="../Techniques/pdf/PDF7" class="pdf"></a></li>
</ul>

</section>

<section id="advisory">
<h3>Additional Techniques (Advisory) for Images of Text</h3>


<section>

<h4>CSS Techniques</h4>

<ul>

<li>

<a href="../Techniques/css/C12" class="css">Using percent for font sizes</a>

</li>

<li>

<a href="../Techniques/css/C13" class="css">Using named font sizes</a>

</li>

<li>

<a href="../Techniques/css/C14" class="css">Using em units for font sizes</a>

</li>

<li>

<a href="../Techniques/css/C8" class="css">Using CSS letter-spacing to control spacing within a word</a>

</li>

<li>

<a href="../Techniques/css/C6" class="css">Positioning content based on structural markup</a>

</li>

<li><a href="../Techniques/css/C12" class="css">Using percent for font sizes</a></li>
<li><a href="../Techniques/css/C13" class="css">Using named font sizes</a></li>
<li><a href="../Techniques/css/C14" class="css">Using em units for font sizes</a></li>
<li><a href="../Techniques/css/C8" class="css">Using CSS letter-spacing to control spacing within a word</a></li>
<li><a href="../Techniques/css/C6" class="css">Positioning content based on structural markup</a></li>
</ul>

</section>

</section>

<section id="failure">
<h3>Failures for Images of Text</h3>


</section>

</section>

</body>
</html>
4 changes: 3 additions & 1 deletion understanding/20/info-and-relationships.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -575,7 +575,9 @@ <h3>Failures for Info and Relationships</h3>
<a href="../../techniques/failures/F92" class="failure"></a>

</li>

<li>
<a href="../../Techniques/failures/F111" class="failure"></a>
</li>
</ul>

</section>
Expand Down
3 changes: 3 additions & 0 deletions understanding/20/name-role-value.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -207,6 +207,9 @@ <h3>Failures for Name, Role, Value</h3>
<li>
<a href="../Techniques/failures/F89" class="failure"></a>
</li>
<li>
<a href="../Techniques/failures/F111" class="failure"></a>
</li>
</ul>
</section>
</section>
Expand Down

0 comments on commit ac9049f

Please sign in to comment.