Module widgets 

Ready-made widgets. Every one takes its look from the theme and works with keyboard and mouse.

Re-exports

pub use crate::date::TimeOfDay;

Structs

Accordion

A vertical list of titled sections; each opens with a click or Enter to show its body.

AppShell

Builds the common application frame: a header on top, a sidebar on the left, the body beside it and a footer at the bottom.

Appearance

The appearance section of a settings page or a setup wizard: language, theme and icons as the family shares them, reduced motion and the pillar, as rows of a SettingsList.

Axis

A row of labels along the edge of a chart: hours of a day, weekdays, months, or names of your own.

Badge

A status pill: a tinted surface with a marker dot and a word, and optionally a count.

Bar

One bar of a BarChart.

BarChart

Bars measured in eighths of a cell, with labels and values.

BigText

Text drawn large from block elements: digits, :, ., %, - and the letters A to Z.

Breadcrumb

The path to the current place, such as workspace › quvyta › crates › src.

Button

A button: the shape is its surface colour, never brackets.

CardGrid

Cards laid out in as many columns as fit, for a store’s apps, a launcher’s programs or a choice of profiles. Only the cards on screen are built and drawn, so a grid of ten thousand cards costs what one screen of them costs.

Checkbox

A box that is checked or not, with an optional label.

CodeView

Code with syntax colours, line numbers and wrapping of long lines.

Column

A column of a Table: a title, a width rule, an alignment and whether it can be sorted.

CommandPalette

A layer with a filter field over a list of commands, for running anything from the keyboard.

ContextItem

One row of a menu: an action, a submenu or a gap between groups.

ContextMenu

Wraps an area and opens a menu of ContextItems at the pointer on a right click, or next to the focused widget on Shift+F10 or the menu key.

CopyValue

A value on a raised surface that copies itself to the clipboard: an install command, a token, a URL.

DatePicker

A field showing a chosen date that opens a calendar to choose another.

Divider

A pause between groups of content.

DurationInput

A length of time edited segment by segment: hours and minutes, optionally seconds, each followed by its unit in the active language: 1 h 30 min, 1 sa 30 dk.

EmptyState

A centred block explaining why an area is empty and what to do about it.

Field

A labelled control: the label, the control the application adds inside, and under it a faint hint or, when there is one, the error in the danger colour with a marker.

FileBrowser

The application-owned state of a FilePicker.

FileDetails

What one entry is besides its name: its size, when it changed last, and its permissions.

FileEntry

One entry of a folder.

FileManager

A folder as a tree, with every file operation on it.

FileManagerState

What a file manager has read of its root folder, what is open in it, and what is selected.

FilePicker

Browses folders and chooses a file or a folder.

FileWork

A long operation the manager is running in the background right now.

FolderEntry

One entry of a folder, as a file manager reads it: a name and whether it can be opened.

Form

A column of Fields that share one label layout, with an optional summary of problems above them.

FormErrors

The problems of a form, in the order the application found them, each under the name of the control it belongs to.

FormFields

Adds fields to a Form inside Form::show.

Gauge

A one-row meter for a value in a range: label, meter and value.

Ghost

A light surface that fills its area with the accent mixed into whatever lies under it: no lines, no text, nothing to click. It shows where something will be, for a window dragged as a ghost over a slow connection (the window stays put, only this moves, and it lands in one frame when the button comes up) and for the area a window would snap to.

Heatmap

A grid of days as tones: one cell per value, a column per week, the tone carrying how much that day holds.

HelpLayer

A layer listing every key binding: the hints of the current screen first, then the application’s keymap actions, then the framework’s. Labels come from the language files (keys.<action> and quvyta.keys.<action>), keys from the keymap, so rebinding a key or switching the language updates the list.

HoldToConfirm

A control that sends its message only after a key or the mouse button is held on it.

IconButton

A button that is one icon: a space, the glyph and a space, three cells in every glyph mode.

KeyHints

A bar of key hints such as tab next ctrl q quit, fed from the keymap and from hints the application adds for the current screen.

Legend

The names behind the tones of a chart: a patch of colour and the name it stands for.

List

A vertical list that only draws the rows it shows, so it stays fast with any number of items. For a very long list, keep the items as an Arc<[ListItem]> in your state and pass it to List::shared, so they are not built again every frame.

ListItem

One row of a List.

LogBuffer

A bounded store of log lines: when full, pushing drops the oldest line.

LogLine

One line of a log.

LogView

A view of a LogBuffer that follows new lines as they arrive.

Markdown

