NE.Standard

Enums and value types

Every enum and every value type a component property or an item model carries, with what each member means. A property page links here from its type.

Value types

A length, a colour, a text appearance: built from a static member, or written as its parts.

ColorVariant

From NE.Colors, a package of its own: the names are listed here, and what they mean is in the colour vocabulary and in its own repository.

MemberMeaning
FromRgb(byte red, byte green, byte blue, ColorAdjustment adjustment = ColorAdjustment.None, int factor = 0, byte opacity = 255)
FromColor(Color color, ColorAdjustment adjustment = ColorAdjustment.None, int factor = 0)
TryParseHex(string? text, ColorVariant variant)
Nearest(Color color)
Nearest(byte red, byte green, byte blue, byte opacity = 255)
MinFactor
MaxFactor
ColorName Name
ColorAdjustment Adjustment
int Factor
byte Opacity
int? Rgb

UIActionArgument

Represents a value, binding, or contextual value passed to a UI action.

MemberMeaning
Literal(object? value)Creates a literal action argument from a value.
Literals(params KeyValuePair<string, object>[] arguments)Creates literal action arguments from named values, keeping their names and order.
CurrentItem()Creates an action argument resolved from the current item.
CurrentItemKey()Creates an action argument resolved from the current item key.
GroupKey()Creates an action argument resolved from the current item's group.
EventKey(int index)Creates an action argument resolved from the key at index of the event's own key chain.
EventValue()Creates an action argument resolved from what the event carries after the keys that address its component.
EventValue(int index)Creates an action argument resolved from the value at index of what the event carries after the keys that address its component.
Bind(UIBindingPath binding)Creates an action argument resolved from a binding path.
UIActionArgumentKind KindHow this argument is resolved.
object ValueThe literal value for literal arguments, the place in the event's key chain for an event key, or the tuple index for an event value.
UIBindingPath? BindingThe binding path for binding arguments.
bool OfferedWhether the framework offers the argument beside the author's own (a drop, an edited row's key): a command with no parameter for it leaves it untaken, and the compile does not warn of it.

UIBindingPath

Represents a recursive binding path and the context used to resolve it.

MemberMeaning
Relative(RecursivePath path)Creates a binding path resolved relative to the current binding context.
Parent(RecursivePath path)Creates a binding path resolved in the scope around the component's own (UIBindingScope.Parent).
Root(RecursivePath path)Creates a binding path resolved relative to the root binding context.
RecursivePath PathThe recursive binding path.
UIBindingScope ScopeThe context used to resolve the path.

UIComponentReference

Identifies an authoring component reference before compilation/runtime resolution.

MemberMeaning
ValidateDynamicParameters(object[] dynamicParameters)Validates that all dynamic parameters are supported reference parameter values.
string IdThe authoring component id.
object[] DynamicParametersDynamic reference parameters used for templated or repeated component instances.
bool HasDynamicParametersWhether this reference contains dynamic parameters.

UICornerRadius

Corner radius values, in pixels, for a rectangular UI element's four corners.

MemberMeaning
All(double topLeft, double topRight, double bottomRight, double bottomLeft)Creates a corner radius with an independent value for each corner.
Uniform(double radius)Creates a corner radius applying the same value to all four corners.
Top(double radius)Creates a corner radius rounding only the top corners, leaving the bottom corners square.
Bottom(double radius)Creates a corner radius rounding only the bottom corners, leaving the top corners square.
double TopLeft
double TopRight
double BottomRight
double BottomLeft

UIGridPlacement

A component's placement in the fixed-column grid: 1-based column/row, and how many columns/rows it spans.

MemberMeaning
At(int column, int row, int columnSpan = 1, int rowSpan = 1)Creates a placement at the given column and row with the given spans.
GridColumnsGets the number of columns in the standard UI grid.
int Column
int Row
int ColumnSpan
int RowSpan

UIGridUnit

A grid track's size, with the floor and ceiling a splitter may move it between.

A fixed track's bounds only limit dragging; a star or content track's bounds also constrain what the platform's layout resolves it to.

MemberMeaning
Star(double value = 1, double? min = null, double? max = null)Creates a proportional (star-sized) grid track, optionally bounded by a minimum and/or maximum in pixels.
Absolute(double value, double? min = null, double? max = null)Creates a fixed-size grid track, optionally bounded for a splitter by a minimum and/or maximum in pixels.
Auto(double? min = null, double? max = null)Creates a content-sized grid track, optionally bounded by a minimum and/or maximum.
UIGridUnitType UnitHow the track is sized: fixed length, a share of free space, or its content.
double ValueThe size, in the unit's own terms.
double? MinValueThe floor a splitter may drag the track to.
double? MaxValueThe ceiling a splitter may drag the track to.
bool HasBoundsWhether the track carries a floor or a ceiling.

UILayoutLength

Represents a layout length value.

