From 3706be09aa635f5be2cc27db1c39357d57b0b472 Mon Sep 17 00:00:00 2001
From: Christopher Torgalson <manager@bedlamhotel.com>
Date: Thu, 12 Jun 2025 11:07:58 -0400
Subject: [PATCH 1/6] feat: adds new variables to prev-next SDC

- prev_next_nav_aria_label: convenience prop allowing aria-label to be set
  without needing to create an attribute object
- prev_next_pre_content: slot allowing content to be inserted before the
  Prev and Next links inside the <nav> element
- prev_next_post_content: slot allowing content to be inserted after the
  Prev and Next links inside the <nav> element
---
 components/prev-next/prev-next.component.yml | 17 +++++++++++++++++
 components/prev-next/prev-next.twig          |  9 +++++++++
 2 files changed, 26 insertions(+)

diff --git a/components/prev-next/prev-next.component.yml b/components/prev-next/prev-next.component.yml
index f49d7574..7b9bd7e1 100644
--- a/components/prev-next/prev-next.component.yml
+++ b/components/prev-next/prev-next.component.yml
@@ -74,3 +74,20 @@ props:
       description: >
         The actual URL for the Next link. If empty, the entire link will
         not be rendered.
+    prev_next_nav_aria_label:
+      type: string
+      title: Prev-Next nav label
+      description: Translated label for parent <nav> element. Optional since
+        an aria-label may also be set in prevNextAttributes or an accessible
+        value provided as part of the prev_next_pre_content slot.
+slots:
+  prev_next_pre_content:
+    title: Prev-Next pre-content
+    description:
+      Use this slot to add arbitrary content prior to the nav list in the
+      component. This is useful for adding an accessible text label when
+      aria-label isn't used.
+  prev_next_post_content:
+    title: Prev-Next post-content
+    description:
+      Use this slot to add arbitrary content after nav list in the component.
diff --git a/components/prev-next/prev-next.twig b/components/prev-next/prev-next.twig
index c4488ffb..35b605c1 100644
--- a/components/prev-next/prev-next.twig
+++ b/components/prev-next/prev-next.twig
@@ -8,6 +8,9 @@
 #}
 
 {% set prevNextAttributes = create_attribute(prevNextAttributes|default({})) %}
+{% if prev_next_nav_aria_label is not empty %}
+  {% do prevNextAttributes.setAttribute('aria-label', prev_next_nav_aria_label) %}
+{% endif %}
 
 {% set icon_path = icon_path|default('@localgov_base/includes/icons') %}
 {% set prev_icon = prev_icon|default('chevron-left') %}
@@ -29,6 +32,9 @@
 #}
 
 <nav{{prevNextAttributes.addClass(classes)}}>
+  {% block prev_next_pre_content %}
+    {{ prev_next_pre_content }}
+  {% endblock %}
   <ul class="lgd-prev-next__list">
     {% if prev_url %}
       <li class="lgd-prev-next__list-item lgd-prev-next__list-item--prev">
@@ -69,4 +75,7 @@
       </li>
     {% endif %}
   </ul>
+  {% block postv_next_post_content %}
+    {{ prev_next_post_content }}
+  {% endblock %}
 </nav>

From 53c2b6b2ca12ffb2a94a40055f818cf1d180777e Mon Sep 17 00:00:00 2001
From: Christopher Torgalson <manager@bedlamhotel.com>
Date: Thu, 12 Jun 2025 11:10:48 -0400
Subject: [PATCH 2/6] feat: adds accessible label to Guides Prev-Next nav

---
 templates/block/guides-prev-next-block.html.twig | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/templates/block/guides-prev-next-block.html.twig b/templates/block/guides-prev-next-block.html.twig
