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.

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

Update PDF techniques #3354

Merged
merged 77 commits into from Aug 30, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
77 commits
Select commit Hold shift + click to select a range
9e0b3d5
Delete Word 2003 image
fstrr Mar 7, 2023
6af7de7
Syntax highlighting. Also:
fstrr Mar 7, 2023
41acb03
Syntax highlighting, gave images alt text, fixed links
fstrr Mar 7, 2023
84375c1
Syntax highlighting, alt text for images, broken links
fstrr Mar 7, 2023
cceec9a
Syntax highlighting, alt text, dead links
fstrr Mar 8, 2023
08776ba
Syntax highlighting, alt text, broken links
fstrr Mar 8, 2023
4cd0025
Updated PDF so it passed the Acrobat accessibility check
fstrr Mar 17, 2023
ba17c4c
Updated images to remove unnecessary content
fstrr Mar 17, 2023
39b6405
Syntax highlighting, broken links, images have alt text
fstrr Mar 17, 2023
70138fc
Code syntax, added alt text, fixed links
fstrr Mar 18, 2023
db2edd3
Image alt text, broken links
fstrr Mar 18, 2023
3f6cf02
Syntax highlighting, image alt text, broken links
fstrr Mar 18, 2023
2fbddc2
Syntax highlighting, alt text for images, broken links
fstrr Apr 6, 2023
3d899a3
Syntax highlighting, remove Livecycle content, broken links, alt text
fstrr Apr 6, 2023
249c567
Syntax highlighting, updated 404ing links, img alt text
fstrr Apr 13, 2023
f5e92ab
Syntax highlighting, broken links, alt text
fstrr Apr 14, 2023
63d56e5
Syntax highlighting, alt text, broken links
fstrr Apr 14, 2023
08eaa21
Syntax highlighting, alt text, fix broken links
fstrr Apr 20, 2023
afe5a40
Syntax highlighting, alt text, broken links
fstrr Apr 20, 2023
d70eb5e
Syntax highlighting, broken links, removed LiveCycle content
fstrr Apr 20, 2023
a85c092
Syntax highlighting alt text, broken links
fstrr Apr 20, 2023
50dcf73
Syntax highlighting, alt text, broken links
fstrr May 2, 2023
86e90ce
Syntax highlighting, alt text, broken links
fstrr May 2, 2023
08662f3
Syntax highlighting, alt text, broken links
fstrr May 2, 2023
e8ec0c3
Syntax highlighting, alt text, broken links
fstrr May 2, 2023
13900ab
Syntax highlighting, alt text, broken links
fstrr May 2, 2023
4d2178f
Removed Livecycle content
fstrr May 2, 2023
e76a071
Typo
fstrr May 3, 2023
19da535
Improving links to PDFs
fstrr May 3, 2023
93c97dc
Made link to example.com https
fstrr May 3, 2023
25579d8
Clarifying the example PDF
fstrr May 3, 2023
9a667a1
Remove lifecycle pdf
fstrr May 3, 2023
2ffa43b
Updating link to PDF1.7 spec
fstrr May 4, 2023
69d8219
Fixed color contrast issues
fstrr May 5, 2023
18a2eb0
Replaced all the empty paragraphs with page breaks
fstrr May 5, 2023
72d4d46
Update PDF techniques
fstrr May 12, 2023
b76799e
Updated to pdf techniques 1 and 2
ljoakley Jun 2, 2023
b21476f
Create oomenu.jpg
ljoakley Jul 10, 2023
8106a0d
Create styles.jpg
ljoakley Jul 10, 2023
1cdf211
Create oostyles.jpg
ljoakley Jul 10, 2023
210e1b5
Update PDF2.html
ljoakley Jul 10, 2023
aaaf309
Updates to OpenOffice Column tool
ljoakley Jul 10, 2023
67ba532
Update PDF3.html
ljoakley Jul 10, 2023
b086729
Update PDF3.html
ljoakley Jul 10, 2023
a364909
Update PDF9.html
ljoakley Jul 11, 2023
8774a84
updates to PDF11
ljoakley Jul 11, 2023
ca78118
Remove out of date images, add new images for Acrobat and Word
fstrr Jul 14, 2023
a5f97eb
Update PDF1 for current Acrobat Pro and Word
fstrr Jul 14, 2023
e4c3aaf
Update PDF3
fstrr Jul 14, 2023
8ccd879
Update PDF2
fstrr Jul 18, 2023
2344806
Update PDF4
fstrr Jul 18, 2023
7ffa27a
Update PDF5
fstrr Jul 18, 2023
2eef52e
Update PDF5 example PDF
fstrr Jul 18, 2023
d67cb68
Update PDF6
fstrr Jul 18, 2023
d3cb04c
Update PDF7
fstrr Jul 18, 2023
9f9b508
Update PDF8
fstrr Jul 19, 2023
5827974
removed pagination
ljoakley Jul 27, 2023
25486cb
Replace “pagination artifacts”.
fstrr Jul 28, 2023
d92cfb6
upate for pdf14
ljoakley Aug 8, 2023
6eabe59
Update PDF9 examples
fstrr Aug 10, 2023
26f3578
Update PDF10 examples
fstrr Aug 10, 2023
13de709
Update PDF11’s examples
fstrr Aug 11, 2023
7934ba2
Update PDF 12 examples
fstrr Aug 11, 2023
181b1d1
Updated PDF 15 examples
fstrr Aug 11, 2023
0384741
Updating an email address
fstrr Aug 15, 2023
6fecdf0
Updated pdf17
ljoakley Aug 15, 2023
98cf8ef
Update PDF 16
fstrr Aug 18, 2023
679f61f
Update PDF 17
fstrr Aug 18, 2023
b3a2cbf
Update PDF18
fstrr Aug 21, 2023
47e669b
Update PDF19
fstrr Aug 22, 2023
2b4764f
Update PDF20
fstrr Aug 22, 2023
67a5cb3
Update PDF 21
fstrr Aug 22, 2023
9a7a197
Update PDF22
fstrr Aug 22, 2023
84a3cc6
Update PDF23
fstrr Aug 22, 2023
f0b6ebf
Merge branch 'issue-3197' into update-pdf-techniques
fstrr Aug 22, 2023
752459c
Tweak PDF17
fstrr Aug 22, 2023
156016e
Update PDF14
fstrr Aug 22, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
347 changes: 133 additions & 214 deletions techniques/pdf/PDF1.html

