áttekintés
egy kördiagram, amely a böngészőben SVG vagy VML segítségével jelenik meg. Megjeleníti az eszköztippeket, amikor a szeletekre mutat.,
Példa
, Hogy egy 3D-s kördiagramot
Ha az is3D
lehetőséget, hogy a true
, yourpie diagram sorsolunk ki, mintha három méretek: is3D
false
alapértelmezés szerint, ezért itt kifejezetten beállítani, hogy a true
:
, Hogy egy Fánk Táblázat
A fánk diagram egy kördiagram egy lyuk a közepén., A pieHole
opció:
a pieHole
opciót 0 és 1 közötti számra kell állítani, amely megfelel a lyuk és a thechart közötti sugár arányának. A 0,4-0,6 közötti számok a legtöbb grafikonon a legjobban néznek ki.Az 1-gyel egyenlő vagy annál nagyobb értékeket figyelmen kívül hagyják, a 0 érték pedig teljesen bezárja a piehole-t.
nem lehet kombinálni a pieHole
és is3D
opciók; ha igen, pieHole
figyelmen kívül kell hagyni.,
vegye figyelembe, hogy a Google Charts megpróbálja a címkét a lehető legközelebb helyezni a szelet középpontjához. Ha van egy fánk diagram justone szelet, a közepén a szelet eshet a fánk lyuk. Ebben az esetben változtassa meg a címke színét:
var options = { pieHole: 0.5, pieSliceTextStyle: { color: 'black', }, legend: 'none' };
kördiagram forgatása
alapértelmezés szerint a kördiagramok az első szelet bal szélével kezdődnekkointing egyenesen felfelé. Ezt a pieStartAngle
opcióval módosíthatja:
itt a diagramot az óramutató járásával megegyező irányban 100 fokkal forgatjuk a pieStartAngle: 100
opcióval., (Azért választották így, mert ez a különlegesség előfordul, hogy az” olasz ” címke illeszkedik a szeletbe.)
a táblázat többi részétől a offset
slices
opció:
egy szelet elválasztásához hozzon létre egy slices
objektumot, majd rendelje hozzá a megfelelő szeletszám a offset
0 és 1 között., Az alábbiakban, akkor rendelje fokozatosan nagyobb ellensúlyozza, hogy a szeletek 4 (Gudzsaráti), 12 (Marathi), 14 (Oriya), illetve 15 (Pandzsábi):
Eltávolítása Szelet
elhagyására, a szelet, a változás a colorto 'transparent'
:
Mi is használták a pieStartAngle
forgatni a diagram 135degrees, pieSliceText
, hogy távolítsa el a szöveget theslices, valamint tooltip.trigger
letiltásához tippek:
Szelet Láthatósági Küszöb
megadhat egy értéket, mint a küszöbérték egy szelet pite, hogy tegyék külön-külön., Ez az érték a diagram töredékének felel meg (az egész diagram értéke 1). Ha ezt a küszöböt az egész százalékában szeretné beállítani, ossza meg a kívánt százalékot 100-mal (20% – os küszöbérték esetén az érték 0,2 lenne).
sliceVisibilityThreshold: 5/8 // This is equivalent to 0.625 or 62.5% of the chart.
Az ennél a küszöbértéknél kisebb szeleteket egyetlen” más ” szeletre kombináljuk, és az összes szelet kombinált értéke a küszöbérték alatt lesz.
Loading
The google.charts.load
A Csomag neve"corechart"
.,
google.charts.load("current", {packages: });
a vizualizáció osztályneve google.visualization.PieChart
.
var visualization = new google.visualization.PieChart(container);
adatformátum
sorok: a táblázat minden sora egy szelet.
oszlopok:
konfigurációs beállítások
Név | |
---|---|
backgroundColor |
a diagram fő területének háttérszíne. Lehet egy egyszerű HTML szín karakterlánc, például: Típus: string vagy object
alapértelmezett: “white”
|
backgroundColor.löket |
a szín a diagram határ, mint egy HTML szín karakterlánc. Típus: string
alapértelmezett: ‘# 666 ‘
|
backgroundColor.strokeWidth |
a határszélesség, képpontokban. Típus: szám
alapértelmezett: 0
|
backgroundColor.töltse ki a |
a diagram kitöltési színét HTML színláncként., Típus: string
alapértelmezett: ‘fehér’
|
chartArea |
egy tagokkal rendelkező objektum a diagramterület elhelyezésének és méretének konfigurálásához (ahol maga a diagram húzódik, a tengelyek és a legendák kivételével). Két formátum támogatott: egy szám, vagy egy szám, amelyet %követ. Egy egyszerű szám egy érték pixelben; egy szám, amelyet % követ, egy százalék. Példa: Típus: object
alapértelmezett: null
|
chartArea.backgroundColor |
Chart terület háttér színe., Ha egy karakterláncot használnak, akkor lehet egy hexadecimális karakterlánc (például “#FDC”) vagy egy angol színnév. Objektum használatakor a következő tulajdonságok adhatók:
Típus: karakterlánc vagy objektum
alapértelmezett: “fehér”
|
chartArea.balra |
milyen messze kell felhívni a diagramot a bal szélről., Típus: szám vagy karakterlánc
alapértelmezett: auto
|
chartArea.top |
meddig kell felhívni a táblázatot a felső határ. Típus: szám vagy karakterlánc
alapértelmezett: auto
|
chartArea.szélesség |
diagram terület szélessége. Típus: szám vagy karakterlánc
alapértelmezett: auto
|
chartArea.magasság |
diagram terület magassága. Típus: szám vagy karakterlánc
alapértelmezett: auto
|
színek |
a diagramelemekhez használt színek., Egy sor karakterlánc, ahol minden elem egy HTML színű karakterlánc, például: Típus: karakterláncok tömbje
alapértelmezett: alapértelmezett színek
|
enableInteractivity |
hogy a diagram felhasználói eseményeket dob-e, vagy reagál-e a felhasználói interakcióra. Ha hamis, a diagram nem dobja “select” vagy más interakció-alapú események (de dobja kész vagy hiba események), és nem jelenik hovertext vagy más módon változik attól függően, hogy a felhasználó bemenet., Típus: boolean
alapértelmezett: true
|
fontSize |
a diagram összes szövegének alapértelmezett betűmérete pixelben. Ezt felülírhatja az adott diagramelemek tulajdonságai segítségével. Típus: szám
alapértelmezett: automatikus
|
fontName |
a diagram összes szövegének alapértelmezett betűtípusa. Ezt felülírhatja az adott diagramelemek tulajdonságai segítségével. Típus: string
alapértelmezett: ‘Arial’
|
forceIFrame |
rajzolja a diagramot egy inline keretben., (Vegye figyelembe, hogy az IE8-on ezt az opciót figyelmen kívül hagyják; az összes IE8 diagramot i-keretekben rajzolják.) Típus: boolean
alapértelmezett: false
|
magasság |
a diagram magassága pixelben. Típus: szám
alapértelmezett: a tartalmazó elem magassága
|
is3D |
Ha igaz, háromdimenziós diagramot jelenít meg. Típus: boolean
alapértelmezett: false
|
legend |
egy objektum tagokkal a legenda különböző aspektusainak konfigurálásához., Az objektum tulajdonságainak megadásához használhatja az objektum szó szerinti jelölését, amint az itt látható: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Típus: objektum
alapértelmezett: null
|
jelmagyarázat.igazítás |
A legenda igazítása. Lehet az alábbiak egyike:
a Start, a középpont és a vég A jelmagyarázat stílusához-függőleges vagy vízszintes-viszonyított. Például egy “jobb” jelmagyarázatban a “start” és a ” vég “a felső és az alsó, a “felső” jelmagyarázat esetében a “start” és a “vége” a terület bal és jobb oldalán található. Az alapértelmezett érték a jelmagyarázat pozíciójától függ. Az “alsó” legendák esetében az alapértelmezett a “központ”; más legendák alapértelmezés szerint a “start”. Típus: string
alapértelmezett: automatikus
|
jelmagyarázat.pozíció |
a legenda helyzete., Lehet az alábbiak egyike:
Típus: string
alapértelmezett:’jobb’
|
jelmagyarázat.maxLines |
a jelmagyarázatban szereplő sorok maximális száma. Állítsa ezt egynél nagyobb számra, hogy sorokat adjon hozzá a legendához., Megjegyzés: a megjelenített vonalak tényleges számának meghatározásához használt pontos logika továbbra is fluxusban van. Ez az opció jelenleg csak akkor működik, ha legenda.pozíció “felső”. Típus: szám
alapértelmezett: 1
|
jelmagyarázat.textStyle |
egy objektum, amely megadja a legenda szövegstílusát. Az objektumnak ez a formátuma: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } a Típus: object
alapértelmezett:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
pieHole |
Ha 0 és 1 között van, fánkdiagram jelenik meg. A lyuk sugara Típus: szám
alapértelmezett: 0
|
pieSliceBorderColor |
a szelet szegélyeinek színe. Csak akkor alkalmazható, ha a diagram kétdimenziós., Típus: string
alapértelmezett: ‘fehér’
|
pieSliceText |
a szöveg tartalma jelenik meg a szelet. Lehet a következők egyike:
Típus: string
alapértelmezett: ‘százalék’
|
pieSliceTextStyle |
egy objektum, amely meghatározza a szelet szövegstílusát., Az objektumnak ez a formátuma: {color: <string>, fontName: <string>, fontSize: <number>} a Típus: object
alapértelmezett:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
pieStartAngle |
a szög, fokokban, a diagram elforgatásához. Az alapértelmezett Típus: szám
alapértelmezett:
0 |
Ha igaz, a szeleteket az óramutató járásával ellentétes irányba húzza. Az alapértelmezett az óramutató járásával megegyező irányba történő rajzolás. Típus: boolean
alapértelmezett: false
|
|
pieResidueSliceColor |
szín a kombinációs szelethez, amely az összes szeletet a sliceVisibilityThreshold alatt tartja., Típus: string
alapértelmezett: ‘#CCC’
|
pieResidueSliceLabel |
a slicevisibilitythreshold alatti összes szeletet tartalmazó kombinációs szelet címkéje. Típus: string
alapértelmezett: “Egyéb”
|
szeletek |
egy sor objektum, mindegyik leírja a formátum a megfelelő szelet a pite. Egy szelet alapértelmezett értékeinek használatához adjon meg egy üres objektumot (azaz
megadhat egy sor objektumot, amelyek mindegyike a megadott sorrendben lévő szeletre vonatkozik, vagy megadhat egy objektumot, ahol minden gyermeknek van egy numerikus kulcsa, amely jelzi, hogy melyik szeletre vonatkozik. Például a következő két deklaráció azonos, és az első szeletet feketének, a negyediket pirosnak nyilvánítja: slices: slices: {0: {color: 'black'}, 3: {color: 'red'}} Típus: objektumok tömbje vagy beágyazott objektumokkal rendelkező objektum
alapértelmezett: {}
|
sliceVisibilityThreshold |
pite, amely alatt egy szelet nem jelenik meg külön-külön., Minden olyan szelet, amely nem haladta meg ezt a küszöböt, egyetlen “más” szeletre kombinálódik, amelynek mérete minden méretük összege. Alapértelmezés szerint nem jelenít meg külön-külön olyan szeletet, amely kisebb, mint fél fok. // Slices less than 25% of the pie will be// combined into an "Other" slice.sliceVisibilityThreshold: .25 Típus: szám
alapértelmezett: fél fok (.5/360 vagy 1/720 vagy .0014)
|
cím |
szöveg jelenik meg a diagram felett. Típus: string
alapértelmezett: Nincs cím
|
titleTextStyle |
egy objektum, amely meghatározza a cím szövegstílusát., 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., Az objektum tulajdonságainak megadásához használhatja az objektum szó szerinti jelölését, amint az itt látható: {textStyle: {color: '#FF0000'}, showColorCode: true} Típus: object
alapértelmezett: null
|
tooltip.ignoreBounds |
Ha Megjegyzés: Ez csak a HTML tooltip-ekre vonatkozik. Ha ez engedélyezve van SVG tooltips, minden túlcsordulás kívül a diagram határokat lesz vágva. További részletekért lásd: Tooltip tartalom testreszabása., Típus: boolean
alapértelmezett: false
|
tooltip.isHtml |
ha true értékre van állítva, használjon HTML-renderelt (nem SVG-renderelt) eszköztippeket. További részletekért lásd: Tooltip tartalom testreszabása. megjegyzés: a HTML tooltip tartalom testreszabását az tooltip oszlop adat szerepkörén keresztül nem támogatja a buborékdiagram megjelenítés. Típus: boolean
alapértelmezett: false
|
tooltip.showColorCode |
Ha igaz, akkor az eszköztipp szeletinformációi melletti színes négyzeteket jelenítsen meg., Típus: boolean
alapértelmezett: false
|
tooltip.szöveg |
milyen információkat jeleníthet meg, amikor a felhasználó egy pite szelet felett lebeg. A következő értékek támogatottak:
Típus: string
alapértelmezett: ‘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 |
az a felhasználói interakció, amely az eszköztipp megjelenítését okozza:
Típus: string
alapértelmezett: ‘focus’
|
szélesség |
a diagram szélessége pixelben., Típus: szám
alapértelmezett: a
|
módszerek
módszer | |
---|---|
div id=”c2803449a9″> |
rajzolja a diagramot. A diagram csak a Return Type: none
|
getAction(actionID) |
visszaadja a tooltip action objektumot a kért visszatérési típus: object
|
getBoundingBox(id) |
visszaad egy objektumot, amely a bal, felső, szélesség és magassága chart elem
az értékek a diagram tartályához viszonyítva vannak. Hívja ezt a diagram rajzolása után. visszatérési típus: object
|
getChartAreaBoundingBox() |
visszaad egy objektumot, amely a diagram tartalmának bal, felső, szélességét és magasságát tartalmazza (pl.,
az értékek a diagram tartályához viszonyítva vannak. Hívja ezt a diagram rajzolása után. visszatérési típus: object
|
getChartLayoutInterface() |
visszaad egy objektumot, amely információkat tartalmaz a grafikon és annak elemei képernyőn való elhelyezéséről., A következő módszerekkel lehet nevezni a visszaadott objektum:
Hívás után a diagram készül. visszatérési típus: object
|
getHAxisValue(position, optional_axis_index) |
visszaadja a logikai vízszintes értéket a példa: hívja ezt a diagram rajzolása után. visszatérési típus: number
|
getImageURI() |
visszaadja a kép URI-ként serializált diagramot. hívja ezt a diagram rajzolása után. lásd a PNG-diagramok nyomtatását. visszatérési típus: string
|
getSelection() |
visszaadja a kiválasztott diagram entitások egy tömbjét. A választható entitások szeletek és legenda bejegyzések. Ehhez a diagramhoz csak egy entitás választható ki egy adott pillanatban., Return Type: Array of selection elements
|
getVAxisValue(position, optional_axis_index) |
visszaadja a logikai függőleges értéket példa: hívja ezt a diagram rajzolása után. visszatérési típus: number
|
getXLocation(position, optional_axis_index) |
visszaadja a példa: hívja ezt a diagram rajzolása után. visszatérési típus: number
|
getYLocation(position, optional_axis_index) |
visszaadja a példa: hívja ezt a diagram rajzolása után. Return Type: number
|
removeAction(actionID) |
eltávolítja a tooltip műveletet a kért visszatérési típus:
none |
setAction(action) |
beállítja a végrehajtandó eszköztip műveletet, amikor a felhasználó rákattint a művelet szövegére. a a táblázat visszatérési típus:
none |
setSelection() |
kiválasztja a megadott diagram entitásokat. Törli az előző választást. A választható entitások szeletek és legenda bejegyzések. Ehhez a diagramhoz egyszerre csak egy entitás választható ki. Return Type: none
|
clearChart() |
törli a diagramot, és kiadja az összes kiosztott erőforrását. Return Type: none
|
események
további információért arról, hogyan kell ezeket az eseményeket használni, lásd az alapvető interaktivitást, az események kezelését és a tüzelési eseményeket.
Name | |
---|---|
click |
tüzelt, amikor a felhasználó rákattint a diagram belsejében., Lehet használni, hogy azonosítsa, ha a cím, adatelemek, legenda bejegyzések, tengelyek, rácsvonalak, vagy címkék kattintanak. tulajdonságok: targetID
|
error |
a diagram megjelenítésekor hiba lép fel. tulajdonságok: id, message
|
onmouseover |
tüzelt, amikor a felhasználó egy vizuális entitás felett felkel. Adja vissza a megfelelő adattábla elem sor – és oszlopindexeit. Egy szelet vagy jelmagyarázat bejegyzés korrelál az adattábla egy sorával (az oszlopindex null)., tulajdonságok: sor, oszlop
|
onmouseout |
tüzelt, amikor a felhasználó elfordul egy vizuális entitástól. Adja vissza a megfelelő adattábla elem sor – és oszlopindexeit. Egy szelet vagy jelmagyarázat bejegyzés korrelál az adattábla egy sorával (az oszlopindex null). tulajdonságok: sor, oszlop
|
ready |
a diagram készen áll a külső módszerhívásokra., Ha azt szeretnénk, hogy kölcsönhatásba lépnek a diagram, és hívja módszerek után rajzol, akkor létre kell hozni egy hallgatót erre az eseményre, mielőtt hívja a tulajdonságok: Nincs
|
select |
tüzelt, amikor a felhasználó rákattint egy vizuális entitás. Ha szeretné megtudni, hogy mi lett kiválasztva, hívja tulajdonságok: none
|
Adatházirend
minden kód és adat feldolgozása és renderelése a böngészőben történik., Semmilyen adatot nem küldünk semmilyen szerverre.