index 88f224d1..b03ffa5c 100644
--- a/templates/block/guides-prev-next-block.html.twig
+++ b/templates/block/guides-prev-next-block.html.twig
@@ -1,3 +1,5 @@
+{% set nav_id = 'guides-prev-next' %}
+{% set prevNextAttributes = create_attribute({ id: nav_id }) %}
 {% set prev_next_type = 'guides' %}
 {#
   Probably the parent module should take responsibility for this.
@@ -9,4 +11,8 @@
 {% set prev_url = previous_url|default('') %}
 {% set prev_title = previous_title %}
 
-{% include 'localgov_base:prev-next' %}
+{% embed 'localgov_base:prev-next' %}
+  {% block prev_next_pre_content %}
+    <h2 class="visually-hidden" aria-labelledby="{{ nav_id }}">{{ 'Guides navigation'|t }}</h2>
+  {% endblock %}
+{% endembed %}

From c4393db6f1042113160549cb9931893132b88ad9 Mon Sep 17 00:00:00 2001
From: Christopher Torgalson <manager@bedlamhotel.com>
Date: Thu, 12 Jun 2025 11:11:16 -0400
Subject: [PATCH 3/6] feat: adds accessible label to Blog Prev-Next nav

---
 templates/block/localgov-blogs-prev-next-block.html.twig | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/templates/block/localgov-blogs-prev-next-block.html.twig b/templates/block/localgov-blogs-prev-next-block.html.twig
index 63619184..c977d405 100644
--- a/templates/block/localgov-blogs-prev-next-block.html.twig
+++ b/templates/block/localgov-blogs-prev-next-block.html.twig
@@ -1,2 +1,8 @@
+{% set nav_id = 'blogs-prev-next' %}
+{% set prevNextAttributes = create_attribute({ id: nav_id }) %}
 {% set prev_next_type = 'blog' %}
-{% include 'localgov_base:prev-next' %}
+{% embed 'localgov_base:prev-next' %}
+  {% block prev_next_pre_content %}
+    <h2 class="visually-hidden" aria-labelledby="{{ nav_id }}">{{ 'Blog navigation'|t }}</h2>
+  {% endblock %}
+{% endembed %}

From c42227ac8d64f38e98174c0fab84969bd3d4a1c5 Mon Sep 17 00:00:00 2001
From: Christopher Torgalson <manager@bedlamhotel.com>
Date: Thu, 12 Jun 2025 11:11:39 -0400
Subject: [PATCH 4/6] feat: adds accessible label to Publication Prev-Next nav

---
 .../navigation/book-navigation--publication.html.twig     | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/templates/navigation/book-navigation--publication.html.twig b/templates/navigation/book-navigation--publication.html.twig
index b6a7ec6a..01af8cc0 100644
--- a/templates/navigation/book-navigation--publication.html.twig
+++ b/templates/navigation/book-navigation--publication.html.twig
@@ -32,9 +32,15 @@
 #}
 
 {% if has_links %}
+  {% set nav_id = 'publication-prev-next' %}
+  {% set prevNextAttributes = create_attribute({ id: nav_id }) %}
   {# This uses previous_* vars, prev-next uses prev_*, so we translate. #}
   {% set show_title = true %}
   {% set prev_next_type = 'publications' %}
 
-  {% include 'localgov_base:prev-next' %}
+  {% embed 'localgov_base:prev-next' %}
+    {% block prev_next_pre_content %}
+      <h2 class="visually-hidden" aria-labelledby="{{ nav_id }}">{{ 'Publication navigation'|t }}</h2>
+    {% endblock %}
+  {% endembed %}
 {% endif %}

From 3712100358f1407d8eac80ae6de0cb45720bc555 Mon Sep 17 00:00:00 2001
From: Christopher Torgalson <manager@bedlamhotel.com>
Date: Thu, 12 Jun 2025 11:12:02 -0400
Subject: [PATCH 5/6] feat: adds accessible label to Step-by-Step Prev-Next nav

---
 ...-localgov-step-by-step-navigation--prev-next.html.twig | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/templates/views/views-view-list--localgov-step-by-step-navigation--prev-next.html.twig b/templates/views/views-view-list--localgov-step-by-step-navigation--prev-next.html.twig
index bd4a0224..4269821f 100644
--- a/templates/views/views-view-list--localgov-step-by-step-navigation--prev-next.html.twig
+++ b/templates/views/views-view-list--localgov-step-by-step-navigation--prev-next.html.twig
@@ -36,8 +36,14 @@
  */
 #}
 
+{% set nav_id = 'step-by-step-prev-next' %}
+{% set prevNextAttributes = create_attribute({ id: nav_id }) %}
 {% set prev_next_type = 'step_by_step' %}
 {% set prev_url = has_prev_step ? path('entity.node.canonical', {'node': prev_step_nid }) : '' %}
 {% set next_url = has_next_step ? path('entity.node.canonical', {'node': next_step_nid }) : ''  %}
 
-{% include 'localgov_base:prev-next' %}
+{% embed 'localgov_base:prev-next' %}
+  {% block prev_next_pre_content %}
+    <h2 class="visually-hidden" aria-labelledby="{{ nav_id }}">{{ 'Step by step navigation'|t }}</h2>
+  {% endblock %}
+{% endembed %}

From b7054d2f8b7ac6a1c0a20cf6f8dea1e1212553dc Mon Sep 17 00:00:00 2001
From: Christopher Torgalson <manager@bedlamhotel.com>
Date: Thu, 12 Jun 2025 11:13:32 -0400
Subject: [PATCH 6/6] feat: adds missing documentation for prevNextAttributes
 prop

---
 components/prev-next/prev-next.component.yml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/prev-next/prev-next.component.yml b/components/prev-next/prev-next.component.yml
index 7b9bd7e1..7fbe3b9e 100644
--- a/components/prev-next/prev-next.component.yml
+++ b/components/prev-next/prev-next.component.yml
@@ -10,6 +10,11 @@ status: stable
 props:
   type: object
   properties:
+    prevNextAttributes:
+      type: object
+      title: Prev-Next attributes
+      description: a Drupal attributes object. Will not override default
+        classes.
     prev_next_type:
       type: string
       title: Prev-Next type