nosignal-shell/modules/controlcenter/components/DeviceList.qml

125 lines
3 KiB
QML

pragma ComponentBehavior: Bound
import ".."
import qs.components
import qs.components.controls
import qs.components.containers
import qs.services
import qs.config
import QtQuick
import QtQuick.Layouts
/**
* DeviceList
*
* A reusable base component for displaying lists of devices/networks with a standardized
* structure. Provides a header with action buttons, title/subtitle, and a scrollable list
* with customizable delegates.
*
* This component eliminates duplication across WirelessList, EthernetList, and Bluetooth DeviceList
* by providing a common structure while allowing full customization of headers and delegates.
*
* Usage:
* ```qml
* DeviceList {
* session: root.session
* title: qsTr("Networks (%1)").arg(Nmcli.networks.length)
* description: qsTr("All available WiFi networks")
* model: ScriptModel {
* values: [...Nmcli.networks].sort(...)
* }
* activeItem: session.network.active
* onItemSelected: (item) => {
* session.network.active = item;
* }
* headerComponent: Component {
* RowLayout {
* // Custom header buttons
* }
* }
* delegate: Component {
* // Custom delegate for each item
* }
* }
* ```
*/
ColumnLayout {
id: root
property Session session: null
property var model: null
property Component delegate: null
property string title: ""
property string description: ""
property var activeItem: null
property Component headerComponent: null
property Component titleSuffix: null
signal itemSelected(var item)
spacing: Appearance.spacing.small
// Header with action buttons (optional)
Loader {
id: headerLoader
Layout.fillWidth: true
sourceComponent: root.headerComponent
visible: root.headerComponent !== null
}
// Title and description row
RowLayout {
Layout.fillWidth: true
Layout.topMargin: root.headerComponent ? 0 : 0
spacing: Appearance.spacing.small
visible: root.title !== "" || root.description !== ""
StyledText {
visible: root.title !== ""
text: root.title
font.pointSize: Appearance.font.size.large
font.weight: 500
}
Loader {
sourceComponent: root.titleSuffix
visible: root.titleSuffix !== null
}
Item {
Layout.fillWidth: true
}
}
// Expose view for access from parent components
property alias view: view
// Description text
StyledText {
visible: root.description !== ""
Layout.fillWidth: true
text: root.description
color: Colours.palette.m3outline
}
// List view
StyledListView {
id: view
Layout.fillWidth: true
Layout.fillHeight: true
model: root.model
delegate: root.delegate
spacing: Appearance.spacing.small / 2
clip: true
StyledScrollBar.vertical: StyledScrollBar {
flickable: view
}
}
}