[gtk+] Update CSS nodes documentation



commit 5a83787dc0315df426f4ee5aae0b1068abb58449
Author: Cosimo Cecchi <cosimoc gnome org>
Date:   Mon Feb 29 10:43:12 2016 -0800

    Update CSS nodes documentation

 gtk/gtkscale.c     |   25 +++++++++++++++++--------
 gtk/gtkscrollbar.c |   19 ++++++++++---------
 2 files changed, 27 insertions(+), 17 deletions(-)
---
diff --git a/gtk/gtkscale.c b/gtk/gtkscale.c
index 3caecb7..ab49746 100644
--- a/gtk/gtkscale.c
+++ b/gtk/gtkscale.c
@@ -79,20 +79,24 @@
  * scale[.fine-tune]
  * ├── marks.top
  * │   ├── mark
+ * │   ┊    ├── [label]
+ * │   ┊    ╰── indicator
  * ┊   ┊
  * │   ╰── mark
- * ├── trough
- * │   ├── slider
- * │   ├── [highlight]
- * │   ╰── [fill]
+ * ├── contents
+ * │   ╰── trough
+ * │       ├── slider
+ * │       ├── [highlight]
+ * │       ╰── [fill]
  * ╰── marks.bottom
  *     ├── mark
- *     ┊
+ *     ┊    ├── indicator
+ *     ┊    ╰── [label]
  *     ╰── mark
  * ]|
  *
- * GtkScale has a main CSS node with name scale, and subnodes with names
- * trough and slider.
+ * GtkScale has a main CSS node with name scale and a subnode for its contents,
+ * with subnodes named trough and slider.
  *
  * The main node gets the style class .fine-tune added when the scale is in
  * 'fine-tuning' mode.
@@ -105,9 +109,14 @@
  * there is a subnode with name fill below the trough node that is used for
  * rendering the filled in part of the trough.
  *
- * If marks are present, there is a marks subnode before or after the trough
+ * If marks are present, there is a marks subnode before or after the contents
  * node, below which each mark gets a node with name mark. The marks nodes get
  * either the .top or .bottom style class.
+ *
+ * The mark node has a subnode named indicator. If the mark has text, it also
+ * has a subnode named label. When the mark is either above or left of the
+ * scale, the label subnode is the first when present. Otherwise, the indicator
+ * subnode is the first.
  */
 
 
diff --git a/gtk/gtkscrollbar.c b/gtk/gtkscrollbar.c
index 0f4ca11..27c9c7f 100644
--- a/gtk/gtkscrollbar.c
+++ b/gtk/gtkscrollbar.c
@@ -57,17 +57,18 @@
  * # CSS nodes
  *
  * |[<!-- language="plain" -->
- * scrollbar
- * ├── [button.down]
- * ├── [button.up]
- * ├── trough
- * │   ╰── slider
- * ├── [button.down]
- * ╰── [button.up]
+ * scrollbar[.fine-tune]
+ * ╰── contents
+ *     ├── [button.up]
+ *     ├── [button.down]
+ *     ├── trough
+ *     │   ╰── slider
+ *     ├── [button.up]
+ *     ╰── [button.down]
  * ]|
  *
- * GtkScrollbar has a main CSS node with name scrollbar, and subnodes with
- * names trough and slider.
+ * GtkScrollbar has a main CSS node with name scrollbar and a subnode for its
+ * contents, with subnodes named trough and slider.
  *
  * The main node gets the style class .fine-tune added when the scrollbar is
  * in 'fine-tuning' mode.


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