[gtk/list-styles: 1/3] lists: Mention list style classes in docs




commit 7b0a158fd8433f937b51f3ea07b7dff790e91d87
Author: Matthias Clasen <mclasen redhat com>
Date:   Wed Aug 5 16:41:53 2020 -0400

    lists: Mention list style classes in docs
    
    Document that GtkListView, GtkColumnView and GtkListBox
    support .rich-list, .navigation-sidebar and .data-table
    style classes.

 gtk/gtkcolumnview.c |  8 +++++++-
 gtk/gtklistbox.c    | 17 ++++++++++++-----
 gtk/gtklistview.c   |  8 +++++++-
 3 files changed, 26 insertions(+), 7 deletions(-)
---
diff --git a/gtk/gtkcolumnview.c b/gtk/gtkcolumnview.c
index 176481f2ba..f4da4693e7 100644
--- a/gtk/gtkcolumnview.c
+++ b/gtk/gtkcolumnview.c
@@ -80,7 +80,7 @@
  * # CSS nodes
  *
  * |[<!-- language="plain" -->
- * columnview[.column-separators]
+ * columnview[.column-separators][.rich-list][.navigation-sidebar][.data-table]
  * ├── header
  * │   ├── <column header>
  * ┊   ┊
@@ -101,6 +101,12 @@
  * #GtkColumnView:show-row-separators is set, it will be passed on to the
  * list view, causing its CSS node to carry the .separators style class.
  * For rubberband selection, a node with name rubberband is used.
+ *
+ * The main columnview node may also carry style classes to select
+ * the style of list presentation:
+ * - .rich-list
+ * - .navigation-sidebar
+ * - .data-table
  */
 
 struct _GtkColumnView
diff --git a/gtk/gtklistbox.c b/gtk/gtklistbox.c
index fd0a86e4d2..6e19e804ae 100644
--- a/gtk/gtklistbox.c
+++ b/gtk/gtklistbox.c
@@ -75,14 +75,21 @@
  * # CSS nodes
  *
  * |[<!-- language="plain" -->
- * list[.separators]
+ * list[.separators][.rich-list][.navigation-sidebar]
  * ╰── row[.activatable]
  * ]|
  *
- * GtkListBox uses a single CSS node named list. It may carry the .separators style
- * class, when the #GtkListBox:show-separators property is set. Each GtkListBoxRow uses
- * a single CSS node named row. The row nodes get the .activatable
- * style class added when appropriate.
+ * GtkListBox uses a single CSS node named list. It may carry the .separators
+ * style class, when the #GtkListBox:show-separators property is set. Each
+ * GtkListBoxRow uses a single CSS node named row. The row nodes get the
+ * .activatable style class added when appropriate.
+ *
+ * The main list node may also carry style classes to select
+ * the style of list presentation:
+ * - .rich-list
+ * - .navigation-sidebar
+ * - .data-table
+
  */
 
 typedef struct _GtkListBoxClass   GtkListBoxClass;
diff --git a/gtk/gtklistview.c b/gtk/gtklistview.c
index e0a33b42f4..cc638a06a4 100644
--- a/gtk/gtklistview.c
+++ b/gtk/gtklistview.c
@@ -118,7 +118,7 @@
  * # CSS nodes
  *
  * |[<!-- language="plain" -->
- * listview[.separators]
+ * listview[.separators][.rich-list][.navigation-sidebar][.data-table]
  * ├── row
  * │
  * ├── row
@@ -132,6 +132,12 @@
  * .separators style class, when #GtkListView:show-separators property
  * is set. Each child widget uses a single CSS node named row. For
  * rubberband selection, a node with name rubberband is used.
+ *
+ * The main listview node may also carry style classes to select
+ * the style of list presentation:
+ * - .rich-list
+ * - .navigation-sidebar
+ * - .data-table
  */
 
 typedef struct _ListRow ListRow;


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]