Fluent-Qt

Обновления проекта

Релизы и миграции

Обновления и требования к миграции для UILib и Gallery, сгруппированные по версиям.

1.12.1

Последняя версия

Библиотека UILib

PropertyPanel создаёт редакторы по мере появления строк на экране. AreaChart повторно использует заливку при движении указателя.

Приложение Gallery

В диалоге What’s new фон больше не просвечивает через разделители при прокрутке. Примеры с фотографиями загружают изображения по мере необходимости.

Заметки о проекте

Сайт, справочник API компонентов и интерактивные редакторы свойств доступны на девяти языках.

1.12.0

Библиотека UILib

Вертикальное размещение иконок кнопок, заголовки столбцов дерева и восстановление развёрнутых окон на нужном мониторе.

  • Используйте Button::IconAbove или Button::IconBelow для размещения иконки над или под текстом.
  • TreeView оставляет место под видимые заголовки столбцов. Используйте headerlessTopInset при скрытых заголовках.
  • В Windows восстановление развёрнутого Window учитывает рабочую область целевого монитора.

Приложение Gallery

Добавлены офлайн-просмотр заметок о релизах и пример заголовков столбцов в дереве.

  • Откройте «What’s new» в заголовке окна (или нажмите иконку рупора в узком окне), чтобы прочитать встроенный журнал обновлений Gallery.
  • Пример TreeView показывает отображение заголовков столбцов модели над первой строкой.

Заметки о проекте

Редактируйте живые примеры Qt на 99 страницах компонентов и копируйте код C++ или PySide6.

1.11.4

Библиотека UILib

Добавлены отчёты диагностики, поддержка Snap Layouts в Windows 11 и общие настройки рамок текстовых полей.

  • DiagnosticSession записывает недавние события UI и снимки виджетов в ZIP-архив в памяти.
  • Наведите курсор на кнопку развёртывания изменяемого по размеру Window, чтобы использовать Snap Layouts в Windows 11.
  • Текстовые поля делят настройки рамки LineEdit. Подчёркивание без фокуса по умолчанию имеет нулевую ширину и не рисует тонкую линию.
  • В Toast исправлены владение виджетами действий и вёрстка в узких окнах.

Приложение Gallery

Отправка отчётов об ошибках Gallery с ZIP-архивом недавней диагностики.

  • Кнопка «Report a problem» рядом с «Settings» копирует ZIP с диагностикой и отчётами о сбоях; выберите «Open GitHub issue» в уведомлении и вставьте архив.
  • В веб-версии Gallery ZIP-архив скачивается для прикрепления к отчёту об ошибке.

Заметки о проекте

Журнал релизов на сайте разделяет обновления UILib и Gallery, добавлены фильтры области и постоянные ссылки на миграции.

1.11.3

Библиотека UILib

Добавлены Transfer, суффиксы единиц и завершающие виджеты для LineEdit и ComboBox, геометрия каретки TextEdit и исправления компоновки полей.

  • LineEdit и ComboBox могут отображать суффиксы единиц вроде px (отдельно от текста) или пользовательский виджет справа.
  • Transfer перемещает элементы между двумя списками с поиском по стабильным ключам и пропуском отключённых строк.
  • TextEdit открывает прямоугольник каретки и сигнал изменения для позиционирования всплывающих подсказок автодополнения.
  • Исправлены границы текста редактируемого ComboBox после выбора или обновления модели и центрирование иконки перетаскивания NumberBox при любом масштабе.

Приложение Gallery

Добавлен пример автодополнения участников по @ и исправлено отсечение перенаправления в старых версиях Qt.

  • Введите @ в примере автодополнения TextEdit и выберите участника клавишами со стрелками, не покидая редактор.

1.11.1

Библиотека UILib

Добавлены RangeSlider и ImageViewer, исправлены выравнивание текста, оверлеи и отрисовка при дробном масштабировании.

  • RangeSlider выбирает нижнюю и верхнюю границы с минимальным шагом, подсказками и доступными ползунками.
  • ImageViewer поддерживает зум вокруг курсора, панорамирование, режимы подгонки, жесты и кэш миниатюр, в том числе внутри FlipView.
  • Устранены артефакты дробного масштаба (<100%) с помощью локальной перерисовки; исключены полные перерисовки виджетов окна на GPU-кадрах.
  • Исправлены выравнивание компактных элементов, отступы иконок меню, фокус переполнения SelectorBar и захват фона всплывающих окон.

Приложение Gallery

Требуется миграция

Сохранение масштаба интерфейса 50%–200% и пагинация результатов поиска. Для сборки из исходников требуются приватные заголовки Qt.

