大四学生一枚,javascript初学者,目前在实习,公司的有一套自己的框架,只需要javascript就可以实现前台和后台,但是关于这个框架的文档是很久以前手写的,跟真正的框架源码甩了好几条街
我希望能够开发一个针对本公司的js文档生成器,源码如下
ui.require('Button');
ui.version.Table = '2.0';
ui.comp.Table = ui.extend('', {
constructor: function(param) {
ui.comp.Table.superclass.constructor.apply(this, arguments);
this.width = 'auto';
this.height = 'auto';
},
focusPreScrollTop:function(focused,num){
var container = this.domObj_listContainer.find('.kui-table-content');
var item = container.find('.kui-table-row-focus');
if(item.size()>0){
var itemTop = item.offset().top;
var toolTop = this.domObj_header.offset().top;
var height = this.domObj_header.outerHeight(true);
if(itemTop < (toolTop+height)){
var temp = itemTop - (toolTop+height);
container.scrollTop(this._getScrollTop(temp,focused,item,num));
}
}
}
});
已有的文档内容如下
<tr>
<th>属性名</th>
<th>简介</th>
</tr>
<tr>
<td>id</td>
<td>默认值无(AUTO_INCREMENT). 允许格式:字符串。<br/>此属性用于设置组件的id。如不指定,框架会使用一个页面唯一的内部id,命名格式为<i>kui-n</i>,n为一个自增长数字。为组件指定id后,可通过ui.getObjectById( id )方法快速获取组件对象。</td>
</tr>
<tr>
<td>container</td>
<td>默认值"body". 允许格式:jquery 选择器或jquery DOM 对象。<br/>此属性用于设置组件的上级容器。默认body 即表示绘制在页面body元素下。可指定一个jquery 选择器或DOM 对象,如 container : '#myDiv' 或 container : $('#myDiv')</td>
</tr>
<tr>
<td>width</td>
<td>默认值'auto'. 允许格式:数字(单位像素)或字符串(百分比或auto)。<br/>此属性用于设置Block的宽度。默认auto,将撑满水平宽度。</td>
</tr>
除了tr, td中的内容其它不需要改变,我的初步想法是将jsDoc的源码拿来改,但是又不知道如何下手,看不太懂jsDoc的源码
但是如果自己从头开始写一个文本分析工具一样的文档生成器,是不是重复造轮子?
还希望各位大神给我一点建议,感激不尽
我希望能够开发一个针对本公司的js文档生成器,源码如下
ui.require('Button');
ui.version.Table = '2.0';
ui.comp.Table = ui.extend('', {
constructor: function(param) {
ui.comp.Table.superclass.constructor.apply(this, arguments);
this.width = 'auto';
this.height = 'auto';
},
focusPreScrollTop:function(focused,num){
var container = this.domObj_listContainer.find('.kui-table-content');
var item = container.find('.kui-table-row-focus');
if(item.size()>0){
var itemTop = item.offset().top;
var toolTop = this.domObj_header.offset().top;
var height = this.domObj_header.outerHeight(true);
if(itemTop < (toolTop+height)){
var temp = itemTop - (toolTop+height);
container.scrollTop(this._getScrollTop(temp,focused,item,num));
}
}
}
});
已有的文档内容如下
<tr>
<th>属性名</th>
<th>简介</th>
</tr>
<tr>
<td>id</td>
<td>默认值无(AUTO_INCREMENT). 允许格式:字符串。<br/>此属性用于设置组件的id。如不指定,框架会使用一个页面唯一的内部id,命名格式为<i>kui-n</i>,n为一个自增长数字。为组件指定id后,可通过ui.getObjectById( id )方法快速获取组件对象。</td>
</tr>
<tr>
<td>container</td>
<td>默认值"body". 允许格式:jquery 选择器或jquery DOM 对象。<br/>此属性用于设置组件的上级容器。默认body 即表示绘制在页面body元素下。可指定一个jquery 选择器或DOM 对象,如 container : '#myDiv' 或 container : $('#myDiv')</td>
</tr>
<tr>
<td>width</td>
<td>默认值'auto'. 允许格式:数字(单位像素)或字符串(百分比或auto)。<br/>此属性用于设置Block的宽度。默认auto,将撑满水平宽度。</td>
</tr>
除了tr, td中的内容其它不需要改变,我的初步想法是将jsDoc的源码拿来改,但是又不知道如何下手,看不太懂jsDoc的源码
但是如果自己从头开始写一个文本分析工具一样的文档生成器,是不是重复造轮子?
还希望各位大神给我一点建议,感激不尽
解决方案 »
- window.print() 如何不显示打印机选择画面
- 如何调用兄弟页面的方法?请大家帮忙
- 为啥FILTER:progid:DXImageTransform.Microsoft.Gradient(非信任站点)无效
- Javascript如何才能知道Windows media player 播放完毕了?
- 请问怎么用js控制框架页面的滚动条
- 问一个超级变态的问题?
- NetScape下请问如何得到一个元素(如图片或者鼠标什么的)的绝对位置?
- -----关于查找替换的问题-----
- karma(无为),8988(晓月),或知道的人请进:Table单元格合并出现奇怪的问题!!!
- 大学项目,网站注释工具
- 求“微信网页版”右下角消息弹出提示的实现方法?
- 新人求教
问题描述可以再清楚,详细一点。目前并不是太清楚你到底是要做什么,要生成什么。如果是要根据JS的注释生成API的文档,那么JSDoc是可以用的。
嗯,孤陋寡闻了,一直只是听说nodejs,没有稍微了解过哦。本人还停留在传统技术层面,多学习哈
比如:JSDoc Toolkit和YUIDoc
需要按照这两种API生成文档的要求,给代码加注释,个人觉得已经很好了
公司的有一套自己的框架,只需要javascript就可以实现前台和后台
让我眼前一亮