Large diffs are not rendered by default.

347 changes: 79 additions & 268 deletions techniques/pdf/PDF10.html

Large diffs are not rendered by default.

256 changes: 127 additions & 129 deletions techniques/pdf/PDF11.html

Large diffs are not rendered by default.

242 changes: 93 additions & 149 deletions techniques/pdf/PDF12.html
@@ -1,21 +1,32 @@
<!DOCTYPE html><html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"><head><title>Providing name, role, value information for form fields in PDF documents</title><link rel="stylesheet" type="text/css" href="../../css/sources.css" class="remove"></link></head><body><h1>Providing name, role, value information for form fields in PDF documents</h1><section class="meta"><p class="id">ID: PDF12</p><p class="technology">Technology: pdf</p><p class="type">Type: Technique</p></section><section id="applicability"><h2>When to Use</h2>
<p>Tagged PDF documents with interactive form fields. </p>
</section><section id="description"><h2>Description</h2>
<p>The objective of this technique is to ensure that assistive technologies
<!DOCTYPE html>
<html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Providing name, role, value information for form fields in PDF documents</title>
<link rel="stylesheet" type="text/css" href="../../css/editors.css" class="remove"></link>
</head>
<body>
<h1>Providing name, role, value information for form fields in <abbr title="Portable Document Format">PDF</abbr> documents</h1>
<section class="meta">
<p class="id">ID: PDF12</p>
<p class="technology">Technology: pdf</p>
<p class="type">Type: Technique</p>
</section>
<section id="applicability">
<h2>When to Use</h2>
<p>Tagged PDF documents with interactive form fields.</p>
</section>
<section id="description">
<h2>Description</h2>
<p>The objective of this technique is to ensure that assistive technologies
can gather information about and interact with form controls in PDF
content. </p>
content.</p>
<p>The types of PDF form controls are: text input field, check box, radio
button, combo box, list box, and button. </p>
button, combo box, list box, and button.</p>
<p>Providing name, role, state, and value information for all form components
enables compatibility with assistive technology, such as screen readers,
screen magnifiers, and speech recognition software used by people with
disabilities. </p>
<p>The PDF specification defines how name, role, and value are set for
form controls in Section 12.7.4 (Field Types) of <a href="http://www.adobe.com/content/dam/Adobe/en/devnet/pdf/pdfs/PDF32000_2008.pdf">PDF
1.7 (ISO 32000-1)</a>, as shown in the following table. The Comments column explains how Adobe Acrobat Pro displays the corresponding information. </p>


<table id="PDF12_spec">
disabilities.</p>
<table>
<tbody>
<tr>
<th scope="col">Interactive Form Dictionary Entries</th>
Expand Down Expand Up @@ -60,13 +71,12 @@
</tbody>
</table>


