Child pages
  • JSDoc Annotations
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

When writing  Servoy Developer IDE

The Script Editor in the Servoy Developer IDE supports annotating JavaScript code using JSDoc. Documenting the code is a good practise, as it makes it easier to understand the code after a while or if another programmer needs to have a look at it.

Within Servoy, there is  

The JSDoc syntax supported by the Servoy Developer IDE is derived from the JSDoc Toolkit and Google Closure Compiler's support for JavaScript annotation, plus some custom Servoy extensions.

The JSDoc syntax consists of a set of JSDoc tags. Some of these tags require a Type Expression as one of the parameters.

JSDoc:

/**

*

*

*/

Auto generated tempaltes

Control-Shift-J

Code Completion

JSDoc Tags

Tag

Syntax & Examples

Comments

@AllowToRunInFind

@AllowToRunInFind

Custom Servoy JSDoc tag to annotate a function that it can be run if the Form on which the function is ran is in FindMode

@author

@author {userName}

 

@constructor

 

 

@deprecated

 

 

@example

 

 

@param

@param {Type} name parameterDescription

 

@private

@private

Annotates a function as accessible only from within the scope in which it is declared

@protected

@protected

Annotates a function as accessible from within the scope in which it is declared and all scopes that extend this scope

@return

@return {Type}

 

@returns

@returns {Type}

alias for @return

@see

@see seeDescription

 

@since

@since versionDescription

 

@SuppressWarnings

@SuppressWarnings (warning)

Custom Servoy JSDoc tag to suppress builder markers of a certain type within a function

@throws

@throws {Type}

 

@type

@type {Type}

 

@version

@version versionDescription

 

Type Expressions

Type Expressions are used to describe the type and/or structure of data...

Expression name

Syntax example

Comments

Array Type

String[]
Array<String>
Array<Byte>

 

Object Type

Object<String>
Object<Array<String>>

Unknown macro: {name}


 

Object Type with optional properties

{{

Unknown macro: {sDocID}

}}
{{

Unknown macro: {sDocID}

}}

 

JSFoundSet type

JSFoundset<datasource>
JSFoundset<

Unknown macro: {column1}

>

 

JSRecord type

JSRecord<datasource>
JSRecord<

Unknown macro: {column1}

>

 

JSDataSet type

JSDataSet<

Unknown macro: {name}

>

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Adding whatever tag you like

Code completion

JSDoc Templates

Tip: Check out the JSDoc plugin for Servoy Developer on ServoyForge

Old 5.x style of annotating:

JSRecord:servername.tablename

JSFoundset :servername.tablename

Form:formname

  • No labels