Commit 2f544655 authored by Matthias Clasen's avatar Matthias Clasen

Revise CSS node documentation

Clarify the use of brackets in the CSS node diagrams:
[] means optional nodes or classes, <> means child widgets.
parent fe9301ac
......@@ -57,7 +57,8 @@
*
* |[<!-- language="plain" -->
* checkbutton
* ╰── check
* ├── check
* ╰── <child>
* ]|
*
* A GtkCheckButton with indicator (see gtk_toggle_button_set_mode()) has a
......@@ -65,7 +66,8 @@
*
* |[<!-- language="plain" -->
* button.check
* ╰── [check]
* ├── check
* ╰── <child>
* ]|
*
* A GtkCheckButton without indicator changes the name of its main node
......
......@@ -53,8 +53,8 @@
*
* |[<!-- language="plain" -->
* menuitem
* ├── ...
* ╰── check.right
* ├── check.left
* ╰── <child>
* ]|
*
* GtkCheckMenuItem has a main CSS node with name menuitem, and a subnode
......
......@@ -94,8 +94,8 @@
* expander
* ├── title
* │ ├── arrow
* │ ╰── label widget
* ╰── child
* │ ╰── <label widget>
* ╰── <child>
* ]|
*
* GtkExpander has three CSS nodes, the main node with the name expander,
......
......@@ -57,9 +57,9 @@
* |[<!-- language="plain" -->
* flowbox
* ├── flowboxchild
* │ ╰── child
* │ ╰── <child>
* ├── flowboxchild
* │ ╰── child
* │ ╰── <child>
* ┊
* ╰── [rubberband]
* ]|
......
......@@ -55,7 +55,7 @@
*
* # CSS nodes
*
* GtkGrid uses a single CSS node wiht name grid.
* GtkGrid uses a single CSS node with name grid.
*/
typedef struct _GtkGridChild GtkGridChild;
......
......@@ -89,7 +89,7 @@
* |[<!-- language="plain" -->
* levelbar[.discrete]
* ╰── trough
* ├── block.filled.<level-name>
* ├── block.filled.level-name
* ┊
* ├── block.empty
* ┊
......@@ -100,7 +100,7 @@
* trough node are a number of nodes with name block and style class .filled
* or .empty. In continuous mode, there is exactly one node of each, in discrete
* mode, the number of filled and unfilled nodes corresponds to blocks that are
* drawn. The block.filled nodes also get a style class .<level-name> corresponding
* drawn. The block.filled nodes also get a style class .level-name corresponding
* to the level for the current value.
*/
#include "config.h"
......
......@@ -88,7 +88,9 @@
* |[<!-- language="plain" -->
* menu
* ├── arrow.top
* ├── ...
* ├── <child>
* ┊
* ├── <child>
* ╰── arrow.bottom
* ]|
*
......
......@@ -92,7 +92,7 @@
*
* |[<!-- language="plain" -->
* menuitem
* ├── ...
* ├── <child>
* ╰── [arrow.right]
* ]|
*
......
......@@ -111,19 +111,19 @@
*
* |[<!-- language="plain" -->
* modelbutton
* ├── ...
* ├── <child>
* ╰── check
* ]|
*
* |[<!-- language="plain" -->
* modelbutton
* ├── ...
* ├── <child>
* ╰── radio
* ]|
*
* |[<!-- language="plain" -->
* modelbutton
* ├── ...
* ├── <child>
* ╰── arrow
* ]|
*
......
......@@ -101,19 +101,20 @@
* |[<!-- language="plain" -->
* notebook
* ├── header.top
* │ ├── [action widget]
* │ ├── [<action widget>]
* │ ├── tabs
* │ │ ├── [arrow]
* │ │ ├── tab
* ┊ ┊ ┊ ╰── [tab label]
* │ │ │ ╰── <tab label>
* ┊ ┊ ┊
* │ │ ├── tab[.reorderable-page]
* │ │ │ ╰── [tab label]
* │ │ │ ╰── <tab label>
* │ │ ╰── [arrow]
* │ ╰── [action widget]
* │ ╰── [<action widget>]
* │
* ├── [child]
* ├── <child>
* ┊
* ╰── [child]
* ╰── <child>
* ]|
*
* GtkNotebook has a main CSS node with name notebook, a subnode
......
......@@ -85,7 +85,9 @@
*
* |[<!-- language="plain" -->
* paned
* ╰── separator[.wide]
* ├── <child>
* ├── separator[.wide]
* ╰── <child>
* ]|
*
* GtkPaned has a main CSS node with name paned, and a subnode for
......
......@@ -76,7 +76,8 @@
*
* |[<!-- language="plain" -->
* radiobutton
* ╰── radio
* ├── radio
* ╰── <child>
* ]|
*
* A GtkRadioButton with indicator (see gtk_toggle_button_set_mode()) has a
......@@ -84,7 +85,8 @@
*
* |[<!-- language="plain" -->
* button.radio
* ╰── [radio]
* ├── radio
* ╰── <child>
* ]|
*
* A GtkRadioButton without indicator changes the name of its main node
......
......@@ -66,8 +66,8 @@
*
* |[<!-- language="plain" -->
* menuitem
* ├── ...
* ╰── radio
* ├── radio.left
* ╰── <child>
* ]|
*
* GtkRadioMenuItem has a main CSS node with name menuitem, and a subnode
......
......@@ -78,16 +78,16 @@
* scale[.fine-tune]
* ├── marks.top
* │ ├── mark
* │ ├── mark
* │ ╰── ...
* ┊ ┊
* │ ╰── mark
* ├── trough
* │ ├──slider
* │ ├── slider
* │ ├── [highlight]
* │ ╰── [fill]
* ╰── marks.bottom
* ├── mark
* ├── mark
* ╰── ...
*
* ╰── mark
* ]|
*
* GtkScale has a main CSS node with name scale, and subnodes with names
......
......@@ -129,9 +129,9 @@
* |[<!-- language="plain" -->
* treeview.view
* ├── header
* │ ├── [column header]
* │ ├── [column header]
┊ ┊
* │ ├── <column header>
* ┊ ┊
* │ ╰── <column header>
* │
* ╰── [rubberband]
* ]|
......
......@@ -131,7 +131,8 @@
*
* |[<!-- language="plain" -->
* window
* ╰── decoration
* ├── decoration
* ╰── <child>
* ]|
*
* GtkWindow has a main CSS node with name window and style class .background,
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment