TabBar QML Type
Permite al usuario cambiar entre diferentes vistas o subtareas. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- contentHeight : real
(since QtQuick.Controls 2.2 (Qt 5.9)) - contentWidth : real
(since QtQuick.Controls 2.2 (Qt 5.9)) - position : enumeration
Propiedades adjuntas
- index : int
(since QtQuick.Controls 2.3 (Qt 5.10)) - position : enumeration
(since QtQuick.Controls 2.3 (Qt 5.10)) - tabBar : TabBar
(since QtQuick.Controls 2.3 (Qt 5.10))
Descripción detallada
TabBar ofrece un modelo de navegación basado en pestañas.

TabBar se rellena con controles de tipo « TabButton » y puede utilizarse junto con cualquier control de diseño o contenedor que disponga de la propiedad « currentIndex », como StackLayout o SwipeView
TabBar {
id: bar
width: parent.width
TabButton {
text: qsTr("Home")
}
TabButton {
text: qsTr("Discover")
}
TabButton {
text: qsTr("Activity")
}
}
StackLayout {
width: parent.width
currentIndex: bar.currentIndex
Item {
id: homeTab
}
Item {
id: discoverTab
}
Item {
id: activityTab
}
}Como se muestra arriba, TabBar suele rellenarse con un conjunto estático de botones de pestaña que se definen en línea como elementos hijos de la barra de pestañas. También es posible añadir elementos de tipo « add », « insert », « move » y « remove » de forma dinámica en tiempo de ejecución. Se puede acceder a los elementos mediante « itemAt()» o « contentChildren ».
Cuando TabBar se combina con otro contenedor, como SwipeView, es necesario establecer un enlace bidireccional entre la propiedad currentIndex de cada control. Para hacerlo sin romper los enlaces, evite establecer currentIndex directamente y, en su lugar, utilice setCurrentIndex(), por ejemplo. Consulte Managing the Current Index para obtener más información.
Para realizar una acción cuando cambia currentIndex, utilice el controlador de señales de cambio de la propiedad onCurrentIndexChanged:
onCurrentIndexChanged: {
print("currentIndex changed to", currentIndex)
// ...
}Redimensionamiento de las pestañas
De forma predeterminada, TabBar redimensiona sus botones para que se ajusten al ancho del control. El espacio disponible se distribuye equitativamente entre cada botón. El comportamiento predeterminado de redimensionamiento se puede anular estableciendo un ancho explícito para los botones.
El siguiente ejemplo ilustra cómo mantener cada botón de pestaña en su tamaño implícito en lugar de redimensionarlo para que se ajuste a la barra de pestañas:

TabBar {
width: parent.width
TabButton {
text: "First"
width: implicitWidth
}
TabButton {
text: "Second"
width: implicitWidth
}
TabButton {
text: "Third"
width: implicitWidth
}
}Pestañas deslizables
Si el ancho total de los botones supera el ancho disponible de la barra de pestañas, esta se vuelve automáticamente deslizable.

TabBar {
id: bar
width: parent.width
Repeater {
model: ["First", "Second", "Third", "Fourth", "Fifth"]
TabButton {
text: modelData
width: Math.max(100, bar.width / 5)
}
}
}Véase también « TabButton» , «Personalización de TabBar», «Controles de navegación», «Controles de contenedor» y «Gestión del foco en controles de Qt Quick ».
Documentación de propiedades
contentHeight : real [since QtQuick.Controls 2.2 (Qt 5.9)]
Esta propiedad almacena la altura del contenido. Se utiliza para calcular la altura implícita total de la barra de pestañas.
Nota: Esta propiedad está disponible en TabBar desde QtQuick.Controls 2.2 (Qt 5.9), pero se trasladó al tipo base Container en QtQuick.Controls 2.5 (Qt 5.12).
Esta propiedad se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
Véase también Container::contentHeight.
contentWidth : real [since QtQuick.Controls 2.2 (Qt 5.9)]
Esta propiedad contiene el ancho del contenido. Se utiliza para calcular el ancho implícito total de la barra de pestañas.
Nota: Esta propiedad está disponible en TabBar desde QtQuick.Controls 2.2 (Qt 5.9), pero se trasladó al tipo base Container en QtQuick.Controls 2.5 (Qt 5.12).
Esta propiedad se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
Véase también Container::contentWidth.
position : enumeration
Esta propiedad determina la posición de la barra de pestañas.
Nota: Si la barra de pestañas se asigna como encabezado o pie de página de ApplicationWindow o Page, la posición adecuada se establece automáticamente.
Valores posibles:
| Constante | Descripción |
|---|---|
TabBar.Header | La barra de pestañas se encuentra en la parte superior, como encabezado de ventana o de página. |
TabBar.Footer | La barra de pestañas se encuentra en la parte inferior, a modo de pie de página de la ventana o de la página. |
El valor por defecto depende del estilo.
Véase también ApplicationWindow::header, ApplicationWindow::footer, Page::header y Page::footer.
Documentación de la propiedad adjunta
TabBar.index : int [read-only attached, since QtQuick.Controls 2.3 (Qt 5.10)]
Esta propiedad adjunta contiene el índice de cada botón de pestaña de TabBar.
Se asocia a cada botón de pestaña del control « TabBar ».
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
TabBar.position : enumeration [read-only attached, since QtQuick.Controls 2.3 (Qt 5.10)]
Esta propiedad adjunta determina la posición de la barra de pestañas.
Se asocia a cada botón de pestaña de la clase ` TabBar`.
Valores posibles:
| Constante | Descripción |
|---|---|
TabBar.Header | La barra de pestañas se encuentra en la parte superior, a modo de encabezado de ventana o página. |
TabBar.Footer | La barra de pestañas se encuentra en la parte inferior, a modo de pie de página o de la ventana. |
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
TabBar.tabBar : TabBar [read-only attached, since QtQuick.Controls 2.3 (Qt 5.10)]
Esta propiedad adjunta contiene la barra de pestañas que gestiona este botón de pestaña.
Se asocia a cada botón de pestaña del control « TabBar ».
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.