Тип QML WebEngineHistory

Предоставляет модели данных, которые представляют историю страницы веб-движка. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• backItems : WebEngineHistoryListModel
• forwardItems : WebEngineHistoryListModel
• items : WebEngineHistoryListModel

Методы

• void clear()

Подробное описание

К типу WebEngineHistory можно получить доступ, используя свойство WebEngineView.navigationHistory.

Тип WebEngineHistory предоставляет следующие объекты модели данных WebEngineHistoryListModel:

• backItems, содержащий URL посещенных страниц.
• forwardItems, содержащий URL страниц, которые были посещены после текущей страницы.
• items, содержащий URL элементов «назад», «вперед» и текущей страницы.

Самый простой способ использовать эти модели — использовать их в ListView, как показано в следующем фрагменте кода:

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

ListView отображает содержимое соответствующей модели. Делегат отвечает за форматирование элементов списка. Внешний вид каждого элемента списка в делегате можно определить отдельно (он не зависит от веб-движка).

Роли модели title, url и icon указывают заголовок, URL-адрес и значок-закладку посещенной страницы. Роль offset указывает положение страницы относительно текущей страницы (0). Положительное число указывает, что страница была посещена после текущей, а отрицательное — что страница была посещена до текущей.

Модели данных также можно использовать для создания меню, как показано в следующем фрагменте кода:

    toolBar: ToolBar {
        id: navigationBar
            RowLayout {
                anchors.fill: parent
                ToolButton {
                    enabled: currentWebView && (currentWebView.canGoBack || currentWebView.canGoForward)
                    menu:Menu {
                        id: historyMenu

                        Instantiator {
                            model: currentWebView && currentWebView.navigationHistory.items
                            MenuItem {
                                text: model.title
                                onTriggered: 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)
                            }
                        }
                    }

Полный пример см. в WebEngine Quick Nano Browser.

См. также WebEngineHistoryListModel.

Документация по свойствам

[только для чтения] backItems : WebEngineHistoryListModel

URL посещенных страниц.

[только для чтения] forwardItems : WebEngineHistoryListModel

URL страниц, которые были посещены после текущей страницы.

[только для чтения] items : WebEngineHistoryListModel

URL элементов «назад», «вперед» и текущего элемента в истории.

Документация по методам

void clear()

Очищает историю.

Этот метод был представлен в QtWebEngine 1.11.