Справочная документация по Sailfish.Silica

Основные типы

Каждое приложение ОС Аврора начинается с ApplicationWindow и имеет один объект PageStack, в котором содержатся все его страницы. Специальный объект Theme позволяет оформить пользовательский интерфейс приложения в соответствии со стилем ОС Аврора.

ApplicationWindow Компонент верхнего уровня приложения ОС Аврора
Clipboard Обеспечивает базовые функции буфера обмена
PageStack Хранит и управляет страницами приложения
Screen Предоставляет параметры экрана устройства
StandardPaths Предоставляет расположение стандартных системных каталогов для хранения пользовательской информации
Theme Определяет свойства, позволяющие оформить пользовательский интерфейс приложения в стиле ОС Аврора

Страницы и диалоги

Каждая страница или диалог представляет собой отдельный экран приложения. Диалог — это тип страницы, который отображается при запросе подтверждения или отмены действий пользователя.

ColorPickerDialog Диалог для выбора цвета из ColorPicker
ColorPickerPage Страница для выбора цвета из ColorPicker
DatePickerDialog Диалог для выбора даты из DatePicker
Dialog Страница, закрываемая действием подтверждения или отмены
DialogHeader Заголовок для использования в типе Dialog
Page Предоставляет контейнер для содержимого одной страницы внутри приложения
PageHeader Обеспечивает оформленный в стиле ОС Аврора заголовок страницы
TimePickerDialog Предоставляет диалог для выбора времени с помощью TimePicker

Виды и контейнеры

Данные компоненты используются для отображения или служат контейнером для других элементов. Следует обратить внимание, что типы SilicaFlickable, SilicaListView, SilicaGridView и SilicaWebView обеспечивают поведение, характерное для ОС Аврора. Им следует отдавать предпочтение по сравнению с аналогичными типами Flickable, ListView и GridView (из модуля QtQuick) и WebView из модуля QtWebKit. Кроме того, типы ScrollDecorator обеспечивают индикаторы прокрутки для представлений.

ColumnView Создает экземпляры делегата в столбце по мере необходимости
DockedPanel Панель, которая пристыкована к краю элемента и расширяется от этого края
Drawer Предоставляет контейнер, с помощью которого реализуется выдвигающаяся панель с еще одной панелью снизу (под первой)
HorizontalScrollDecorator Добавляет горизонтальный индикатор прокрутки к представлениям Silica
ScrollDecorator Добавляет горизонтальный или вертикальный индикаторы прокрутки к представлениям Silica
SilicaFlickable Представление Flickable в стиле ОС Аврора
SilicaGridView Представление GridView в стиле ОС Аврора
SilicaListView Представление ListView в стиле ОС Аврора
SilicaWebView Представление WebView для отображения веб-страниц в стиле ОС Аврора
SlideshowView Представление для пролистывания ряда элементов
VerticalScrollDecorator Добавляет вертикальный индикатор прокрутки к представлениям Silica
ViewPlaceholder Текстовая метка, отображаемая в центре элемента, которая появляется в случае недоступности содержимого страницы

Элементы управления

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

BackgroundItem Базовый элемент в стиле ОС Аврора, который отображает нажатие на него при помощи подсветки фона
BusyIndicator Неинтерактивный элемент, который отображается в виде вращающегося круга во время ожидания загрузки контента или завершения какого-либо процесса
Button Кнопка с текстовой меткой
ButtonLayout Элемент для расположения кнопок по правилам ОС Аврора
ColorPicker Палитра для выбора цвета
ComboBox Элемент графического интерфейса для выбора варианта из выпадающего списка
DatePicker Календарь для выбора даты
HighlightImage Изображение с эффектом подсветки
IconButton Кнопка с изображением
IconTextSwitch Кнопка-переключатель с текстовой меткой и значком
Keypad Клавиатура для набора номера
ListItem Базовый элемент списка в стиле ОС Аврора, при нажатии на который появляется контекстное меню
PasswordField Текстовое поле для ввода пароля
ProgressBar Горизонтальный индикатор выполнения
Remorse Ненадолго появляющиеся элементы интерфейса (области), которые позволяет отменить разрушающее действие (удаление)
RemorseItem Ненадолго появляющийся элемент, который позволяет отменить разрушающее действие (удаление)
RemorsePopup Ненадолго показывает всплывающий элемент, нажатием на который можно отменить разрушающее действие (удаление)
Separator Горизонтальный разделитель
Slider Горизонтальный ползунок
Switch Кнопка-переключатель со значком
TextSwitch Кнопка-переключатель с текстовой меткой
TimePicker Циферблат часов для выбора времени
TouchBlocker Элемент, который принимает все нажатия на себя
ValueButton Интерактивный элемент управления, который отображает метку и значение

Ввод и отображение текста на экране

Компоненты для отображения и ввода текста.

DetailItem Отображение метки и связанного с ней значения в стиле ОС Аврора
EnterKey Контролирует внешний вид и поведение клавиши ввода в виртуальной клавиатуре
Icon A monochrome icon
Label Текстовая метка
LinkedLabel Текстовый абзац, в котором автоматически формируются ссылки для номеров и адресов
Palette A color palette
PasswordField Текстовое поле для ввода пароля
SearchField Текстовое поле для ввода поискового запроса
SectionHeader Заголовок текста для начала раздела на странице
SilicaControl An interactive visual item
SilicaItem A visual item
TextArea Отображает несколько строк для редактирования простого текста
TextField Отображает одну строку для редактирования простого текста

Меню

Меню позволяют пользователю выбирать и вызывать действие из списка.

ContextMenu Предоставляет контекстное меню
MenuItem Пункт меню
MenuLabel Статическая текстовая метка, которая отображается в начале меню
PullDownMenu Добавляет вытягиваемое сверху меню в представлениях Silica
PushUpMenu Добавляет вытягиваемое снизу меню в представлениях Silica

Анимации и эффекты

Базовые анимации Silica, которые используются для плавного появления/исчезновения элементов или изменения содержимого списков, сетки и других представлений. OpacityRampEffect предоставляет упрощенный метод реализации линейного появления/исчезновения элемента.

AddAnimation Анимация добавления элемента в стиле ОС Аврора
FadeAnimation Анимация появления/исчезновения в стиле ОС Аврора
FadeAnimator Анимация появления/исчезновения в стиле ОС Аврора, которая выполняется вне основного потока пользовательского интерфейса приложения
OpacityRampEffect Шейдер, который применяет эффект градиента непрозрачности
RemoveAnimation Анимация для удаления элемента в стиле ОС Аврора

Обложки приложения

Обложки являются визуальными представлениями приложений, которые работают в фоне (свернуты) и отображаются на экране запущенных приложений.

Cover Обложка приложения
CoverAction Действие для обложки
CoverActionList Список действий для обложки
CoverBackground Предоставляет полупрозрачную обложку
CoverPlaceholder Предоставляет шаблон для самой простой обложки приложения