8、最佳实践

创造最佳的用户体验

我们热爱我们的图表。并希望它们成为整个HTML5世界中最好，最漂亮，响应最快和功能最强大的图表。我们正在努力实现这些目标。

我们了解所有关于我们的图表以及使用它们创建最佳用户体验，我们很乐意与您分享我们的知识。本文档介绍了将图表库集成到您的网站/应用程序中的几种最佳实践。重点是始终考虑您的用户和他们的体验。

1. 了解图表库是什么，不是什么

图表库是一个能够显示价格，形状和技术分析工具的图表组件。我们的图表库使图表变得神奇，仅此而已。如果您想要一些额外的功能（如聊天，特殊的商品列表，最热门交易栏，广告等），最好的方法是在图表之外实现它们。但是，如果要将外部功能与图表库链接，可以使用图表库的API链接它们。

2. 返回与库请求一样多的K线

图表库将向您的后端询问数据，并在每次请求时提供所需的数据范围界限。请遵守这些范围界限并尽可能完整地返回填充此范围的数据。不要返回范围外的数据。如果要扩展库请求的默认数据范围，请使用我们的JS API（请参阅calculateHistoryDepth）。

3. 返回与库请求一样多的标记

与上述K线相同。只发送符合要求范围的标记。

4. 不要覆盖calculateHistoryDepth()以获取超过2个屏幕的数据

图表库避免加载用户没有要求的内容。在图表中加载更多的K线，意味着需要更多的CPU和内存。这意味着的响应效率会被降低。

5. 不要让你的图表看起来一团糟

用户喜欢漂亮的图表。我们也是。请务必在自定义尺寸或样式时保持图表看起来不错。避免嵌入看起来与整个图表样式不同的自定义控件。

6. 避免制作非常小的图表

图表库支持的最小尺寸是600x600px。避免使图表变的更小，因为它会看起来一团糟。请使用mobile预设，或者隐藏一些工具栏。

7. 使用适当的语言

图表库已翻译成数十种语言。使用符合用户需求的语言。

8. 如果您遇到问题

我们一直渴望为您提供帮助。但不幸的是，我们真的很忙，所以我们没有太多时间。 请帮助我们有效地利用时间，并始终将您的图表库的版本更新为最新的unstable版本，以检查问题是否仍然发生。如果有，请与我们联系。

另外，检查您传递给图表库的数据，并确保它符合我们的要求，如文档中所述。要特别注意SymbolInfo的内容，因为它是最常见的发生错误的地方（根据我们的统计）。

您可以观察我们的演示数据服务 的输出，并将其与您的对比，以确保您的后端数据是正确的。

在开发过程中始终在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.js的最小到期时间

除了添加到HTML文件的charting_library.js之外，图表库中的所有文件名中都包含哈希值。 将图表库更新为较新版本时，所有文件的名称也会更改。 如果浏览器从缓存中加载charting_library.js，则该文件中的所有链接都将被破坏。 应将此文件的到期时间设置为最小值，以确保浏览器不缓存该文件。