oxjs/source/Ox.UI/js/Form/ButtonGroup.js
2012-12-09 01:43:33 +01:00

156 lines
5.4 KiB
JavaScript

'use strict';
/*@
Ox.ButtonGroup <f> ButtonGroup Object
options <o> Options object
buttons <[o]> array of button options
max <n> integer, maximum number of selected buttons, 0 for all
min <n> integer, minimum number of selected buttons, 0 for none
selectable <b> if true, buttons are selectable
type <s> string, 'image' or 'text'
self <o> Shared private variable
([options[, self]]) -> <o:Ox.Element> ButtonGroup Object
change <!> {id, value} selection within a group changed
@*/
Ox.ButtonGroup = function(options, self) {
self = self || {};
var that = Ox.Element({}, self)
.defaults({
buttons: [],
max: 1,
min: 1,
overlap: 'none',
selectable: false,
size: 'medium',
style: 'default',
type: 'text',
value: options.max != 1 ? [] : ''
})
.options(options || {})
.update({
value: function() {
// fixme: this doesn't work in cases where
// multiple buttons can be selected
var position = Ox.getIndexById(
self.options.buttons, self.options.value
);
if (position > -1) {
self.$buttons[position].trigger('click');
} else if (self.options.min == 0) {
self.$buttons.forEach(function($button, i) {
$button.options('value') && $button.trigger('click');
});
}
}
})
.addClass(
'OxButtonGroup'
+ (self.options.overlap != 'none' ? ' OxOverlap' + Ox.toTitleCase(self.options.overlap) : '')
);
self.options.buttons = self.options.buttons.map(function(button, i) {
return Ox.extend({
disabled: button.disabled,
id: button.id || button,
overlap: self.options.overlap == 'left' && i == 0 ? 'left'
: self.options.overlap == 'right' && i == self.options.buttons.length - 1 ? 'right'
: 'none',
title: button.title || button,
tooltip: button.tooltip,
width: button.width
}, self.options.selectable ? {
selected: Ox.makeArray(self.options.value).indexOf(button.id || button) > -1
} : {});
});
if (self.options.selectable) {
self.optionGroup = new Ox.OptionGroup(
self.options.buttons,
self.options.min,
self.options.max,
'selected'
);
self.options.buttons = self.optionGroup.init();
self.options.value = self.optionGroup.value();
}
self.$buttons = [];
self.options.buttons.forEach(function(button, pos) {
self.$buttons[pos] = Ox.Button({
disabled: button.disabled || false, // FIXME: getset should handle undefined
group: true,
id: button.id,
overlap: button.overlap,
selectable: self.options.selectable,
size: self.options.size,
style: self.options.style,
title: button.title,
tooltip: button.tooltip,
type: self.options.type,
value: button.selected || false, // FIXME: getset should handle undefined
width: button.width
})
.bindEvent(self.options.selectable ? {
change: function() {
toggleButton(pos);
}
} : {
click: function() {
that.triggerEvent('click', {id: button.id});
}
})
.appendTo(that);
});
function getButtonById(id) {
return self.$buttons[Ox.getIndexById(self.options.buttons, id)];
}
function toggleButton(pos) {
var toggled = self.optionGroup.toggle(pos);
if (!toggled.length) {
// FIXME: fix and use that.toggleOption()
self.$buttons[pos].value(!self.$buttons[pos].value());
} else {
toggled.forEach(function(i) {
i != pos && self.$buttons[i].value(!self.$buttons[i].value());
});
self.options.value = self.optionGroup.value();
that.triggerEvent('change', {
title: self.options.value === '' ? ''
: Ox.isString(self.options.value)
? Ox.getObjectById(self.options.buttons, self.options.value).title
: self.options.value.map(function(value) {
return Ox.getObjectById(self.options.buttons, value).title;
}),
value: self.options.value
});
}
}
/*@
disableButton <f> Disable button
@*/
that.disableButton = function(id) {
getButtonById(id).options({disabled: true});
};
/*@
enableButton <f> Enable button
@*/
that.enableButton = function(id) {
getButtonById(id).options({disabled: false});
};
/*
buttonOptions <f> Get or set button options
*/
that.buttonOptions = function(id, options) {
return getButtonById(id).options(options);
};
return that;
};