NE.Standard

Language switcher

A button that switches the page to another language in place, and tells the session.

LanguageSwitcherComponent · type key standard.language-switcher · Actions · property blocks: ISurfaceComponent, IBorderedComponent, ITooltipComponent, ISwitcherComponent

It tells the session, so the next page renders in the language too. The choices are the translator's languages, each named in itself and never translated; with one language there is nothing to switch and the button is not drawn. A switch rewrites the page's words where they stand; numbers and dates keep their culture until the next render.

new LanguageSwitcherComponent("language-switcher")

Properties

PropertyTypeDefaultBindingDescription
Icon
SetIcon · BindIcon
stringnullone-wayThe glyph drawn before the language; none by default.
Display
SetDisplay
UILanguageDisplay?UILanguageDisplay.Code—What the button shows for the page's language: its code or its name. The field always shows the name.
Languages
SetLanguages
IReadOnlyList<string>null—The languages offered and their order; by default every language the translator lists, in its order. A language the translator does not list is left out.
Background
SetBackground · BindBackground
UIThemeColor?nullone-wayThe surface's background colour; unset leaves whatever the theme paints underneath.
Padding
SetPadding · BindPadding
UIResponsive<UIThickness>?nullone-wayThe inner spacing between this component's edges and its content, optionally overridden per breakpoint.
BackgroundImage
SetBackgroundImage · BindBackgroundImage
stringnullone-wayThe picture painted over the background colour, centred and never repeated: a URL or a data URI.
BackgroundImageFit
SetBackgroundImageFit · BindBackgroundImageFit
UIImageFit?UIImageFit.Coverone-wayHow the picture fills the surface.
BackgroundImageDim
SetBackgroundImageDim · BindBackgroundImageDim
double?nullone-wayHow far the picture is dimmed, from 0 (not at all) to 1 (gone): the ground the content reads on, laid over it — darker in a dark theme, lighter in a light one. Drawn by the browser; unset, the picture is not dimmed.
BackgroundImageDimMode
SetBackgroundImageDimMode · BindBackgroundImageDimMode
UIBackgroundDimMode?UIBackgroundDimMode.Uniformone-wayHow ISurfaceComponent.BackgroundImageDim is spread over the picture: evenly, or at the edges alone.
BackgroundImageBlur
SetBackgroundImageBlur · BindBackgroundImageBlur
double?nullone-wayThe blur of the picture, in the platform's device-independent units, zero or more; the content over it stays sharp. Drawn by the browser; unset, the picture is not blurred.
BorderColor
SetBorderColor · BindBorderColor
UIThemeColor?nullone-wayThe border's colour, written as CSS border-color; unset leaves the stylesheet's own.
BorderThickness
SetBorderThickness · BindBorderThickness
UIResponsive<UIThickness>?nullone-wayThe border's thickness, optionally overridden per breakpoint; unset leaves the stylesheet's own.
A frame on a wide screen may run edge to edge on a phone: SetBorderThickness(UIThickness.Uniform(0), md: UIThickness.Uniform(1)).
BorderRadius
SetBorderRadius · BindBorderRadius
UIResponsive<UICornerRadius>?nullone-wayThe corner rounding, optionally overridden per breakpoint; unset leaves the stylesheet's own.
TooltipPlain
SetTooltipPlain
bool?false—Whether the tooltip is shown as written, its asterisks, brackets and braces as characters, rather than read as inline markup: words the controller holds bound to it — a person's name, a note's status; unset, it is markup.
Render-time only: the first paint and every value pushed later are shown the same way.
Tooltip
SetTooltip · BindTooltip
UIPhrasenullone-wayThe tooltip shown on hover and focus; on an icon button with no title, it also names the control for screen readers. translatable
TooltipPlacement
SetTooltipPlacement · BindTooltipPlacement
UIPopupPlacement?UIPopupPlacement.Topone-wayThe side the tooltip prefers; flips to the opposite side when there is no room for it there.
Variant
SetVariant
UISwitcherVariant?UISwitcherVariant.Button—Whether it is a button for a page's head or a field for a settings form; decided once at render.
The field draws its edge on its box, as a select does; ISwitcherComponent.ButtonVariant, Padding, Background and BackgroundImage* are the button's alone.
ButtonVariant
SetButtonVariant · BindButtonVariant
UIButtonVariant?UIButtonVariant.Ghostone-wayThe button's look; a quiet ghost by default, as a page header's switch is. Not ISwitcherComponent.Variant, which picks button or field.
Size
SetSize · BindSize
UIResponsive<UISize>?Mediumone-wayThe button size — the box the glyph and the words sit in.
IconSize
SetIconSize · BindIconSize
UISize?nullone-wayThe size the glyphs are drawn at.
Title
SetTitle
UIPhrasenull—The field's caption; unset, the framework's word for the setting ("Theme", "Language"). The button has none. Decided at render, as a key or the author's text: a bound caption pushed empty would leave the field unnamed. translatable
FieldVariant
SetFieldVariant · BindFieldVariant
UIInputAppearance?UIInputAppearance.Filledone-wayThe field's skin, drawn as an input's appearance is: UIInputAppearance.Filled unless set. The button has its ISwitcherComponent.ButtonVariant instead.

