Pestañas
Para crear una interfaz con pestañas usa los componentes <Tabs>
y <TabItem>
.
Las pestañas son útiles para agrupar información equivalente donde un usuario solo necesita ver una de varias opciones.
Importación
Sección titulada «Importación»import { Tabs, TabItem } from '@astrojs/starlight/components';
Muestra una interfaz con pestañas usando los componentes <Tabs>
y <TabItem>
.
Cada <TabItem>
debe tener una label
para mostrar a los usuarios.
import { Tabs, TabItem } from '@astrojs/starlight/components';
<Tabs> <TabItem label="Estrellas">Sirius, Vega, Betelgeuse</TabItem> <TabItem label="Lunas">Io, Europa, Ganymede</TabItem></Tabs>
{% tabs %}{% tabitem label="Estrellas" %}Sirius, Vega, Betelgeuse{% /tabitem %}
{% tabitem label="Lunas" %}Io, Europa, Ganymede{% /tabitem %}{% /tabs %}
Sincronizar pestañas
Sección titulada «Sincronizar pestañas»Mantén sincronizados varios grupos de pestañas agregando el atributo syncKey
.
Todos las <Tabs>
en una página con el mismo valor de syncKey
mostrarán la misma etiqueta activa.
Esto permite que el lector elija una vez (por ejemplo, su sistema operativo o administrador de paquetes) y vea su elección persistida a través de las navegaciones de página.
Para sincronizar pestañas relacionadas, agrega una propiedad syncKey
idéntica a cada componente <Tabs>
y asegúrate de que todos usen las mismas etiquetas <TabItem>
:
import { Tabs, TabItem } from '@astrojs/starlight/components';
_Algunas estrellas:_
<Tabs syncKey="constelaciones"> <TabItem label="Orion">Bellatrix, Rigel, Betelgeuse</TabItem> <TabItem label="Gemini">Pollux, Castor A, Castor B</TabItem></Tabs>
_Algunos exoplanetas:_
<Tabs syncKey="constelaciones"> <TabItem label="Orion">HD 34445 b, Gliese 179 b, Wasp-82 b</TabItem> <TabItem label="Gemini">Pollux b, HAT-P-24b, HD 50554 b</TabItem></Tabs>
_Algunas estrellas:_
{% tabs syncKey="constelaciones" %}{% tabitem label="Orion" %}Bellatrix, Rigel, Betelgeuse{% /tabitem %}
{% tabitem label="Gemini" %}Pollux, Castor A, Castor B{% /tabitem %}{% /tabs %}
_Algunos exoplanetas:_
{% tabs syncKey="constelaciones" %}{% tabitem label="Orion" %}HD 34445 b, Gliese 179 b, Wasp-82 b{% /tabitem %}
{% tabitem label="Gemini" %}Pollux b, HAT-P-24b, HD 50554 b{% /tabitem %}{% /tabs %}
Agregar iconos a las pestañas
Sección titulada «Agregar iconos a las pestañas»Incluye un icono en un elemento de pestaña usando el atributo icon
establecido en el nombre de uno de los iconos integrados de Starlight para mostrar un icono junto a la etiqueta.
import { Tabs, TabItem } from '@astrojs/starlight/components';
<Tabs> <TabItem label="Estrellas" icon="star"> Sirius, Vega, Betelgeuse </TabItem> <TabItem label="Lunas" icon="moon"> Io, Europa, Ganymede </TabItem></Tabs>
{% tabs %}{% tabitem label="Estrellas" icon="star" %}Sirius, Vega, Betelgeuse{% /tabitem %}
{% tabitem label="Lunas" icon="moon" %}Io, Europa, Ganymede{% /tabitem %}{% /tabs %}
Props de <Tabs>
Sección titulada «Props de <Tabs>»Implementación: Tabs.astro
El componente <Tabs>
agrupa varios componentes <TabItem>
y acepta las siguientes propiedades:
syncKey
Sección titulada «syncKey»tipo: string
Una clave utilizada para mantener sincronizados varios grupos de pestañas en varias páginas.
Props de <TabItem>
Sección titulada «Props de <TabItem>»Implementación: TabItem.astro
Un conjunto de pestañas está compuesto por elementos de pestaña, cada uno con las siguientes propiedades:
requerido
tipo: string
Un elemento de pestaña debe incluir un atributo label
establecido en el texto que se mostrará en la pestaña.
tipo: string
Cada elemento de pestaña puede incluir un atributo icon
establecido en el nombre de uno de los iconos integrados de Starlight para mostrar un icono junto a la etiqueta.