mirror of
https://github.com/angular/angular
synced 2026-05-24 09:28:37 +00:00
When a sidebar item links to a page in a different category (e.g., Route
transition animations under Animations links to a Routing page), clicking
back navigates to the main menu instead of the originating category.
Store the originating category in NavigationState when clicking a
cross-referenced item, so the back button returns to the correct section.
(cherry picked from commit 8132a96884)
163 lines
5.8 KiB
HTML
163 lines
5.8 KiB
HTML
<ng-template
|
|
#navigationList
|
|
let-navigationItems
|
|
let-preserveOtherCategoryOrder="preserveOtherCategoryOrder"
|
|
>
|
|
<ul
|
|
class="docs-navigation-list docs-faceted-list"
|
|
[class.docs-navigation-list-dropdown]="isDropdownView()"
|
|
>
|
|
@for (itemGroup of groupItems(navigationItems, preserveOtherCategoryOrder); track $index) {
|
|
@let groupLabel = itemGroup[0];
|
|
@let items = itemGroup[1];
|
|
@let firstItem = items[0];
|
|
|
|
@if (groupLabel && collapsableLevel() !== firstItem.level && items.length > 1) {
|
|
<li class="docs-navigation-group">{{ groupLabel }}</li>
|
|
}
|
|
@for (item of items; track $index) {
|
|
<li
|
|
class="docs-faceted-list-item"
|
|
[class.single-entry]="items.length === 1 && item.level !== 1"
|
|
>
|
|
@let itemLabel = item.label!;
|
|
@if (item.path) {
|
|
@if (item.isExternal) {
|
|
<a
|
|
[href]="item.path"
|
|
target="_blank"
|
|
[matTooltip]="item.label"
|
|
[matTooltipDisabled]="itemLabel.length < 27"
|
|
matTooltipPosition="after"
|
|
[attr.aria-label]="item.label"
|
|
[matTooltipClass]="'API-tooltip'"
|
|
>
|
|
<span
|
|
[class.docs-external-link]="item.isExternal"
|
|
class="docs-faceted-list-item-text"
|
|
>
|
|
{{ item.label }}
|
|
</span>
|
|
|
|
@if (item.children && item.level! > 1 && !item.isExpanded) {
|
|
<docs-icon>chevron_right</docs-icon>
|
|
}
|
|
</a>
|
|
} @else {
|
|
<a
|
|
[routerLink]="'/' + item.path"
|
|
routerLinkActive="docs-faceted-list-item-active"
|
|
[routerLinkActiveOptions]="{
|
|
paths: 'exact',
|
|
queryParams: 'ignored',
|
|
matrixParams: 'ignored',
|
|
fragment: 'ignored',
|
|
}"
|
|
(click)="emitClickOnLink(item)"
|
|
[matTooltip]="item.label"
|
|
[matTooltipDisabled]="itemLabel.length < 27"
|
|
matTooltipPosition="after"
|
|
[attr.aria-label]="item.label"
|
|
[matTooltipClass]="'API-tooltip'"
|
|
>
|
|
<span class="docs-faceted-list-item-text">
|
|
{{ item.label }}
|
|
<ng-container *ngTemplateOutlet="itemStatus; context: {$implicit: item}" />
|
|
</span>
|
|
|
|
@if (item.children && !item.isExpanded) {
|
|
<docs-icon>chevron_right</docs-icon>
|
|
}
|
|
</a>
|
|
}
|
|
} @else {
|
|
<!-- Nav Section Header -->
|
|
@if (item.level !== collapsableLevel() && item.level !== expandableLevel()) {
|
|
<div
|
|
class="docs-secondary-nav-header"
|
|
[matTooltip]="item.label"
|
|
[matTooltipDisabled]="itemLabel.length < 27"
|
|
matTooltipPosition="after"
|
|
[attr.aria-label]="item.label"
|
|
[matTooltipClass]="'API-tooltip'"
|
|
>
|
|
<span class="docs-faceted-list-item-text">
|
|
{{ item.label }}
|
|
<ng-container *ngTemplateOutlet="itemStatus; context: {$implicit: item}" />
|
|
</span>
|
|
</div>
|
|
}
|
|
|
|
<!-- Nav Button Expand/Collapse -->
|
|
@if (
|
|
(item.children && item.level === expandableLevel()) ||
|
|
item.level === collapsableLevel()
|
|
) {
|
|
<button
|
|
type="button"
|
|
(click)="toggle(item)"
|
|
[attr.aria-label]="(item.isExpanded ? 'Collapse' : 'Expand') + ' ' + item.label"
|
|
[attr.aria-expanded]="item.isExpanded"
|
|
class="docs-secondary-nav-button"
|
|
[class.docs-faceted-list-item-active]="item | isActiveNavigationItem: activeItem()"
|
|
[class.docs-expanded-button]="item.children && item.level == collapsableLevel()"
|
|
[class.docs-not-expanded-button]="item.children && item.level === expandableLevel()"
|
|
[class.docs-nav-item-has-icon]="
|
|
item.children && item.level === expandableLevel() && !item.isExpanded
|
|
"
|
|
[matTooltip]="item.label"
|
|
[matTooltipDisabled]="itemLabel.length < 27"
|
|
matTooltipPosition="after"
|
|
[attr.aria-label]="item.label"
|
|
[matTooltipClass]="'API-tooltip'"
|
|
>
|
|
@if (item.children && item.level === collapsableLevel()) {
|
|
<docs-icon>arrow_back</docs-icon>
|
|
}
|
|
<span class="docs-faceted-list-item-text">
|
|
{{ item.label }}
|
|
<ng-container *ngTemplateOutlet="itemStatus; context: {$implicit: item}" />
|
|
</span>
|
|
</button>
|
|
}
|
|
}
|
|
@if (
|
|
item.level &&
|
|
displayItemsToLevel() > item.level &&
|
|
item.children &&
|
|
item.children.length > 0
|
|
) {
|
|
<ng-container
|
|
*ngTemplateOutlet="
|
|
navigationList;
|
|
context: {
|
|
$implicit: item.children,
|
|
level: item.level,
|
|
preserveOtherCategoryOrder: item.preserveOtherCategoryOrder,
|
|
}
|
|
"
|
|
/>
|
|
}
|
|
</li>
|
|
}
|
|
}
|
|
</ul>
|
|
</ng-template>
|
|
|
|
<ng-container
|
|
*ngTemplateOutlet="
|
|
navigationList;
|
|
context: {
|
|
$implicit: navigationItems(),
|
|
preserveOtherCategoryOrder: preserveOtherCategoryOrder(),
|
|
}
|
|
"
|
|
/>
|
|
|
|
<ng-template let-item #itemStatus>
|
|
@if (item.status === 'new') {
|
|
<span class="tag docs-new-item">New</span>
|
|
} @else if (item.status === 'updated') {
|
|
<span class="tag docs-updated-item">Updated</span>
|
|
}
|
|
</ng-template>
|