MemberMeaning
Auto()Creates a layout length that sizes automatically to its content.
Absolute(double value)Creates a layout length with a fixed absolute value.
Fill()The whole of what the parent gives, less the component's own margin on that axis: a list with SetMargin(8) and a Fill height fits its parent with 8 px clear at either end rather than overflowing it by the margin.
UILayoutLengthKind KindWhether the length is absolute, the whole of what the parent gives, or the content's own.
double ValueThe length in pixels for UILayoutLengthKind.Absolute; -1 for the kinds that carry none.

UIPanePlace

A pane of a pane container and the grid cells of the place it was added at, which it holds until the viewer moves it.

MemberMeaning
string NameThe pane's name, as the container's layout lists it.
UIResponsive<UIGridPlacement> PlacementThe place's cells, per breakpoint.
bool KeepsSizeWhether the pane keeps its own size wherever it lands: a place it trades with, standing beside its own and lined up with it, gives it the tracks it was added at (UIPaneLayout.Arrange); elsewhere it takes the place's size, as every pane does.

UIProperty

Represents a UI component property key.

MemberMeaning
string NameThe property name.

UIPropertyReference

Identifies a component property by authoring component reference and property key.

MemberMeaning
UIComponentReference ComponentThe authoring component reference.
UIProperty PropertyThe component property key.

UISelectionStyle

What a chosen item looks like: ground, ink, and an edge mark; unset parts keep the control's default.

Reaches the stylesheet as six custom properties (--ui-selected-*), shared by custom and built-in looks alike.

MemberMeaning
Ground(UIThemeColor background)A chosen item that says so only by its ground.
Marked(UISelectionMark mark, UIThemeColor? markColor = null)A chosen item that says so by a line on one edge, in the given colour or the theme's primary.
UIThemeColor? BackgroundThe ground a chosen item is drawn on.
UIThemeColor? ForegroundThe ink a chosen item's text takes.
UISelectionMark? MarkThe edge a chosen item is marked on.
UIThemeColor? MarkColorThe mark's own colour.
bool? BoldWhether a chosen item's text is drawn bold.
UIThemeColor? ActionBarBackgroundThe ground of the item its action bar stands over, which says whose the bar is; unset the pointer's wash, UIThemeColor.Transparent none — for a row its own card covers.

UITemporalStep

Represents a step value for temporal input components.

MemberMeaning
Days(int value)Creates a step measured in days.
Hours(int value)Creates a step measured in hours.
Minutes(int value)Creates a step measured in minutes.
Seconds(int value)Creates a step measured in seconds.
UITemporalStepUnit UnitThe unit one step counts in.
int ValueHow many units one step moves.

UITextAppearance

Represents a text's typography: either a semantic UITextType role, or an explicit UITextAppearance.Size override.

UITextAppearance.Weight, UITextAppearance.LineHeight and UITextAppearance.LetterSpacing are read only alongside an explicit UITextAppearance.Size.

MemberMeaning
FromRole(UITextType role)Creates a text appearance tracking the given semantic UITextType role live.
Custom(double size, int? weight = null, double? lineHeight = null, double? letterSpacing = null)Creates a text appearance from an explicit font size, optionally overriding weight, line-height, and letter-spacing.
DisplayThe largest, most prominent typographic role, for hero-style text, tracked live via UITextAppearance.FromRole.
TitleThe typographic role for primary headings, tracked live via UITextAppearance.FromRole.
SubtitleThe typographic role for secondary headings, tracked live via UITextAppearance.FromRole.
BodyThe typographic role for regular body text, tracked live via UITextAppearance.FromRole.
CaptionThe typographic role for small, supplementary text, tracked live via UITextAppearance.FromRole.
OverlineThe typographic role for small label text placed above content, tracked live via UITextAppearance.FromRole.
UITextType? RoleThe semantic role sizing the text; used only while Size is unset.
double? SizeAn explicit size, in pixels, which wins over the role.
int? WeightAn explicit font weight.
double? LineHeightAn explicit line height, in pixels.
double? LetterSpacingAn explicit letter spacing, in pixels.

UIThemeColor

Represents a themed color: either a semantic UIColorStyle role, or an explicit UIThemeColor.Light/UIThemeColor.Dark override, which wins when set.

