oxjs/source/Ox/js/DOM.js

342 lines
11 KiB
JavaScript
Raw Normal View History

2011-11-05 16:46:53 +00:00
'use strict';
/*@
2012-04-15 12:14:18 +00:00
Ox.$ <f> Generic HTML element, mimics jQuery
2012-05-30 22:47:57 +00:00
value <s|h|w|?> tagname, selector, html element, `window`, or `document`
Passing a tagname ('<tagname>') creates an element, passing a selector
('tagname', '.classname' or '#id') selects an element.
(value) -> <o> Element object
2012-04-15 19:12:48 +00:00
> Ox.$('<div>').addClass('red').hasClass('red')
true
2012-04-15 19:12:48 +00:00
> Ox.$('<div>').addClass('red').removeClass('red').hasClass('red')
false
2012-04-15 19:12:48 +00:00
> Ox.$('<div>').addClass('red').addClass('red')[0].className
'red'
> Ox.$('<div>').attr({id: 'red'}).attr('id')
'red'
> Ox.$('<div>').attr({id: 'red'}).removeAttr('id').attr('id')
void 0
2012-04-15 19:12:48 +00:00
> Ox.$('<div>').css({color: 'red'}).css('color')
'red'
> Ox.$('<div>').html('red').html()
'red'
> Ox.$('<div>').html('red').empty().html()
''
> Ox.$('<input>').val('red').val()
'red'
> !!Ox.$('<div>').on({click: function(e) { Ox.test(e.type, 'click'); }}).trigger('click')
true
@*/
2012-05-25 07:52:57 +00:00
Ox.$ = Ox.element = function(value) {
var element = !Ox.isString(value) ? value // window, document or element
2012-05-25 07:52:57 +00:00
: value[0] == '<' ? document.createElement(value.slice(1, -1))
: value[0] == '#' ? document.getElementById(value.slice(1))
: value[0] == '.' ? document.getElementsByClassName(value.slice(1))[0]
: document.getElementsByTagName(value)[0];
2012-04-05 15:30:00 +00:00
return element ? {
2012-05-30 22:47:57 +00:00
//@ 0 <h> The DOM element itself
2012-04-05 15:30:00 +00:00
0: element,
/*@
addClass <f> Adds a class name
(className) -> <o> This element
className <s> Class name
@*/
2012-05-25 07:52:57 +00:00
addClass: function(string) {
2012-04-15 12:14:18 +00:00
this[0].className = Ox.unique(((
this[0].className ? this[0].className + ' ' : ''
2012-05-25 07:52:57 +00:00
) + Ox.clean(string)).split(' ')).join(' ');
return this;
},
/*@
append <f> Appends another element to this element
(element) -> <o> This element
2012-04-15 12:14:18 +00:00
element <o|[o]> One or more elements
@*/
2012-04-15 12:14:18 +00:00
append: function() {
var that = this;
Ox.makeArray(arguments[0]).forEach(function(element) {
2012-04-15 12:14:18 +00:00
that[0].appendChild(element[0]);
});
return this;
},
/*@
appendTo <f> appends this element object to another element object
(element) -> <o> This element
element <o> Another element
@*/
appendTo: function(element) {
element[0].appendChild(this[0]);
return this;
},
/*@
attr <f> Gets or sets an attribute
2012-04-15 12:14:18 +00:00
(key) -> <s> Value
(key, value) -> <o> This element
({key: value, key1: value1, ...}) -> <o> This element
key <str> Attribute name
value <str> Attribute value
@*/
attr: function() {
var ret, that = this;
if (arguments.length == 1 && Ox.isString(arguments[0])) {
ret = this[0].getAttribute(arguments[0]);
if (ret === null) {
ret = void 0;
}
} else {
2012-05-25 07:52:57 +00:00
Ox.forEach(Ox.makeObject(arguments), function(value, key) {
that[0].setAttribute(key, value);
});
ret = this;
}
return ret;
},
/*@
css <f> Gets or sets a CSS attribute
2012-04-15 12:14:18 +00:00
(key) -> <s> Value
(key, value) -> <o> This element
({key0: value0, key1: value1, ...}) -> <o> This element
key <str> Attribute name
value <str> Attribute value
@*/
css: function() {
var ret, that = this;
if (arguments.length == 1 && Ox.isString(arguments[0])) {
ret = this[0].style[arguments[0]];
} else {
2012-05-25 07:52:57 +00:00
Ox.forEach(Ox.makeObject(arguments), function(value, key) {
that[0].style[key] = value;
});
ret = this;
}
return ret;
},
2012-04-15 12:14:18 +00:00
/*@
empty <f> Empties the inner HTML
() -> <o> This element
@*/
2012-04-05 15:30:00 +00:00
empty: function() {
return this.html('');
2012-04-05 15:30:00 +00:00
},
/*@
2012-04-15 12:14:18 +00:00
hasClass <f> Returns true if this element has a given class
(className) -> <b> True if this element has the class
className <s> Class name
@*/
2012-05-25 07:52:57 +00:00
hasClass: function(string) {
return this[0].className.split(' ').indexOf(string) > -1;
},
2012-04-15 12:14:18 +00:00
/*@
height <f> Returns the height of this element
() -> <n> Height in px
@*/
height: function() {
return this[0].offsetHeight;
},
2012-04-15 12:14:18 +00:00
/*@
hide <f> Hides this element
() -> <o> This element
@*/
hide: function() {
return this.css({display: 'none'});
},
/*@
html <f> Gets or sets the inner HTML
2012-04-15 12:14:18 +00:00
() -> <s> The inner HTML
(html) -> <o> This element
html <s> The inner HTML
@*/
2012-05-25 07:52:57 +00:00
html: function(string) {
var ret;
2012-05-25 07:52:57 +00:00
if (arguments.length == 0) {
ret = this[0].innerHTML;
} else {
2012-05-25 07:53:55 +00:00
this[0].innerHTML = string;
ret = this;
}
return ret;
},
/*@
on <f> Binds a callback to an event
(event, callback) -> <o> This element
({event0: callback0, event1: callback1, ...}) -> <o> This element
event <s> Event name
callback <f> Callback function
e <o> Event properties
@*/
on: function() {
var that = this;
Ox.forEach(Ox.makeObject(arguments), function(callback, event) {
that[0].addEventListener(event, callback);
});
return this;
},
/*@
2012-04-15 12:14:18 +00:00
one <f> Binds a callback to an event and unbinds it on first invocation
(event, callback) -> <o> This element
({event0: callback0, event1: callback1, ...}) -> <o> This element
event <s> Event name
callback <f> Callback function
2012-04-15 12:14:18 +00:00
e <o> Event properties
@*/
2012-04-15 12:14:18 +00:00
one: function(events) {
var that = this;
Ox.forEach(Ox.makeObject(arguments), function(callback, event) {
that.on(event, function fn() {
that.off(event, fn);
2012-04-15 12:14:18 +00:00
callback();
});
});
return this;
},
2012-04-15 12:14:18 +00:00
/*@
off <f> Unbinds a callback from an event
(event) -> <o> This element (unbinds all callbacks)
(event, callback) -> <o> This element
({event0: callback0, event1: callback1, ...}) -> <o> This element
event <s> Event name
callback <f> Callback function
@*/
off: function(event, callback) {
var that = this;
Ox.forEach(Ox.makeObject(arguments), function(callback, event) {
if (callback) {
that[0].removeEventListener(event, callback);
} else {
that[0]['on' + event] = null;
}
});
return this;
},
/*@
2012-04-15 12:14:18 +00:00
remove <f> Removes this element from the DOM
() -> <o> This element
@*/
2012-04-06 23:45:51 +00:00
remove: function() {
this[0].parentNode.removeChild(this[0]);
return this;
},
/*@
removeAttr <f> Removes an attribute
(key) -> <o> This element
2012-04-15 12:14:18 +00:00
([key0, key1, ...]) -> <o> This element
key <s> The attribute
@*/
2012-04-15 12:14:18 +00:00
removeAttr: function() {
var that = this;
Ox.makeArray(arguments[0]).forEach(function(key) {
that[0].removeAttribute(key);
2012-04-15 12:14:18 +00:00
});
return this;
},
/*@
removeClass <f> Removes a class name
(className) -> <o> This element
className <s> Class name
@*/
2012-05-25 07:52:57 +00:00
removeClass: function(string) {
var array = Ox.clean(string).split(' ');
2012-04-15 12:14:18 +00:00
this[0].className = this[0].className.split(' ').filter(
function(className) {
2012-05-25 07:52:57 +00:00
return array.indexOf(className) == -1;
}
).join(' ');
return this;
2012-04-05 15:30:00 +00:00
},
2012-04-15 12:14:18 +00:00
/*@
show <f> Show this element
() -> This element
@*/
show: function() {
return this.css({display: 'block'});
},
2012-04-15 12:14:18 +00:00
/*@
trigger <f> Triggers an event
2012-05-30 22:47:57 +00:00
(event) -> <o> This element
@*/
trigger: function(event) {
var e = document.createEvent('MouseEvents');
e.initEvent(event, true, true);
this[0].dispatchEvent(e);
return this;
},
/*@
2012-04-15 12:14:18 +00:00
val <f> Gets or sets the value property of this element
() -> <s> Value
(value) -> <o> This element
value <s> Value
@*/
2012-05-25 07:52:57 +00:00
val: function(value) {
2012-04-14 09:45:19 +00:00
var ret;
if (arguments.length == 0) {
2012-05-30 22:47:57 +00:00
ret = this[0].value;
2012-04-14 09:45:19 +00:00
} else {
2012-05-25 07:52:57 +00:00
this[0].value = value;
2012-04-14 09:45:19 +00:00
ret = this;
}
return ret;
},
2012-04-15 12:14:18 +00:00
/*@
width <f> Returns the width of this element
() -> <n> Width in px
@*/
width: function() {
return this[0].offsetWidth;
}
2012-04-05 15:30:00 +00:00
} : null;
};
2012-05-27 21:17:40 +00:00
/*@
Ox.canvas <function> Generic canvas object
# Description --------------------------------------------------------------
Returns an object with the properties: `canvas`, `context`, `data` and
`imageData`.
2012-05-27 21:17:40 +00:00
# Usage --------------------------------------------------------------------
Ox.canvas(width, height) -> <object> canvas
Ox.canvas(image) -> <object> canvas
# Arguments ----------------------------------------------------------------
width <n> Width in px
height <n> Height in px
image <e> Image object
@*/
Ox.canvas = function() {
var c = {}, isImage = arguments.length == 1,
image = isImage ? arguments[0] : {
width: arguments[0], height: arguments[1]
};
c.context = (c.canvas = Ox.$('<canvas>').attr({
width: image.width, height: image.height
})[0]).getContext('2d');
isImage && c.context.drawImage(image, 0, 0);
c.data = (c.imageData = c.context.getImageData(
0, 0, image.width, image.height
)).data;
return c;
};
/*@
Ox.documentReady <function> Calls a callback function once the DOM is ready
(callback) -> <b> If true, the document was ready
callback <f> Callback function
@*/
Ox.documentReady = (function() {
var callbacks = [];
document.onreadystatechange = function() {
if (document.readyState == 'complete') {
callbacks.forEach(function(callback) {
callback();
});
}
};
return function(callback) {
if (document.readyState == 'complete') {
callback();
return true;
} else {
callbacks.push(callback);
return false;
}
};
}());