En esta página

url QML Value Type

un localizador de recursos. Más...

Descripción detallada

El tipo « url » hace referencia a un localizador de recursos (como, por ejemplo, un nombre de archivo). Puede ser absoluto, p. ej., «http://qt-project.org», o relativo, p. ej., «pics/logo.png». Una URL relativa se resuelve en relación con la URL del componente que la contiene.

Por ejemplo, el siguiente código asigna una URL válida a la propiedad ` Image::source `, que es de tipo ` url`:

Image { source: "pics/logo.png" }

Al integrar con C++, ten en cuenta que cualquier valor de tipo « QUrl » pasado a QML desde C++ se convierte automáticamente en un valor de tipo « url », y viceversa.

Como alternativa, puedes convertir tu ` 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 tipo ` url `. Esto impedía trabajar con URL relativas y provocaba un comportamiento inconsistente al volver a leer una URL escrita previamente en una propiedad. Por lo tanto, el comportamiento se modificó en Qt 6: las URL ya no se resuelven automáticamente al asignarlas. Los elementos individuales que utilizan URL deben resolverlas por sí mismos.

Nota: Al hacer referencia a archivos almacenados con el sistema de recursos de Qt desde Qml, debes utilizar «qrc:///» en lugar de «:/», ya que Qml requiere rutas de URL. Las URL relativas resueltas desde ese archivo utilizarán el mismo protocolo.

Además, las URL pueden contener caracteres codificados mediante el esquema de «codificación por porcentaje» especificado en la 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 el carácter «#» —que normalmente se interpretaría como el inicio del elemento «fragmento» 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 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.