overzicht
een cirkeldiagram dat in de browser wordt weergegeven met behulp van SVG of VML. Toont tooltips wanneer u met de muis over plakken zweeft.,
Voorbeeld
het Maken van een 3D-Cirkeldiagram
Als je de is3D
optie om de true
, yourpie grafiek worden getekend alsof het heeft drie dimensies:
is3D
false
standaard, dus hier willen we u er expliciet instellen true
:
het Maken van een Donut Grafiek
Een donut-diagram is een cirkeldiagram met een gat in het midden., U kunt donutdiagrammen maken met de pieHole
optie:
de pieHole
optie moet worden ingesteld op een getal tussen 0 en 1, overeenkomend met de verhouding van radii tussen het gat en de kaart. Getallen tussen 0.4 en 0.6 zullen er het beste uitzien op de meeste grafieken.Waarden gelijk aan of groter dan 1 zullen worden genegeerd, en een waarde van 0 zal je piehole volledig sluiten.
u kunt de opties pieHole
en is3D
niet combineren; als u dit doet, zal pieHole
worden genegeerd.,
merk op dat Google Charts probeert het label zo dicht mogelijk bij het midden van de slice te plaatsen. Als u een donutgrafiek met slechts één plakje hebt, kan het midden van het plakje in het donutgat vallen. In dat geval, verander de kleur van het label:
var options = { pieHole: 0.5, pieSliceTextStyle: { color: 'black', }, legend: 'none' };
een cirkeldiagram draaien
standaard beginnen cirkeldiagrammen met de linkerrand van de eerste slicepointing recht omhoog. U kunt dit wijzigen met pieStartAngle
optie:
Hier draaien we de grafiek 100 graden met de klok mee met een optie van pieStartAngle: 100
., (Zo gekozen omdat die particularangle toevallig het” Italiaanse ” label past in de plak.)
Exploderende een Stuk
U kunt afzonderlijke cirkelsegmenten van de rest van de tabel met de offset
eigendom van de slices
optie:
Om een slice, het maken van een slices
object en wijs de juiste segmentnummer een offset
tussen 0 en 1., Hieronder geven we geleidelijk grotere verschuivingen te plakjes 4 (Gujarati), 12 (Marathi), 14 (Oriya), en 15 (Punjabi):
Verwijderen van Segmenten
Voor het weglaten van een segment, het wijzigen van de colorto 'transparent'
:
We ook gebruik van de pieStartAngle
om te draaien van de grafiek 135degrees, pieSliceText
om de tekst te verwijderen uit theslices, en tooltip.trigger
uitschakelen knopinfo:
Segment Zichtbaarheid Drempel
U kunt een waarde instellen als u de drempel voor een cirkelsegment te renderen individueel., Deze waarde komt overeen met een fractie van de grafiek (waarbij de hele grafiek waarde 1 heeft). Om deze drempel als percentage van het geheel in te stellen, deelt u het gewenste percentage door 100 (voor een drempel van 20% zou de waarde 0,2 zijn).
sliceVisibilityThreshold: 5/8 // This is equivalent to 0.625 or 62.5% of the chart.
elke plak die kleiner is dan deze drempel zal worden gecombineerd tot een enkele” andere ” plak, en zal de gecombineerde waarde hebben van alle plakjes onder de drempel.
Laden
degoogle.charts.load
pakketnaam is"corechart"
.,
google.charts.load("current", {packages: });
de klassenaam van de visualisatie is google.visualization.PieChart
.
var visualization = new google.visualization.PieChart(container);
gegevensformaat
rijen: elke rij in de tabel vertegenwoordigt een slice.
kolommen:
configuratieopties
Naam | backgroundColor |
de achtergrondkleur voor het hoofdgebied van de grafiek. Kan een eenvoudige HTML-kleurreeks zijn, bijvoorbeeld: Type: tekenreeks of object
standaard:’white’
|
---|---|---|
achtergrondkleur.lijn |
De kleur van de kaartrand, als een HTML – kleurstring. Type: string
standaard:’ # 666 ‘
|
|
achtergrondkleur.strokeWidth |
de randbreedte, in pixels. Type: aantal
standaard: 0
|
|
achtergrondkleur.vul |
De kaartvulkleur in, als een HTML – kleurenreeks., Type: string
standaard:’white’
|
|
chartArea |
Een object met leden om de plaatsing en grootte van het diagramgebied te configureren (waar het diagram zelf wordt getekend, exclusief as en legendes). Twee formaten worden ondersteund: een getal, of een getal gevolgd door %. Een eenvoudig getal is een waarde in pixels; een getal gevolgd door % is een percentage. Voorbeeld: Type: object
standaard: null
|
|
chartArea.achtergrondkleur |
achtergrondkleur voor het diagramgebied., Wanneer een string wordt gebruikt, kan het een hex string zijn (bijvoorbeeld ‘#fdc’) of een Engelse Kleurnaam. Wanneer een object wordt gebruikt, kunnen de volgende eigenschappen worden opgegeven:
Type: tekenreeks of object
standaard:’white’
|
|
chartArea.left |
hoe ver de grafiek van de linkerrand moet worden getrokken., Type: Aantal of tekenreeks
standaard: auto
|
|
chartArea.top |
hoe ver de grafiek van de bovenrand moet worden getrokken. Type: Aantal of tekenreeks
standaard: auto
|
|
chartArea.breedte |
breedte van het diagramgebied. Type: Aantal of tekenreeks
standaard: auto
|
|
chartArea.hoogte |
hoogte van het diagramgebied. Type: Aantal of tekenreeks
standaard: auto
|
|
kleuren |
de te gebruiken kleuren voor de grafiekelementen., Een array van strings, waarbij elk element een HTML kleurstring is, bijvoorbeeld: Type: Array van tekenreeksen
standaard: standaardkleuren
|
|
enableInteractivity |
of het diagram gebruikersgebaseerde gebeurtenissen gooit of reageert op gebruikersinteractie. Als false, zal de grafiek niet gooien ‘select’ of andere interactie-gebaseerde gebeurtenissen (maar zal gooien klaar of fout gebeurtenissen), en zal niet hovertext weer te geven of anders veranderen, afhankelijk van de input van de gebruiker., Type: boolean
Default: true
|
|
lettergrootte |
De standaard lettergrootte, in pixels, van alle tekst in de grafiek. U kunt dit overschrijven met eigenschappen voor specifieke grafiekelementen. Type: aantal
standaard: automatisch
|
|
fontName |
het standaardlettertype voor alle tekst in de grafiek. U kunt dit overschrijven met eigenschappen voor specifieke grafiekelementen. Type: string
standaard: ‘Arial’
|
|
forceIFrame |
tekent de grafiek binnen een inline frame., (Merk op dat op IE8, deze optie wordt genegeerd; alle IE8 grafieken worden getekend in I-frames.) Type: boolean
standaard: false
|
|
hoogte |
hoogte van de grafiek, in pixels. Type: nummer
standaard: hoogte van het element
|
|
is3D |
indien waar, geeft een driedimensionaal diagram weer. Type: boolean
standaard: false
|
|
legenda |
Een object met leden om verschillende aspecten van de legende in te stellen., Om de eigenschappen van dit object te specificeren, kunt u object-letterlijke notatie gebruiken, zoals hier getoond: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Type: object
standaard: null
|
legenda.uitlijning |
uitlijning van de legenda. Kan een van de volgende zijn:
begin, Midden en einde zijn relatief aan de stijl — verticaal of horizontaal — van de legenda. Bijvoorbeeld, in een’ right ‘legend,’ start ‘en’ end ‘zijn aan de boven-en onderkant, respectievelijk; voor een’ top ‘ legend,’ start ‘en’ end ‘ zou aan de linker-en rechterkant van het gebied, respectievelijk. De standaardwaarde hangt af van de positie van de legenda. Voor’ bottom ‘legends is de standaard ‘center’; andere legends zijn standaard’start’. Type: tekenreeks
standaard: automatisch
|
legenda.positie |
positie van de legenda., Kan een van de volgende zijn:
Type: string
standaard: ‘right’
|
|
legenda.maxLines |
Maximum aantal regels in de legenda. Stel dit in op een getal groter dan één om regels toe te voegen aan je legende., Opmerking: de exacte logica die wordt gebruikt om het werkelijke aantal weergegeven lijnen te bepalen is nog steeds in flux. Deze optie werkt momenteel alleen als legenda.positie is ‘top’. Type: aantal
standaard: 1
|
|
legenda.tekststijl |
Een object dat de tekststijl van de legenda specificeert. Het object heeft dit formaat: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } de Type: object
standaard:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
|
pieHole |
indien tussen 0 en 1 een donutdiagram wordt weergegeven. Het gat met een straal gelijk aan Type: aantal
standaard: 0
|
|
pieSliceBorderColor |
De kleur van de sliceranden. Alleen van toepassing wanneer de grafiek tweedimensionaal is., Type: string
standaard:’white’
|
|
pieslicetekst |
de inhoud van de tekst die op het slice wordt weergegeven. Kan een van de volgende zijn:
Type: string
standaard: ‘percentage’
|
|
pieSliceTextStyle |
Een object dat de stijl van de slice-tekst specificeert., Het object heeft dit formaat: {color: <string>, fontName: <string>, fontSize: <number>} de Type: object
standaard:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
|
pieStartAngle |
de hoek, in graden, om de grafiek te draaien. De standaardwaarde van Type: number
standaard:
0 |
|
reverseCategories |
indien waar, tekent slices tegen de klok in. De standaard is om met de klok mee te tekenen. Type: boolean
Default: false
|
|
pieResidueSliceColor |
kleur voor de combinatie slice die alle slices onder slicevisibility drempel houdt., Type: string
Default: ‘# ccc ‘
|
|
pieResidueSliceLabel |
een label voor de combinatie slice die alle slices onder slicevisibility drempel houdt. Type: string
standaard: ‘Other’
|
|
slices |
een array van objecten, die elk het formaat van de corresponderende slice in de pie beschrijven. Om de standaardwaarden voor een slice te gebruiken, geeft u een leeg object op (d.w.z.
u kunt een array van objecten opgeven, die elk van toepassing zijn op de slice in de gegeven volgorde, of u kunt een object opgeven waarbij elk kind een numerieke sleutel heeft die aangeeft op welke slice het van toepassing is. De volgende twee declaraties zijn bijvoorbeeld identiek en verklaren de eerste slice als zwart en de vierde als rood: slices: slices: {0: {color: 'black'}, 3: {color: 'red'}} Type: Array van objecten, of object met geneste objecten
standaard: {}
|
|
slicevisibility drempel |
de fractionele waarde van de pie, waaronder een slice niet individueel tonen., Alle plakjes die deze drempel niet hebben overschreden, worden gecombineerd tot een enkele” andere ” plak, waarvan de grootte de som is van al hun maten. Standaard is niet om afzonderlijk een slice die kleiner is dan een halve graad. // Slices less than 25% of the pie will be// combined into an "Other" slice.sliceVisibilityThreshold: .25 Type: number
Standaard: halve graad (.5/360 of 1/720 of .0014)
|
|
titel |
tekst die boven de grafiek moet worden weergegeven. Type: string
standaard: geen titel
|
|
titeltekststijl |
Een object dat de tekststijl van de titel specificeert., 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., Om de eigenschappen van dit object te specificeren, kunt u object letterlijke notatie gebruiken, zoals hier getoond: {textStyle: {color: '#FF0000'}, showColorCode: true} Type: object
standaard: null
|
tooltip.ignoreBounds |
indien ingesteld op Opmerking: Dit is alleen van toepassing op HTML-tooltips. Als dit is ingeschakeld met SVG tooltips, zal elke overloop buiten de grafiekgrenzen worden bijgesneden. Zie tekstballon aanpassen voor meer informatie., Type: boolean
standaard: false
|
tooltip.isHtml |
indien ingeschakeld, gebruik HTML-gerenderde (in plaats van SVG-gerenderde) tooltips. Zie tekstballon aanpassen voor meer informatie. opmerking: het aanpassen van de html-tooltip-inhoud via de functie tooltip-kolomgegevens wordt niet ondersteund door de weergave van de bellengrafiek. Type: boolean
standaard: false
|
|
tooltip.toon kleurcode |
indien waar, toon gekleurde vierkantjes naast de slice-informatie in de tooltip., Type: boolean
standaard: false
|
|
tooltip.tekst |
welke informatie moet worden weergegeven wanneer de gebruiker over een taartpunt zweeft. De volgende waarden worden ondersteund:
Type: string
standaard: ‘both’
|
|
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 |
de gebruikersinteractie die ervoor zorgt dat de tooltip wordt weergegeven:
Type: string
standaard:’focus’
|
|
breedte |
breedte van de grafiek, in pixels., Type: aantal
standaard: breedte van het element
|
Methods
Method | |
---|---|
draw(data, options)
|
tekent de grafiek. De grafiek accepteert verdere methodeaanroepen alleen nadat de gebeurtenis Return Type: none
|
getAction(actionID) |
|
getBoundingBox(id) |
|
getChartAreaBoundingBox() |
geeft een object terug dat links, boven, breedte en hoogte van de inhoud van de grafiek bevat (d.w.z., exclusief labels en legenda):
Waarden zijn ten opzichte van de container van de grafiek. Bel dit nadat de grafiek is getekend. Return Type: object
|
getChartLayoutInterface() |
geeft een object met informatie over de plaatsing op het scherm van de grafiek en de elementen., De volgende methoden kunnen worden aangeroepen op het geretourneerde object:
Oproep nadat de grafiek getekend. Return Type: object
|
getHAxisValue(position, optional_axis_index) |
|
getImageURI() |
geeft de seriële grafiek terug als een image-URI. Roep dit aan nadat de grafiek is getekend. zie PNG-diagrammen afdrukken. Return Type: string
|
getSelection() |
geeft een array van de geselecteerde grafiekentiteiten terug. Selecteerbare entiteiten zijn slices en legend entries. Voor deze grafiek kan op een bepaald moment slechts één entiteit worden geselecteerd., Return Type: Array of selection elements
|
getVAxisValue(position, optional_axis_index) |
|
getXLocation(position, optional_axis_index) |
|
getYLocation(position, optional_axis_index) |
|
removeAction(actionID) |
setAction(action)
|
stelt een tooltip-actie in die moet worden uitgevoerd wanneer de gebruiker op de actietekst klikt. de methode alle tooltip-acties moeten worden ingesteld voordat de methode Return Type:
none |
setSelection()
|
selecteert de opgegeven chart-entiteiten. Annuleert elke eerdere selectie. Selecteerbare entiteiten zijn slices en legend entries. Voor deze grafiek kan slechts één entiteit tegelijk worden geselecteerd. Return Type: none
|
clearChart() |
wist de grafiek en geeft alle toegewezen bronnen vrij. Return Type: none
|
Events
voor meer informatie over het gebruik van deze events, zie Basic Interactivity, Handling Events, and Firing Events.
Name | |
---|---|
click
|
afgevuurd wanneer de gebruiker in de grafiek klikt., Kan worden gebruikt om te identificeren wanneer op de titel, gegevenselementen, legenda-items, Assen, rasterlijnen of labels wordt geklikt. eigenschappen: targetID
|
error |
afgevuurd wanneer er een fout optreedt bij het weergeven van de grafiek. eigenschappen: id, message
|
onmouseover |
afgevuurd wanneer de gebruiker over een visuele entiteit beweegt. Geeft de rij – en kolomindices van het overeenkomstige gegevenstabel-element terug. Een slice-of legenda-ingang correleert met een rij in de gegevenstabel (kolomindex is null)., eigenschappen: rij, kolom
|
afgevuurd wanneer de gebruiker zich van een visuele entiteit verwijdert. Geeft de rij – en kolomindices van het overeenkomstige gegevenstabel-element terug. Een slice-of legenda-ingang correleert met een rij in de gegevenstabel (kolomindex is null). eigenschappen: rij, kolom
|
|
het diagram is gereed voor externe methodeaanroepen., Als u wilt interageren met de grafiek en de aanroepmethoden nadat u deze hebt getekend, moet u een luisteraar instellen voor deze gebeurtenis voordat u de eigenschappen: none
|
select |
afgevuurd wanneer de gebruiker op een visuele entiteit klikt. Om te weten te komen wat er is geselecteerd, roep Eigenschappen: geen
|
gegevensbeleid
alle code en gegevens worden verwerkt en gerenderd in de browser., Er worden geen gegevens naar een server verzonden.