Differential D25177 Diff 69590 src/controls/private/ActionToolBarLayoutDetails.qml

Changeset View

Standalone View

src/controls/private/ActionToolBarLayoutDetails.qml

This file was added.

1		/*
2		* Copyright 2018 Marco Martin <mart@kde.org>
	martUnsubmitted Not Done please add this file to kirigami.qrc and kirigami.qrc.in mart: please add this file to kirigami.qrc and kirigami.qrc.in
3		* Copyright 2019 Arjen Hiemstra <ahiemstra@heimr.nl>
4		*
5		* This program is free software; you can redistribute it and/or modify
6		* it under the terms of the GNU Library General Public License as
7		* published by the Free Software Foundation; either version 2, or
8		* (at your option) any later version.
9		*
10		* This program is distributed in the hope that it will be useful,
11		* but WITHOUT ANY WARRANTY; without even the implied warranty of
12		* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13		* GNU Library General Public License for more details
14		*
15		* You should have received a copy of the GNU Library General Public
16		* License along with this program; if not, write to the
17		* Free Software Foundation, Inc.,
18		* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19		*/
20
21		import QtQuick 2.7
22		import QtQuick.Layouts 1.2
23		import QtQuick.Controls 2.4 as Controls
24		import org.kde.kirigami 2.5 as Kirigami
25
26		/**
27		* This fairly complex thing determines the layout of ActionToolBar, that is,
28		* which actions should be displayed in full width toolbutton form, which should
29		* be displayed in an icon-only reduced size and which should be placed in the
30		* overflow menu.
31		*
32		* It makes use of two fairly static layouts, one contains all actions in expanded
33		* full-size form, the other in reduced icon-only form. The items in these layouts
34		* determine if they should be visible based on their relative position and size
35		* and some properties of the action. The update function then goes through these
36		* items, adding the actions to the relevant lists, so they can be used by the
37		* ActionToolBar to determine which action should be visible in what state.
38		*
39		* The reason for using two separate layouts from ActionToolBar's main layout is
40		* so that we can use the actual geometry of the buttons to calculate the
41		* visibility, completely disregarding any other layouting quirks. We can then
42		* use that information so only the relevant things in the ActionToolBar are
43		* visible. This allows the main ActionToolBar to use normal layout features for
44		* things like the positioning of the visible actions.
45		*/
46		Item {
47		id: details
48
49		property var actions
50
51		property var visibleActions: []
52		property var hiddenActions: []
53		property var iconOnlyActions: []
54
55		property bool flat: false
56		property int display: Controls.Button.TextBesideIcon
57		property real spacing: Kirigami.Units.smallSpacing
58		property real leftPadding: 0
59		property real rightPadding: 0
60
61		property real iconOnlyWidth: 0
62		readonly property real iconLayoutWidth: width - rightPadding
63		readonly property real fullLayoutWidth: iconLayoutWidth - iconOnlyWidth
64
65		enabled: false
66		opacity: 0 // Cannot use visible: false because then relayout doesn't happen correctly
67
68		function update() {
69		var visible = []
70		var hidden = []
71		var iconOnly = []
72		var iconsWidth = 0
73
74		if (details.width >= fullSizePlaceholderLayout.width + details.rightPadding) {
75		visibleActions = Array.prototype.map.call(details.actions, function(i) { return i })
76		hiddenActions = []
77		iconOnlyActions = []
78		iconOnlyWidth = 0
79		return
80		}
81
82		for (var i = 0; i < root.actions.length; ++i) {
83		var item = fullSizePlaceholderRepeater.itemAt(i)
84		var iconOnlyItem = iconOnlyPlaceholderRepeater.itemAt(i)
85
86		if (item.actionVisible) {
87		visible.push(item.kirigamiAction)
88		} else if (iconOnlyItem.actionVisible) {
89		visible.push(item.kirigamiAction)
90		iconOnly.push(item.kirigamiAction)
91		iconsWidth += iconOnlyItem.width + details.spacing
92		} else {
93		hidden.push(item.kirigamiAction)
94		}
95		}
96
97		visibleActions = visible
98		hiddenActions = hidden
99		iconOnlyActions = iconOnly
100		iconOnlyWidth = iconsWidth
101		}
102
103		onWidthChanged: Qt.callLater(update)
104		Component.onCompleted: Qt.callLater(update)
105
106		RowLayout {
107		id: fullSizePlaceholderLayout
108		spacing: details.spacing
109
110		// This binding is here to take care of things like visibility changes
111		onWidthChanged: Qt.callLater(details.update)
112
113		Repeater {
114		id: fullSizePlaceholderRepeater
115
116		model: details.actions
117
118		PrivateActionToolButton {
119		flat: details.flat && !modelData.icon.color.a
120		display: details.display
121		visible: (modelData.visible === undefined \|\| modelData.visible)
122		&& (modelData.displayHint !== undefined && !modelData.displayHintSet(Kirigami.Action.DisplayHint.AlwaysHide))
123		kirigamiAction: modelData
124		property bool actionVisible: visible && (x + width < details.fullLayoutWidth)
125		}
126		}
127		}
128
129		RowLayout {
130		id: iconOnlyPlaceholderLayout
131		spacing: details.spacing
132
133		Repeater {
134		id: iconOnlyPlaceholderRepeater
135
136		model: details.actions
137
138		PrivateActionToolButton {
139		flat: details.flat && !modelData.icon.color.a
140		display: Controls.Button.IconOnly
141		visible: (modelData.visible === undefined \|\| modelData.visible)
142		&& (modelData.displayHint !== undefined && modelData.displayHintSet(Kirigami.Action.DisplayHint.KeepVisible))
143		kirigamiAction: modelData
144		property bool actionVisible: visible && (x + width < details.iconLayoutWidth)
145		}
146		}
147		}
148		}