פרמטרים של משבצות טקסט בלוחות בקרה של LookML

בדף הזה מוסבר איך להוסיף ולהתאים אישית רכיב בלוח הבקרה של LookML‏ type: text באמצעות פרמטרים של מרכז שליטה של LookML בקובץ dashboard.lkml.

מידע על הוספת טקסט למרכז בקרה דרך ממשק המשתמש של Looker זמין בדף התיעוד בנושא יצירת מרכזי בקרה בהגדרת המשתמש.

דוגמה לשימוש

## BASIC PARAMETERS
name: element_name
type: text
height: N
width: N
top: N
left: N
row: N
col: N

## TEXT PARAMETERS
title_text: title text
subtitle_text: subtitle text
body_text: body text

הגדרות של פרמטרים

שם הפרמטר	תיאור
פרמטרים בסיסיים
name (לרכיבים)	יצירת רכיב
type (לרכיבים)	קובע את סוג התצוגה החזותית שתשמש ברכיב
height (לרכיבים)	המאפיין מגדיר את הגובה של רכיב ביחידות של tile_size בלוחות בקרה של layout: tile ושל layout: static
width (לרכיבים)	המאפיין מגדיר את הרוחב של רכיב ביחידות של tile_size בלוחות בקרה מסוג layout: tile ו-layout: static
top	המאפיין הזה מגדיר את המיקום מלמעלה למטה של רכיב ביחידות של tile_size בלוחות בקרה של layout: static
left	המאפיין מגדיר את המיקום של רכיב משמאל לימין ביחידות של tile_size בלוחות בקרה של layout: static
row	המאפיין הזה מגדיר את המיקום של רכיב מלמעלה למטה ביחידות של שורות בלוחות בקרה של layout: newspaper
col	המאפיין מגדיר את המיקום של רכיב משמאל לימין ביחידות של עמודות בלוחות בקרה של layout: newspaper
פרמטרים של טקסט
title_text	מציין כותרת לרכיב בלוח הבקרה מסוג type: text
subtitle_text	מציין כתובית לרכיב בלוח הבקרה של type: text
body_text	מציין את הטקסט של גוף הרכיב בלוח הבקרה של type: text

פרמטרים בסיסיים

כשמגדירים רכיב של לוח בקרה ב-LookML מסוג type: text, צריך לציין ערכים לפחות לפרמטרים name ו-type.

name

הקטע הזה מתייחס לפרמטר name שהוא חלק מרכיב לוח בקרה.

אפשר להשתמש ב-name גם כחלק ממסנן של לוח בקרה, כמו שמתואר בדף התיעוד פרמטרים של לוח בקרה.

כל הצהרה של name יוצרת רכיב בלוח הבקרה חדש ומקצה לו שם. שמות הרכיבים צריכים להיות ייחודיים. לפעמים יש הפניה לשמות בפרמטר elements כשמשתמשים בלוחות בקרה של layout: grid.

- name: orders_by_date

type

הקטע הזה מתייחס לפרמטר type שהוא חלק מרכיב לוח בקרה.

אפשר להשתמש ב-type גם כחלק ממסנן של לוח בקרה, כמו שמתואר בדף התיעוד פרמטרים של לוח בקרה.

אפשר להשתמש ב-type גם כחלק מצירוף, כפי שמתואר בדף התיעוד של הפרמטר type (לצירופים).

אפשר להשתמש ב-type גם כחלק ממאפיין, כמו שמתואר בדף התיעוד סוגי מאפיינים, מסננים ופרמטרים.

אפשר להשתמש ב-type גם כחלק ממדד, כמו שמתואר בדף התיעוד סוגי מדדים.

הפרמטר type קובע את סוג התצוגה החזותית שתשמש ברכיב.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot

במאמר type (למרכזי שליטה של LookML) מופיעה סקירה כללית של הסוגים השונים של רכיבי לוח הבקרה של LookML.

height

הקטע הזה מתייחס לפרמטר height שהוא חלק מרכיב לוח בקרה.

אפשר להשתמש ב-height גם כחלק משורה בלוח בקרה, כמו שמתואר בדף התיעוד פרמטרים של לוח בקרה.

למרכזי בקרה עם פריסות tile או static

הפרמטר height מגדיר את הגובה של רכיב ביחידות של tile_size (שמוגדר בפיקסלים), עבור לוחות בקרה של layout: tile ושל layout: static.

לדוגמה, הקוד הבא מציין את הערכים tile_size: 100 ו-height: 4, כך שהגובה של רכיב orders_by_date יהיה 400 פיקסלים.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

למרכזי בקרה עם פריסה של newspaper

הפרמטר height מגדיר את הגובה של רכיב, ביחידות של שורה, בלוחות בקרה של layout: newspaper.

גובה ברירת המחדל של רכיב בלוח בקרה עם פריסה של עיתון הוא 6 שורות, או בערך 300 פיקסלים. הגובה המינימלי הוא שורה אחת ללוחות בקרה עם פרמטר preferred viewer שהערך שלו הוא dashboards-next. הגובה המינימלי הוא 2 שורות ללוחות בקרה עם פרמטר preferred viewer שהערך שלו הוא dashboards.

