Anda sedang melihat dokumentasi untuk Looker 26.0. Klik link ini untuk melihat dokumentasi terbaru.

Parameter tombol untuk dasbor LookML

Tombol hanya didukung oleh dasbor LookML dengan setelan berikut:

preferred_viewer ditetapkan ke dashboards-next
layout ditetapkan ke newspaper

Halaman ini menunjukkan cara menambahkan dan menyesuaikan elemen dasbor LookML type: button dengan parameter dasbor LookML dalam file dashboard.lkml. Tombol berguna untuk menempatkan link dalam dasbor Anda. Anda dapat menautkan ke konten Looker, seperti Look dan dasbor, atau ke situs lain.

Untuk mengetahui informasi tentang cara menambahkan tombol ke dasbor melalui UI Looker, lihat halaman dokumentasi Membuat dasbor yang ditentukan pengguna.

Contoh penggunaan


## BASIC PARAMETERS
type: button
name: text
height: N
width: N
row: N
col: N

## BUTTON PARAMETER
rich_content_json: '{
 "text": "button text",
 "description": "description",
 "newTab": true | false,
 "alignment": "left" | "right" | "center",
 "size": "small" | "medium" | "large",
 "style": "OUTLINED" | "FILLED" | "TRANSPARENT",
 "color": "hex string or css color",
 "href": "link"
 }'

Definisi parameter

Nama Parameter	Deskripsi
Parameter Dasar
`type` (untuk elemen)	Menentukan jenis visualisasi yang akan digunakan dalam elemen
`name` (untuk elemen)	Membuat elemen
`height` (untuk elemen)	Menentukan tinggi kotak kartu elemen tombol. Tinggi dinyatakan dalam satuan baris untuk dasbor `layout: newspaper`
`width` (untuk elemen)	Menentukan lebar kotak kartu elemen tombol. Lebar dalam unit kolom untuk dasbor `layout: newspaper`
`row`	Menentukan posisi atas ke bawah kotak petak elemen tombol dalam satuan baris untuk dasbor `layout: newspaper`
`col`	Menentukan posisi kiri ke kanan kotak petak elemen tombol dalam satuan kolom untuk dasbor `layout: newspaper`
Parameter Tombol
`rich_content_json`	Objek JSON yang berisi key/value pair dengan informasi tentang tombol

Parameter dasar

Saat menentukan elemen dasbor LookML type: button, Anda harus menentukan nilai untuk setidaknya parameter name dan type.

Parameter height, width, row, dan col berlaku untuk kotak kartu elemen tombol, bukan untuk tombol itu sendiri.

`name`

Bagian ini mengacu pada parameter name yang merupakan bagian dari elemen dasbor.

name juga dapat digunakan sebagai bagian dari filter dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Setiap deklarasi name membuat elemen dasbor baru dan menetapkan nama untuknya. Nama elemen harus unik.

name yang diberikan ke tombol tidak akan muncul di UI dasbor.

- name: orders_by_date

`type`

Bagian ini mengacu pada parameter type yang merupakan bagian dari elemen dasbor.

type juga dapat digunakan sebagai bagian dari filter dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

type juga dapat digunakan sebagai bagian dari gabungan, yang dijelaskan di halaman dokumentasi parameter type (untuk gabungan).

type juga dapat digunakan sebagai bagian dari dimensi, yang dijelaskan di halaman dokumentasi Jenis dimensi, filter, dan parameter.

type juga dapat digunakan sebagai bagian dari pengukuran, yang dijelaskan di halaman dokumentasi Jenis pengukuran.

Parameter type menentukan jenis visualisasi yang akan digunakan dalam elemen.

- 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_geo_coordinates | looker_geo_choropleth | looker_waterfall |
        looker_wordcloud | looker_boxplot | button

Lihat halaman dokumentasi type (untuk dasbor LookML) untuk mengetahui ringkasan berbagai jenis elemen dasbor LookML.

`height`

Bagian ini mengacu pada parameter height yang merupakan bagian dari elemen dasbor.

height juga dapat digunakan sebagai bagian dari baris dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Parameter height menentukan tinggi kotak petak elemen tombol, dalam satuan baris.

Kotak kartu elemen tombol secara default memiliki tinggi 6 baris. Tinggi minimum adalah 1 baris. Mengubah tinggi elemen tombol dapat memengaruhi elemen lain di dasbor, tetapi tidak akan memengaruhi tinggi tombol itu sendiri.

Misalnya, kode berikut menetapkan kotak petak tombol agar memiliki tinggi 12 baris:

- dashboard: sales_overview
  layout: newspaper
  ...

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

`width`

Bagian ini mengacu pada parameter width yang merupakan bagian dari elemen dasbor.

width juga dapat digunakan sebagai bagian dari dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Parameter width menentukan lebar kotak petak elemen tombol, dalam satuan kolom.

