shift-shell/containments/homescreens/folio
Marco Allegretti 9bccbeede6 Add drag-reorder for dock favourites
Click-and-drag reordering of favourites bar items in convergence
mode.  The existing touch-based press-and-hold drag is kept for
mobile; in convergence mode, press-and-hold opens the context
menu only.

DelegateTouchArea owns the exclusive mouse grab at the C++ level,
so drag detection (threshold crossing + delta signals) is added
there rather than using a QML DragHandler.  Displaced items
animate into their new positions while the dragged item follows
the cursor.

Expose FavouritesModel::moveEntry as Q_INVOKABLE so QML can
persist the reorder.
2026-04-12 14:15:13 +02:00
..
qml Add drag-reorder for dock favourites 2026-04-12 14:15:13 +02:00
applicationlistmodel.cpp homescreens/folio: Use locale-aware sorting for application list 2025-11-28 23:08:39 -05:00
applicationlistmodel.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04:00
CMakeLists.txt Show window thumbnail on dock icon hover 2026-04-10 10:23:36 +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 Add pin-to-dock for running apps in convergence mode 2026-04-11 09:42:21 +02:00
favouritesmodel.h Add drag-reorder for dock favourites 2026-04-12 14:15:13 +02:00
folioapplication.cpp homescreens/folio: Do not initialize shared_ptr with a QObject parent 2025-07-15 18:10:03 -04:00
folioapplication.h folio: Port to plasma_add_applet 2025-07-16 23:21:46 -04: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 Replace navigation panel with unified dock bar 2026-04-09 10:15:14 +02:00
homescreen.h Replace navigation panel with unified dock bar 2026-04-09 10:15:14 +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