Widgets

Slint provides a series of built-in widgets that can be imported from "std-widgets.slint".

The widget appearance depends on the selected style. The following styles are available:

  • fluent: The Fluent style implements the Fluent Design System.

  • material: The Material style implements the Material Design.

  • native: The Native style resembles the appearance of the controls that are native to the platform they are used on. This specifically includes support for the look and feel of controls on macOS and Windows. This style is only available if you have Qt installed on your system.

See Selecting a Widget Style for details how to select the style. If no style is selected, native is the default. If native is not available, fluent is the default.

Button

Properties

  • checkable (bool): Shows whether the button can be checked or not. This enables the checked property to possibly become true.

  • checked (bool): Shows whether the button is checked or not. Needs checkable to be true to work.

  • enabled: (bool): Defaults to true. When false, the button cannot be pressed

  • icon (image): The image to show in the button. Note that not all styles support drawing icons.

  • pressed: (bool): Set to true when the button is pressed.

  • text (string): The text written in the button.

Callbacks

  • clicked

Example

import { Button, VerticalBox } from "std-widgets.slint";
export component Example inherits Window {
    VerticalBox {
        Button {
            text: "Click Me";
            clicked => { self.text = "Clicked"; }
        }
    }
}

StandardButton

The StandardButton looks like a button, but instead of customizing with text and icon, it can used one of the pre-defined kind and the text and icon will depend on the style.

Properties

  • kind (enum): The kind of button, one of ok cancel, apply, close, reset, help, yes, no, abort, retry or ignore

  • enabled: (bool): Defaults to true. When false, the button cannot be pressed

Callbacks

  • clicked

Example

import { StandardButton, VerticalBox } from "std-widgets.slint";
export component Example inherits Window {
  VerticalBox {
    StandardButton { kind: ok; }
    StandardButton { kind: apply; }
    StandardButton { kind: cancel; }
  }
}

CheckBox

Properties

  • text (string): The text written next to the checkbox.

  • checked: (bool): Whether the checkbox is checked or not.

Callbacks

  • toggled: The checkbox value changed

Example

import { CheckBox } from "std-widgets.slint";
export component Example inherits Window {
    width: 200px;
    height: 25px;
    CheckBox {
        width: parent.width;
        height: parent.height;
        text: "Hello World";
    }
}

SpinBox

Properties

  • value (int): The value.

  • minimum (int): The minimum value (default: 0).

  • maximum (int): The maximum value (default: 100).

Example

import { SpinBox } from "std-widgets.slint";
export component Example inherits Window {
    width: 200px;
    height: 25px;
    SpinBox {
        width: parent.width;
        height: parent.height;
        value: 42;
    }
}

Slider

Properties

  • value (float): The value.

  • minimum (float): The minimum value (default: 0)

  • maximum (float): The maximum value (default: 100)

Callbacks

  • changed(float): The value was changed

Example

import { Slider } from "std-widgets.slint";
export component Example inherits Window {
    width: 200px;
    height: 25px;
    Slider {
        width: parent.width;
        height: parent.height;
        value: 42;
    }
}

GroupBox

Properties

  • title (string): A text written as the title of the group box.

Example

import { GroupBox } from "std-widgets.slint";
export component Example inherits Window {
    width: 200px;
    height: 100px;
    GroupBox {
        title: "A Nice Title";
        Text {
            text: "Hello World";
            color: blue;
        }
    }
}

LineEdit

A widget used to enter a single line of text

Properties

  • text (string): The text being edited

  • font-size (length): the size of the font of the input text

  • has-focus: (bool): Set to true when the line edit currently has the focus

  • placeholder-text: (string): A placeholder text being shown when there is no text in the edit field

  • enabled: (bool): Defaults to true. When false, nothing can be entered

  • read-only (bool): When set to true, text editing via keyboard and mouse is disabled but selecting text is still enabled as well as editing text programatically (default value: false)

  • input-type (enum InputType): The way to allow special input viewing properties such as password fields (default value: text).

  • horizontal-alignment (enum TextHorizontalAlignment): The horizontal alignment of the text.

Callbacks

  • accepted: Enter was pressed

  • edited: Emitted when the text has changed because the user modified it

Example

import { LineEdit } from "std-widgets.slint";
export component Example inherits Window {
    width: 200px;
    height: 25px;
    LineEdit {
        font-size: 14px;
        width: parent.width;
        height: parent.height;
        placeholder-text: "Enter text here";
    }
}

TextEdit

Similar to LineEdit, but can be used to enter several lines of text

