Tutorial de QML 2: Componentes de QML
En este capítulo se añade un selector de color para cambiar el color del texto.

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: 25El 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.colorDeclaramos 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.