המחשה של טבלאות מאפיינים ושאילתות

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>