嵌入式資訊主頁、Look 圖表和探索項目的主題

您可以在「管理」面板的「平台」部分中，透過「主題」頁面定義主題。您可以透過自訂主題，自訂內嵌資訊主頁、Look 和探索的字型系列、文字顏色、背景顏色、按鈕顏色、圖塊顏色和其他視覺元素，以及內嵌資訊主頁中圖塊和 Conversational Analytics 介面的編輯視窗。

本頁面說明下列事項：

如要瞭解如何為資訊主頁和探索設定預設主題，或將主題套用至特定資訊主頁或探索，請參閱「開始嵌入 - 套用自訂主題」說明文件頁面。

使用內嵌主題的執行個體需求

如要在 Looker 執行個體上管理嵌入式主題，請注意下列需求：

  • 如果您的執行個體是 Looker (原始版本) 執行個體，則必須由 Looker 啟用自訂嵌入資訊主頁、Look 圖表和探索項目主題的功能。如要更新這項功能的授權，請與銷售專員 Google Cloud 聯絡。
  • 如果執行個體是 Looker (Google Cloud Core) 執行個體，嵌入式主題適用於企業版和嵌入版 版本，但不適用於標準版。
  • Looker 使用者必須具備管理員角色，或包含manage_themes 權限的角色。

關於「主題」頁面

您可以在「管理」面板的「平台」部分中，前往「主題」頁面管理執行個體的主題。

如果您的執行個體已啟用內部資訊主頁主題 搶先版功能，「主題」頁面會顯示「內部」和「嵌入」分頁，分別用於管理 Looker 資訊主頁和嵌入內容的主題。

預設主題

系統會在執行個體上自動建立 Looker 預設主題，且無法刪除或編輯。除非 Looker 管理員指定其他主題做為預設主題，否則系統會使用 Looker 主題做為預設主題。

選取主題旁的「查看」按鈕，或建立主題副本，即可查看 Looker 主題設定，這些設定會歸類到下列各節：

主題

設定名稱 值
名稱 Looker

一般

這個專區中的設定會套用至內嵌資訊主頁、內嵌探索和對話式數據分析介面。

設定名稱 值 附註
按鍵顏色 #1A73E8 資訊主頁的主要按鈕和篩選器控制項會使用這個顏色。

探索頁面的主要按鈕、橫幅和強調色會使用這個顏色。
文字顏色 #3e3f40
背景顏色 #f6f8fa
字型系列 Roboto、Noto Sans JP、Noto Sans CJK KR、Noto Sans Arabic UI、Noto Sans Devanagari UI、Noto Sans Hebrew、Noto Sans Thai UI、Helvetica、Arial、sans-serif 這些字型由 Looker 應用程式提供，建議使用這些字型，因為瀏覽器和圖片算繪時都會提供這些字型。Looker 會使用字型系列清單中第一個支援字元的字型，因此應優先列出優先順序較高或專用的字型。如果字型有「UI」變體，Looker 會使用這些變體，稍微修改字元，以便更符合視覺元件的界線。
字型來源 無

資訊主頁頁面

設定名稱 值
顏色集合 無
標題字型大小 None
上邊界 None
下邊界 None
左右邊界 None

資訊主頁圖塊

設定名稱 值
標題顏色 #3a4245
文字顏色 #3a4245
內文顏色 無
背景顏色 #ffffff
文字背景顏色 None
標題對齊設定 置中
標題字型大小 無
方塊陰影 無
資料欄間距大小 無
資料列間距大小 無
邊框半徑 無

資訊主頁控制項

設定名稱 值
顯示資訊主頁標頭 是
顯示資訊主頁標題 是
中央資訊主頁標題 否
顯示篩選器列 是
顯示篩選器切換按鈕 是

探索頁面

設定名稱 值
顯示標頭 是
顯示標題 是
顯示上次執行作業 是
顯示時區 是
顯示「執行」按鈕 是
顯示「設定」按鈕 是
顯示資訊主頁的上次更新時間指標 是
顯示「重新載入資料」圖示 是
顯示「更多選項」按鈕 是

Look 圖表頁面

