Zum Inhalt springen
Starlight

Routendaten Referenz

Das Routendatenobjekt von Starlight enthält Informationen über die aktuelle Seite. Erfahre mehr darüber, wie das Datenmodell von Starlight funktioniert, in der „Routendaten“-Anleitung.

In Astro-Komponenten greifst du auf die Routendaten von Astro.locals.starlightRoute zu:

src/components/Custom.astro
---
const { hasSidebar } = Astro.locals.starlightRoute;
---

In der Routen-Middleware greifst du auf die Routendaten aus dem Kontextobjekt zu, das an deine Middleware-Funktion übergeben wird:

src/routeData.ts
import { defineRouteMiddleware } from '@astrojs/starlight/route-data';


export const onRequest = defineRouteMiddleware((context) => {
  const { hasSidebar } = context.locals.starlightRoute;
});

starlightRoute

Abschnitt betitelt „starlightRoute“

Das Objekt starlightRoute hat die folgenden Eigenschaften:

dir

Abschnitt betitelt „dir“

Typ: 'ltr' | 'rtl'

Schreibrichtung der Seite.

lang

Abschnitt betitelt „lang“

Typ: string

BCP-47-Sprachkennzeichen für das Gebietsschema dieser Seite, z. B. de, zh-CN oder pt-BR.

locale

Abschnitt betitelt „locale“

Typ: string | undefined

Der Basispfad, unter dem eine Sprache angeboten wird. undefined für Root-Locale-Slugs.

siteTitle

Abschnitt betitelt „siteTitle“

Typ: string

Der Seitentitel für das Gebietsschema dieser Seite.

siteTitleHref

Abschnitt betitelt „siteTitleHref“

Typ: string

Der Wert für das Attribut href des Seitentitels, der auf die Homepage zurückverweist, z. B. /. Bei mehrsprachigen Websites wird hier das aktuelle Gebietsschema angegeben, z. B. /en/ oder /zh-cn/.

slug

Abschnitt betitelt „slug“

Typ: string

Der aus dem Dateinamen des Inhalts generierte Slug für diese Seite.

Diese Eigenschaft ist veraltet und wird in einer zukünftigen Version von Starlight entfernt werden. Stelle auf die neue Content Layer API um, indem du Starlights docsLoader benutzt und verwende stattdessen die Eigenschaft id.

id

Abschnitt betitelt „id“

Typ: string

Der Slug für diese Seite oder die eindeutige ID für diese Seite, die auf dem Dateinamen des Inhalts basiert, wenn du das Flag legacy.collections benutzt.

isFallback

Abschnitt betitelt „isFallback“

Typ: true | undefined

true, wenn diese Seite in der aktuellen Sprache unübersetzt ist und Fallback-Inhalte aus dem Standardgebiets­schema verwendet. Wird nur in mehrsprachigen Websites verwendet.

entryMeta

Abschnitt betitelt „entryMeta“

Typ: { dir: 'ltr' | 'rtl'; lang: string }

Gebietsschema-Metadaten für den Seiteninhalt. Du kannst von den Werten der Top-Level-Locale unterscheiden, wenn eine Seite Fallback-Inhalte verwendet.

entry

Abschnitt betitelt „entry“

Der Astro-Inhaltssammlungs­eintrag für die aktuelle Seite. Beinhaltet Frontmatter-Werte für die aktuelle Seite in entry.data.

entry: {
  data: {
    title: string;
    description: string | undefined;
    // usw.
  }
}

Erfahre mehr über die Form dieses Objekts in der Astros Eintragstyp-Sammlung Referenz.

Abschnitt betitelt „sidebar“

Typ: SidebarEntry[]

Seitennavigations­einträge für diese Seite.

hasSidebar

Abschnitt betitelt „hasSidebar“

Typ: boolean

Ob die Seitenleiste auf dieser Seite angezeigt werden soll oder nicht.

pagination

Abschnitt betitelt „pagination“

Typ: { prev?: Link; next?: Link }

Links zur vorherigen und nächsten Seite in der Seitenleiste, falls aktiviert.

toc

Abschnitt betitelt „toc“

Typ: { minHeadingLevel: number; maxHeadingLevel: number; items: TocItem[] } | undefined

Inhaltsverzeichnis für diese Seite, falls aktiviert.

headings

Abschnitt betitelt „headings“

Typ: { depth: number; slug: string; text: string }[]

Array aller Markdown-Überschriften, die aus der aktuellen Seite extrahiert wurden. Verwende stattdessen toc, wenn du einen Inhaltsverzeichnis-Komponenten erstellen willst, welches die Konfigurations­optionen von Starlight berücksichtigt.

lastUpdated

Abschnitt betitelt „lastUpdated“

Typ: Date | undefined

JavaScript Date Objekt, welches angibt, wann diese Seite zuletzt aktualisiert wurde, falls aktiviert.

editUrl

Abschnitt betitelt „editUrl“

Typ: URL | undefined

URL-Objekt für die Adresse, unter der diese Seite bearbeitet werden kann, falls aktiviert.

Abschnitt betitelt „head“

Typ: HeadConfig[]

Array mit allen Tags, die in den <head> der aktuellen Seite aufgenommen werden sollen. Enthält wichtige Tags wie <title> und <meta charset="utf-8">.

Hilfsmittel

Abschnitt betitelt „Hilfsmittel“

defineRouteMiddleware()

Abschnitt betitelt „defineRouteMiddleware()“

Verwende das Hilfsmethode defineRouteMiddleware(), um dein Route-Middleware-Modul zu definieren:

src/routeData.ts
import { defineRouteMiddleware } from '@astrojs/starlight/route-data';


export const onRequest = defineRouteMiddleware((context) => {
  // ...
});

StarlightRouteData-Typ

Abschnitt betitelt „StarlightRouteData-Typ“

Wenn du Code schreibst, der mit den Routendaten von Starlight arbeiten muss, kannst du den Typ StarlightRouteData importieren, damit er der Form von Astro.locals.starlightRoute entspricht.

Im folgenden Beispiel aktualisiert die Funktion usePageTitleInTOC() die Routedaten so, dass der Titel der aktuellen Seite als Beschriftung für den ersten Eintrag im Inhaltsverzeichnis verwendet wird und die Standard­beschriftung „Übersicht“ ersetzt. Mit dem Typ StarlightRouteData kannst du prüfen, ob die Änderungen der Routendaten gültig sind.

src/route-utils.ts
import type { StarlightRouteData } from '@astrojs/starlight/route-data';


export function usePageTitleInTOC(starlightRoute: StarlightRouteData) {
  const overviewLink = starlightRoute.toc?.items[0];
  if (overviewLink) {
    overviewLink.text = starlightRoute.entry.data.title;
  }
}

Diese Funktion kann dann von einer Route Middleware aufgerufen werden:

src/route-middleware.ts
import { defineRouteMiddleware } from '@astrojs/starlight/route-data';
import { usePageTitleInTOC } from './route-utils';


export const onRequest = defineRouteMiddleware((context) => {
  usePageTitleInTOC(context.locals.starlightRoute);
});