@grafana/ui | Grafana documentation

STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: /docs/grafana/v9.0/packages_api/ui.md (append .md) or send Accept: text/markdown to /docs/grafana/v9.0/packages_api/ui/. For the curated documentation index, use https://archive.grafana.com/llms.txt. For the complete documentation index, use https://archive.grafana.com/llms-full.txt.

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Documentation

Grafana documentation

API Reference

@grafana/ui

Enterprise Open source

@grafana/ui package

A library containing the different design components of the Grafana ecosystem.

Classes

Class	Description
BarGauge
BigValue
Cascader
ClickOutsideWrapper
ErrorBoundary
ErrorBoundaryAlert
Gauge
Graph	This is a react wrapper for the angular, flot based graph visualization. Rather than using this component, you should use the `<PanelRender …/> with timeseries panel configs.
GraphNG	“Time as X” core component, expects ascending x
GraphSeriesToggler
JsonExplorer	JsonExplorerJsonExplorer allows you to render JSON objects in HTML with a collapsible navigation.
JSONFormatter
List
ModalsProvider
Popover
PopoverController
RefreshPicker
SelectValueEditor
SetInterval
StatsPicker
StringArrayEditor
UnitPicker
UPlotConfigBuilder
VizRepeater

Enumerations

Enumeration	Description
BarGaugeDisplayMode
BigValueColorMode
BigValueGraphMode
BigValueJustifyMode
BigValueTextMode	Options for how the value & title are to be displayed
CompletionItemKind
EventsWithValidation
LegacyInputStatus
NodeGraphDataFrameFieldNames
SeriesVisibilityChangeBehavior

Functions

Function	Description
AlertingSettings({ alertmanagerDataSources, options, onOptionsChange, })
AsyncMultiSelect(props)
AsyncSelect(props)
BracesPlugin()
buildScaleKey(config)
calculateFontSize(text, width, height, lineHeight, maxSize)	*(BETA)*
ClearPlugin()
ClipboardButton({ onClipboardCopy, onClipboardError, children, getText, …buttonProps })
ClipboardPlugin()
convertOldAngularValueMapping(panel)
Drawer({ children, inline, onClose, closeOnMaskClick, scrollableContent, title, subtitle, width, expandable, tabs, })
EmotionPerfTest()
EventsCanvas({ id, events, renderEventMarker, mapEventToXYCoords, config })
FadeTransition(props)
FileDropzone({ options, children, readAs, onLoad, fileListRenderer, onFileRemove })
FileDropzoneDefaultChildren({ primaryText, secondaryText, })
FileListItem({ file: customFile, removeFile })
Form({ defaultValues, onSubmit, validateOnMount, validateFieldsOnMount, children, validateOn, maxWidth, …htmlProps })
getFieldTypeIcon(field)	Get the icon for a given field type
getScrollbarWidth()
getTagColor(index)
getTagColorsFromName(name)	Returns tag badge background and border colors based on hashed tag name.
getTextColorForBackground(color)
IndentationPlugin()
measureText(text, fontSize)	*(BETA)*
Modal(props)
MultiSelect(props)
NewlinePlugin()
Portal(props)
preparePlotFrame(frames, dimFields, timeRange)
RadioButtonGroup({ options, value, onChange, onClick, disabled, disabledOptions, size, id, className, fullWidth, autoFocus, })
RadioButtonList({ name, id, options, value, onChange, className, disabled, disabledOptions, })
resetSelectStyles(theme)
RunnerPlugin({ handler })
Segment({ options, value, onChange, Component, className, allowCustomValue, allowEmptyValue, placeholder, disabled, inputMinWidth, inputPlaceholder, onExpandedChange, autofocus, …rest })
SegmentAsync({ value, onChange, loadOptions, reloadOptionsOnChange, Component, className, allowCustomValue, allowEmptyValue, disabled, placeholder, inputMinWidth, inputPlaceholder, autofocus, onExpandedChange, noOptionMessageHandler, …rest })
SegmentInput({ value: initialValue, onChange, Component, className, placeholder, inputPlaceholder, disabled, autofocus, onExpandedChange, …rest })
Select(props)
SelectionShortcutsPlugin()
sharedSingleStatMigrationHandler(panel)
sharedSingleStatPanelChangedHandler(panel, prevPluginId, prevOptions)
SlatePrism(optsParam, prismLanguages)	A Slate plugin to highlight code syntax.
SlideOutTransition(props)
stylesFactory(stylesCreator)
SuggestionsPlugin({ onTypeahead, cleanText, onWillApplySuggestion, portalOrigin, })
TabbedContainer(props)
useStyles(getStyles)
useStyles2(getStyles)
useTheme()
useTheme2()
ValuePicker({ label, icon, options, onChange, variant, minWidth, size, isFullWidth, menuPlacement, })
VizLegend({ items, displayMode, sortBy: sortKey, seriesVisibilityChangeBehavior, sortDesc, onLabelClick, onToggleSort, placement, className, itemRenderer, readonly, })
withErrorBoundary(Component, errorBoundaryProps)	HOC for wrapping a component in an error boundary.

Interfaces

Interface	Description
AsyncSelectProps
BadgeProps
CardContainerProps
CardProps
CascaderOption
CompletionItem
CompletionItemGroup
ConfirmModalProps
ContextMenuProps
CustomControlProps
DatePickerProps
DatePickerWithInputProps
DropzoneFile
ErrorBoundaryAlertProps	Props for the ErrorBoundaryAlert component
FieldArrayApi
FileDropzoneProps
FileListItemProps
GraphNGProps
GraphSeriesTogglerAPI
LoadingPlaceholderProps
MultiSelectCommonProps
PlotSelection
PluginSignatureBadgeProps
SelectableOptGroup
SelectAsyncProps
SelectBaseProps
SelectCommonProps
SelectContainerProps
SeriesTableProps
SeriesTableRowProps
SingleStatBaseOptions
SuggestionsState
TabConfig
TableSortByFieldState
Themeable
Themeable2
TimeRangePickerProps
Token
TypeaheadInput
TypeaheadOutput
ValidationEvents
ValidationRule
VizLayoutComponentType	*(BETA)*
VizLayoutLegendProps	*(BETA)*
VizLayoutProps	*(BETA)*
VizLegendItem
VizRepeaterRenderValueProps

Namespaces

Namespace	Description
commonOptionsBuilder
DOMUtil
Modal
RadioButtonGroup
ReactUtils
styleMixins
VizLegend

Variables

Variable	Description
Alert
Badge
Button
ButtonCascader
ButtonGroup
ButtonSelect
CallToActionCard
Card	Generic card component
CardContainer
CertificationKey
Checkbox
CodeEditor
CollapsableSection
Collapse
ColorPicker
colors
ConfirmButton
ConfirmModal
Container
ContextMenu
ControlledCollapse
Counter
CustomScrollbar	Wraps component into component from `react-custom-scrollbars`
DataLinkInput
DataLinksContextMenu
DataLinksInlineEditor
DataSourceHttpSettings
DatePicker
DatePickerWithInput
DateTimePicker
defaultIntervals
DeleteButton
DropdownIndicator
EmptySearchResult
ErrorWithStack
FeatureBadge
FeatureInfoBox
Field
FieldArray
fieldMatchersUI
FieldSet
FieldValidationMessage
FileUpload
FilterInput
FilterPill
FormattedValueDisplay
FullWidthButtonContainer
getAvailableIcons
getCardStyles
getInputStyles
getLogRowStyles
getSelectStyles
getStandardFieldConfigs	Returns collection of common field config properties definitions
getTheme
graphTickFormatter
graphTimeFormat
GraphWithLegend
hasValidationEvent
HorizontalGroup
Icon
IconButton
InfoBox
InlineField
InlineFieldRow
InlineFormLabel
InlineLabel
InlineSegmentGroup	*(BETA)*
InlineSwitch
Input
InputControl
Label
LegacyForms
Legend
LinkButton
linkModelToContextMenuItems	Delays creating links until we need to open the ContextMenu
LoadingPlaceholder
LogLabels
LogMessageAnsi
LogRows
makeFragment
makeValue
Marker
mockTheme
mockThemeContext
ModalRoot
ModalsContext
ModalsController
ModalTabsHeader
NumberValueEditor
Pagination
PanelContainer
PanelContextRoot
PlotLegend
PluginSignatureBadge
QueryField
RangeSlider	RichHistoryQueriesTab uses this Range Component
regexValidation
SCHEMA
SelectContainer
SeriesColorPicker
SeriesColorPickerPopover
SeriesColorPickerPopoverWithTheme
SeriesIcon
SeriesTable
SeriesTableRow
sharedInputStyle
Slider
SliderValueEditor
sortedColors
Spinner
StringValueEditor
Switch
Tab
TabContent
Table
TableInputCSV
TabsBar
Tag
TagList
TagsInput
TextArea
ThemeContext
TimeOfDayPicker
TimeRangeInput
TimeRangePicker
TimeSeries
TimeZonePicker
TLSAuthSettings
ToolbarButton
ToolbarButtonRow
Tooltip
UPLOT_AXIS_FONT_SIZE
validate
VerticalGroup
VizLayout	*(BETA)*
VizTooltip
VizTooltipContainer
WeekStartPicker
WithContextMenu
withTheme
XYCanvas	Renders absolutely positioned element on top of the uPlot’s plotting area (axes are not included!). Useful when you want to render some overlay with canvas-independent elements on top of the plot.

Type Aliases

Type Alias	Description
ActionMeta
AlertVariant
BadgeColor
ButtonProps
ButtonVariant
CodeEditorMonacoOptions
ControlComponent
FormAPI
FormatOptionLabelMeta
FormInputSize
IconButtonVariant
IconName
IconSize
IconType
InputActionMeta
LoadOptionsCallback
Monaco
MonacoEditor
OnTagClick
PopoverContent
Renderable
RenderFunction
ScrollbarPosition
SelectOptions
SelectValue