MemberMeaning
FromStyle(UIColorStyle style)Creates a theme color tracking the given semantic UIColorStyle role live.
FromColorVariant(ColorName name, ColorAdjustment adjustment = ColorAdjustment.None, int factor = 0, byte opacity = 255)Creates a theme color from a fixed color variant, used identically in both light and dark mode.
FromColorVariant(ColorVariant color)Creates a theme color from a fixed color variant, used identically in both light and dark mode.
Create(ColorVariant? light, ColorVariant? dark)Creates a theme color from explicit light and dark overrides.
TryParse(string? text, UIThemeColor color)Reads the canonical wire form a client sends back: @Role for a semantic role, #RRGGBBAA for an explicit colour, or Name/Adjustment/factor/opacity for a palette variant.
DefaultPresets mirroring each UIColorStyle role, theme-aware via UIThemeColor.FromStyle.
PrimaryThe theme's primary brand color, tracked live via UIThemeColor.FromStyle.
AccentThe theme's secondary accent color, tracked live via UIThemeColor.FromStyle.
BackgroundThe page/surface background color, tracked live via UIThemeColor.FromStyle.
SurfaceA raised surface's background color (e.g. a card), tracked live via UIThemeColor.FromStyle.
OnPrimaryA color intended to sit on top of UIThemeColor.Primary, tracked live via UIThemeColor.FromStyle.
OnAccentA color intended to sit on top of UIThemeColor.Accent, tracked live via UIThemeColor.FromStyle.
OnBackgroundA color intended to sit on top of UIThemeColor.Background, tracked live via UIThemeColor.FromStyle.
OnSurfaceA color intended to sit on top of UIThemeColor.Surface, tracked live via UIThemeColor.FromStyle.
InfoThe informational status color, tracked live via UIThemeColor.FromStyle.
WarningThe warning status color, tracked live via UIThemeColor.FromStyle.
SuccessThe success status color, tracked live via UIThemeColor.FromStyle.
DangerThe danger/error status color, tracked live via UIThemeColor.FromStyle.
OnInfoA color intended to sit on top of UIThemeColor.Info, tracked live via UIThemeColor.FromStyle.
OnWarningA color intended to sit on top of UIThemeColor.Warning, tracked live via UIThemeColor.FromStyle.
OnSuccessA color intended to sit on top of UIThemeColor.Success, tracked live via UIThemeColor.FromStyle.
OnDangerA color intended to sit on top of UIThemeColor.Danger, tracked live via UIThemeColor.FromStyle.
MutedA dimmed variant of the ambient color, for secondary/de-emphasized text, tracked live via UIThemeColor.FromStyle.
SelectedThe chrome token indicating a selected item or state, tracked live via UIThemeColor.FromStyle.
FocusRingThe focus indicator ring color, tracked live via UIThemeColor.FromStyle.
BorderThe default border color, tracked live via UIThemeColor.FromStyle.
MarkThe edge that says a control is there, reading 3:1 on its ground, tracked live via UIThemeColor.FromStyle.
ShadowThe drop shadow color, tracked live via UIThemeColor.FromStyle.
OverlayThe modal/scrim overlay color, tracked live via UIThemeColor.FromStyle.
TransparentNo fill: a colour of no opacity, the same in both themes. A background written it shows what is behind it, and what stands on it takes the page's ink, as on the page's own grounds.
UIColorStyle? StyleThe semantic role the palette resolves the colour from.
ColorVariant? LightAn explicit colour for the light theme.
ColorVariant? DarkAn explicit colour for the dark theme.

UIThickness

Thickness values, in pixels, for a rectangular UI element's four sides.

MemberMeaning
All(double left, double top, double right, double bottom)Creates a thickness with an independent value for each side.
Uniform(double value)Creates a thickness applying the same value to all four sides.
Symmetric(double horizontal, double vertical)Creates a thickness applying one value to the left/right sides and another to the top/bottom sides.
double Left
double Top
double Right
double Bottom

UIValidationMessage

A validation message a controller puts on an input: the severity and the words. Null on the property means none.

The words are translatable as a label is: a text is looked up as a plain value on a translatable property is — under key prefixes only a prefixed one — and a UIPhrase always; the page shows them in its language and again after a switch.

MemberMeaning
Error(string message)A message that refuses the value.
Error(UIPhrase message)A message that refuses the value.
Warning(string message)A message that warns about the value without refusing it.
Warning(UIPhrase message)A message that warns about the value without refusing it.
Info(string message)A message that only tells the viewer something about the value.
Info(UIPhrase message)A message that only tells the viewer something about the value.
UIValidationSeverity SeverityHow the message is drawn and whether it refuses a submit.
UIPhrase MessageThe words shown under the input, or in its marker's tooltip: the author's text (UIPhrase.IsText) or a phrase.

Enums

ColorAdjustment

From NE.Colors, a package of its own: the names are listed here, and what they mean is in the colour vocabulary and in its own repository.

MemberMeaning
None
Shade
Tint

ColorName

From NE.Colors, a package of its own: the names are listed here, and what they mean is in the colour vocabulary and in its own repository.

MemberMeaning
IronFog
SilverNight
BronzeDusk
StellarRed
NebulaRose
LunarPink
PulsarMagenta
SolarAmber
NebulaLemon
LunarYellow
SolarGold
EclipseOlive
NebulaLime
LunarSage
AuroraGreen
NebulaMint
LunarFern
AstralTeal
NebulaCyan
LunarMoss
QuantumBlue
NebulaAqua
LunarAzure
NovaPurple
NebulaViolet
LunarLavender
Comet
Flare
Ember
Photon
Vortex
Halo

UIActionArgumentKind

Defines how an interaction action argument is resolved.

MemberMeaning
LiteralThe argument value is a fixed literal.
CurrentItemThe argument value is the current item of the enclosing items scope.
CurrentItemKeyThe argument value is the key of the current item of the enclosing items scope.
BindingThe argument value is resolved from a binding.
EventKeyThe argument value is one key of the event's own chain, by its place in it — for an event that names its keys itself.
EventValueThe argument value is what the event carries after the keys that address its component — the place a dragged row was dropped at.
GroupKeyThe argument value is the group of the current item — in a group header, the group the header heads.

