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
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>`_.
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
ListBox {
factory: ListItemFactory {
template {
ListView {
factory: BuilderListItemFactory {
template ListItem {
child: Label {
label: bind item.string;
label: bind template.item as <StringObject>.string;
};
}
}
};
model: NoSelection {
model: StringList {
strings [ "Item 1", "Item 2", "Item 3" ]
}
};
};
}