En esta página

Tutorial de QML 2: Componentes de QML

En este capítulo se añade un selector de color para cambiar el color del texto.

Texto «¡Hola, mundo!» en verde con seis celdas de colores debajo

Nuestro selector de color está formado por seis celdas de diferentes colores. Para evitar escribir el mismo código varias veces para cada celda, creamos un nuevo componente Cell. Un componente permite definir un nuevo tipo que podemos reutilizar en otros archivos QML. Un componente QML es como una «caja negra» que interactúa con el mundo exterior a través de propiedades, señales y funciones, y que, por lo general, se define en su propio archivo QML. (Para más detalles, consulta la documentación de Component ). El nombre del archivo del componente debe comenzar siempre con una letra mayúscula.

A continuación se muestra el código QML para « Cell.qml »:

import QtQuick

Item {
    id: container
    property alias cellColor: rectangle.color
    signal clicked(cellColor: color)

    width: 40; height: 25

    Rectangle {
        id: rectangle
        border.color: "white"
        anchors.fill: parent
    }

    MouseArea {
        anchors.fill: parent
        onClicked: container.clicked(container.cellColor)
    }
}

Guía paso a paso

El componente Cell

Item {
    id: container
    property alias cellColor: rectangle.color
    signal clicked(cellColor: color)

    width: 40; height: 25

El tipo raíz de nuestro componente es un ` Item ` con el contenedor` id `. Un ` Item ` es el tipo visual más básico en QML y se utiliza a menudo como contenedor para otros tipos.

    property alias cellColor: rectangle.color

Declaramos una propiedad ` cellColor `. Se puede acceder a esta propiedad desde fuera de nuestro componente, lo que nos permite instanciar las celdas con diferentes colores. Esta propiedad no es más que un alias de una propiedad ya existente: el color del rectángulo que compone la celda (véase «Enlace de propiedades»).

    signal clicked(cellColor: color)

Queremos que nuestro componente tenga también una señal a la que llamaremos «clicked», con un parámetro «cellColor» de tipo color. Más adelante utilizaremos esta señal para cambiar el color del texto en el archivo QML principal.

    Rectangle {
        id: rectangle
        border.color: "white"
        anchors.fill: parent
    }

Nuestro componente de celda es, básicamente, un rectángulo de color con la propiedad « id ».

La propiedad « anchors.fill » es una forma práctica de establecer el tamaño de un tipo visual. En este caso, el rectángulo tendrá el mismo tamaño que su padre (véase «Diseño basado en anclajes»).

    MouseArea {
        anchors.fill: parent
        onClicked: container.clicked(container.cellColor)
    }

Para cambiar el color del texto al hacer clic en una celda, creamos un tipo « MouseArea » con el mismo tamaño que su elemento padre.

Un ` MouseArea ` define una señal llamada `clicked`. Cuando se activa esta señal, queremos emitir nuestra propia señal `clicked` con el color como parámetro.

El archivo QML principal

En nuestro archivo QML principal, utilizamos nuestro componente « Cell » para crear el selector de color:

import QtQuick

Rectangle {
    id: page
    width: 320; height: 480
    color: "lightgray"

    Text {
        id: helloText
        text: "Hello world!"
        y: 30
        anchors.horizontalCenter: page.horizontalCenter
        font.pointSize: 24; font.bold: true
    }

    Grid {
        id: colorPicker
        x: 4; anchors.bottom: page.bottom; anchors.bottomMargin: 4
        rows: 2; columns: 3; spacing: 3

        Cell { cellColor: "red"; onClicked: helloText.color = cellColor }
        Cell { cellColor: "green"; onClicked: helloText.color = cellColor }
        Cell { cellColor: "blue"; onClicked: helloText.color = cellColor }
        Cell { cellColor: "yellow"; onClicked: helloText.color = cellColor }
        Cell { cellColor: "steelblue"; onClicked: helloText.color = cellColor }
        Cell { cellColor: "black"; onClicked: helloText.color = cellColor }
    }
}

Creamos el selector de color colocando 6 celdas de diferentes colores en una cuadrícula.

        Cell { cellColor: "red"; onClicked: helloText.color = cellColor }

Cuando se activa la señal «clicked» de nuestra celda, queremos establecer el color del texto en el valor de «cellColor» pasado como parámetro. Podemos reaccionar a cualquier señal de nuestro componente a través de una propiedad con el nombre «onSignalName» (véase Atributos de señal).

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