設定名稱 值
顯示標頭 是
顯示標題 是
顯示上次執行作業 是
顯示時區 是
顯示「執行」按鈕 是
顯示「設定」按鈕 是

以下是資訊主頁、資訊主頁圖塊的編輯視窗，以及採用 Looker 主題的「探索」範例。

採用 Looker 主題的資訊主頁範例

使用預設 Looker 主題的內嵌 Looker 資訊主頁。

以 Looker 主題為例，資訊主頁圖塊的編輯視窗

使用預設 Looker 主題的內嵌 Looker 資訊主頁中的「編輯圖塊」對話方塊。

採用 Looker 主題的「探索」頁面範例

使用預設 Looker 主題嵌入的 Looker 探索。

主題和嵌入設定的套用方式

您可以透過自訂主題和網址引數，變更內嵌資訊主頁或探索的預設主題外觀。顯示嵌入式資訊主頁或「探索」時，Looker 會依下列順序套用設定：

  1. 從預設主題的設定開始
  2. 套用網址 theme 引數中指定的自訂主題設定 (如有)
  3. 套用_theme 網址引數中指定的屬性 (如有，僅適用於資訊主頁)

每個項目都會覆寫先前的項目，也就是說，嵌入設定會覆寫預設主題設定，而自訂主題則會覆寫嵌入設定和預設主題。

不過，如果是 _theme 網址引數，只有在 _theme 引數中指定的元素，才會覆寫其他主題或嵌入設定中的元素。系統仍會使用其餘的自訂主題設定和嵌入設定。舉例來說，如果您在內嵌資訊主頁的網址中加入 _theme={"show_filters_bar":false} 引數，即使您已在內嵌設定或自訂主題中開啟「顯示篩選器」，篩選器列也不會顯示。但系統仍會使用自訂主題或其他嵌入設定。

下載資訊主頁時，系統會顯示所有已套用的自訂主題。

建立自訂主題

如要為嵌入式資訊主頁、Look 和探索建立自訂主題，請在「主題」管理頁面中選取「嵌入」分頁，然後按一下「新增主題」。

接著，在「新主題」頁面中，為要自訂的各項設定新增樣式和顏色規格。

除了主題名稱 (必須是專屬名稱) 以外，所有欄位都會自動填入預設主題的值。您可以變更下列各節所述的任何設定。選取「儲存主題」即可保留變更並儲存新主題。

主題

名稱：主題名稱不得重複，且只能包含英數字元和底線。如果您在主題名稱中輸入空格，儲存主題時，空格會替換為底線。

一般

這個專區中的設定會套用至嵌入的資訊主頁和嵌入的探索。

主要顏色：資訊主頁的主要按鈕和篩選器控制項會使用這個顏色。探索頁面的欄位挑選器連結和圖示、主要按鈕、橫幅和強調色會使用這個顏色。

文字顏色：探索和資訊主頁上文字的十六進位顏色代碼。

背景顏色：探索和資訊主頁背景的十六進位顏色代碼。

字型系列：字型系列的名稱。這個字型會用於資訊主頁上的所有文字，包括圖塊標題、文字圖塊和視覺化圖表中的圖例。探索中的所有文字也會使用這個字型。如果字型名稱含有空格，請在名稱前後加上引號，例如「Open Sans」。

  • 如果您使用常見的網頁安全字型，只要在「字型系列」欄位中輸入字型名稱，並將「字型來源」欄位留空即可。如要使用較不常見的字型，請在「字型系列」欄位中輸入字型名稱，然後使用下一個「字型來源」欄位，提供要使用字型定義的網址。

字型來源：除非要使用自訂字型 (非常見的網頁安全字型)，否則請將這個欄位留空。「字型來源」必須是開頭為 https 的完整網址，並指向 @font-face 的 src 引數中指定的 url 值。建議使用網頁開放字型格式 (.woff) 檔案，因為 Internet Explorer 11 不支援 .woff2 檔案。

  • 舉例來說，如果是 PT Sans Narrow，您可以在「字型系列」欄位中輸入「PT Sans Narrow」，然後在「字型來源」欄位中輸入 https://fonts.gstatic.com/s/ptsansnarrow/v7/UyYrYy3ltEffJV9QueSi4RdbPw3QSf9R-kE0EsQUn2A.woff。

