chore(labs): add helper isDisabled function for pseudo classes

PiperOrigin-RevId: 900894916

Author: asyncliz

labs/gb/components/button/button.ts

@@ -14,7 +14,10 @@ import {
   setupRipple,
 } from '@material/web/labs/gb/components/ripple/ripple.js';
 import {createClassMapDirective} from '@material/web/labs/gb/components/shared/directives.js';
-import {PSEUDO_CLASSES} from '@material/web/labs/gb/components/shared/pseudo-classes.js';
+import {
+  isDisabled,
+  PSEUDO_CLASSES,
+} from '@material/web/labs/gb/components/shared/pseudo-classes.js';
 import {type ClassInfo} from 'lit/directives/class-map.js';
 
 /** Button color configuration types. */
@@ -132,9 +135,7 @@ export function setupButton(
       // event listeners as well as prevent the default action. This is because
       // the underlying element may not actually be `:disabled`, such as an
       // anchor tag or a soft-disabled button.
-      if (
-        button.matches(`.${BUTTON_CLASSES.disabled},[aria-disabled="true"]`)
-      ) {
+      if (isDisabled(button)) {
         event.stopImmediatePropagation();
         event.preventDefault();
         return;

labs/gb/components/ripple/ripple.ts

@@ -5,7 +5,10 @@
  */
 
 import {createElementDirective} from '@material/web/labs/gb/components/shared/directives.js';
-import {PSEUDO_CLASSES} from '@material/web/labs/gb/components/shared/pseudo-classes.js';
+import {
+  PSEUDO_CLASSES,
+  isDisabled,
+} from '@material/web/labs/gb/components/shared/pseudo-classes.js';
 import {type ClassInfo} from 'lit/directives/class-map.js';
 
 /** Ripple classes. */
@@ -87,7 +90,7 @@ export function setupRipple(
   ripple.addEventListener(
     'pointerdown',
     (event: PointerEvent): void => {
-      if (ripple.matches(':disabled,.disabled')) return;
+      if (isDisabled(ripple)) return;
 
       // Set ripple position to the pointer position.
       const rect = ripple.getBoundingClientRect();

labs/gb/components/shared/pseudo-classes.ts

@@ -25,3 +25,13 @@ export const PSEUDO_CLASSES = {
   indeterminate: 'indeterminate',
   invalid: 'invalid',
 };
+
+/**
+ * Returns whether the element is disabled.
+ *
+ * @param element The element to check.
+ * @return true if the element is disabled.
+ */
+export function isDisabled(element: Element): boolean {
+  return element.matches('.disabled,:disabled,[disabled],[aria-disabled=true]');
+}

labs/gb/components/shared/pseudo-classes_test.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// import 'jasmine'; (google3-only)
+
+import {Environment} from '@material/web/testing/environment.js';
+import {html} from 'lit';
+import {isDisabled} from './pseudo-classes.js';
+
+describe('pseudo-classes', () => {
+  const env = new Environment();
+
+  describe('isDisabled()', () => {
+    it('returns true for elements with .disabled class', () => {
+      const root = env.render(html`<div class="disabled"></div>`);
+      expect(isDisabled(root.firstElementChild!)).toBeTrue();
+    });
+
+    it('returns true for elements with :disabled pseudo-class', () => {
+      const root = env.render(html`<button disabled></button>`);
+      expect(isDisabled(root.firstElementChild!)).toBeTrue();
+    });
+
+    it('returns true for elements with [disabled] attribute', () => {
+      const root = env.render(html`<div disabled></div>`);
+      expect(isDisabled(root.firstElementChild!)).toBeTrue();
+    });
+
+    it('returns true for elements with [aria-disabled=true] attribute', () => {
+      const root = env.render(html`<div aria-disabled="true"></div>`);
+      expect(isDisabled(root.firstElementChild!)).toBeTrue();
+    });
+
+    it('returns false for non-disabled elements', () => {
+      const root = env.render(html`<div></div>`);
+      expect(isDisabled(root.firstElementChild!)).toBeFalse();
+    });
+  });
+});