En esta página

TabBar QML Type

Permite al usuario cambiar entre diferentes vistas o subtareas. Más...

Import Statement: import QtQuick.Controls
Inherits:

Container

Propiedades

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.

Esquema de la barra de pestañas que muestra la navegación por 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:

Barra de pestañas con las pestañas «Primera», «Segunda» y «Tercera» con anchos implícitos

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.

La barra de pestañas se puede deslizar para desplazarse por numerosas pestañas

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:

ConstanteDescripción
TabBar.HeaderLa barra de pestañas se encuentra en la parte superior, como encabezado de ventana o de página.
TabBar.FooterLa 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:

ConstanteDescripción
TabBar.HeaderLa barra de pestañas se encuentra en la parte superior, a modo de encabezado de ventana o página.
TabBar.FooterLa 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.