使用自訂主題的內嵌探索範例

以下範例顯示具有自訂主題的嵌入式探索。「Key Color」(主要顏色) 設為 #e82042，「Font Family」(字型系列) 設為 Verdana。

在嵌入式設定中執行「探索」時，「探索」中的文字會以指定的「字型系列」字型 (Verdana) 顯示。強調色、按鈕和連結會顯示指定的主色，#e82042：

嵌入式「探索」頁面，其中「新增」按鈕、「前往 LookML」按鈕、齒輪選單按鈕和「快速入門」分析的標題都套用了 #e82042 顏色。

執行探索後，「執行」按鈕外框和文字會以指定的主色顯示，#e82042：

內嵌的「探索」頁面，已將 #e82042 顏色套用至「執行」按鈕。

內嵌資訊主頁圖塊編輯視窗的範例 (採用自訂主題)

除了上一節所述的「探索」元素外，編輯資訊主頁動態磚時，橫幅會以「主要顏色」設定 (#e82042) 中指定的顏色顯示，並採用「字型系列」設定 (Verdana) 中指定的字型：

嵌入式 Looker 資訊主頁中的「編輯動態磚」對話方塊，橫幅套用 #e82042 顏色，且頁面上的所有文字都套用 Verdana 字型系列。

資訊主頁頁面

顏色集合：您可以選擇顏色集合，這是一組相互協調的調色盤，可搭配使用。將顏色集合指派給資訊主頁後，系統會根據集合中的調色盤，為資訊主頁中所有圖塊的所有資料序列上色，確保整個資訊主頁的資料序列顏色一致。

  • 將顏色集合指派給內嵌主題時，主題的顏色集合會覆寫先前指派給動態磚的任何顏色集合。不過，主題的顏色集合不會覆寫指派給資料序列的自訂顏色，也不會覆寫套用至表格圖表的條件式格式設定。

背景顏色：資訊主頁和文字方塊背景的十六進位顏色代碼。

上邊界：選擇性設定資訊主頁頂端的邊界特定值。從下拉式選單中選擇預先定義的選項。邊界是以像素 (px) 為單位測量。

下邊界：視需要為資訊主頁底部的邊界設定特定值。從下拉式選單中選擇預先定義的選項。邊界是以像素 (px) 為單位測量。

左右邊界：選擇性設定資訊主頁左右邊界的特定值。從下拉式選單中選擇預先定義的選項。邊界是以像素 (px) 為單位測量。

資訊主頁圖塊

標題顏色：下列元素的十六進位顏色代碼：

  • 資訊主頁標題
  • 資訊主頁圖塊的標題
  • Markdown 圖塊的標題和第 1 層標題文字
  • 單一值圖表的文字顏色

文字顏色：下列元素的十六進位顏色代碼：

  • 資訊主頁上的文字，包括圖表中的圖例
  • Markdown 資訊方塊的副標題和內文 (標題層級 1 的文字除外)
  • 文字方塊中的標題層級 1、標題層級 2 和一般文字
  • 單一值圖表中的圖塊圖示

內文文字顏色：下列元素的十六進位顏色代碼：

  • Markdown 圖塊中的內文，標題層級 2 和標題層級 3 的文字除外。
  • 文字圖塊中的內文

背景顏色：所有圖塊 (文字圖塊除外) 的背景十六進位顏色代碼。(文字動態磚與資訊主頁使用相同的背景顏色，這是在「資訊主頁」頁面的「背景顏色」部分設定。)

標題對齊方式：將動態磚標題對齊左側、右側或中央。

標題字型大小：您可以從預先定義的字型大小 (以像素為單位) 中選擇，調整資訊主頁動態磚的字型大小。

Box Shadow：使用 CSS 語法在資訊主頁動態磚周圍建立陰影。你可以選取預先定義的方塊陰影，或建立自訂陰影。如要建立自訂方塊陰影，請輸入所需 horizontal-offset vertical-offset blur-radius spread-radius color ，然後選取「輸入自訂樣式」來套用設定。右側會顯示方塊陰影設定的預覽畫面。

欄間距大小：您可以從一組預先定義的大小 (以像素為單位) 中，調整資訊主頁動態磚欄之間的間距大小。

資料列間距大小：您可以從預先定義的像素大小中，選擇調整資訊主頁圖塊資料列之間的間距大小。

邊框半徑：您可以選擇調整資訊主頁圖塊的邊框半徑，建立方角或圓角。

資訊主頁控制項

顯示資訊主頁標頭：停用這個選項即可隱藏整個資訊主頁標頭，包括所有資訊主頁篩選器和控制項。停用這個選項後，所有其他資訊主頁控制選項都會取消選取並停用。

顯示資訊主頁標題：選取核取方塊，即可顯示資訊主頁的標題。

中央資訊主頁標題：選取這個核取方塊，即可在資訊主頁上顯示置中的資訊主頁標題。如果未啟用這個選項，資訊主頁標題會靠左對齊。只有在啟用「顯示資訊主頁標題」選項後，才能使用這個選項。

顯示篩選器列：勾選核取方塊，即可在資訊主頁頂端顯示篩選器列。如果未選取這個選項，系統會取消選取並停用「顯示篩選器切換按鈕」選項，隱藏資訊主頁篩選器圖示。

顯示篩選器切換按鈕：勾選核取方塊，即可顯示資訊主頁篩選器圖示。

顯示資訊主頁的上次更新時間指標：勾選核取方塊，即可顯示資訊主頁的上次更新時間指標。

顯示「重新載入資料」圖示：勾選核取方塊，即可顯示資訊主頁重新載入資料圖示。

顯示「更多選項」按鈕：選取核取方塊即可顯示三點式資訊主頁選單。如果取消勾選這個選項，資訊主頁選單選項就會無法使用。

探索頁面

在自訂主題中，您可以調整內嵌「探索」頁面上的下列元素：

顯示標題：停用這個選項可隱藏內嵌探索的整個標題，包括標題、上次執行指標、資料時區、「執行」按鈕和「探索動作」齒輪選單。

顯示標題：停用這個選項，即可隱藏內嵌探索的標題。

顯示上次執行作業：停用這個選項可隱藏「探索」上次執行的時間。

顯示時區：停用這個選項，即可在內嵌的 Explore 中隱藏資料的時區。

顯示「執行」按鈕：停用這個選項，即可隱藏內嵌「探索」的「執行」按鈕。

顯示動作按鈕：停用這個選項，即可在內嵌的「探索」中隱藏「探索動作」齒輪選單。

Look 圖表頁面

在自訂主題中，您可以調整內嵌 Look 的下列元素：

顯示標頭：停用這個選項可隱藏內嵌 Look 的整個標頭，包括標題、上次執行指標、資料時區、「執行」按鈕和「探索動作」齒輪選單。

顯示標題：停用這個選項，即可隱藏內嵌 Look 的標題。

顯示上次執行作業：停用這個選項，即可隱藏 Look 的執行時間。

顯示時區：停用這個選項，即可在嵌入的 Look 中隱藏資料時區。

顯示「執行」按鈕：停用這個選項，即可隱藏內嵌 Look 中的「執行」按鈕。如果停用「顯示嵌入式 Look 圖表的篩選器」，這個切換按鈕就不會顯示「執行」按鈕。

顯示動作按鈕：停用這個選項，即可在內嵌的 Look 中隱藏「探索動作」齒輪選單。

複製主題

如要複製現有主題，請選取主題的選單，然後選取「複製主題」。

複製主題時，新主題的名稱預設為複製主題的名稱，後面加上「(副本)」。請務必手動將這個名稱改為新的專屬名稱，且只能使用英數字元和底線，並移除括號。

你可以像建立新主題一樣，編輯其餘設定。如需設定說明，請參閱先前介紹的主題設定。請務必選取「儲存」，保留所有主題設定。

編輯主題

系統會在執行個體上自動建立 Looker 主題，且無法編輯。(如要修改 Looker 主題，可以建立主題副本，然後編輯副本)。

如果是其他主題，請選取相關的「編輯」按鈕，更新主題設定。

編輯設定的方式與建立新主題時相同。如需設定說明，請參閱先前介紹的主題設定。請務必選取「儲存」，保留更新內容。

刪除主題

除了 Looker 主題或設為預設的主題外，您可以刪除任何主題。如要刪除主題，請選取主題的選單，然後選取「刪除主題」。

刪除主題後，凡是網址中指定該主題的內嵌資訊主頁，都會使用預設主題。

為嵌入式資訊主頁和探索設定預設主題

嵌入的 Look 不支援自訂主題。自訂主題僅適用於嵌入式資訊主頁和嵌入式探索。

如要為執行個體中內嵌的資訊主頁和探索指定預設主題，請選取主題選單，然後選取「設為預設」。

除非您為個別資訊主頁或探索指定不同設定，否則 Looker 執行個體上的內嵌資訊主頁和探索會使用預設主題。如要進一步瞭解主題和嵌入設定如何套用至嵌入式資訊主頁或「探索」，請參閱本頁面的「主題和嵌入設定的套用方式」一節。

在特定嵌入資訊主頁和探索項目中套用主題

嵌入的 Look 不支援自訂主題。自訂主題僅適用於嵌入式資訊主頁和嵌入式探索。

如要讓資訊主頁或探索使用預設主題以外的主題，可以在嵌入資訊主頁或探索的網址中指定其他主題。如要這麼做，請在嵌入網址結尾加上 theme= 參數和主題名稱。舉例來說，如果主題名稱為「Red」，請在嵌入式資訊主頁網址結尾加入 theme=Red：

https://example.cloud.looker.com/embed/dashboards/246?theme=red

如果是探索，請在嵌入探索網址結尾加上 theme=Red： none https://example.cloud.looker.com/embed/explore/model_name/explore_name?theme=red

網址中的主題元素不區分大小寫，因此可以使用 theme=Red 或 theme=red。

使用 _theme 網址引數套用個別資訊主頁主題元素

您可以使用 _theme 網址引數，為內嵌資訊主頁自訂個別主題元素，例如 tile_background_color 和 show_title。

_theme 網址引數的格式如下：

_theme={"<property>":value}

舉例來說，您可以使用 _theme={"show_filters_bar":false} 隱藏內嵌資訊主頁的篩選器列。完整網址可能如下所示：

https://example.cloud.looker.com/embed/dashboards/236?_theme={"show_filters_bar":false}

使用半形逗號指定多個主題屬性：

_theme={"show_title":false,"show_filters_bar":false,"text_tile_text_color":"blue"}

顏色值必須加上引號，並可使用顏色名稱或十六進位顏色代碼表示。如果使用十六進位代碼，請務必使用 # 符號的網址編碼版本，也就是 %23。舉例來說，這兩個網址引數都會指定紅色：

_theme={"title_color":"red","text_tile_text_color":"%23FF0000"}

使用 _theme 物件嵌入資訊主頁時，請注意下列事項：

  • _theme 網址引數中指定的任何元素，都會覆寫其他主題中該元素的設定。因此 _theme 引數是微調主題或嵌入設定的實用方式。舉例來說，假設您有一個隱藏篩選器列的自訂主題，但您有一個資訊主頁需要顯示篩選器列。您可以為資訊主頁使用自訂主題，然後在內嵌資訊主頁的網址中新增 _theme={"show_filters_bar":true} 引數，在該資訊主頁上顯示篩選器列，但保留所有其他自訂主題設定。如要進一步瞭解主題和嵌入設定如何套用至嵌入式資訊主頁，請參閱本頁的「主題和嵌入設定的套用方式」一節。
  • 如果是程式設計指令碼，您必須對 _theme 引數進行網址編碼。
  • 以 PDF 格式傳送嵌入式資訊主頁時，系統不會套用 _theme 引數。
  • 如果您將資訊主頁下載為 PDF，系統會套用 _theme 引數。