Siklos/blueprint-compiler
1
0
Fork 0
mirror of https://gitlab.gnome.org/jwestman/blueprint-compiler.git synced 2025-05-04 15:59:08 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs: Fix ExtListItemFactory example & description

Browse source
This commit is contained in:
James Westman 2023-05-16 17:33:37 -05:00
parent e4bad039b0
commit 9e02051e12
1 changed files with 13 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

20
docs/reference/extensions.rst
View file

@ -187,28 +187,30 @@ Gtk.BuilderListItemFactory Templates
.. rst-class:: grammar-block .. rst-class:: grammar-block
ExtListItemFactory = 'template' :ref:`ObjectContent<Syntax Object>` ExtListItemFactory = 'template' :ref:`TypeName<Syntax TypeName>` :ref:`ObjectContent<Syntax Object>`
Valid in `Gtk.BuilderListItemFactory <https://docs.gtk.org/gtk4/class.BuilderListItemFactory.html>`_. Valid in `Gtk.BuilderListItemFactory <https://docs.gtk.org/gtk4/class.BuilderListItemFactory.html>`_.
The ``template`` block defines the template that will be used to create list items. This block is unique within Blueprint because it defines a completely separate sub-blueprint which is used to create the list items. The sub-blueprint may not reference objects in the main blueprint or vice versa. The ``template`` block defines the template that will be used to create list items. This block is unique within Blueprint because it defines a completely separate sub-blueprint which is used to create each list item. The sub-blueprint may not reference objects in the main blueprint or vice versa.
The template type is `Gtk.ListItem <https://docs.gtk.org/gtk4/class.ListItem.html>`_, and the template should have a ``child`` property. The template type must be `Gtk.ListItem <https://docs.gtk.org/gtk4/class.ListItem.html>`_. The template object can be referenced with the ``template`` keyword.
.. code-block:: blueprintui .. code-block:: blueprintui
ListBox { ListView {
factory: ListItemFactory { factory: BuilderListItemFactory {
template { template ListItem {
child: Label { child: Label {
label: bind item.string; label: bind template.item as <StringObject>.string;
}; };
} }
} };
model: NoSelection {
model: StringList { model: StringList {
strings [ "Item 1", "Item 2", "Item 3" ] strings [ "Item 1", "Item 2", "Item 3" ]
} };
};
} }