このページでは、dashboard.lkml
ファイルに LookML ダッシュボード パラメータを使用して、type: looker_funnel
の LookML ダッシュボード要素を追加してカスタマイズする方法について説明します。
Looker UI から目標到達プロセス グラフを作成する方法については、目標到達プロセス グラフのオプション ページをご覧ください。
パラメーター定義
パラメーター名 | 説明 | |
---|---|---|
基本パラメータ | ||
name (要素の場合) |
要素を作成する | |
title (要素の場合) |
要素名のユーザーへの表示方法を変更します | |
type (要素の場合) |
要素で使用するビジュアリゼーションのタイプを決定します。 | |
height (要素の場合) |
layout: tile および layout: static ダッシュボードの要素の高さを tile_size の単位で定義します |
|
width (要素の場合) |
layout: tile および layout: static ダッシュボードの要素の幅を tile_size の単位で定義します |
|
top |
layout: static ダッシュボードで、要素の上から下への位置を tile_size の単位で定義します。 |
|
left |
layout: static ダッシュボードの要素の左から右への位置を tile_size の単位で定義します |
|
row |
layout: newspaper ダッシュボードの要素の上から下の位置を、行単位で定義します。 |
|
col |
layout: newspaper ダッシュボードの要素の左から右への位置を列単位で定義します |
|
refresh (要素の場合) |
要素が自動的に更新される間隔を設定します | |
note |
LookML のセクションを開始して、要素のメモを定義します。このパラメータには、text 、state 、display のサブパラメータがあります。 |
|
クエリ パラメータ | ||
model |
要素のクエリに使用するモデルを定義します。 | |
explore (要素の場合) |
要素のクエリに使用する Explore を定義します。 | |
dimensions |
要素のクエリに使用するディメンションを定義します。 | |
measures |
要素のクエリに使用するメジャーを定義します。 | |
sorts |
要素のクエリに使用する並べ替えを定義します | |
pivots |
要素のクエリに使用するためにピボットする必要があるディメンションを定義する | |
limit |
要素のクエリに使用する行数制限を定義します。 | |
filters (要素の場合) |
要素のクエリで変更できないフィルタを定義します。 | |
listen |
filters (ダッシュボード用)が作成された場合に、要素のクエリで変更できるフィルタを定義します。 |
|
query_timezone |
クエリの実行時に使用するタイムゾーンを定義します | |
merged_queries |
マージされた結果クエリを定義 | |
hidden_fields |
クエリで使用する(グラフには表示しない)フィールドを指定します。 | |
軸パラメータ | ||
leftAxisLabelVisible |
ラベルを左軸に適用するかどうかを指定します | |
leftAxisLabel |
左軸のラベルを指定します | |
rightAxisLabelVisible |
ラベルが右軸に適用されるかどうかを指定します | |
rightAxisLabel |
右軸のラベルを指定します | |
バー パラメータ | ||
color_application |
ダッシュボード要素にカラーパレットを適用します。このパラメータのサブパラメータは collection_id と palette_id です。 |
|
smoothedBars |
目標到達プロセス グラフの各バーの外縁を、その上および下のバーに接続するかどうかを指定します。 | |
isStepped |
追加 21.16 目標到達プロセス グラフをステップ型の目標到達プロセスのスタイルで表示するかどうかを指定します。 | |
orientation |
目標到達プロセス グラフのデータを表の行と列のどちらから取得するかを指定します | |
labelScale |
グラフの棒の上部とグラフの両側に配置されるラベルのサイズを指定します | |
ラベルのパラメータ | ||
labelPosition |
グラフでのデータラベルの表示場所を指定します | |
percentType |
各棒に割合を割り当てるかどうかを指定します | |
percentPosition |
グラフ内の棒の割合が表示される場所を指定します | |
valuePosition |
データ値をグラフ上で表示する場所を指定します | |
labelColorEnabled |
グラフのラベルと割合にカスタム色を設定するかどうかを指定します | |
labelColor |
ラベルとパーセンテージのカスタム色を指定します |
基本パラメータ
LookML ダッシュボード要素を定義する場合は、少なくとも name
と type
の基本パラメータの値を指定する必要があります。その他の基本パラメータ(title
、height
、width
など)は、ダッシュボード上の要素の外観と位置に影響します。
name
このセクションでは、ダッシュボード要素の一部である
name
パラメータについて説明します。
name
はダッシュボード フィルタの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
name
の宣言ごとに新しいダッシュボード要素が作成され、名前が割り当てられます。要素名は一意である必要があります。layout: grid
ダッシュボードを使用している場合、名前が elements
パラメータで参照されることがあります。
- name: orders_by_date
title
このセクションでは、ダッシュボード要素の一部である
title
パラメータについて説明します。
title
はダッシュボードの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
title
はダッシュボード フィルタの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
title
パラメータを使用すると、要素名のユーザーへの表示方法を変更できます。指定しない場合、タイトルはデフォルトで要素 name
に設定されます。
次の例を考えてみましょう。
- name: sales_overview
title: '1) Sales Overview'
この形式を使用すると、要素は [販売の概要] ではなく [1)販売の概要] と表示されます。
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
さまざまなタイプの LookML ダッシュボード要素の概要については、type
(LookML ダッシュボード用)のドキュメントをご覧ください。
height
このセクションでは、ダッシュボード要素の一部である
height
パラメータについて説明します。
height
は、ダッシュボードの行の一部として使用することもできます。詳しくは、ダッシュボード パラメータのドキュメントをご覧ください。
tile
または static
レイアウトのダッシュボードの場合
height
パラメータは、layout: tile
ダッシュボードと layout: static
ダッシュボードの要素の高さを tile_size
(ピクセル単位で定義)単位で定義します。
たとえば、次のコードでは 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 行です。ダッシュボードの高さの最小値は 2 行で、preferred viewer
パラメータを dashboards
に設定します。
たとえば、次のコードは、要素の高さを 12 行、またはデフォルトに設定されている他の要素の高さの 2 倍に設定します。
- 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
パラメータは、layout: static
ダッシュボードの要素の上から下の位置を tile_size
の単位で定義します。
たとえば、次のコードでは、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
パラメータは、要素の上端を配置する行を定義します。
ダッシュボードの先頭は行 0 です。新聞レイアウトのダッシュボードでは、要素の高さはデフォルトで 6 行になっています。つまり、ダッシュボードの上部にあるダッシュボード要素(row: 0
)では、デフォルトで 0 ~ 5 の行が使用されます。
各行の高さは 50 ピクセルです。つまり、デフォルトの要素の高さは 6 で、300 ピクセルです。
たとえば次のコードは、要素がデフォルトの高さに設定されていると仮定して、要素を要素の 2 行目に設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
row: 6
...
col
layout: newspaper
ダッシュボードの場合、col
パラメータは、要素の左端を配置する列を定義します。
ダッシュボードは 24 列に分かれています。ダッシュボードの左側 0 から始まるダッシュボード。新聞レイアウトのダッシュボードの要素幅は、デフォルトで 8 列になります。つまり、ダッシュボードの左側にある col: 0
要素では列 0 ~ 7 がデフォルトで表示されます。
たとえば、次のコードでは、ダッシュボードの要素の 3 列目に設定する要素を設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
refresh
このセクションでは、ダッシュボード要素の一部である
refresh
パラメータについて説明します。
refresh
はダッシュボードの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
refresh
パラメータを使用すると、要素を定期的に再読み込みすることで、最新のデータを取得できます。これは、オフィスのテレビなど、常にダッシュボードが表示される設定で役立ちます。このパラメータを有効にするには、ダッシュボードをブラウザ ウィンドウで開く必要があります。この設定は、ダッシュボードのキャッシュを「ウォームアップ」するためにバックグラウンドで実行されることはありません。
リフレッシュ レートは、秒、分、時間、日の任意の数値(小数点なし)にできます。例:
- name: orders_by_date
refresh: 2 hours
更新間隔を短く設定する場合は注意が必要です。この要素の背後にあるクエリがリソースを大量に消費する場合、特定の要素が原因でデータベースに過大な負荷がかかる可能性があります。
note
次のように、要素に説明的なメモを追加できます。
- name: element_name
note:
text: 'note text'
state: collapsed | expanded
display: above | below | hover
note
には、サブパラメータ text
、state
、display
があります。
text
text
サブパラメータは、メモに表示されるテキストを指定します。テキストはローカライズできます。
state
state
サブパラメータは、要素の幅内の 1 行に収まらないほど大きいメモを collapsed
と expanded
のどちらにするかを決定します。collapsed
を選択してメモが長すぎる場合は、メモの最後に表示される省略記号(...
)が表示されます。これを使用してメモの全文を読むことができます。
display
display
サブパラメータは、要素にメモが表示される場所を決定します。above
はメモを要素の上部に配置し、below
はメモを要素の下に配置します。hover
では、ユーザーが要素にカーソルを合わせるとメモが表示されます。
クエリ パラメータ
type: looker_funnel
の LookML ダッシュボード要素を定義する場合は、model
および explore
クエリ パラメータと、dimensions
パラメータおよび measures
パラメータを使用してディメンションとメジャーを少なくとも 1 つずつ指定する必要があります。
model
model
パラメータは、要素クエリに使用するモデルを定義します。指定しない場合は、デフォルトでダッシュボードが存在するモデルになります。
- name: orders_by_date
model: ecommerce
model
パラメータは、LookML 定数を受け入れます。プロジェクトのマニフェスト ファイルで定数を定義してから、構文 "@{constant_name}"
を使用して定数を model
の値として設定できます。定数を使用すると、1 つのモデル名を 1 か所で定義できます。これは、複数のダッシュボード要素で使用されるモデルの名前を更新する場合に特に便利です。
LookML ダッシュボードで定数の詳細と使用例については、constant
パラメータのドキュメント ページをご覧ください。
explore
このセクションでは、ダッシュボード要素の一部である
explore
パラメータについて説明します。
explore
は、モデルの一部として使用することもできます。詳しくは、explore
パラメータのドキュメントをご覧ください。
explore
はダッシュボード フィルタの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
explore
パラメータは、要素クエリに使用する Explore を定義します。
- name: orders_by_date
explore: order
explore
パラメータは、LookML 定数を受け入れます。プロジェクトのマニフェスト ファイルで定数を定義してから、構文 "@{constant_name}"
を使用して定数を explore
の値として設定できます。定数を使用すると、1 つの場所で Explore の名前を定義できます。これは、複数のダッシュボード要素で使用される Explore の名前を更新する場合に特に便利です。
LookML ダッシュボードで定数の詳細と使用例については、constant
パラメータのドキュメント ページをご覧ください。
dimensions
dimensions
パラメータは、要素クエリに使用するディメンションを定義します。ディメンションを指定するには、構文 view_name.dimension_name
を使用します。クエリに dimensions
を含めない場合は、含めないでください。
## single dimension example
- name: orders_by_date
dimensions: order.order_date
## multiple dimension example
- name: orders_by_date
dimensions: [order.order_date, customer.name]
measures
measures
パラメータは、要素クエリに使用するメジャーを定義します。構文は view_name.measure_name
を使用してメジャーを指定します。クエリに measures
を含めない場合は、含めないでください。
## single measure example
- name: orders_by_date
measures: order.count
## multiple measure example
- name: orders_by_date
measures: [order.count, order_item.count]
sorts
sorts
パラメータは、要素クエリに使用する並べ替えを定義します。1 番目、2 番目、3 と順に表示されます。構文 view_name.field_name
は、ディメンションまたはメジャーを指定するときに使用します。Looker のデフォルトの並べ替え順を使用する場合は、sorts
を含めないでください。降順にする場合、末尾には desc
を付けます。昇順で並べ替える場合は、接尾辞は不要です。
## single sort example
- name: orders_by_date
sorts: order.order_date desc
## multiple sort example
- name: orders_by_date
sorts: [order.order_date desc, customer.name]
pivots
pivots
パラメータは、要素クエリ用にピボットするディメンションを定義します。ディメンションを指定するには、構文 view_name.dimension_name
を使用します。クエリに pivots
を含めない場合は、含めないでください。
## single pivot example
- name: orders_by_date
pivots: customer.gender
## multiple pivot example
- name: orders_by_date
pivots: [customer.gender, customer.age_tier]
limit
limit
パラメータでは、要素クエリに使用する行数制限を定義します。この制限は、ピボットが適用される前の行数に適用されます。
- name: orders_by_date
limit: 100
filters
このセクションでは、ダッシュボード要素の一部である
filters
パラメータについて説明します。
filters
はダッシュボードの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。
filters
は、メジャーの一部として使用することもできます。詳しくは、filters
パラメータのドキュメントをご覧ください。
filters
パラメータは、要素のクエリに使用する変更できないフィルタを定義します。ユーザーがダッシュボードで変更できるフィルタが必要な場合は、ダッシュボードの filters
を使用してフィルタを設定し、listen
を使用して要素に適用する必要があります。
filters
の構文は次のとおりです。
- name: element_name
filters:
orders.created_date: 2020/01/10 for 3 days
orders.status: Shipped
# You can create multiple filter statements
各フィルタは、Looker のフィルタ式または値定数を受け入れることができます。フィルタ式で _localization
または _user_attributes
Liquid 変数を使用して柔軟なフィルタ値を指定することもできます。
listen
ダッシュボードには、ユーザーがダッシュボード要素の背後にあるデータを変更できるフィルタを含めることができます。これらは、ダッシュボードの filters
パラメータを使用して設定します。フィルタが要素に影響するには、listen
パラメータを使用して、フィルタの要素が「リッスン」に設定する必要があります。
listen
の構文は次のとおりです。
- name: element_name
listen:
filter_name_goes_here: dimension or measure on which to apply
the filter using view_name.field_name syntax
# You can add more than one listen statement
たとえば、[日付] というフィルタを作成し、ユーザーが UI のフィルタ フィールドに日付を入力する必要があるとします。その後、ユーザーが入力した値を次のように orders_by_date
要素に適用できます。
- dashboard: sales_overview
...
filters:
- name: date
type: date_filter
elements:
- name: orders_by_date
listen:
date: order.order_date
...
このコンセプトの詳細については、LookML ダッシュボードの構築のドキュメントをご覧ください。
query_timezone
query_timezone
パラメータでは、クエリを実行するタイムゾーンを指定します。タイムゾーン オプションは、timezone
の値のドキュメント ページに表示されます。閲覧者のタイムゾーンを使用してクエリを実行する場合は、値を user_timezone
として割り当てます。
- name: orders_by_date
query_timezone: America/Los Angeles
- name: orders_by_customer
query_timezone: user_timezone
merged_queries
merged_queries
パラメータでは、複数のクエリから結果を結合する方法を定義します。コンポーネント クエリを merged_queries
パラメータの下に定義し、join_fields
サブパラメータを使用してマージルールを定義します。
merged_queries
の構文は次のとおりです。
merged_queries:
- 'primary query definition'
- 'next source query definition'
join_fields:
- field_name: 'field from the source query using the view_name.field_name syntax'
source_field_name: 'joined field from the primary query using the
view_name.field_name syntax'
# more join_fields definitions as needed
- 'next source query definition'
join_fields:
- field_name: view_name.field_name
source_field_name: view_name.field_name
# more join_fields definitions as needed
# additional source queries and join_fields definitions as needed
merged_results
で定義された最初のクエリがプライマリ クエリであり、他のクエリはそのクエリと統合されます。
たとえば、銘柄コード、会社名、Twitter ユーザー名で結合すると、2 つのクエリを統合して、会社名、会社の Twitter ユーザー名、IPO の年、銘柄コード、従業員数、求人数の結果を返すことができます。
- name: merged_results_element
title: Merged Results Tile
merged_queries:
- model: market_research
explore: company_info
fields: [company.name, company.twitter_username, ipo.public_year, ipo.stock_symbol]
filters:
company.twitter_username: "-NULL"
ipo.valuation_amount: NOT NULL
sorts: [ipo.public_year desc]
- model: crunchbase
explore: companies
fields: [companies.name, ipo.stock_symbol, companies.twitter_username,
companies.number_of_employees, jobs.job_count]
filters:
companies.number_of_employees: NOT NULL
ipo.stock_symbol: "-NULL"
companies.twitter_username: "-NULL"
sorts: [jobs.job_count desc]
join_fields:
- field_name: ipo.stock_symbol
source_field_name: ipo.stock_symbol
- field_name: companies.name
source_field_name: company.name
- field_name: companies.twitter_username
source_field_name: company.twitter_username
データの結果は次のようになります。
次に、要素パラメータを適用して、お好みでビジュアリゼーションのスタイルを設定できます。
hidden_fields
hidden_fields
パラメータは、クエリで使用されているがグラフには表示されていないフィールドを指定します(存在する場合)。非表示になっているフィールドは、Explore のデータテーブル セクションに表示されます。
hidden_fields: [inventory_items.count, distribution_centers.id]
軸パラメータ
このセクションで説明するパラメータのほとんどは、目標到達プロセスグラフの可視化エディタの軸セクションのオプションに対応しています。
leftAxisLabelVisible
このパラメータは、ラベルを左軸に適用するかどうかを決定します。
leftAxisLabelVisible: true | false
leftAxisLabel
左軸のラベルを指定します。leftAxisLabelVisible
パラメータは true
に設定する必要があります。
leftAxisLabel: Year
rightAxisLabelVisible
このパラメータは、ラベルが右軸に適用されるかどうかを決定します。
rightAxisLabelVisible: true | false
rightAxisLabel
右軸のラベルを指定します。rightAxisLabelVisible
パラメータは true
に設定する必要があります。
rightAxisLabel: Count
棒のパラメータ
このセクションで説明するパラメータのほとんどは、目標到達プロセスグラフの可視化エディタのバー セクションにあるオプションに対応しています。
color_application
color_application
パラメータと、そのサブパラメータ collection_id
および palette_id
を使用して、特定の色コレクションとパレットをダッシュボード要素に適用できます。Looker のネイティブ カラー コレクションの概要については、カラー コレクションのドキュメント ページをご覧ください。
使用するパレット用のコレクション ID とパレット ID がある場合は、collection_id
と palette_id
のサブパラメータにその ID を入力します。コレクション ID またはパレット ID は、英数字のコードの場合もあれば、カラー コレクションの名前に基づく場合もあります。英数字のコードは Looker のネイティブ コレクションに使用されます。これらはインスタンス固有で、次のようになります。
color_application:
collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1
カスタム カラー コレクションは、カラー コレクションの名前に基づくコレクション ID とパレット ID を使用します。この ID はインスタンス間で移植可能で、次のようになります。
color_application:
collection_id: blue-tone-collection
palette_id: blue-tone-collection-categorical-0
また、UI を使って必要な色、コレクション、パレットを見つけて、LookML を生成してダッシュボードに追加することもできます。ユーザー定義コンテンツ(Look、ダッシュボード、Explore など)に移動し、UI を使用してコンテンツのビジュアリゼーションに適用する色、コレクション、パレットを適用します。完了したら、ダッシュボード LookML を取得する手順に従って、生成された LookML をコピーし、color_application
セクションに貼り付けます。
smoothedBars
目標到達プロセス グラフの各バーの外縁を、その上および下のバーに接続するかどうかを指定します。
smoothedBars: true | false
isStepped
目標到達プロセス グラフをステップ型の目標到達プロセスのスタイルで表示するかどうかを指定します。このパラメータは、従来のダッシュボードには適用されません。
isStepped: true | false
orientation
orientation
パラメータは、目標到達プロセスのグラフのデータを表の行と列のどちらから取得するかを決定します。orientation
を automatic
に設定することもできます。これにより、目標到達プロセスのグラフでは、データポイントが最も多い場所に基づいてデータが選択されます。
orientation: automatic | rows | columns
labelScale
グラフの棒の上部とグラフの両側に配置されるラベルのサイズを指定します。ラベルの最小サイズと最大サイズは、グラフのサイズによって異なります。ラベルを最小サイズに指定するには、labelScale
を '0'
に設定します。ラベルが最大サイズになるように、labelScale
を '1'
に設定します。0 ~ 1 までの数値でパーセンテージを示します。ラベルのサイズは、最小サイズから最大サイズまでのパーセンテージに設定されます。
labelScale: '0.5'
ラベルのパラメータ
このセクションで説明するパラメータのほとんどは、目標到達プロセスグラフの可視化エディタのラベル セクションにあるオプションに対応しています。
labelPosition
グラフ上でデータラベルを表示する場所を指定します。labelPosition
パラメータには、次の値を指定できます。
left
: データラベルはグラフの左側に表示されます。inline
: データラベルはグラフの中央、グラフバーの中に表示されます。right
: データラベルはグラフの右側にあります。hidden
: データラベルは表示されません。
labelPosition: left | inline | right | hidden
percentType
グラフの各棒に割合の値を割り当てるかどうかを指定します。percentType
パラメータでは、棒グラフの値とグラフの最大値(total
)を比較したり、棒グラフの値と前の棒グラフ(prior
)を比較したりして、各棒に割合を割り当てるかどうかを設定します。
percentType: total | prior
percentPosition
グラフ上で棒の割合が表示される場所を指定します。percentPosition
パラメータには、次の値を指定できます。
left
: 割合はグラフの左側に表示されます。inline
: 割合ラベルは、グラフの中央、グラフバーの内側に表示されます。right
: 割合グラフはグラフの右側に表示されます。hidden
: 割合ラベルは表示されません。
valuePosition
グラフ上でデータ値が表示される場所を指定します。valuePosition
パラメータには、次の値を指定できます。
left
: データ値はグラフの左側にあります。inline
: データ値はグラフの中央、グラフバーの内側にあります。right
: データ値はグラフの右側に表示されます。Hidden
: データ値は表示されません。
labelColorEnabled
labelColorEnabled
パラメータを使うと、グラフ内のラベルや割合にカスタムの色を設定できます。
labelColorEnabled: true | false
labelColor
labelColorEnabled
が true
に設定されている場合は、labelColor
パラメータを使用して、ラベルとパーセンテージのカスタム色を指定します。labelPosition
が inline
に設定されているラベルは選択した色で表示され、グラフの両側にあるラベルは選択した色よりも約 40% 暗くなります。
labelColor: "#4FBC89"