# 7、最佳做法 # 最佳做法 - - - - - - ## 創造最好的用戶體驗 我們喜歡我們的圖表。 我們希望它們成為整個HTML5世界中最好，最美麗，響應最快，功能最強大的圖表。 我們正在努力實現這些目標。 我們了解所有關于我們的圖表以及使用它們創建最佳用戶體驗，我們很樂意與您分享我們的知識。 本文檔介紹了將圖表庫集成到您的網站/應用程序中的幾種最佳實踐。 重點是始終考慮您的用戶和他們的體驗。 ### 1. 了解圖表庫是什么，不是什么 圖表庫是一個能夠顯示價格，圖形和技術分析工具的圖表組件。 我們的圖表庫使圖表變得神奇，僅此而已。 如果您想要一些額外的功能（如聊天，特殊的商品列表，最熱門交易欄，廣告等），最好的方法是在圖表之外實現它們。 但是，如果要將外部功能與圖表庫鏈接，可以使用圖表庫的API鏈接它們。 ### 2. 返回與庫請求一樣多的K線 圖表庫將向您的后端詢問數據，并為提供每個請求所需的數據范圍界限。 請遵守這些邊界并盡可能完整地返回填充此范圍的數據。 不要返回范圍外的數據。 如果要擴展庫請求的默認數據范圍，請使用我們的JS API（請參閱calculateHistoryDepth）。 ### 3. 返回與庫請求一樣多的標記 與上述K線相同。只發送符合要求范圍的標記。 ### 4. 不要覆蓋calculateHistoryDepth()以獲取超過2個屏幕的數據 圖表庫避免加載用戶沒有要求的內容。在圖表中加載更多的K線，意味著需要更多的CPU和內存。這意味著的響應效率會被降低。 ### 5. 不要讓你的圖表看起來一團糟 用戶喜歡漂亮的圖表。我們也是。請務必在自定義尺寸或樣式時保持圖表看起來不錯。避免嵌入看起來與整個圖表樣式不同的自定義控件。 ### 6. 避免制作非常小的圖表 圖書館支持的最小尺寸是`600x600px`。避免使圖表變的更小，因為它會看起來一團糟。請使用`mobile`預設，或者隱藏一些工具欄。 ### 7. 使用適當的語言 圖表庫已翻譯成數十種語言。使用符合用戶需求的語言。 ### 8. 如果您遇到問題 我們總是渴望幫助你。 但是，不幸的是，我們真的很忙，所以我們沒有太多時間。 請幫助我們有效地度過時間，并始終將您的圖書館的版本更新為最新的`unstable`版本，以檢查問題是否仍然發生。 如果有，請與我們聯系。 另外，檢查您傳遞給圖表庫的數據，并確保它符合我們的要求，如文檔中所述。 要特別注意SymbolInfo的內容，因為它是最常見的發生錯誤的地方（根據我們的統計）。 您可以看我們的輸出[demo data service](https://demo_feed.tradingview.com/quotes?symbols=AAPL) 并將其與您的對比，以確保您的后端行為是正確的。 在開發過程中始終在Widget構造函數選項中使用`debug：true`，并在生產環境中將其刪除，以使代碼更快地工作。 ### 9. 閱讀文檔 我們花了很多時間為您創建這些文檔，使您的生活更輕松。 請試一試。 ### 10. 為您的解決方案選擇適當的數據傳輸 注意JS API和UDF之間的差異，并選擇最符合您需求的API。 如果您需要真正快速的數據更新或數據流傳輸，請勿使用UDF。 如果您的后端有十幾個商品，請勿使用UDF用于數據分組（請參閱`supports_group_request`）。 ### 11. 不要嘗試嗅探我們的代碼并使用未記錄的功能 我們的文檔中未提及的所有功能都是可以更改的主題，沒有任何警告和向后兼容性。此外，您簽署的法律協議嚴格禁止更改源代碼。 ### 12. 不要在您的生產網站上使用我們的演示數據源 這個數據源只是一個演示，不適合實際使用。它可能不穩定，不能承受過大的負載。 ### 13. 使用API進行自定義。 避免編輯CSS。 我們不保證CSS選擇器的向后兼容性。 ### 14. 發送到客戶端時，將服務器設置為gzip文件 這是靜態HTML內容的常見最佳做法。 加載圖標庫的HTML文件會減少用戶的等待時間。 ### 15.設置charting\_library.min.js的最短到期時間 除了添加到HTML文件的`charting_library.min.js`之外，圖表庫中的所有文件名中都包含哈希值。 將圖表庫更新為較新版本時，所有文件的名稱也會更改。 如果瀏覽器從緩存中加載`charting_library.min.js`，則該文件中的所有鏈接都將被破壞。 應將此文件的到期時間設置為最小值，以確保瀏覽器不緩存該文件。