En esta página

FlexboxLayout QML Type

El constructor QML «FlexboxLayout» proporciona un diseño flexible para los elementos rápidos. Más información...

Import Statement: import QtQuick.Layouts
Since: Qt 6.10
Inherits:

Item

Status: Technology preview

Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.

Propiedades

Propiedades adjuntas

Descripción detallada

FlexboxLayout permite organizar los elementos flexibles de forma similar a como lo hace el diseño de caja flexible de CSS. Internamente, Qt FlexboxLayout utiliza el motor yoga para calcular la geometría de los elementos flexibles. La biblioteca yoga es un subconjunto del diseño de caja flexible de CSS. Por lo tanto, FlexboxLayout puede limitarse a las características compatibles con la biblioteca yoga.

Nota: FlexboxLayout se ajusta a la versión 2.0 de la biblioteca yoga en cuanto a sus características.

Los elementos dentro de FlexboxLayout se pueden configurar con tamaños preferidos, mínimos y máximos a través de las propiedades asociadas de diseño existentes. Por ejemplo, si es necesario estirar un elemento dentro de FlexboxLayout, se puede establecer la propiedad asociada de diseño « Layout.fillWidth » o « Layout.fillHeight ».

Los elementos de un FlexboxLayout admiten estas propiedades asociadas:

Más información sobre las propiedades asociadas aquí.

Para poder utilizar este tipo de forma más eficiente, se recomienda comprender el mecanismo general del módulo de diseños « Qt Quick ». Consulte la Descripción general de los diseños «Qt Quick » para obtener más información.

Ejemplo de uso

El siguiente fragmento de código muestra un ejemplo minimalista del uso de QML FlexboxLayout para organizar los elementos rectangulares de forma más flexible

FlexboxLayout {
    id: flexLayout
    anchors.fill: parent
    wrap: FlexboxLayout.Wrap
    direction: FlexboxLayout.Row
    justifyContent: FlexboxLayout.JustifySpaceAround
    Rectangle {
        color: 'teal'
        implicitWidth: 200
        implicitHeight: 200
    }
    Rectangle {
        color: 'plum'
        implicitWidth: 200
        implicitHeight: 200
    }
    Rectangle {
        color: 'olive'
        implicitWidth: 200
        implicitHeight: 200
    }
    Rectangle {
        color: 'beige'
        implicitWidth: 200
        implicitHeight: 200
    }
    Rectangle {
        color: 'darkseagreen'
        implicitWidth: 200
        implicitHeight: 200
    }
}

Nota: Esta API se considera una vista previa técnica y puede cambiar o eliminarse en futuras versiones de Qt.

Véase también ColumnLayout, GridLayout, RowLayout, StackView y Qt Quick : Descripción general de los diseños.

Documentación de propiedades

alignContent : enumeration

Esta propiedad especifica la distribución de las líneas de flex a lo largo del eje transversal del diseño de la caja flexible.

Valores posibles:

ConstanteDescripción
FlexboxLayout.AlignStartLas líneas flexibles se alinean con el inicio del diseño de la caja flexible.
FlexboxLayout.AlignCenterLas líneas flexibles se alinean a lo largo del centro del diseño de la caja flexible.
FlexboxLayout.AlignEndLas líneas flexibles se alinean con el final del diseño de la caja flexible.
FlexboxLayout.AlignStretch(por defecto) Las líneas flexibles se estiran según la altura del diseño del flexbox.
FlexboxLayout.AlignSpaceBetweenLos espacios se distribuyen uniformemente entre las líneas y no hay espacio a lo largo del borde del diseño de la caja flexible.
FlexboxLayout.AlignSpaceAroundLos espacios se distribuyen uniformemente entre las líneas y hay un espacio de la mitad del tamaño en los bordes del diseño de la caja flexible.
FlexboxLayout.AlignSpaceEvenlyLos espacios se distribuyen uniformemente entre las líneas y los bordes del diseño de la caja flexible. No es compatible con Qt 6.10.

El valor por defecto es ` FlexboxLayout.AlignStart`.

alignItems : enumeration

Esta propiedad especifica la alineación de los elementos dentro de las líneas flexibles del diseño de caja flexible, y se alinea a lo largo del eje transversal (que es ortogonal al eje principal, tal y como se define mediante la propiedad direction). Esta propiedad puede ser anulada por los elementos del diseño de caja flexible a través de la propiedad asociada FlexboxLayout.alignSelf.

Valores posibles:

