Tabulación

Divide colecciones de datos que están relacionados pero pertenecen a diferentes tipos.

Uso básico

Tabulación básica y concisa

Tabulación provee funcionalidad de tarjeta selectiva. Por defecto, la primer pestaña es seleccionada como activa, y es posible activar cualquier pestaña estableciendo el atributo de value.

User

Estilo de Tarjeta

Pestañas diseñadas como tarjetas.

Establecer type a card para obtener una pestaña diseñada como tarjeta.

User

Tarjeta con Bordes

Pestañas de tarjeta con bordes.

Establecer type a border-card.

Posición de tabulación

Es posible usar el atributo tab-position para establecer la posición de la tabulación.

Es posible escoger entre cuatro direcciones: tabPosition="left|right|top|bottom"

Pestaña Personalizada

Es posible usar slots con nombre para personalizar el contenido de la etiqueta de la pestaña.

Agregar y cerrar pestaña

Solo las pestañas de tipo tarjeta soportan adición y cierre.

Tab 2 content

Customized add button icon 2.4.0

Tab 2 content

Customized trigger button of new tab

Tab 2 content

Tabs API

Tabs Attributes

NombreDescripciónTipoDefault
model-value / v-modelbinding value, name of the selected tab, the default value is the name of first tabstring / number
typetipo de Pestañaenum''
closablesi la Pestaña es cerrablebooleanfalse
addablesi la Pestaña es añadiblebooleanfalse
editablesi la Pestaña es añadible y cerrablebooleanfalse
tab-positionposición de tabulaciónenumtop
stretchsi el ancho del tab se ajusta automáticamente a su contenedorbooleanfalse
before-leavefunción hook antes de cambiar de pestaña. Si se devuelve false o se devuelve una Promise y luego se rechaza, se evitará el cambio.Function() => true

Tabs Events

NombreDescripciónParámetros
tab-clickse lanza cuando se hace clic a una pestañaFunction
tab-changese dispara cuando activeName cambiaFunction
tab-removese lanza cuando se hace clic al botón tab-removeFunction
tab-addse lanza cuando se hace clic al botón tab-addFunction
editse lanza cuando los botones de tab-add y/o tab-remove son clickeadosFunction

Tabs Slots

NombreDescripciónSubtags
defaultpersonaliza el contenido por defectoTab-pane
add-icon 2.5.4customize add button icon
addIcon 2.4.0 deprecatedcustomize add button icon

Tabs Exposes

NombreDescripciónTipo
currentNamecurrent active pane nameobject
tabNavRef 2.9.10tab-nav component instanceobject

Tab-nav API

Tab-nav Exposes

NombreDescripciónType
scrollToActiveTabscroll to the active tabFunction
removeFocusremove focus statusFunction
tabListRef 2.9.10el_tabs__nav html elementobject
tabBarRef 2.9.10el_tabs__nav bar instanceobject

Tab-pane API

Tab-pane Attributes

NameDescriptionTypePor defecto
labeltítulo de la pestañastring''
disabledsi la Tabulación está deshabilitadabooleanfalse
nameidentifier corresponding to the name of Tabs, representing the alias of the tab-pane, the default is ordinal number of the tab-pane in the sequence, e.g. the first tab-pane is '0'string / number
closablesi la Pestaña es cerrablebooleanfalse
lazysi Tab es renderizado con lazy-loadbooleanfalse

Tab-pane Slots

NameDescription
defaultContenido de los Tab-pane's
labelEtiqueta de los Tab-pane's

Type Declarations

Show declarations
ts
type TabBarInstance = InstanceType<typeof TabBar> & {
  /** @description tab root html element */
  ref: barRef
  /** @description method to manually update tab bar style */
  update
}

Fuente

ComponentesStyleDocumentación

Contribuidores