Тип QML WebEngineHistory

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

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

Свойства

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

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

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

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

• backItems, который содержит URL-адреса посещенных страниц.
• forwardItems, который содержит URL-адреса страниц, посещенных после текущей страницы.
• items, который содержит URL-адреса элементов назад и вперед, а также 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: historyMenu.insertItem(index, object)
                            onObjectRemoved: historyMenu.removeItem(object)
                        }
                    }
                }

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

См. также WebEngineHistoryListModel.

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

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

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

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

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

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

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