From 495ca01bb5dfb2ba32eb7554c7b1030e37fdb117 Mon Sep 17 00:00:00 2001
From: Zac-Smucker-Bryan <zacary.bryan@gmail.com>
Date: Fri, 10 Jul 2026 16:53:53 -0500
Subject: [PATCH 1/2] fix(button): sync aria description between host and
 native button

Adds @Watch('aria-description') to button.tsx before onAriaChanged
---
 core/src/components/button/button.tsx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/core/src/components/button/button.tsx b/core/src/components/button/button.tsx
index a1e7f72bf01..59e46bd2a3a 100644
--- a/core/src/components/button/button.tsx
+++ b/core/src/components/button/button.tsx
@@ -171,6 +171,7 @@ export class Button implements ComponentInterface, AnchorInterface, ButtonInterf
   @Watch('aria-checked')
   @Watch('aria-label')
   @Watch('aria-pressed')
+  @Watch('aria-description')
   onAriaChanged(newValue: string, _oldValue: string, propName: string) {
     this.inheritedAttributes = {
       ...this.inheritedAttributes,

From a7941a182dcbd0651115444be512fb0d5f95c5de Mon Sep 17 00:00:00 2001
From: Zac-Smucker-Bryan <zacary.bryan@gmail.com>
Date: Fri, 10 Jul 2026 16:57:48 -0500
Subject: [PATCH 2/2] test(button): add e2e test for aria-description sync

Set aria description and both buttons should match. Update aria description on host button, and both buttons should still match.
---
 .../components/button/test/a11y/button.e2e.ts | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/core/src/components/button/test/a11y/button.e2e.ts b/core/src/components/button/test/a11y/button.e2e.ts
index 585c0b5853d..fb712c99abe 100644
--- a/core/src/components/button/test/a11y/button.e2e.ts
+++ b/core/src/components/button/test/a11y/button.e2e.ts
@@ -148,3 +148,32 @@ configs({ directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
     });
   });
 });
+
+configs({ directions: ['ltr'] }).forEach(({ title, config }) => {
+  test.describe(title('button: aria description updates'), () => {
+    test('native button updates aria-description when host attribute changes', async ({ page }) => {
+      test.info().annotations.push({
+        type: 'issue',
+        description: 'https://github.com/ionic-team/ionic-framework/issues/30626',
+      });
+
+      await page.setContent(
+        `
+        <ion-button aria-label="label" aria-description="0">Button</ion-button>
+      `,
+        config
+      );
+
+      const host = page.locator('ion-button');
+      const nativeButton = host.locator('button');
+
+      await expect(nativeButton).toHaveAttribute('aria-description', '0');
+
+      await host.evaluate((el) => {
+        el.setAttribute('aria-description', '1');
+      });
+
+      await expect(nativeButton).toHaveAttribute('aria-description', '1');
+    });
+  });
+});