ConstanteDescripción
FlexboxLayout.AlignStart(por defecto) Los elementos se alinean con el inicio del eje transversal del diseño de caja flexible.
FlexboxLayout.AlignCenterLos elementos se alinean a lo largo del centro del eje transversal del diseño de caja flexible.
FlexboxLayout.AlignEndLos elementos se alinean con el extremo del eje transversal del diseño de la caja flexible.

Nota: Las alineaciones mencionadas en los valores posibles solo son aplicables a la propiedad `alignItems`.

El valor por defecto es « FlexboxLayout.AlignStart ».

columnGap : real

Esta propiedad establece la cantidad de espacio que debe aplicarse a la « FlexboxLayout » a lo largo del eje en línea. Al configurar esta propiedad, se anula el valor de « gap » que afecta al eje en línea.

El valor por defecto es « 0 ».

direction : enumeration

Esta propiedad determina la dirección de disposición de los elementos dentro del diseño de caja flexible y define el eje principal.

Valores posibles:

ConstanteDescripción
FlexboxLayout.Row(por defecto) Los elementos se disponen de izquierda a derecha.
FlexboxLayout.RowReversedLos elementos se disponen de derecha a izquierda.
FlexboxLayout.ColumnLos elementos se disponen de arriba abajo.
FlexboxLayout.ColumnReversedLos elementos se disponen de abajo hacia arriba.

El valor por defecto es « FlexboxLayout.Row ».

gap : real

Esta propiedad determina la cantidad de espacio que debe asignarse a la propiedad ` FlexboxLayout `, tanto a lo largo del eje inline como del eje block.

El valor por defecto es 0.

justifyContent : enumeration

Esta propiedad especifica la distribución de los elementos a lo largo del eje principal del diseño de caja flexible.

Valores posibles:

ConstanteDescripción
FlexboxLayout.JustifyStart(por defecto) Los elementos se alinean con el inicio del diseño de la caja flexible.
FlexboxLayout.JustifyCenterLos elementos se alinean a lo largo del centro del diseño de caja flexible.
FlexboxLayout.JustifyEndLos elementos se alinean al final del diseño de la caja flexible.
FlexboxLayout.JustifySpaceBetweenLos espacios se distribuyen uniformemente entre los elementos y no hay espacio en los bordes del diseño de la caja flexible.
FlexboxLayout.JustifySpaceAroundLos espacios se distribuyen de manera uniforme entre los elementos y se deja un espacio de la mitad del tamaño en los bordes del diseño de caja flexible.
FlexboxLayout.JustiftSpaceEvenlyLos espacios se distribuyen uniformemente entre los elementos y los bordes del diseño de caja flexible.

El valor por defecto es « FlexboxLayout.JustifyStart ».

rowGap : real

Esta propiedad indica la cantidad de espacio que debe aplicarse a la « FlexboxLayout » a lo largo del eje del bloque. Al configurar esta propiedad, se anula el valor de « gap » que afecta al eje del bloque.

El valor por defecto es « 0 ».

wrap : enumeration

Esta propiedad especifica si los elementos del diseño de caja flexible pueden ajustarse o no, lo cual ocurre cuando los elementos hijos desbordan el tamaño del diseño de caja flexible. Si los elementos se ajustan, se distribuirán en varias líneas en función de la condición de desbordamiento indicada. Cada línea ocupa el tamaño máximo del elemento a lo largo del eje transversal.

Valores posibles:

ConstanteDescripción
FlexboxLayout.WrapLos elementos se distribuyen en varias líneas dentro del diseño de caja flexible.
FlexboxLayout.NoWrap(por defecto) Los elementos no se ajustan y se disponen en una sola línea dentro del diseño de caja flexible.
FlexboxLayout.WrapReverseLos elementos se distribuyen en varias líneas dentro del diseño de caja flexible en sentido inverso.

El valor por defecto es « FlexboxLayout.NoWrap ».

Documentación de la propiedad adjunta

FlexboxLayout.alignSelf : enumeration [attached]

Esta propiedad adjunta permite alinear este elemento en el diseño de caja flexible a lo largo del eje transversal y anula la propiedad de diseño de caja flexible del elemento padre « alignItems ».

Por defecto, el elemento hijo hereda la alineación del padre y puede anular la propiedad de diseño de la caja flexible del padre « alignItems » con los valores « FlexboxLayout.AlignStart », « FlexboxLayout.AlignCenter » y « FlexboxLayout.AlignEnd ».

El valor por defecto es ` FlexboxLayout.AlignAuto`.

© 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.