לדוגמה, הקוד הבא מגדיר את הגובה של רכיב מסוים ל-12 שורות, כלומר פי שניים מהגובה של רכיבים אחרים שמוגדרים כברירת המחדל:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

הקטע הזה מתייחס לפרמטר width שהוא חלק מרכיב לוח בקרה.

אפשר להשתמש ב-width גם כחלק מלוח בקרה, כמו שמתואר בדף התיעוד פרמטרים של לוח בקרה.

הפרמטר width מגדיר את הרוחב של אלמנט ביחידות של tile_size, עבור לוחות בקרה של layout: tile ושל layout: static.

לדוגמה, הקוד הבא מציין tile_size: 100 ו-width: 4, כך שהרוחב של רכיב orders_by_date יהיה 400 פיקסלים.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

הפרמטר width מגדיר את הרוחב של אלמנט ביחידות של עמודות, בלוחות בקרה של layout: newspaper.

רוחב ברירת המחדל של לוח בקרה עם פריסה של עיתון הוא 24 עמודות.

לדוגמה, הקוד הבא מגדיר את הרוחב של הרכיב לחצי מהרוחב של לוח הבקרה:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

הפרמטר top מגדיר את המיקום של רכיב מלמעלה למטה, ביחידות של tile_size, בלוחות בקרה של layout: static.

לדוגמה, הקוד הבא מציין את הערכים tile_size: 100 ו-top: 4, וממקם את הקצה העליון של רכיב orders_by_date במרחק של 400 פיקסלים מהחלק העליון של מרכז הבקרה.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

הפרמטר left מגדיר את המיקום של רכיב משמאל לימין, ביחידות של tile_size, בלוחות בקרה של layout: static.

לדוגמה, הקוד הבא מציין את tile_size: 100 ו-left: 4, וממקם את הקצה השמאלי של רכיב orders_by_date במרחק של 400 פיקסלים מהצד השמאלי של לוח הבקרה.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

במרכזי בקרה מסוג layout: newspaper, הפרמטר row מגדיר את השורה שבה הקצה העליון של רכיב ממוקם.

לוח בקרה מתחיל בשורה 0 בחלק העליון של לוח הבקרה. בלוח בקרה עם פריסה של עיתון, גובה הרכיב הוא כברירת מחדל 6 שורות, כלומר הרכיבים בלוח הבקרה בחלק העליון של לוח הבקרה (row: 0) יתפסו כברירת מחדל את השורות 0 עד 5.

גובה כל שורה הוא 50 פיקסלים, כלומר גובה ברירת המחדל של רכיב עם 6 שורות הוא 300 פיקסלים.

לדוגמה, הקוד הבא מגדיר שרכיב יוצג בשורה השנייה של הרכיבים בלוח הבקרה, בהנחה שהרכיבים מוגדרים בגובה ברירת המחדל:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

במקרה של לוחות בקרה מסוג layout: newspaper, הפרמטר col מגדיר את העמודה שבה ממוקם הקצה השמאלי של האלמנט.

לוחות הבקרה מחולקים ל-24 עמודות. מרכז הבקרה מתחיל בעמודה 0 בצד ימין של מרכז הבקרה. לוח בקרה עם פריסת עיתון מוגדר כברירת מחדל לרוחב של 8 עמודות לרכיב, כלומר רכיבי לוח הבקרה בצד ימין של לוח הבקרה (col: 0) יתפסו כברירת מחדל את עמודות 0 עד 7.

לדוגמה, הקוד הבא מגדיר רכיב שיוצג בעמודה השלישית של הרכיבים בלוח הבקרה:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

פרמטרים של טקסט

לוחות בקרה של LookML שנוצרים מטקסטים שנוצרו באמצעות האפשרות טקסט בממשק המשתמש של Looker לא ישתמשו בפרמטרים title_text או subtitle_text.

אפשר להשתמש בפרמטרים שמתוארים בקטע הזה כדי להוסיף תוכן לרכיב של לוח בקרה ב-LookML של type: text.

title_text

הפרמטר title_text מציין את הטקסט שיופיע ברכיב type: text בגודל הגופן הגדול ביותר שזמין. הוא מוצג בחלק העליון של האריח.

title_text: title text

subtitle_text

הפרמטר subtitle_text מציין את הטקסט שיופיע ברכיב type: text בגודל הגופן האמצעי שזמין. אם יש title_text, הסמל subtitle_text יופיע מתחתיו.

subtitle_text: subtitle text

body_text

הפרמטר body_text מציין את הטקסט שיופיע ברכיב type: text בגודל הגופן הקטן ביותר שזמין. הפרמטר הזה מוצג אחרון בכרטיס הטקסט. בדף התיעוד שימוש ב-Markdown במשבצות Markdown יש סקירה כללית של Markdown שאפשר להשתמש בו כדי לעצב טקסט או כדי להוסיף קישורים ותמונות למשבצת טקסט.

body_text: body text