Qt 5.11 | Qt WebEngine | Qt WebEngine Examples | WebEngine Qt Quick Custom Dialogs Example

Qt 5.11.3 Reference Documentation

# WebEngine Qt Quick Custom Dialogs Example

Customizes UI elements of Qt WebEngine's dialogs.

A web page might request dialogs for various purposes, such as authentication, picking colors, choosing files, and responding to JavaScript alerts, confirmation requests, and prompts.

Custom Dialogs demonstrates how to use WebEngine dialog request objects to implement custom dialogs for use instead of the default dialogs.

## Running the Example

To run the example from Qt Creator, open the Welcome mode and select the example from Examples. For more information, visit Building and Running an Example.

## UI Elements of WebEngineView

In this example, we create a simple `index.html` page that contains buttons and text fields for triggering a context menu and the following dialogs:

- HTTP Authentication Dialog
- Proxy Authentication Dialog
- JavaScript Alert, Confirm, and Prompt Dialogs
- Color Picker Dialog
- File Picker Dialog

## Triggering Dialogs

As mentioned, the index.html file is responsible for triggering the dialogs from the side of HTML and JavaScript. Additionally, the example program starts a localhost TCP server returning the mocked HTTP responses needed to trigger proxy and HTTP authentication dialogs.

## Custom Dialogs

The custom dialogs are just Qt Quick Designer UI Forms without any business logic. The point here is to present the glue code that is required to display the custom dialog for a particular web engine dialog or a menu request.

## Creating the Main Window

In `main.cpp`, we initialize the WebEngine the same way as in the WebEngine Qt Quick Minimal Example:

      int main(int argc, char *argv[])
      {
          Application app(argc, argv);
          QtWebEngine::initialize();

          QQmlApplicationEngine engine;
          Server *server = new Server(&engine);

          engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
          QTimer::singleShot(0, server, &Server::run);

          QNetworkProxy proxy;
          proxy.setType(QNetworkProxy::HttpProxy);
          proxy.setHostName("localhost");
          proxy.setPort(5555);
          QNetworkProxy::setApplicationProxy(proxy);

          return app.exec();
      }

In addition, we set up a proxy and a TCP server to be able to simulate proxy and HTTP authetication requests.

In `main.qml`, we create a top level window, which contains a StackView with a SwitchButton and a WebView:

      import QtQuick.Window 2.0

      Window {
          width: 350
          height: 550
          visible: true

          Controls.StackView {
              id: stackView
              anchors.fill: parent
              focus: true
              initialItem: Item {
                  id: main
                  width: parent.width
                  height: parent.height
                  ColumnLayout {
                      anchors.fill: parent
                      SwitchButton {
                          id: switcher
                          Layout.fillWidth: true
                      }
                      WebView {
                          id: webView
                          useDefaultDialogs: switcher.checked
                          Layout.fillWidth: true
                          Layout.fillHeight: true
                      }
                  }
              }

              function closeForm()
              {
                  pop(main);
              }

              function openForm(form)
              {
                  push(form);
                  currentItem.closeForm.connect(closeForm);
              }

          }

          Component.onCompleted: {
              webView.openForm.connect(stackView.openForm);
          }
      }

## Handling Web Engine Requests

In this example, we implement the handling of the following web engine requests:

- ContextMenuRequest
- AuthenticationDialogRequest
- JavaScriptDialogRequest
- ColorDialogRequest
- FileDialogRequest

### Context Menu Requests

ContextMenuRequest is a request object that is passed as a parameter of the WebEngineView::contextMenuRequested signal. We use the `onContextMenuRequested` signal handler to handle requests for `#openMenu` URL links:

      WebEngineView {
          ...
          onContextMenuRequested: function(request) {
              // we only show menu for links with #openMenu
              if (!request.linkUrl.toString().endsWith("#openMenu")) {
                  request.accepted = true;
                  return;
              }
              // return early to show default menu
              if (useDefaultDialogs)
                  return;

              request.accepted = true;
              openForm({item: Qt.resolvedUrl("forms/Menu.qml"),
                           properties: {"request": request}});
          }
          ...
      }