<p>The following table describes how the role, name, value, and state
<p>The following table describes how the role, name, value, and state
are defined for PDF form controls created using Adobe Acrobat Pro.
Adobe LiveCycle Designer provides the same controls as well as several
additional ones: see Example 2 below. </p>

<table id="PDF12_acrobat">
<table>
<tbody>
<tr>
<th>PDF form element </th>
Expand Down Expand Up @@ -141,147 +151,81 @@
</tr>
</tbody>
</table>


</section><section id="examples"><h2>Examples</h2>
<section class="example">
<h3>Specifying name, role, value and/or state for a form field
using Adobe Acrobat 9 Pro</h3>

<p>This example is shown with Adobe Acrobat Pro. There are other software tools that perform similar functions. See the list of other software tools in <a href="#pdf_notes_acc-sup_files_applications"></a>.</p>
<p>This example uses a check box for illustration; the procedure is the
same for other form controls. In Form Editing mode: </p>
<ol>
<li> Access the context menu for the form field you are creating or
modifying. </li>
<li> Select the Properties... dialog for the form field. </li>
<li> Specify the name by adding a value to the tool tip field. This
will used by the accessibility API as the Name for the control and
should usually be set to match the text used as a visual label for
the control. </li>
<li> Select the Options tab. </li>
<li> Specify the default value and the default state, if appropriate. </li>
</ol>
<p>The image below shows the Check Box Properties dialog, open in the
General tab. (The Name field in the dialog is not needed for accessibility.) </p>
<figure id="figure-general-tab">
<img src="img/nrv1.jpg" />

<figcaption>General tab on the Check Box Properties dialog, showing name and tool tip fields for a check box</figcaption>

</figure>
<p>The image below shows the Check Box Properties dialog, open in the
Options tab. </p>
<figure id="figure-check-box-props">
<img src="img/nrv2.jpg" />

<figcaption>Options tab on the Check Box Properties dialog, showing value and state fields for a check box.</figcaption>

</figure>
<p class="working-example">This example is shown in operation in the <a href="../../working-examples/pdf-form-labels/form.pdf">working example of specifying name, role, value using Acrobat Pro</a>.</p>

</section>
<section class="example">
<h3>Specifying name, value, and state for a form field using
Adobe LiveCycle Designer ES 8.2.1</h3>

<p>This example is shown with Adobe LiveCycle Designer. There are other software tools that perform similar functions. See the list of other software tools in <a href="#pdf_notes_acc-sup_files_applications"></a>.</p>
<p>In Adobe LiveCycle Designer, you use the Object Library to create
form objects and the Object Palette to specify name, role, state or
value for the object. </p>
<p>The following image shows the Object Palette. </p>
<figure id="figure-object-palette">
<img src="img/lc-objlib.jpg" />

<figcaption>LiveCycle Designer Object Library showing the form objects available for form creation.</figcaption>

</figure>
<p>The following three images show the tabs in the Object palette. In
the first the Field tab is open for specifying the type (or role) of
the field. </p>
<figure id="figure-LCD-object-palette">
<img src="img/lc-objpal-t.jpg" />

<figcaption>LiveCycle Designer Object palette, Field tab.</figcaption>

</figure>
<p>The next image shows the Value tab, with options that can be applied
to the field. </p>
<figure id="figure-LCD-value-tab">
<img src="img/lc-objpal-v.jpg" />

<figcaption>LiveCycle Designer Object palette, Value tab options.</figcaption>

</figure>
<p>The third images shows the Binding tab, specifying the name of the
field. </p>
<figure id="figure-binding-tab">
<img src="img/lc-objpal-b.jpg" />

<figcaption>LiveCycle Designer Object palette, Binding tab.</figcaption>

</figure>
<p class="working-example">This example is shown in operation in the <a href="../../working-examples/pdf-form-labels/form-lc.pdf">working example of specifying name, role, value using LiveCycle Designer</a>.</p>

</section>
<section class="example">
<h3>Adding a checkbox in a PDF document using the /Btn field
type</h3>

<p>The following code fragment illustrates code that is typical for a
simple check box field such as shown in Examples 1 and 2. This is typically
accomplished by an authoring tool. </p>
<pre xml:space="preserve">1 0 obj
</section>
<section id="examples">
<h2>Examples</h2>
<section class="example">
<h3>Specifying name, role, value and/or state for a form field using Adobe Acrobat Pro</h3>