Rendered Markdown: headings with the accent pillar, wrapped paragraphs, lists, quotes and highlighted code blocks. Horizontal rules become space, never a drawn line.

Menu

The navigation column of an application: groups of destinations under faint headings.

MenuGroup

A group of items in a Menu, with an optional faint heading.

MenuItem

One destination in a Menu.

Modal

A dialog over a dimmed screen: a title, any content and action buttons.

Naming

The dialog that asks for a name, while it is open.

NumberInput

A text field for a number: typing edits it like a text input, Up and Down step it.

PageTransition

Wraps the current page and animates whenever its key changes.

PaletteCommand

One command of a CommandPalette.

Panel

A surface one step above its background, optionally titled, selectable and pressable.

Popover

Content shown as a layer next to an anchor, such as a filter panel under a button.

ProgressBar

A bar that fills as work completes, or sweeps while the amount is unknown.

RadioGroup

A set of options of which exactly one is chosen, for a few choices that should all stay visible. For many choices use a Select.

RailTab

One tab of a TabRail.

RowMark

How one row of a file manager looks, beyond what the manager itself knows.

ScrollMetrics

Position of a scrolled view: how many rows exist, how many are visible and the first visible row.

ScrollView

Shows content taller than its area and scrolls it with the wheel, the scrollbar or the keyboard (↑/↓, PgUp/PgDn, Home/End while focused). When focus moves to a widget inside that is out of view, the view scrolls to it. When a widget inside asks to show a part of itself with PaintCx::reveal, such as a code view going to a line, the view glides just far enough to show it, or jumps there when motion is reduced.

Section

The title of one section of an Accordion or a WidgetDock: a label with an optional icon and a faint detail on the right, such as a count.

Segmented

Side-by-side segments of one surface, of which the filled one is chosen: for two to five short, mutually exclusive choices such as a view mode, where the choice should read at a glance.

Select

A field showing the chosen option that opens a list of options as a layer.

Series

One series of a BarChart: a name and one value per category.

SettingRow

One setting of a SettingsList: a label, an optional description and the control added with SettingsRows::row.

SettingsList

Settings, one per row: the label (and a faint description) on the left, its control anchored on the right.

SettingsRows

Adds headings and rows to a SettingsList inside SettingsList::show.

Setup

The application-owned state of a SetupWizard: which step it is on, what has been chosen on the appearance step and how the Nerd Font install is going.

SetupWizard

The first-run wizard: the appearance step the framework draws and drives, then a step for each one the application adds, on the Wizard every other flow uses.

ShimmerText

A working message such as “processing”: either light passing over the letters or growing dots. One pass takes the theme’s motion.shimmer; with reduced motion the text is still.

SidePanel

A panel docked to the left or right of a body, on its own surface.

Skeleton

A placeholder in the shape of content that is on its way: text lines, an avatar or a block.

Slider

A value chosen along a range by moving a knob on a rail.

Span

A run of text with its own look inside a Text.

Sparkline

A compact trend: one column per value, newest on the right, measured in eighths of a cell.

Spinner

A one-cell indicator that something is working, with an optional label.

Splitter

Two panes that share an area: side by side with Splitter::columns, stacked with Splitter::rows. The application owns the size of the first pane; the second takes the rest.

Steps

Where a sequence of steps stands: finished steps carry a check in the success colour, the current step is bold with an accent marker, and upcoming steps are faint. Steps are set apart by space and tone; nothing connects them.

Switch

An on/off switch that applies at once, with an optional label.

TabRail

Tabs stacked down the side of the screen, such as the open projects of an IDE.

Table

Rows of cells under a header row. Only the rows on screen are drawn, so a table stays fast with any number of rows; pass the rows as an Arc<[TableRow]> kept in your state to avoid copying them every frame.

TableCell

One cell: text, optionally with a glyph before it and a colour.

TableRow

One row of a Table.

Tabs

A row of tabs. The open tab is a raised surface; tabs are never boxed or bracketed.

TaskList

Shows a Tasks model as rows built from existing widgets.

Text

Text that wraps to its width, or is cut with … when wrapping is off.

TextArea

A multi-line text field with word wrap, scrolling and real editing.

TextInput

A text field with real editing: cursor, selection, word jumps, undo and clipboard.

TimeBlock

One block of a Timeline: a stretch of the day with a name, such as work from 09:00 to 11:10.

TimeInput

A time of day edited segment by segment: hours and minutes, optionally seconds, on a 24-hour clock written the same in every language.

Timeline

