Ausführliche Erklärung der Highcharts-Konfigurationsoptionen
Highcharts bietet eine große Anzahl von Konfigurationsoptionen und Parametern, mit denen Sie Diagramme einfach an die Anforderungen der Benutzer anpassen können. In diesem Kapitel werden die Verwendungshinweise für Highcharts-Konfigurationsoptionen ausführlich vorgestellt.
Parameterkonfiguration (Attribute + Ereignisse)
-
chart.events.addSeries: Fügt dem Diagramm eine Serie hinzu.
-
chart.events.click: Das Klickereignis, das im Plotbereich des gesamten Diagramms auftritt.
-
chart.events.load: Diagramm-Ladeereignis.
-
chart.events.redraw: Das Neuzeichnungsereignis des Diagramms, das ausgelöst werden kann, wenn auf die Legende geklickt wird, um Plots ein- oder auszublenden.
-
chart.events.selection: Wenn die Diagrammkurve zum Zoomen ausgewählt werden kann, kann dieses Ereignis ausgelöst werden, wenn ein Auswahlvorgang im Diagramm durchgeführt wird.
-
chart.height: Der Höhenwert des zu zeichnenden Diagramms.
-
chart.inverted: Vertauscht die x- und y-Achsen im Diagramm.
-
chart.polar: Gibt an, ob es sich um ein Polardiagramm handelt.
-
chart.reflow: Wenn sich die Fenstergröße ändert, passt sich die Diagrammbreite an die Änderung der Fenstergröße an.
-
chart.renderTo: Der Ort, an dem das Diagramm geladen wird, ein DOM-Objekt auf der Seite.
-
chart.showAxes: Ob die Achsen in einem leeren Diagramm angezeigt werden.
-
chart.type: The type of the chart, defaulting to line, and also includesbar/column/pie……
-
chart.width: Die Breite des Diagramm-Zeichenbereichs, standardmäßig automatisch angepasst.
-
chart.zoomType: Der Zoomtyp für Datenberichte im Diagramm. Es kann entlang der X-Achse, der Y-Achse oder gleichzeitig entlang beider XY-Achsen gezoomt werden.
-
colors: Wenn es mehrere Reihen im Diagramm gibt, die Farben zwischen den einzelnen Datenreihen. Es ist ein Array, das im Allgemeinen unverändert bleibt.
-
credits.enabled: Ob die Anzeige von Urheberrechtsinformationen erlaubt ist.
-
credits.href: Link für das Urheberrecht.
-
credits.text: Der Text, der für Urheberrechtsinformationen angezeigt wird.
-
exporting.buttons.exportButton.enabled: Ob die Anzeige der Export-Schaltfläche erlaubt ist.
-
exporting.buttons.exportButton.menuItems: Die Menüoptionen der Export-Schaltfläche.
-
exporting.buttons.exportButton.onclick: Ereignis, wenn auf die Export-Schaltfläche geklickt wird, nicht auf das interne Menü.
-
exporting.buttons.printButton.enabled: Ob die Druck-Schaltfläche zugelassen werden soll.
-
exporting.buttons.printButton.onclick: Das Klickereignis der Druck-Schaltfläche.
-
exporting.enabled: Ob die Druck- und Export-Schaltflächen aktiviert sind.
-
exporting.filename: Dateiname der exportierten Datei.
-
exporting.type: Das Dateiformat des standardmäßig exportierten Bildes.
-
exporting.url: Die Schnittstellenverarbeitungsadresse zum Konvertieren und Exportieren von SVG-Diagrammen.
-
exporting.width: Die Breite des standardmäßig exportierten Bildes. (Hinweis: Der Originaltext enthielt einen Tippfehler "exporing.width")
-
labelsLabels: Kann an jeder Position im Diagramm geladen werden und enthält Elemente und Stil.
-
lang: Sprachparameterkonfiguration, einschließlich Konfigurationen im Zusammenhang mit dem Export-Schaltflächenmenü, Zeitnamen-Konfigurationen usw.
-
legend.enabled: Ob die Legende aktiviert werden soll.
-
navigation.buttonOptions.enabled: Ob die Schaltflächen in der gesamten Navigation im Diagramm angeklickt werden können.
-
plotOptions.area.allowPointSelect: Ob das Anklicken von Datenpunkten erlaubt werden soll.
-
plotOptions.area.color: Die Farbe des Diagramms.
-
plotOptions.area.dataLabels.enabled: Ob Datenbeschriftungen erlaubt werden sollen.
-
plotOptions.area.enableMouseTracking: Ob die Blasendarstellung der Mausverfolgung für Datenpunkte im Datendiagramm erlaubt werden soll.
-
plotOptions.area.events.checkboxClick: Klickereignis für das Kontrollkästchen in der Legende im Datendiagramm.
-
plotOptions.area.events.click: Klickereignis für Datenpunkte im Datendiagramm.
-
plotOptions.area.events.hide: Das Ereignis, wenn eine Datenreihe im Datendiagramm ausgeblendet wird.
-
plotOptions.area.events.show: Das Ereignis, wenn eine Datenreihe im Datendiagramm angezeigt wird.
-
plotOptions.area.events.legendItemClick: Das Ereignis, wenn ein Element in der Legende im Datendiagramm angeklickt wird. Wenn direkt false zugewiesen wird, kann es nicht angeklickt werden.
-
plotOptions.area.events.mouseOut: Mouse-out-Ereignis für Datenpunkte.
-
plotOptions.area.events.mouseOver: Mouse-over-Ereignis für Datenpunkte.
-
plotOptions.area.marker.enabled: Ob Punktmarkierungen im Zeichenbereich des Diagramms angezeigt werden sollen.
-
plotOptions.area.marker.states.hover.enabled: Legt fest, ob der Hover-Zustand von Markierungen zugelassen wird.
-
plotOptions.area.marker.states.select.enabled: Legt fest, ob der Auswahlzustand von Markierungen zugelassen wird.
-
plotOptions.area.point.events.click: Klick-Ereignis für jeden einzelnen Punkt im Diagramm.
-
plotOptions.area.point.events.mouseOut
-
plotOptions.area.point.events..mouseOver
-
plotOptions.area.point.events.remove: Ereignis, wenn ein Punkt aus dem Diagramm entfernt wird.
-
plotOptions.area.point.events.select: Das Punktauswahl-Ereignis im Diagramm.
-
plotOptions.area.point.events.unselect: Ereignis, wenn die Auswahl eines Punkts im Diagramm aufgehoben wird.
-
plotOptions.area.point.events.update: Ereignis, das ausgelöst wird, wenn Daten im Diagramm aktualisiert werden.
-
plotOptions.area.visible: Legt fest, ob die Datenreihe beim Laden standardmäßig angezeigt oder ausgeblendet wird.
-
plotOptions.area.zIndex: Bei mehreren Reihen wird die Stapelreihenfolge jeder Reihe angepasst.
-
Die oben genannten point.events gelten auch für andere flächenähnliche Diagramme (arearange, areaspline, areasplinerange), andere Balkendiagramme (bar, column) und alle Diagramme.
-
plotOptions.area.showInLegend: Ob in der Legende angezeigt werden soll.
-
plotOptions.area.stacking: Ob nach Wert oder nach Prozentsatz gestapelt werden soll.
-
plotOptions.area.states.hover.enabled: Ob der Hover-Zustand erlaubt ist.
-
plotOptions.area.stickyTracking: Sticky-Tracking von Datenpunkten mit der Maus.
-
plotOptions.arearange, plotOptions.areaspline, plotOptions.areasplinerange sind ähnlich zu plotOptions.area.
-
plotOptions.bar.groupPadding: Der Abstand zwischen den einzelnen Gruppen in einer Balkendiagramm-Gruppierung.
-
plotOptions.bar.grouping: Ob die Daten gruppiert werden sollen.
-
plotOptions.bar.minPointLength: Definiert die Mindestlänge eines Punktes, wenn sein Wert null ist.
-
plotOptions.bar.showInLegend: Ob in der Legende angezeigt werden soll.
-
plotOptions.bar.stacking: Ob nach Wert oder nach Prozentsatz gestapelt werden soll (normal/percent).
-
plotOptions.column und plotOptions.columnrange sind ähnlich zu plotOptions.bar.
-
Die Konfiguration von plotOptions.line ist ähnlich zur Konfiguration von plotOptions.area.
-
plotOptions.pie.ignoreHiddenPoint: Legt in einem Kreisdiagramm fest, ob nach dem Ausblenden einer Reihe durch Klicken auf die Legende das gesamte Kreisdiagramm auf 100 % neu verteilt wird oder der ausgeblendete Teil einfach basierend auf dem ursprünglichen Diagramm ausgeblendet wird, sodass eine Lücke entsteht.
-
plotOptions.pie.innerSize: Wie viel Leerraum beim Zeichnen in der Mitte des Kreisdiagramms reserviert wird.
-
plotOptions.pie.slicedOffset: Wird zusammen mit allowPointSelect verwendet. Wenn ein Punkt angeklickt wird, wird der entsprechende Sektor herausgetrennt. Dieser Parameter konfiguriert die Versatzdistanz.
-
Weitere gängige Konfigurationsparameter von plotOptions.pie ähneln denen von plotOptions.area; die zugehörigen Konfigurationen von plotOptions.scatter, plotOptions.series und plotOptions.spline ähneln der Konfiguration von plotOptions.area.
-
series: ist ein Array.
-
series.data.color: Die Farbe eines bestimmten Datenpunkts.
-
series.data.dataLabels: Die Datenbeschriftung eines bestimmten Datenpunkts in einer Reihe.
-
series.data.events ähnelt der Konfiguration von plotOptions.area.point.events.
-
series.data.marker ähnelt der Konfiguration von plotOptions.area.marker.
-
series.data.name: Konfiguriert den Namen des Datenpunkts.
-
series.data.sliced: Konfiguriert den Trennungsabstand von Sektoren in einem Kreisdiagramm.
-
series.data.x: der x-Wert des Punkts.
-
series.data.y: der y-Wert des Punktes.
-
series.name: Der Name der Datenreihe.
-
series.stack: Der Gruppierungsindex für die Stapelung.
-
series.type: Der Anzeigetyp der Datenreihe.
-
series.xAxis, series.yAxis: Wenn mehrere Achsen verwendet werden, gibt an, welcher Achse eine Datenreihe entspricht.
-
subtitle: Konfiguriert den Untertitel des Diagramms.
-
title: Konfiguriert den Titel des Diagramms.
-
tooltip: Konfiguriert den Tooltip für Daten im Diagramm.
-
tooltip.valueDecimals: Anzahl der zulässigen Dezimalstellen.
-
tooltip.percentageDecimals: Anzahl der zulässigen Dezimalstellen für Prozentsätze.
-
xAxis, yAxis-Konfiguration legt die Achse fest
-
allowDecimals: Ob Dezimalstellen auf der Achse zulässig sind.
-
categories: Ein Array, die Kategorien der Achse.
-
plotLines: Hauptlinien zeichnen.
-
tickColor: Farbe der Teilstriche.
-
tickInterval: Der Schrittweitenwert für Teilstriche.
-
labels.rotation: Drehung in Grad für Teilstrichbeschriftungen.
Chart: Optionen für den Diagrammbereich
Mit den Chart-Optionen für den Diagrammbereich werden Eigenschaften des Diagrammbereichs festgelegt.
| Parameter | Beschreibung | Standardwert |
|---|---|---|
| backgroundColor | Hintergrundfarbe des Diagrammbereichs festlegen | #FFFFFF |
| borderWidth | Rahmenbreite des Diagramms festlegen | 0 |
| borderRadius | Eckenradius des Diagrammrahmens festlegen | 5 |
| renderTo | Der Container, in dem das Diagramm platziert wird. Normalerweise wird ein DIV in HTML platziert und der Wert des id-Attributs des DIV abgerufen. | null |
| defaultSeriesType | Die Standarddiagrammtypen sind line, spline, area, areaspline, column, bar, pie, scatter. | 0 |
| width | Die Diagrammbreite, die sich standardmäßig an die Breite des Diagrammcontainers anpasst. | null |
| height | Die Diagrammhöhe, die sich standardmäßig an die Höhe des Diagrammcontainers anpasst. | null |
| margin | Legt den Abstand zwischen dem Diagramm und anderen Elementen fest, ein Array, wie z. B. [0,0,0,0]. | [null] |
| plotBackgroundColor | Die Hintergrundfarbe des Hauptdiagrammbereichs, d. h. die Hintergrundfarbe des Bereichs, der von der X- und Y-Achse eingeschlossen wird. | null |
| plotBorderColor | Die Rahmenfarbe des Hauptdiagrammbereichs, d. h. die Rahmenfarbe des Bereichs, der von der X- und Y-Achse eingeschlossen wird. | null |
| plotBorderWidth | Die Rahmenbreite des Hauptdiagrammbereichs | 0 |
| shadow | Ob ein Schatten festgelegt werden soll; backgroundColor muss festgelegt werden. | false |
| reflow | Ob die Höhe und Breite des Diagrammbereichs automatisch angepasst werden sollen. Wenn Breite und Höhe nicht festgelegt sind, wird es an die Größe angepasst. | wahr |
| zoomType | Ziehen Sie die Maus, um zu zoomen, wobei entlang der x-Achse oder y-Achse skaliert wird; kann festgelegt werden auf: 'x', 'y', 'xy'. | '' |
| events | Ereignis-Callbacks, die Rückruffunktionen für die addSeries-Methode, die click-Methode, die load-Methode, die selection-Methode usw. unterstützen. |
Color: Farboptionen
Die Option Color wird verwendet, um das Farbschema des Diagramms festzulegen.
| Parameter | Beschreibung | Standardwert |
| color | Wird verwendet, um die Farben von Diagrammen wie Linien-/Säulen-/Kreisdiagrammen in Array-Form anzuzeigen. | array |
Highcharts bietet bereits standardmäßig mehrere Farbschemata. Wenn die anzuzeigenden Grafiken die Anzahl der Farbtypen überschreiten, beginnen die zusätzlichen Grafiken automatisch, ab dem ersten Farbschema auszuwählen. Methode zum Anpassen von Farbschemata:
Highcharts.setOptions({
colors: ['#058DC7', '#3273B4', '#ED561B', '#DDDF00', '#24CBE5', '#64A4E5', '#FF9655',
'#FFF263', '#6AB2F9']
});
Titel: Titeloptionen
Mit Titeloptionen werden Eigenschaften im Zusammenhang mit dem Diagrammtitel festgelegt.
| Parameter | Beschreibung | Standardwert |
|---|---|---|
| text | Textinhalt des Titels. | Diagrammtitel |
| align | Horizontaler Ausrichtungsmodus. | center |
| verticalAlign | Vertikaler Ausrichtungsmodus. | top |
| margin | Der Abstand zwischen Titel und Untertitel oder der Abstand zum Hauptdiagrammbereich. | 15 |
| floating | Gibt an, ob geschwebt werden soll. Wenn true, kann der Titel vom Hauptdiagrammbereich abweichen, was mit den Attributen x und y verwendet werden kann. | false |
| style | CSS-Stile festlegen. | {color: '#3E576F', fontSize: '16px'} |
Subtitle: Untertitel-Optionen
Die vom Untertitel bereitgestellten Attributoptionen sind ungefähr dieselben wie die des Titels. Sie können auf die oben aufgeführten Titeloptionen verweisen. Erwähnenswert ist, dass die Option text des Untertitels standardmäßig auf '' gesetzt ist, d. h. leer, sodass der Untertitel standardmäßig nicht angezeigt wird.
xAxis: Optionen der X-Achse.
Die Optionen der X-Achse werden verwendet, um Eigenschaften im Zusammenhang mit der X-Achse des Diagramms festzulegen.
| Parameter | Beschreibung | Standardwert |
|---|---|---|
| categories | Legt die Kategorienamen der X-Achse fest, Array, z. B. categories: ['Apples', 'Bananas', 'Oranges'] | [] |
| title | Name der X-Achse, unterstützt Attribute wie text, enabled, align, rotation, style usw. | |
| labels | Legt den Stil jedes Kategorienamens auf der X-Achse fest, wie style, formatter, rotation usw. | array |
| max | Der maximale Wert der X-Achse (wenn categories leer ist). Wenn null, wird der maximale Wert automatisch basierend auf den Daten der X-Achse ermittelt. | null |
| min | Der minimale Wert der X-Achse (wenn categories leer ist). Wenn null, wird der minimale Wert automatisch basierend auf den Daten der X-Achse ermittelt. | array |
| gridLineColor | Gitterfarbe (vertikale Linie) | #C0C0C0 |
| gridLineWidth | Gitterbreite (vertikale Linie) | 1 |
| lineColor | Grundlinienfarbe | #C0D0E0 |
| lineWidth | Grundlinienbreite | 0 |
yAxis: Optionen für die Y-Achse.
Die Optionen der Y-Achse sind grundsätzlich identisch mit den xAxis-Optionen oben. Bitte beziehen Sie sich auf die Parameter-Einstellungen in der Tabelle oben; sie werden nicht separat aufgeführt.
Series: Datenreihen-Optionen
Datenreihen-Optionen werden verwendet, um Eigenschaften festzulegen, die sich auf die im Diagramm anzuzeigenden Daten beziehen.
| Parameter | Beschreibung | Standardwert |
|---|---|---|
| data | Die im Diagramm angezeigten Datenreihen können im Array- oder JSON-Format vorliegen. Zum Beispiel: data:[0, 5, 3, 5], oder data: [{name: 'Point 1',y: 0}, {name: 'Point 2',y: 5}] |
'' |
| name | Anzeigen des Namens der Datenreihe. | '' |
| type | Datenreihentyp, unterstützt area, areaspline, bar, column, line, pie, scatter oder spline | line |
plotOptions: Optionen für Datenpunkte.
plotOptions wird verwendet, um Eigenschaften festzulegen, die sich auf Datenpunkte im Diagramm beziehen. Je nach Diagrammtyp variieren die Eigenschaftseinstellungen in plotOptions geringfügig; die allgemeinen Optionen sind unten aufgeführt.
| Parameter | Beschreibung | Standardwert |
| aktiviert | Ob Daten direkt auf Datenpunkten angezeigt werden sollen | false |
| allowPointSelect | Ob das Auswählen von Datenpunkten mit der Maus erlaubt werden soll | false |
| formatter | Callback-Funktion zum Formatieren des Inhalts der Datenanzeige | formatter: function() {return this.y;} |
Tooltip: Datenpunkt-Tooltip
Tooltip wird verwendet, um die Tooltip-Informationen festzulegen, die angezeigt werden, wenn die Maus über einen Datenpunkt fährt.
| Parameter | Beschreibung | Standardwert |
| aktiviert | Ob der Tooltip angezeigt werden soll. | wahr |
| backgroundColor | Legt die Hintergrundfarbe des Tooltips fest | rgba(255, 255, 255, .85) |
| borderColor | Die Rahmenfarbe des Tooltips, die standardmäßig automatisch an die Farbe der Datenreihe angepasst wird. | auto |
| borderRadius | Eckenradius des Tooltips. | 5 |
| shadow | Ob ein Tooltip-Schatten angezeigt werden soll | wahr |
| style | Legt den Inhaltsstil des Tooltips fest, z. B. Schriftfarbe usw. | color:'#333' |
| formatter | Callback-Funktion, die verwendet wird, um den Anzeigeinhalt des Tooltips zu formatieren. Der zurückgegebene Inhalt unterstützt HTML-Tags wie: <b>, <strong>, <i>, <em>, <br/>, <span>. | 2 |
Legende: Legendenoptionen
legend wird verwendet, um legendenspezifische Eigenschaften festzulegen.
| Parameter | Beschreibung | Standardwert |
|---|---|---|
| layout | Anzeigeform, unterstützt horizontal und vertikal. | horizontal |
| align | Ausrichtung. | center |
| backgroundColor | Hintergrundfarbe der Legende. | null |
| borderColor | Rahmenfarbe der Legende. | #909090 |
| borderRadius | Rahmenradius der Legende. | 5 |
| aktiviert | Ob die Legende angezeigt werden soll. | wahr |
| floating | Ob sie schweben kann; wird mit den Attributen x und y verwendet. | false |
| shadow | Ob ein Schatten angezeigt werden soll. | false |
| style | Stil des Legendeninhalts festlegen | '' |
Für detailliertere Informationen lesen Sie bitte die englische Dokumentation der offiziellen Highcharts-Website:http://api.highcharts.com/highcharts
Weitere Erweiterungen