url QML Value Type
un localisateur de ressources. Plus...
Description détaillée
Le type url fait référence à un localisateur de ressources (comme un nom de fichier, par exemple). Il peut être absolu, par exemple "http://qt-project.org", ou relatif, par exemple "pics/logo.png". Une URL relative est résolue par rapport à l'URL du composant qui la contient.
Par exemple, l'exemple suivant attribue une URL valide à la propriété Image::source, qui est de type url:
Image { source: "pics/logo.png" }
Lors de l'intégration avec C++, notez que toute valeur QUrl transmise à QML à partir de C++ est automatiquement convertie en valeur url, et vice-versa.
Vous pouvez également convertir votre url en objet URL afin d'accéder à ses composants et de les modifier :
var urlObject = new URL(url);
Remarque : dans Qt 5, les URL étaient automatiquement résolues en fonction du contexte actuel lors de leur affectation à une propriété url. Cela rendait impossible l'utilisation d'URL relatives et créait un comportement incohérent lors de la relecture d'une URL précédemment écrite dans une propriété. C'est pourquoi le comportement a été modifié dans Qt 6 : les URL ne sont plus automatiquement résolus lors de l'affectation. Les éléments individuels qui utilisent des URL doivent les résoudre eux-mêmes.
Remarque : lorsque vous faites référence à des fichiers stockés dans le système de ressources Qt à partir de Qt Qml, vous devez utiliser "qrc:///" au lieu de ":/", car Qt Qml exige des chemins d'accès URL. Les URL relatives résolues à partir de ce fichier utiliseront le même protocole.
En outre, les URL peuvent contenir des caractères codés à l'aide du schéma "percent-encoding" spécifié par la RFC 3986. Ces caractères seront préservés dans les propriétés de type url, afin de permettre au code QML de construire des valeurs d'URL précises.
Par exemple, un fichier local contenant le caractère "#", qui serait normalement interprété comme le début de l'élément "fragment" de l'URL, peut être consulté en encodant les caractères du nom du fichier :
Image { source: encodeURIComponent("/tmp/test#1.png") }
Ce type de valeur est fourni par le langage QML.
Voir aussi Types de valeurs 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.
