--- schema_version: "1" id: 90deb520cad71e8af908c42a6a28aeba89a69ad3897c141ce1d43e81fa71ae9a title: 使用自訂格式主題 collection: tableau version: current locale: zh-tw portal_url: https://docs.salesforce.com/tableau/current/zh-tw/pro/desktop/formatting_custom_themes.md canonical_url: https://help.tableau.com/current/pro/desktop/zh-tw/formatting_custom_themes.htm source_site: help.tableau.com content_type: documentation content_hash: f5f7e045365643571c80649e8bc6d1589deb28c8c78a7008384f109ede318a31 description: Use custom formatting themes to apply consistent formatting across workbooks. --- [跳至主要內容](#main-content) # 使用自訂格式主題 Tableau 隨附安裝許多格式設定選項，以便自訂視覺效果和儀表板以滿足需求。如果對許多工作簿使用相同的格式，或者有更適合業務的特殊字體和顏色，則可以使用自訂格式主題來節省時間。自訂主題可快速將格式選擇套用到整個 Tableau 工作簿。 可以透過匯入指定格式設定所選的 JSON 檔案來將自訂主題新增至 Tableau 工作簿。同樣地，如果正在檢視工作簿並且想要在另一個工作簿上使用相同的主題，則可以匯出自訂主題檔案。 注意：此功能僅在 Tableau Desktop 2025.1 中可用。 ## 匯入自訂主題 1. 開啟 Tableau Desktop 並建立一個工作表。 2. 從工具列中選取格式。 3. 選取匯入自訂主題... ![選擇「匯入自訂主題」選項的格式功能表。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/formatting_import_customtheme.png) 4. 選取要匯入的 JSON 檔案並選取開啟。 將出現一個對話方塊，其中包含覆寫或保留所做的任何現有格式編輯的選項。 ![提供使用自訂主題來取代或維護目前格式選項的對話方塊，。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/formatting_override_customtheme.png) 可以選擇在匯入自訂主題之前讓自訂主題覆寫 Tableau 工作簿所做的所有格式變更。也可以選擇在匯入自訂主題之前保留透過格式設定窗格所做的變更。 附註：若您選擇讓自訂主題覆寫現有的格式設定編輯，它只會覆寫您在 JSON 檔案中包含的樣式變更。它也不會覆寫透過 RTF 編輯器所做的樣式變更。 覆寫：自訂主題檔案將覆寫對 Tableau 工作簿所做的任何格式設定。 保留：自訂主題檔案將保留對 Tableau 工作簿所做的任何格式設定。 5. 選取覆寫或保留。 自訂主題匯入並將格式套用至工作簿。 ## 匯出自訂主題 可以透過兩種方式匯出自訂主題：可以匯出自訂主題檔案，也可以匯出套用自訂主題的工作簿。匯出主題時，匯出檔案包含在選取工作表上所做的格式設定選擇。例如，如果工作簿中的兩個不同工作表有不同的格式設定選擇，則匯出的自訂主題檔案將反映匯出檔案時選取的工作表上的格式設定選擇。僅匯出受支援且存在於自訂主題文件中的樣式元素。 ### 匯出包含自訂主題的 JSON 檔案 1. 從工具列中選取格式。 2. 選取匯出自訂主題... ![選擇「匯出自訂主題」選項的格式功能表。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/formatting_export_customtheme.png) 3. 前往要儲存自訂主題檔案的資料夾，然後按下儲存。 現在可以在本機找到自訂主題檔案。此主題檔案可以匯入到其他工作簿並與其他工作簿一起使用。 ### 匯出套用自訂主題的工作簿 1. 從工作表上的工具列中，選取檔案，然後選取另存新檔。 或者，可以選取匯出封裝工作簿。 2. 將工作簿儲存為 .twb 或 .twbx 檔案。 在 Tableau 中重新開啟工作簿時，將會套用自訂主題。 ## 建立 JSON 主題檔案 JSON 檔案是定義自訂主題中的樣式的位置。可以使用喜歡的文字編輯器建立檔案，確保包含自訂主題所需的樣式元素。使用範例檔案作為建立檔案的範本。 有許多第三方資源可以幫忙驗證檔案，例如 https://www.jsonschemavalidator.net。 在[此處](https://help.tableau.com/samples/en-us/custom_themes/CustomThemesSchema_1.0.0.json)複製驗證主題檔案所需的 JSON 結構描述檔案。 ### 要包含在自訂主題檔案中的元素 自訂主題檔案應包含版本、基本主題、樣式元素、樣式屬性和格式選擇。 #### 版本 自訂主題檔案的第一行應包含版本。從 Tableau 25.1 開始，版本號為 1.0.0，該行應如下所示：「version」：「1.0.0」。 版本號碼可能會在 Tableau 的未來版本中更新。 #### 基本主題 自訂主題文件的第二個條目應包含基本主題。基本主題對應於 Tableau 中可用的現有工作簿主題，並且基於不同版本的 Tableau Desktop。JSON 主題檔案中指定的任何格式設定樣式都會套用至基底主題之上。 | 基本主題 | 對應於 | 主題檔案中的條目 | | --- | --- | --- | | 流暢 | Tableau Desktop（版本 10.x 及更新版本） | _"base-theme": "smooth"_ | | 清理 | Tableau Desktop 版本 8.0.x – 9.3.x | _"base-theme": "clean"_ | | 現代 | Tableau Desktop 版本 3.5 – 7.0。 | _"base-theme": "modern"_ | | 經典 | Tableau Desktop 版本 1.0 – 3.2 | _"base-theme": "classic"_ | 有關工作簿主題的詳情，請參閱[升級或變更工作簿主題（僅限 Tableau Desktop）](https://help.tableau.com/current/pro/desktop/zh-tw/formatting_workbook.htm#Upgrade_or_change_your_workbook_theme) #### 樣式元素 樣式元素指定將在什麼層級套用格式設定選擇。例如，所有字體、篩選器標題或只是工具提示字體。請參閱樣式元素表以取得要指定的可用元素的清單。 #### 樣式屬性 樣式屬性指定希望套用格式選擇的樣式元素部分。例如，所有樣式元素的字體顏色和字體大小。 請務必檢查正在使用的樣式元素的屬性清單。例如，雖然螢光筆樣式元素支援背景色彩樣式屬性，但螢光筆標題元素不支援。 #### 格式設定選擇 格式設定選擇指定想要套用於樣式元素和樣式屬性的內容。例如，字體顏色、字體系列和字體大小。格式設定選擇必須以字串或整數形式輸入，具體取決於樣式屬性。顏色必須以十六進位顏色代碼形式輸入，例如#FF0000。 **字串**輸入類型包含文字。 **整數**輸入類型包含數字。 ### 自訂主題檔案範例 複製 ``` {“版本”: “1.0.0”，    "基本主題": "平滑",    “樣式”：{        “全部”： {            "字體顏色": "#d16302",            "字體系列": "Tableau 粗體"        },        “工作表”: {            "字體顏色": "#d16302",            "字體系列": "Tableau 粗體",            “字體大小”：14        },        “工作表標題”：{            "字體顏色": "#d16302",            "字體系列": "Tableau 粗體",            “字體大小”：14        },        “檢視”: {            “背景顏色”：“#ffb370”        }    }} ``` ### 自訂主題支援的樣式元素 此表包含受支援的樣式元素及其對應的受支援樣式屬性的清單。雖然自訂主題目前並非支援 Tableau 中可用的所有樣式元素，但我們將在未來版本中新增更多樣式元素。匯入自訂主題檔案時，其樣式元素將會套用至工作簿中的所有工作表。
樣式元素描述樣式屬性輸入類型格式設定選擇
所有設定整個工作簿中所有字體的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
工作表設定工作表預設字體的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
worksheet-title設定工作表標題字體的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
工具提示設定工具提示字體的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
dashboard-title設定儀表板標題的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
font-weight字串指定為 normal或者 bold 的字串。
story-title設定故事標題字體的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
標頭設定標頭字體格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
legend設定圖例正文字體和背景顏色的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
background-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。此元素還支援兩個附加數字以實現透明度，例如#FF000080。
legend-title設定所有工作表上圖例標題字體的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
filter設定所有工作表上篩選器正文字體和背景顏色的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
background-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。此元素還支援兩個附加數字以實現透明度，例如#FF000080。
filter-title設定所有工作表上篩選器標題字體的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
parameter-ctrl設定所有工作表上參數正文字體和背景顏色的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
background-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。此元素還支援兩個附加數字以實現透明度，例如#FF000080。
parameter-ctrl-title設定所有工作表上參數控制標題字體格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
highlighter設定所有工作表上螢光筆正文字體和背景顏色的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
background-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。此元素還支援兩個附加數字以實現透明度，例如#FF000080。
Highlighter-title設定所有工作表上螢光筆控制標題字體的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
font-size整數最小值為 1、最大值為 99 的整數。
page-ctrl-title設定所有工作表上頁面卡標題字體的格式。font-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
font-family字串最大長度為 50 個字元的字串。
gridline設定檢視上格線的格式。line-visibility字串指訂為開啟或關閉的字串。
line-pattern字串指定為點線、虛線或實線的字串。
line-width整數最小值為 1、最大值為 99 的整數。
line-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。此元素還支援兩個附加數字以實現透明度，例如#FF000080。
zeroline設定檢視上零線的格式。line-visibility字串指訂為開啟或關閉的字串。
line-pattern字串指定為點線、虛線或實線的字串。
line-width整數最小值為 1、最大值為 99 的整數。
line-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。此元素還支援兩個附加數字以實現透明度，例如#FF000080。
mark設定檢視上標記色彩的格式。mark-color字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
檢視設定檢視上背景色彩的格式。 字串遵循十六進位色彩代碼格式的字串，例如#FF0000。
## 疑難排解匯入自訂主題檔案的問題 ### 樣式元素沒有套用 無法顯示字型類型 僅當字體隨 Tableau 一起安裝或環境中存在該字體時才能顯示。 透過 RTF 編輯器套用格式 透過 RTF 編輯器而不是透過格式設定窗格套用格式更新，並且在套用自訂主題時選擇覆寫現有格式，則格式設定將會保留。發生這種情況是由於樣式系統格式化造成的。 ### 無法匯入主題檔案 主題檔案包含錯誤 錯誤訊息將為您提供錯誤的位置（例如字體色彩）。在樣式元素表中找到樣式元素，並確保樣式元素中的條目與輸入類型準則相符。例如，色彩是字串資料類型，必須遵循十六進位色彩代碼的格式設定，如 #FF0000。 ![顯示驗證主題檔案時出現錯誤的位置的錯誤訊息。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/formatting_error_customtheme.png) 有許多第三方資源可以幫忙驗證主題檔案，例如 https://www.jsonschemavalidator.net。 在[此處](https://help.tableau.com/samples/en-us/custom_themes/CustomThemesSchema_1.0.0.json)複製驗證主題檔案所需的 JSON 結構描述檔案。 主題檔案大小太大 允許的最大檔案大小為 15000 位元組（或 15 KB）。減少檔案大小並再試一次。 主題檔案路徑太長 檔案路徑的長度不能超過 256 個字元。減少檔案路徑的長度並再試一次。 主題檔案名稱包含無效字元 檔案名稱只能包含字母數字字元、點、破折號、空格和底線。移除檔案名稱中所有無效字元，然後再試一次。