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

Updated Reflow understanding doc #4055

Merged
merged 149 commits into from
Mar 7, 2025
Merged
Changes from 1 commit
Commits
Show all changes
149 commits
Select commit Hold shift + click to select a range
1cb8c80
Updated Reflow understanding doc
scottaohara Sep 5, 2024
8d0f1f9
Update reflow.html
scottaohara Sep 5, 2024
b1e767f
Update understanding/21/reflow.html
scottaohara Sep 6, 2024
7504dd2
Update understanding/21/reflow.html
scottaohara Sep 6, 2024
005e080
new graphics used in the examples
scottaohara Sep 10, 2024
60c3d71
add img folder to all new img src
scottaohara Sep 13, 2024
8c2236e
note for sticky/fixed content
scottaohara Sep 13, 2024
54adc01
fix missing word in 'what to do'
scottaohara Sep 13, 2024
627dbc5
add clarifying note to 320x256 section
scottaohara Sep 13, 2024
bf3d520
pull in missing content from the external doc
scottaohara Sep 13, 2024
6d1d428
revise initial intent paragraphs
scottaohara Sep 25, 2024
89cecfe
updates to reflow doc
scottaohara Oct 3, 2024
5e1ee84
content updates
scottaohara Oct 3, 2024
cfb36fb
Merge branch 'main' into scottaohara-reflow-understanding-rewrite
scottaohara Oct 4, 2024
a6dd504
Merge branch 'main' into scottaohara-reflow-understanding-rewrite
scottaohara Oct 15, 2024
2453865
updates per external feedback
scottaohara Oct 18, 2024
633eaa2
finish addressing external feedback
scottaohara Oct 18, 2024
473a63b
adjust example image widths
scottaohara Oct 23, 2024
030256f
re-arrange and fix p markup
scottaohara Oct 23, 2024
845c55a
rewording of reorganized content
scottaohara Oct 23, 2024
ca79e05
new example screenshot
scottaohara Oct 23, 2024
6296a9e
simplify wording
scottaohara Oct 23, 2024
9dcfcbd
addressing issue 887
scottaohara Oct 23, 2024
ac903e5
fix incomplete sentence and punctuation fixes
scottaohara Oct 23, 2024
a475898
Create g20x.html
scottaohara Oct 24, 2024
67e1761
Update understanding/21/reflow.html
scottaohara Oct 25, 2024
bc1d2f5
off screen to off-screen
scottaohara Oct 25, 2024
2fdad82
Update understanding/21/reflow.html
fstrr Oct 26, 2024
3670020
Update techniques/general/g20x.html
scottaohara Nov 4, 2024
b89e94f
address some of the feedback
scottaohara Nov 19, 2024
7597c58
updates to first intent paragraph
scottaohara Nov 19, 2024
9fe9bae
add more content to new indentation technique
scottaohara Nov 22, 2024
9db3dba
Update understanding/21/reflow.html
scottaohara Nov 22, 2024
9034790
Update understanding/21/reflow.html
scottaohara Nov 22, 2024
8ffffcf
remove in-page link / text that was broken
scottaohara Nov 22, 2024
acbbb3f
Update understanding/21/reflow.html
scottaohara Nov 22, 2024
389a46e
more wording updates
scottaohara Nov 22, 2024
dd46e18
Update understanding/21/reflow.html
scottaohara Nov 22, 2024
d2f5623
Update understanding/21/reflow.html
scottaohara Nov 22, 2024
ef48bf4
Update reflow.html
scottaohara Nov 22, 2024
295747f
Update understanding/21/reflow.html
scottaohara Nov 22, 2024
9eea703
Update understanding/21/reflow.html
scottaohara Nov 22, 2024
5f390a5
Move image to correct folder
patrickhlauke Nov 29, 2024
5e478ab
Subtly anonymise NPR examples, fix typos
patrickhlauke Nov 29, 2024
bf3507f
Tweak carousel images
patrickhlauke Nov 29, 2024
7db653d
Merge branch 'main' into scottaohara-reflow-understanding-rewrite
patrickhlauke Nov 29, 2024
17da9a4
Revise paragraph on table + paragraph reflow expectations
scottaohara Dec 6, 2024
5287894
Update understanding/21/reflow.html
scottaohara Dec 6, 2024
62dd7eb
Update understanding/21/reflow.html
scottaohara Dec 6, 2024
e720c0a
Update understanding/21/reflow.html
scottaohara Dec 6, 2024
37ff092
Update alt text for code-diff gif
scottaohara Dec 6, 2024
be502a6
Merge branch 'main' into scottaohara-reflow-understanding-rewrite
patrickhlauke Dec 7, 2024
9716370
Update understanding/21/reflow.html
scottaohara Dec 18, 2024
4067f0d
Update understanding/21/reflow.html
scottaohara Dec 18, 2024
bb187a5
Working example of a new horizontally scrollable panel for the update…
giacomo-petri Dec 19, 2024
ccf6efa
Technique of a new horizontally scrollable panel for the updated refl…
giacomo-petri Dec 19, 2024
573a3dc
pull in suggestions
scottaohara Dec 19, 2024
75cd4c4
Merge branch 'main' into scottaohara-reflow-understanding-rewrite
patrickhlauke Dec 31, 2024
7bd05ba
intent revisions
scottaohara Jan 8, 2025
292aad8
Merge branch 'main' into scottaohara-reflow-understanding-rewrite
scottaohara Jan 17, 2025
22cf5e1
a few more intent updates
scottaohara Jan 21, 2025
d6b16ee
revert in brief text
scottaohara Jan 23, 2025
161fd19
new sections added, and further rewording
scottaohara Jan 23, 2025
0a12d36
Merge branch 'main' into scottaohara-reflow-understanding-rewrite
scottaohara Jan 24, 2025
d1e83a1
Add files via upload
scottaohara Jan 24, 2025
1d98aa6
Rename g20x.html to g301.html
scottaohara Jan 24, 2025
b2c67a3
Rename g20x2.html to g302.html
scottaohara Jan 24, 2025
2d7de42
significant restructuring of the understanding doc
scottaohara Jan 25, 2025
41a7bfd
fix typo
scottaohara Jan 31, 2025
c4412a2
cut down initial note
scottaohara Feb 4, 2025
b5250f4
cutting down first note some more
scottaohara Feb 4, 2025
4ffe380
Delete understanding/21/img/reflow-macbook-resolutions.jpg.jpg
scottaohara Feb 4, 2025
94c36c4
simplify figcaption text
scottaohara Feb 4, 2025
b984ba5
revise more content
scottaohara Feb 4, 2025
ac01e6f
Fix image file extension for figure 16
scottaohara Feb 4, 2025
77ff758
relocate content from note 1
scottaohara Feb 4, 2025
b762a5e
code snippet working examples
scottaohara Feb 4, 2025
b67b061
Update index.html
scottaohara Feb 4, 2025
89fc3bf
revise 301 tech
scottaohara Feb 5, 2025
d4eb537
revise g301
scottaohara Feb 5, 2025
9bcd667
add working example for new 301 tech
scottaohara Feb 5, 2025
795fd4c
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
aeded95
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
6aeeb00
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
b065239
revert merged suggestion
scottaohara Feb 6, 2025
b9707ec
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
54a691e
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
1028d0c
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
28b3c4c
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
7714c1d
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
3f1d823
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
0c181ef
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
333b9b5
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
a0c7e38
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
de88e1c
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
d3f4342
Update understanding/21/reflow.html
scottaohara Feb 6, 2025
739f907
Update understanding/21/reflow.html
scottaohara Feb 7, 2025
d83480a
Update understanding/21/reflow.html
scottaohara Feb 7, 2025
e729d5f
Update understanding/21/reflow.html
scottaohara Feb 7, 2025
0d448bd
Update understanding/21/reflow.html
scottaohara Feb 7, 2025
08503e5
Update understanding/21/reflow.html
scottaohara Feb 7, 2025
76bc862
Update understanding/21/reflow.html
scottaohara Feb 7, 2025
24e4e7b
Update understanding/21/reflow.html
scottaohara Feb 7, 2025
92cc454
Update understanding/21/reflow.html
scottaohara Feb 7, 2025
6f68917
Update understanding/21/reflow.html
scottaohara Feb 7, 2025
8d1a094
Update understanding/21/reflow.html
scottaohara Feb 7, 2025
b42e91e
Update understanding/21/reflow.html
scottaohara Feb 7, 2025
c32f5dd
Update understanding/21/reflow.html
scottaohara Feb 7, 2025
9a80c83
revise intro paragraph for 'reflowing websites and apps'
scottaohara Feb 7, 2025
89e32aa
adjust intro to 'content that can benefit from 2-d layout..." section
scottaohara Feb 7, 2025
0e1dca5
remove swimlanes and adjust content accordingly
scottaohara Feb 7, 2025
ce25641
Create .gitignore
scottaohara Feb 7, 2025
21d7ef1
add video files
scottaohara Feb 7, 2025
8c53c64
Rename carousel-pass-fail.mp4 to carousel-fail.mp4
scottaohara Feb 7, 2025
6a1a1a6
Add video elements and update carousel descriptions
scottaohara Feb 7, 2025
6c24b78
Delete understanding/21/video/.gitignore
scottaohara Feb 7, 2025
8e42728
Update image width from 550px to 320px
scottaohara Feb 7, 2025
778f719
Add files via upload
scottaohara Feb 7, 2025
fe61c6d
Update video source paths and content exception text
scottaohara Feb 7, 2025
44bcdd6
make videos smaller to take up less vertical space
scottaohara Feb 7, 2025
a21b5d4
address gundula's request
scottaohara Feb 11, 2025
c74a78b
pull in last of francis's suggestions
scottaohara Feb 11, 2025
9a9a3ae
add example files
scottaohara Feb 12, 2025
9457400
add new pass/fail example in the table/grid section
scottaohara Feb 12, 2025
cbac8a2
Merge branch 'main' into scottaohara-reflow-understanding-rewrite
scottaohara Feb 13, 2025
5eae0b9
Merge branch 'main' into scottaohara-reflow-understanding-rewrite
patrickhlauke Feb 14, 2025
1cb29a7
Comment out 'benefits' section in reflow.html
scottaohara Feb 14, 2025
952e023
Added 2nd example for comparison
giacomo-petri Feb 14, 2025
13f99ec
Add hyperlink and update content for clarity for program guide
scottaohara Feb 14, 2025
a9da106
Update nested list example descriptions and details
scottaohara Feb 14, 2025
36140b0
Merge branch 'main' into scottaohara-reflow-understanding-rewrite
scottaohara Feb 18, 2025
de68058
Adding two small videos to intent section
mbgower Feb 18, 2025
c894bef
Adding first image pair
mbgower Feb 18, 2025
b23499a
photo editor mockup
scottaohara Feb 18, 2025
cabcfd2
Update content and image in reflow.html
scottaohara Feb 18, 2025
7424d7f
Merge branch 'main' into scottaohara-reflow-understanding-rewrite
scottaohara Feb 19, 2025
1db93ae
Update understanding/21/reflow.html
fstrr Feb 19, 2025
7a05556
Update understanding/21/reflow.html
fstrr Feb 19, 2025
3d7f57d
Update understanding/21/reflow.html
fstrr Feb 19, 2025
bd7a63a
Add link to "electronic program guide" and update text resize section.
scottaohara Feb 21, 2025
829a647
Update working-examples/reflow-carousel-panel-horizontal-scroll/index…
fstrr Feb 21, 2025
26c3803
Update working-examples/reflow-carousel-panel-horizontal-scroll/index…
fstrr Feb 21, 2025
d3de87c
Merge branch 'main' into scottaohara-reflow-understanding-rewrite
scottaohara Feb 21, 2025
3d3a038
Rename new techniques sequentially after existing ones
kfranqueiro Mar 7, 2025
874fe86
Update G224 code indentation to be consistent with other techniques
kfranqueiro Mar 7, 2025
c63577e
Revert "Update G224 code indentation to be consistent with other tech…
kfranqueiro Mar 7, 2025
77799e5
removed console logs and fixed alt attributes
giacomo-petri Mar 7, 2025
3c634b8
escape code elements in example markup
scottaohara Mar 7, 2025
cc708e7
Update working-examples/reflow-indenting/index.html
scottaohara Mar 7, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
re-arrange and fix p markup
move the scoping of exceptions section into the exceptions section (preceded it, and that was weird)

