En esta página

Qt Labs StyleKit

StyleKit es un sistema de estilos declarativo para los controles deQt Quick , basado en las plantillas de Qt Quick . Te permite definir un estilo visual completo para todos tus controles a partir de un único objeto Style, incluyendo compatibilidad con themes, el estilo de state-based y transitions. StyleKit se encarga automáticamente de la implementación subyacente de las plantillas, lo que te permite centrarte exclusivamente en aspectos visuales como colors, las dimensiones, borders y shadows.

Una de las principales ventajas de StyleKit es su sistema jerárquico de propiedades: basta con establecer una propiedad una sola vez en un tipo base, como abstractButton, para que se aplique automáticamente a todos los controles similares a botones. Se puede sobrescribir cuando sea necesario para controles o estados específicos. Los cambios en el estilo se reflejan al instante en todos los controles, lo que garantiza la coherencia al tiempo que permite una personalización detallada.

Para los controles que requieran un comportamiento personalizado más allá de lo que ofrece StyleKit, sigue siendo posible implementar plantillas personalizadas e integrarlas a la perfección junto con los controles con estilo de StyleKit.

Características principales

  • Estilización declarativa: una API de QML fácil de usar que te permite centrarte en el diseño en lugar de en la implementación
  • Valores por defecto jerárquicos: todas las propiedades se propagan. Configúralas una vez y sobrescríbelas cuando sea necesario
  • Estilo basado en estados: diseña apariencias distintas para los estados de desplazamiento del cursor, pulsado, enfocado, etc.
  • Transiciones animadas: define animaciones fluidas entre estados
  • Compatibilidad con temas: diseña temas claros y oscuros, así como tantos temas personalizados como desees
  • Variaciones: diseña múltiples variaciones de los mismos controles
  • Integración de paletas y fuentes: configura las paletas y las fuentes de los controles mediante QML

El siguiente ejemplo muestra un ejemplo básico de un estilo:

// PlainStyle.qml

import QtQuick
import Qt.labs.StyleKit

Style {
    control {
        padding: 6
        background {
            radius: 4
            width: 100
            height: 36
        }
        indicator {
            width: 20
            height: 20
            border.width: 1
        }
        handle {
            width: 20
            height: 20
            radius: 10
        }
    }

    button {
        background {
            width: 120
            shadow.opacity: 0.6
            shadow.verticalOffset: 2
            shadow.horizontalOffset: 2
            gradient: Gradient {
                GradientStop { position: 0.0; color: Qt.alpha("black", 0.0)}
                GradientStop { position: 1.0; color: Qt.alpha("black", 0.2)}
            }
        }
        pressed.background.scale: 0.95
    }

    slider {
        indicator.fillWidth: true
        indicator.height: 6
        indicator.radius: 3
    }

    light: Theme {
        applicationWindow {
            background.color: "whitesmoke"
        }
        control {
            text.color: "black"
            background.color: "#e8e8e8"
            background.border.color: "#c0c0c0"
            hovered.background.color: "#d0d0d0"
        }
        button {
            text.color: "white"
            background.color: "cornflowerblue"
            background.shadow.color: "gray"
            hovered.background.color: "royalblue"
        }
    }

    dark: Theme {
        applicationWindow {
            background.color: Qt.darker("gray", 2.0)
        }
        control {
            text.color: "white"
            background.color: "#3a3a3a"
            background.border.color: "#555555"
            hovered.background.color: "#4a4a4a"
        }
        button {
            background.color: "sandybrown"
            background.shadow.color: "black"
            hovered.background.color: Qt.darker("sandybrown", 1.2)
        }
    }
}

Así es como se configura el estilo en tu aplicación:

// Main.qml

import QtQuick
import Qt.labs.StyleKit

ApplicationWindow {
    id: app
    width: 1024
    height: 800
    visible: true

    // Assign the style to be used
    StyleKit.style: PlainStyle {}

    // Controls are used as normal
    Column {
        anchors.fill: parent
        anchors.margins: 10
        spacing: 10

        Button {
            text: "Button"
        }

        Slider {
            width: 200
        }
    }
}

Uso del módulo en tu proyecto

Los tipos QML del módulo están disponibles a través de la importación « QtQuick.labs.StyleKit ». Para utilizar los tipos, añade la siguiente instrucción de importación a tu archivo .qml:

import Qt.labs.StyleKit

Artículos y guías

Ejemplos

Clases de C++

QStyleKitStyle

Aplica un estilo de StyleKit de Qt Labs a Qt Widgets

tipos QML

AbstractStyle

Tipo base abstracto con propiedades comunes tanto a «Style» como a «Theme»

BorderStyle

Define el estilo del borde de un delegado

ControlStateStyle

Describe el estilo de un control en un estado determinado

ControlStyle

Define el estilo de un control en el estado normal

ControlStyleProperties

Define las propiedades personalizables de un control

CustomControl

Define el estilo de un control personalizado (no integrado)

CustomTheme

Define un tema personalizado con nombre

DelegateStyle

Define el aspecto visual de un elemento dentro de un control

HandleStyle

Define el estilo del controlador para controles como Switch, Slider y RangeSlider

ImageStyle

Define el estilo de la imagen de un delegado

IndicatorStyle

Define el estilo del indicador de un control

ShadowStyle

Define el estilo de la sombra proyectada de un delegado

StylableControls

Tipo base abstracto que contiene los tipos de control a los que se les puede aplicar un estilo

Style

Tipo raíz para una definición de estilo

StyleAnimation

Un tipo de conveniencia para animar propiedades de estilo

StyleKit

Un singleton para establecer y acceder al estilo actual

StyleKitDebug

Rastrea cómo se resuelven las propiedades de estilo para un control

StyleReader

Lee las propiedades del estilo activo para un control específico

StyleVariation

Define estilos alternativos para controles específicos

StyledItem

Representa un `DelegateStyle`

SubIndicatorStyle

Define el estilo para un delegado de subindicador

TextStyle

Define el estilo de texto para la etiqueta de un control

Theme

Define modificaciones de color y estilo para una combinación de colores

Licencias

Qt Labs StyleKit está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulte Licencias de Qt para obtener más detalles.

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