docs/src/app/routes.ts - main - githubmirror/components

docs/src/app/routes.ts
94 строки3 KB
Kristiyan Kostadinov
docs: make external redirects smoother (#32438)
01 дек 2025, 21:06
01 дек 2025, 21:062494f0a
/**
 * @license
 * Copyright Google LLC All Rights Reserved.
 *
 * Use of this source code is governed by an MIT-style license that can be
 * found in the LICENSE file at https://angular.dev/license
 */

import {Component} from '@angular/core';
import {Route, Routes} from '@angular/router';
import {CanActivateComponentSidenav} from './pages/component-sidenav/component-sidenav-can-load-guard';

@Component({template: ''})
export class RedirectPlaceholder {}

function externalRedirect(target: string): Partial<Route> {
  return {
    // The router requires a `component`.
    component: RedirectPlaceholder,
    canActivate: [
      () => {
        window.location.href = target;
        return false;
      },
    ],
  };
}

export const MATERIAL_DOCS_ROUTES: Routes = [
  {
    path: '',
    pathMatch: 'full',
    loadComponent: () => import('./pages/homepage').then(m => m.Homepage),
  },
  {path: 'categories', redirectTo: '/components/categories'},
  {path: 'cdk', pathMatch: 'full', redirectTo: '/cdk/categories'},
  {path: 'components', pathMatch: 'full', redirectTo: '/components/categories'},
  {
    path: 'guides',
    loadComponent: () => import('./pages/guide-list').then(m => m.GuideList),
  },
  // Since https://github.com/angular/components/pull/9574, the cdk-table guide became the overview
  // document for the cdk table. To avoid any dead / broken links, we redirect to the new location.
  {path: 'guide/cdk-table', redirectTo: '/cdk/table/overview'},
  // Component harness, drag & drop docs have moved to angular.dev
  {
    path: 'cdk/testing',
    ...externalRedirect('https://angular.dev/guide/testing/component-harnesses-overview'),
  },
  {
    path: 'cdk/testing/api',
    ...externalRedirect('https://angular.dev/api#angular_cdk_testing'),
  },
  {
    path: 'cdk/testing/:tab',
    ...externalRedirect('https://angular.dev/guide/testing/component-harnesses-overview'),
  },
  {
    path: 'cdk/drag-drop',
    ...externalRedirect('https://angular.dev/guide/drag-drop'),
  },
  {
    path: 'cdk/drag-drop/api',
    ...externalRedirect('https://angular.dev/api#angular_cdk_drag-drop'),
  },
  {
    path: 'cdk/drag-drop/:tab',
    ...externalRedirect('https://angular.dev/guide/drag-drop'),
  },
  {path: 'guide/system-variables', redirectTo: '/guide/theming-your-components'},
  // In v19, the theming system became based on system variables and the mat.theme mixin.
  // The following guides were consolidated into the main theming guide, which redirects
  // users to v18 docs if they are looking for this content.
  {path: 'guide/typography', redirectTo: '/guide/theming'},
  {path: 'guide/customizing-component-styles', redirectTo: '/guide/theming'},
  {path: 'guide/elevation', redirectTo: '/guide/theming'},
  {path: 'guide/duplicate-theming-styles', redirectTo: '/guide/theming'},
  {
    path: 'guide/:id',
    loadComponent: () => import('./pages/guide-viewer').then(m => m.GuideViewer),
  },
  // Needs to be defined before `:section` so it gets picked first when redirecting a missing page.
  {
    path: '404',
    loadComponent: () => import('./pages/not-found').then(m => m.NotFound),
  },
  {
    path: ':section',
    canActivate: [CanActivateComponentSidenav],
    loadChildren: () =>
      import('./pages/component-sidenav/component-sidenav').then(m => m.componentSidenavRoutes),
  },
  {path: '**', redirectTo: '/404'},
];