0x2620/oxjs
2
0
Fork 1
Code Issues 172 Pull requests Releases Wiki Activity

update documentation example

Browse source
This commit is contained in:
rolux 2012-06-23 23:46:58 +02:00
parent a071d541de
commit d41e12de2f
1 changed files with 18 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

30
examples/documentation/oxdoc/js/example.js
View file

@ -68,8 +68,8 @@ My.favorites <object> ...
regexp <r> My favorite regular expression regexp <r> My favorite regular expression
string <s> My favorite string string <s> My favorite string
undefined <u> Undefined is an all-time favorite undefined <u> Undefined is an all-time favorite
window <w> ... window <w> So is the DOM window
other <+> ... other <+> And the document
any <*> Favorite of the day any <*> Favorite of the day
# Events ------------------------------------------------------------------- # Events -------------------------------------------------------------------
event <!> Fires when My.favorite['function'] is called event <!> Fires when My.favorite['function'] is called
@ -95,7 +95,9 @@ My.favorites = (function() {
other: document other: document
}, },
keys = Object.keys(favorites); keys = Object.keys(favorites);
favorites.any = favorites[keys[Math.floor(Math.random() * keys.length)]]; favorites.any = favorites[
keys[Math.floor(+new Date / 86400) * keys.length]
];
return favorites; return favorites;
}()); }());
@ -103,7 +105,7 @@ My.favorites = (function() {
Documentation can be nested. In other words, one can document the properties of Documentation can be nested. In other words, one can document the properties of
a property (of a property...). Also, if all elements of an array are of a known a property (of a property...). Also, if all elements of an array are of a known
type (in this case `string`), one can mark the type as `<[s]>` instead of just type (in this case `string`), one can mark the type as `<[s]>` instead of just
`<array>`. `<a>`.
*/ */
/*@ /*@
My.HTMLUtils <o> HTML Utilities My.HTMLUtils <o> HTML Utilities
@ -153,9 +155,9 @@ function's signature, return value and arguments. Signature and return value are
just a special case of `name <type> summary`, where `name` has the form just a special case of `name <type> summary`, where `name` has the form
`(arguments) ->`. If an item can be of more than one type (in this case `string` `(arguments) ->`. If an item can be of more than one type (in this case `string`
or `function`), this is documented as `<s|f>`. If it has a default value (in or `function`), this is documented as `<s|f>`. If it has a default value (in
this case the string `'GET'`), this is documented as `<s|'GET'>`. In the case of this case the string `'GET'`), this is documented as `<s|'GET'>`. For a
a `function`-type argument (usually a callback function), there is no return `function`-type argument (usually a callback function), there is no return value
value to document, only the arguments it gets passed. to document, only the arguments it gets passed.
*/ */
/*@ /*@
My.readURL <f> Asynchronously reads a remote resource My.readURL <f> Asynchronously reads a remote resource
@ -239,8 +241,8 @@ My.range = function() {
}; };
/* /*
In case a function has a property or method one wants to document, it gets In case a function has properties or methods that need documentation, they get
prefixed with `.`, in order to differentiate it from an argument. prefixed with `.`, in order to differentiate them from arguments.
*/ */
/*@ /*@
My.localStorage <f> Returns a localStorage handler for a given namespace My.localStorage <f> Returns a localStorage handler for a given namespace
@ -362,8 +364,14 @@ My.Box = function(options, self) {
return that; return that;
}; };
/*
If an object extends or inherits from another one, one can specify its "class"
(i.e. the name of the constuctor of the object it inherits from). Here,
`My.ExtendedBox` extends `My.Box`. All events and properties of the latter,
unless redefined will, be present on the former
*/
/*@ /*@
My.ExtendedBox <f> ... My.ExtendedBox <f> An extended box with random color
options <o> Options options <o> Options
height <n> Height in px height <n> Height in px
width <n> Width in px width <n> Width in px
@ -382,8 +390,6 @@ My.ExtendedBox = function(options, self) {
if (key == 'width' || key == 'height') { if (key == 'width' || key == 'height') {
setSize(); setSize();
} }
})
.css({
}); });
randomize(); randomize();
setSize(); setSize();