340 lines
12 KiB
JavaScript
340 lines
12 KiB
JavaScript
'use strict';
|
|
|
|
/*@
|
|
Ox.DocPanel <f> Documentation Panel
|
|
([options[, self]]) -> <o:Ox.SplitPanel> Documentation Panel
|
|
options <o> Options object
|
|
collapsible <b|false> If true, the list can be collabsed
|
|
element <e> Default content
|
|
files <a|[]> Files to parse for docs (alternative to items option)
|
|
getModule <f> Returns module for given item
|
|
getSection <f> Returns section for given item
|
|
items <a|[]> Array of doc items (alternative to files option)
|
|
path <s|''> Path prefix
|
|
references <r|null> RegExp to find references
|
|
replace <[[]]|[]> See Ox.SyntaxHighlighter
|
|
resizable <b|true> If true, list is resizable
|
|
resize <a|[128, 256, 384]> List resize positions
|
|
runTests <b|false> If true, run tests
|
|
selected <s|''> Id of the selected item
|
|
showTests <b|false> If true, show test results in list
|
|
showTooltips <b|false> If true, show test result tooltips in list
|
|
size <s|256> Default list size
|
|
self <o> Shared private variable
|
|
load <!> Fires once all docs are loaded
|
|
items [o] Array of doc items
|
|
@*/
|
|
|
|
Ox.DocPanel = function(options, self) {
|
|
|
|
self = self || {};
|
|
var that = Ox.Element({}, self)
|
|
.defaults({
|
|
collapsible: false,
|
|
element: '',
|
|
examples: [],
|
|
examplesPath: '',
|
|
files: [],
|
|
getModule: function(item) {
|
|
return item.file.replace(self.options.path, '');
|
|
},
|
|
getSection: function(item) {
|
|
return item.section;
|
|
},
|
|
items: [],
|
|
path: '',
|
|
references: null,
|
|
replace: [],
|
|
resizable: false,
|
|
resize: [128, 256, 384],
|
|
runTests: false,
|
|
selected: '',
|
|
showTests: false,
|
|
showTooltips: false,
|
|
size: 256,
|
|
})
|
|
.options(options || {})
|
|
.update({
|
|
selected: function() {
|
|
selectItem(self.options.selected);
|
|
}
|
|
});
|
|
|
|
self.results = {};
|
|
|
|
self.$testsButton = Ox.Button({title: 'Run Tests'})
|
|
.css({float: 'left', margin: '4px'})
|
|
.bindEvent({click: runTests});
|
|
self.$testsLabel = Ox.Label({title: 'Running Tests...'})
|
|
.css({float: 'left', margin: '4px'})
|
|
.hide();
|
|
self.$toolbar = Ox.Bar({size: 24})
|
|
.append(self.$testsButton)
|
|
.append(self.$testsLabel)
|
|
self.$list = Ox.Element();
|
|
self.$sidebar = Ox.SplitPanel({
|
|
elements: [
|
|
{element: Ox.Element(), size: 24},
|
|
{element: Ox.Element()}
|
|
],
|
|
orientation: 'vertical'
|
|
});
|
|
self.$page = Ox.Element();
|
|
|
|
that.setElement(
|
|
self.$panel = Ox.SplitPanel({
|
|
elements: [
|
|
{
|
|
collapsible: self.options.collapsible,
|
|
element: self.$sidebar,
|
|
resizable: self.options.resizable,
|
|
resize: self.options.resize,
|
|
size: self.options.size
|
|
},
|
|
{
|
|
element: self.$page
|
|
}
|
|
],
|
|
orientation: 'horizontal'
|
|
})
|
|
);
|
|
|
|
if (self.options.files) {
|
|
self.options.files = Ox.makeArray(self.options.files);
|
|
self.options.items = Ox.doc(self.options.files.map(function(file) {
|
|
return self.options.path + file;
|
|
}), function(docItems) {
|
|
self.options.items = docItems;
|
|
getExamples(function() {
|
|
self.$sidebar.replaceElement(0, self.$toolbar);
|
|
renderList();
|
|
self.options.runTests && runTests();
|
|
that.triggerEvent('load', {items: docItems});
|
|
});
|
|
});
|
|
} else {
|
|
getExamples(function() {
|
|
self.$sidebar.replaceElement(0, self.$toolbar);
|
|
renderList();
|
|
self.options.runTests && runTests();
|
|
});
|
|
}
|
|
|
|
function getExamples(callback) {
|
|
var i = 0;
|
|
if (self.options.examples && self.options.examples.length) {
|
|
self.options.examples.forEach(function(example) {
|
|
var path = self.options.examplesPath + example;
|
|
Ox.get(path + '/index.html', function(html) {
|
|
var match = html.match(/<title>(.+)<\/title>/),
|
|
title = match ? match[1] : 'Untitled';
|
|
Ox.get(path + '/js/example.js', function(js) {
|
|
var references = js.match(self.options.references);
|
|
references && Ox.unique(references).forEach(function(reference) {
|
|
var item = getItemByName(reference);
|
|
item.examples = (item.examples || []).concat({id: example, title: title});
|
|
});
|
|
if (++i == self.options.examples.length) {
|
|
self.options.items.forEach(function(item) {
|
|
item.examples && item.examples.sort(function(a, b) {
|
|
a = a.title.toLowerCase();
|
|
b = b.title.toLowerCase();
|
|
return a < b ? -1 : a > b ? 1 : 0;
|
|
});
|
|
});
|
|
callback();
|
|
}
|
|
});
|
|
});
|
|
});
|
|
} else {
|
|
callback();
|
|
}
|
|
}
|
|
|
|
function getIcon(id, expanded) {
|
|
var $icon = null, results = self.results[id];
|
|
if (!Ox.isEmpty(self.results)) {
|
|
$icon = Ox.Theme.getColorImage(
|
|
'symbol' + (expanded === true ? 'Down' : expanded === false ? 'Right' : 'Center'),
|
|
!results ? 'none' : results.failed === 0 ? 'passed' : 'failed',
|
|
self.options.showTooltips ? getTooltip(results) : null
|
|
);
|
|
} else if (!Ox.endsWith(id, '/')) {
|
|
$icon = $('<img>').attr({src: Ox.UI.getImageURL('symbolCenter')});
|
|
}
|
|
return $icon;
|
|
}
|
|
|
|
function getItemByName(name) {
|
|
var item = {};
|
|
Ox.forEach(self.options.items, function(v) {
|
|
if (v.name == name) {
|
|
item = v;
|
|
Ox.Break();
|
|
}
|
|
});
|
|
return item;
|
|
}
|
|
|
|
function getTooltip(results) {
|
|
return results
|
|
? results.passed + ' test'
|
|
+ (results.passed == 1 ? '' : 's') + ' passed'
|
|
+ (results.failed
|
|
? ', ' + results.failed + ' test'
|
|
+ (results.failed == 1 ? '' : 's') + ' failed'
|
|
: ''
|
|
)
|
|
: 'No tests';
|
|
}
|
|
|
|
function parseFiles(callback) {
|
|
var counter = 0,
|
|
docItems = [],
|
|
length = self.options.files.length;
|
|
self.options.files.forEach(function(file) {
|
|
Ox.doc(self.options.path + file, function(fileItems) {
|
|
docItems = docItems.concat(fileItems);
|
|
++counter == length && callback(docItems);
|
|
});
|
|
});
|
|
}
|
|
|
|
function renderList() {
|
|
var treeItems = [];
|
|
self.options.items.forEach(function(docItem) {
|
|
var moduleIndex, results, sectionIndex;
|
|
docItem.module = self.options.getModule(docItem);
|
|
moduleIndex = Ox.getIndexById(treeItems, docItem.module + '/');
|
|
if (moduleIndex == -1) {
|
|
treeItems.push({
|
|
id: docItem.module + '/',
|
|
items: [],
|
|
title: docItem.module
|
|
});
|
|
moduleIndex = treeItems.length - 1;
|
|
}
|
|
docItem.section = self.options.getSection(docItem);
|
|
if (docItem.section) {
|
|
sectionIndex = Ox.getIndexById(
|
|
treeItems[moduleIndex].items,
|
|
docItem.module + '/' + docItem.section + '/'
|
|
);
|
|
if (sectionIndex == -1) {
|
|
treeItems[moduleIndex].items.push({
|
|
id: docItem.module + '/' + docItem.section + '/',
|
|
items: [],
|
|
title: docItem.section
|
|
});
|
|
sectionIndex = treeItems[moduleIndex].items.length - 1;
|
|
}
|
|
}
|
|
(
|
|
docItem.section
|
|
? treeItems[moduleIndex].items[sectionIndex]
|
|
: treeItems[moduleIndex]
|
|
).items.push({
|
|
id: docItem.module + '/' + (
|
|
docItem.section ? docItem.section + '/' : ''
|
|
) + docItem.name,
|
|
title: docItem.name
|
|
});
|
|
});
|
|
treeItems.sort(sortByTitle);
|
|
treeItems.forEach(function(item) {
|
|
item.items.sort(sortByTitle);
|
|
item.items.forEach(function(subitem) {
|
|
subitem.items.sort(sortByTitle);
|
|
});
|
|
});
|
|
self.$list = Ox.TreeList({
|
|
icon: self.options.showTests
|
|
? getIcon
|
|
: Ox.UI.getImageURL('symbolCenter'),
|
|
items: treeItems,
|
|
selected: self.options.selected
|
|
? [self.options.selected] : '',
|
|
width: self.options.size
|
|
})
|
|
.bindEvent({
|
|
select: function(data) {
|
|
selectItem(data.ids.length ? data.ids[0] : '')
|
|
}
|
|
});
|
|
self.$sidebar.replaceElement(1, self.$list);
|
|
selectItem(self.options.selected);
|
|
}
|
|
|
|
function runTests() {
|
|
self.$testsButton.hide();
|
|
self.$testsLabel.show();
|
|
Ox.load({Geo: {}, Image: {}, Unicode: {}}, function() {
|
|
Ox.test(self.options.items, function(results) {
|
|
results.forEach(function(result) {
|
|
var item = getItemByName(result.name),
|
|
passed = result.passed ? 'passed' : 'failed';
|
|
item.tests[Ox.indexOf(item.tests, function(test) {
|
|
return test.statement == result.statement;
|
|
})] = result;
|
|
['', item.module + '/'].concat(
|
|
item.section ? item.module + '/' + item.section + '/' : [],
|
|
item.module + '/' + (item.section ? item.section + '/' : '') + item.name
|
|
).forEach(function(key) {
|
|
self.results[key] = self.results[key] || {passed: 0, failed: 0};
|
|
self.results[key][passed]++;
|
|
});
|
|
});
|
|
self.$testsLabel.hide();
|
|
self.$testsButton.show();
|
|
renderList();
|
|
});
|
|
});
|
|
}
|
|
|
|
function selectItem(id) {
|
|
var item, name;
|
|
if (id && !Ox.contains(id, '/')) {
|
|
name = id;
|
|
item = getItemByName(name);
|
|
id = item ? item.module + '/' + (
|
|
item.section ? item.section + '/' : ''
|
|
) + item.name : '';
|
|
}
|
|
if (id) {
|
|
self.options.selected = id;
|
|
if (!Ox.endsWith(self.options.selected, '/')) {
|
|
if (!item) {
|
|
name = self.options.selected.split('/').slice(-1);
|
|
item = getItemByName(name);
|
|
}
|
|
self.$list.options({selected: [self.options.selected]});
|
|
self.$page = Ox.DocPage({
|
|
item: item,
|
|
replace: self.options.replace
|
|
})
|
|
.bindEvent({
|
|
example: function(data) {
|
|
that.triggerEvent('example', data);
|
|
},
|
|
select: function(data) {
|
|
selectItem(data.id);
|
|
}
|
|
});
|
|
that.$element.replaceElement(1, self.$page);
|
|
that.triggerEvent('select', {id: name});
|
|
}
|
|
} else {
|
|
self.$page.empty().append(self.options.element);
|
|
}
|
|
}
|
|
|
|
function sortByTitle(a, b) {
|
|
var a = Ox.stripTags(a.title).toLowerCase(),
|
|
b = Ox.stripTags(b.title).toLowerCase();
|
|
return a < b ? -1 : a > b ? 1 : 0;
|
|
}
|
|
|
|
return that;
|
|
|
|
};
|