Include ancestor generating a block container in the programatically determined link context definition (#1765)

carlosapaduarte · web-flow · commit d52fcf03ef5e · 2022-05-18T18:18:58.000+01:00
* Update programmatically-determined-link-context.md

* update examples to use the updated definition

* fix typo

* added heading to the prgrammatically determined link context

* updated condition of parent with text nodes to ancestor with display block

* Removed unused definition

* Remove unused definition

* Add inapplicable examples showcasing the new contexts considered

* Removed headings from programmatically determined context

* Removed `p` elements from the definition because they are handled by the display:block condition
diff --git a/_rules/links-with-identical-names-and-context-serve-equivalent-purpose-fd3a94.md b/_rules/links-with-identical-names-and-context-serve-equivalent-purpose-fd3a94.md
@@ -95,12 +95,12 @@ These two HTML `a` elements have the same [accessible name][] and [context][prog
 
 ```html
 <html lang="en">
-	<p>
+	<div>
 		Learn more (<a href="/test-assets/links-with-identical-names-serve-equivalent-purpose-b20e66/index.html">About us</a
 		>) and get in touch (<a href="/test-assets/links-with-identical-names-serve-equivalent-purpose-b20e66/redirect.html"
 			>About us</a
 		>)
-	</p>
+	</div>
 </html>
 ```
 
@@ -233,14 +233,14 @@ These two HTML `a` elements have the same [accessible name][] and [context][prog
 
 ```html
 <html lang="en">
-	<p>
+	<div>
 		Learn more (<a href="/test-assets/links-with-identical-names-serve-equivalent-purpose-b20e66/about/contact.html"
 			>Contact us</a
 		>) and get in touch (
 		<a href="/test-assets/links-with-identical-names-serve-equivalent-purpose-b20e66/admissions/contact.html"
 			>Contact us</a
 		>)
-	</p>
+	</div>
 </html>
 ```
 
@@ -370,6 +370,32 @@ These two `span` elements do not have a [semantic role][] of link.
 </html>
 ```
 
+#### Inapplicable Example 5
+
+These two HTML `a` elements have the same [accessible name][] and link to the [same resource][] but different [programmatically determined link contexts][programmatically determined link context].
+
+```html
+<html lang="en">
+	<div>
+		You can learn more in the
+		<a href="/test-assets/links-with-identical-names-serve-equivalent-purpose-b20e66/index.html">Contact us</a> page.
+	</div>
+	<div>
+		You can find contact information in the
+		<a href="/test-assets/links-with-identical-names-serve-equivalent-purpose-b20e66/index.html">Contact us</a> page.
+	</div>
+</html>
+```
+
+#### Inapplicable Example 6
+
+These two HTML `a` elements have the same [accessible name][] but different [programmatically determined link contexts][programmatically determined link context] because the `div` elements place them in different display blocks.
+
+```html
+<div><a href="https://www.w3.org/WAI/">Read more</a> about the W3C WAI</div>
+<div><a href="https://www.w3.org/International/">Read more</a> about the W3C internationalization</div>
+```
+
 [accessible name]: #accessible-name 'Definition of accessible name'
 [document]: https://dom.spec.whatwg.org/#concept-document 'Definition of document'
 [explicit role]: #explicit-role 'Definition of explicit role'
diff --git a/pages/glossary/programmatically-determined-link-context.md b/pages/glossary/programmatically-determined-link-context.md
@@ -11,7 +11,7 @@ input_aspects:
 The _programmatically determined context_ of a link (or _programmatically determined link context_) is the set of all elements that are [included in the accessibility tree][], and have one or more of the following relationships to the link:
 
 - being an [ancestor][] of the link in the [flat tree][] with a [semantic role][] of `listitem`; or
-- being the closest [ancestor][] of the link in the [flat tree][] that is a `p` element; or
+- being the closest [ancestor][] of the link in the [flat tree][] that generates a [block container][]; or
 - being the closest [ancestor][] of the link in the [flat tree][] that has a [semantic role][] of `cell` or `gridcell`; or
 - being a header cell [assigned][] to the closest [ancestor][] of the link in the [flat tree][] that has a [semantic role][] of `cell` or `gridcell`; or
 - being referenced by an `aria-describedby` attribute of the link.
@@ -20,8 +20,9 @@ This definition is based on the [WCAG definition of programmatically determined
 
 This definition assumes that the HTML document with the link is a document using HTML according to the specification.
 
-[ancestor]: https://dom.spec.whatwg.org/#concept-tree-ancestor
-[assigned]: https://html.spec.whatwg.org/multipage/tables.html#algorithm-for-assigning-header-cells
-[flat tree]: https://drafts.csswg.org/css-scoping/#flat-tree 'Definition of flat tree'
+[ancestor]: https://dom.spec.whatwg.org/#concept-tree-ancestor 'DOM, ancestor, 2021/11/29'
+[assigned]: https://html.spec.whatwg.org/multipage/tables.html#algorithm-for-assigning-header-cells 'HTML, algorithm for assigning header cells, 2021/11/29'
+[block container]: https://drafts.csswg.org/css-display/#block-container 'CSS Display Module Level 3, block container, 2022/01/17'
+[flat tree]: https://drafts.csswg.org/css-scoping/#flat-tree 'CSS Scoping Module Level 1, flat tree, 2021/11/29'
 [included in the accessibility tree]: #included-in-the-accessibility-tree 'Definition of included in the accessibility tree'
 [semantic role]: #semantic-role 'Definition of semantic role'
