25756b49a3
* Remove duplicated sections * Regenerate docs * Refactor schema.sections func (#63079) * Refactor schema.sections func * Small refactors --------- Co-authored-by: Joan López de la Franca Beltran <5459617+joanlopez@users.noreply.github.com>
175 lines
15 KiB
Markdown
175 lines
15 KiB
Markdown
---
|
|
keywords:
|
|
- grafana
|
|
- schema
|
|
title: BarChartPanelCfg kind
|
|
---
|
|
> Both documentation generation and kinds schemas are in active development and subject to change without prior notice.
|
|
|
|
## BarChartPanelCfg
|
|
|
|
#### Maturity: [experimental](../../../maturity/#experimental)
|
|
#### Version: 0.0
|
|
|
|
|
|
|
|
| Property | Type | Required | Description |
|
|
|--------------------|-----------------------------|----------|-------------|
|
|
| `PanelFieldConfig` | [object](#panelfieldconfig) | **Yes** | |
|
|
| `PanelOptions` | [object](#paneloptions) | **Yes** | |
|
|
|
|
### PanelFieldConfig
|
|
|
|
It extends [AxisConfig](#axisconfig) and [HideableFieldConfig](#hideablefieldconfig).
|
|
|
|
| Property | Type | Required | Description |
|
|
|---------------------|-----------------------------------------------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------|
|
|
| `axisCenteredZero` | boolean | No | *(Inherited from [AxisConfig](#axisconfig))* |
|
|
| `axisColorMode` | string | No | *(Inherited from [AxisConfig](#axisconfig))*<br/>TODO docs<br/>Possible values are: `text`, `series`. |
|
|
| `axisGridShow` | boolean | No | *(Inherited from [AxisConfig](#axisconfig))* |
|
|
| `axisLabel` | string | No | *(Inherited from [AxisConfig](#axisconfig))* |
|
|
| `axisPlacement` | string | No | *(Inherited from [AxisConfig](#axisconfig))*<br/>TODO docs<br/>Possible values are: `auto`, `top`, `right`, `bottom`, `left`, `hidden`. |
|
|
| `axisSoftMax` | number | No | *(Inherited from [AxisConfig](#axisconfig))* |
|
|
| `axisSoftMin` | number | No | *(Inherited from [AxisConfig](#axisconfig))* |
|
|
| `axisWidth` | number | No | *(Inherited from [AxisConfig](#axisconfig))* |
|
|
| `fillOpacity` | integer | No | Controls the fill opacity of the bars. Default: `80`. |
|
|
| `gradientMode` | string | No | TODO docs<br/>Possible values are: `none`, `opacity`, `hue`, `scheme`. |
|
|
| `hideFrom` | [HideSeriesConfig](#hideseriesconfig) | No | *(Inherited from [HideableFieldConfig](#hideablefieldconfig))*<br/>TODO docs |
|
|
| `lineWidth` | integer | No | Controls line width of the bars. Default: `1`. |
|
|
| `scaleDistribution` | [ScaleDistributionConfig](#scaledistributionconfig) | No | *(Inherited from [AxisConfig](#axisconfig))*<br/>TODO docs |
|
|
| `thresholdsStyle` | [GraphThresholdsStyleConfig](#graphthresholdsstyleconfig) | No | TODO docs |
|
|
|
|
### AxisConfig
|
|
|
|
TODO docs
|
|
|
|
| Property | Type | Required | Description |
|
|
|---------------------|-----------------------------------------------------|----------|----------------------------------------------------------------------------------------|
|
|
| `axisCenteredZero` | boolean | No | |
|
|
| `axisColorMode` | string | No | TODO docs<br/>Possible values are: `text`, `series`. |
|
|
| `axisGridShow` | boolean | No | |
|
|
| `axisLabel` | string | No | |
|
|
| `axisPlacement` | string | No | TODO docs<br/>Possible values are: `auto`, `top`, `right`, `bottom`, `left`, `hidden`. |
|
|
| `axisSoftMax` | number | No | |
|
|
| `axisSoftMin` | number | No | |
|
|
| `axisWidth` | number | No | |
|
|
| `scaleDistribution` | [ScaleDistributionConfig](#scaledistributionconfig) | No | TODO docs |
|
|
|
|
### ScaleDistributionConfig
|
|
|
|
TODO docs
|
|
|
|
| Property | Type | Required | Description |
|
|
|-------------------|--------|----------|--------------------------------------------------------------------------|
|
|
| `type` | string | **Yes** | TODO docs<br/>Possible values are: `linear`, `log`, `ordinal`, `symlog`. |
|
|
| `linearThreshold` | number | No | |
|
|
| `log` | number | No | |
|
|
|
|
### GraphThresholdsStyleConfig
|
|
|
|
TODO docs
|
|
|
|
| Property | Type | Required | Description |
|
|
|----------|--------|----------|-----------------------------------------------------------------------------------------------------------|
|
|
| `mode` | string | **Yes** | TODO docs<br/>Possible values are: `off`, `line`, `dashed`, `area`, `line+area`, `dashed+area`, `series`. |
|
|
|
|
### HideSeriesConfig
|
|
|
|
TODO docs
|
|
|
|
| Property | Type | Required | Description |
|
|
|-----------|---------|----------|-------------|
|
|
| `legend` | boolean | **Yes** | |
|
|
| `tooltip` | boolean | **Yes** | |
|
|
| `viz` | boolean | **Yes** | |
|
|
|
|
### HideableFieldConfig
|
|
|
|
TODO docs
|
|
|
|
| Property | Type | Required | Description |
|
|
|------------|---------------------------------------|----------|-------------|
|
|
| `hideFrom` | [HideSeriesConfig](#hideseriesconfig) | No | TODO docs |
|
|
|
|
### PanelOptions
|
|
|
|
It extends [OptionsWithLegend](#optionswithlegend) and [OptionsWithTooltip](#optionswithtooltip) and [OptionsWithTextFormatting](#optionswithtextformatting).
|
|
|
|
| Property | Type | Required | Description |
|
|
|-----------------------|-------------------------------------------------|----------|------------------------------------------------------------------------------------------------------------------------------------|
|
|
| `barWidth` | number | **Yes** | Controls the width of bars. 1 = Max width, 0 = Min width. Default: `0.97`. |
|
|
| `fullHighlight` | boolean | **Yes** | Enables mode which highlights the entire bar area and shows tooltip when cursor<br/>hovers over highlighted area Default: `false`. |
|
|
| `groupWidth` | number | **Yes** | Controls the width of groups. 1 = max with, 0 = min width. Default: `0.7`. |
|
|
| `legend` | [VizLegendOptions](#vizlegendoptions) | **Yes** | *(Inherited from [OptionsWithLegend](#optionswithlegend))*<br/>TODO docs |
|
|
| `orientation` | string | **Yes** | TODO docs<br/>Possible values are: `auto`, `vertical`, `horizontal`. |
|
|
| `showValue` | string | **Yes** | TODO docs<br/>Possible values are: `auto`, `never`, `always`. |
|
|
| `stacking` | string | **Yes** | TODO docs<br/>Possible values are: `none`, `normal`, `percent`. |
|
|
| `tooltip` | [VizTooltipOptions](#viztooltipoptions) | **Yes** | *(Inherited from [OptionsWithTooltip](#optionswithtooltip))*<br/>TODO docs |
|
|
| `xTickLabelMaxLength` | integer | **Yes** | Sets the max length that a label can have before it is truncated. |
|
|
| `xTickLabelRotation` | integer | **Yes** | Controls the rotation of the x axis labels. Default: `0`. |
|
|
| `barRadius` | number | No | Controls the radius of each bar. Default: `0`. |
|
|
| `colorByField` | string | No | Use the color value for a sibling field to color each bar value. |
|
|
| `text` | [VizTextDisplayOptions](#viztextdisplayoptions) | No | *(Inherited from [OptionsWithTextFormatting](#optionswithtextformatting))*<br/>TODO docs |
|
|
| `xField` | string | No | Manually select which field from the dataset to represent the x field. |
|
|
| `xTickLabelSpacing` | integer | No | Controls the spacing between x axis labels.<br/>negative values indicate backwards skipping behavior Default: `0`. |
|
|
|
|
### OptionsWithLegend
|
|
|
|
TODO docs
|
|
|
|
| Property | Type | Required | Description |
|
|
|----------|---------------------------------------|----------|-------------|
|
|
| `legend` | [VizLegendOptions](#vizlegendoptions) | **Yes** | TODO docs |
|
|
|
|
### VizLegendOptions
|
|
|
|
TODO docs
|
|
|
|
| Property | Type | Required | Description |
|
|
|---------------|----------|----------|-----------------------------------------------------------------------------------------------------------------------------------------|
|
|
| `calcs` | string[] | **Yes** | |
|
|
| `displayMode` | string | **Yes** | TODO docs<br/>Note: "hidden" needs to remain as an option for plugins compatibility<br/>Possible values are: `list`, `table`, `hidden`. |
|
|
| `placement` | string | **Yes** | TODO docs<br/>Possible values are: `bottom`, `right`. |
|
|
| `showLegend` | boolean | **Yes** | |
|
|
| `asTable` | boolean | No | |
|
|
| `isVisible` | boolean | No | |
|
|
| `sortBy` | string | No | |
|
|
| `sortDesc` | boolean | No | |
|
|
| `width` | number | No | |
|
|
|
|
### OptionsWithTextFormatting
|
|
|
|
TODO docs
|
|
|
|
| Property | Type | Required | Description |
|
|
|----------|-------------------------------------------------|----------|-------------|
|
|
| `text` | [VizTextDisplayOptions](#viztextdisplayoptions) | No | TODO docs |
|
|
|
|
### VizTextDisplayOptions
|
|
|
|
TODO docs
|
|
|
|
| Property | Type | Required | Description |
|
|
|-------------|--------|----------|--------------------------|
|
|
| `titleSize` | number | No | Explicit title text size |
|
|
| `valueSize` | number | No | Explicit value text size |
|
|
|
|
### OptionsWithTooltip
|
|
|
|
TODO docs
|
|
|
|
| Property | Type | Required | Description |
|
|
|-----------|-----------------------------------------|----------|-------------|
|
|
| `tooltip` | [VizTooltipOptions](#viztooltipoptions) | **Yes** | TODO docs |
|
|
|
|
### VizTooltipOptions
|
|
|
|
TODO docs
|
|
|
|
| Property | Type | Required | Description |
|
|
|----------|--------|----------|---------------------------------------------------------------|
|
|
| `mode` | string | **Yes** | TODO docs<br/>Possible values are: `single`, `multi`, `none`. |
|
|
| `sort` | string | **Yes** | TODO docs<br/>Possible values are: `asc`, `desc`, `none`. |
|
|
|
|
|