1. Home
  2. ChevronRightUi
  3. ChevronRightTabs

Tabs

Contenedor de pestañas de diseño componible para alternar entre vistas.

La primitiva Tabs proporciona una estructura de componente modular y navegable por teclado para organizar contenido en directorios de paneles discretos.


ImportaciónLink

import { Tabs } from 'boltdocs/primitives'

Inicio RápidoLink

Compón botones y paneles de pestañas usando subcomponentes:

import React, { useState } from 'react'
import { Tabs } from 'boltdocs/primitives'

export default function CustomTabs() {
  const [activeTab, setActiveTab] = useState('tab-1')

  return (
    <Tabs>
      <Tabs.List className="border-b border-subtle mb-4">
        <Tabs.Item
          id="tab-1"
          selected={activeTab === 'tab-1'}
          onClick={() => setActiveTab('tab-1')}
          className="px-4 py-2 text-sm font-semibold data-[selected=true]:text-primary-500 border-b-2 border-transparent data-[selected=true]:border-primary-500"
        >
          Descripción General
        </Tabs.Item>
        <Tabs.Item
          id="tab-2"
          selected={activeTab === 'tab-2'}
          onClick={() => setActiveTab('tab-2')}
          className="px-4 py-2 text-sm font-semibold data-[selected=true]:text-primary-500 border-b-2 border-transparent data-[selected=true]:border-primary-500"
        >
          Referencia de API
        </Tabs.Item>
      </Tabs.List>

      <Tabs.Content>
        {activeTab === 'tab-1' && <div>Panel de descripción general del contenido...</div>}
        {activeTab === 'tab-2' && <div>Descripción detallada de la referencia de API...</div>}
      </Tabs.Content>
    </Tabs>
  )
}

Subcomponentes ComponiblesLink

La primitiva Tabs proporciona los siguientes espacios de nombres para personalización de diseño:

ComponenteEtiqueta HTMLDescripciónProps
Tabs.Root / Tabs<div>Envoltorio principal del bloque de pestañas de nivel superior.ComponentBaseProps
Tabs.List<div> (tablist)Contiene los disparadores de categorías de pestañas.ComponentBaseProps
Tabs.Item<button> (tab)La celda selector individual del botón de pestaña.Tabs.Item Props
Tabs.Content<div> (tabpanel)Contenedor de vista que envuelve las secciones de contenido activas.ComponentBaseProps
Tabs.Indicator<div>Una línea de resaltado de posicionamiento absoluto que muestra la pestaña activa.Tabs.Indicator Props

Props del ComponenteLink

ComponentBaseProps (Común)Link

PropiedadTipoPredeterminadoDescripción
childrenReactNodeundefinedElementos de contenido hijos.
classNamestringundefinedClases CSS utilitarias personalizadas.
styleCSSPropertiesundefinedConfiguraciones de estilo en línea.

Props de Tabs.ItemLink

PropiedadTipoPredeterminadoDescripción
idstringRequeridoClave selector única que coincide con el panel de contenido de la pestaña.
selectedbooleanfalseEstado de selección activa resaltada.
disabledbooleanfalsePreviene disparadores de clic de selección.
onClick() => voidundefinedManipulador de callback de selección activada.
onKeyDown(e: KeyboardEvent) => voidundefinedManipulador de callback de activación de pulsación de tecla.

Props de Tabs.IndicatorLink

PropiedadTipoPredeterminadoDescripción
styleCSSPropertiesundefinedEstilos de mapeo de coordenadas dinámicas (por ejemplo, transform, width).
Last updated on July 27, 2026

Was this page helpful?