diff options
| author | Matthew Vogt <matthew.vogt@nokia.com> | 2012-06-19 10:24:01 +1000 |
|---|---|---|
| committer | Qt by Nokia <qt-info@nokia.com> | 2012-06-25 01:50:37 +0200 |
| commit | 2c4595ad02ff35011c24ea71c193d5a9710bec30 (patch) | |
| tree | a6eb3d3da97e2aafd3fff03de22b1d884bdd2d25 /src/qml/doc | |
| parent | 2753e9a795537df10c5a3b64ec9f6d8d81381837 (diff) | |
Decode directory separators in source URLs
URLs with encoded directory-separator characters are not correctly
processed by QUrl.
Task-number: QTBUG-25981
Change-Id: I78173ef44c4850774b56753335bea34db04c0735
Reviewed-by: Chris Adams <christopher.adams@nokia.com>
Diffstat (limited to 'src/qml/doc')
| -rw-r--r-- | src/qml/doc/src/typesystem/basictypes.qdoc | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/src/qml/doc/src/typesystem/basictypes.qdoc b/src/qml/doc/src/typesystem/basictypes.qdoc index 3c1b849b5b..c24787b4c8 100644 --- a/src/qml/doc/src/typesystem/basictypes.qdoc +++ b/src/qml/doc/src/typesystem/basictypes.qdoc @@ -167,6 +167,21 @@ See \l {QML Basic Types} for the list of basic types that are supported by the Q Usually you will only have to do this once, because relative URLs resolved from that file will use the same protocol. + URLs may contain encoded characters using the 'percent-encoding' scheme + specified by \l {http://tools.ietf.org/html/rfc3986}{RFC 3986}. These characters + will be preserved within properties of type \c url, to allow QML code to + construct precise URL values. An exception to this rule is the preemptive + decoding of directory-separator characters (\c '/') - these characters are decoded + to allow the URL to be correctly classified. + + For example, a local file containing a '#' character, which would normally be + interpreted as the beginning of the URL 'fragment' element, can be accessed by + encoding the characters of the file name: + + \qml + Image { source: encodeURIComponent("/tmp/test#1.png") } + \endqml + \sa {QML Basic Types} */ |