UIActionBarAlignment

How a component's action bar lines up with it (SetActionBar): the bar floats above the component, under it where there is no room above, aligned with its end, its start or its middle. Start and end follow the page's direction, so a right-to-left page mirrors them.

MemberMeaning
EndAligned with the end edge, where a messenger puts a message's actions.
StartAligned with the start edge.
CenterCentred on the component, as over a node on a canvas.

UIAlignment

Defines cross-axis or main-axis alignment for UI layout.

MemberMeaning
StartAligns content to the start of the axis.
CenterAligns content to the center of the axis.
EndAligns content to the end of the axis.
StretchStretches content to fill the axis.

UIBackgroundDimMode

Defines how a background picture's dim is spread over it.

MemberMeaning
UniformDims the whole picture evenly: the one text reads on anywhere, as a message feed's wallpaper wants.
VignetteDims the edges and leaves the middle clear: a frame for a card or a hero picture, not a ground for reading.

UIBadgeFill

Defines how a badge spends its colour: on its ground, on a light tint of it, or on its edge alone.

MemberMeaning
FilledThe colour as the ground, with the words in the colour that reads on it.
TintedA light tint of the colour as the ground, with the words in the colour's ink.
OutlineNo ground, a thin edge in the colour, and the words in the colour's ink.

UIBadgeVariant

Defines visual variants for badge-like components.

MemberMeaning
PrimaryThe theme's primary brand color variant.
AccentThe theme's secondary accent color variant.
InfoThe informational status color variant.
WarningThe warning status color variant.
SuccessThe success status color variant.
DangerThe danger/error status color variant.
SurfaceA card-like distinct background variant with no color accent.
PlainThe content alone, with no ground, edge or padding, in the muted ink; a reachable one brightens under the pointer and the keyboard.

UIBindingMode

Defines how data flows between a binding source and a UI target.

MemberMeaning
OneWayUpdates flow only from the binding source to the UI target.
TwoWayUpdates flow in both directions between the binding source and the UI target.
OneWayToSourceUpdates flow only from the UI target to the binding source.
OnSubmitTarget-to-source updates are buffered until an explicit submit occurs.

UIBindingScope

Defines the component context used to resolve a binding path.

MemberMeaning
RelativeResolves the binding path relative to the component's own context.
ParentResolves the binding path in the scope around the component's own: up past the nearest component that defines a context (a row's template, a menu's entry), one step out — so a control straight in a row reaches the list's scope, not the row.
RootResolves the binding path relative to the root context.

UIButtonVariant

Defines visual variants for button-like components.

