Übersicht
Ein Kreisdiagramm, das im Browser mit SVG oder VML gerendert wird. Zeigt Tooltips an, wenn Sie mit der Maus über Slices fahren.,
Beispiel
Erstellen eines 3D-Kreisdiagramms
Wenn Sie die Option is3D
auf true
setzen, wird Ihrpie-Diagramm so gezeichnet, als hätte es drei Dimensionen:
is3D
ist false
von standard, also hier setzen wir es explizit auf true
:
Erstellen eines Donut-Diagramms
Ein Donut-Diagramm ist ein Kreisdiagramm mit einem Loch in der Mitte., Youcan erstellen Sie donut-Diagramme mit dem pieHole
option:
pieHole
option sollte gesetzt werden, um eine Zahl zwischen 0and 1, entsprechend dem Verhältnis der Radien zwischen der Bohrung und thechart. Zahlen zwischen 0.4 und 0.6 sehen in den meisten Charts am besten aus.Werte gleich oder größer als 1 werden ignoriert, und ein Wert von 0wird Ihr Piehole vollständig schließen.
Sie können die Optionen pieHole
und is3D
nicht kombinieren; Wenn Sie dies tun, wird pieHole
ignoriert.,
Beachten Sie, dass Google Charts versucht, das Label so nah wie möglich am Slice-Center zu platzieren. Wenn Sie ein Donut-Diagramm mit nur einer Scheibe haben, kann die Mitte der Scheibe in das Donut-Loch fallen. Ändern Sie in diesem Fall die Farbe des Etiketts:
var options = { pieHole: 0.5, pieSliceTextStyle: { color: 'black', }, legend: 'none' };
Drehen eines Kreisdiagramms
Standardmäßig beginnen Kreisdiagramme mit dem linken Rand des ersten slicepointing gerade nach oben. Sie können das mit der pieStartAngle
Option ändern:
Hier drehen wir das Diagramm im Uhrzeigersinn um 100 Grad mit der Optionof pieStartAngle: 100
., (So gewählt, weil dieses particularangle zufällig das“ italienische “ Etikett in das Slice passt.)
Explodieren eines Slices
Mit der offset
– Eigenschaft der slices
– Option können Sie Tortenscheiben vom Rest des Diagramms trennen:
Um ein Slice zu trennen, erstellen Sie ein slices
– Objekt und weisen Sie der entsprechenden Slice-Nummer eine offset
zwischen 0 und 1., Im Folgenden weisen wir den Slices 4 (Gujarati), 12 (Marathi), 14 (Oriya) und 15 (Punjabi) schrittweise größere Offsets zu:
Slices entfernen
Um ein Slice wegzulassen, ändern Sie das colorto 'transparent'
:
Wir haben auch die pieStartAngle
verwendet, um das Diagramm 135degrees zu drehen, pieSliceText
um den Text aus theslices zu entfernen, und tooltip.trigger
um Tooltips zu deaktivieren:
Slice Visibility Threshold
Sie können einen Wert als Schwellenwert für ein pie slice festlegen, das einzeln gerendert werden soll., Dieser Wert entspricht einem Bruchteil des Diagramms (wobei das gesamte Diagramm den Wert 1 hat). Um diesen Schwellenwert als Prozentsatz des Ganzen festzulegen, teilen Sie den gewünschten Prozentsatz durch 100 (bei einem Schwellenwert von 20% wäre der Wert 0, 2).
sliceVisibilityThreshold: 5/8 // This is equivalent to 0.625 or 62.5% of the chart.
Alle Slices, die kleiner als dieser Schwellenwert sind, werden zu einem einzigen“ Anderen “ Slice kombiniert und haben den kombinierten Wert aller Slices unterhalb des Schwellenwerts.
Laden
Diegoogle.charts.load
paket name ist"corechart"
.,
google.charts.load("current", {packages: });
Der Klassenname der Visualisierung lautet google.visualization.PieChart
.
var visualization = new google.visualization.PieChart(container);
Datenformat
Zeilen: Jede Zeile in der Tabelle repräsentiert einen Slice.
Spalten:
Konfigurationsoptionen
Name | |
---|---|
backgroundColor |
Die Hintergrundfarbe für den Hauptbereich des Diagramms. Kann entweder eine einfache HTML-Farbzeichenfolge sein, z. B.: Type: string oder object
Default: ‚white‘
|
Hintergrundfarbe.strich |
Die Farbe des Diagrammrandes als HTML-Farbzeichenfolge. Typ: Zeichenfolge
Default: ‚#666‘
|
Hintergrundfarbe.strokeWidth |
Die Randbreite in Pixel. – Typ: Anzahl
Standardeinstellung: 0
|
Hintergrundfarbe.füllen Sie |
Die Diagrammfüllfarbe als HTML-Farbzeichenfolge aus., Typ: Zeichenfolge
Default: ‚white‘
|
chartArea |
Ein Objekt mit den Mitgliedern zu konfigurieren, die Platzierung und die Größe der Diagrammfläche (in denen das Diagramm selbst gezeichnet, ohne Achse und Legenden). Es werden zwei Formate unterstützt: eine Zahl oder eine Zahl gefolgt von %. Eine einfache Zahl ist ein Wert in Pixel; eine Zahl, gefolgt von % ist ein Prozentsatz. Beispiel: Typ: Objekt
Voreinstellung: null
|
chartArea.Hintergrundfarbe |
Hintergrundfarbe des Diagrammbereichs., Wenn eine Zeichenfolge verwendet wird, kann es sich entweder um eine Hex-Zeichenfolge (z. B. ‚#fdc‘) oder einen englischen Farbnamen handeln. Wenn ein Objekt verwendet wird, können die folgenden Eigenschaften bereitgestellt werden:
Typ: String oder Objekt
Standard: ‚weiß‘
|
ChartArea.links |
Wie weit das Diagramm vom linken Rand aus gezeichnet werden soll., Typ: numerisch oder Zeichenfolge
Voreinstellung: auto
|
chartArea.top |
Wie weit das Diagramm vom oberen Rand entfernt ist. Typ: numerisch oder Zeichenfolge
Voreinstellung: auto
|
chartArea.breite |
Breite des Diagrammbereichs. Typ: numerisch oder Zeichenfolge
Voreinstellung: auto
|
chartArea.höhe |
Diagramm bereich höhe. Typ: numerisch oder Zeichenfolge
Voreinstellung: auto
|
Farben |
Die Farben für die Elemente des Diagramms., Ein Array von Strings, wobei jedes Element eine HTML-Farbzeichenfolge ist, zum Beispiel: Typ: Array von Zeichenfolgen
Standard: Standardfarben
|
enableInteractivity |
Ob das Diagramm benutzerbasierte Ereignisse auslöst oder auf Benutzerinteraktion reagiert. Wenn false, löst das Diagramm keine „select“ -oder andere interaktionsbasierte Ereignisse aus (sondern löst Ready-oder Fehlerereignisse aus) und zeigt keinen Hovertext an oder ändert sich auf andere Weise abhängig von der Benutzereingabe., Typ: boolean
Standard: true
|
FontSize |
Die Standardschriftgröße des gesamten Textes im Diagramm in Pixel. Sie können dies mithilfe von Eigenschaften für bestimmte Diagrammelemente überschreiben. – Typ: Anzahl
Standardeinstellung: Automatik
|
fontName |
Die Standard-schriftart für den gesamten text in der Tabelle. Sie können dies mithilfe von Eigenschaften für bestimmte Diagrammelemente überschreiben. Typ: Zeichenfolge
Default: ‚Arial‘
|
forceIFrame |
Zeichnet das Diagramm in einem inline-frame., (Beachten Sie, dass diese Option in IE8 ignoriert wird; Alle IE8-Diagramme werden in i-Frames gezeichnet.) – Typ: boolean
Standardeinstellung: false
|
Höhe |
Höhe der Grafik in Pixeln. – Typ: Anzahl
Standard: Höhe des enthaltenden Elements
|
is3D |
Wenn true, zeigt ein dreidimensionales Diagramm. Type: boolean
Default: false
|
legend |
Ein Objekt mit Mitgliedern, um verschiedene Aspekte der Legende zu konfigurieren., Um Eigenschaften dieses Objekts anzugeben, können Sie die Objektliteralnotation verwenden, wie hier gezeigt: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Type: object
Default: null
|
legend.Ausrichtung |
Ausrichtung der Legende. Kann einer der folgenden sein:
Anfang, Mitte und Ende sind im Vergleich zu den Stil-vertikal oder horizontal-von der Legende. In einer „rechten“ Legende befinden sich beispielsweise „Start“ und „Ende“ oben bzw. unten; Für eine „obere“ Legende befinden sich „Start“ und „Ende“ links bzw. rechts vom Bereich. Der Standardwert hängt von der Position der Legende ab. Für‘ bottom ‚Legenden ist der Standardwert ‚center‘; andere Legenden standardmäßig ’start‘. Typ: Zeichenfolge
Standardeinstellung: Automatik
|
Legende.position |
die Position der Legende., Kann eine der folgenden sein:
Typ: Zeichenfolge
Default: ‚right‘
|
Legende.maxLines |
Maximale Anzahl von Zeilen in der Legende. Setzen Sie dies auf eine Zahl größer als eins, um Ihrer Legende Zeilen hinzuzufügen., Hinweis: Die genaue Logik zur Bestimmung der tatsächlichen Anzahl der gerenderten Zeilen ist noch im Fluss. Diese Option funktioniert derzeit nur, wenn Legende.position „oben“. – Typ: Anzahl
Standardeinstellung: 1
|
Legende.TextStyle |
Ein Objekt, das den Textstil der Legende angibt. Das Objekt hat dieses Format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } Die Typ: objekt
Standard:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
pieHole |
Wenn zwischen 0 und 1, zeigt eine donut diagramm. Das Loch mit einem Radius gleich – Typ: Anzahl
Standardeinstellung: 0
|
pieSliceBorderColor |
Die Farbe der Scheibe-Grenzen. Nur anwendbar, wenn das Diagramm zweidimensional ist., Typ: Zeichenfolge
Default: ‚white‘
|
pieSliceText |
Der Inhalt des Textes angezeigt, die auf der Scheibe. Kann einer der folgenden sein:
Typ: Zeichenfolge
Default: ‚Prozentsatz‘
|
pieSliceTextStyle |
Ein Objekt, das angibt, der slice-text-Stil., Das Objekt hat dieses Format: {color: <string>, fontName: <string>, fontSize: <number>} Die Typ: Objekt
Voreinstellung:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
pieStartAngle |
Der Winkel (in Grad), um das Diagramm zu drehen durch. Der Standardwert von – Typ: Anzahl
Voreinstellung:
0 |
reverseCategories |
Wenn true, dann zieht Scheiben gegen den Uhrzeigersinn. Standardmäßig wird im Uhrzeigersinn gezeichnet. – Typ: boolean
Standardeinstellung: false
|
pieResidueSliceColor |
die Farbe für die Kombination slice enthält alle Scheiben unten sliceVisibilityThreshold., Typ: Zeichenfolge
Default: ‚#ccc‘
|
pieResidueSliceLabel |
Eine Bezeichnung für die Kombination slice enthält alle Scheiben unten sliceVisibilityThreshold. Type: string
Default: ‚Other‘
|
slices |
Ein Array von Objekten, die jeweils das Format des entsprechenden Slices im Kuchen beschreiben. Um Standardwerte für ein Slice zu verwenden, geben Sie ein leeres Objekt an (z. B.
Sie können entweder ein Array von Objekten angeben, von denen jedes in der angegebenen Reihenfolge auf das Slice zutrifft, oder Sie können ein Objekt angeben, bei dem jedes Kind über einen numerischen Schlüssel verfügt, der angibt, auf welches Slice es zutrifft. Beispielsweise sind die folgenden zwei Deklarationen identisch und deklarieren das erste Slice als schwarz und das vierte als rot: slices: slices: {0: {color: 'black'}, 3: {color: 'red'}} Type: Array of objects oder Objekt mit verschachtelten Objekten
Default: {}
|
slicevisibilitytytheshold |
Der Bruchwert des Tortens, unter dem ein Slice nicht einzeln angezeigt wird., Alle Slices, die diesen Schwellenwert nicht überschritten haben, werden zu einem einzigen „anderen“ Slice kombiniert, dessen Größe die Summe aller ihrer Größen ist. Standardmäßig wird kein Slice einzeln angezeigt, der kleiner als ein halbes Grad ist. // Slices less than 25% of the pie will be// combined into an "Other" slice.sliceVisibilityThreshold: .25 – Typ: Anzahl
Standardeinstellung: ein Halbes Grad (.5/360 oder 1/720 oder .0014)
|
Titel |
Text, der über dem Diagramm angezeigt werden soll. Typ: Zeichenfolge
Default: no title
|
titleTextStyle |
Ein Objekt, das angibt, den Titel-text-Stil., The object has this format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } The Type: object
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
tooltip |
An object with members to configure various tooltip elements., Um Eigenschaften dieses Objekts anzugeben, können Sie die Objektliteralnotation verwenden, wie hier gezeigt: {textStyle: {color: '#FF0000'}, showColorCode: true} Type: object
Default: null
|
tooltip.ignoreBounds |
Wenn auf Hinweis: Dies gilt nur für HTML Tooltips. Wenn dies mit SVG-Tooltips aktiviert ist, wird jeder Überlauf außerhalb der Diagrammgrenzen abgeschnitten. Weitere Informationen finden Sie unter Anpassen von Tooltip-Inhalten., – Typ: boolean
Standardeinstellung: false
|
tooltip.isHtml |
Wenn auf true gesetzt, verwenden Sie HTML-gerenderte (anstatt SVG-gerenderte) Tooltips. Weitere Informationen finden Sie unter Anpassen von Tooltip-Inhalten. Hinweis: Die Anpassung des HTML-Tooltip-Inhalts über die Rolle Tooltip-Spaltendaten wird von der Blasendiagrammvisualisierung nicht unterstützt. – Typ: boolean
Standardeinstellung: false
|
tooltip.showColorCode |
Wenn true, zeigen Sie farbige Quadrate neben den Slice-Informationen im Tooltip an., – Typ: boolean
Standardeinstellung: false
|
tooltip.text |
Welche Informationen angezeigt werden sollen, wenn der Benutzer den Mauszeiger über eine Tortenscheibe bewegt. Die folgenden Werte werden unterstützt:
Typ: Zeichenfolge
Default: ‚beide‘
|
tooltip.,textStyle |
An object that specifies the tooltip text style. The object has this format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } The Type: object
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
tooltip.,trigger |
Die Benutzerinteraktion, durch die der Tooltip angezeigt wird:
Typ: Zeichenfolge
Default: ‚focus‘
|
Breite |
Breite der Grafik in Pixeln., – Typ: Anzahl
Standard: Breite des enthaltenden Elements
|
Methoden
Methode | |
---|---|
draw(data, options) |
Zieht das Diagramm. Das Diagramm akzeptiert weitere Methodenaufrufe erst, nachdem das Ereignis Rückgabetyp: none
|
getAction(actionID) |
Gibt das Tooltip-Aktionsobjekt mit der angeforderten Rückgabetyp: Objekt
|
getBoundingBox(id) |
Gibt ein Objekt zurück, das das linke, obere, Breite und Höhe des Diagrammelements enthält
die Werte sind relativ zum container des Diagramms. Rufen Sie dies auf, nachdem das Diagramm gezeichnet wurde. Rückgabetyp: Objekt
|
getChartAreaBoundingBox() |
Gibt ein Objekt zurück, das den linken, oberen, breiten und Höheninhalt des Diagramms enthält (dh,, ohne Etiketten und der Legende):
Die Werte sind relativ zum container des Diagramms. Rufen Sie dies auf, nachdem das Diagramm gezeichnet wurde. Rückgabetyp: Objekt
|
getChartLayoutInterface() |
Gibt ein Objekt zurück, das Informationen über die Platzierung des Diagramms auf dem Bildschirm und seine Elemente enthält., Für das zurückgegebene Objekt können folgende Methoden aufgerufen werden:
Rufen Sie dies nach dem Zeichnen des Diagramms auf. Rückgabetyp: Objekt
|
getHAxisValue(position, optional_axis_index) |
Gibt den logischen horizontalen Wert bei Beispiel: Rufen Sie dies auf, nachdem das Diagramm gezeichnet wurde. Rückgabetyp: number
|
getImageURI() |
Gibt das Diagramm serialisiert als Bild-URI. Rufen Sie dies auf, nachdem das Diagramm gezeichnet wurde. Siehe Drucken von PNG-Diagrammen. Rückgabetyp: string
|
getSelection() |
Gibt ein array der ausgewählten Diagramm Personen. Auswählbare Entitäten sind Slices und Legendeneinträge. Für dieses Diagramm kann zu einem bestimmten Zeitpunkt nur eine Entität ausgewählt werden., Rückgabetyp: Array von Auswahlelementen
|
getVAxisValue(position, optional_axis_index) |
Gibt den logischen vertikalen Wert bei Beispiel: Rufen Sie dies auf, nachdem das Diagramm gezeichnet wurde. Rückgabetyp: number
|
getXLocation(position, optional_axis_index) |
Gibt die Bildschirm-x-Koordinate von Beispiel: Rufen Sie dies auf, nachdem das Diagramm gezeichnet wurde. Rückgabetyp: number
|
getYLocation(position, optional_axis_index) |
Gibt die Bildschirm-y-Koordinate von Beispiel: Rufen Sie dies auf, nachdem das Diagramm gezeichnet wurde. Rückgabetyp: number
|
removeAction(actionID) |
Entfernt die tooltip-Aktion mit den angeforderten Rückgabetyp:
none |
setAction(action) |
Legt eine Tooltip-Aktion fest, die ausgeführt werden soll, wenn der Benutzer auf den Aktionstext klickt. Die Alle Tooltip-Aktionen sollten vor dem Aufruf der Rückgabetyp:
none |
setSelection() |
Wählt die angegebene Diagramm Personen. Bricht jede vorherige Auswahl ab. Auswählbare Entitäten sind Slices und Legendeneinträge. Für dieses Diagramm kann jeweils nur eine Entität ausgewählt werden. Rückgabetyp: keiner
|
clearChart() |
Löscht das Diagramm, und gibt alle seine Ressourcen zugewiesen. Rückgabetyp: none
|
Ereignisse
Weitere Informationen zur Verwendung dieser Ereignisse finden Sie unter Grundlegende Interaktivität, Umgang mit Ereignissen und Auslösen von Ereignissen.
Name | |
---|---|
click |
Ausgelöst, wenn der Benutzer innerhalb des Diagramms., Kann verwendet werden, um zu identifizieren, wann auf Titel, Datenelemente, Legendeneinträge, Achsen, Gitterlinien oder Beschriftungen geklickt wird. Eigenschaften: targetID
|
error |
Wird ausgelöst, wenn beim Rendern des Diagramms ein Fehler auftritt. Eigenschaften: id, message
|
onmouseover |
wird Ausgelöst, wenn der Benutzer die Maus über einen visuellen Einheit. Übergibt die Zeilen – und Spaltenindizes des entsprechenden Datentabellenelements zurück. Ein Slice-oder Legendeneintrag korreliert mit einer Zeile in der Datentabelle (Spaltenindex ist null)., Eigenschaften: Zeile, Spalte
|
onmouseout |
wird Ausgelöst, wenn der Benutzer die Maus Weg von einer visuellen Einheit. Übergibt die Zeilen – und Spaltenindizes des entsprechenden Datentabellenelements zurück. Ein Slice-oder Legendeneintrag korreliert mit einer Zeile in der Datentabelle (Spaltenindex ist null). Eigenschaften: Zeile, Spalte
|
ready |
Das Diagramm ist bereit für externe Methodenaufrufe., Wenn Sie mit dem Diagramm interagieren und Methoden aufrufen möchten, nachdem Sie es gezeichnet haben, sollten Sie einen Listener für dieses Ereignis einrichten, bevor Sie die Eigenschaften: keine
|
select |
wird Ausgelöst, wenn der Benutzer auf einer visuellen Einheit. Um zu erfahren, was ausgewählt wurde, rufen Sie Eigenschaften: none
|
Datenrichtlinie
Alle Codes und Daten werden im Browser verarbeitet und gerendert., Es werden keine Daten an einen Server gesendet.