Chart.js
入门指南
入门
安装
集成
分步指南
概览
可访问性(Accessibility)
颜色(Colors)
数据结构(Data structures)
字体(Fonts)
选项(Options)
内边距(Padding)
性能(Performance)
图表配置
配置(Configuration)
动画(Animations)
画布背景(Canvas background)
数据抽取(Data Decimation)
设备像素比率(Device Pixel Ratio)
通用配置(Elements)
互动(Interactions)
布局(Layout)
图例(Legend)
本地化(Locale)
响应式图表(Responsive Charts)
副标题(Subtitle)
标题(Title)
提示(Tooltip)
Charts
面积图(Area Chart)
柱状/条形图(Bar Chart)
气泡图(Bubble Chart)
环形&饼图(Doughnut and Pie Charts)
折线图(Line Chart)
混合图表(Mixed Chart Types)
极地图(Polar Area Chart)
雷达图(Radar Chart)
离散图(Scatter Chart)
坐标轴
轴(Axes)
笛卡尔坐标(Cartesian)
笛卡尔坐标轴(Cartesian Axes)
分类轴(Category Axis)
线性轴(Linear Axis)
对数轴(Logarithmic Axis)
时间笛卡尔轴(Time Cartesian Axis)
时间序列轴(Time Series Axis)
径向(Radial)
径向轴(Radial Axes)
线性径向轴(Linear Radial Axis)
标签轴(Labelling Axes)
样式(Styling)
开发者
开发者(Developers)
Chart.js API
坐标轴扩展
图表扩展
贡献
插件
发布扩展
更新 Charts
迁移
4.x迁移指南
3.x迁移指南
示例
Chart.js Samples
Bar Charts
Bar Chart Border Radius
Floating Bars
Horizontal Bar Chart
Stacked Bar Chart
Stacked Bar Chart with Groups
Vertical Bar Chart
Line Charts
Interpolation Modes
Line Chart
Multi Axis Line Chart
Point Styling
Line Segment Styling
Stepped Line Charts
Line Styling
Other charts
Bubble
Combo bar/line
Doughnut
Multi Series Pie
Pie
Polar area
Polar area centered point labels
Radar
Radar skip points
Scatter
Scatter - Multi axis
Stacked bar/line
Area charts
Line Chart Boundaries
Line Chart Datasets
Line Chart drawTime
Line Chart Stacked
Radar Chart Stacked
Scales
Linear Scale - Min-Max
Linear Scale - Suggested Min-Max
Linear Scale - Step Size
Log Scale
Stacked Linear / Category
Time Scale
Time Scale - Max Span
Time Scale - Combo Chart
Scale Options
Center Positioning
Grid Configuration
Tick Configuration
Title Configuration
Legend
Events
HTML Legend
Point Style
Position
Alignment and Title Position
Title
Alignment
Subtitle
Basic
Tooltip
Custom Tooltip Content
External HTML Tooltip
Interaction Modes
Point Style
Position
Scriptable Options
Bar Chart
Bubble Chart
Line Chart
Pie Chart
Polar Area Chart
Radar Chart
Animations
Delay
Drop
Loop
Progressive Line
Progressive Line With Easing
Advanced
Data Decimation
Derived Axis Type
Derived Chart Type
Linear Gradient
Programmatic Event Triggers
Animation Progress Bar
Radial Gradient
Plugins
Chart Area Border
Doughnut Empty State
Quadrants
Utils
分类轴(Category Axis) - Chart.js中文文档 - 笔下光年
网站首页
分类轴(Category Axis)
If the global configuration is used, labels are drawn from one of the label arrays included in the chart data. If only data.labels is defined, this will be used. If data.xLabels is defined and the axis is horizontal, this will be used. Similarly, if data.yLabels is defined and the axis is vertical, this property will be used. Using both xLabels and yLabels together can create a chart that uses strings for both the X and Y axes. Specifying any of the settings above defines the x-axis as type: 'category' if not defined otherwise. For more fine-grained control of category labels, it is also possible to add labels as part of the category axis definition. Doing so does not apply the global defaults. ## Category Axis Definition Globally: ```javascript let chart = new Chart(ctx, { type: ... data: { labels: ['January', 'February', 'March', 'April', 'May', 'June'], datasets: ... } }); ``` As part of axis definition: ```javascript let chart = new Chart(ctx, { type: ... data: ... options: { scales: { x: { type: 'category', labels: ['January', 'February', 'March', 'April', 'May', 'June'] } } } }); ``` ## Configuration Options ### Category Axis specific options Namespace: options.scales[scaleId] | Name | Type | Description | |--------|---------|-----------------| | min | `string` | `number` | The minimum item to display. more... | | max | `string` | `number` | The maximum item to display. more... | | labels | `string[]` | `string[][]` | An array of labels to display. When an individual label is an array of strings, each item is rendered on a new line. | ### Common options to all cartesian axes Namespace: options.scales[scaleId] | Name | Type | Default | Description | |-------------|-----------------|-----------------|--------------| | bounds | string | 'ticks' | Determines the scale bounds. more... | | position | string | object | | Position of the axis. more... | | stack | string | | Stack group. Axes at the same position with same stack are stacked. | | stackWeight | number | 1 | Weight of the scale in stack group. Used to determine the amount of allocated space for the scale within the group. | | axis | string | | Which type of axis this is. Possible values are: 'x', 'y'. If not set, this is inferred from the first character of the ID which should be 'x' or 'y'. | | offset | boolean | false | If true, extra space is added to the both edges and the axis is scaled to fit into the chart area. This is set to true for a bar chart by default. | | title | object | | Scale title configuration. more... | ### Common options to all axes Namespace: options.scales[scaleId] | Name | Type | Default | Description | |-----------------|----------------|-----------|---------------| | type | string | | Type of scale being employed. Custom scales can be created and registered with a string key. This allows changing the type of an axis for a chart. | | alignToPixels | boolean | false | Align pixel values to device pixels. | | backgroundColor | Color | | Background color of the scale area. | | border | object | | Border configuration. more... | | display | boolean | string | true | Controls the axis global visibility (visible when true, hidden when false). When display: 'auto', the axis is visible only if at least one associated dataset is visible. | | grid | object | | Grid line configuration. more... | | min | number | | User defined minimum number for the scale, overrides minimum value from data. more... | | max | number | | User defined maximum number for the scale, overrides maximum value from data. more... | | reverse | boolean | false | Reverse the scale. | | stacked | boolean|string | false | Should the data be stacked. more... | | suggestedMax | number | | Adjustment used when calculating the maximum data value. more... | | suggestedMin | number | | Adjustment used when calculating the minimum data value. more... | | ticks | object | | Tick configuration. more... | | weight | number | 0 | The weight used to sort the axis. Higher weights are further away from the chart area. | ## Tick Configuration ### Common tick options to all cartesian axes Namespace: options.scales[scaleId].ticks | Name | Type | Default | Description | |-----------------|---------|--------------|----------------| | align | string | 'center' | The tick alignment along the axis. Can be 'start', 'center', 'end', or 'inner'. inner alignment means align start for first tick and end for the last tick of horizontal axis | | crossAlign | string | 'near' | The tick alignment perpendicular to the axis. Can be 'near', 'center', or 'far'. See Tick Alignment | | sampleSize | number | ticks.length | The number of ticks to examine when deciding how many labels will fit. Setting a smaller value will be faster, but may be less accurate when there is large variability in label length. | | autoSkip | boolean | true | If true, automatically calculates how many labels can be shown and hides labels accordingly. Labels will be rotated up to maxRotation before skipping any. Turn autoSkip off to show all labels no matter what. | | autoSkipPadding | number | 3 | Padding between the ticks on the horizontal axis when autoSkip is enabled. | | includeBounds | boolean | true | Should the defined min and max values be presented as ticks even if they are not "nice". | | labelOffset | number | 0 | Distance in pixels to offset the label from the centre point of the tick (in the x-direction for the x-axis, and the y-direction for the y-axis). Note: this can cause labels at the edges to be cropped by the edge of the canvas | | maxRotation | number | 50 | Maximum rotation for tick labels when rotating to condense labels. Note: Rotation doesn't occur until necessary. Note: Only applicable to horizontal scales. | | minRotation | number | 0 | Minimum rotation for tick labels. Note: Only applicable to horizontal scales. | | mirror | boolean | false | Flips tick labels around axis, displaying the labels inside the chart instead of outside. Note: Only applicable to vertical scales. | | padding | number | 0 | Padding between the tick label and the axis. When set on a vertical axis, this applies in the horizontal (X) direction. When set on a horizontal axis, this applies in the vertical (Y) direction. | | maxTicksLimit | number | 11 | Maximum number of ticks and gridlines to show. | ### Common tick options to all axes Namespace: options.scales[scaleId].ticks | Name | Type | Scriptable | Default | Description | |-------------------|----------|--------------|--------------|---------------| | backdropColor | Color | Yes | 'rgba(255, 255, 255, 0.75)' | Color of label backdrops. | | backdropPadding | Padding | | 2 | Padding of label backdrop. | | callback | function | | | Returns the string representation of the tick value as it should be displayed on the chart. See callback. | | display | boolean | | true | If true, show tick labels. | | color | Color | Yes | Chart.defaults.color | Color of ticks. | | font | Font | Yes | Chart.defaults.font | See Fonts | | major | object | | {} | Major ticks configuration. | | padding | number | | 3 | Sets the offset of the tick labels from the axis | | showLabelBackdrop | boolean | Yes | true for radial scale, false otherwise | If true, draw a background behind the tick labels. | | textStrokeColor | Color | Yes | `` | The color of the stroke around the text. | | textStrokeWidth | number | Yes | 0 | Stroke width around the text. | | z | number | | 0 | z-index of tick layer. Useful when ticks are drawn on chart area. Values <= 0 are drawn under datasets, > 0 on top. | ## Min Max Configuration For both the min and max properties, the value must be string in the labels array or numeric value as an index of a label in that array. In the example below, the x axis would only display "March" through "June". ```javascript let chart = new Chart(ctx, { type: 'line', data: { datasets: [{ data: [10, 20, 30, 40, 50, 60] }], labels: ['January', 'February', 'March', 'April', 'May', 'June'] }, options: { scales: { x: { min: 'March' } } } }); ``` ## Internal data format Internally category scale uses label indices
上一篇:
笛卡尔坐标轴(Cartesian Axes)
下一篇:
线性轴(Linear Axis)