KitDataTable
Tableau de données avec lignes virtualisées et tri demandé au contrôleur.

Fournissez columns, rows, generation et active-index depuis un modèle à identités stables. Traitez sort-requested(column-token), navigate et activate(row-token, generation).
Les en-têtes présentent DataSortDirection.unsorted, .ascending ou .descending, sans trier localement. Le viewport reste fini, les colonnes peuvent défiler horizontalement et reveal-active() rend la ligne active visible.
Exemple complet
Ce fichier Slint complet présente une composition visuelle et produit la capture ci-dessus. Les textes internes sans propriété de libellé conservent la langue par défaut du kit ; les dialogues système suivent la plateforme. Les états projetés et les signaux qui demandent une décision doivent être raccordés à l’hôte ; cet exemple isolé ne fournit pas ce contrôleur. Configurer le projet Rust, puis consulter l’application avec contrôleurs typés pour relier réellement édition, validation et sélection.
// Public label overrides localize this fixture; toolkit/host defaults keep their language.
// SPDX-License-Identifier: GPL-3.0-or-later
import { DataAlignment, DataSortDirection, KitDataTable, KitTheme, KitThemes } from "@kit/kit.slint";
export component Example inherits Window {
title: "KitDataTable — exemple";
preferred-width: 620px;
preferred-height: 400px;
max-width: 100000px;
max-height: 100000px;
background: root.theme.canvas;
in-out property <KitTheme> theme: KitThemes.light;
in-out property <string> status;
VerticalLayout {
padding: 24px; spacing: 16px; alignment: start;
Text { text: "Tableau de données"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
KitDataTable { label: "Tableau de données"; theme: root.theme; height: 250px; generation: 1; columns: [{ token: 11, label: "Projet", sortable: true, sort: DataSortDirection.ascending, alignment: DataAlignment.leading }, { token: 23, label: "État", sortable: true, sort: DataSortDirection.unsorted, alignment: DataAlignment.leading }, { token: 38, label: "Responsable", sortable: false, sort: DataSortDirection.unsorted, alignment: DataAlignment.leading }]; rows: [{ token: 101, cells: ["Notes de terrain", "En cours", "Alex"], selected: true, disabled: false }, { token: 205, cells: ["Système de design", "Révision", "Jamie"], selected: false, disabled: false }, { token: 309, cells: ["Plan de lancement", "Brouillon", "Taylor"], selected: false, disabled: false }]; activate(token, generation) => { root.status = "Identifiant du projet " + token; } }
if root.status != "": Text { text: root.status; color: root.theme.text-secondary; font-size: 12px * root.theme.text-scale; wrap: word-wrap; }
}
}
API publique
Hérite de Rectangle.
Les déclarations suivantes sont extraites des sources du composant. Les propriétés du parent restent disponibles ; les détails de gestion d’état sont décrits dans le guide des contrôleurs.
Propriétés
| Nom | Type | Sens |
|---|---|---|
theme |
KitTheme |
in |
control-size |
ControlSize |
in |
columns |
[TableColumn] |
in |
rows |
[TableRow] |
in |
generation |
int |
in |
active-index |
int |
in |
label |
string |
in |
minimum-column-width |
length |
in |
scroll-y |
length |
out |
Types et variantes
Les noms ci-dessous utilisent la syntaxe Slint. Les types Rust partagés se trouvent dans slint_kit ; les enums de présentation proviennent des types Rust générés par Slint.
| Type | Déclaration |
|---|---|
enum ControlSize |
compact, medium, comfortable |
enum DataAlignment |
leading, center, trailing |
enum DataSortDirection |
unsorted, ascending, descending |
enum NavigationStep |
next, previous, first, last, page-next, page-previous |
struct TableColumn |
token: int, label: string, sortable: bool, sort: DataSortDirection, alignment: DataAlignment |
struct TableRow |
token: int, cells: [string], selected: bool, disabled: bool |
Signaux
activate(int,int)navigate(NavigationStep)sort-requested(int)
Fonctions
take-focus()reveal-active()