Note: The current implementation only implement very few basic shortcut. More shortcut will be implemented in a future version: https://github.com/slint-ui/slint/issues/474

Properties

  • text (string): The text being edited

  • font-size (length): the size of the font of the input text

  • has-focus: (bool): Set to true when the widget currently has the focus

  • enabled: (bool): Defaults to true. When false, nothing can be entered

  • read-only (bool): When set to true, text editing via keyboard and mouse is disabled but selecting text is still enabled as well as editing text programatically (default value: false)

  • wrap (enum TextWrap): The way the text wraps (default: word-wrap).

  • horizontal-alignment (enum TextHorizontalAlignment): The horizontal alignment of the text.

Callbacks

  • edited: Emitted when the text has changed because the user modified it

Example

import { TextEdit } from "std-widgets.slint";
export component Example inherits Window {
    width: 200px;
    height: 200px;
    TextEdit {
        font-size: 14px;
        width: parent.width;
        height: parent.height;
        text: "Lorem ipsum dolor sit amet,\n consectetur adipisici elit";
    }
}

ScrollView

A Scrollview contains a viewport that is bigger than the view and can be scrolled. It has scrollbar to interact with. The viewport-width and viewport-height are calculated automatically to create a scollable view except for when using a for loop to populate the elements. In that case the viewport-width and viewport-height are not calculated automatically and must be set manually for scrolling to work. The ability to automatically calculate the viewport-width and viewport-height when using for loops may be added in the future and is tracked in issue #407.

Properties

  • viewport-width and viewport-height (length): The width and length properties of the viewport

  • viewport-x and viewport-y (length): The x and y properties of the viewport. Usually these are negative

  • visible-width and visible-height (length): The size of the visible area of the ScrollView (not including the scrollbar)

  • enabled and has-focus (bool): property that are only used to render the frame as disabled or focused, but do not change the behavior of the widget.

Example

import { ScrollView } from "std-widgets.slint";
export component Example inherits Window {
    width: 200px;
    height: 200px;
    ScrollView {
        width: 200px;
        height: 200px;
        viewport-width: 300px;
        viewport-height: 300px;
        Rectangle { width: 30px; height: 30px; x: 275px; y: 50px; background: blue; }
        Rectangle { width: 30px; height: 30px; x: 175px; y: 130px; background: red; }
        Rectangle { width: 30px; height: 30px; x: 25px; y: 210px; background: yellow; }
        Rectangle { width: 30px; height: 30px; x: 98px; y: 55px; background: orange; }
    }
}

ListView

A ListView is like a Scrollview but it should have a for element, and the content are automatically layed out in a list. Elements are only instantiated if they are visible

Properties

Same as ScrollView

Example

