Chart.js - 图例
Chart.js 图例显示将在图表或图形上显示的数据集的数据。 Legend 配置选项的命名空间是 options.plugins.legend,而图表图例的全局选项在 Chart.defaults.plugins.legend 中定义。
下表给出了我们可以与图表图例一起使用的各种配置选项的描述 −
名称 | 类型 | 默认 | 描述 |
---|---|---|---|
Display | 布尔值 | true | 如果为 true,则显示图例,否则不显示。 |
Position | 字符串 | 'top' | 用于设置图例的位置,默认为顶部位置。 |
Align | string | 'center' | 用于设置图例的对齐方式。默认为中心位置。 |
maxHeight | number | 它将以像素为单位设置图例的最大高度。 | |
maxWidth | number | 它将以像素为单位设置图例的最大宽度 | |
fullSize | Boolean | true | 顾名思义,如果为 true,则框将占据画布的整个宽度/高度。 |
onClick | function | 这是一个回调函数,当您注册点击时会调用它。事件。 | |
onHover | function | 这是一个回调函数,当您在标签项顶部注册"mousemove"事件时会调用该函数。 | |
onLeave | function | 这是一个回调函数,当您在之前悬停的标签项之外注册"mousemove"事件时会调用该函数。 | |
Reverse | Boolean | false | 顾名思义,使用此配置,图例将以相反的顺序显示数据集。如果为 false,则为默认值。 |
Labels | 对象 | 您可以使用各种图例标签配置,例如颜色、字体、填充、boxWidth、boxHeight 等。 | |
Rtl | 布尔值 | 如果为 true,则图例将从右到左呈现。 | |
textDirection | 字符串 | 画布的默认值 | 顾名思义,此配置将强制画布上的文本方向为"rtl"或"ltr"以呈现图例,而不管在canvas |
Title | 对象 | 您可以使用各种图例标题配置,例如颜色、字体、填充、文本、显示等。 |
语法
图表图例语法如下 −
legend: { display: true, position: 'bottom', labels: { color: 'darkred', } }
图例 enabled 属性必须为 true 才能显示数据标签。如果设置为 false,则 图例 将停用。
示例
让我们举一个例子,其中我们将使用各种图例配置 −
<!DOCTYPE html> <html> <head> <meta charset- "UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <title> chart.js</title> </head> <body> <canvas id="toolTip" aria-label="chart" height="350" width="580"></canvas> <script src="https://cdnjs.cloudflare.com/ajax/libs/Chart.js/3.1.1/chart.min.js"></script> <script> var chartTooltip = document.getElementById("toolTip").getContext("2d"); var toolTip = new Chart(chartTooltip, { type: "line", data: { labels: ["HTML", "CSS", "JAVASCRIPT", "CHART.JS", "JQUERY", "BOOTSTRP"], datasets: [{ label: "online tutorial subjects", data: [20, 40, 30, 35, 30, 20], backgroundColor: ['coral', 'aqua', 'pink', 'lightgreen', 'lightblue', 'crimson'], borderColor: [ "black", ], borderWidth: 1, pointRadius: 5, }], }, options: { responsive: false, plugins: { legend: { display: true, position: 'bottom', align: 'center', labels: { color: 'darkred', font: { weight: 'bold' }, } } } } }); </script> </body> </html>
输出
查看输出。它显示了各种图例配置 −