minor cleanup, tweaking and docs...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
This commit is contained in:
Alex A. Naanou 2015-06-18 18:18:28 +03:00
parent dac7f73072
commit 531d4e610c

View File

@ -201,8 +201,6 @@ var BrowserPrototype = {
return this return this
}, },
// internal actions...
// Filter the item list... // Filter the item list...
// //
// .filter() // .filter()
@ -212,25 +210,33 @@ var BrowserPrototype = {
// .filter(<string>) // .filter(<string>)
// -> elements // -> elements
// //
// .filter(<string>) // .filter(<regexp>)
// -> elements // -> elements
// //
// .filter(<function>) // .filter(<function>)
// -> elements // -> elements
// //
// //
// .filter(<pattern>[, <rejected-handler>][, <ignore-disabled>])
//
// XXX write out the following signatures...
// .filter(<pattern>)
// .filter(<pattern>, <ignore-disabled>)
// .filter(<pattern>, <rejected-handler>)
// .filter(<pattern>, <rejected-handler>, <ignore-disabled>)
//
// XXX pattern modes: // XXX pattern modes:
// - lazy match // - lazy match
// abc -> *abc* -> ^.*abc.*$ // abc -> *abc* -> ^.*abc.*$
// ab cd -> *ab*cd* -> ^.*ab.*cd.*$ // ab cd -> *ab*cd* -> ^.*ab.*cd.*$
// - glob // - glob
// - regex
// XXX need to support glob / nested patterns... // XXX need to support glob / nested patterns...
// ..things like /**/a*/*moo/ // ..things like /**/a*/*moo/
// XXX make the signature a bit more flexible...
filter: function(pattern, rejected, ignore_disabled){ filter: function(pattern, rejected, ignore_disabled){
pattern = pattern || '*' pattern = pattern || '*'
ignore_disabled = typeof(rejected) == typeof(true) ? rejected : ignore_disabled
ignore_disabled = ignore_disabled == null ? true : ignore_disabled ignore_disabled = ignore_disabled == null ? true : ignore_disabled
rejected = typeof(rejected) == typeof(true) ? null : rejected
var that = this var that = this
var browser = this.dom var browser = this.dom
@ -285,6 +291,9 @@ var BrowserPrototype = {
return elems.filter(filter) return elems.filter(filter)
}, },
// internal actions...
// NOTE: this uses .filter(..) for actual filtering... // NOTE: this uses .filter(..) for actual filtering...
// XXX revise API... // XXX revise API...
showFiltered: function(pattern){ showFiltered: function(pattern){