WebViewExtension

Интерфейс для создания расширений для WebViewItem. Подробнее...

Подключение:

#include <webviewextension.h>

Диаграмма наследования для Aurora::WebView::WebViewExtension:

Пример обёртки сайта с помощью компонента WebView:

// Импортируем необходимые модули для работы приложения
import QtQuick 2.0                  // Базовые элементы и типы данных QML
import Sailfish.Silica 1.0          // Компоненты пользовательского интерфейса Aurora OS
import ru.auroraos.WebView 1.0      // Специализированный компонент WebView для Aurora OS

// Корневой элемент страницы
Page {
    objectName: "WebViewItemPage"   // Уникальное имя объекта (используется для автотестов и отладки)

    // Стандартный заголовок страницы
    PageHeader {
        id: pageHeader
        objectName: "pageHeader"    // Имя объекта заголовка для идентификации
        title: qsTr("WebviewItem")  // Текст заголовка с обёрткой qsTr для поддержки локализации (перевода)
    }

    // WebView для отображения веб-страницы
    WebView {
        id: webView                 // Идентификатор компонента веб-представления

        // Система привязок (anchors) для позиционирования WebView на странице
        anchors.top: parent.children[0].bottom    // Прижимаем верх к низу первого элемента родителя (PageHeader)
        anchors.left: parent.left                 // Прижимаем к левому краю родительского элемента
        anchors.right: parent.right               // Прижимаем к правому краю родительского элемента
        anchors.bottom: parent.bottom             // Прижимаем к нижнему краю (занимает всё оставшееся вертикальное пространство)

        // URL загружаемой веб-страницы для демонстрации
        url: "https://developer.auroraos.ru/"

        // Переопределение строки User-Agent
        // Позволяет веб-сайтам думать, что запрос поступает с десктопного браузера Chrome на Windows 10
        userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36"

        // Поддержка сенсорного экрана внутри WebView
        TouchInput { 
            enabled: true           // Разрешаем обработку касаний, скроллинга и жестов
        }

        // Поддержка клавиатуры внутри WebView
        KeyboardInput { 
            enabled: true           // Разрешаем использование физической или экранной клавиатуры
        }
    }
}

Сигналы

void	webViewChanged (WebViewItem *oldItem, WebViewItem *newItem) Сигнализирует об изменении родительского элемента QuickItem. Подробнее...

Публичные функции-члены

WebViewExtension (QQuickItem *parent=Q_NULLPTR)

Защищённые функции-члены

void	syncEnabled (Cef::BrowserExtension *libExtension)

Защищённые атрибуты

WebViewItem *

m_webView

Дружественные методы и классы

class

WebViewItem

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

Интерфейс для создания расширений для WebViewItem.

Собственные расширения должны быть унаследованы от класса WebViewExtension. Позже расширение должно быть объявлено внутри элемента QML WebViewдля получения доступа к функциональности WebViewItem.

Расширение должно ожидать сигнала webViewChanged(), чтобы убедиться, что есть/был допустимый экземпляр WebViewItem для взаимодействия.

Описание функций-членов

webViewChanged

void Aurora::WebView::WebViewExtension::webViewChanged (WebViewItem * oldItem, WebViewItem * newItem)

signal

Сигнал об изменении родительского элемента QuickItem.

Параметры

oldItem	Старый экземпляр WebViewItem. Может быть null.
newItem	Новый экземпляр WebViewItem. Может быть null.