Prezentare generală
o diagramă radială care este redată în browser folosind SVG sau VML. Afișează ponturi atunci când situându-se peste felii.,
Exemplu
de a Face un 3D Pie Chart
Dacă setați is3D
opțiunea de a true
, yourpie graficul va fi elaborat ca desi are trei dimensiuni:
is3D
este false
în mod implicit, deci, aici ne-am stabilit în mod explicit să true
:
de a Face un Grafic Gogoașă
O gogoasa diagramă este un pie chart cu o gaură în centru., Poți crea diagrame gogoasa cu pieHole
opțiune:
pieHole
opțiune ar trebui să fie setat la un număr între 0and 1, corespunzător cu raportul dintre raze între gaură și thechart. Numere între 0.4 și 0.6 va arata cel mai bine pe cele mai multe diagrame.Valorile egale sau mai mari decât 1 vor fi ignorate și o valoare de 0VA închide complet piehole-ul.
nu puteți combina pieHole
și is3D
opțiuni; dacă o faci, pieHole
va fi ignorat.,rețineți că Google Charts încearcă să plaseze eticheta cât mai aproape decentrul feliei. Dacă aveți o diagramă de gogoși cu justo felie, Centrul feliei poate cădea în gaura de gogoși. Punctez caz, schimba culoarea etichetei:
var options = { pieHole: 0.5, pieSliceTextStyle: { color: 'black', }, legend: 'none' };
Rotative o Diagramă radială
în mod implicit, diagrame plăcintă începe cu marginea din stânga a primei slicepointing drept în sus. Puteți schimba asta cu pieStartAngle
opțiune:
Aici, ne-am roti graficul de 100 de grade în sensul acelor de ceasornic cu o optionof pieStartAngle: 100
., (Deci ales pentru că acel particularangle se întâmplă să facă eticheta” Italiană ” să se potrivească în interiorul feliei.)
Explodează o Felie
puteți separa felii de plăcintă de restul diagramă cu offset
proprietatea slices
opțiune:
Pentru a separa o felie, a crea un slices
obiect și alocați corespunzător felie numărul un offset
între 0 și 1., Mai jos, vom atribui progresiv mai mari decalaje de la 4 felii (Gujarati), 12 (Marathi), 14 (Oriya) și 15 (Punjabi):
Eliminarea Felii
Pentru a omite o felie, schimba culoarepentru a 'transparent'
:
de asemenea, Am folosit pieStartAngle
pentru a roti diagrama 135degrees, pieSliceText
pentru a elimina textul din theslices, și tooltip.trigger
pentru a dezactiva ponturile:
Felie de Vizibilitate Prag
puteți seta o valoare de prag pentru o felie de plăcintă pentru a face în mod individual., Această valoare corespunde unei fracțiuni a graficului (cu întreaga diagramă având valoarea 1). Pentru a seta acest prag ca procent din întreg, împărțiți procentul dorit cu 100 (pentru un prag de 20%, valoarea ar fi 0, 2).
sliceVisibilityThreshold: 5/8 // This is equivalent to 0.625 or 62.5% of the chart.
orice felii mai mici decât acest prag vor fi combinate într-o singură felie „alta” și vor avea valoarea combinată a tuturor feliilor sub prag.
Încărcare
google.charts.load
pachetul nume este "corechart"
.,
google.charts.load("current", {packages: });
numele clasei de vizualizare este google.visualization.PieChart
.
var visualization = new google.visualization.PieChart(container);
formatul datelor
rânduri: fiecare rând din tabel reprezintă o felie.
Coloane:
Opțiuni de Configurare
Nume | |
---|---|
backgroundColor |
culoarea de fundal pentru zona principală a diagramei. Poate fi un simplu HTML șir de culoare, de exemplu: tip: string sau obiect
implicit: „alb”
|
backgroundColor.stroke |
culoarea chenarului graficului, ca șir de culori HTML. tip: string
implicit: ‘#666’
|
backgroundColor.strokeWidth |
lățimea de frontieră, în pixeli. Tip: număr
implicit: 0
|
backgroundColor.completați |
culoarea de umplere a graficului, ca șir de culori HTML., Type: string
Default: ‘white’
|
chartArea |
un obiect cu membri pentru a configura plasarea și dimensiunea zonei diagramei (unde diagrama în sine este desenată, excluzând axa și legendele). Sunt acceptate două formate: un număr sau un număr urmat de %. Un număr simplu este o valoare în pixeli; un număr urmat de % este un procent. Exemplu: Tip: obiect
Default: nul
|
chartArea.backgroundColor |
Diagramă zona de culoare de fundal., Atunci când un șir este utilizat, acesta poate fi fie un șir hexagonal (de exemplu, „#fdc”) sau un nume de culoare Engleză. Când se utilizează un obiect, pot fi furnizate următoarele proprietăți:
tip: string sau obiect
implicit: ‘alb’
|
chartArea.stânga |
cât de departe pentru a trage graficul de la marginea din stânga., Tip: număr sau șir
implicit: auto
|
chartArea.top |
cât de departe pentru a trage graficul de la marginea de sus. Tip: număr sau șir
implicit: auto
|
chartArea.lățime |
lățimea zonei graficului. Tip: număr sau șir
implicit: auto
|
chartArea.înălțime |
Înălțimea zonei graficului. Tip: număr sau șir
implicit: auto
|
culori |
culorile de utilizat pentru elementele de diagramă., O serie de șiruri, în care fiecare element este un șir de culori HTML, de exemplu: Tip: matrice de siruri de caractere
implicit: culori implicite
|
enableInteractivity |
dacă graficul aruncă evenimente bazate pe utilizator sau reacționează la interacțiunea cu utilizatorul. Dacă este fals, graficul nu va arunca „selectați” sau alte evenimente bazate pe interacțiune (dar va arunca evenimente gata sau de eroare) și nu va afișa textul plutitor sau nu se va schimba în funcție de intrarea utilizatorului., tip: boolean
implicit: adevărat
|
fontSize |
dimensiunea implicită a fontului, în pixeli, a întregului text din diagramă. Puteți suprascrie acest lucru folosind proprietăți pentru anumite elemente de diagramă. Tip: număr
implicit: automat
|
fontName |
fața fontului implicit pentru tot textul din diagramă. Puteți suprascrie acest lucru folosind proprietăți pentru anumite elemente de diagramă. tip: string
implicit: ‘Arial’
|
forceIFrame |
desenează graficul în interiorul unui cadru inline., (Rețineți că pe IE8, această opțiune este ignorată; toate diagramele IE8 sunt desenate în cadre I.) tip: boolean
implicit: fals
|
înălțime |
înălțimea graficului, în pixeli. Tip: număr
Default: înălțimea conțin elementul
|
is3D |
Dacă este adevărat, afișează o diagramă tridimensională. tip: boolean
implicit: fals
|
legendă |
un obiect cu membri pentru a configura diferite aspecte ale legendei., Pentru a specifica proprietățile acestui obiect, puteți utiliza obiect literală notație, așa cum se arată aici: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Tip: obiect
Default: nul
|
legenda.aliniere |
alinierea legendei. Poate fi una dintre următoarele:
|
legendă.poziția |
poziția legendei., Poate fi una dintre următoarele:
Tip: string
Default: „dreapta”
|
legenda.maxLines |
numărul maxim de linii din legendă. Setați acest lucru la un număr mai mare decât unul pentru a adăuga linii la legenda dvs., Notă: logica exactă utilizată pentru a determina numărul real de linii randate este încă în flux. această opțiune funcționează în prezent numai atunci când legenda.poziția este „de sus”. Tip: număr
implicit: 1
|
legendă.textStyle |
un obiect care specifică stilul textului legendei. Obiectul are următorul format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } Type: object
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
pieHole |
Dacă între 0 și 1, Afișează o diagramă gogoasa. Gaura cu au o rază egală cu Tip: număr
implicit: 0
|
pieSliceBorderColor |
culoarea marginilor felie. Se aplică numai atunci când graficul este bidimensional., tip: string
implicit: ‘alb’
|
pieSliceText |
conținutul textului afișat pe felie. Poate fi una dintre următoarele:
Tip: string
Default: ‘procentual’
|
pieSliceTextStyle |
Un obiect care specifică felie stil de text., Obiectul are următorul format: {color: <string>, fontName: <string>, fontSize: <number>} Tip: obiect
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
pieStartAngle |
unghiul, în grade, pentru a roti diagrama de. Valoarea implicită a Tip: număr
Default:
0 |
reverseCategories |
Dacă este adevărat, atrage felii invers acelor de ceasornic. Implicit este să desenați în sensul acelor de ceasornic. Tip: boolean
Default: fals
|
pieResidueSliceColor |
Culoare pentru o combinație felie care deține toate feliile de mai jos sliceVisibilityThreshold., Tip: string
Default: ‘#ccc’
|
pieResidueSliceLabel |
O etichetă pentru o combinație felie care deține toate feliile de mai jos sliceVisibilityThreshold. tip: string
implicit: „altele”
|
felii |
o serie de obiecte, fiecare descriind formatul feliei corespunzătoare din plăcintă. Pentru a utiliza valorile implicite pentru o felie, specificați un obiect gol (adică,
puteți specifica fie o serie de obiecte, fiecare dintre acestea se aplică feliei în ordinea dată, fie puteți specifica un obiect în care fiecare copil are o cheie numerică care indică felia la care se aplică. De exemplu, următoarele două declarații sunt identice, și să declare prima felie la fel de neagră și al patrulea ca rosu: slices: slices: {0: {color: 'black'}, 3: {color: 'red'}} Tip: Serie de obiecte, obiect sau cu obiecte imbricate
Default: {}
|
sliceVisibilityThreshold |
fracționată valoare de plăcintă, mai jos, pe care o felie nu va arăta în mod individual., Toate feliile care nu au trecut de acest prag vor fi combinate într-o singură felie „alta”, a cărei dimensiune este suma tuturor dimensiunilor lor. Implicit nu este de a arăta în mod individual orice felie, care este mai mică decât o jumătate de grad. // Slices less than 25% of the pie will be// combined into an "Other" slice.sliceVisibilityThreshold: .25 Tip: număr
implicit: jumătate de grad (.5/360 sau 1/720 sau .0014)
|
titlu |
Text de afișat deasupra graficului. Type: string
Default: no title
|
titleTextStyle |
un obiect care specifică stilul textului titlului., 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., Pentru a specifica proprietățile acestui obiect, puteți utiliza obiect literală notație, așa cum se arată aici: {textStyle: {color: '#FF0000'}, showColorCode: true} Tip: obiect
Default: nul
|
tooltip.ignoreBounds |
dacă este setat la Notă: Acest lucru se aplică numai tooltips HTML. Dacă acest lucru este activat cu ajutorul sfaturilor SVG, orice depășire în afara limitelor graficului va fi decupată. Consultați personalizarea conținutului Tooltip pentru mai multe detalii., tip: boolean
implicit: fals
|
tooltip.isHtml |
dacă este setat la true, utilizați HTML-prestate (mai degrabă decât SVG-prestate) ponturi. Consultați personalizarea conținutului Tooltip pentru mai multe detalii. notă: personalizarea conținutului tooltip HTML prin intermediul rolului de date al coloanei tooltip nu este acceptată de vizualizarea diagramei cu bule. tip: boolean
implicit: fals
|
tooltip.showColorCode |
dacă este adevărat, arată pătrate colorate de lângă informațiile felie în tooltip., tip: boolean
implicit: fals
|
tooltip.text |
ce informații să afișeze atunci când utilizatorul trece peste o felie de plăcintă. Sunt acceptate următoarele valori:
tip: string
implicit: „ambele”
|
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 |
interacțiunea cu utilizatorul care determină afișarea tooltip-ului:
tip: string
implicit: ‘focus’
|
lățime |
lățimea graficului, în pixeli., Tip: număr
Default: lățimea conțin elementul
|
Metode
Metoda | |
---|---|
draw(data, options) |
Atrage diagramă. Graficul acceptă apeluri suplimentare numai după ce evenimentul Tip de Retur: niciunul
|
getAction(actionID) |
a se Întoarce tooltip obiect acțiune solicitate Tip de Retur: obiect
|
getBoundingBox(id) |
Returnează un obiect care conține stânga, sus, lățimea și înălțimea de diagramă element
Valorile sunt relative la containere din diagramă. Apelați acest lucru după ce graficul este desenat. Tip retur: obiect
|
getChartAreaBoundingBox() |
returnează un obiect care conține stânga, sus, lățimea și înălțimea conținutului graficului (adică.,, cu excepția etichetelor și legendă):
Valorile sunt relative la containere din diagramă. Apelați acest lucru după ce graficul este desenat. Return Type: object
|
getChartLayoutInterface() |
returnează un obiect care conține informații despre plasarea pe ecran a graficului și a elementelor sale., următoarele metode poate fi numit pe obiectul returnat:
Apel în această după diagramă este trasată. Tip de Retur: obiect
|
getHAxisValue(position, optional_axis_index) |
Returnează valoarea logică orizontale valoarea de la exemplu: apelați acest lucru după ce graficul este desenat. Tip retur: număr
|
getImageURI() |
returnează graficul serializat ca URI de imagine. apelați acest lucru după ce graficul este desenat. A se vedea imprimarea diagrame PNG. Tip retur: string
|
getSelection() |
returnează o matrice de entități diagramă selectate. Entitățile selectabile sunt felii și intrări legendă. Pentru această diagramă, o singură entitate poate fi selectată la un moment dat., Tip de Returnare: Array de elemente de selectare
|
getVAxisValue(position, optional_axis_index) |
Returnează valoarea logică verticală valoarea la exemplu: apelați acest lucru după ce graficul este desenat. Tip de Retur: numărul
|
getXLocation(position, optional_axis_index) |
a se Întoarce ecran x-coordonata exemplu: apelați acest lucru după ce graficul este desenat. Tip de Retur: numărul
|
getYLocation(position, optional_axis_index) |
a se Întoarce la ecranul y-coordonata exemplu: apelați acest lucru după ce graficul este desenat. Tip de Retur: numărul
|
removeAction(actionID) |
Elimină tooltip acțiune solicitate Tip de Retur:
none |
setAction(action) |
Stabilește un tooltip acțiune pentru a fi executat atunci când utilizatorul face clic pe textul de acțiune. metoda orice și toate acțiunile tooltip ar trebui să fie stabilite înainte de apelarea graficului Tip de Retur:
none |
setSelection() |
Selectează specificate diagramă entități. Anulează orice selecție anterioară. Entitățile selectabile sunt felii și intrări legendă. Pentru această diagramă, o singură entitate poate fi selectată la un moment dat. Return Type: none
|
clearChart() |
șterge Graficul și eliberează toate resursele alocate. Return Type: none
|
evenimente
Pentru mai multe informații despre modul de utilizare a acestor evenimente, consultați interactivitate de bază, gestionarea evenimentelor și evenimente de ardere.
Nume | |
---|---|
click |
Concediat atunci când utilizatorul face clic în interiorul diagramei., Poate fi folosit pentru a identifica atunci când titlul, elemente de date, intrările legenda, axe, gridlines, sau etichete sunt apasat. proprietăți: targetID
|
error |
tras atunci când apare o eroare la încercarea de a face graficul. proprietăți: id, mesaj
|
onmouseover |
tras atunci când utilizatorul Mouse-uri peste o entitate vizuală. Trece înapoi indicii rând și coloană ale elementului tabel de date corespunzător. O intrare felie sau legenda se corelează cu un rând în tabelul de date (index coloană este nul)., proprietăți: rând, coloană
|
onmouseout |
tras atunci când utilizatorul se îndepărtează de o entitate vizuală. Trece înapoi indicii rând și coloană ale elementului tabel de date corespunzător. O intrare felie sau legenda se corelează cu un rând în tabelul de date (index coloană este nul). proprietăți: rând, coloană
|
ready |
graficul este pregătit pentru apeluri de metode externe., Dacă doriți să interacționați cu Graficul și să apelați metode după ce îl desenați, ar trebui să configurați un ascultător pentru acest eveniment înainte de a apela metoda proprietăți: nici unul
|
select |
tras atunci când utilizatorul face clic pe o entitate vizuală. Pentru a afla ce a fost selectat, apelați proprietăți: none
|
Politica de date
toate codurile și datele sunt procesate și redate în browser., Nu există date este trimis la orice server.