Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Використання редактора тем

У цій статті пояснюється, як створювати теми інтерфейсу користувача та керувати ними за допомогою редактора Godot і його інструмента редагування тем. Ми рекомендуємо ознайомитись із основами створення скінів/тем графічного інтерфейсу, прочитавши Вступ до графічного інтерфейсу користувача перед початком.

Редактор тем — це інструмент нижньої панелі, який автоматично активується, коли для редагування вибрано ресурс Theme. Він містить необхідний інтерфейс користувача для додавання, видалення та налаштування типів тем і елементів теми. У ньому є розділ попереднього перегляду для тестування ваших змін у реальному часі, а також діалогове вікно для виконання масових операцій з елементами теми.

Створення теми

Як і будь-які інші ресурси, теми можна створювати безпосередньо в док-станції файлової системи, клацнувши правою кнопкою миші та вибравши Новий ресурс..., потім вибравши Тема та натиснувши Створити. Це особливо корисно для створення тем для всього проекту.

Теми також можна створювати з будь-якого вузла керування. Виберіть вузол керування в ієрархії сцени, а потім в інспекторі перейдіть до властивості theme. Звідти ви можете вибрати Нову тему.

Це створить порожню тему та відкриє редактор тем. Майте на увазі, що створені таким чином ресурси за замовчуванням додаються до сцени. Натомість скористайтеся контекстним меню, щоб зберегти нову тему у файл.

У той час як редактор тем надає інструменти для керування типами тем і елементами, теми також містять стандартний резервний шрифт, який можна редагувати лише за допомогою панелі Inspector. Те саме стосується вмісту складних типів ресурсів, таких як StyleBoxes та піктограм — вони відкриваються для редагування в інспекторі.

Огляд редактора тем

Редактор тем складається з двох основних частин. Основний редактор тем, розташований у нижній частині редактора Godot, має на меті надати користувачам інструменти для швидкого створення, редагування та видалення елементів і типів тем. Він надає візуальні інструменти для вибору та зміни елементів керування, абстрагування основних концепцій теми. З іншого боку, діалогове вікно Керування елементами теми намагається задовольнити потреби тих, хто хоче змінити теми вручну. Це також корисно для створення нової теми редактора.

Попередній перегляд теми

У лівій частині головного редактора є набір вкладок попереднього перегляду. Вкладка Попередній перегляд за замовчуванням відображається з коробки та містить більшість часто використовуваних елементів керування в різних станах. Попередній перегляд є інтерактивним, тому також можна переглянути проміжні стани (наприклад, наведення).

Додаткові вкладки можна створити з довільних сцен у вашому проекті. Сцена повинна мати керуючий вузол як корінь, щоб функціонувати як попередній перегляд. Щоб додати нову вкладку, натисніть кнопку Додати попередній перегляд і виберіть збережену сцену з вашої файлової системи.

Якщо ви вносите зміни в сцену, вони не відображатимуться у попередньому перегляді автоматично. Щоб оновити попередній перегляд, натисніть кнопку перезавантаження на панелі інструментів.

Попередній перегляд також можна використовувати для швидкого вибору типу теми для редагування. Виберіть інструмент вибору на панелі інструментів і наведіть курсор на область попереднього перегляду, щоб виділити вузли керування. Виділені контрольні вузли відображають назву свого класу або варіант типу, якщо доступний. Натискання виділеного елемента керування відкриває його для редагування з правого боку.

Типи тем і елементи

Права частина редактора тем містить список типів тем, доступних у редагованому ресурсі теми, а також вміст вибраного типу. Список елементів типу розділений на кілька вкладок, що відповідають кожному типу даних, доступних у темі (кольори, константи, стилі тощо). Якщо опцію Показати за замовчуванням увімкнено, для кожного вбудованого типу значення теми за замовчуванням відображаються сірим кольором. Якщо опцію вимкнено, відображаються лише елементи, доступні в самій редагованій темі.

Окремі елементи з теми за замовчуванням можна додати до поточної теми, натиснувши кнопку Перевизначити біля елемента. Ви також можете замінити всі стандартні елементи вибраного типу теми, натиснувши кнопку Перевизначити все. Перевизначені властивості потім можна видалити за допомогою кнопки Видалити елемент. Властивості також можна перейменувати за допомогою кнопки Перейменувати елемент, а також повністю власні властивості можна додати до списку за допомогою текстового поля під ним.

Перевизначені елементи теми можна редагувати безпосередньо на правій панелі, якщо вони не є ресурсами. Для ресурсів доступні рудиментарні елементи керування, але натомість їх потрібно редагувати в доці «Інспектор».

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

Хоча типи тем можна вибирати з попереднього перегляду, їх також можна додавати вручну. Натискання кнопки з плюсом біля списку типів відкриває меню Додати тип елемента. У цьому меню ви можете вибрати тип зі списку або ввести довільне ім’я для створення спеціального типу. Текстове поле також фільтрує список контрольних вузлів.

Керуйте та імпортуйте елементи

Натискання кнопки Керування елементами відкриває діалогове вікно Керування елементами теми.

На вкладці Редагувати елементи ви можете переглядати та додавати типи тем, а також переглядати та редагувати елементи теми вибраного типу.

Ви можете створювати, перейменовувати та видаляти окремі елементи теми тут, натиснувши відповідний Додати елемент X і вказавши їх назву. Ви також можете масово видаляти елементи теми або за типом даних (використовуючи піктограму пензля у списку), або за їх якістю. Видалити елементи класу видалить усі вбудовані елементи теми, які ви налаштували для типу контрольного вузла. Видалити настроювані елементи видалить усі настроювані елементи теми для вибраного типу. Нарешті, Видалити всі елементи видалить усе з типу.

На вкладці Імпорт елементів ви можете імпортувати елементи теми з інших тем. Ви можете імпортувати елементи зі стандартної теми Godot, теми редактора Godot або іншої спеціальної теми. Ви можете імпортувати окремі або кілька елементів, а також вирішувати, копіювати чи пропустити їхні дані. Існує кілька способів вибору та скасування вибору елементів, зокрема вручну, за ієрархією, за типом даних тощо. Вибір включення даних призведе до копіювання всіх елементів теми до вашої теми. Пропуск даних створить елементи з відповідним типом даних і назвою, але залишить їх порожніми, таким чином створивши шаблон теми.