From 52d9eeab53b5cfd92c15c9a25894991f84cd827e Mon Sep 17 00:00:00 2001 From: Leena Miettinen Date: Tue, 12 Jan 2016 13:10:44 +0100 Subject: Doc: warn about heavy routines blocking content rendering Task-number: QTBUG-50092 Change-Id: I1f3bbcab3b1999b9ecc86660ff9fef8330775cb4 Reviewed-by: Allan Sandfeld Jensen --- src/webengine/doc/src/webengineview.qdoc | 3 +++ src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc | 3 +++ 2 files changed, 6 insertions(+) diff --git a/src/webengine/doc/src/webengineview.qdoc b/src/webengine/doc/src/webengineview.qdoc index bfdeab984..a8cd1eb56 100644 --- a/src/webengine/doc/src/webengineview.qdoc +++ b/src/webengine/doc/src/webengineview.qdoc @@ -251,6 +251,9 @@ The script will run in the same \e world as other scripts that are part of the loaded site. + \warning Do not execute lengthy routines in the callback function, because it might block the + rendering of the web content. + See WebEngineView::userScripts for an alternative API to inject scripts. */ diff --git a/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc b/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc index 22eacfda9..aac5228d6 100644 --- a/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc +++ b/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc @@ -635,6 +635,9 @@ page.runJavaScript("document.title", [](const QVariant &v) { qDebug() << v.toString(); }); \endcode + \warning Do not execute lengthy routines in the callback function, because it might block the + rendering of the web engine page. + See scripts() for an alternative API to inject scripts. */ -- cgit v1.2.3