docs: add reference links to ARIA (#32498)

SkyZeroZx · andrewseguin · commit 15ce9b492e7d · 2025-12-12T08:43:06.000-07:00
Adds see links in the ARIA components documentation to improve discoverability of related documentation and usage guides (cherry picked from commit c2c7669)
diff --git a/src/aria/accordion/accordion-content.ts b/src/aria/accordion/accordion-content.ts
@@ -26,6 +26,7 @@ import {DeferredContent} from '../private';
  * ```
  *
  * @developerPreview 21.0
+ * @see [Accordion](guide/aria/accordion)
  */
 @Directive({
   selector: 'ng-template[ngAccordionContent]',
diff --git a/src/aria/accordion/accordion-group.ts b/src/aria/accordion/accordion-group.ts
@@ -57,6 +57,7 @@ import {ACCORDION_GROUP} from './accordion-tokens';
  * ```
  *
  * @developerPreview 21.0
+ * @see [Accordion](guide/aria/accordion)
  */
 @Directive({
   selector: '[ngAccordionGroup]',
diff --git a/src/aria/accordion/accordion-panel.ts b/src/aria/accordion/accordion-panel.ts
@@ -37,6 +37,7 @@ import {DeferredContentAware, AccordionPanelPattern, AccordionTriggerPattern} fr
  * ```
  *
  * @developerPreview 21.0
+ * @see [Accordion](guide/aria/accordion)
  */
 @Directive({
   selector: '[ngAccordionPanel]',
diff --git a/src/aria/accordion/accordion-trigger.ts b/src/aria/accordion/accordion-trigger.ts
@@ -37,6 +37,7 @@ import {ACCORDION_GROUP} from './accordion-tokens';
  * ```
  *
  * @developerPreview 21.0
+ * @see [Accordion](guide/aria/accordion)
  */
 @Directive({
   selector: '[ngAccordionTrigger]',
diff --git a/src/aria/combobox/combobox-dialog.ts b/src/aria/combobox/combobox-dialog.ts
@@ -25,6 +25,11 @@ import {ComboboxPopup} from './combobox-popup';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Combobox](guide/aria/combobox)
+ * @see [Select](guide/aria/select)
+ * @see [Multiselect](guide/aria/multiselect)
+ * @see [Autocomplete](guide/aria/autocomplete)
  */
 @Directive({
   selector: 'dialog[ngComboboxDialog]',
diff --git a/src/aria/combobox/combobox-input.ts b/src/aria/combobox/combobox-input.ts
@@ -35,6 +35,11 @@ import {Combobox} from './combobox';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Combobox](guide/aria/combobox)
+ * @see [Select](guide/aria/select)
+ * @see [Multiselect](guide/aria/multiselect)
+ * @see [Autocomplete](guide/aria/autocomplete)
  */
 @Directive({
   selector: 'input[ngComboboxInput]',
diff --git a/src/aria/combobox/combobox-popup-container.ts b/src/aria/combobox/combobox-popup-container.ts
@@ -38,6 +38,11 @@ import {DeferredContent} from '../private';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Combobox](guide/aria/combobox)
+ * @see [Select](guide/aria/select)
+ * @see [Multiselect](guide/aria/multiselect)
+ * @see [Autocomplete](guide/aria/autocomplete)
  */
 @Directive({
   selector: 'ng-template[ngComboboxPopupContainer]',
diff --git a/src/aria/combobox/combobox-popup.ts b/src/aria/combobox/combobox-popup.ts
@@ -20,6 +20,11 @@ import {COMBOBOX} from './combobox-tokens';
  * exposing the popup's control pattern to the parent combobox.
  *
  * @developerPreview 21.0
+ *
+ * @see [Combobox](guide/aria/combobox)
+ * @see [Select](guide/aria/select)
+ * @see [Multiselect](guide/aria/multiselect)
+ * @see [Autocomplete](guide/aria/autocomplete)
  */
 @Directive({
   selector: '[ngComboboxPopup]',
diff --git a/src/aria/combobox/combobox.ts b/src/aria/combobox/combobox.ts
@@ -52,6 +52,11 @@ import {COMBOBOX} from './combobox-tokens';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Combobox](guide/aria/combobox)
+ * @see [Select](guide/aria/select)
+ * @see [Multiselect](guide/aria/multiselect)
+ * @see [Autocomplete](guide/aria/autocomplete)
  */
 @Directive({
   selector: '[ngCombobox]',
diff --git a/src/aria/grid/grid-cell-widget.ts b/src/aria/grid/grid-cell-widget.ts
@@ -36,6 +36,8 @@ import {GRID_CELL} from './grid-tokens';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Grid](guide/aria/grid)
  */
 @Directive({
   selector: '[ngGridCellWidget]',
diff --git a/src/aria/grid/grid-cell.ts b/src/aria/grid/grid-cell.ts
@@ -35,6 +35,8 @@ import {GRID_CELL, GRID_ROW} from './grid-tokens';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Grid](guide/aria/grid)
  */
 @Directive({
   selector: '[ngGridCell]',
diff --git a/src/aria/grid/grid-row.ts b/src/aria/grid/grid-row.ts
@@ -29,6 +29,8 @@ import {GRID_CELL, GRID_ROW} from './grid-tokens';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Grid](guide/aria/grid)
  */
 @Directive({
   selector: '[ngGridRow]',
diff --git a/src/aria/grid/grid.ts b/src/aria/grid/grid.ts
@@ -41,6 +41,8 @@ import {GRID_ROW} from './grid-tokens';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Grid](guide/aria/grid)
  */
 @Directive({
   selector: '[ngGrid]',
diff --git a/src/aria/listbox/listbox.ts b/src/aria/listbox/listbox.ts
@@ -45,6 +45,11 @@ import {LISTBOX} from './tokens';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Listbox](guide/aria/listbox)
+ * @see [Autocomplete](guide/aria/autocomplete)
+ * @see [Select](guide/aria/select)
+ * @see [Multiselect](guide/aria/multiselect)
  */
 @Directive({
   selector: '[ngListbox]',
diff --git a/src/aria/listbox/option.ts b/src/aria/listbox/option.ts
@@ -25,6 +25,11 @@ import {LISTBOX} from './tokens';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Listbox](guide/aria/listbox)
+ * @see [Autocomplete](guide/aria/autocomplete)
+ * @see [Select](guide/aria/select)
+ * @see [Multiselect](guide/aria/multiselect)
  */
 @Directive({
   selector: '[ngOption]',
diff --git a/src/aria/menu/menu-bar.ts b/src/aria/menu/menu-bar.ts
@@ -49,6 +49,9 @@ import {MENU_COMPONENT} from './menu-tokens';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
 @Directive({
   selector: '[ngMenuBar]',
diff --git a/src/aria/menu/menu-content.ts b/src/aria/menu/menu-content.ts
@@ -25,6 +25,9 @@ import {DeferredContent} from '../private';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
 @Directive({
   selector: 'ng-template[ngMenuContent]',
diff --git a/src/aria/menu/menu-item.ts b/src/aria/menu/menu-item.ts
@@ -26,6 +26,9 @@ import type {MenuBar} from './menu-bar';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
 @Directive({
   selector: '[ngMenuItem]',
diff --git a/src/aria/menu/menu-trigger.ts b/src/aria/menu/menu-trigger.ts
@@ -36,6 +36,9 @@ import type {Menu} from './menu';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
 @Directive({
   selector: 'button[ngMenuTrigger]',
diff --git a/src/aria/menu/menu.ts b/src/aria/menu/menu.ts
@@ -51,6 +51,9 @@ import {MENU_COMPONENT} from './menu-tokens';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
 @Directive({
   selector: '[ngMenu]',
diff --git a/src/aria/tabs/tab-content.ts b/src/aria/tabs/tab-content.ts
@@ -25,6 +25,8 @@ import {DeferredContent} from '../private';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Tabs](guide/aria/tabs)
  */
 @Directive({
   selector: 'ng-template[ngTabContent]',
diff --git a/src/aria/tabs/tab-list.ts b/src/aria/tabs/tab-list.ts
@@ -39,6 +39,8 @@ import type {Tab} from './tab';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Tabs](guide/aria/tabs)
  */
 @Directive({
   selector: '[ngTabList]',
diff --git a/src/aria/tabs/tab-panel.ts b/src/aria/tabs/tab-panel.ts
@@ -36,6 +36,8 @@ import {TABS} from './utils';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Tabs](guide/aria/tabs)
  */
 @Directive({
   selector: '[ngTabPanel]',
diff --git a/src/aria/tabs/tab.ts b/src/aria/tabs/tab.ts
@@ -35,6 +35,8 @@ import {HasElement, TABS} from './utils';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Tabs](guide/aria/tabs)
  */
 @Directive({
   selector: '[ngTab]',
diff --git a/src/aria/tabs/tabs.ts b/src/aria/tabs/tabs.ts
@@ -39,6 +39,8 @@ import {TABS} from './utils';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Tabs](guide/aria/tabs)
  */
 @Directive({
   selector: '[ngTabs]',
diff --git a/src/aria/toolbar/toolbar-widget-group.ts b/src/aria/toolbar/toolbar-widget-group.ts
@@ -25,6 +25,8 @@ import {TOOLBAR_WIDGET_GROUP} from './utils';
  * that have their own internal navigation.
  *
  * @developerPreview 21.0
+ *
+ * @see [Toolbar](guide/aria/toolbar)
  */
 @Directive({
   selector: '[ngToolbarWidgetGroup]',
diff --git a/src/aria/toolbar/toolbar-widget.ts b/src/aria/toolbar/toolbar-widget.ts
@@ -36,6 +36,8 @@ import type {ToolbarWidgetGroup} from './toolbar-widget-group';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Toolbar](guide/aria/toolbar)
  */
 @Directive({
   selector: '[ngToolbarWidget]',
diff --git a/src/aria/toolbar/toolbar.ts b/src/aria/toolbar/toolbar.ts
@@ -41,6 +41,8 @@ import {sortDirectives} from './utils';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Toolbar](guide/aria/toolbar)
  */
 @Directive({
   selector: '[ngToolbar]',
diff --git a/src/aria/tree/tree-item-group.ts b/src/aria/tree/tree-item-group.ts
@@ -39,6 +39,8 @@ import {sortDirectives} from './utils';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Tree](guide/aria/tree)
  */
 @Directive({
   selector: 'ng-template[ngTreeItemGroup]',
diff --git a/src/aria/tree/tree.ts b/src/aria/tree/tree.ts
@@ -58,6 +58,8 @@ import {sortDirectives} from './utils';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Tree](guide/aria/tree)
  */
 @Directive({
   selector: '[ngTree]',

Original file line number	Diff line number	Diff line change
`@@ -26,6 +26,7 @@ import {DeferredContent} from '../private';`
`26`	`26`	* ```
`27`	`27`	`*`
`28`	`28`	`* @developerPreview 21.0`
	`29`	`+ * @see [Accordion](guide/aria/accordion)`
`29`	`30`	`*/`
`30`	`31`	`@Directive({`
`31`	`32`	`selector: 'ng-template[ngAccordionContent]',`
Original file line number	Diff line number	Diff line change
`@@ -57,6 +57,7 @@ import {ACCORDION_GROUP} from './accordion-tokens';`
`57`	`57`	* ```
`58`	`58`	`*`
`59`	`59`	`* @developerPreview 21.0`
	`60`	`+ * @see [Accordion](guide/aria/accordion)`
`60`	`61`	`*/`
`61`	`62`	`@Directive({`
`62`	`63`	`selector: '[ngAccordionGroup]',`
Original file line number	Diff line number	Diff line change
`@@ -37,6 +37,7 @@ import {DeferredContentAware, AccordionPanelPattern, AccordionTriggerPattern} fr`
`37`	`37`	* ```
`38`	`38`	`*`
`39`	`39`	`* @developerPreview 21.0`
	`40`	`+ * @see [Accordion](guide/aria/accordion)`
`40`	`41`	`*/`
`41`	`42`	`@Directive({`
`42`	`43`	`selector: '[ngAccordionPanel]',`
Original file line number	Diff line number	Diff line change
`@@ -37,6 +37,7 @@ import {ACCORDION_GROUP} from './accordion-tokens';`
`37`	`37`	* ```
`38`	`38`	`*`
`39`	`39`	`* @developerPreview 21.0`
	`40`	`+ * @see [Accordion](guide/aria/accordion)`
`40`	`41`	`*/`
`41`	`42`	`@Directive({`
`42`	`43`	`selector: '[ngAccordionTrigger]',`
Original file line number	Diff line number	Diff line change
`@@ -36,6 +36,8 @@ import {GRID_CELL} from './grid-tokens';`
`36`	`36`	* ```
`37`	`37`	`*`
`38`	`38`	`* @developerPreview 21.0`
	`39`	`+ *`
	`40`	`+ * @see [Grid](guide/aria/grid)`
`39`	`41`	`*/`
`40`	`42`	`@Directive({`
`41`	`43`	`selector: '[ngGridCellWidget]',`