LuckyTemplates 中的自定義主題

在今天的帖子中，我將快速回顧一下您可以通過直接編輯和應用 JSON 主題文件進行的自定義設置。這實際上並不是對在 LuckyTemplates 本身內可以完成的操作的描述，而是作為一個示例，說明在執行自定義主題時可以在 LuckyTemplates 之外完成的操作。您可以在本博客底部觀看本教程的完整視頻。

本主題不適合 LuckyTemplates 報表使用者或臨時 LuckyTemplates 開發人員，而是適合那些熟悉並樂於直接編輯和創建 JSON 代碼的人員。

要實現自定義主題，您需要熟悉 JSON 文件的語法和結構以及開發環境工具。我將使用 Visual Studio 代碼開發 JSON 主題文件。

讓我們看一下已內置到 LuckyTemplates 桌面應用程序中的可用自定義項。首先，我們需要一張畫布來展示我們的作品。我使用了 LuckyTemplates 實踐數據集，這是一個簡單的銷售數據集，可以輕鬆構建視覺效果。演示 PBIX 文件是單個報告頁面，使用 1600 x 900 的自定義尺寸來提供比標準 1280 x 720 報告多一點的空間。

目錄

• 使用默認主題
• 自定義主題的 JSON 基礎知識快速回顧
• 更改自定義主題的背景
• 更改標題文本背景
• 為視覺效果添加陰影
• 添加標題文本
• 自定義主題中要記住的其他事項
• 結論

使用默認主題

讓我們在這裡看看我們的默認主題。如果我們瀏覽主題並應用默認主題......

…我們可以看到它只是使用標準的藍色、橙色和紫色。

如果我選擇深色背景上的白色文本主題......

……這是我們將要看到的主題。

自定義主題的 JSON 基礎知識快速回顧

這絕對不是關於如何為 LuckyTemplates 開發 JSON 文件的全面回顧，而是對 JSON 文件的一些快速評論。

JSON 代表JavaScript 對象表示法；這是數據文件的明文格式，由嵌套對像或代碼塊組成。其中每一個都有自己的名稱-值對集合。

冒號用於分隔名稱-值對。大括號用於包圍對象。列表元素用逗號分隔，列表可以被刪除。列表也可以是數組，在本例中，它被方括號括起來。

LuckyTemplates JSON 文件通常包含三個主要部分：name、colors和visuals。名稱部分實際上是唯一必需的部分，如您所見，這是我們今天要開始調查的地方。

讓我們通過瀏覽主題來應用這個主題文件。

我們將使用默認主題。您將看到使用了默認顏色。

讓我們轉到代碼塊部分並複制一組替代顏色。

我們可以通過在名稱塊後添加逗號然後粘貼代碼來將其粘貼到我們的 JSON 主題文件中。

我們將保存 JSON 主題文件，返回到 LuckyTemplates，並應用臨時主題。

現在，我們可以看到顏色發生了變化。

視覺部分是迄今為止最大的部分，這是我們進行其餘工作的地方。您可以輕鬆更改文本，包括字體、字號和顏色。

讓我們轉到我們的記事本，為我們的文本類和設置為不同大小的字體複製代碼塊。

然後我們將轉到 Visual Studio Code，添加一個用於分隔代碼的列，然後粘貼代碼。

我們將再次保存我們的主題文件。然後我們將返回 LuckyTemplates 並應用主題文件。我們可以看到所有的文本現在都變成了藍色。

我們可以輕鬆做的一件事是更改文本顏色。讓我們再次回到 JSON 文件，選擇藍色，並將其替換為紅色。

讓我們再次保存，返回 LuckyTemplates，再次導入 JSON 主題文件。現在，我們可以看到所有的文本都變成了紅色。

更改自定義主題的背景

現在讓我們看看頁面背景並將其設置為調色板中第二深的顏色。我們將轉到 Notepad++，獲取我們的頁面背景代碼塊，然後復制它。

然後我們將轉到 Visual Studio Code 並將代碼粘貼到那裡。

然後轉到 LuckyTemplates 並再次應用 scratch 主題以查看新背景。

更改標題文本背景

讓我們通過將標題文本背景更改為最暗的主題顏色並將文本顏色更改為白色來完成我們的演示。如您所見，我還沒有想出通過 JSON 主題文件設置表格和矩陣樣式的正確語法。所以我使用界面將兩個視覺效果的樣式更改為none。

讓我們回到 Notepad++ 複製標題背景的 JSON 代碼塊。

然後我們轉到 Visual Studio Code 將代碼粘貼到那裡。

同樣，我們將保存我們的主題，返回 LuckyTemplates，並再次應用該主題。

為視覺效果添加陰影

我還有一些小型獨立演示，展示了一些主題選項。讓我們將主題重置為默認選項。如果我們想為所有視覺效果添加陰影，我們可以使用 visualStyles 和 dropShadow 語法。

如果我們轉到 LuckyTemplates 並應用該主題文件，您會看到我們所有的視覺對像都有陰影。

添加標題文本

如果我們想要確保我們所有的視覺對像都有標題文本，我們可以使用 Visual Studio Code 中的 visualStyles、title、show 和 text 語法添加一些佔位符標題文本。

如果我們轉到 LuckyTemplates 並應用該主題文件，我們會注意到只有一個視覺效果發生了變化，因為所有其他視覺效果都已使用標題進行了修改。

如果我們要轉到一個新頁面，創建一個新表，並引入我們想要的渠道和措施，我們有默認的標題文本。

我們可以做的另一件事是影響新圖像縮放到其容器的方式。如果我們重置為默認主題並插入圖像，我們會看到它確實保持了縱橫比。

如果我們想使用主題文件來設置圖像縮放比例，我們可以使用 visualStyles、image、imageScaling 和 image ScalingType 語法。

如果我們轉到 LuckyTemplates 並添加該主題，我們將看到現在可以更改現有視覺對象的縱橫比。

如果我們添加新的視覺效果，我們可以再次看到縮放現在設置為適合。

自定義主題中要記住的其他事項

json文件中的頁面背景透明度設置似乎沒有考慮進去，所以我在demo開始前通過接口將頁面背景透明度設置為0。

表格和矩陣樣式的設置似乎也沒有被考慮在內。所以我使用界面將表格和矩陣樣式設置為無。

順序在 JSON 主題文件中似乎很重要，因此如果您發現未考慮特定設置，請嘗試在代碼中將感興趣的設置重新排序為更高或更早的位置。

現有的視覺效果可能無法完全響應主題文件，特別是如果它們已經應用了任何格式設置。

創建主題、公司徽標、圖標和背景
如何為報表選擇 LuckyTemplates 顏色主題
如何創建引人注目的 LuckyTemplates 調色板

結論

如果您是 JSON 編碼方面的相對新手，尤其是 LuckyTemplates 方面的新手，請對我使用過的所有示例持保留態度。我希望那些對 LuckyTemplates 中的 JSON 主題編碼更有經驗和熟悉的人會產生更好、更清晰的代碼。

最後，我只想分享我的一些初步經驗，並展示我在自定義主題中發現的一些自定義設置。LuckyTemplates JSON 主題化有多種設置可用，願意投入時間和精力研究可用在線資源的人可以迭代開發有用的主題文件。

一個很好的起點是 PowerBI.tips 的高級主題生成器的屬性選項卡，您可以在其中使用他們的 UI 為所有或特定視覺類型生成 JSON 主題文件。希望您可以將自定義 JSON 主題編碼添加到您的 LuckyTemplates 工具箱，它既可以幫助標準化您的報告，又可以在將來為您節省一些工作。

格雷格