diff options
author | Jüri Valdmann <juri.valdmann@qt.io> | 2019-02-21 13:23:41 +0100 |
---|---|---|
committer | Kai Koehne <kai.koehne@qt.io> | 2019-02-22 13:18:06 +0000 |
commit | fd2acd57df7d62490a9a7c1f7b5b60ae50c51ce6 (patch) | |
tree | 813c1dcb4f13b4dab352ade495a334d09798e1d5 /src/webenginewidgets | |
parent | f5bad87426599ff52e382aa7e0698a7e4b4b62de (diff) |
Clarify documentation of QWebEnginePage::title()
Explain what happens when the HTML has no proper <title> defined and clarify the
meaning of 'by default': it refers to the state before load()/setUrl()/etc.
Fixes: QTBUG-71799
Change-Id: Ib2669007573b3ea53e205d9228237bae392f6f78
Reviewed-by: Michael Brüning <michael.bruning@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Diffstat (limited to 'src/webenginewidgets')
-rw-r--r-- | src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc | 6 | ||||
-rw-r--r-- | src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc | 4 |
2 files changed, 8 insertions, 2 deletions
diff --git a/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc b/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc index 035b45a6d..ef1166601 100644 --- a/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc +++ b/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc @@ -643,6 +643,12 @@ \property QWebEnginePage::title \brief the title of the page as defined by the HTML \c <title> element + If the page has no \c <title> element, then the URL is used instead. For \c + file:// URLs only the filename is used and not the full path. + + By default, before any content has been loaded, this property contains an + empty string. + \sa titleChanged() */ diff --git a/src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc b/src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc index 501959ab9..1c51a2a52 100644 --- a/src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc +++ b/src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc @@ -173,9 +173,9 @@ /*! \property QWebEngineView::title - \brief the title of the web page currently viewed + \brief the title of the page as defined by the HTML \c <title> element - By default, this property contains an empty string. + Equivalent to \l {QWebEnginePage::title()}. \sa titleChanged() */ |