充分運用 Looker 視覺化工具食譜：自訂工具提示

圖表工具提示預設會顯示所選維度和測量指標的值，協助使用者瞭解單一資料點的重要性。

舉例來說，如果地圖圖表是以「Total Gross Margin」(毛利率總額) 為依據，並依「State」(州) 分組，當使用者將滑鼠游標懸停在加州時，工具提示就會顯示這兩個欄位的值。

使用者將游標懸停在加州上，顯示工具提示，其中包含州值「加州」和總毛利率值「$988,018.58」。

不過，如果您想在工具提示中加入預設欄位以外的欄位，讓使用者不必查看其他地方，就能取得更多資訊或資料點的背景資訊，該怎麼做？

您可以自訂工具提示，顯示多個指定欄位的值，包括「探索」查詢中未包含的欄位。

食材

必要條件

如要自訂工具提示，請按照下列步驟操作：

自訂工具提示的注意事項

自訂工具提示時，請務必考量下列事項：

  • html 參數中的值會成為圖表的 Y 軸。
  • 您想在 Y 軸上顯示的值，應為測量指標 sql 參數中的值。
  • 使用任何格式化測量指標 (type: percent_of_total 測量指標，或含有 value_format_name 或 value_format 參數的測量指標) 時，請務必使用 Liquid 語法來表示轉譯值 {{ field_name._rendered_value }} (其中 field_name 是測量指標或維度的實際名稱)。

範例

根據預設，圖表資料點的工具提示會包含「Total Gross Margin」和「State」的值。不過，如果您想提供地圖上未標示或探索查詢中未包含的其他資訊，該怎麼辦？如果想加入「Percent of Total Gross Margin」欄位的值，而非「State」，該怎麼做？加入「總毛利率百分比」，有助於使用者瞭解個別資料點的「總毛利率」值與整個資料集的總毛利率相比如何。

如要自訂工具提示，請按照下列步驟操作：

measure: total_gross_margin {
  type: sum
  value_format_name: decimal_2
  sql: ${gross_margin} ;;
  html: {{ rendered_value }} | {{percent_of_gross_margin._rendered_value }} of total ;;
}

  1. 在開發模式中，前往要自訂欄位的 LookML 定義。

    您可以從「探索」頁面直接前往欄位的 LookML 定義。

  2. 除了原始欄位外，請決定要在工具提示中加入哪些欄位和值。例如「總毛利率百分比」。

  3. 在「探索」查詢中參照並顯示在工具提示中的原始測量指標，新增 html 參數。在本例中，目前在「探索」查詢中，且顯示在工具提示中的測量指標是「Total Gross Margin」。

  4. 在 html 參數中，使用 液體變數 建立運算式，將額外欄位附加至現有測量指標的值。

    • 這個範例使用 Liquid 變數 _rendered_value 顯示 Looker 格式的值。舉例來說，total_gross_margin 會使用 Looker 格式設定顯示兩位小數，percent_of_total_gross_margin 則會使用 Looker 格式設定顯示百分比和兩位小數。
    • 您可以使用直立線字元 | 分隔不同欄位的值。
    • 您也可以附加其他字詞，進一步說明工具提示中顯示的其他值。在這個例子中，of total 是用來釐清百分比值的意義。

  5. 確認程式碼運作正常後，儲存、驗證並推送至正式環境。

現在，當使用者將滑鼠游標懸停在含有工具提示的資料點上時，工具提示會顯示兩個值：資料點的 total_gross_margin 值和對應的 percent_of_total_gross_margin 值。

後續步驟

建立含有自訂工具提示的圖表後，您可以與他人分享：