selection.js revision 9002d9b85f99bb503c702f12a20f829f732d22f8
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnellYUI.add('selection', function(Y) {
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell /**
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell * Wraps some common Selection/Range functionality into a simple object
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell * @module editor
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell * @submodule selection
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell */
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell /**
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell * Wraps some common Selection/Range functionality into a simple object
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell * @class Selection
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell * @for Selection
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell * @constructor
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell */
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell //TODO This shouldn't be there, Y.Node doesn't normalize getting textnode content.
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell var textContent = 'textContent',
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell INNER_HTML = 'innerHTML',
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell FONT_FAMILY = 'fontFamily';
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell Y.Selection = function() {
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell var sel, par, ieNode, nodes, rng, i;
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell if (Y.config.win.getSelection) {
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell sel = Y.config.win.getSelection();
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell } else if (Y.config.doc.selection) {
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell sel = Y.config.doc.selection.createRange();
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell }
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell this._selection = sel;
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell if (sel.pasteHTML) {
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell textContent = 'nodeValue';
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell this.isCollapsed = (sel.compareEndPoints('StartToEnd', sel)) ? false : true;
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell if (this.isCollapsed) {
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell this.anchorNode = this.focusNode = Y.one(sel.parentElement());
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell par = sel.parentElement();
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell nodes = par.childNodes;
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell rng = sel.duplicate();
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell for (i = 0; i < nodes.length; i++) {
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell rng.select(nodes[i]);
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott if (rng.inRange(sel)) {
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott ieNode = nodes[i];
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott }
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell }
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell this.ieNode = ieNode;
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell if (ieNode) {
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell if (ieNode.nodeType !== 3) {
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell if (ieNode.firstChild) {
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell ieNode = ieNode.firstChild;
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott }
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell }
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell this.anchorNode = this.focusNode = Y.Selection.resolve(ieNode);
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell this.anchorOffset = this.focusOffset = (this.anchorNode.nodeValue) ? this.anchorNode.nodeValue.length : 0 ;
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell this.anchorTextNode = this.focusTextNode = Y.one(ieNode);
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell }
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell }
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell //var self = this;
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell //debugger;
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell } else {
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell this.isCollapsed = sel.isCollapsed;
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell this.anchorNode = Y.Selection.resolve(sel.anchorNode);
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell this.focusNode = Y.Selection.resolve(sel.focusNode);
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell this.anchorOffset = sel.anchorOffset;
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell this.focusOffset = sel.focusOffset;
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell this.anchorTextNode = Y.one(sel.anchorNode);
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott this.focusTextNode = Y.one(sel.focusNode);
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott }
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott if (Y.Lang.isString(sel.text)) {
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott this.text = sel.text;
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell } else {
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott this.text = sel.toString();
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell }
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott };
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott /**
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott * Performs a prefilter on all nodes in the editor. Looks for nodes with a style: fontFamily or font face
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell * It then creates a dynamic class assigns it and removed the property. This is so that we don't lose
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott * the fontFamily when selecting nodes.
415243fbc81341293a852ff6aa14e9608d08685cCraig McDonnell * @static
91f0e3cb60de3eba8cbb70c7e36cc0df22d71f5bRobert Wapshott * @method filter
2beebed98b4fc7f018fb224a1e4a3ab6103a4c0bCraig McDonnell */
Y.Selection.filter = function(blocks) {
var nodes = Y.all(Y.Selection.ALL),
baseNodes = Y.all('strong,em'),
ls;
nodes.each(function(n) {
if (n.getStyle(FONT_FAMILY)) {
var sheet = new Y.StyleSheet('editor');
sheet.set('.' + n._yuid, {
fontFamily: n.getStyle(FONT_FAMILY)
});
n.addClass(n._yuid);
n.removeAttribute('face');
n.setStyle(FONT_FAMILY, '');
if (n.getAttribute('style') === '') {
n.removeAttribute('style');
}
//This is for IE
if (n.getAttribute('style').toLowerCase() === 'font-family: ') {
n.removeAttribute('style');
}
}
});
//Not sure about this one?
baseNodes.each(function(n, k) {
var t = n.get('tagName').toLowerCase(),
newTag = 'i';
if (t === 'strong') {
newTag = 'b';
}
Y.Selection.prototype._swap(baseNodes.item(k), newTag);
});
//Filter out all the empty UL/OL's
ls = Y.all('ol,ul');
ls.each(function(v, k) {
var lis = v.all('li');
if (!lis.size()) {
v.remove();
}
});
if (blocks) {
Y.Selection.filterBlocks();
}
};
/**
* Method attempts to replace all "orphined" text nodes in the main body by wrapping them with a <p>. Called from filter.
* @static
* @method filterBlocks
*/
Y.Selection.filterBlocks = function() {
var childs = Y.config.doc.body.childNodes, i, node, wrapped = false, doit = true,
sel, single, br;
if (childs) {
for (i = 0; i < childs.length; i++) {
node = Y.one(childs[i]);
if (!node.test(Y.Selection.BLOCKS)) {
doit = true;
if (childs[i].nodeType == 3) {
if (childs[i].textContent == '\n') {
doit = false;
}
}
if (doit) {
if (!wrapped) {
wrapped = [];
}
wrapped.push(childs[i]);
}
} else {
wrapped = Y.Selection._wrapBlock(wrapped);
}
}
wrapped = Y.Selection._wrapBlock(wrapped);
}
single = Y.all('p');
if (single.size() === 1) {
br = single.item(0).all('br');
if (br.size() === 1) {
br.item(0).remove();
var html = single.item(0).get('innerHTML');
if (html == '' || html == ' ') {
single.set('innerHTML', '<span>&nbsp;</span>');
sel = new Y.Selection();
try {
sel.selectNode(single.item(0).get('firstChild'), true);
} catch (er) {}
}
}
}
};
Y.Selection._wrapBlock = function(wrapped) {
if (wrapped) {
var newChild = Y.Node.create('<p></p>'),
firstChild = Y.one(wrapped[0]), i;
for (i = 1; i < wrapped.length; i++) {
newChild.append(wrapped[i]);
}
firstChild.replace(newChild);
newChild.prepend(firstChild);
}
return false;
};
/**
* Undoes what filter does enough to return the HTML from the Editor, then re-applies the filter.
* @static
* @method unfilter
* @return {String} The filtered HTML
*/
Y.Selection.unfilter = function() {
var nodes = Y.all('body [class]'),
html = '', nons, ids;
nodes.each(function(n) {
if (n.hasClass(n._yuid)) {
//One of ours
n.setStyle(FONT_FAMILY, n.getStyle(FONT_FAMILY));
n.removeClass(n._yuid);
if (n.getAttribute('class') === '') {
n.removeAttribute('class');
}
}
});
nons = Y.all('.yui-non');
nons.each(function(n) {
if (n.get('innerHTML') === '') {
n.remove();
} else {
n.removeClass('yui-non');
}
});
ids = Y.all('body [id]');
ids.each(function(n) {
if (n.get('id').indexOf('yui_3_') === 0) {
n.removeAttribute('id');
n.removeAttribute('_yuid');
}
});
html = Y.one('body').get('innerHTML');
nodes.each(function(n) {
n.addClass(n._yuid);
n.setStyle(FONT_FAMILY, '');
if (n.getAttribute('style') === '') {
n.removeAttribute('style');
}
});
return html;
};
/**
* Resolve a node from the selection object and return a Node instance
* @static
* @method resolve
* @param {HTMLElement} n The HTMLElement to resolve. Might be a TextNode, gives parentNode.
* @return {Node} The Resolved node
*/
Y.Selection.resolve = function(n) {
if (n && n.nodeType === 3) {
n = n.parentNode;
}
return Y.one(n);
};
/**
* Returns the innerHTML of a node with all HTML tags removed.
* @static
* @method getText
* @param {Node} node The Node instance to remove the HTML from
* @return {String} The string of text
*/
Y.Selection.getText = function(node) {
return node.get('innerHTML').replace(Y.Selection.STRIP_HTML, '');
};
/**
* The selector to use when looking for Nodes to cache the value of: [style],font[face]
* @static
* @property ALL
*/
Y.Selection.ALL = '[style],font[face]';
/**
* RegExp used to strip HTML tags from a string
* @static
* @property STRIP_HTML
*/
Y.Selection.STRIP_HTML = /<\S[^><]*>/g;
/**
* The selector to use when looking for block level items.
* @static
* @property BLOCKS
*/
Y.Selection.BLOCKS = 'p,div,ul,ol,table,style';
/**
* The temporary fontname applied to a selection to retrieve their values: yui-tmp
* @static
* @property TMP
*/
Y.Selection.TMP = 'yui-tmp';
/**
* The default tag to use when creating elements: span
* @static
* @property DEFAULT_TAG
*/
Y.Selection.DEFAULT_TAG = 'span';
Y.Selection.CURID = 'yui-cursor';
Y.Selection.CURSOR = '<span id="' + Y.Selection.CURID + '">&nbsp;</span>';
Y.Selection.prototype = {
/**
* Range text value
* @property text
* @type String
*/
text: null,
/**
* Flag to show if the range is collapsed or not
* @property isCollapsed
* @type Boolean
*/
isCollapsed: null,
/**
* A Node instance of the parentNode of the anchorNode of the range
* @property anchorNode
* @type Node
*/
anchorNode: null,
/**
* The offset from the range object
* @property anchorOffset
* @type Number
*/
anchorOffset: null,
/**
* A Node instance of the actual textNode of the range.
* @property anchorTextNode
* @type Node
*/
anchorTextNode: null,
/**
* A Node instance of the parentNode of the focusNode of the range
* @property focusNode
* @type Node
*/
focusNode: null,
/**
* The offset from the range object
* @property focusOffset
* @type Number
*/
focusOffset: null,
/**
* A Node instance of the actual textNode of the range.
* @property focusTextNode
* @type Node
*/
focusTextNode: null,
/**
* The actual Selection/Range object
* @property _selection
* @private
*/
_selection: null,
/**
* Wrap an element, with another element
* @private
* @method _wrap
* @param {HTMLElement} n The node to wrap
* @param {String} tag The tag to use when creating the new element.
* @return {HTMLElement} The wrapped node
*/
_wrap: function(n, tag) {
var tmp = Y.Node.create('<' + tag + '></' + tag + '>');
tmp.set(INNER_HTML, n.get(INNER_HTML));
n.set(INNER_HTML, '');
n.append(tmp);
return Y.Node.getDOMNode(tmp);
},
/**
* Swap an element, with another element
* @private
* @method _swap
* @param {HTMLElement} n The node to swap
* @param {String} tag The tag to use when creating the new element.
* @return {HTMLElement} The new node
*/
_swap: function(n, tag) {
var tmp = Y.Node.create('<' + tag + '></' + tag + '>');
tmp.set(INNER_HTML, n.get(INNER_HTML));
n.replace(tmp, n);
return Y.Node.getDOMNode(tmp);
},
/**
* Get all the nodes in the current selection. This method will actually perform a filter first.
* Then it calls doc.execCommand('fontname', null, 'yui-tmp') to touch all nodes in the selection.
* The it compiles a list of all nodes affected by the execCommand and builds a NodeList to return.
* @method getSelected
* @return {NodeList} A NodeList of all items in the selection.
*/
getSelected: function() {
Y.Selection.filter();
Y.config.doc.execCommand('fontname', null, Y.Selection.TMP);
var nodes = Y.all(Y.Selection.ALL),
items = [];
nodes.each(function(n, k) {
if (n.getStyle(FONT_FAMILY, Y.Selection.TMP)) {
n.setStyle(FONT_FAMILY, '');
n.removeAttribute('face');
if (n.getAttribute('style') === '') {
n.removeAttribute('style');
}
items.push(Y.Node.getDOMNode(nodes.item(k)));
}
});
return Y.all(items);
},
/**
* Insert HTML at the current cursor position and return a Node instance of the newly inserted element.
* @method insertContent
* @param {String} html The HTML to insert.
* @return {Node} The inserted Node.
*/
insertContent: function(html) {
return this.insertAtCursor(html, this.anchorTextNode, this.anchorOffset, true);
},
/**
* Insert HTML at the current cursor position, this method gives you control over the text node to insert into and the offset where to put it.
* @method insertAtCursor
* @param {String} html The HTML to insert.
* @param {Node} node The text node to break when inserting.
* @param {Number} offset The left offset of the text node to break and insert the new content.
* @param {Boolean} collapse Should the range be collapsed after insertion. default: false
* @return {Node} The inserted Node.
*/
insertAtCursor: function(html, node, offset, collapse) {
var cur = Y.Node.create('<' + Y.Selection.DEFAULT_TAG + ' class="yui-non"></' + Y.Selection.DEFAULT_TAG + '>'),
inHTML, txt, txt2, newNode, range = this.createRange(), b;
if (node && node.test('body')) {
b = Y.Node.create('<span></span>');
node.append(b);
node = b;
}
if (range.pasteHTML) {
newNode = Y.Node.create(html);
range.pasteHTML('<span id="rte-insert"></span>');
inHTML = Y.one('#rte-insert');
if (inHTML) {
inHTML.set('id', '');
inHTML.replace(newNode);
return newNode;
} else {
Y.on('available', function() {
inHTML.set('id', '');
inHTML.replace(newNode);
}, '#rte-insert');
}
} else {
//TODO using Y.Node.create here throws warnings & strips first white space character
//txt = Y.one(Y.Node.create(inHTML.substr(0, offset)));
//txt2 = Y.one(Y.Node.create(inHTML.substr(offset)));
if (offset > 0) {
inHTML = node.get(textContent);
txt = Y.one(Y.config.doc.createTextNode(inHTML.substr(0, offset)));
txt2 = Y.one(Y.config.doc.createTextNode(inHTML.substr(offset)));
node.replace(txt, node);
newNode = Y.Node.create(html);
txt.insert(newNode, 'after');
if (txt2 && txt2.get('length')) {
newNode.insert(cur, 'after');
cur.insert(txt2, 'after');
this.selectNode(cur, collapse);
}
} else {
newNode = Y.Node.create(html);
node.append(newNode);
}
}
return newNode;
},
/**
* Get all elements inside a selection and wrap them with a new element and return a NodeList of all elements touched.
* @method wrapContent
* @param {String} tag The tag to wrap all selected items with.
* @return {NodeList} A NodeList of all items in the selection.
*/
wrapContent: function(tag) {
tag = (tag) ? tag : Y.Selection.DEFAULT_TAG;
if (!this.isCollapsed) {
var items = this.getSelected(),
changed = [], range, last, first, range2;
items.each(function(n, k) {
var t = n.get('tagName').toLowerCase();
if (t === 'font') {
changed.push(this._swap(items.item(k), tag));
} else {
changed.push(this._wrap(items.item(k), tag));
}
}, this);
range = this.createRange();
first = changed[0];
last = changed[changed.length - 1];
if (this._selection.removeAllRanges) {
range.setStart(changed[0], 0);
range.setEnd(last, last.childNodes.length);
this._selection.removeAllRanges();
this._selection.addRange(range);
} else {
range.moveToElementText(Y.Node.getDOMNode(first));
range2 = this.createRange();
range2.moveToElementText(Y.Node.getDOMNode(last));
range.setEndPoint('EndToEnd', range2);
range.select();
}
changed = Y.all(changed);
return changed;
} else {
return Y.all([]);
}
},
/**
* Find and replace a string inside a text node and replace it with HTML focusing the node after
* to allow you to continue to type.
* @method replace
* @param {String} se The string to search for.
* @param {String} re The string of HTML to replace it with.
* @return {Node} The node inserted.
*/
replace: function(se,re) {
var range = this.createRange(), node, txt, index, newNode;
if (range.getBookmark) {
index = range.getBookmark();
txt = this.anchorNode.get('innerHTML').replace(se, re);
this.anchorNode.set('innerHTML', txt);
range.moveToBookmark(index);
newNode = Y.one(range.parentElement());
} else {
node = this.anchorTextNode;
txt = node.get(textContent);
index = txt.indexOf(se);
txt = txt.replace(se, '');
node.set(textContent, txt);
newNode = this.insertAtCursor(re, node, index, true);
}
return newNode;
},
/**
* Destroy the range.
* @method remove
* @chainable
* @return {Y.Selection}
*/
remove: function() {
this._selection.removeAllRanges();
return this;
},
/**
* Wrapper for the different range creation methods.
* @method createRange
* @return {RangeObject}
*/
createRange: function() {
if (Y.config.doc.selection) {
return Y.config.doc.selection.createRange();
} else {
return Y.config.doc.createRange();
}
},
/**
* Select a Node (hilighting it).
* @method selectNode
* @param {Node} node The node to select
* @param {Boolean} collapse Should the range be collapsed after insertion. default: false
* @chainable
* @return {Y.Selection}
*/
selectNode: function(node, collapse, end) {
end = end || 0;
node = Y.Node.getDOMNode(node);
var range = this.createRange();
if (range.selectNode) {
range.selectNode(node);
this._selection.removeAllRanges();
this._selection.addRange(range);
if (collapse) {
try {
this._selection.collapse(node, end);
} catch (e) {
this._selection.collapse(node, 0);
}
}
} else {
if (node.nodeType === 3) {
node = node.parentNode;
}
range.moveToElementText(node);
if (collapse) {
range.collapse(((end) ? false : true));
}
range.select();
}
return this;
},
/**
* Put a placeholder in the DOM at the current cursor position.
* @method setCursor
* @return {Node}
*/
setCursor: function() {
return this.insertContent(Y.Selection.CURSOR);
},
/**
* Get the placeholder in the DOM at the current cursor position.
* @method getCursor
* @return {Node}
*/
getCursor: function() {
return Y.one('#' + Y.Selection.CURID);
},
/**
* Remove the cursor placeholder from the DOM.
* @method removeCursor
* @param {Boolean} keep Setting this to true will keep the node, but remove the unique parts that make it the cursor.
* @return {Node}
*/
removeCursor: function(keep) {
var cur = this.getCursor();
if (cur) {
if (keep) {
cur.removeAttribute('id');
cur.set('innerHTML', '&nbsp;');
} else {
cur.remove();
}
}
return cur;
},
/**
* Gets a stored cursor and focuses it for editing, must be called sometime after setCursor
* @method focusCursor
* @return {Node}
*/
focusCursor: function(collapse, end) {
if (collapse !== false) {
collapse = true;
}
if (end !== false) {
end = true;
}
var cur = this.removeCursor(true);
if (cur) {
this.selectNode(cur, collapse, end);
}
},
/**
* Generic toString for logging.
* @method toString
* @return {String}
*/
toString: function() {
return 'Selection Object';
}
};
}, '@VERSION@' ,{requires:['node'], skinnable:false});