EmptyState

Remarks

⚠ Worth a control because the alternative is a blank rectangle, which every user reads as a bug in the application rather than as an absence of data. The three parts below are what makes it not one: a headline saying what is missing, a sentence saying why, and somewhere to put the button that fixes it.

⚠ No picture, deliberately, and it used to have one. An Illustration icon part existed, with a theme rule sizing it, and nothing in the tree ever asked for it: every empty state here — six in the editor — set a headline and a sentence and stopped, and the property was getter-only, so markup could not reach it either. The rule was unjudged in both scoped censuses for exactly that reason (#1369). A picture that nothing draws is not the thing that stops an empty list reading as a bug; the sentence is. An application that wants one adds an Icon to the control and styles it, and the day a caller here wants one is the day to design the part with it.

Fields and properties (9)

• protected override string TagName

  The element name this type answers to when a caller does not choose one.

• protected override bool AcceptsFocus

  Whether the focus can rest on this kind of control at all.

• public string? Title

  The headline.

• public string? Description

  The sentence under it.

• public UiElement TitlePart

  The headline's element.

• public UiElement DescriptionPart

  The description's element.

• public UiElement Actions

  Where the button that resolves it goes.

• protected override AccessibleRole NativeRole
• protected override string? NativeAccessibleName

  What this kind of element calls itself, from what it already holds.

Methods (1)

• protected override void OnCreated()

  Builds whatever this element is made of, once, as it joins a document.

Used by (8)

• AccessibilityTreeTestsVixen.Ui.Controls.Tests
• AddressableGroupsViewVixen.Editor.AssetEditors
• InspectorViewVixen.Editor.Inspector
• ModelImportViewVixen.Editor.AssetEditors
• NetworkViewVixen.Editor.Debugger
• NetworkViewTestsVixen.Editor.Debugger.Tests
• SettingsViewVixen.Editor.Ui
• TargetOverrideMatrixVixen.Editor.AssetEditors