blob: 0e7fc44b1d801ac8bd3924123714061a5850d421 [file] [log] [blame]
/**
* Scrollable drop-down menus with view filter.
*
* @author Nils Diewald
*/
/*
* TODO: First item shouldn't be automatically highlighted!
* TODO: space is not a valid prefix!
* TODO: Prefix should be case sensitive!
*/
define([
'menu/item',
'menu/prefix',
'util'
], function (defaultItemClass,
defaultPrefixClass) {
// Default maximum number of menu items
var menuLimit = 8;
function _codeFromEvent (e) {
if (e.charCode && (e.keyCode == 0))
return e.charCode
return e.keyCode;
};
/**
* List of items for drop down menu (complete).
* Only a sublist of the menu is filtered (live).
* Only a sublist of the filtered menu is visible (shown).
*/
return {
/**
* Create new Menu based on the action prefix
* and a list of menu items.
*
* @this {Menu}
* @constructor
* @param {string} Context prefix
* @param {Array.<Array.<string>>} List of menu items
*/
create : function (params) {
return Object.create(this)._init(params);
},
/**
* Destroy this menu
* (in case you don't trust the
* mark and sweep GC)!
*/
destroy : function () {
if (this._element != undefined)
delete this._element["menu"];
for (var i = 0; i < this._items.length; i++) {
delete this._items[i]["_menu"];
};
delete this._prefix['_menu'];
},
/**
* Focus on this menu.
*/
focus : function () {
this._element.focus();
},
// mouse wheel treatment
_mousewheel : function (e) {
var delta = 0;
delta = e.deltaY / 120;
if (delta > 0)
this.next();
else if (delta < 0)
this.prev();
e.halt();
},
// Arrow key and prefix treatment
_keydown : function (e) {
var code = _codeFromEvent(e);
switch (code) {
case 27: // 'Esc'
e.halt();
this.hide();
break;
case 38: // 'Up'
e.halt();
this.prev();
break;
case 33: // 'Page up'
e.halt();
this.prev();
break;
case 40: // 'Down'
e.halt();
this.next();
break;
case 34: // 'Page down'
e.halt();
this.next();
break;
case 39: // 'Right'
if (this._prefix.active())
break;
var item = this.liveItem(this._position);
if (item["further"] !== undefined) {
item["further"].bind(item).apply();
};
e.halt();
break;
case 13: // 'Enter'
// Click on prefix
if (this._prefix.active())
this._prefix.onclick(e);
// Click on item
else
this.liveItem(this._position).onclick(e);
e.halt();
break;
case 8: // 'Backspace'
this._prefix.chop();
this.show();
e.halt();
break;
};
},
// Add characters to prefix
_keypress : function (e) {
var c = String.fromCharCode(_codeFromEvent(e)).toLowerCase();
// Add prefix
this._prefix.add(c);
if (!this.show()) {
this.prefix('').show();
e.halt();
};
},
// Initialize list
_init : function (itemClass, prefixClass, params) {
var that = this;
this._itemClass = itemClass || defaultItemClass;
if (prefixClass !== undefined)
this._prefix = prefixClass.create();
else
this._prefix = defaultPrefixClass.create();
this._prefix._menu = this;
var e = document.createElement("ul");
e.style.opacity = 0;
e.style.outline = 0;
e.setAttribute('tabindex', 0);
e.classList.add('menu');
e.classList.add('roll');
e.appendChild(this._prefix.element());
// This has to be cleaned up later on
e["menu"] = this;
// Arrow keys
e.addEventListener(
'keydown',
function (ev) {
that._keydown(ev)
},
false
);
// Strings
e.addEventListener(
'keypress',
function (ev) {
that._keypress(ev)
},
false
);
// Mousewheel
e.addEventListener(
'wheel',
function (ev) {
that._mousewheel(ev)
},
false
);
this._element = e;
this.active = false;
this._items = new Array();
var i;
// Initialize item list based on parameters
for (i in params) {
var obj = this._itemClass.create(params[i]);
// This may become circular
obj["_menu"] = this;
this._items.push(obj);
};
this._limit = menuLimit;
this._position = 0; // position in the active list
this._active = -1; // active item in the item list
this._firstActive = false; // Show the first item active always?
this._reset();
return this;
},
/**
* Get the associated dom element.
*/
element : function () {
return this._element;
},
/**
* Get the creator class for items
*/
itemClass : function () {
return this._itemClass;
},
/**
* Get and set the numerical value
* for the maximum number of items visible.
*/
limit : function (limit) {
if (arguments.length === 1) {
this._limit = limit;
return this;
};
return this._limit;
},
/**
* Upgrade this object to another object,
* while private data stays intact.
*
* @param {Object} An object with properties.
*/
upgradeTo : function (props) {
for (var prop in props) {
this[prop] = props[prop];
};
return this;
},
// Reset chosen item and prefix
_reset : function () {
this._offset = 0;
this._pos = 0;
this._prefix.value('');
},
/**
* Filter the list and make it visible
*
* @param {string} Prefix for filtering the list
*/
show : function () {
// Initialize the list
if (!this._initList())
return false;
// show based on initial offset
this._showItems(0);
// Set the first element to active
// Todo: Or the last element chosen
if (this._firstActive)
this.liveItem(0).active(true);
this._prefix.active(false);
this._active = this._list[0];
this._position = 0;
this._element.style.opacity = 1;
// Add classes for rolling menus
this._boundary(true);
return true;
},
/**
* Hide the menu and call the onHide callback.
*/
hide : function () {
this.active = false;
this.delete();
this._element.style.opacity = 0;
this._prefix.clear();
this.onHide();
/* this._element.blur(); */
},
/**
* Function released when the menu hides.
* This method is expected to be overridden.
*/
onHide : function () {},
// Initialize the list
_initList : function () {
// Create a new list
if (this._list === undefined) {
this._list = [];
}
else if (this._list.length != 0) {
this._boundary(false);
this._list.length = 0;
};
// Offset is initially zero
this._offset = 0;
// There is no prefix set
if (this.prefix().length <= 0) {
var i = 0;
for (; i < this._items.length; i++)
this._list.push(i);
while (this._items[++i] !== undefined) {
this._items[i].lowlight();
// console.log(this._item);
};
return true;
};
// There is a prefix set, so filter the list
var pos;
var paddedPrefix = " " + this.prefix();
// Iterate over all items and choose preferred matching items
// i.e. the matching happens at the word start
for (pos = 0; pos < this._items.length; pos++) {
if ((this.item(pos).lcField().indexOf(paddedPrefix)) >= 0)
this._list.push(pos);
};
// The list is empty - so lower your expectations
// Iterate over all items and choose matching items
// i.e. the matching happens anywhere in the word
if (this._list.length == 0) {
for (pos = 0; pos < this._items.length; pos++) {
if ((this.item(pos).lcField().indexOf(this.prefix())) >= 0)
this._list.push(pos);
};
};
// Filter was successful - yeah!
return this._list.length > 0 ? true : false;
},
// Set boundary for viewport
_boundary : function (bool) {
this.item(this._list[0]).noMore(bool);
this.item(this._list[this._list.length - 1]).noMore(bool);
},
/**
* Get the prefix for filtering,
* e.g. &quot;ve&quot; for &quot;verb&quot;
*/
prefix : function (pref) {
if (arguments.length === 1) {
this._prefix.value(pref);
return this;
};
return this._prefix.value();
},
// Append Items that should be shown
_showItems : function (offset) {
this.delete();
// Use list
var shown = 0;
var i;
for (i in this._list) {
// Don't show - it's before offset
if (shown++ < offset)
continue;
this._append(this._list[i]);
if (shown >= (this.limit() + this._offset))
break;
};
},
/**
* Delete all visible items from the menu element
*/
delete : function () {
var child;
/*
// Iterate over all visible items
for (var i = 0; i <= this.limit(); i++) {
// there is a visible element
// unhighlight!
if (child = this.shownItem(i)) {
child.lowlight();
child.active(false);
};
};
*/
for (var i in this._list) {
var item = this._items[this._list[i]];
item.lowlight();
item.active(false);
};
// Remove all children
var children = this._element.childNodes;
for (var i = children.length - 1; i >= 1; i--) {
this._element.removeChild(
children[i]
);
};
},
// Append item to the shown list based on index
_append : function (i) {
var item = this.item(i);
// Highlight based on prefix
if (this.prefix().length > 0)
item.highlight(this.prefix());
// Append element
this.element().appendChild(item.element());
},
// Prepend item to the shown list based on index
_prepend : function (i) {
var item = this.item(i);
// Highlight based on prefix
if (this.prefix().length > 0)
item.highlight(this.prefix());
var e = this.element();
// Append element
e.insertBefore(
item.element(),
e.children[1]
);
},
/**
* Get a specific item from the complete list
*
* @param {number} index of the list item
*/
item : function (index) {
return this._items[index]
},
/**
* Get a specific item from the filtered list
*
* @param {number} index of the list item
* in the filtered list
*/
liveItem : function (index) {
if (this._list === undefined)
if (!this._initList())
return;
return this._items[this._list[index]];
},
/**
* Get a specific item from the visible list
*
* @param {number} index of the list item
* in the visible list
*/
shownItem : function (index) {
if (index >= this.limit())
return;
return this.liveItem(this._offset + index);
},
/**
* Get the length of the full list
*/
length : function () {
return this._items.length;
},
/**
* Make the next item in the filtered menu active
*/
next : function () {
// No active element set
if (this._position === -1)
return;
var newItem;
// Set new live item
if (!this._prefix.active()) {
var oldItem = this.liveItem(this._position);
oldItem.active(false);
};
this._position++;
newItem = this.liveItem(this._position);
// The next element is undefined - roll to top or to prefix
if (newItem === undefined) {
// Activate prefix
var prefix = this._prefix;
// Mark prefix
if (prefix.isSet() && !prefix.active()) {
this._position--;
prefix.active(true);
return;
}
else {
this._offset = 0;
this._position = 0;
newItem = this.liveItem(0);
this._showItems(0);
};
}
// The next element is outside the view - roll down
else if (this._position >= (this.limit() + this._offset)) {
this._removeFirst();
this._offset++;
this._append(this._list[this._position]);
};
this._prefix.active(false);
newItem.active(true);
},
/*
* Page down to the first item on the next page
*/
/*
nextPage : function () {
// Prefix is active
if (this._prefix.active()) {
this._prefix.active(false);
}
// Last item is chosen
else if (this._position >= this.limit() + this._offset) {
this._position = this.limit() + this._offset - 1;
newItem = this.liveItem(this._position);
var oldItem = this.liveItem(this._position--);
oldItem.active(false);
}
// Last item of page is chosen
else if (0) {
// Jump to last item
else {
var oldItem = this.liveItem(this._position);
oldItem.active(false);
this._position = this.limit() + this._offset - 1;
newItem = this.liveItem(this._position);
};
newItem.active(true);
},
*/
/*
* Make the previous item in the menu active
*/
prev : function () {
// No active element set
if (this._position === -1) {
return;
// TODO: Choose last item
};
var newItem;
// Set new live item
if (!this._prefix.active()) {
var oldItem = this.liveItem(this._position--);
oldItem.active(false);
};
newItem = this.liveItem(this._position);
// The previous element is undefined - roll to bottom
if (newItem === undefined) {
// Activate prefix
var prefix = this._prefix;
this._offset = this.liveLength() - this.limit();
// Normalize offset
this._offset = this._offset < 0 ? 0 : this._offset;
this._position = this.liveLength() - 1;
if (prefix.isSet() && !prefix.active()) {
this._position++;
prefix.active(true);
return;
}
else {
newItem = this.liveItem(this._position);
this._showItems(this._offset);
};
}
// The previous element is outside the view - roll up
else if (this._position < this._offset) {
this._removeLast();
this._offset--;
this._prepend(this._list[this._position]);
};
this._prefix.active(false);
newItem.active(true);
},
/**
* Length of the filtered item list.
*/
liveLength : function () {
if (this._list === undefined)
this._initList();
return this._list.length;
},
// Remove the HTML node from the first item
_removeFirst : function () {
this.item(this._list[this._offset]).lowlight();
this._element.removeChild(this._element.children[1]);
},
// Remove the HTML node from the last item
_removeLast : function () {
this.item(this._list[this._offset + this.limit() - 1]).lowlight();
this._element.removeChild(this._element.lastChild);
}
};
});