// Copyright (C) 2019 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only


/*!
  \page qtwebview-index.html
  \title Qt WebView
  \brief A light-weight web view.

  Qt \WebView lets you display web content inside a QML application. To avoid
  including a full web browser stack, Qt \WebView uses native APIs where
  appropriate.

  This is useful on mobile platforms, such as \l {Qt for Android}{Android} and
  \l{Qt for iOS}{iOS}. On iOS, policies dictate that all web content is
  displayed using the operating system's web view.

  On Windows, Qt \WebView can use both \l{Qt WebEngine} module and
  \l {https://learn.microsoft.com/en-us/microsoft-edge/webview2/}{WebView2} to
  render content.

  On Linux, Qt \WebView depends on the \l{Qt WebEngine} module to
  render content.

  On \macos, the system web view is used in the same manner as iOS.

  \section1 Prerequisites

  To make the Qt WebView module function correctly across all platforms, it's
  necessary to call \l {qtwebview-initialize} {\c QtWebView::initialize()}
  before creating the \l {QGuiApplication} {\c QGuiApplication} instance and
  before window's \c QPlatformOpenGLContext is created.

  \section1 Using The Module

  \section2 QML API

  \include {module-use.qdocinc} {using the qml api} {QtWebView}

  \section2 C++ API

  \include {module-use.qdocinc} {using the c++ api}

  \section3 Building with CMake

  \include {module-use.qdocinc} {building with cmake} {WebView}

  \section3 Building with qmake

  \include {module-use.qdocinc} {building_with_qmake} {webview}

  \section1 Limitations

  Due to platform limitations, overlapping the WebView with other QML components
  is not supported. Doing this will have unpredictable results, which may differ
  from platform to platform. Applications can also not rely on events in the
  WebView to propagate into the Qt event delivery system. E.g. it is not possible
  to "overlay" an invisible item on top of the WebView to handle certain events,
  or to handle events that the WebView doesn't process in a parent item.

  \section1 Examples

  Look at the \l{Qt WebView Examples} for a demonstration on
  how the APIs can be used in applications.

  \section1 Reference

  \list
    \li \l{Qt WebView QML Types}
    \li \l{Qt WebView C++ Classes and Namespaces}
  \endlist

  \section1 Licenses

  Qt \WebView is available under commercial licenses from \l{The Qt Company}.
  In addition, it is available under the
  \l{GNU Lesser General Public License, version 3}, or
  the \l{GNU General Public License, version 2}.
  See \l{Qt Licensing} for further details.
*/