Methods

AsField()
Draws the switcher as a settings form's field: its title ("Language" unless set) over a select-shaped box showing the page's language by its name, a press opening the list whatever the number of languages; it stands in its cell as an input does, not centred as the button, so an alignment goes after it.
ConfigureTemplate(TTemplate? current, Action<TTemplate> configure, string what)
Configures current when it is a TTemplate, throwing when a different one was set.
Common properties (23) — layout, visibility, theme, and the rest every component shares
PropertyTypeDefaultBindingDescription
Visibility
SetVisibility · BindVisibility
UIResponsive<UIVisibility>?Visibleone-wayWhat the component does with the room it was given, optionally overridden per breakpoint (e.g. collapsed from a given width up).
Hidden at every width — by a static value or a controller binding — the server refuses a command or a value the component or anything inside it sends. That is a guard against a stale or forged page, not the permission itself: an interaction that hides it (HiddenWhen) lives on the client alone, so who may act belongs in the command or the setter.
Enabled
SetEnabled · BindEnabled
bool?trueone-wayWhether the component responds to input; false dims it and marks it, and its subtree, inert.
False by a static value or a controller binding, the server refuses a command or a value the component or anything inside it sends. That is a guard against a stale or forged page, not the permission itself: an interaction that disables it (EnabledWhen) lives on the client alone, so who may act belongs in the command or the setter.
Theme
SetTheme · BindTheme
UIThemeMode?nullone-wayThe theme mode forced on this component's subtree, or null to inherit the ambient theme.
HorizontalAlignment
SetHorizontalAlignment · BindHorizontalAlignment
UIResponsive<UIAlignment>?Centerone-wayWhere the component sits within its grid cell along the horizontal axis, optionally overridden per breakpoint.
VerticalAlignment
SetVerticalAlignment · BindVerticalAlignment
UIResponsive<UIAlignment>?Centerone-wayWhere the component sits within its grid cell along the vertical axis, optionally overridden per breakpoint.
Width
SetWidth · BindWidth
UIResponsive<UILayoutLength>?nullone-wayThe component width, optionally overridden per breakpoint.
MinWidth
SetMinWidth · BindMinWidth
UIResponsive<UILayoutLength>?nullone-wayThe component minimum width, optionally overridden per breakpoint.
MaxWidth
SetMaxWidth · BindMaxWidth
UIResponsive<UILayoutLength>?nullone-wayThe component maximum width, optionally overridden per breakpoint.
Height
SetHeight · BindHeight
UIResponsive<UILayoutLength>?nullone-wayThe component height, optionally overridden per breakpoint.
MinHeight
SetMinHeight · BindMinHeight
UIResponsive<UILayoutLength>?nullone-wayThe component minimum height, optionally overridden per breakpoint.
MaxHeight
SetMaxHeight · BindMaxHeight
UIResponsive<UILayoutLength>?nullone-wayThe component maximum height, optionally overridden per breakpoint.
ZIndex
SetZIndex · BindZIndex
int?0one-wayThe stacking order within the visual tree.
Margin
SetMargin · BindMargin
UIResponsive<UIThickness>?nullone-wayThe outer spacing around the component, optionally overridden per breakpoint.
Placement
SetPlacement · BindPlacement
UIResponsive<UIGridPlacement>?nullone-wayThe grid placement, optionally overridden per breakpoint.
AlignWithFieldBoxes
SetAlignWithFieldBoxes
UIResponsive<UIFieldBoxAlignment>?null—Whether the component stands level with the boxes of captioned fields beside it — a caption line down, centred on the box — and on which boxes, per breakpoint. Unset, the compiler decides it wherever the component stands side by side with a thing that draws a caption row (UIFieldBoxes); UIFieldBoxAlignment.None keeps it where it is laid out.
Render-time only. A panel draws it as its top padding and its least height, anything else as its top margin, set down onto the band's middle; an authored Padding, MinHeight or Margin replaces them.
Loading
SetLoading · BindLoading
bool?falseone-wayWhether the component is in loading state — a live state a controller turns on and off.
While it holds, by a static value or a controller binding, the server refuses a command or a value the component or anything inside it sends — as the page does.
LoadingStyle
SetLoadingStyle · BindLoadingStyle
UILoadingStyle?nullone-wayThe visual indicator shown while this component or spinner is loading, or null to inherit the ambient or theme loading style.
ShowContextMenu
SetShowContextMenu · BindShowContextMenu
bool?trueone-wayWhether a right-click opens the IVisualComponent.ContextMenu; on a host with rows, whether it opens any row's. Off, the menu stays in the tree and nothing opens it.
ActionBar
SetActionBar
UIActionBarAlignment?null—How the component's action bar lines up with it, or null for none: the IVisualComponent.ContextMenu's entries marked for the bar (a menu item's InActionBar) as icons, and "more" opening the menu itself, floating above the component once the reader chooses it — a press, a tap, the keyboard's cursor — until a press elsewhere, Escape, or another chosen.
A quick view of the menu, not a second list: a press on an icon is that entry's press. Render-time only; a component with an action bar and no context menu is refused when the view compiles.
ActionBarRepeatInMore
SetActionBarRepeatInMore
bool?true—Whether the menu the IVisualComponent.ActionBar's "more" opens repeats the entries the bar shows (the default), or holds the rest alone — no caption or rule left with nothing to stand over or between. A right-click and a long press open the whole menu either way, and a bar whose menu holds nothing more draws no "more".
Render-time only.
ScrollGroup
SetScrollGroup · BindScrollGroup
stringnullone-wayThe scroll group this component belongs to: every component sharing the name scrolls together.
Driven by whichever one the reader scrolls. Components that mark their shown source lines (e.g. a code field and a Markdown display) sync line-for-line; otherwise by scroll fraction.
TextSelectable
SetTextSelectable · BindTextSelectable
bool?nullone-wayWhether the reader can select the words in this component and everything inside it: true lets them (a table whose cells are copied, a chat bubble), false keeps them out; unset, the place decides — a Text's and a Paragraph's words and a validation message select, unless they stand in a row, a menu or another control, and nothing else does. The nearest component that says wins.
A control's own words (a button's label, a tab, a menu entry, a field's caption), a surface the pointer drags (a row that drags by itself, a canvas, a grip) and, on a touch screen, anything a long press opens a menu on never select; a field's value always does.
WindowFoot
SetWindowFoot
bool?null—Whether this component is the window's foot (a chat's composer, a pane's last row): where it stands at the window's bottom edge the phone's system bar takes its background colour, dimmed by any open modal drawer or dialog veil, and its content sits above the bar. The page's bottom bar is one by itself.
Render-time only.