also fixes a paragraph with a missing start tag
scottaohara authored Oct 23, 2024
commit 030256fdf3e901221f47bee8304c902fea9c7969
24 changes: 13 additions & 11 deletions understanding/21/reflow.html
Original file line number Diff line number Diff line change
@@ -82,8 +82,18 @@ <h4>Horizontally scrolling section within a vertically scrolling page</h4>
</figure>


<h4>Understanding the scope of exceptions</h4>
<p>Where a section or sections of content within a web page require bi-directional scrolling, this does not grant an exception to other sections of content.</p>

</section>
<section>
<h3>Exceptions and content considerations for Reflow</h3>
<p>
For many 'traditional' web pages where its primary purpose is for a user to read distinct short or long-form <a href="https://www.w3.org/TR/WCAG/#dfn-section">sections of content</a>, the web page is generally expected to scroll vertically (when written in languages such as English). For users with low vision who may need to zoom the web page to read its content, it is generally expected that as the viewport size decreases due to the increase in zoom level, that the content of the page would reflow to fit within the confines of the viewport.</p>
<p>
Ideally, all sections of content would be able to reflow, allowing the content to be more easily read by users. However, not all content can reflow without degradation of the information or functionality the content represents - for instance, content which requires two-dimensional layout.
</p>

<h4>Understanding the scope of exceptions</h4>
<p>Where an exception for bi-directional scrolling would be applicable to a section or sections of content within a web page, such an exception does not extend to other sections of content which do not necessitate bi-directional scroling for understanding or functionality.</p>
<p>For example, while a data table would be given an exception to Reflow, presenting the table in a container which itself can scroll would help ensure other content which does not meet an exception could reflow as the viewport adjusts.</p>
<figure>
<img src="img/table-exception.jpg" alt="a table within a containing element that provides bi-directional scrollbars to view the content of the table. The content above and below the table reflows to fit within the available width of the viewport.">
@@ -118,14 +128,6 @@ <h4>Understanding the scope of exceptions</h4>
<p>By providing the video player a <code>max-width: 100%</code> CSS property, the video now fits within the container element and thus no horizontal scroll bar is present on the page.</p>
</figcaption>
</figure>
</section>
<section>
<h3>Exceptions and content considerations for Reflow</h3>
<p>
For many 'traditional' web pages where its primary purpose is for a user to read distinct short or long-form <a href="https://www.w3.org/TR/WCAG/#dfn-section">sections of content</a>, the web page is generally expected to scroll vertically (when written in languages such as English). For users with low vision who may need to zoom the web page to read its content, it is generally expected that as the viewport size decreases due to the increase in zoom level, that the content of the page would reflow to fit within the confines of the viewport.</p>
<p>
Ideally, all sections of content would be able to reflow, allowing the content to be more easily read by users. However, not all content can reflow without degradation of the information or functionality the content represents - for instance, content which requires two-dimensional layout.
</p>