The first text field from the top on our page triggers the request. Next, we check whether we should use the default menu. If not, we accept the request and switch the view to show the `MenuForm`:

      MenuForm {
          property QtObject request
          signal closeForm()

          followLink.onClicked: closeForm()
          back.onClicked: closeForm()
          forward.onClicked: closeForm()
          reload.onClicked: closeForm()
          copyLinkUrl.onClicked: closeForm()
          saveLink.onClicked: closeForm()
          close.onClicked: closeForm()

          Component.onCompleted: {
              back.btnEnable = false;
              forward.btnEnable = false;
          }
      }

To keep things simple, we do not provide any logic on component completion, and we simply close the form on any action.

### Authentication Dialog Requests

AuthenticationDialogRequest is a request object that is passed as a parameter of the WebEngineView::authenticationDialogRequested signal:

      WebEngineView {
          ...
          onAuthenticationDialogRequested: function(request) {
              if (useDefaultDialogs)
                  return;

              request.accepted = true;
              openForm({item: Qt.resolvedUrl("forms/Authentication.qml"),
                           properties: {"request": request}});
          }
          ...
      }

We use the `onAuthenticationDialogRequested` signal handler to check whether we should use the default authentication dialog. If not, we accept the request and switch the view to show the `AuthenticationForm`:

      AuthenticationForm {
          property QtObject request
          signal closeForm()

          cancelButton.onClicked: {
              request.dialogReject();
              closeForm();
          }

          loginButton.onClicked: {
              request.dialogReject();
              closeForm();
          }

          Component.onCompleted: {
              switch (request.type) {
              case  AuthenticationDialogRequest.AuthenticationTypeHTTP:
                  console.log("HTTP Authentication Required. Host says: " + request.realm);
                  break;
              case  AuthenticationDialogRequest.AuthenticationTypeProxy:
                  console.log("Proxy Authentication Required for: " + request.proxyHost);
                  break;
              }
          }
      }

On component completion, we log the request type. The user can fill in the credentials and click Login. We provide `onClicked` handlers to accept or reject the authentication dialog. The TCP server on localhost does not handle real authentication, and therefore we call `rejectDialog()` instead of `acceptDialog()` also for the login button `clicked` signal.

### JavaScript Dialog Requests

JavaScriptDialogRequest is a request object that is passed as a parameter of the WebEngineView::javaScriptDialogRequested signal:

      WebEngineView {
          ...
          onJavaScriptDialogRequested: function(request) {
              if (useDefaultDialogs)
                  return;

              request.accepted = true;
              openForm({item: Qt.resolvedUrl("forms/JavaScript.qml"),
                           properties: {"request": request}});
          }
          ...
      }

We use the `onJavaScriptDialogRequested` signal handler to check whether we should use the default JavaScript dialog. If not, we accept the request and switch the view to show the `JavaScriptForm`:

      JavaScriptForm {
          property QtObject request
          signal closeForm()

          cancelButton.onClicked: {
              request.dialogReject();
              closeForm();
          }

          okButton.onClicked: {
              request.dialogAccept(prompt.text);
              closeForm();
          }

          Component.onCompleted: {
              switch (request.type) {
              case JavaScriptDialogRequest.DialogTypeAlert:
                  cancelButton.visible = false;
                  title = qsTr("Alert");
                  message = request.message;
                  prompt.text = "";
                  prompt.visible = false;
                  break;
              case JavaScriptDialogRequest.DialogTypeConfirm:
                  title = qsTr("Confirm");
                  message = request.message;
                  prompt.text = "";
                  prompt.visible = false;
                  break;
              case JavaScriptDialogRequest.DialogTypePrompt:
                  title = qsTr("Prompt");
                  message = request.message;
                  prompt.text = request.defaultText;
                  prompt.visible = true;
                  break;
              }
          }
      }

On component completion, we customize the form based on the request type. For a JavaScript prompt dialog we use `dialogAccept()` with the `prompt.text` argument.

### Color Dialog Requests

