0

全部。

我刚开始使用 react-styleguidist 并且喜欢它的易用性。但是,我想在文档中添加动态示例。即文档查看者可以通过按钮、事件和其他异步交互更改道具来与之交互的示例。

现在我似乎只能在降价中生成这样的文档示例

js <MyComponent propOne="something static" />

周围有没有,我希望能够同时记录和开发,而不必也使用 react-storybook。

谢谢,

4

2 回答 2

2

Styleguidist 文档的回答:

每个示例都有自己的状态,您可以将其作为状态变量访问并使用 setState() 函数进行更改。默认状态为 {},可以使用 initialState 进行设置。

于 2018-11-20T22:14:37.483 回答
0

这取决于您的意图是什么,但您当然可以开始模拟您需要更多交互性的所有部分。据我了解,React Styleguidist 是记录单个自包含组件。因此,如果您开始在更高级别封装组件交互性,您可以更轻松地公开该组件,因为您将有更少的道具和状态来模拟。

我发现 Storybook 可能是一个更好的工具,可以让人们模拟和试验组件的交互性。它是一个不同的工具,更像是一个组件构建器,并带有旋钮和操作,为您提供简单的帮助器,可以轻松地让您从更原子的级别构建,然后将越来越多的组件添加到一起。最后,您会得到一个非常冗长的列表(和单个组件视图),与看起来和感觉更像是生活风格指南的东西相对(想想引导文档)。

我最近讨论了这两种工具之间的差异,这可能是一个很好的参考,看看其中一种工具是否比另一种更适合您的需求。

我发现最好使用 Storybook 来开发组件、展示交互性并从设计师那里获得反馈。Styleguidist 更像是一个记录完整系统的工具,以及组件如何独立和串联工作。

请记住,组件和注入的属性越复杂,模拟和存根这些组件就越困难。它们越原子(在设计中)并且更接近纯功能/渲染视觉属性,它们就越容易记录并可能在项目中重用或以其他方式扩展。

于 2019-02-25T19:52:11.423 回答