Пакет javafx.scene.control

Элементы управления интерфейсом пользователя JavaFX (UI-элементы управления или просто Элементы управления) являются специализированными узлами в графическом представлении JavaFX, особенно подходящими для повторного использования во многих различных контекстах приложений. Они разработаны для высокой визуальной настраиваемости дизайнерами и разработчиками. Они разработаны для эффективной работы с системами компоновки. Примеры известных элементов управления включают Button, Label, ListView и TextField.

Поскольку элементы управления являются Nodes в графическом представлении, их можно свободно смешивать с Groups, Images, Media, Text и basic geometric shapes. Хотя создание новых элементов управления UI не является тривиальной задачей, их использование и стилизация очень просты, особенно для разработчиков веб-приложений.

В оставшейся части данного документа будут описаны базовая архитектура библиотеки элементов управления UI JavaFX, как стилизовать существующие элементы управления, создавать пользовательские темы и как использовать элементы управления для построения более сложных пользовательских интерфейсов.

Архитектура

Элементы управления следуют классической модели MVC. Control является «моделью». Она содержит как состояние, так и функции, которые манипулируют этим состоянием. Сам класс Control не знает, как он отображается или как происходит взаимодействие пользователя. Эти задачи делегируются Skin («представлению»), которая может внутренне разделить функциональность представления и контроллера на отдельные классы, хотя в настоящее время для «контроллера» нет публичного API.

Все элементы управления наследуются от класса Control, который, в свою очередь, является узлом Parent и узлом Node. Каждый элемент управления имеет ссылку на единственную тему, которая является реализацией представления для элемента управления. Элемент управления делегирует те́ме ответственность за вычисление минимальных, максимальных и предпочтительных размеров элемента управления, смещения базовой линии и проверки попадания (включение и пересечение). Также ответственность темы, или делегата темы, заключается в реализации и реагировании на все соответствующие события клавиш, которые происходят на элементе управления, когда он содержит фокус.

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

Элемент управления наследуется от Parent и, следовательно, не является листом. С точки зрения разработчика или дизайнера элемент управления в большинстве случаев можно рассматривать как лиственный узел. Например, разработчик или дизайнер может рассматривать кнопку как прямоугольник или другой простой лиственный узел.

Поскольку элемент управления может быть изменён, он будет автоматически изменён на свой предпочтительный размер на каждом такте графического представления. Установка ширины и высоты элемента управления не влияет на его предпочтительный размер. При использовании в контейнере компоновки ограничения компоновки, наложенные на элемент управления (или заданные вручную на элементе управления), определяют, как он позиционируется и масштабируется.

Тему элемента управления можно изменить в любое время. Это обозначит элемент управления как нуждающийся в компоновке, так как изменение темы, вероятно, изменило предпочтительный размер элемента управления. Если тема не указана во время создания элемента управления, для всех встроенных элементов управления будет предоставлена тема по умолчанию на основе CSS.

Каждый элемент управления может иметь необязательную подсказку. Подсказка — это элемент управления, который отображает некоторую (обычно текстовую) информацию о элементе управления пользователю, когда курсор находится над элементом управления в течение определённого периода времени. Её можно стилизовать с помощью CSS так же, как и другие элементы управления.

focusTraversable в элементе управления по умолчанию является истинным, в то время как в Node — ложным по умолчанию. Элементы управления, которые по умолчанию не должны быть фокусируемыми (например, Label), переопределяют это значение на ложное.

Функции getMinWidth, getMinHeight, getPrefWidth, getPrefHeight, getMaxWidth и getMaxHeight напрямую делегируются те́ме. Метод baselineOffset делегируется узлу темы. Не рекомендуется подклассам изменять эти делегирования.

Стилизация элементов управления

Есть два способа настройки внешнего вида элемента управления. Наиболее сложный и гибкий способ — создание новой темы для элемента управления, которая точно реализует желаемый визуальный вид элемента управления. Подробнее см. документацию по темам.

Самый простой и эффективный способ стилизации встроенных элементов управления — использование CSS. Обратите внимание, что в этом выпуске это описание CSS применяется только к темам по умолчанию, предоставляемым для встроенных элементов управления. В последующих выпусках это будет доступно для любых сторонних пользовательских элементов управления, желающих воспользоваться этими возможностями CSS.

Каждая из тем по умолчанию для встроенных элементов управления состоит из нескольких индивидуально стилизуемых областей или регионов. Это похоже на HTML-страницу, которая состоит из <div>, а затем стилизуется с помощью CSS. Каждый отдельный регион может быть нарисован с фоном, границами, изображениями, отступами, отступами и т. д. Поддержка JavaFX CSS включает возможность иметь несколько фонов и границ и выводить цвета. Эти возможности значительно упрощают изменение внешнего вида элементов управления JavaFX с помощью CSS.

Цвета, используемые для рисования тем по умолчанию встроенных элементов управления, все выводятся из основного цвета, акцентного цвета и цвета фона. Просто изменив основной цвет элемента управления, вы можете изменить полученные градиенты и создать кнопки или другие элементы управления, которые визуально соответствуют темам по умолчанию, но визуально выделяются.

Как и все другие узлы в графическом представлении, элементы управления могут быть стилизованы с помощью внешнего файла стилей или указанием стиля непосредственно на элементе управления. Хотя для примеров проще выразить и понять, указав стиль непосредственно на узле, рекомендуется использовать внешний файл стилей и использовать либо класс стиля, либо идентификатор элемента управления так же, как вы бы использовали «класс» или идентификатор HTML-элемента с HTML CSS.

Каждый UI-элемент управления указывает класс стиля, который может быть использован для стилизации элементов управления из внешнего файла стилей. Например, элементу управления кнопкой присваивается класс стиля «кнопка» CSS. Имена классов CSS разделяются дефисами и пишутся строчными буквами, в отличие от верблюжьего регистра, в противном случае они абсолютно одинаковы. Например, Button — «кнопка», RadioButton — «кнопка-радио», Tooltip — «подсказка» и так далее.

Документация по классу каждого элемента управления определяет области темы по умолчанию, которые можно стилизовать. Дополнительную информацию о возможностях CSS, предоставляемых JavaFX, см. в руководстве по CSS.