WebEngineHistory QML Type

Fournit des modèles de données qui représentent l'historique d'une page de moteur web. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• backItems : WebEngineHistoryModel
• forwardItems : WebEngineHistoryModel
• items : WebEngineHistoryModel

Méthodes

• void clear() (since QtWebEngine 1.11)

Description détaillée

Le type WebEngineHistory est accessible à l'aide de la propriété WebEngineView.history.

Le type WebEngineHistory fournit les objets suivants du modèle de données WebEngineHistoryModel:

• backItemsURL, qui contient les URL des pages visitées.
• forwardItemsqui contient les URL des pages visitées, qui contient les URL des pages qui ont été visitées après avoir visité la page actuelle.
• itemsL'objet "Historique", qui contient les URL des éléments précédents et suivants, ainsi que l'URL de la page actuelle.

La façon la plus simple d'utiliser ces modèles est de les utiliser dans un site ListView, comme l'illustre l'extrait de code suivant :

ListView {
    id: historyItemsList
    anchors.fill: parent
    model: webEngineView.history.items
    delegate:
        Text {
            color: "black"
            text: model.title + " - " + model.url + " (" + model.offset + ")"
        }
}

Le site ListView affiche le contenu du modèle correspondant. Le délégué est responsable du format des éléments de la liste. L'apparence de chaque élément de la liste dans le délégué peut être définie séparément (elle n'est pas spécifique au moteur web).

Les rôles title, url et icon du modèle spécifient le titre, l'URL et le favicon de la page visitée. Le rôle offset spécifie la position de la page par rapport à la page actuelle (0). Un nombre positif indique que la page a été visitée après la page actuelle, tandis qu'un nombre négatif indique que la page a été visitée avant la page actuelle.

Les modèles de données peuvent également être utilisés pour créer un menu, comme l'illustre l'extrait de code suivant :

    menuBar: ToolBar {
        id: navigationBar
        RowLayout {
            anchors.fill: parent
            ToolButton {
                enabled: win.currentWebView?.canGoBack || win.currentWebView?.canGoForward
                onClicked: historyMenu.open()
                text: qsTr("▼")
                Menu {
                    id: historyMenu
                    Instantiator {
                        model: win.currentWebView?.history?.items
                        MenuItem {
                            required property var model
                            text: model.title
                            onTriggered: win.currentWebView.goBackOrForward(model.offset)
                            checkable: !enabled
                            checked: !enabled
                            enabled: model.offset
                        }

                        onObjectAdded: function(index, object) {
                            historyMenu.insertItem(index, object)
                        }
                        onObjectRemoved: function(index, object) {
                            historyMenu.removeItem(object)
                        }
                    }
                }

Pour l'exemple complet, voir WebEngine Quick Nano Browser.

Voir aussi WebEngineHistoryModel.

Documentation sur les propriétés

backItems : WebEngineHistoryModel [read-only]

Un objet WebEngineHistoryModel que vous pouvez utiliser pour extraire des informations sur les éléments précédents, c'est-à-dire les pages qui ont été visitées avant la page actuelle.

Voir également WebEngineHistoryModel, forwardItems, et items.

forwardItems : WebEngineHistoryModel [read-only]

Un objet WebEngineHistoryModel que vous pouvez utiliser pour extraire des informations sur les éléments en aval, c'est-à-dire les pages qui ont été visitées après la page actuelle.

Voir également WebEngineHistoryModel, backItems, et items.

items : WebEngineHistoryModel [read-only]

Un objet WebEngineHistoryModel que vous pouvez utiliser pour extraire des informations sur les éléments précédents, les éléments suivants et l'élément actuel dans l'historique.

Voir également WebEngineHistoryModel, backItems, et forwardItems.

Documentation de la méthode

[since QtWebEngine 1.11] void clear()

Efface l'historique.

Cette méthode a été introduite dans QtWebEngine 1.11.