oxjs/source/Ox.UI/js/Form/Ox.Button.js

166 lines
5.8 KiB
JavaScript
Raw Normal View History

2011-07-29 18:48:43 +00:00
// vim: et:ts=4:sw=4:sts=4:ft=javascript
2011-12-21 13:42:47 +00:00
2011-11-05 16:46:53 +00:00
'use strict';
2011-12-21 13:42:47 +00:00
2011-05-16 08:24:46 +00:00
/*@
Ox.Button <f:Ox.Element> Button Object
() -> <f> Button Object
(options) -> <f> Button Object
(options, self) -> <f> Button Object
options <o> Options object
2011-12-22 05:52:46 +00:00
If a button is both selectable and has two values, its value is the
selected id, and the second value corresponds to the selected state
disabled <b|false> If true, button is disabled
group <b|false> If true, button is part of group
id <s|''> Element id
overlap <s|'none'> 'none', 'left' or 'right'
selectable <b|false> If true, button is selectable
style <s|'default'> 'default', 'checkbox', 'symbol' or 'tab'
title <s|''> Button title
tooltip <s|[s]|''> Tooltip
type <s|text> 'text' or 'image'
value <b|s|undefined> True for selected, or current value id
values <[o]|[]> [{id, title}, {id, title}]
width <s|'auto'> Button width
2011-05-16 08:24:46 +00:00
self <o> Shared private variable
click <!> non-selectable button was clicked
2011-12-21 13:42:47 +00:00
change <!> selectable button was clicked
2011-05-16 08:24:46 +00:00
@*/
2011-04-22 22:03:10 +00:00
2011-05-16 08:24:46 +00:00
Ox.Button = function(options, self) {
self = self || {};
var that = Ox.Element('<input>', self)
2011-04-22 22:03:10 +00:00
.defaults({
disabled: false,
group: false,
id: '',
overlap: 'none',
selectable: false,
size: 'medium',
// fixme: 'default' or ''?
style: 'default',
2011-04-22 22:03:10 +00:00
title: '',
tooltip: '',
type: 'text',
2011-12-22 05:52:46 +00:00
value: void 0,
values: [],
2011-04-22 22:03:10 +00:00
width: 'auto'
})
.options(options ? Ox.extend(Ox.clone(options), {
// tooltip may be an array, so we can't pass it yet
tooltip: ''
}) : {})
.attr({
disabled: self.options.disabled,
2011-04-22 22:03:10 +00:00
type: self.options.type == 'text' ? 'button' : 'image'
})
2011-12-21 13:42:47 +00:00
.addClass(
'OxButton Ox' + Ox.toTitleCase(self.options.size)
+ (self.options.disabled ? ' OxDisabled': '')
+ (self.options.selectable && self.options.value ? ' OxSelected': '')
+ (self.options.style != 'default' ? ' Ox' + Ox.toTitleCase(self.options.style) : '')
+ (self.options.overlap != 'none' ? ' OxOverlap' + Ox.toTitleCase(self.options.overlap) : '')
)
2011-04-22 22:03:10 +00:00
.css(self.options.width == 'auto' ? {} : {
width: (self.options.width - 14) + 'px'
})
.mousedown(mousedown)
.click(click);
2011-12-22 05:52:46 +00:00
if (self.options.values.length) {
self.options.values = self.options.values.map(function(value) {
2011-12-21 13:42:47 +00:00
return {
2011-12-22 05:52:46 +00:00
id: value.id || value,
title: value.title || value
2011-12-21 13:42:47 +00:00
};
});
2011-12-22 05:52:46 +00:00
self.value = Ox.getPositionById(self.options.values, self.options.value);
if (self.value == -1) {
self.value = 0;
self.options.value = self.options.values[0].id;
}
self.options.title = self.options.values[self.value].title;
} else if (self.options.selectable) {
self.options.value = self.options.value || false;
2011-12-21 13:42:47 +00:00
}
2011-04-22 22:03:10 +00:00
2011-12-21 13:42:47 +00:00
setTitle();
2011-04-22 22:03:10 +00:00
2011-12-22 05:52:46 +00:00
options.tooltip && that.options({
tooltip: Ox.isArray(options.tooltip)
? options.tooltip[self.value]
: options.tooltip
});
2011-04-22 22:03:10 +00:00
function click() {
if (!self.options.disabled) {
2011-12-22 05:52:46 +00:00
if (self.options.values.length || self.options.selectable) {
that.toggle();
2011-12-21 13:42:47 +00:00
that.triggerEvent('change', {value: self.options.value});
2011-12-22 05:52:46 +00:00
} else {
2011-12-21 13:42:47 +00:00
that.triggerEvent('click');
2011-04-22 22:03:10 +00:00
}
}
}
function mousedown(e) {
if (self.options.type == 'image' && $.browser.safari) {
// keep image from being draggable
e.preventDefault();
}
}
2011-12-21 13:42:47 +00:00
function setTitle() {
2011-04-22 22:03:10 +00:00
if (self.options.type == 'image') {
that.attr({
2011-08-09 17:00:39 +00:00
src: Ox.UI.getImageURL(
2011-12-22 05:52:46 +00:00
'symbol' + self.options.title[0].toUpperCase()
+ self.options.title.substr(1)
2011-04-22 22:03:10 +00:00
)
});
} else {
2011-12-22 05:52:46 +00:00
that.val(self.options.title);
2011-04-22 22:03:10 +00:00
}
}
2011-04-29 12:40:51 +00:00
self.setOption = function(key, value) {
2011-04-22 22:03:10 +00:00
if (key == 'disabled') {
2011-12-22 05:52:46 +00:00
that.attr({disabled: value}).toggleClass('OxDisabled');
} else if (key == 'tooltip') {
that.$tooltip.options({title: value});
2011-04-22 22:03:10 +00:00
} else if (key == 'title') {
2011-12-21 13:42:47 +00:00
setTitle();
} else if (key == 'value') {
2011-12-22 05:52:46 +00:00
if (self.options.values.length) {
self.options.title = Ox.getObjectById(self.options.values, value).title;
setTitle();
}
2011-12-21 13:42:47 +00:00
self.options.selectable && that.toggleClass('OxSelected');
2011-04-22 22:03:10 +00:00
} else if (key == 'width') {
2011-12-22 05:52:46 +00:00
that.$element.css({width: (value - 14) + 'px'});
2011-04-22 22:03:10 +00:00
}
};
2011-04-22 22:03:10 +00:00
2011-12-22 05:52:46 +00:00
that.toggle = function() {
var index;
if (self.options.values.length) {
index = 1 - Ox.getPositionById(self.options.values, self.options.value);
self.options.title = self.options.values[index].title;
self.options.value = self.options.values[index].id;
setTitle();
// fixme: if the tooltip is visible
// we also need to call show()
that.$tooltip && that.$tooltip.options({
title: self.options.tooltips[index]
});
} else {
self.options.value = !self.options.value;
}
2011-12-21 13:42:47 +00:00
self.options.selectable && that.toggleClass('OxSelected');
2011-04-22 22:03:10 +00:00
}
return that;
};