1.11.0

Библиотека UILib

Требуется миграция

Эффекты частиц вынесены в модуль FluentQt::Particles, FontIcon получил поддержку своих шрифтов иконок, а Python-колёса собираются со стабильным ABI.

  • FontIcon получил fontFamily() и setFontFamily() для своих шрифтов иконок; оставьте пустым для встроенных иконок Fluent.
  • Эффекты частиц перенесены из ядра библиотеки в опциональную цель FluentQt::Particles (fluentqt.particles в Python).
  • Отладочная сборка для десктопа по умолчанию использует релизный рантайм Qt. Задайте FLUENT_QT_DEBUG_RELEASE_RUNTIME=OFF для линковки с отладочными библиотеками Qt.
  • Открытые оверлеи отслеживают перемещение родителя, ползунки скроллбара совпадают с зоной клика, а Python wheel использует стабильный ABI CPython (abi3).

ParticleBackdrop перенесён в модуль Particles

Типы fluent::layout::ParticleBackdrop и fluentqt.layout.ParticleBackdrop удалены; линковка только FluentQt::FluentQt больше не включает эффекты частиц.

Включите FLUENT_QT_BUILD_PARTICLES при сборке из исходников или запросите COMPONENTS Particles и слинкуйте FluentQt::Particles, затем обновите пути включения и импорты.

До
FluentQt::FluentQt
#include <FluentQt/Layout.h>
fluent::layout::ParticleBackdrop
from fluentqt.layout import ParticleBackdrop
После
find_package(FluentQt CONFIG REQUIRED COMPONENTS Particles)
target_link_libraries(app PRIVATE FluentQt::Particles)
#include <FluentQt/Particles.h>
fluent::particles::ParticleBackdrop
from fluentqt.particles import ParticleBackdrop

Добавлено в b674c94

Приложение Gallery

3D Gallery загружает только изменённые строки текстур, восстанавливает чёткость после остановки, ограничивает кэш и переходит в 2D при падении FPS.

1.10.3

Библиотека UILib

Добавлены редактирование чисел и свойств, экспорт графиков и новые элементы выбора.

  • Значения NumberBox можно менять перетаскиванием с возможностью отмены. PropertyPanel поддерживает группы, поиск и сброс к значениям по умолчанию.
  • Графики можно сохранять в PNG или экспортировать в CSV — как видимый диапазон, так и все данные.
  • AutoSuggestBox поддерживает асинхронные подсказки и отбрасывает устаревшие. Новое: TagInput и TreeSelect.
  • DataGrid поддерживает закрепление столбцов, а DataGridToolBar — поиск, фильтры и настройку колонок.

Заметки о проекте

Каждая страница компонента на сайте содержит живой пример, код на C++ и PySide6 и публичный API.

1.10.0

Библиотека UILib

Добавлены DateTimeRangePicker, QmlBridge для встраивания страниц QML в окна Widgets и опциональный модуль Plugins для зависимостей и жизненного цикла расширений.

Приложение Gallery

Python Live Scene перезагружает превью в том же окне.

1.9.3

Библиотека UILib

Исправлен фон окна при запуске и смене материала: новые окна больше не мерцают белым в тёмной теме, а при отключении Mica/Acrylic старый материал сохраняется до готовности нового.

1.9.1

Библиотека UILib

Python wheel снова включают опциональный модуль Spatial, отсутствовавший в 1.9.0.

Приложение Gallery

Собранная 3D Gallery использует Direct3D 11 на Windows ARM64 и переходит в 2D при отсутствии аппаратного ускорения.

  • В пакетах wheel 1.9.0 отсутствовал модуль Spatial. Обновите FluentQt и FluentQt-Gallery до 1.9.1 для работы 3D Gallery.

1.9.0

Библиотека UILib

Добавлен опциональный модуль Spatial. SpatialView размещает обычные виджеты на 3D-поверхностях с перспективой и сохранением ввода.

Приложение Gallery

Добавлен 3D-режим в настольную и браузерную Gallery.

1.8.3

Библиотека UILib

Добавлены фоновая анимация частиц ParticleBackdrop на CPU и экран загрузки SplashScreen. Исправлены клавиатурный выбор и редактирование текста.

Приложение Gallery

Упрощены чтение и копирование исходного кода примеров.

1.8.2

Библиотека UILib

UserTheme::applyOverrides() меняет цвета, скругления и шрифты для всего приложения, а setThemeOverrides() — для одного виджета. Выпадающие списки ComboBox используют выбранные шрифты; исправлены ошибки навигации и слайдеров.

