Built-in Controls
Here are some of the more commonly-used Avalonia controls, organized by category:
Layout controls
| Control | Description |
|---|---|
| Border | Decorates a single child with a border and background. |
| Canvas | Displays child controls at specified positions. |
| Dock Panel | Arranges child controls along specified edges (top, bottom, left, right) with one filling any remaining space. |
| Expander | Has a header area (always visible) and a collapsible content section (single child). |
| Grid | Arranges child controls in the cells of a grid, positioned by row and column. The cells can span rows and columns. |
| Grid Splitter | Can be added to a grid to allow the user to resize rows or columns at runtime. |
| Panel | Stacks child controls on top of one another. |
| Relative Panel | Allows multiple child controls. The position and alignment of the child controls can be specified in relation to the panel itself, or in relation to other child controls. The size of child controls can be specified, or calculated from relations and alignments. |
| Scroll Viewer | Adds scroll bars and scrolling behavior if the (single) child is larger than the space available. |
| Split View | Adds a collapsible pane to the edge of its (single child) content zone. |
| Stack Panel | Allows multiple child controls, arranged in sequence, horizontally or vertically. |
| Tab Control | The tab control allows you to sub-divide a view into tab items. |
| Uniform Grid | Allows multiple child controls, arranged in a grid with cells of uniform column and row size. |
| Wrap Panel | Arranges child controls in sequence from left to right, while they fit in the width. Starts a new line when there is no space left. |
Buttons
| Control | Description |
|---|---|
| Button | The basic button control - can display text, an icon or both. Has standard 'click' behavior. |
| RepeatButton | A button that raises its click event repeatedly when it is pressed and held. |
| RadioButton | A button that has a selected state. It can be placed in a group so that selection of one button deselects all the others in the group. |
| ToggleButton | A button that has a selected state and a unselected state. Subsequent clicks 'toggle' this state. A 'checked' pseudo class allows different styles to be allocated to the selected and unselected states. |
| ButtonSpinner | A control with two spin buttons and a content zone. |
| SplitButton | This functions as a button with primary and secondary parts that can be pressed independently. The primary part behaves like standard button, and the secondary part opens a flyout with additional actions. |
| ToggleSplitButton | This functions as a button with primary and secondary parts that can be pressed independently. The primary part behaves like toggle button, and the secondary part opens a flyout with additional actions. |
Repeating Data Controls
These controls display repeating data, in either a tabular or list format:
| Control | Description |
|---|---|
| DataGrid | Displays data in a customizable grid. |
| ItemsControl | Displays a collection of items from a bound data source. |
| ItemsRepeater | Displays repeating data from a bound data source. It has both a layout template and a data template. |
| ListBox | A control with items that can be selected. |
| ComboBox | A control with a drop-down list with items that can be selected. |
Text display and editing
| Control | Description |
|---|---|
| AutoCompleteBox | A control that shows a text box for user input and a drop-down that contains possible matches based on what has been typed. |
| TextBlock | A control that displays a block of text. Read-only. |
| TextBox | Used to display or edit text without formatting restrictions. |
| SelectableTextBlock | Used to display or edit text without formatting restrictions. Allows selecting and copying. |
| MaskedTextBox | Used to display text in the format contained in a mask; or used to edit text using the format mask to prevent invalid user input. |
Value selection
| Control | Type | Description |
|---|---|---|
| CheckBox | Boolean | True value presented as a check mark. Click interaction toggles the value. Has an option to display an 'unknown' value. |
| Slider | Double | Relative value compared to a maximum and minimum value presented as the position along the length of the slider track of the slider button. Drag interaction on the slider button can alter the value between the maximum and minimum values. Keyboard and click interactions can also nudge the value. |
| Calendar | DateTime | The calendar is a control for users to select dates or date ranges. |
| CalendarDatePicker | DateTime | An extension of the calendar control that includes a text box and button. |
| ColorPicker | Color / HsvColor | The color picker supports user-selection and editing of colors using a spectrum, palette and component sliders. It also supports an optional alpha component, RGB or HSV color models and hexadecimal color values. |
| DatePicker | DateTime | The date picker has three 'spinner' controls to allow the user to pick a date value. |
| TimePicker | TimeSpan | The time picker has three 'spinner' controls to allow the user to pick a time from hours, minutes and seconds. |
Displaying images
| Control | Description |
|---|---|
| Image | Displays a bitmap or vector image. |
| PathIcon | Draws a vector image using the current Foreground. |
Menus and Popups
| Control | Description |
|---|---|
| Menu | Displays an application menu. |
| Flyouts | Attaches a popup or a context menu to a control. |
| ToolTip | Displays a tool tip when a control is hovered. |