Visualization
הרכיב הזה מאחזר את הנתונים וההגדרות מהקשר השאילתה ומציג את הוויזואליזציה המתאימה. אפשר להתאים אישית את הרוחב והגובה על ידי העברת ערכים מספריים של פיקסלים למאפיינים האלה.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
width
|
מספר (בפיקסלים) | ברירת המחדל היא 100% אם המאפיין לא מוגדר. |
height
|
מספר (בפיקסלים) | ברירת המחדל היא 500px אם המאפיין לא מוגדר. |
chartTypeMap
|
אובייקט של צמדי מפתח/ערך | מקבל אובייקט של מפתח/ערך שמגדיר איזה רכיב להציג כשמערכת המתאם נתקלת בערכים ספציפיים של סוג התרשים. אפשר להשתמש בזה כדי לשנות את הגדרות ברירת המחדל של התרשימים ב-Looker או כדי להוסיף סוגים חדשים של תרשימים למערכת המתאמים. |
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
import { MyCustomRadar } from '../MyCustomRadar'
<Query query='12345' config={{ type: 'radar'}}>
<Visualization
width={1000}
height={500}
chartTypeMap={{ radar: MyCustomRadar}}
/>
</Query>
Query
Query משולב עם JavaScript API שלנו כדי לטפל במחזור הבקשה/התגובה וכדי לאחזר תגובה לשאילתה לפי מזהה השאילתה או הערך qid. אפשר להעביר החלפות של הגדרות התצורה של הוויזואליזציה כדי למזג אותן עם תגובת ה-API, ולטעון את כל הנתונים להקשר של React.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
query
|
מספר | מחרוזת | אפשר להזין את Query.client_id, שמופיע אחרי המאפיין qid בכתובת ה-URL של התצוגה המקדימה (3fdrdE0b3ATltUvXBaSOPN), או מזהה מספרי של שאילתה (1234). אם יש לכם גישה למזהה המספרי של השאילתה, תוכלו לחסוך בקשה נוספת לשרת אם תתחילו מהערך הזה.Query מקבל את המאפיין query או את המאפיין dashboard, אבל לא את שניהם.
|
dashboard
|
מספר | אפשר להזין מזהה מספרי של לוח בקרה (1234). אם יש לכם גישה למזהה המספרי של לוח הבקרה, תוכלו להתחיל מהערך הזה ולחסוך בקשת שרת נוספת.dashboard לא מקבל את מזהי המחרוזות של מרכזי בקרה של LookML.Query מקבל את המאפיין query או את המאפיין dashboard, אבל לא את שניהם.
|
config
|
בהתאם לערך של type, אפשר להזין את המאפיינים הבאים:type, legend, positioning, render_null_values, tooltips, series, x_axis, y_axis בהמשך הדף מופיע תיעוד ספציפי לתרשימים עם ערכים נתמכים.
|
הגדרת הגדרות של תרשימים ושינוי שלהן. |
LoadingIndicator
|
הפניה לרכיב | מקבל הפניה לרכיב לא מוטמע. ברירת מחדל: ProgressCircular
|
import { Visualization, Query } from '@looker/visualizations'
import { ProgressCircular } from '@looker/components'
<Query
query='12345'
config={{
/* specific properties described later on this page */
}}
LoadingIndicator={ProgressCircular}
>
<Visualization />
</Query>
מאפיינים של תרשים שטח
אלה המאפיינים של config תרשימי שטח.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
type
|
'area'
|
|
legend
|
false (להשבתה) או { position: 'left' | 'bottom' | 'right' | 'top' }
|
הגדרת המיקום של המקרא או השבתת המקרא על ידי הגדרת הערך false.ברירת מחדל: { position: 'bottom' }
|
positioning
|
'overlay' | 'stacked' | 'percent'
|
מצב של ערימת תרשימים. ברירת מחדל: 'overlay'
|
render_null_values
|
בוליאני | מתייחסת לערכי null כאל 0. ברירת מחדל: false
|
tooltips
|
בוליאני | הפעלה או השבתה של הופעת תיאורי כלים כשמעבירים את העכבר מעל נקודות נתונים. ברירת מחדל: true
|
series
|
סדרה בפורמט view_name.field_name
|
אפשרויות ההגדרה ודוגמאות לשימוש מפורטות בקטע סדרות. |
x_axis
|
הגדרות ציר ה-X | בקטע ציר ה-X מופיעות אפשרויות הגדרה ודוגמאות לשימוש. |
y_axis
|
הגדרת ציר ה-Y | בקטע ציר ה-Y מפורטות אפשרויות ההגדרה ודוגמאות לשימוש. |
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'area',
legend: { position: 'left' },
positioning: 'stacked',
render_null_values: true,
tooltips: true,
}}
>
<Visualization />
</Query>
series
המאפיין series יכול לקבל מערך של הגדרות סדרה או אובייקט בעל שם שמבטל סדרה ספציפית בתגובה.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
color
|
מחרוזת | קוד הקסדצימלי |
label
|
מחרוזת | |
line_width
|
מספר | מגדירים את עובי הקו בפיקסלים. ברירת מחדל: 3 |
shape
|
'circle' | 'diamond' | 'square' | 'triangle' | 'triangle-down'
|
הגדרת צורת הנקודה. ברירת מחדל: 'circle'
|
style
|
'none' | 'filled' | 'outline'
|
הגדרת סגנון הנקודה. ברירת מחדל: 'none' (הנקודות מושבתות)
|
visible
|
בוליאני | להציג או להסתיר את סדרת הנתונים. ברירת מחדל: true
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
/* named series overrides */
<Query
query='12345'
config={{
type: 'area',
series: {
'orders.count': {
color: '#4285F4',
label: 'Total Orders',
shape: 'square',
}
}
}}
>
<Visualization />
</Query>
/* ordered list series overrides */
<Query
query='12345'
config={{
type: 'area',
series: [{ color: '#4285F4', label: 'Total Orders', shape: 'square' }],
}}
>
<Visualization />
</Query>
x_axis
למרות שבשלב הזה התרשימים שלנו תומכים רק בציר X יחיד, ה-API שלנו מוכן לעתיד ומובנה כך שיתמוך בהגדרת צירים מרובים.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
gridlines
|
בוליאני | הצגה או הסתרה של קווי רשת אנכיים. ברירת מחדל: false
|
label
|
false (להסתרה של התווית) | מחרוזת (הערך להצגה)
|
מגדיר את הערך שיוצג כתווית של ציר ה-x. ברירת מחדל: false (ללא תווית)
|
reversed
|
בוליאני | הופכת את הסדר של נקודות הנתונים. ברירת מחדל: false
|
values
|
בוליאני | הצגה או הסתרה של הערכים שמוצגים לאורך הציר. ברירת מחדל: true |
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'area',
x_axis: [{ gridlines: true, label: 'Date of first purchase' }],
}}
>
<Visualization />
</Query>
y_axis
למרות שבשלב הזה התרשימים שלנו תומכים רק בציר Y אחד, ה-API שלנו מתוכנן לעתיד ומובנה כך שיתמוך בהגדרת צירים מרובים.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
gridlines
|
בוליאני | הצגה או הסתרה של קווי רשת אנכיים. ברירת מחדל: false.
|
label
|
false (להסתרה של התווית) | מחרוזת (הערך להצגה)
|
מגדיר את הערך שיוצג כתווית של ציר ה-Y. ברירת מחדל: false (ללא תווית)
|
range
|
[מספר (מינימום) | 'auto', מספר (מקסימום) | 'auto' |
המאפיין הזה מגדיר את הערך המינימלי והמקסימלי של ציר ה-y. אם מגדירים את הערך המינימלי ל-'auto', ברירת המחדל היא 0. אם מגדירים את הערך המקסימלי ל-'auto', ברירת המחדל היא הערך המקסימלי של נקודת הנתונים בקבוצה. ברירת מחדל: ['auto' | 'auto']
|
values
|
בוליאני | הצגה או הסתרה של הערכים שמוצגים לאורך הציר. ברירת מחדל: true
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'area',
y_axis: [
{ gridlines: true, label: 'Number of orders', range: [50, 'auto'] },
],
}}
>
<Visualization />
</Query>
מאפיינים של תרשים עמודות אופקי ושל תרשים עמודות אנכי
אלה המאפיינים של config בתרשימי עמודות אופקיות ועמודות אנכיות.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
type
|
'bar' | 'column'
|
|
legend
|
false (להשבתה) או { position: 'left' | 'bottom' | 'right' | 'top' }
|
הגדרת המיקום של המקרא או השבתת המקרא על ידי הגדרת הערך false. ברירת מחדל: { position: 'bottom' }
|
positioning
|
'grouped' | 'stacked' | 'percent'
|
מצב של ערימת תרשימים. ברירת מחדל: 'overlay'
|
tooltips
|
בוליאני | הפעלה או השבתה של הופעת תיאורי כלים כשמעבירים את העכבר מעל נקודות נתונים.ברירת מחדל: true
|
series
|
סדרה בפורמט view_name.field_name
|
אפשרויות ההגדרה ודוגמאות לשימוש מפורטות בקטע סדרות. |
x_axis
|
הגדרות ציר ה-X | בקטע ציר ה-X מופיעות אפשרויות הגדרה ודוגמאות לשימוש. |
y_axis
|
הגדרת ציר ה-Y | בקטע ציר ה-Y מפורטות אפשרויות ההגדרה ודוגמאות לשימוש. |
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'bar',
legend: { position: 'left' },
positioning: 'stacked',
tooltips: true,
}}
>
<Visualization />
</Query>
series
המאפיין series יכול לקבל מערך של הגדרות סדרה או אובייקט בעל שם שמבטל סדרה ספציפית בתגובה.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
color
|
מחרוזת | קוד הקסדצימלי |
label
|
מחרוזת | |
visible
|
בוליאני | להציג או להסתיר את סדרת הנתונים. ברירת מחדל: true
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'column',
series: {
'orders.count': {
color: '#4285F4',
label: 'Total Orders',
visible: false,
},
},
}}
>
<Visualization />
</Query>
/* ordered list series overrides */
<Query
query='12345'
config={{
type: 'column',
series: [{ color: '#4285F4', label: 'Total Orders', visible: false }],
}}
>
<Visualization />
</Query>
x_axis
למרות שבשלב הזה התרשימים שלנו תומכים רק בציר X יחיד, ה-API שלנו מוכן לעתיד ומובנה כך שיתמוך בהגדרת צירים מרובים.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
gridlines
|
בוליאני | הצגה או הסתרה של קווי רשת אנכיים. ברירת מחדל: false.
|
label
|
false (להסתרה של התווית) | מחרוזת (הערך להצגה)
|
מגדיר את הערך שיוצג כתווית של ציר ה-x. ברירת מחדל: false (ללא תווית)
|
reversed
|
בוליאני | הופכת את הסדר של נקודות הנתונים. ברירת מחדל: false
|
values
|
בוליאני | הצגה או הסתרה של הערכים שמוצגים לאורך הציר. ברירת מחדל: true
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'column',
x_axis: [{ gridlines: true, label: 'Date of first purchase' }],
}}
>
<Visualization />
</Query>
y_axis
למרות שבשלב הזה התרשימים שלנו תומכים רק בציר Y אחד, ה-API שלנו מתוכנן לעתיד ומובנה כך שיתמוך בהגדרת צירים מרובים.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
gridlines
|
בוליאני | הצגה או הסתרה של קווי רשת אנכיים. ברירת מחדל: false.
|
label
|
false (להסתרה של התווית) | מחרוזת (הערך להצגה)
|
מגדיר את הערך שיוצג כתווית של ציר ה-Y. ברירת מחדל: false (ללא תווית)
|
range
|
[מספר (מינימום) | 'auto', מספר (מקסימום) | 'auto' |
המאפיין הזה מגדיר את הערך המינימלי והמקסימלי של ציר ה-y. אם מגדירים את הערך min ל-'auto', ברירת המחדל היא 0. אם מגדירים את הערך max ל-'auto', ברירת המחדל היא הערך המקסימלי של נקודת הנתונים במערך. ברירת מחדל: ['auto' | 'auto'].
|
values
|
בוליאני | הצגה או הסתרה של הערכים שמוצגים לאורך הציר. ברירת מחדל: true
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'bar',
y_axis: [
{ gridlines: true, label: 'Number of orders', range: [500, 'auto'] },
],
}}
>
<Visualization />
</Query>
מאפייני תרשים קו
אלה המאפיינים של config תרשימי קו.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
type
|
'line'
|
|
legend
|
false (להשבתה) או { position: 'left' | 'bottom' | 'right' | 'top' }
|
הגדרת המיקום של המקרא או השבתת המקרא על ידי הגדרת הערך false. ברירת מחדל: { position: 'bottom' }
|
render_null_values
|
בוליאני | מתייחסת לערכי null כאל 0. ברירת מחדל: false
|
tooltips
|
בוליאני | הפעלה או השבתה של הופעת תיאורי כלים כשמעבירים את העכבר מעל נקודות נתונים. ברירת מחדל: true
|
series
|
סדרה בפורמט view_name.field_name
|
אפשרויות ההגדרה ודוגמאות לשימוש מפורטות בקטע סדרות. |
x_axis
|
הגדרות ציר ה-X | בקטע ציר ה-X מופיעות אפשרויות הגדרה ודוגמאות לשימוש. |
y_axis
|
הגדרת ציר ה-Y | בקטע ציר ה-Y מפורטות אפשרויות ההגדרה ודוגמאות לשימוש. |
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'line',
legend: { position: 'left' },
render_null_values: true,
tooltips: true,
}}
>
<Visualization />
</Query>
series
המאפיין series יכול לקבל מערך של הגדרות סדרה או אובייקט בעל שם שמבטל סדרה ספציפית בתגובה.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
color
|
מחרוזת | קוד הקסדצימלי |
label
|
מחרוזת | |
line_width
|
מספר | מגדירים את עובי הקו בפיקסלים. ברירת מחדל: 3 |
shape
|
'circle' | 'diamond' | 'square' | 'triangle' | 'triangle-down'
|
הגדרת צורת הנקודה. ברירת מחדל: 'circle'
|
style
|
'none' | 'filled' | 'outline'
|
הגדרת סגנון הנקודה. ברירת מחדל: 'none' (הנקודות מושבתות)
|
visible
|
בוליאני | להציג או להסתיר את סדרת הנתונים. ברירת מחדל: true
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
/* named series overrides */
<Query
query='12345'
config={{
type: 'line',
series: {
'orders.count': {
color: '#4285F4',
label: 'Total Orders',
shape: 'square',
},
},
}}
>
<Visualization />
</Query>
/* ordered list series overrides */
<Query
query='12345'
config={{
type: 'line',
series: [{ color: '#4285F4', label: 'Total Orders', shape: 'square' }],
}}
>
<Visualization />
</Query>
x_axis
למרות שבשלב הזה התרשימים שלנו תומכים רק בציר X יחיד, ה-API שלנו מוכן לעתיד ומובנה כך שיתמוך בהגדרת צירים מרובים.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
gridlines
|
בוליאני | הצגה או הסתרה של קווי רשת אנכיים. ברירת מחדל: false.
|
label
|
false (להסתרה של התווית) | מחרוזת (הערך להצגה)
|
מגדיר את הערך שיוצג כתווית של ציר ה-x. ברירת מחדל: false (ללא תווית)
|
reversed
|
בוליאני | הופכת את הסדר של נקודות הנתונים. ברירת מחדל: false
|
values
|
בוליאני | הצגה או הסתרה של הערכים שמוצגים לאורך הציר. ברירת מחדל: true
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'line',
x_axis: [{ gridlines: true, label: 'Date of first purchase' }],
}}
>
<Visualization />
</Query>
y_axis
למרות שבשלב הזה התרשימים שלנו תומכים רק בציר Y אחד, ה-API שלנו מתוכנן לעתיד ומובנה כך שיתמוך בהגדרת צירים מרובים.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
gridlines
|
בוליאני | הצגה או הסתרה של קווי רשת אנכיים. ברירת מחדל: false
|
label
|
false (להסתרה של התווית) | מחרוזת (הערך להצגה)
|
מגדיר את הערך שיוצג כתווית של ציר ה-Y. ברירת מחדל: false (ללא תווית)
|
range
|
[מספר (מינימום) | 'auto', מספר (מקסימום) | 'auto' |
המאפיין הזה מגדיר את הערך המינימלי והמקסימלי של ציר ה-y. אם מגדירים את הערך min ל-'auto', ברירת המחדל היא 0. אם מגדירים את הערך max ל-'auto', ברירת המחדל היא הערך המקסימלי של נקודת הנתונים במערך. ברירת מחדל: ['auto' | 'auto'].
|
values
|
בוליאני | הצגה או הסתרה של הערכים שמוצגים לאורך הציר. ברירת מחדל: true
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'line',
y_axis: [
{ gridlines: true, label: 'Number of orders', range: [500, 'auto'] },
],
}}
>
<Visualization />
</Query>
מאפיינים של תרשים פיזור
אלה המאפיינים של config לתרשימי פיזור.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
type
|
'scatter'
|
|
legend
|
false (להשבתה) או { position: 'left' | 'bottom' | 'right' | 'top' }
|
הגדרת המיקום של המקרא או השבתת המקרא על ידי הגדרת הערך false. ברירת מחדל: { position: 'bottom' }
|
render_null_values
|
בוליאני | מתייחסת לערכי null כאל 0. ברירת מחדל: false
|
tooltips
|
בוליאני | הפעלה או השבתה של הופעת תיאורי כלים כשמעבירים את העכבר מעל נקודות נתונים. ברירת מחדל: true
|
series
|
סדרה בפורמט view_name.field_name
|
אפשרויות ההגדרה ודוגמאות לשימוש מפורטות בקטע סדרות. |
x_axis
|
הגדרות ציר ה-X | בקטע ציר ה-X מופיעות אפשרויות הגדרה ודוגמאות לשימוש. |
y_axis
|
הגדרת ציר ה-Y | בקטע ציר ה-Y מפורטות אפשרויות ההגדרה ודוגמאות לשימוש. |
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'scatter',
legend: { position: 'left' },
render_null_values: true,
tooltips: true,
}}
>
<Visualization />
</Query>
series
המאפיין series יכול לקבל מערך של הגדרות סדרה או אובייקט בעל שם שמבטל סדרה ספציפית בתגובה.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
color
|
מחרוזת | קוד הקסדצימלי |
label
|
מחרוזת | |
line_width
|
מספר | משמש להגדרת גודל הנקודות בתרשים פיזור. אפשר לחשוב על זה כערך של כל נקודה בתוכנית. ברירת מחדל: 3
|
shape
|
'circle' | 'diamond' | 'square' | 'triangle' | 'triangle-down'
|
הגדרת צורת הנקודה. ברירת מחדל: 'circle'
|
style
|
'none' | 'filled' | 'outline'
|
הגדרת סגנון הנקודה. ברירת מחדל: 'none' (הנקודות מושבתות)
|
size_by
|
false | מחרוזת
|
שם הסדרה שלפיה יכויל הגודל של כל נקודה. מגדירים את false כדי להשבית את ההתאמה הדינמית של גודל הנקודה. ברירת מחדל: false
|
visible
|
בוליאני | להציג או להסתיר את סדרת הנתונים. ברירת מחדל: true
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
/* named series overrides */
<Query
query='12345'
config={{
type: 'scatter',
series: {
'orders.count': {
color: '#4285F4',
label: 'Total Orders',
shape: 'square',
size_by: 'orders.count',
},
},
}}
>
<Visualization />
</Query>
/* ordered list series overrides */
<Query
query='12345'
config={{
type: 'scatter',
series: [
{
color: '#4285F4',
label: 'Total Orders',
shape: 'square',
size_by: 'orders.count',
},
],
}}
>
<Visualization />
</Query>
x_axis
למרות שבשלב הזה התרשימים שלנו תומכים רק בציר X יחיד, ה-API שלנו מוכן לעתיד ומובנה כך שיתמוך בהגדרת צירים מרובים.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
gridlines
|
בוליאני | הצגה או הסתרה של קווי רשת אנכיים. ברירת מחדל: false.
|
label
|
false (להסתרה של התווית) | מחרוזת (הערך להצגה)
|
מגדיר את הערך שיוצג כתווית של ציר ה-x. ברירת מחדל: false (ללא תווית)
|
reversed
|
בוליאני | הופכת את הסדר של נקודות הנתונים. ברירת מחדל: false
|
values
|
בוליאני | הצגה או הסתרה של הערכים שמוצגים לאורך הציר. ברירת מחדל: true
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'scatter',
x_axis: [{ gridlines: true, label: 'Date of first purchase' }],
}}
>
<Visualization />
</Query>
y_axis
למרות שבשלב הזה התרשימים שלנו תומכים רק בציר Y אחד, ה-API שלנו מתוכנן לעתיד ומובנה כך שיתמוך בהגדרת צירים מרובים.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
gridlines
|
בוליאני | הצגה או הסתרה של קווי רשת אנכיים. ברירת מחדל: false.
|
label
|
false (להסתרה של התווית) | מחרוזת (הערך להצגה)
|
מגדיר את הערך שיוצג כתווית של ציר ה-Y. ברירת מחדל: false (ללא תווית)
|
range
|
[מספר (מינימום) | 'auto', מספר (מקסימום) | 'auto' |
המאפיין הזה מגדיר את הערך המינימלי והמקסימלי של ציר ה-y. אם מגדירים את הערך min ל-'auto', ברירת המחדל היא 0. אם מגדירים את הערך max ל-'auto', ברירת המחדל היא הערך המקסימלי של נקודת הנתונים במערך. ברירת מחדל: ['auto' | 'auto'].
|
values
|
בוליאני | הצגה או הסתרה של הערכים שמוצגים לאורך הציר. ברירת מחדל: true
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'scatter',
y_axis: [
{ gridlines: true, label: 'Number of orders', range: [500, 'auto'] },
],
}}
>
<Visualization />
</Query>
מאפייני תרשים של ערך יחיד
אלה מאפייני config לתרשימים עם ערך יחיד.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
type
|
'single_value'
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query query='12345' config={{ type: 'single_value' }}>
<Visualization />
</Query>
מאפיינים של תרשים קו בלי צירים
אלה מאפייני config לתרשימי קו קטן.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
type
|
'sparkline'
|
|
render_null_values
|
בוליאני | מתייחסת לערכי null כאל 0. ברירת מחדל: false
|
series
|
סדרה בפורמט view_name.field_name
|
אפשרויות ההגדרה ודוגמאות לשימוש מפורטות בקטע סדרות. |
y_axis
|
הגדרת ציר ה-Y | בקטע ציר ה-Y מפורטות אפשרויות ההגדרה ודוגמאות לשימוש. |
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query="12345"
config={{ type: 'sparkline', render_null_values: true }}
>
<Visualization />
</Query>
series
למרות ש-Sparkline תומך רק בסדרה אחת, אנחנו שומרים על דפוס API שכולל החלפות של סדרות בשם או במערך, כדי לשמור על עקביות עם סוגי התרשימים האחרים בספרייה שלנו.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
color
|
מחרוזת | קוד הקסדצימלי |
line_width
|
מספר | מגדירים את עובי הקו בפיקסלים. ברירת מחדל: 3
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
/* named series overrides */
<Query
query='12345'
config={{
type: 'sparkline',
series: {
'orders.count': {
color: '#4285F4',
line_width: 10,
},
},
}}
>
<Visualization />
</Query>
/* ordered list series overrides */
<Query
query='12345'
config={{
type: 'scatter',
series: [
{
color: '#4285F4',
line_width: 10,
},
],
}}
>
<Visualization />
</Query>
y_axis
למרות שבשלב הזה התרשימים שלנו תומכים רק בציר Y אחד, ה-API שלנו מתוכנן לעתיד ומובנה כך שיתמוך בהגדרת צירים מרובים.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
range
|
[מספר (מינימום) | 'auto', מספר (מקסימום) | 'auto' |
המאפיין הזה מגדיר את הערך המינימלי והמקסימלי של ציר ה-y. אם מגדירים את הערך min ל-'auto', ברירת המחדל היא 0. אם מגדירים את הערך max ל-'auto', ברירת המחדל היא הערך המקסימלי של נקודת הנתונים במערך. ברירת מחדל: ['auto' | 'auto'].
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'sparkline',
y_axis: [
{ range: [50, 'auto'] },
],
}}
>
<Visualization />
</Query>
מאפייני תרשים הטבלה
אלה מאפייני config לתרשימי טבלה.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
type
|
'table'
|
|
series
|
סדרה בפורמט view_name.field_name
|
אפשרויות ההגדרה ודוגמאות לשימוש מפורטות בקטע סדרות. |
column_order
|
string[]
|
מערך של שמות סדרות (לדוגמה, 'orders.count') שמציין את הסדר שבו רוצים שהעמודות בטבלה יופיעו משמאל לימין.
|
show_row_numbers
|
boolean
|
החלפה בין הצגה של שורת הסכומים הכוללים בתחתית הטבלה לבין הסתרה שלה. ברירת מחדל: true
|
show_totals
|
boolean
|
החלפה בין הצגה של שורת הסכומים הכוללים בתחתית הטבלה לבין הסתרה שלה. ברירת מחדל: true
|
show_row_totals
|
boolean
|
החלפה בין הצגה של סכומי השורות בצד שמאל של הטבלה לבין הסתרה שלהם. ברירת מחדל: true
|
truncate_text
|
boolean
|
כשמשתמשים ב-true, הטקסט בתא בטבלה מוגבל לשורה אחת, ואם התוכן חורג מהתא הוא נחתך ומוצגות שלוש נקודות. אם הערך הוא false, התוכן יכול להופיע בכמה שורות. ברירת מחדל: true
|
truncate_header
|
boolean
|
כשמשתמשים ב-true, תוויות הכותרת של הטבלה מוגבלות לשורה אחת, ותוכן שחורג מהגבולות נחתך ומוחלף בשלוש נקודות. כשההגדרה false, הכותרות יכולות להופיע בכמה שורות. ברירת מחדל: true
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'table',
column_order: ['orders.count', 'users.city'],
show_row_numbers: true,
show_totals: true,
show_row_totals: true,
truncate_text: true,
truncate_header: true
}}
>
<Visualization />
</Query>
series
מאפיין הסדרה יכול לקבל מערך של הגדרות סדרה או אובייקט בעל שם שמבטל סדרה ספציפית בתגובה.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
cell_visualization
|
boolean
|
החלפה בין מצב הפעלה להשבתה של הדמיה של תאים בשורה. ברירת המחדל היא true למדד הראשון ו-false למדדים האחרים.
|
color
|
string
|
ציין את הצבע המשמש להצגת ויזואליזציית תאי הטבלה. |
value_format
|
string
|
מחרוזת של פורמט מספרים שמציינת אם להציג את הערכים כמטבע, את הדיוק של הנקודה הצפה, אם להשתמש בפסיקים או בנקודות כדי להפריד בין אלפים וכו'. |
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'table',
series: {
'orders.count': {
color: '#4285F4',
cell_visualization: true,
value_format: '$#,##0.00',
},
},
}}
>
<Visualization />
</Query>
/* ordered list series overrides */
<Query
query='12345'
config={{
type: 'table',
series: [{
color: '#4285F4',
cell_visualization: true,
value_format: '$#,##0.00',
}]
}}
>
<Visualization />
</Query>
מאפיינים של תרשים עוגה
אלה המאפיינים של config תרשימי עוגה.
| מאפיין (property) | ערכים | הערות |
|---|---|---|
type
|
'pie'
|
|
legend
|
false (להשבתה) | הגדרת מקרא
|
אם מגדירים את הערך false, המקרא מושבת. ברירת המחדל: מופעלת. עיין בסעיף מקרא לקבלת אפשרויות תצורה ודוגמאות לשימוש כאשר הן מופעלות.
|
tooltips
|
בוליאני | הפעלה או השבתה של הופעת תיאורי כלים כשמעבירים את העכבר מעל נקודות נתונים. ברירת מחדל: true
|
series
|
סדרה בפורמט view_name.field_name
|
אפשרויות ההגדרה ודוגמאות לשימוש מפורטות בקטע סדרות. |
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'pie',
legend: false,
tooltips: true,
}}
>
<Visualization />
</Query>
legend
המאפיין legend יכול לקבל את הגדרות המקרא הבאות:
| מאפיין (property) | ערכים | הערות |
|---|---|---|
type
|
'labels' | 'legend'
|
labels תוויות המקומות מצביעות ישירות על כל פלח. legend מוסיף מקרא נפרד. ברירת מחדל: 'legend'
|
position
|
'top' | 'bottom' | 'left' | 'right'
|
מיקום המקרא כשtype: 'legend'. ברירת מחדל: 'right'
|
width
|
מספר | הרוחב המקסימלי של המקרא בפיקסלים כשמגדירים את הערך type: 'legend'. ברירת מחדל: 300
|
value
|
'label' | 'label_value' | 'value' | 'percent' | 'label_percent'
|
הגדרת התוכן של מקרא: תווית, תווית וערך, ערך, אחוז, תווית ואחוז. ברירת מחדל: 'label_percent'
|
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'pie',
legend: {
type: 'legend'
position: 'right'
width: 200,
value: 'label_value',
},
}}
>
<Visualization />
</Query>
series
בניגוד לתרשימים קרטזיים, כל נקודת נתונים בתרשים עוגה נחשבת לסדרה חדשה:
| מאפיין (property) | ערכים | הערות |
|---|---|---|
color
|
מחרוזת | קוד הקסדצימלי |
דוגמה לשימוש:
import { Visualization, Query } from '@looker/visualizations'
<Query
query='12345'
config={{
type: 'pie',
series: {
'New York': {
color: '#4285F4',
},
'Los Angeles': {
color: '#b73ec3',
},
'Chicago': {
color: '#db4da8',
},
},
}}
>
<Visualization />
</Query>