Python: How to define TableColumns for a ListModel

[lars-sorgalla]

Hello,
I have created a ListModel in Python to represent a table. This is working fine. But I am stuck with defining the columns for this table.

On Slint side the ListModel is used as a StandardTableView where the row property correctly gets the data. But how do I define the columns (using the type [TableColumn])?

On a side note: having an example somewhere in the docs for this would be great.

[aashishrajdev]

TableColumn is a built-in struct, so from Python it works like any other struct array: expose a [TableColumn] property, forward it to the table, and assign a slint.ListModel of columns.

app.slint

import { StandardTableView } from "std-widgets.slint";

export component MainWindow inherits Window {
    in property <[TableColumn]> columns;
    in property <[[StandardListViewItem]]> rows;

    StandardTableView {
        columns: root.columns;
        rows: root.rows;
    }
}

main.py

import slint
from slint.language import SortOrder, StandardListViewItem, TableColumn

ui = slint.load_file("app.slint").MainWindow()

ui.columns = slint.ListModel([
    TableColumn(title="Name", min_width=120.0, horizontal_stretch=1.0, sort_order=SortOrder.unsorted),
    TableColumn(title="Age", sort_order=SortOrder.unsorted),
])

ui.rows = slint.ListModel([
    slint.ListModel([StandardListViewItem(text="Alice"), StandardListViewItem(text="31")]),
    slint.ListModel([StandardListViewItem(text="Bob"), StandardListViewItem(text="42")]),
])

ui.run()

A few notes:

• Fields use snake_case in Python (min_width, horizontal_stretch, sort_order, width). They map to the kebab-case Slint fields.
• Set sort_order explicitly. The named tuple fills in ""/0.0 for the other fields, but sort_order defaults to None.
• Plain dicts work too, e.g. {"title": "Name", "min_width": 0.0, "horizontal_stretch": 1.0, "sort_order": SortOrder.unsorted, "width": 0.0}. Just include all the fields.
• Use a ListModel, not a list. The table writes back into the columns model: clicking a header updates sort-order, and dragging a column edge updates width.
• slint.language.TableColumn and SortOrder are available from Slint 1.17.
• If your columns never change, you can skip Python and write them in .slint: columns: [{ title: "Name" }, { title: "Age" }];

[lars-sorgalla]

super cool. Thank you very much. I was not aware that the columns also need to be defined in a ListModel. Instead I was just using a list[TableColumn] which did not work.