feat(aria/toolbar): adds toolbar-basic-horizontal-example to dev-app (#32106)

* feat(aria/toolbar): adds toolbar-basic-horizontal-example to dev-app

Adds toolbar-basic-horizontal-example to components-examples for
aria and implements it onto the dev-app aria-toolbar toolbar-demo.html
page.

* refactor(aria/toolbar): consolidate imports in dev-app

Updates toolbar-demo.ts to consolidate the imports from
components-examples for toolbar.

* feat(aria/toolbar): implement radiogroup in toolbar basic example

Adds radiogroup UI into the toolbar basic horizontal example. Also
attempts to improve accessibility by adding LiveAnnouncer on button
activation.

* refactor(aria/toolbar): fix lint error

Updates to fix naming convention lint error.

Author: essjay05

src/components-examples/aria/toolbar/BUILD.bazel

@@ -14,6 +14,7 @@ ng_project(
         "//:node_modules/@angular/forms",
         "//src/aria/radio-group",
         "//src/aria/toolbar",
+        "//src/cdk/a11y",
         "//src/material/checkbox",
         "//src/material/form-field",
         "//src/material/select",

src/components-examples/aria/toolbar/index.ts

@@ -1 +1,2 @@
+export {ToolbarBasicHorizontalExample} from './toolbar-basic-horizontal/toolbar-basic-horizontal-example';
 export {ToolbarConfigurableExample} from './toolbar-configurable/toolbar-configurable-example';

src/components-examples/aria/toolbar/toolbar-basic-horizontal/toolbar-basic-horizontal-example.html

@@ -0,0 +1,43 @@
+<div class="example-container">
+    <div ngToolbar class="example-toolbar" aria-label="Text Formatting Tools">
+        <button
+            ngToolbarWidget
+            class="example-radio-button"
+            (click)="format('bold')"
+            (keydown.enter)="format('bold')">
+            Bold
+        </button>
+        <button
+            ngToolbarWidget
+            class="example-radio-button"
+            (click)="format('italic')"
+            (keydown.enter)="format('italic')">
+            Italic
+        </button>
+        <button
+            ngToolbarWidget
+            class="example-radio-button"
+            (click)="format('underline')"
+            (keydown.enter)="format('underline')">
+            Underline
+        </button>
+        <ul
+            ngRadioGroup
+            class="example-radio-group"
+            aria-label="Select text alignment"
+        >
+            @for (alignment of alignments; track alignment) {
+            <li ngRadioButton [value]="alignment.value" class="example-radio-button">
+                <span class="example-radio-indicator"></span>
+                <span>{{ alignment.label }}</span>
+            </li>
+            }
+        </ul>
+        <button
+            ngToolbarWidget
+            class="example-radio-button"
+            [disabled]="true">
+            Disabled Action
+        </button>
+    </div>
+</div>

src/components-examples/aria/toolbar/toolbar-basic-horizontal/toolbar-basic-horizontal-example.ts

@@ -0,0 +1,28 @@
+import {Component} from '@angular/core';
+import {Toolbar, ToolbarWidget} from '@angular/aria/toolbar';
+import {RadioGroup, RadioButton} from '@angular/aria/radio-group';
+import {LiveAnnouncer} from '@angular/cdk/a11y';
+
+/** @title Basic Horizontal Toolbar Example */
+@Component({
+  selector: 'toolbar-basic-horizontal-example',
+  templateUrl: 'toolbar-basic-horizontal-example.html',
+  styleUrl: '../toolbar-common.css',
+  imports: [RadioButton, RadioGroup, Toolbar, ToolbarWidget],
+})
+export class ToolbarBasicHorizontalExample {
+  constructor(private _liveAnnouncer: LiveAnnouncer) {}
+  alignments = [
+    {value: 'left', label: 'Left'},
+    {value: 'center', label: 'Center'},
+    {value: 'right', label: 'Right'},
+  ];
+  format(tool: string) {
+    console.log(`Tool activated: ${tool}`);
+    this._liveAnnouncer.announce(`${tool} applied`, 'polite');
+  }
+  test(action: string) {
+    console.log(`Action triggered: ${action}`);
+    this._liveAnnouncer.announce(`${action} button activated`, 'polite');
+  }
+}

src/dev-app/aria-toolbar/toolbar-demo.css

@@ -1,6 +1,6 @@
 .example-radio-grid {
   display: grid;
-  grid-template-columns: repeat(auto-fit, minmax(500px, 1fr));
+  grid-template-columns: repeat(auto-fit, minmax(100%, 1fr));
   gap: 20px;
 }
 
@@ -18,3 +18,7 @@
 h4 {
   height: 36px;
 }
+
+.example-toolbar-container {
+  width: 100%;
+}

src/dev-app/aria-toolbar/toolbar-demo.html

@@ -1,7 +1,11 @@
 <div>
   <div class="example-radio-grid">
-    <div class="example-configurable-radio-container">
-        <h4>Configurable CDK Toolbar</h4>
+    <div class="example-toolbar-container">
+        <h2>Toolbar Basic Horizontal</h2>
+        <toolbar-basic-horizontal-example></toolbar-basic-horizontal-example>
+    </div>
+    <div class="example-configurable-radio-container example-toolbar-container">
+        <h2>Configurable CDK Toolbar</h2>
         <toolbar-configurable-example></toolbar-configurable-example>
     </div>
   </div>

src/dev-app/aria-toolbar/toolbar-demo.ts

@@ -7,11 +7,14 @@
  */
 
 import {ChangeDetectionStrategy, Component, ViewEncapsulation} from '@angular/core';
-import {ToolbarConfigurableExample} from '@angular/components-examples/aria/toolbar';
+import {
+  ToolbarBasicHorizontalExample,
+  ToolbarConfigurableExample,
+} from '@angular/components-examples/aria/toolbar';
 
 @Component({
   templateUrl: 'toolbar-demo.html',
-  imports: [ToolbarConfigurableExample],
+  imports: [ToolbarBasicHorizontalExample, ToolbarConfigurableExample],
   styleUrl: './toolbar-demo.css',
   encapsulation: ViewEncapsulation.None,
   changeDetection: ChangeDetectionStrategy.OnPush,