import { ListView } from "std-widgets.slint";
export component Example inherits Window {
    width: 150px;
    height: 150px;
    ListView {
        width: 150px;
        height: 150px;
        for data in [
            { text: "Blue", color: #0000ff, bg: #eeeeee},
            { text: "Red", color: #ff0000, bg: #eeeeee},
            { text: "Green", color: #00ff00, bg: #eeeeee},
            { text: "Yellow", color: #ffff00, bg: #222222 },
            { text: "Black", color: #000000, bg: #eeeeee },
            { text: "White", color: #ffffff, bg: #222222 },
            { text: "Magenta", color: #ff00ff, bg: #eeeeee },
            { text: "Cyan", color: #00ffff, bg: #222222 },
        ] : Rectangle {
            height: 30px;
            background: data.bg;
            width: parent.width;
            Text {
                x: 0;
                text: data.text;
                color: data.color;
            }
        }
    }
}

StandardListView

Like ListView, but with a default delegate, and a model property which is a model of type StandardListViewItem

The StandardListViewItem is equivalent to { text: string } but will be improved in the future with icon, checked and so on (TODO)

Properties

Same as ListView, and in addition:

  • model ([StandardListViewItem]): The model

  • current-item (int): The index of the currently active item. -1 mean none is selected, which is the default

Example

import { StandardListView } from "std-widgets.slint";
export component Example inherits Window {
    width: 150px;
    height: 150px;
    StandardListView {
        width: 150px;
        height: 150px;
        model: [ { text: "Blue"}, { text: "Red" }, { text: "Green" },
            { text: "Yellow" }, { text: "Black"}, { text: "White"},
            { text: "Magenta" }, { text: "Cyan" },
        ];
    }
}

StandardTableView

The StandardTableView represents a table of data with columns and rows. Cells are organised in a model where each row is a model of StandardListViewItem.

Properties

Same as ListView, and in addition:

  • current-sort-column (int): Indicates the sorted column. -1 mean no column is sorted.

  • columns ([TableColumn]): Defines the model of the table columns.

  • rows ([StandardListViewItem]): Defines the model of table rows.

Callbacks

  • sort-ascending(int): Emitted if the model should be sorted by the given column in ascending order.

  • sort-descending(int): Emitted if the model should be sorted by the given column in descending order.

Example

import { StandardTableView } from "std-widgets.slint";
export component Example inherits Window {
    width: 230px;
    height: 200px;
    StandardTableView {
        width: 230px;
        height: 200px;
        columns: [
            { title: "Header 1" },
            { title: "Header 2" },
        ];
        rows: [
            [
                { text: "Item 1" }, { text: "Item 2" },
            ],
            [
                { text: "Item 1" }, { text: "Item 2" },
            ],
            [
                { text: "Item 1" }, { text: "Item 2" },
            ]
        ];
    }
}

ComboBox

A button that, when clicked, opens a popup to select a value.

Properties

  • model ([string]): The list of possible values

  • current-index: (int): The index of the selected value (-1 if no value is selected)

  • current-value: (string): The currently selected text

  • enabled: (bool): When false, the combobox cannot be opened (default: true)

Callbacks

  • selected(string): A value was selected from the combo box. The argument is the currently selected value.

Example

import { ComboBox } from "std-widgets.slint";
export component Example inherits Window {
    width: 200px;
    height: 130px;
    ComboBox {
        y: 0px;
        width: self.preferred-width;
        height: self.preferred-height;
        model: ["first", "second", "third"];
        current-value: "first";
    }
}

TabWidget

TabWidget is a container for a set of tabs. It can only have Tab elements as children and only one tab will be visible at a time.

Properties

  • current-index (int): The index of the currently visible tab

Properties of the Tab element

  • title (string): The text written in the tab bar.

Example

import { TabWidget } from "std-widgets.slint";
export component Example inherits Window {
    width: 200px;
    height: 200px;
    TabWidget {
        Tab {
            title: "First";
            Rectangle { background: orange; }
        }
        Tab {
            title: "Second";
            Rectangle { background: pink; }
        }
    }
}

HorizontalBox, VerticalBox, GridBox

That’s the same as HorizontalLayout, VerticalLayout or GridLayout but the spacing and padding values depending on the style instead of defaulting to 0.

AboutSlint

This element displays the a β€œMade with Slint” badge.

import { AboutSlint } from "std-widgets.slint";
export component Example inherits Window {
    width: 128px;
    height: 128px;
    AboutSlint {
    }
}

Selecting a Widget Style

The widget style is selected at compile time of your project. The details depend on which programming language you’re using Slint with.

Selecting a Widget Style when using Slint with Rust:

Before you start your compilation, you can select the style by setting the SLINT_STYLE variable to one of the style names, such as fluent for example.

Selecting the Widget Style When Using the slint_build Crate

Select the style with the slint_build::compile_with_config() function in the compiler configuration argument.

Selecting the Widget Style When Using the slint_interpreter Crate

Select the style with the slint_interpreter::ComponentCompiler::set_style() function.

Selecting a Widget Style when using Slint with C++:

Select the style by defining a SLINT_STYLE CMake cache variable to hold the style name as a string. This can be done for example on the command line:

cmake -DSLINT_STYLE="material" /path/to/source

Selecting the Widget Style When Previewing Designs With slint-viewer

Select the style either by setting the SLINT_STYLE environment variable, or passing the style name with the --style argument:

slint-viewer --style material /path/to/design.slint

Selecting the Widget Style When Previewing Designs With The Slint Visual Studio Code Extension

Select the style by first opening the Visual Studio Code settings editor:

  • On Windows/Linux - File > Preferences > Settings

  • On macOS - Code > Preferences > Settings

Then enter the style name under Extensions > Slint > Preview:Style

Selecting the Widget Style When Previewing Designs With The Generic LSP Process

Select the style by setting the SLINT_STYLE environment variable before launching the process. Alternatively, if your IDE integration allows passing command line parameters, you can specify the style via --style.

structs

TableColumn

TableColumn is used to define the column and the column header of a TableView.

Properties

  • title (string): Describes the column header title.

  • min-width (length): Defines the minimum with of the column.

  • width (length): The current width of the column.

  • horizontal-stretch (float): Defines the horizontal stretch of the column.

  • sort-order (SortOrder): Describes the sort order of the column.

StandardListViewItem

The StandardListViewItem is used to display items in the StandardListView and the StandardTableView.

Properties

  • text (string): Describes the text of the item.