[英]JSDoc for a ES6 react component
我认为 React 组件的 JSDoc 注释可能如下所示:
/**
* My component...
*
* @namespace MyComponent
* @memberof app.components
*/
app.components.MyComponent = React.createClass({
})
但是如果我使用 ES6 应该是什么样子呢?
/**
* My component...
*
* @namespace MyComponent
* @memberof ??
*/
class MyComponent extends Component {
/**
* PropTypes
* @param {string} element
*/
static propTypes = {
element: PropTypes.object
}
/**
* Constructor
* How to take care about onChange and states?
*/
constructor () {
super()
this.onChange = this.onChange.bind(this)
this.state = {
anything: true
}
}
}
另外我不明白如何记录静态 propTypes 和构造函数......
“最佳”文档是否缺少更多标签?
由于您使用的是 ES6 模块,因此您无需指定命名空间或“@memberof”。
有一个jsdoc-react,但我建议使用像styleguidist这样的交互式组件样式指南,它可以处理 jsdoc 和 proptypes。 根据他们的文档,他们不评论构造函数。
这是倍数反应生活方式指南的列表
您可以将 JSDoc 与 Better-docs 主题/插件一起使用
在这里查看: https : //www.inkoop.io/blog/a-guide-to-js-docs-for-react-js/
声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.