summaryrefslogtreecommitdiffstats
path: root/src/core
diff options
context:
space:
mode:
authorMichal Klocek <michal.klocek@qt.io>2022-10-26 10:44:00 +0200
committerMichal Klocek <michal.klocek@qt.io>2022-11-18 15:10:31 +0100
commit6ff5d9691a392082c79fb07a89d9d8daf4a76500 (patch)
treef4921904c8081839cac4dec352ca4a92fd467ba6 /src/core
parent2aaaf875327b553eafa29a6ca943893f6e362ef9 (diff)
Doc: Improve html5 geo location docs
Task-number: QTBUG-106498 Pick-to: 6.4 Change-Id: I7e2b9d6b5cc3a3a9593303684d8f9eaf19f37dc8 Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Diffstat (limited to 'src/core')
-rw-r--r--src/core/doc/src/qtwebengine-features.qdoc16
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.