Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana/v7.0/packages_api/data/fieldconfigeditorconfig.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana/v7.0/packages_api/data/fieldconfigeditorconfig/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://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.
FieldConfigEditorConfig interface
Signature
export interface FieldConfigEditorConfig<TOptions, TSettings = any, TValue = any> Import
import { FieldConfigEditorConfig } from '@grafana/data';Properties
| Property | Type | Description |
|---|---|---|
| category | string[] | Array of strings representing category of the field config property. First element in the array will make option render as collapsible section. |
| defaultValue | TValue | |
| description | string | Description of the field config property. Will be displayed in the UI as form element description. |
| name | string | Name of the field config property. Will be displayed in the UI as form element label. |
| path | (keyof TOptions & string) | string | Path of the field config property to control. |
| settings | TSettings | Custom settings of the editor. |
| shouldApply | (field: Field) => boolean | Function that allows specifying whether or not this field config should apply to a given field. |
| showIf | (currentConfig: TOptions) => boolean | Function that enables configuration of when field config property editor should be shown based on current panel field config. |
category property
Array of strings representing category of the field config property. First element in the array will make option render as collapsible section.
Signature
category?: string[];defaultValue property
Signature
defaultValue?: TValue;description property
Description of the field config property. Will be displayed in the UI as form element description.
Signature
description?: string;name property
Name of the field config property. Will be displayed in the UI as form element label.
Signature
name: string;path property
Path of the field config property to control.
Signature
path: (keyof TOptions & string) | string;Example
Given field config object of a type:
interface CustomFieldConfig {
a: {
b: string;
}
}path can be either ‘a’ or ‘a.b’.
settings property
Custom settings of the editor.
Signature
settings?: TSettings;shouldApply property
Function that allows specifying whether or not this field config should apply to a given field.
Signature
shouldApply?: (field: Field) => boolean;showIf property
Function that enables configuration of when field config property editor should be shown based on current panel field config.
Signature
showIf?: (currentConfig: TOptions) => boolean;