OptionaliconA glyph drawn before the label in the strip, marking where the pane came from.
An SVG string, injected with innerHTML and not sanitised — it must be
trusted, exactly like PivotDefinition.icon. Useful when several tabs are
the same kind of pane: four candidate reviews and a data table read as one list
of five otherwise.
Stable identity: what removeDockTab / activateDockTab take, and the
data-tab written onto the strip's button.
The strip's label, used verbatim (so it can be translated).
OptionalonCalled when this tab comes to the front, and when it leaves. A tab that watches
live data should stop working in onDeactivate and catch up in onActivate:
nothing else tells it that it is off screen.
OptionalonOptionalorderDisplay order in the strip, ascending. Equal orders keep registration order — and since plugins install after the UI is built, a plugin's tabs land after the built-in ones without having to say so.
Build the pane's body. Called once, lazily, the first time the tab comes to the front — a tab nobody opens costs nothing. The element is kept and re-attached on later activations, so it holds its own state (scroll position included).
OptionaltoolbarBuild this tab's header controls, laid out as part of the dock's header row. Re-invoked on every activation, so the controls can reflect the tab's current state.
A pane with several views of its own draws the switch here. Two public classes
give it the same look the built-in table has — pvt-dock-views on the strip,
pvt-dock-view on each button, active on the current one — so it stays a pill
group beside the dock's own tabs and follows the theme.
A DockTab once registered: its
idis resolved.