Lebar kotak kartu elemen tombol secara default adalah 8 kolom, yang merupakan sepertiga dari lebar penuh dasbor. Lebar minimum untuk kotak kartu tombol adalah 2.

Misalnya, kode berikut menetapkan kotak kartu tombol menjadi setengah lebar dasbor:

- dashboard: sales_overview
  layout: newspaper
  ...

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

Jika ada ruang di dalam kotak kartu tombol, lebar tombol akan bertambah untuk mengakomodasi string teks yang panjang, yang ditentukan dalam text. Namun, lebar tombol tidak akan bertambah melebihi nilai yang ditetapkan dalam parameter width; dan, jika perlu, string yang ditentukan dalam text akan dipangkas pada tombol.

`row`

Parameter row menentukan baris tempat tepi atas kotak ubin elemen tombol ditempatkan.

Dasbor dimulai dengan baris 0 di bagian atas dasbor. Elemen tombol dasbor secara default memiliki tinggi elemen 6 baris, yang berarti elemen dasbor di bagian atas dasbor (row: 0) secara default akan menempati baris 0-5.

Dalam contoh berikut, kode menetapkan kotak kartu tombol untuk ditempatkan di baris kedua elemen di dasbor, dengan asumsi elemen ditetapkan pada tinggi default:

- dashboard: sales_overview
  layout: newspaper
  ...

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

`col`

Parameter col menentukan kolom tempat tepi kiri kotak petak elemen tombol ditempatkan.

Dasbor dibagi menjadi 24 kolom. Dasbor dimulai dengan kolom 0 di sebelah kiri dasbor. Dasbor dengan tata letak koran secara default memiliki lebar elemen 8 kolom, yang berarti elemen dasbor di sebelah kiri dasbor (col: 0) secara default akan menempati kolom 0-7.

Misalnya, kode berikut menetapkan elemen yang akan ditetapkan di kolom ketiga elemen di dasbor:

- dashboard: sales_overview
  layout: newspaper
  ...

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

Parameter tombol

Parameter yang dijelaskan di bagian ini dapat digunakan untuk menambahkan konten ke elemen dasbor LookML type: button.

`rich_content_json`

rich_content_json adalah objek JSON dengan beberapa pasangan kunci/nilai yang menentukan karakteristik tombol dasbor.

rich_content_json: '{
 "text": "Go to Sales Dashboard",
 "description": "View sales from the last 18 months.",
 "newTab": true,
 "alignment": "center",
 "size": "medium",
 "style": "FILLED",
 "color": "forestgreen",
 "href":"https://instance_name.looker.com/dashboards/152?State=California&Created+Fiscal+Quarter=2022"
 }'

`text`

text menentukan teks yang akan muncul di tombol di UI dasbor. Tombol akan diperluas lebarnya untuk mengakomodasi teks hingga mencapai batas yang ditetapkan oleh parameter width, dan pada saat itu teks akan dipangkas.

`description`

description menentukan teks yang muncul sebagai tooltip pop-up saat kursor diarahkan ke tombol. Jika tidak ada deskripsi yang diberikan, secara default link yang diberikan di href akan ditampilkan.

`newTab`

newTab adalah Boolean yang menentukan apakah link tombol akan terbuka di tab baru (true) atau terbuka di tab saat ini (false). newTab secara default adalah true.

`alignment`

alignment menetapkan perataan tombol dalam kotak kartu elemen tombol. alignment secara default adalah center.

ukuran

size menetapkan ukuran tombol dan teksnya ke small, medium, atau large. Nilai size tidak memengaruhi ukuran kotak kartu elemen tombol atau parameter height.

`style`

style menetapkan gaya tombol ke salah satu nilai berikut:

FILLED: Isi tombol diisi dengan warna yang ditetapkan di color. Teks tombol berwarna putih. Ini adalah nilai defaultnya.
OUTLINED: Tombol memiliki garis di sekitar tepinya, tetapi bodinya transparan. Warna teks tombol ditetapkan oleh color.
TRANSPARENT: Isi tombol transparan. Warna teks tombol ditetapkan oleh color.

`color`

color menetapkan warna tombol atau teks tombol, bergantung pada setelan style. color secara default menggunakan warna pertama dalam koleksi warna kategoris default instance Looker.

Nilai warna dapat diformat sebagai string hex, seperti #2ca6cd, atau sebagai nama warna CSS, seperti mediumblue.

`href`

href menetapkan URL yang akan dituju pengguna saat mengklik tombol. Link ke dasbor Looker lainnya dapat berisi parameter filter yang menyetel filter dasbor ke nilai tertentu.

Dalam pengalaman sematan, link ke dasbor harus berisi embed/ di URL link.

Parameter tombol untuk dasbor LookML Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Contoh penggunaan

Definisi parameter

Parameter dasar

name

type

height

width

row

col

Parameter tombol

rich_content_json

text

description

newTab

alignment