var QML Value Type
un tipo de propiedad genérico. Más...
Descripción detallada
El tipo ` var ` es un tipo de propiedad genérico que puede hacer referencia a cualquier tipo de datos.
Es equivalente a una variable normal de JavaScript. Por ejemplo, las propiedades «var» pueden almacenar números, cadenas, objetos, matrices y funciones:
Item {
property var aNumber: 100
property var aBool: false
property var aString: "Hello world!"
property var anotherString: String("#FF008800")
property var aColor: Qt.rgba(0.2, 0.3, 0.4, 0.5)
property var aRect: Qt.rect(10, 10, 10, 10)
property var aPoint: Qt.point(10, 10)
property var aSize: Qt.size(10, 10)
property var aVector3d: Qt.vector3d(100, 100, 100)
property var anArray: [1, 2, 3, "four", "five", (function() { return "six"; })]
property var anObject: { "foo": 10, "bar": 20 }
property var aFunction: (function() { return "one"; })
}Semántica de notificación de cambios
Es importante tener en cuenta que los cambios en las propiedades normales de los objetos JavaScript asignadas a una propiedad `var` no activarán actualizaciones de los enlaces que acceden a ellas. El ejemplo siguiente mostrará «El coche tiene 4 ruedas», ya que el cambio en la propiedad `wheels` no provocará la reevaluación del enlace asignado a la propiedad «text»:
Item {
property var car: new Object({wheels: 4})
Text {
text: "The car has " + car.wheels + " wheels";
}
Component.onCompleted: {
car.wheels = 6;
}
}Si, en cambio, el controlador onCompleted tuviera un « "car = new Object({wheels: 6})" », el texto se actualizaría para decir «El coche tiene 6 ruedas», ya que la propia propiedad «car» se modificaría, lo que provocaría que se emitiera una notificación de cambio.
Semántica de la inicialización de valores de propiedad
La sintaxis de QML establece que las llaves situadas a la derecha de una asignación de inicialización del valor de una propiedad denotan una asignación de enlace. Esto puede resultar confuso al inicializar una propiedad de tipo « var », ya que las llaves vacías en JavaScript pueden denotar tanto un bloque de expresión como una declaración de objeto vacío. Si deseas inicializar una propiedad de tipo « var » con un valor de objeto vacío, debes encerrar las llaves entre paréntesis.
Las propiedades de tipo « var » son « undefined » por defecto.
Por ejemplo:
Item {
property var first: {} // nothing = undefined
property var second: {{}} // empty expression block = undefined
property var third: ({}) // empty object
}En el ejemplo anterior, la propiedad ` first ` está vinculada a una expresión vacía, cuyo resultado es `undefined`. La propiedad ` second ` está vinculada a una expresión que contiene un único bloque de expresión vacío («{}»), que, de igual modo, tiene un resultado `undefined`. La propiedad third está vinculada a una expresión que se evalúa como una declaración de objeto vacía y, por lo tanto, la propiedad se inicializará con ese valor de objeto vacío.
Del mismo modo, los dos puntos en JavaScript pueden ser tanto una asignación de valor a una propiedad de objeto como una etiqueta de código. Por lo tanto, la inicialización de una propiedad «var» con una declaración de objeto también puede requerir el uso de paréntesis:
Item {
property var first: { example: 'true' } // example is interpreted as a label
property var second: ({ example: 'true' }) // example is interpreted as a property
property var third: { 'example': 'true' } // example is interpreted as a property
Component.onCompleted: {
console.log(first.example) // prints 'undefined', as "first" was assigned a string
console.log(second.example) // prints 'true'
console.log(third.example) // prints 'true'
}
}Véase también Tipos de valor de QML.
© 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.