shift-shell/containments/homescreens/folio
Marco Allegretti e5ec88a12b Improve auto-hide dock reveal
Expand the dock input region as soon as the reveal animation starts
rather than waiting for it to finish, so the cursor can reach dock
items while the panel is still sliding into view.

Introduce updateInputRegion() and call it from onDockOffsetChanged,
onShouldHideChanged, onActiveChanged, onWidthChanged, and onHeightChanged
so the input region is always consistent with the current state.

While hover-revealing with a maximised window present, switch the
LayerShell exclusion zone from -1 to dockHeight so the window tiles
away from the dock instead of being obscured underneath it.

Reduce the hover dwell timer from a hard-coded 300 ms to
Kirigami.Units.shortDuration so the dock is easier to summon.
2026-05-06 13:33:38 +02:00
..
qml Improve auto-hide dock reveal 2026-05-06 13:33:38 +02:00
applicationlistmodel.cpp Fix app list model filter ordering and reset handling 2026-04-18 19:05:04 +02:00
applicationlistmodel.h Add category filter panel to the app drawer 2026-04-18 13:20:13 +02:00
CMakeLists.txt Extract RunningAppsPanelButton to its own file 2026-05-04 20:34:54 +02:00
delegatetoucharea.cpp Add drag-reorder for dock favourites 2026-04-12 14:15:13 +02:00
delegatetoucharea.h Add drag-reorder for dock favourites 2026-04-12 14:15:13 +02:00
dragstate.cpp folio: Fix delegate drop placement not accounting for view padding 2026-01-13 21:57:13 -05:00
dragstate.h folio: Refactor and implement support for proper drag & drop 2025-12-13 21:24:05 -05:00
favouritesmodel.cpp Fix homescreen includes, accessibility, and popup clamp 2026-04-18 20:25:05 +02:00
favouritesmodel.h Allow dragging running dock tasks to pin them 2026-04-13 12:32:54 +02:00
folioapplication.cpp Add category filter panel to the app drawer 2026-04-18 13:20:13 +02:00
folioapplication.h Add category filter panel to the app drawer 2026-04-18 13:20:13 +02:00
folioapplicationfolder.cpp homescreens/folio: Do not initialize shared_ptr with a QObject parent 2025-07-15 18:10:03 -04:00
folioapplicationfolder.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
foliodelegate.cpp homescreens/folio: Do not initialize shared_ptr with a QObject parent 2025-07-15 18:10:03 -04:00
foliodelegate.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
foliosettings.cpp folio: Move settings to config group, and consolidate 2025-07-16 15:44:59 -04:00
foliosettings.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
foliowidget.cpp homescreens/folio: Do not initialize shared_ptr with a QObject parent 2025-07-15 18:10:03 -04:00
foliowidget.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
homescreen.cpp Add trash button to convergence dock 2026-05-04 11:43:41 +02:00
homescreen.h Mark folio HomeScreen as uncreatable 2026-05-05 13:30:46 +02:00
homescreenstate.cpp folio: Refactor and implement support for proper drag & drop 2025-12-13 21:24:05 -05:00
homescreenstate.h folio: Refactor and implement support for proper drag & drop 2025-12-13 21:24:05 -05:00
Messages.sh homescreens/folio: Fix translations id 2023-11-05 11:45:36 -08:00
metadata.json SVN_SILENT made messages (.desktop file) - always resolve ours 2026-03-15 01:41:15 +00:00
pagelistmodel.cpp folio: Move settings to config group, and consolidate 2025-07-16 15:44:59 -04:00
pagelistmodel.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
pagemodel.cpp folio: Delete delegates if the application is removed 2025-03-19 23:40:11 -04:00
pagemodel.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
README.md Proofreading 2024-06-17 00:02:08 +03:00
widgetcontainer.cpp homescreens/folio: Block propagation if edit mode is active to avoid widget to trigger event 2025-06-18 05:53:15 -04:00
widgetcontainer.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
widgetsmanager.cpp homescreens/folio: Port away from singletons to support multi-display 2024-06-22 19:11:04 -04:00
widgetsmanager.h homescreens/folio: Port away from singletons to support multi-display 2024-06-22 19:11:04 -04:00
windowlistener.cpp folio: Rewrite 2023-10-22 04:08:28 +00:00
windowlistener.h folio: Rewrite 2023-10-22 04:08:28 +00:00

Folio Homescreen

This is the paged homescreen for Plasma Mobile.

How it works

Most of the homescreen is in C++ in order to keep logic together, with QML only responsible for the display and user input.

As such, all the positioning and placement of delegates on the screen are top down from the model, as well as drag and drop behaviour.

TODO

  • BUG: If an app gets uninstalled, the homescreen UI needs to ensure that delegates are updated
  • BUG: landscape favourites bar duplication when dragging icon from it sometimes
  • BUG: can't insert delegates in-between very well in landscape favourites bar
  • BUG: drag and drop animation when rejected on a different page
  • IMPROVEMENT: can make the touch area only the icon?
  • FEATURE: Add folio/halcyon switcher in initial-start
  • FEATURE: add widget import/export
  • FEATURE: keyboard navigation
  • FEATURE: touchpad navigation
  • FEATURE: option to darken wallpaper
  • FEATURE: option to turn off row/column swap
  • PERFORMANCE: ensure that the widget config overlays are in loaders