<h4>Graphics and video</h4>
<p>For example, graphics and video are by their nature two-dimensional. Cutting up a graphic (photograph, drawing, graph, etc.) and stacking the blocks would make the graphic difficult to understand, if not rendering it unintelligible. However, it is possible to have these elements stay within the bounds of the viewport even as other content zooms to 400% (see advisory techniques).</p>
@@ -160,7 +162,7 @@ <h4>Interfaces with persistent toolbars</h4>
</figure>

<h4>Layout needed for usage and meaning</h4>
Additionally, many of these sorts of interfaces allow users to create content set to defined dimensions. For instance, presentations or documents based on physical printing or display sizes. These interfaces often allow for other related content to be created as directly related content to the primary author created content - e.g., presentation notes, editing comments/suggestions for a text document, dynamic messaging presented along with a message interface, etc. Each of these related sections of content often need to be presented in parallel to each other, and their understandability can diminish if their overall location were to change. For example, comments pertaining to a paragraph of text on one page of a document can be difficult to understand if they're not presented directly next to each other. Reflowing the comment inline with the document could cause the content of the document to be misrepresented or misconstrued as all being content written by the document's author, rather than separate authors (original author and editor).</p>
<p>Additionally, many of these sorts of interfaces allow users to create content set to defined dimensions. For instance, presentations or documents based on physical printing or display sizes. These interfaces often allow for other related content to be created as directly related content to the primary author created content - e.g., presentation notes, editing comments/suggestions for a text document, dynamic messaging presented along with a message interface, etc. Each of these related sections of content often need to be presented in parallel to each other, and their understandability can diminish if their overall location were to change. For example, comments pertaining to a paragraph of text on one page of a document can be difficult to understand if they're not presented directly next to each other. Reflowing the comment inline with the document could cause the content of the document to be misrepresented or misconstrued as all being content written by the document's author, rather than separate authors (original author and editor).</p>

<figure>
<img src="img/rich-document-with-comment.png" alt="online rich text document - on the left: the text document is displayed at dimensions representing the physical width and height of the page. On the right, a comment referring to highlighted text in the text document.">