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: | |
| Status: | Technology preview |
Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.
Propiedades
- alignContent : enumeration
- alignItems : enumeration
- columnGap : real
- direction : enumeration
- gap : real
- justifyContent : enumeration
- rowGap : real
- wrap : enumeration
Propiedades adjuntas
- alignSelf : enumeration
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:
- FlexboxLayout.alignSelf
- Layout.minimumWidth
- Layout.minimumHeight
- Layout.preferredWidth
- Layout.preferredHeight
- Layout.maximumWidth
- Layout.maximumHeight
- Layout.fillWidth
- Layout.fillHeight
- Layout.margins
- Layout.leftMargin
- Layout.rightMargin
- Layout.topMargin
- Layout.bottomMargin
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:
| Constante | Descripción |
|---|---|
FlexboxLayout.AlignStart | Las líneas flexibles se alinean con el inicio del diseño de la caja flexible. |
FlexboxLayout.AlignCenter | Las líneas flexibles se alinean a lo largo del centro del diseño de la caja flexible. |
FlexboxLayout.AlignEnd | Las 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.AlignSpaceBetween | Los 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.AlignSpaceAround | Los 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.AlignSpaceEvenly | Los 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:
| Constante | Descripción |
|---|---|
FlexboxLayout.AlignStart | (por defecto) Los elementos se alinean con el inicio del eje transversal del diseño de caja flexible. |
FlexboxLayout.AlignCenter | Los elementos se alinean a lo largo del centro del eje transversal del diseño de caja flexible. |
FlexboxLayout.AlignEnd | Los 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:
| Constante | Descripción |
|---|---|
FlexboxLayout.Row | (por defecto) Los elementos se disponen de izquierda a derecha. |
FlexboxLayout.RowReversed | Los elementos se disponen de derecha a izquierda. |
FlexboxLayout.Column | Los elementos se disponen de arriba abajo. |
FlexboxLayout.ColumnReversed | Los 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:
| Constante | Descripción |
|---|---|
FlexboxLayout.JustifyStart | (por defecto) Los elementos se alinean con el inicio del diseño de la caja flexible. |
FlexboxLayout.JustifyCenter | Los elementos se alinean a lo largo del centro del diseño de caja flexible. |
FlexboxLayout.JustifyEnd | Los elementos se alinean al final del diseño de la caja flexible. |
FlexboxLayout.JustifySpaceBetween | Los espacios se distribuyen uniformemente entre los elementos y no hay espacio en los bordes del diseño de la caja flexible. |
FlexboxLayout.JustifySpaceAround | Los 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.JustiftSpaceEvenly | Los 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:
| Constante | Descripción |
|---|---|
FlexboxLayout.Wrap | Los 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.WrapReverse | Los 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.