WebEngineHistory QML Type

Proporciona modelos de datos que representan el historial de una página del motor web. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

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

Métodos

• void clear() (since QtWebEngine 1.11)

Descripción detallada

Se puede acceder al tipo WebEngineHistory utilizando la propiedad WebEngineView.history.

El tipo WebEngineHistory proporciona los siguientes objetos del modelo de datos WebEngineHistoryModel:

• backItems, que contiene las URL de las páginas visitadas.
• forwardItems, que contiene las direcciones URL de las páginas que se visitaron después de visitar la página actual.
• items, que contiene las URLs de los elementos atrás y adelante, así como la URL de la página actual.

La forma más sencilla de utilizar estos modelos es usarlos en un ListView, como se ilustra en el siguiente fragmento de código:

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

El ListView muestra el contenido del modelo correspondiente. El delegado es responsable del formato de los elementos de la lista. El aspecto de cada elemento de la lista en el delegado puede definirse por separado (no es específico del motor web).

Los roles del modelo title, url e icon especifican el título, la URL y el favicon de la página visitada. El rol offset especifica la posición de la página respecto a la página actual (0). Un número positivo indica que la página fue visitada después de la página actual, mientras que un número negativo indica que la página fue visitada antes de la página actual.

Los modelos de datos también pueden utilizarse para crear un menú, como se ilustra en el siguiente fragmento de código:

    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)
                        }
                    }
                }

Para ver el ejemplo completo, consulte WebEngine Quick Nano Browser.

Véase también WebEngineHistoryModel.

Documentación de propiedades

backItems : WebEngineHistoryModel [read-only]

Un objeto WebEngineHistoryModel que se puede utilizar para extraer información sobre elementos anteriores; es decir, las páginas que se visitaron antes de la página actual.

Véase también WebEngineHistoryModel, forwardItems, y items.

forwardItems : WebEngineHistoryModel [read-only]

Un objeto WebEngineHistoryModel que se puede utilizar para extraer información sobre elementos avanzados; es decir, las páginas que se visitaron después de la página actual.

Véase también WebEngineHistoryModel, backItems, y items.

items : WebEngineHistoryModel [read-only]

Un objeto WebEngineHistoryModel que puede utilizar para extraer información sobre elementos anteriores, elementos posteriores y el elemento actual del historial.

Véase también WebEngineHistoryModel, backItems, y forwardItems.

Documentación del método

[since QtWebEngine 1.11] void clear()

Borra el historial.

Este método se introdujo en QtWebEngine 1.11.