Skip to main content

Toggle

Family: Inputs & Forms
Namespace: Tessera.Controls

Use Toggle when this interaction is the best match for your screen workflow.

When to use​

  • You need a Toggle-style interaction inside the inputs & forms lane.
  • A titled widget surface improves scanability in dense shells.
  • The control is mainly presentational or state-driven through property updates.

Minimal usage​

csharp.cs
using Tessera.Controls;
using Tessera.Layout;

var widget = new Toggle
{
    Title = "Toggle"
};

return Screen.Build(window => window.Body(body => body.Center(widget, width: 44, height: 9)));

Common pitfalls​

  • Do not choose Toggle by name only; validate it against the target workflow.
  • Keep this control scoped to the inputs & forms concern; avoid cross-layer state coupling.
  • Set focused/normal styles intentionally so keyboard focus remains obvious.
  • Keep disabled state explicit and reversible so users understand why actions are blocked.

Public properties​

PropertyType
BorderBorderStyle
BorderStyleTextTesseraStyle
DisabledValueStyleTesseraStyle
FocusedBorderStyleTextTesseraStyle
FocusedTitleStyleTesseraStyle
FocusMarkerstring
IsDisabledbool
IsFocusedbool
IsReadOnlybool
OffTextstring
OffValueStyleTesseraStyle
OnTextstring
OnValueStyleTesseraStyle
PaddingThickness
ShowFocusMarkerbool
Titlestring
TitleStyleTesseraStyle
Valuebool
ValueStyleTesseraStyle

Public events​

This control currently exposes no public events.