MemberMeaning
PrimaryThe theme's primary brand color variant.
AccentThe theme's secondary accent color variant.
DangerThe danger/error status color variant.
OutlineA bordered variant with a transparent background.
GhostA borderless, transparent-background variant.
LinkA variant styled as an inline text link.
SurfaceA raised surface with no tint of its own (what a destination-list row looks like, and ActionComponent's starting variant); distinct from UIButtonVariant.Ghost, which draws nothing until touched.

UIColorStyle

Defines semantic color roles used by UI components.

MemberMeaning
DefaultNo explicit color override; inherits the ambient color.
PrimaryThe theme's primary brand color.
AccentThe theme's secondary accent color.
BackgroundThe page/surface background color.
SurfaceA raised surface's background color (e.g. a card).
OnPrimaryA color intended to sit on top of UIColorStyle.Primary.
OnAccentA color intended to sit on top of UIColorStyle.Accent.
OnBackgroundA color intended to sit on top of UIColorStyle.Background.
OnSurfaceA color intended to sit on top of UIColorStyle.Surface.
InfoThe informational status color.
WarningThe warning status color.
SuccessThe success status color.
DangerThe danger/error status color.
OnInfoA color intended to sit on top of UIColorStyle.Info.
OnWarningA color intended to sit on top of UIColorStyle.Warning.
OnSuccessA color intended to sit on top of UIColorStyle.Success.
OnDangerA color intended to sit on top of UIColorStyle.Danger.
MutedA dimmed variant of the ambient color, for secondary/de-emphasized text.
SelectedThe color indicating a selected item or state.
FocusRingThe color of the focus indicator ring around focused elements.
BorderThe default border color.
ShadowThe color used for drop shadows.
OverlayThe color used for modal/scrim overlay backgrounds.
MarkThe edge that says a control is there (a field's border, an unchecked box's ring), reading 3:1 on its ground.

UIColorTextFormat

How a colour input writes the colour it holds.

MemberMeaning
Hex#RRGGBB, and #RRGGBBAA once the colour is not fully opaque.
Rgbrgb(r, g, b), and rgba(r, g, b, a) once the colour is not fully opaque.

UIComparisonOperator

Defines comparison operators used by UI validation and interaction rules.

MemberMeaning
RequiredThe value must be present: not null, not false, and not empty or whitespace text.
EqualThe value must equal the comparison value.
NotEqualThe value must not equal the comparison value.
GreaterThe value must be greater than the comparison value.
GreaterOrEqualThe value must be greater than or equal to the comparison value.
LessThe value must be less than the comparison value.
LessOrEqualThe value must be less than or equal to the comparison value.
LikeThe value must contain the comparison value as a substring.
InThe value (or at least one element when the value is a collection) must be contained in the comparison value's collection.
RegexThe value must match the comparison value as a regular expression.
LikeIgnoreCaseThe value must contain the comparison value as a substring, ignoring case.
RegexEachEvery item of a list value must match the comparison value as a regular expression — a multi-select's each key; a value that is no list is one item, and nothing is an empty list.

UIDayOfWeek

Defines days of week using Monday as the first day.

MemberMeaning
MondayMonday.
TuesdayTuesday.
WednesdayWednesday.
ThursdayThursday.
FridayFriday.
SaturdaySaturday.
SundaySunday.

UIDragEffects

What a drag source lets a drop do with its items, combined: move them out of it, copy them, or both.

MemberMeaning
NoneNothing: the items are not dragged out of their host.
MoveThe items leave the source for the target.
CopyThe items stay in the source and a copy goes to the target.
AllEither, the drop deciding: a move between hosts of one kind, a copy into anything else, Ctrl (⌥ on a Mac) turning a move into a copy.

UIDragHandlePlacement

Where the grip a row is dragged by stands along the row (DragHandle).

MemberMeaning
EndAt the row's end: after its content, past a table's last column.
StartAt the row's start: before its content, before a table's first column, and pinned with it where the first column is.

UIExpanderVariant

How an expander is drawn.

MemberMeaning
CardA bordered card: the header a padded band, a rule under it over the content.
QuietA quiet fold: the header a line of muted words with the chevron right after them, no frame, fill, padding or rule, and the content flush under it.

UIFieldBoxAlignment

Which field boxes a panel stands level with, or none.

MemberMeaning
NoneStands where it is laid out.
SmallLevel with small field boxes (UISize.Small).
MediumLevel with medium field boxes (UISize.Medium).
LargeLevel with large field boxes (UISize.Large).

UIFileInputVariant

What a file input is drawn as.

MemberMeaning
RowA single-line field of the chosen file names with a pick button at the end, whose upload handle lands in SelectionId.
TilesA drop area of square tiles — a picture as its thumbnail, any other file as its kind's glyph over its name and size — with a picking square and a placeholder while empty, whose upload handles land in SelectionIds.
ShelfA row of square tiles and nothing else — each with its remove and its upload's progress, the whole of it not on the page while empty — whose chooser is opened from elsewhere (OpenPickerEffect) or fed by a drop target, and whose upload handles land in SelectionIds.

UIGridUnitType

Defines the unit type used by grid layout measurements.

MemberMeaning
StarA proportional share of the remaining available space.
AbsoluteA fixed size expressed in device-independent units.
AutoSized to fit its content, optionally bounded by a minimum and/or maximum.

UIGroupSeparator

Defines what a bar draws between two groups of its items.

MemberMeaning
NoneNothing: the groups run into each other.
GapA step of air wider than the spacing between items.
RuleA hairline across the bar.

UIImageCrop

The frame an image input fits a chosen picture to before it uploads.

MemberMeaning
NoneNo crop: the chosen file uploads as it is.
SquareA square frame: a cover, a logo, a thumbnail.
CircleA round frame for an avatar; the picture sent is still the square under it.

UIImageFit

Defines how an image is fitted into its layout bounds; null leaves it to the platform's default.

MemberMeaning
FillStretches the image to fill its bounds, ignoring aspect ratio.
ContainScales the image to fit entirely within its bounds while preserving aspect ratio.
CoverScales the image to cover its bounds while preserving aspect ratio, cropping if needed.
NoneRenders the image at its natural size, without scaling.

UIImageInputVariant

What an image input is drawn as.

MemberMeaning
PictureA large picture: a drop area with the picture as its preview.
AvatarA small round picture replaced in place — a person, a team, a project.
InlineA row like the file input's: a thumbnail, the picture's name, and the pick control at the end.

UIInputAppearance

Defines how an input draws the surface around its field.

MemberMeaning
FilledThe elevated field ground with a subtle border at rest and a full-perimeter focus contour: the default input appearance.
OutlineNo fill, and a border all the way round.
UnderlineNo fill, and a single rule under the text — what an edit-in-place or dense node field wants.
GhostNo box at rest: looks like plain text, reveals a hover wash on pointer hover, keeps the hover wash while focused, and steps text brightness up when hovered while focused.

UIInputMode

Which on-screen keyboard a text field asks a phone for, apart from what its value is (UITextInputType): digits for a one-time code or a PIN that stays text, its leading zeros kept.

MemberMeaning
TextThe ordinary keyboard of the reader's language.
NumericDigits alone: a one-time code, a PIN, a card or account number.
DecimalDigits and the reader's decimal separator: an amount.
TelA telephone keypad: digits, +, * and #.
EmailA keyboard with @ and . to hand.
UrlA keyboard with / and . to hand.
SearchA keyboard whose Enter key reads as a search.

UIInputTitlePlacement

Where a field's caption stands.

MemberMeaning
TopOn a line of its own above the field.
InsideInside the field's own box at its leading edge, with the value read from the trailing one.

UIItemsHostMode

How an items host holds its rows.

MemberMeaning
PlainEvery row is in the document.
VirtualizedThe client holds every item's value and keeps only the rows in view in the document.
WindowedThe items come from a source on the controller, one window at a time.

UIItemsLayoutType

Defines layout modes for items-based components.

MemberMeaning
StackLays out items sequentially along a single axis.
WrapFlows items left to right, wrapping when space runs out. An item takes its content's width; a template root with a placement takes that column span of the 24-column grid instead.
AccordionA vertical stack of ExpanderComponent rows that share their borders and outer corners and keep at most one row open at a time.

UIItemsLoadingLook

What a windowed items view shows while it reads rows it does not have yet (ItemsViewComponent.LoadingLook).

MemberMeaning
SkeletonGrey bars in the rows' shape stand where the rows will land, shimmering while they are read: a list of rows alike.
IndicatorNo rows stand in: a small ring at the edge the rows come in at, over the rows in view and moving none — a conversation, whose messages differ in height and side, read from its end.

UIItemsSortDirection

Defines the sort direction for an items view.

MemberMeaning
AscendingSorts items from lowest to highest.
DescendingSorts items from highest to lowest.

UILanguageDisplay

What a language switcher's button shows for the language the page is in.

MemberMeaning
CodeThe language's code, upper-cased (EN, ZH-HANS).
NameThe language's own name for itself (English, Русский).

UILayoutLengthKind

Defines the kind of layout length value.

MemberMeaning
AutoThe length is determined automatically based on content.
AbsoluteThe length is a fixed value expressed in device-independent units.
FillThe whole of what the parent gives: a page that fills the viewport, a pane that fills its track. A component's own margin on that axis comes out of it, so a filled box with a margin still fits its parent.

UILiveRegion

Defines what a part of the page that tells the reader something is to a screen reader: how its words are read when they change or when it is shown. Unset, nothing: its words are read where the reader reaches them.

MemberMeaning
StatusA status (role="status"): read when the reader is free, for what went right or is worth knowing.
AlertAn alert (role="alert"): read at once, over what is being read, for what went wrong or needs care now.

UILoadingStyle

The shape a spinner or a loading component draws while work is under way.

MemberMeaning
RingA turning circular ring.
DotsThree dots animated by a periodic vertical wave.

UIMenuDisplay

Defines how a menu lays out its entries: icon and title side by side, or a narrow rail of icons with a short label under each.

MemberMeaning
ListEach entry is a row, its icon beside its title; the menu may fold to its icons alone.
RailA narrow column, each entry its icon over a one-line label, its badge on the icon's corner; it never folds, and its groups fly out beside it as a folded menu's do.

UIMenuItemKind

Defines what one entry of a menu is: a selectable item, a section header, a separator, an option with a check mark, or a setting whose choices open beside it.

MemberMeaning
ItemA selectable entry: icon, title, and either a URL or a command.
HeaderA caption introducing the entries below it. Not selectable.
SeparatorA rule between entries. Carries no content.
CheckAn option that is on or off: a check mark at the entry's end says which. The click is the entry's command; the controller flips Checked.
SelectA setting: its current Value at the entry's end, and its nested entries — the choices — opening beside it on click, whatever the menu's fold.

UIMultiSelectVariant

What a multi-select is drawn as.

MemberMeaning
ChipsA field holding a chip per chosen option, each with its remove, over a list that marks the chosen ones with a check and stays open while options are toggled.
BadgesThe chips' field and list with each option a badge — a ticket's labels, a contact's tags — chosen into the field as the badge itself, its remove inside it.
CheckboxesEvery option standing in the field as a checkbox, with no list and no chips: the value is the checked keys. Takes no free text; past MaxSelected the unchecked boxes are off.
ButtonA compact button trigger that opens the multi-select popup and shows the chosen count in its badge when no badge title is set.

UIOrientation

Defines horizontal or vertical orientation.

MemberMeaning
HorizontalContent flows along the horizontal axis.
VerticalContent flows along the vertical axis.

UIOverflow

Defines whether a container clips content that overflows its bounds.

MemberMeaning
HiddenContent that overflows the container's bounds is clipped.
ShowContent that overflows the container's bounds remains visible.

UIPagerMode

What a pager shows of the pages (PagerComponent.Mode); on a phone it is compact whatever it says.

MemberMeaning
FullFirst, previous, the pages by number — the ends and the ones around the current page, an ellipsis for the rest — next and last.
CompactThe rows the page holds out of the source's count ("21–40 of 812"), between previous and next.

UIPopupPlacement

Defines where a popup prefers to sit relative to its anchor; a side with no room for it flips to its opposite, and with room on neither, to a side across, so the popup never covers its own anchor where one of the four sides has room.

MemberMeaning
BottomStartBelow the anchor, aligned to its start edge.
BottomBelow the anchor, centered on it.
BottomEndBelow the anchor, aligned to its end edge.
TopStartAbove the anchor, aligned to its start edge.
TopAbove the anchor, centered on it.
TopEndAbove the anchor, aligned to its end edge.
LeftStartTo the left of the anchor, aligned to its start edge.
LeftTo the left of the anchor, centered on it.
LeftEndTo the left of the anchor, aligned to its end edge.
RightStartTo the right of the anchor, aligned to its start edge.
RightTo the right of the anchor, centered on it.
RightEndTo the right of the anchor, aligned to its end edge.

UIProgressVariant

Defines progress indicator presentation variants.

MemberMeaning
LinearRenders progress as a horizontal bar.
CircularRenders progress as a circular ring.

UIResponsiveTier

One of the viewport tiers a UIResponsive value names — where each starts above the base is the platform's breakpoint table (640, 768, 1280 and 1536 CSS pixels on the web).

MemberMeaning
BaseThe narrowest viewport, where every responsive value starts; a column hidden below it is never hidden.
Sm
Md
Xl
Xxl

UIScrollAnchor

Defines how a scrollable container reacts when its content grows.

MemberMeaning
NoneThe container keeps its scroll position, which is the platform's own behavior.
EndThe container follows content appended at the end while the viewer is already at the end.

UIScrollMode

Defines scroll behavior for scrollable UI regions.

MemberMeaning
DisabledScrolling is disabled; overflowing content is not reachable by scrolling.
AutoScrolling is enabled only when content overflows the available space.
AlwaysScrolling is always enabled, regardless of whether content overflows.

UIScrollSnapMode

Defines the strictness with which a scrollable region snaps to item boundaries.

MemberMeaning
DisabledScroll snapping is disabled.
ProximityThe scroll position snaps to the nearest boundary only when it comes to rest near one.
MandatoryThe scroll position always snaps to a boundary at the end of scrolling.

UISelectionMark

Defines the edge a chosen item draws its mark on — the line a tab has under it, a sidebar entry has beside it — or that it draws none.

MemberMeaning
NoneNo mark: the ground and the ink say it.
LeftA line down the left edge.
RightA line down the right edge.
TopA line along the top edge.
BottomA line along the bottom edge.

UISelectionMode

Defines how many of a list's items the viewer can have chosen at once.

MemberMeaning
NoneNone: the rows are not chosen by clicking them.
OneOne at a time — choosing a row lets the previous one go.
ManyAny number — a click toggles the row it lands on.

UIShape

The shape a picture is drawn in — an image standing alone, or an icon that is a picture; a glyph keeps its own whatever the shape.

MemberMeaning
DefaultThe picture's own: an image in the box the layout gives it, its corners as BorderRadius says; an icon's picture as it is, its corners slightly rounded.
CircleA circle the picture fills, a picture of another proportion cropped to its middle (an image's Fit may say otherwise) — a person, a team.

UISide

Defines the edge of its parent a component is attached to — the side a panel folds toward when it collapses.

MemberMeaning
LeftThe left edge.
RightThe right edge.
TopThe top edge.
BottomThe bottom edge.

UISize

How much room a control or a glyph takes, independent of what it holds: one scale for a button, a field, an icon and an indicator.

MemberMeaning
SmallSized to sit inside a row, a toolbar, a list or a dense surface (a node on a canvas, a cell) without setting its height.
MediumThe ordinary size — a button or a field standing on its own.
LargeA call to action, where the control is the point of what it sits in.

UISplitButtonMode

Which part of a split button opens its menu.

MemberMeaning
SplitThe main part runs the button's own command; the end part opens the menu.
MenuThe whole button opens the menu — a menu button; the button's own click command is not used.

UISurfaceStyle

What a bordered surface is made of.

MemberMeaning
BackgroundThe page's own background inside a border — a surface that reads as part of the page.
SurfaceA surface with its own fill (--ui-color-surface), standing off the page.
TintedThe surface's own colour mixed into the mode's ground instead of painted over it; takes the colour from Background, falling back to the theme's primary when none is set.

UISwitcherVariant

How a page switcher (the theme's, the language's) is drawn: a button for a page's head, or a field for a settings form.

MemberMeaning
ButtonA button: a press switches, or opens the list where there are more than two choices.
FieldA select-shaped field: its title over a box in the input family's appearance showing the current choice, a press opening the list.

UITabMenuEntries

The built-in entries a tabs view's tab menu offers, combined; UITabMenuEntries.Close and UITabMenuEntries.Delete are the two forms of its one remove entry and are never chosen together.

MemberMeaning
NoneNo built-in entry: the menu holds only the application's own.
RenameOpens the caption's rename field.
PinPin or Unpin, by the tab's pinned state.
CloseThe remove entry as a neutral Close: what the tab's own cross does.
DeleteThe remove entry as a destructive Delete, drawn in the danger colour: what the tab's own cross does.

UITagEntry

What Enter takes in a multi-select that takes free text, while the reader types and its suggestions stand open.

MemberMeaning
TypedTextThe text as typed; the arrows pick a suggestion, which Enter then takes.
FirstSuggestionThe first suggestion the text names, marked as the reader types; the typed text only where none matches. Escape takes the mark off first, so Enter takes the text after it.

UITemporalStepUnit

Defines time units used by temporal input step values.

MemberMeaning
DayThe step value is expressed in days.
HourThe step value is expressed in hours.
MinuteThe step value is expressed in minutes.
SecondThe step value is expressed in seconds.

UITextAlignment

Defines text alignment within its layout bounds.

MemberMeaning
StartAligns text to the leading edge of its container.
CenterCenters text within its container.
EndAligns text to the trailing edge of its container.
JustifyStretches text so each line fills the width of its container.

UITextAreaResizeMode

Defines resize behavior for multiline text input components.

MemberMeaning
NoneThe text area cannot be resized by the user.
VerticalThe text area can be resized vertically only.
HorizontalThe text area can be resized horizontally only.
BothThe text area can be resized both horizontally and vertically.

UITextBadgeAlignment

Defines where a trailing badge sits against the text beside it.

MemberMeaning
TitleOn the title's own line, at its far end — the badge marks the title.
ContentCentred against title and description together — the badge stands for the whole block.

UITextBadgePlacement

Defines where a badge in text content is placed.

MemberMeaning
InlineThe badge is placed inline within the text content.
TrailingThe badge is placed after the text content.

UITextIconAlignment

Where a text body's leading icon sits against the text beside it.

MemberMeaning
TitleOn the title's own line, with the description flowing underneath it — the icon marks the title.
ContentCentred against title and description together — the icon stands for the whole block, as in a list row or a card header.

UITextInputType

Defines semantic input types for text input components.

MemberMeaning
TextPlain, unformatted text input.
EmailInput intended for an email address, with matching keyboard/validation hints.
PasswordInput intended for a password, masking the entered characters.
SearchInput intended for a search query.
TelInput intended for a telephone number, with matching keyboard hints.
UrlInput intended for a URL, with matching keyboard/validation hints.

UITextType

Defines semantic text roles used by text components.

MemberMeaning
DisplayThe largest, most prominent typographic role, for hero-style text.
TitleThe typographic role for primary headings.
SubtitleThe typographic role for secondary headings.
BodyThe typographic role for regular body text.
CaptionThe typographic role for small, supplementary text.
OverlineThe typographic role for small label text placed above content.

UITextWrapMode

Defines text wrapping behavior. A wrapping paragraph is clamped by MaxLines, with an ellipsis on the last line it keeps.

MemberMeaning
NoWrapText is kept on a single line, ending in an ellipsis where its container is too narrow.
WrapText wraps onto multiple lines as needed to fit its container.

UIThemeMode

The two themes a surface can be forced into. null means "inherit" on a component and "follow the platform" on a session.

MemberMeaning
LightAlways uses the light theme.
DarkAlways uses the dark theme.

UITimestampFormat

How a timestamp shows its moment, in the reader's own time zone and language.

MemberMeaning
DateTimeThe day and the time of day: "2026-09-30 14:05".
DateThe day alone: "2026-09-30".
TimeThe time of day alone: "14:05".
RelativeHow long ago or how far ahead, kept current as time passes: "5 minutes ago", "yesterday", "in 2 hours".
RelativeDateThe day as a messenger heads it, kept current as days pass: "Today", "Yesterday" and "Tomorrow" in the reader's language, else the day as UITimestampFormat.Date writes it.

UIValidationPresentation

Where a field's validation message goes: a line under the field, or a mark at its edge that speaks in a tooltip.

MemberMeaning
AutoA line under the field, except where the field sits in a table's cell, where it is a mark; an open key-value row keeps the line.
MessageA line under the field, wherever the field is.
MarkerA mark at the field's edge, the message in its tooltip; the field keeps its height.

UIValidationSeverity

What a validation message means: an error stops a submit, a warning and an info only say something.

MemberMeaning
ErrorBlocks a submit and draws both the required marker and the field's edge.
WarningColours the field's edge but never blocks a submit.
InfoSpeaks only under the field, without touching its edge or blocking a submit.

UIValidationTrigger

Defines when a UI validation rule is evaluated.

MemberMeaning
ChangeThe rule is evaluated whenever the value changes.
BlurThe rule is evaluated when the input loses focus.
SubmitThe rule is evaluated when the form is submitted.

UIVisibility

Defines what a component does with the room it was given: fills it, keeps it empty, or gives it back.

MemberMeaning
VisibleDrawn, and taking part in everything: layout, hit-testing, focus and assistive technology.
HiddenNot drawn, but still holding its place — the layout around it does not move.
CollapsedGone from the layout as well: everything after it closes the gap.