本页面演示了如何在 dashboard.lkml 文件中使用 LookML 信息中心参数添加和自定义 type: text 的 LookML 信息中心元素。
如需了解如何通过 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 |
定义元素在 layout: static 信息中心内从上到下的位置，以 tile_size 为单位 |
|
left |
以 tile_size 为单位定义元素在 layout: static 信息中心内从左到右的位置 |
|
row |
定义 layout: newspaper 信息中心内元素从上到下的位置（以行为单位） |
|
col |
以列为单位定义 layout: newspaper 信息中心内元素的从左到右位置 |
|
| 文本参数 | ||
title_text |
为 type: text 的信息中心元素指定标题 |
|
subtitle_text |
为 type: text 的信息中心元素指定副标题 |
|
body_text |
为 type: text 的信息中心元素指定正文 |
|
基本参数
定义 type: text 的 LookML 信息中心元素时，您必须至少为 name 和 type 参数指定值。
name
本部分介绍
name参数，该参数是信息中心元素的一部分。
name也可以用作信息中心过滤条件的一部分，如信息中心参数文档页面中所述。
每个 name 声明都会创建一个新的信息中心元素并为其分配一个名称。
元素名称必须是唯一的。当您使用 layout: grid 信息中心时，有时会在 elements 参数中引用名称；当您将元素整理到图块组 (type: group) 中时，有时会在子元素的 group 参数中引用名称。
- 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 | button | group
如需简要了解不同类型的 LookML 信息中心元素，请参阅 type（适用于 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 的信息中心，最小高度为 1 行。对于 preferred viewer 参数设置为 dashboards 的信息中心，最小高度为 2 行。
例如，以下代码会将一个元素设置为 12 行高，即其他设置为默认值的元素的两倍高：
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
height: 12
...
width
本部分介绍
width参数，该参数是信息中心元素的一部分。
width也可以用作信息中心的一部分，如信息中心参数文档页面中所述。
width 参数用于定义 layout: tile 和 layout: static 信息中心内元素的宽度，单位为 tile_size。
例如，以下代码指定了 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 参数用于定义元素在 layout: static 信息中心内从左到右的位置，以 tile_size 为单位。
例如，以下代码指定了 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 参数定义元素上边缘所在的行。如果使用 group 参数将元素放置在图块组内，则 row 会定义元素相对于组容器 (row: 0) 顶部的行位置。
信息中心从顶部的第 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 参数定义元素左边缘所在的列。如果使用 group 参数将元素放置在图块组内，则 col 会定义元素相对于组容器 (col: 0) 左边缘的列位置。
信息中心分为 24 列。信息中心从左侧的第 0 列开始。采用报纸布局的信息中心默认元素宽度为 8 列，这意味着信息中心左侧的信息中心元素 (col: 0) 默认会占用第 0-7 列。
例如，以下代码会将一个元素设置为信息中心内第三列元素：
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
文本参数
通过 Looker 界面中的文本选项创建的文本图块生成的 LookML 信息中心不会使用
title_text或subtitle_text参数。
本部分中介绍的参数可用于向 type: text 的 LookML 信息中心元素添加内容。
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