@@ -16,9 +16,21 @@
1616
1717import QtQuick 2.0
1818
19+/*! \brief Tool for introspecting Card properties.
20+
21+ Some properties of Cards we need to determine category-wide (like card sizes in grid),
22+ so we should not do them per-Card but in the category renderer.
23+
24+ This component creates an invisible card filled with maximum mapped data and calculates
25+ or measures card properties for this configuration.
26+ */
27+
1928Item {
2029 id: cardTool
30+ /// Template supplied for the category.
2131 property var template
32+
33+ /// Component mapping supplied for the category.
2234 property var components
2335
2436 // FIXME: Saviq
@@ -28,6 +40,9 @@ Item {
2840 height: 0
2941 clip: true
3042
43+ /// type:real \brief Width to be enforced on the card in this configuration.
44+ ///
45+ /// If undefined, should use implicit width of the actual card.
3146 property var cardWidth: {
3247 switch (template !== undefined && template["category-layout"]) {
3348 case "grid":
@@ -46,6 +61,9 @@ Item {
4661 }
4762 }
4863
64+ /// type:real \brief Height to be enforced on the card in this configuration.
65+ ///
66+ /// If undefined, should use implicit height of the actual card.
4967 property var cardHeight: {
5068 switch (template !== undefined && template["category-layout"]) {
5169 case "journal":