QML-тип SilicaWebView

Представление WebView для отображения веб-страниц в стиле ОС Аврора. Подробнее…

Строка импорта:

import Sailfish.Silica 1.0

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

Свойства

• header : Component
• pullDownMenu : Item
• pulleyMenuActive : bool
• pushUpMenu : Item
• quickScroll : bool
• quickScrollAnimating : bool

Методы

• scrollToBottom()
• scrollToTop()

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

Тип SilicaWebView реализует тип WebView с характерными для ОС Аврора поведением и дополнительными свойствами.

Ниже приведён пример представления веб-страницы в стиле ОС Аврора:

import QtQuick 2.2
import Sailfish.Silica 1.0

Page {
    SilicaWebView {
        id: webView

        anchors {
            top: parent.top
            left: parent.left
            right: parent.right
            bottom: urlField.top
        }
        url: "http://sailfishos.org"
    }

    TextField {
        id: urlField
        anchors {
            left: parent.left
            right: parent.right
            bottom: parent.bottom
        }
        inputMethodHints: Qt.ImhUrlCharactersOnly
        text: "http://sailfishos.org"
        label: webView.title
        EnterKey.onClicked: {
            webView.url = text
            parent.focus = true
        }
    }
}

SilicaWebView наследуется от типа QtWebKit WebView. Поэтому любые свойства, сигналы и методы типа WebView (например, свойства url и title в примере выше) также доступны для объектов SilicaWebView. Полный список доступных свойств, сигналов и методов приведён в документации WebView.

Следует обратить внимание, что SilicaWebView должен быть объявлен внутри объекта типа Page. Когда SilicaWebView создается внутри Page, SilicaWebView автоматически создает новые привязки для Page::backNavigation и Page::forwardNavigation. Следовательно, нет необходимости создавать новые привязки для Page::backNavigation, Page::forwardNavigation или выполнять присваивания данных свойств. Дополнительную информацию о привязке (binding) можно получить в документации Привязка свойств QML.

Описание свойств

header : Component

Содержит компонент, используемый в качестве заголовка.

Экземпляр компонента заголовка позиционируется в начале представления перед любыми элементами.

pullDownMenu : Item

Содержит значение вытягиваемого сверху меню PullDownMenu, прикрепленного к данному представлению. Если у представления нет вытягиваемого сверху меню, то свойство имеет значение null.

[read-only] pulleyMenuActive : bool

Истинно, когда вытягиваемое сверху меню или вытягиваемое снизу меню в настоящий момент активно (открыто).

pushUpMenu : Item

Содержит значение вытягиваемого снизу меню PushUpMenu, прикрепленного к данному представлению. Если у представления нет вытягиваемого снизу меню, то свойство имеет значение null.

quickScroll : bool

Определяет, разрешена ли вертикальная область быстрой прокрутки для представления. Область быстрой прокрутки отображается, если значение свойства quickScroll истинно и значение свойства contentHeight по крайней мере в три раза больше, чем значение свойства height представления. Это позволяет пользователю быстро перейти к началу или концу содержимого.

По умолчанию значение свойства истинно, если представление можно прокручивать по вертикали.

quickScrollAnimating : bool

Истинно в момент использования быстрой прокрутки к началу или концу содержимого.

Описание методов

scrollToBottom()

Запускает анимацию, которая быстро прокручивает представление к последнему элементу.

Данный метод неприменим, если представление нельзя прокручивать по вертикали.

scrollToTop()

Запускает анимацию, которая быстро прокручивает представление к первому элементу.

Данный метод неприменим, если представление нельзя прокручивать по вертикали.