A day as a strip: blocks of colour for what filled it, the empty track for the gaps between them — breaks, sleep, time not recorded.

Toast

A notification: a status marker and icon, a title, an optional body and action, and the shared three-cell close mark at the end of the title row.

Tooltip

Wraps widgets and shows a short text next to them after the pointer rests on them for the theme’s motion.hover-delay.

Tree

Nested rows that open and close, like folders.

TreeDrop

A drop of nodes into another node that a droppable tree asks for. The tree never changes the application’s nodes; the application moves them.

TreeMove

A move of one node among its siblings that a reorderable tree asks for. The tree never changes the application’s nodes; apply does the bookkeeping on the application’s own list of siblings.

TreeNode

One node of a Tree, identified by a key that stays the same while the tree changes.

WidgetDock

A vertical stack of titled widgets filling the area it is given, like the side panel of an IDE: each widget opens and closes, and open widgets share the height between them.

Window

A window: a title strip one row tall above a body, with no border lines, for applications that put surfaces where the user drags them, such as a desktop or a tool box. Place it with View::place inside a stack; the body is built with View::add_with.

Wizard

A flow of pages the user goes through in order: Steps on top, the current step’s page, and a row of buttons.

Enums

AppearanceChange

A change made on the Appearance rows. The application hands it back to Appearance::update, which saves it and returns the command that shows it.

CheckboxStyle

How a Checkbox looks.

Closed

What closing a SidePanel leaves behind.

CollapsedMarker

What the one-cell marker of a tab in a collapsed TabRail shows.

ColumnWidth

How wide a Column is.

Corner

The screen corner toasts stack in.

DurationError

Why a written length of time could not be read. message says it in the active language.

DurationUnit

A unit of a length of time.

FileChange

What an operation changed, by key.

FileError

Why a file operation was not done.

FileManagerMsg

Something that happened in a FileManager.

FilePickerMsg

Something that happened in a FilePicker. Hand every message to FileBrowser::update, except FilePickerMsg::Chosen, which is the result.

FileView

The shape a file manager draws its folder in.

Gradient

Which way a BigText gradient runs.

ItemKind

What kind of row an item is.

Language

A language CodeView can colour.

LineMark

How a line of a diff changed; see CodeView::line_marks.

LineTone

The tone of highlighted lines; see CodeView::highlight_lines.

ListingError

Why a folder could not be read.

LogLevel

How important a log line is.

NameFor

What the name the dialog asks for is for.

NameProblem

Why a name cannot be used, as the person types it.

Overflow

What a Tabs strip does when its tabs do not fit.

PickMode

Whether a picker chooses files or folders.

Placement

The side of its anchor a layer prefers. When the layer does not fit there it flips to the opposite side, and it is always kept on screen.

RadioStyle

How the options of a RadioGroup are marked.

ScrollbarStyle

How a scrollbar is drawn. The theme picks one with [style.scrollbar] style = "…"; scrolling widgets can pin one with their scrollbar option.

SetupMsg

Something that happened on the first step of a SetupWizard, or on its buttons. Every one of them goes to Setup::update; the application never answers one itself.

ShimmerStyle

How ShimmerText moves.

Side

Which side a SidePanel is docked to.

SortDirection

Which way a sorted column is ordered.

SpinnerStyle

How a Spinner moves. Every style is a built-in cell animation with Nerd Font, Unicode and ASCII frames, which themes and applications can replace.

SwitchStyle

How a Switch looks.

TabEdit

A change a closable or reorderable tab view asks for. Tab views never change the application’s tabs themselves; TabEdit::apply does the bookkeeping on the application’s own list.

TabWidth

How wide each tab of a Tabs strip is.

ToastKind

What a toast reports; picks its status colour and icon.

WindowEdge

An edge or a corner of a window being resized, see WindowEvent::Resize.

WindowEvent

What the pointer did to a Window, sent through Window::on_event.

Functions

child_key

The key of the entry name inside the folder parent.

copy_into

Copies the entry key into the folder into, keeping its name; a folder is copied with everything in it.

is_inside

Whether key names an entry under a root: a path of plain names, none of them empty, . or .., and not starting at /.

is_within

Whether key is folder or somewhere below it.

name_of

The name of the entry key, without the folders before it.

parent_key

The key of the folder an entry is in, the root for an entry directly in it.

parse_duration

Reads a length of time written by hand, in any language i18n knows.

read_folder

Reads the entries of folder, folders first, then by name ignoring case. Blocks on the file system: call it from Command::perform, never from view.

Type Aliases

Listing

What reading a folder gave.