2012-11-28 15 views
18

Tôi đang cố gắng nhận xét kỹ javascript của mình và tôi đang sử dụng JSDoc. Tôi có một chức năng tiêu thụ một đối tượng jquery và tôi muốn đánh dấu tham số như vậy.Làm thế nào tôi có thể nhận được jsdoc để đánh dấu param của tôi như là một đối tượng jquery?

Hiện nay tôi có điều này:

/** 
* Initializes a login object. 
* @param formEl {JQuery} The login form element on the page. 
*/ 
var login = function(formEl){ ... } 

Nhưng JSDoc không nhận ra (định dạng hoặc đúng) JQuery như một loại biến. Bất kỳ giúp đỡ?

Trả lời

22

Theo http://code.google.com/p/jsdoc-toolkit/wiki/TagParam phải là

Loại thông số trước tên param.

/** 
* Initializes a login object. 
* @param {jQuery} formEl The login form element on the page. 
*/ 
var formEl = jQuery('form'); 
+1

Điều đó đã xảy ra. Tôi nghĩ rằng nó phải là một cái gì đó đơn giản ... Cảm ơn! –

+14

Và thông thường (ít nhất là trong mã tôi đã nhìn thấy) loại là 'jQuery' để phù hợp với tên của biến toàn cầu đã xuất. –

+2

Là một quy ước, việc thêm tiền tố vào các đối tượng JQuery bằng '$' là rất hữu ích. Bằng cách đó, mọi người đều biết rằng '$ formEl' là một tham chiếu JQuery đến phần tử. –