ColorDialogRequest is a request object that is passed as a parameter of the WebEngineView::colorDialogRequested signal:

      WebEngineView {
          ...
          onColorDialogRequested: function(request) {
              if (useDefaultDialogs)
                  return;

              request.accepted = true;
              openForm({item: Qt.resolvedUrl("forms/ColorPicker.qml"),
                           properties: {"request": request}});
          }
          ...
      }

We use the `onColorDialogRequested` signal handler to check whether we should use the default color picker dialog. If not, we accept the request and switch the view to show the `ColorPickerForm`:

      ColorPickerForm {
          property QtObject request
          signal closeForm()

          okButton.onClicked: {
              request.dialogAccept(colorPicker.color);
              closeForm();
          }

          cancelButton.onClicked: {
              request.dialogReject();
              closeForm();
          }

          function createCallback(color) {
              return function() { colorPicker.color = color };
          }

          Component.onCompleted:{
              for (var i = 0; i < grid.children.length; i++) {
                  var cell = grid.children[i];
                  cell.clicked.connect(createCallback(cell.color));
              }
              colorPicker.color = request.color;
          }
      }

On component completion, we create callbacks for all the color cells. When the user selects the color and clicks `OK`, we pass the selected color to the `dialogAccept()` method.

### File Dialog Requests

FileDialogRequest is a request object that is passed as a parameter of the WebEngineView::fileDialogRequested signal:

      WebEngineView {
          ...
          onFileDialogRequested: function(request) {
              if (useDefaultDialogs)
                  return;

              request.accepted = true;
              openForm({item: Qt.resolvedUrl("forms/FilePicker.qml"),
                           properties: {"request": request}});

          }
      }

We use the `onFileDialogRequested` signal handler to check whether we should use the default color picker dialog. If not, we accept the request and switch the view to show the `FilePickerForm`:

      FilePickerForm {
          property QtObject request
          property string selectedFile
          signal closeForm()

          cancelButton.onClicked: {
              request.dialogReject();
              closeForm();
          }

          okButton.onClicked: {
              request.dialogAccept('/' + selectedFile);
              closeForm();
          }

          function createCallback(fileIndex) {
              return function() {
                  for (var i = 0; i < files.children.length; i++) {
                      var file = files.children[i];
                      if (i === fileIndex) {
                          selectedFile = file.text;
                          file.selected = true;
                      } else {
                          file.selected = false;
                      }
                  }
              }
          }

          Component.onCompleted: {
              selectedFile = request.defaultFileName;
              for (var i = 0; i < files.children.length; i++) {
                  var file = files.children[i];
                  file.clicked.connect(createCallback(i));
                  if (file.text === selectedFile)
                      file.selected = true;
              }
          }

On component completion, we create callbacks for selecting files. When the user selects a file and clicks `OK`, we pass the selected file to the `dialogAccept` method.

Files:

- webengine/customdialogs/MessageRectangle.qml
- webengine/customdialogs/SwitchButton.qml
- webengine/customdialogs/WebView.qml
- webengine/customdialogs/customdialogs.pro
- webengine/customdialogs/customdialogs.qrc
- webengine/customdialogs/forms/Authentication.qml
- webengine/customdialogs/forms/AuthenticationForm.ui.qml
- webengine/customdialogs/forms/Button.qml
- webengine/customdialogs/forms/ColorCell.qml
- webengine/customdialogs/forms/ColorPicker.qml
- webengine/customdialogs/forms/ColorPickerForm.ui.qml
- webengine/customdialogs/forms/FilePicker.qml
- webengine/customdialogs/forms/FilePickerForm.ui.qml
- webengine/customdialogs/forms/FileRow.qml
- webengine/customdialogs/forms/JavaScript.qml
- webengine/customdialogs/forms/JavaScriptForm.ui.qml
- webengine/customdialogs/forms/Menu.qml
- webengine/customdialogs/forms/MenuForm.ui.qml
- webengine/customdialogs/icon.svg
- webengine/customdialogs/index.html
- webengine/customdialogs/main.cpp
- webengine/customdialogs/main.qml
- webengine/customdialogs/server.cpp
- webengine/customdialogs/server.h
- webengine/customdialogs/style.css