diff options
author | Michal Klocek <michal.klocek@qt.io> | 2022-10-26 10:44:00 +0200 |
---|---|---|
committer | Michal Klocek <michal.klocek@qt.io> | 2022-11-30 13:20:02 +0100 |
commit | bf2804f3c4d3ba910c51b4dc0bacb55020dd4821 (patch) | |
tree | 4b8f454ee4328767510110b4348e780b98ab7e83 | |
parent | 9339c468795eb53a3b347582086c1256ef5562b7 (diff) |
Doc: Improve html5 geo location docs
Task-number: QTBUG-106498
Change-Id: I7e2b9d6b5cc3a3a9593303684d8f9eaf19f37dc8
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
(cherry picked from commit 6ff5d9691a392082c79fb07a89d9d8daf4a76500)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
-rw-r--r-- | src/core/doc/src/qtwebengine-features.qdoc | 16 |
1 files changed, 9 insertions, 7 deletions
diff --git a/src/core/doc/src/qtwebengine-features.qdoc b/src/core/doc/src/qtwebengine-features.qdoc index ebfe0f6ca..c058ba072 100644 --- a/src/core/doc/src/qtwebengine-features.qdoc +++ b/src/core/doc/src/qtwebengine-features.qdoc @@ -264,15 +264,17 @@ \section1 HTML5 Geolocation \QWE supports JavaScript Geolocation API with \l {Qt Positioning} as a - backend. The application has to explicitly allow the feature by using - QWebEnginePage::Geolocation or \l{WebEngineView::Feature} - {WebEngineView.Feature}. + backend. HTML5 geolocation is disabled by default. To explicitly allow it, the application + needs to listen to QWebEnginePage::featurePermissionRequested. Use QWebEnginePage::Geolocation + with a QWebEnginePage::setFeaturePermission() call or \l{WebEngineView::Feature} + with a \l{WebEngineView::grantFeaturePermission} {WebEngineView.grantFeaturePermission}() call + to grant the required permission. - If Qt Positioning has been built before \QWE then this feature can be + If \QWE was built with Qt Positioning support then this feature can be tested by using \l{WebEngine Widgets Maps Example}{Maps} and allowing it to - find the current position of the user. Note that on Windows an external GPS - receiver must be connected to the application. For more information, see - \l{Qt Positioning}. + find the current position of the user. + + See \l{Qt Positioning} for a possible backend setup like the GPS or IP based positioning. Support for this feature was added in Qt 5.5.0. |