1.8.0

Библиотека UILib

Добавлены тема HighContrast и режимы MotionPolicy (Full, Reduced, Disabled). TextEdit в фокусе плавно анимирует автоподстройку высоты.

Приложение Gallery

В настольный C++, PySide6 и браузерный варианты Gallery добавлены настройки высокой контрастности и анимации.

1.7.5

Библиотека UILib

Кнопки, переключатели и пикеры даты/времени следуют общим правилам fontRole (приоритет у явного setFont()). Навык build-fluentqt-gui охватывает цикл от анализа проекта до ревью.

Приложение Gallery

Поведение примеров унифицировано для C++, PySide6 и WebAssembly.

1.7.4

Библиотека UILib

Клавиши быстрого доступа меню продолжают работать во время анимации.

Приложение Gallery

Нативные превью воспроизводят действия мыши и клавиатуры перед снимком и выводят геометрию виджетов и отчёт Inspector.

1.7.3

Библиотека UILib

Закруглена рамка выбора в CalendarView, выпадающие окна пикеров выровнены по полям, а тени TeachingTip распределены равномерно.

Приложение Gallery

Live Scene оставляет окно предпросмотра PySide6 открытым и обновляет его при сохранении.

1.7.0

Библиотека UILib

Требуется миграция

Удалены языки дизайна Material и Cupertino (остаётся только Fluent). Добавлены Field и DataGrid, унифицировано модальное поведение оверлеев.

Удалены API языка дизайна и тем стиля

Типы DesignLanguage, StyleTheme и StyleThemeCatalog удалены без псевдонимов. Приложения на стандартных темах Fluent Light/Dark не затронуты.

Внешний вид выбирается через Theme, а токены настраиваются через UserTheme. В Python используйте current_theme(), apply_user_theme(), set_accent_color() и reset_theme_tokens(). Gallery игнорирует старый styleTheme.

До
FluentElement::DesignLanguage
StyleTheme / StyleThemeCatalog
current_design_language()
apply_style_theme()
После
FluentElement::Theme
fluent::UserTheme
current_theme()
apply_user_theme()

1.6.4

Библиотека UILib

TextEdit учитывает пользовательские отступы содержимого. Навык build-fluentqt-gui масштабирует проверки под размер приложения.

Приложение Gallery

В примерах кода в браузере добавлено переключение между C++ и PySide6.

1.6.1

Библиотека UILib

На страницу PyPI для FluentQt добавлены полная документация пакета и ссылки на проект.

Приложение Gallery

На страницу PyPI для FluentQt-Gallery добавлены полная документация пакета и ссылки на проект.

1.5.0

Библиотека UILib

Требуется миграция

Добавлены модульные заголовки вроде <FluentQt/BasicInput.h>, типизированные роли шрифтов, режимы выбора и явное владение дочерними виджетами. Текст переключателей и пикеров задаётся приложением.

Типизированные роли шрифтов, единые режимы выбора и явное владение виджетами

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

Подключайте только публичные заголовки и передавайте WidgetOwnership, где это требуется. Задавайте локализованный текст пикеров, подписи ToggleSwitch и имена доступности в приложении.

До
"Body"
FlowSelectionMode / GridSelectionMode
ListSelectionMode / TreeSelectionMode
После
Typography::FontRole::Body
fluent::collections::SelectionMode
fluent::WidgetOwnership

1.4.2

Библиотека UILib

Исправлены правая/нижняя привязки AnchorLayout, переходы состояний QMLPlus и доступ к ресурсам до создания QApplication. TextEdit корректно передаёт фокус и сохраняет историю отмены.

1.4.0

Библиотека UILib

Встроены шрифты и Fluent System Icons; зависимость от системного шрифта Segoe удалена.

Приложение Gallery

Добавлены разделы типографики, цветов, иконок и отступов, а также поддержка системного масштабирования.

1.3.2

Дата не указана

Библиотека UILib

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

Приложение Gallery

На страницах компонентов отображаются заголовок, тип C++ и цель CMake; переключение страниц стало быстрее.

1.3.1

Дата не указана

Библиотека UILib

Библиотека зависит только от Qt Widgets. Релизы включают архив исходников только библиотеки.

Приложение Gallery

spdlog сохранён в Gallery, а неиспользуемые модули Qt исключены из её пакетов.

1.3.0

Дата не указана

Библиотека UILib

Добавлена поддержка Linux (X11 и Wayland для x64 и ARM64) с пакетами Debian. Window::setBackdropEffect() даёт единый API Mica/Acrylic на всех платформах.