gtk:widget, gobject:initially-unowned, gtk:accessible, gtk:buildable, gtk:constraint-target, gobject:object, common-lisp:standard-object, common-lisp:t

None

The gtk:list-box widget is a vertical list box that contains gtk:list-box-row children. These rows can by dynamically sorted and filtered, and headers can be added dynamically depending on the row content. It also allows keyboard and mouse navigation and selection like a typical list.


Figure: GtkListBox

Although a gtk:list-box widget must have only gtk:list-box-row children you can add any kind of widget to it via the gtk:list-box-prepend, gtk:list-box-append, and gtk:list-box-insert functions, and a gtk:list-box-row widget will automatically be inserted between the list and the widget.

The gtk:list-box-row widget can be marked as activatable or selectable. If a row is activatable, the "row-activated" signal will be emitted for it when the user tries to activate it. If it is selectable, the row will be marked as selected when the user tries to select it. The gtk:list-box implementation of the gtk:buildable interface supports setting a child as the placeholder by specifying "placeholder" as the "type" attribute of a <child> element. See also the gtk:list-box-set-placeholder function. The following signals have default keybindings:

• "move-cursor"
• "select-all"
• "toggle-cursor-row"
• "unselect-all"

list[.separators][.rich-list][.navigation-sidebar][.boxed-list]
╰── row[.activatable]    

The gtk:list-box implementation uses a single CSS node named list. It may carry the .separators style class, when the show-separators property is set. Each gtk:list-box-row widget uses a single CSS node named row. The row nodes get the .activatable style class added when appropriate. It may also carry the .boxed-list style class. In this case, the list will be automatically surrounded by a frame and have separators. The main list node may also carry style classes to select the style of list presentation: .rich-list, .navigation-sidebar or .data-table. The gtk:list-box implementation uses the :list role. The gtk:list-box-row implementation uses the :list-item role.