url QML Value Type
un localizador de recursos. Más...
Descripción detallada
El tipo url hace referencia a un localizador de recursos (como un nombre de archivo, por ejemplo). Puede ser absoluto (por ejemplo, "http://qt-project.org") o relativo (por ejemplo, "pics/logo.png"). Una URL relativa se resuelve en relación con la URL del componente que la contiene.
Por ejemplo, a continuación se asigna una URL válida a la propiedad Image::source, que es del tipo url:
Image { source: "pics/logo.png" }
Al integrar con C++, tenga en cuenta que cualquier valor QUrl pasado a QML desde C++ se convierte automáticamente en un valor url, y viceversa.
Alternativamente, puede convertir su url en un objeto URL para acceder a sus componentes y modificarlos:
var urlObject = new URL(url);
Nota: En Qt 5, las URL se resolvían automáticamente en función del contexto actual al asignarlas a cualquier propiedad de url. Esto hacía imposible trabajar con URLs relativas y creaba un comportamiento inconsistente cuando se volvía a leer una URL previamente escrita en una propiedad. Por lo tanto, el comportamiento ha cambiado en Qt 6: las URLs ya no se resuelven automáticamente al asignarlas. Los elementos individuales que usan URLs tienen que resolverlas ellos mismos.
Nota: Cuando se haga referencia a archivos almacenados con el Sistema de Recursos Qt desde dentro de QML, se debe utilizar "qrc:///" en lugar de ":/", ya que QML requiere rutas URL. Las URL relativas resueltas desde dentro de ese archivo utilizarán el mismo protocolo.
Además, las URL pueden contener caracteres codificados utilizando el esquema "percent-encoding" especificado por RFC 3986. Estos caracteres se conservarán dentro de las propiedades de tipo url, para permitir que el código QML construya valores de URL precisos.
Por ejemplo, se puede acceder a un archivo local que contenga un carácter "#", que normalmente se interpretaría como el principio del elemento "fragment" de la URL, codificando los caracteres del nombre del archivo:
Image { source: encodeURIComponent("/tmp/test#1.png") }
Este tipo de valor lo proporciona el lenguaje QML.
Véase también Tipos de valor 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.
