En esta página

Drawer QML Type

Panel lateral que se puede abrir y cerrar con un gesto de deslizamiento. Más...

Import Statement: import QtQuick.Controls
Inherits:

Popup

Propiedades

Descripción detallada

Drawer ofrece un panel lateral que se abre deslizando el dedo, similar a los que suelen utilizarse en las interfaces táctiles para proporcionar un punto central de navegación.

El «Drawer» puede colocarse en cualquiera de los cuatro bordes del elemento de contenido. El «Drawer» de la imagen superior está situado junto al borde izquierdo de la ventana. Para abrirlo, basta con «arrastrarlo» desde el borde izquierdo de la ventana.

import QtQuick
import QtQuick.Controls

ApplicationWindow {
    id: window
    visible: true

    Drawer {
        id: drawer
        width: 0.66 * window.width
        height: window.height

        Label {
            text: "Content goes here!"
            anchors.centerIn: parent
        }
    }
}

Drawer es un tipo especial de ventana emergente que reside en uno de los bordes de la ventana edges. Por defecto, Drawer se vincula a la ventana overlay y, por lo tanto, opera con coordenadas de ventana. También es posible establecer manualmente el parent en otro valor para que el panel se utilice en un espacio de coordenadas específico.

Drawer se puede configurar para que cubra solo una parte del borde de su ventana. El siguiente ejemplo ilustra cómo se puede colocar Drawer para que aparezca debajo del encabezado de una ventana:

import QtQuick
import QtQuick.Controls

ApplicationWindow {
    id: window
    visible: true

    header: ToolBar { }

    Drawer {
        y: header.height
        width: window.width * 0.6
        height: window.height - header.height
    }
}

La propiedad ` position ` determina qué parte del cajón queda visible, con un valor comprendido entre ` 0.0 ` y ` 1.0`. No es posible establecer la coordenada x (o los márgenes horizontales) de un cajón en el borde izquierdo o derecho de la ventana, ni la coordenada y (o los márgenes verticales) de un cajón en el borde superior o inferior de la ventana.

En la imagen anterior, el contenido de la aplicación se «desplaza» por la pantalla. Esto se consigue aplicando una traslación al contenido:

import QtQuick
import QtQuick.Controls

ApplicationWindow {
    id: window
    width: 200
    height: 228
    visible: true

    Drawer {
        id: drawer
        width: 0.66 * window.width
        height: window.height
    }

    Label {
        id: content

        text: "Aa"
        font.pixelSize: 96
        anchors.fill: parent
        verticalAlignment: Label.AlignVCenter
        horizontalAlignment: Label.AlignHCenter

        transform: Translate {
            x: drawer.position * content.width * 0.33
        }
    }
}

Si deseas que el contenido de la aplicación permanezca donde está cuando se abre el cajón, no apliques una traslación.

El cajón se puede configurar como un panel lateral persistente que no se puede cerrar estableciendo el cajón como « non-modal » y « non-interactive ». Consulta el ejemplo de la Galería para obtener más detalles.

Nota: En algunas plataformas, ciertos bordes pueden estar reservados para gestos del sistema y, por lo tanto, no se pueden utilizar con el «Drawer». Por ejemplo, los bordes superior e inferior pueden estar reservados para notificaciones del sistema y centros de control en Android e iOS.

Véase también SwipeView, Personalización de Drawer, Controles de navegación y Controles emergentes.

Documentación de propiedades

dragMargin : real

Esta propiedad indica la distancia desde el borde de la pantalla dentro de la cual las acciones de arrastre abrirán el cajón. Si se establece el valor en 0 o menos, se impide que el cajón se abra al arrastrar.

El valor por defecto es Application.styleHints.startDragDistance.

Véase también interactive.

edge : enumeration

Esta propiedad indica el borde de la ventana desde el que se abrirá el cajón. Los valores válidos son:

ConstanteDescripción
Qt.TopEdgeEl borde superior de la ventana.
Qt.LeftEdgeEl borde izquierdo de la ventana (por defecto).
Qt.RightEdgeEl borde derecho de la ventana.
Qt.BottomEdgeEl borde inferior de la ventana.

interactive : bool [since QtQuick.Controls 2.2 (Qt 5.9)]

Esta propiedad indica si el cajón es interactivo. Un cajón no interactivo no reacciona a los deslizamientos.

El valor por defecto es « true ».

Esta propiedad se introdujo en QtQuick.Controls 2.2 (Qt 5.9).

Véase también dragMargin.

position : real

Esta propiedad indica la posición del cajón con respecto a su posición final. Es decir, la posición será 0.0 cuando el cajón esté completamente cerrado, y 1.0 cuando esté completamente abierto.

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