feat(label): add link variant

Closes #2499

Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: bennypowers

.changeset/label-link-variant.md

@@ -0,0 +1,6 @@
+---
+"@patternfly/elements": minor
+---
+
+`pf-label`: added link variant. Set the `href` attribute to render the
+label as a clickable link.

elements/pf-label/pf-label.css

@@ -240,6 +240,23 @@ pf-button {
     margin-left: var(--pf-c-label__c-button--MarginLeft, 0.25rem);
 }
 
+#link {
+  color: inherit;
+  text-decoration: underline;
+}
+
+#link:hover {
+  text-decoration: none;
+}
+
+.link {
+  /** link label background color */
+  --pf-c-label--BackgroundColor: transparent;
+  /** link label border width */
+  --pf-c-label__content--before--BorderWidth: 0;
+  cursor: pointer;
+}
+
 svg {
   vertical-align:-0.125em;
   fill: currentColor;

elements/pf-label/pf-label.ts

@@ -2,6 +2,7 @@ import { LitElement, html, isServer, type TemplateResult } from 'lit';
 import { customElement } from 'lit/decorators/custom-element.js';
 import { property } from 'lit/decorators/property.js';
 import { classMap } from 'lit/directives/class-map.js';
+import { ifDefined } from 'lit/directives/if-defined.js';
 
 import { SlotController } from '@patternfly/pfe-core/controllers/slot-controller.js';
 
@@ -68,6 +69,9 @@ export class PfLabel extends LitElement {
   /** Text label for a removable label's close button */
   @property({ attribute: 'close-button-label' }) closeButtonLabel?: string;
 
+  /** When set, the label becomes a link. The label text renders inside an anchor element. */
+  @property({ reflect: true }) href?: string;
+
   /** Represents the state of the anonymous and icon slots */
   #slots = new SlotController(this, null, 'icon');
 
@@ -79,15 +83,17 @@ export class PfLabel extends LitElement {
   }
 
   override render(): TemplateResult<1> {
-    const { compact, truncated } = this;
+    const { compact, truncated, href } = this;
     const { variant, color, icon } = this;
     const hasIcon = !!icon || this.#slots.hasSlotted('icon');
+    const isLink = !!href;
     return html`
       <span id="container"
             class="${classMap({
               hasIcon,
               compact,
               truncated,
+              link: isLink,
               [variant ?? '']: !!variant,
               [color ?? '']: !!color })}">
         <!-- slot:
@@ -101,7 +107,11 @@ export class PfLabel extends LitElement {
                    .icon="${this.icon || undefined as unknown as string}"></pf-icon>
         </slot>
         <!-- summary: Must contain the text for the label. -->
+        ${isLink ? html`
+        <a id="link" href="${ifDefined(href)}"><slot id="text"></slot></a>
+        ` : html`
         <slot id="text"></slot>
+        `}
         <!-- summary: container for removable labels' close button -->
         <span part="close-button" ?hidden=${!this.removable}>
           <pf-button plain

elements/pf-label/test/pf-label.spec.ts

@@ -26,6 +26,10 @@ const exampleWithCompactAttribute = html`
   <pf-label compact>Default Compact</pf-label>
 `;
 
+const exampleWithHref = html`
+  <pf-label href="https://example.com">Link Label</pf-label>
+`;
+
 
 describe('<pf-label>', function() {
   before(function() {
@@ -140,4 +144,34 @@ describe('<pf-label>', function() {
     expect(containerStyles.getPropertyValue('padding-bottom')).to.equal('0px');
     expect(containerStyles.getPropertyValue('padding-left')).to.equal('8px'); // 0.5rem = 8px @ 16px browser default
   });
+
+  describe('with href attribute', function() {
+    let element: PfLabel;
+    beforeEach(async function() {
+      element = await createFixture<PfLabel>(exampleWithHref);
+      await element.updateComplete;
+    });
+
+    it('should render an anchor element', function() {
+      const link = element.shadowRoot!.querySelector('#link');
+      expect(link).to.be.an.instanceOf(HTMLAnchorElement);
+    });
+
+    it('should set the href on the anchor', function() {
+      const link = element.shadowRoot!.querySelector('#link') as HTMLAnchorElement;
+      expect(link.href).to.equal('https://example.com/');
+    });
+
+    it('should have a transparent background', function() {
+      const container = element.shadowRoot!.querySelector('#container')!;
+      expect(getComputedStyle(container).getPropertyValue('background-color')).to.equal('rgba(0, 0, 0, 0)');
+    });
+
+    it('should not render an anchor when href is not set', async function() {
+      const el = await createFixture<PfLabel>(example);
+      await el.updateComplete;
+      const link = el.shadowRoot!.querySelector('#link');
+      expect(link).to.be.null;
+    });
+  });
 });