From 8c296e1e767fd282280e6df23c432f5e06c7ca45 Mon Sep 17 00:00:00 2001
From: Peter Ringelmann <peter.ringelmann@nextcloud.com>
Date: Wed, 18 Mar 2026 21:22:19 +0100
Subject: [PATCH] fix(a11y): announce form submission success to screen readers

Signed-off-by: Peter Ringelmann <peter.ringelmann@nextcloud.com>
---
 src/views/Submit.vue | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/src/views/Submit.vue b/src/views/Submit.vue
index d26209d38..6ec979924 100644
--- a/src/views/Submit.vue
+++ b/src/views/Submit.vue
@@ -49,6 +49,11 @@
 				</p>
 			</header>
 
+			<!-- Screen-reader-only live region for submission success announcement -->
+			<div class="hidden-visually" aria-live="polite">
+				{{ successAnnouncement }}
+			</div>
+
 			<NcEmptyContent
 				v-if="loading"
 				class="forms-emptycontent"
@@ -323,6 +328,7 @@ export default {
 			answers: {},
 			loading: false,
 			success: false,
+			successAnnouncement: '',
 			/** Submit state of the form, true if changes are currently submitted */
 			submitForm: false,
 			showConfirmEmptyModal: false,
@@ -495,6 +501,22 @@ export default {
 	},
 
 	watch: {
+		success(newVal) {
+			if (newVal) {
+				// Delay populating the live region to avoid the announcement being
+				// swallowed by the simultaneous large DOM change (form replaced by
+				// success view). Screen readers need a moment to process the new DOM
+				// before a polite live region update registers.
+				setTimeout(() => {
+					this.successAnnouncement =
+						this.form.submissionMessage
+						|| t('forms', 'Thank you for completing the form!')
+				}, 100)
+			} else {
+				this.successAnnouncement = ''
+			}
+		},
+
 		hash() {
 			// If public view, abort. Should normally not occur.
 			if (this.publicView) {