<p>This example is shown with Adobe Acrobat Pro. There are other software tools that perform similar functions.</p>
<p>This example uses a check box for illustration; the procedure is the same for other form controls.</p>
<ol>
<li>Open the Prepare Form tool.</li>
<li>Select the form field you are creating or modifying and access the context menu for it.</li>
<li>Select the Properties... option.</li>
<li>Specify the name by adding a value to the Tooltip field. This
will used by the accessibility <abbr title="Application Programming Interface">API</abbr> as the Name for the control. To conform to the Label In Name Criterion, the Tooltip value must contain the text that presented visually.</li>
<li>If you need to specify the default value and state, select the Options tab for these options.</li>
</ol>
<p>The image below shows the Check Box Properties dialog, open in the General tab. (The Name field in the dialog is not needed for accessibility.)</p>
<div>
<img alt="General tab on the Check Box Properties dialog, showing name and tool tip fields for a check box" src="img/name-role-value.png" width="577">
</div>
<p class="working-example">This example is shown in operation in the <a href="../../working-examples/pdf-name-role-value-form-fields/form.pdf">working example of specifying name, role, value using Acrobat Pro</a>.</p>
</section>
<section class="example">
<h3>Adding a checkbox in a PDF document using the <code>/Btn</code> field type</h3>
<p>The following code fragment illustrates code that is typical for a simple check box field such as shown in Examples 1 and 2. This is typically accomplished by an authoring tool.</p>
<pre xml:space="preserve"><code>1 0 obj
&lt;&lt; /FT /Btn % Role
/TU Retiree % Name
/V /Yes % Value
/AS /Yes
/AP &lt;&lt; /N &lt;&lt; /Yes 2 0 R /Off 3 0 R&gt;&gt;
&gt;&gt;
endobj
</pre>

endobj</code></pre>
</section>
</section><section id="tests"><h2>Tests</h2>
<section class="procedure"><h3>Procedure</h3>
<ol>
<li>
<p> For the form control, verify that name, role, and value/state
are specified by one of the following:</p>
<ul>
<li> Use a screen reader to navigate to the form control and check
that it can be activated or that its value can be changed. Verify
that the name (tooltip) and role are announced. </li>
<li> Use a tool capable of showing the form field information to open the PDF document and verify that the form control has the correct name, role, value, and state (if appropriate) information.</li>
<li> Use a tool that exposes the document through the accessibility
API, and verify that the form control has the correct name, role,
value, and state (if appropriate) information. </li>
</ul>
</li>
</ol>
</section>
<section class="results"><h3>Expected Results</h3>
<ul>
<li>#1 is true. </li>
</ul>
</section>
</section><section id="related"><h2>Related Techniques</h2><ul>
</section>
<section id="tests">
<h2>Tests</h2>
<section class="procedure">
<h3>Procedure</h3>
<ol>
<li>
<p>For the form control, verify that name, role, and value/state are specified by one of the following:</p>
<ul>
<li>Use a screen reader to navigate to the form control and check that it can be activated or that its value can be changed. Verify that the name (tooltip) and role are announced.</li>
<li>Use a tool capable of showing the form field information to open the PDF document and verify that the form control has the correct name, role, value, and state (if appropriate) information.</li>
<li>Use a tool that exposes the document through the accessibility <abbr title="Application Programming Interface">API</abbr>, and verify that the form control has the correct name, role, value, and state (if appropriate) information.</li>
</ul>
</li>
</ol>
</section>
<section class="results">
<h3>Expected Results</h3>
<ul>
<li>#1 is true.</li>
</ul>
</section>
</section>
<section id="related">
<h2>Related Techniques</h2>
<ul>
<li><a href="../pdf/PDF23">PDF23</a></li>
<li><a href="../pdf/PDF5">PDF5</a></li>
<li><a href="../pdf/PDF22">PDF22</a></li>
</ul></section><section id="resources"><h2>Resources</h2>

<ul>
<li> Section 12.7.4 (Field Types) of <a href="http://www.adobe.com/content/dam/Adobe/en/devnet/pdf/pdfs/PDF32000_2008.pdf">PDF
1.7 (ISO 32000-1)</a>
</li>
<li>
<a href="http://partners.adobe.com/public/developer/xml/index_arch.html">Adobe
XML Forms Architecture (XFA)</a>
</li>
<li>
<a href="http://www.adobe.com/accessibility/products/acrobat.html">PDF and Accessibility</a>
</li>
</ul>

</section></body></html>
</ul>
</section>
<section id="resources">
<h2>Resources</h2>
<ul>
<li>Section 12.7.4 (Field Types) in <a href="https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/PDF32000_2008.pdf">PDF 1.7 (ISO 32000-1) (PDF)</a>
</li>
<li>
<a href="https://helpx.adobe.com/acrobat/using/create-verify-pdf-accessibility.html">Create and verify PDF accessibility (Acrobat Pro)</a>
</li>
</ul>
</section>
</body>
</html>