API意见征集

[Gk0Wk]

echarts会是一个框架，框架核心会负责做好样式适配、去抖、生命周期和api等功能，而数据究竟是什么、又以何种方式呈现、交互，就交由插件来决定。

<$echarts addon="" .../>

addon指向一个tiddler，这个tiddler可以是：

• json文件，包含一个echart的option信息；
• js文件，能够生成option的js脚本，并调用$tw等工具集以及我提供的各种api。

...代表后面的其他参数，会传给js型的插件。

---

请问大家有什么想要的API呢？（比如决定更新视图的时机、获取当前关注的tiddler等）欢迎留言。

[linonetwo]

如果是使用简单数据源，用一个filter就能描述的话，可以读这个addon条目的filter字段。当前关注的tiddler也可以通过filter获取，不需要额外api了。

这种情况数据使用应该也很简单，条目内容应该就是一个JSON。

这种简单的视图应该是最适合入门者自己看。filter 文档和 echarts 文档自己制作出来的。

[Gk0Wk]

数据可以直接获取这个没问题，但是想要让echarts显示数据就需要额外的处理了。这个比较难搞。所以我认为JSON就只能显示静态的数据。

[linonetwo]

不过这应该是最常用的用法吧，现在可以加一个工具栏按钮 或者/命令，来在插入这种微件的时候自动创建一个json条目出来

[oflg]

视图更新时间，视图类型（饼图，条形图等），视图数据条目。

（感觉所有这些配置像都可以放在一个json数据条目里，其他插件生出json数据条目后，条目名传给tw-echarts，echarts再解析json更新视图）

[Gk0Wk]

js型插件调用后就会返回一个对象的，这个对象直接传给charts.setOptions

[oflg]

要不然直接参考官方的D3的接口设计吧 https://tiddlywiki.com/plugins/tiddlywiki/d3/

[Gk0Wk]

官方那个其实没啥东西的，不过我会参考的

[linonetwo]

当前关注的更新时机或许可以用 addon 条目的一个 update-trigger-filter 字段来判断，当它变化时就触发更新，类似 react 的 should component update 方法。

默认应该就是 hotzone 的 filter 吧。

[Gk0Wk]

那是不是可以说，只要我这边监听了所有wiki的更改，然后再根据filter过滤后进行比对就可以满足所有的需求？

有没有其他的触发情况，是在wiki发生更改之外的？比如定时刷新的什么的

[linonetwo]

我觉得还是reactive一点吧，节省性能消耗，在实际数据有变化的时候再刷新。如果要定时触发的话 那应该也是有一个定时脚本在自动插入新的条目吧

[linonetwo]

目前官方的微件像是transclude widget，就是监听了系统的变化 ，然后有一个方法来决定 是否要根据变化做出改变的

[Leilei332]

能支持老的Echarts版本吗，比如这个：https://assets.pyecharts.org/assets/echarts.min.js

[linonetwo]

别吧，没人维护啊，到时候bug很多，维护累死人。还不如省下时间找女朋友

[Gk0Wk]

老版本有什么不一样的功能吗

[Leilei332]

外观，对某些组件的兼容性等（如Pyecharts）

[Gk0Wk]

考虑到pyecharts 2.0也即将升级到echart v5，且echarts社区活跃，我认为为了兼容而提供v4版本没有必要。而外观问题的话，是不是可以用自定义主题来解决？如果愿意，可以收集一些主题。

[Leilei332]

其实外观不重要，只要兼容性好就可以了