define("dijit/_editor/selection", [ "dojo/dom", // dom.byId "dojo/_base/lang", "dojo/_base/sniff", // has("ie") has("opera") "dojo/_base/window", // win.body win.doc win.doc.createElement win.doc.selection win.doc.selection.createRange win.doc.selection.type.toLowerCase win.global win.global.getSelection ".." // for exporting symbols to dijit._editor.selection (TODO: remove in 2.0) ], function(dom, lang, has, win, dijit){ // module: // dijit/_editor/selection // summary: // Text selection API lang.getObject("_editor.selection", true, dijit); // FIXME: // all of these methods branch internally for IE. This is probably // sub-optimal in terms of runtime performance. We should investigate the // size difference for differentiating at definition time. lang.mixin(dijit._editor.selection, { getType: function(){ // summary: // Get the selection type (like win.doc.select.type in IE). if(has("ie") < 9){ return win.doc.selection.type.toLowerCase(); }else{ var stype = "text"; // Check if the actual selection is a CONTROL (IMG, TABLE, HR, etc...). var oSel; try{ oSel = win.global.getSelection(); }catch(e){ /*squelch*/ } if(oSel && oSel.rangeCount == 1){ var oRange = oSel.getRangeAt(0); if( (oRange.startContainer == oRange.endContainer) && ((oRange.endOffset - oRange.startOffset) == 1) && (oRange.startContainer.nodeType != 3 /* text node*/) ){ stype = "control"; } } return stype; //String } }, getSelectedText: function(){ // summary: // Return the text (no html tags) included in the current selection or null if no text is selected if(has("ie") < 9){ if(dijit._editor.selection.getType() == 'control'){ return null; } return win.doc.selection.createRange().text; }else{ var selection = win.global.getSelection(); if(selection){ return selection.toString(); //String } } return ''; }, getSelectedHtml: function(){ // summary: // Return the html text of the current selection or null if unavailable if(has("ie") < 9){ if(dijit._editor.selection.getType() == 'control'){ return null; } return win.doc.selection.createRange().htmlText; }else{ var selection = win.global.getSelection(); if(selection && selection.rangeCount){ var i; var html = ""; for(i = 0; i < selection.rangeCount; i++){ //Handle selections spanning ranges, such as Opera var frag = selection.getRangeAt(i).cloneContents(); var div = win.doc.createElement("div"); div.appendChild(frag); html += div.innerHTML; } return html; //String } return null; } }, getSelectedElement: function(){ // summary: // Retrieves the selected element (if any), just in the case that // a single element (object like and image or a table) is // selected. if(dijit._editor.selection.getType() == "control"){ if(has("ie") < 9){ var range = win.doc.selection.createRange(); if(range && range.item){ return win.doc.selection.createRange().item(0); } }else{ var selection = win.global.getSelection(); return selection.anchorNode.childNodes[ selection.anchorOffset ]; } } return null; }, getParentElement: function(){ // summary: // Get the parent element of the current selection if(dijit._editor.selection.getType() == "control"){ var p = this.getSelectedElement(); if(p){ return p.parentNode; } }else{ if(has("ie") < 9){ var r = win.doc.selection.createRange(); r.collapse(true); return r.parentElement(); }else{ var selection = win.global.getSelection(); if(selection){ var node = selection.anchorNode; while(node && (node.nodeType != 1)){ // not an element node = node.parentNode; } return node; } } } return null; }, hasAncestorElement: function(/*String*/tagName /* ... */){ // summary: // Check whether current selection has a parent element which is // of type tagName (or one of the other specified tagName) // tagName: String // The tag name to determine if it has an ancestor of. return this.getAncestorElement.apply(this, arguments) != null; //Boolean }, getAncestorElement: function(/*String*/tagName /* ... */){ // summary: // Return the parent element of the current selection which is of // type tagName (or one of the other specified tagName) // tagName: String // The tag name to determine if it has an ancestor of. var node = this.getSelectedElement() || this.getParentElement(); return this.getParentOfType(node, arguments); //DOMNode }, isTag: function(/*DomNode*/ node, /*String[]*/ tags){ // summary: // Function to determine if a node is one of an array of tags. // node: // The node to inspect. // tags: // An array of tag name strings to check to see if the node matches. if(node && node.tagName){ var _nlc = node.tagName.toLowerCase(); for(var i=0; i nodes and possibly others ... so //we use the W3C range API if(selection.rangeCount){ range = selection.getRangeAt(0); }else{ range = doc.createRange(); } range.setStart(element, 0); range.setEnd(element,(element.nodeType == 3)?element.length:element.childNodes.length); selection.addRange(range); }else{ selection.selectAllChildren(element); } } }, selectElement: function(/*DomNode*/element,/*Boolean?*/nochangefocus){ // summary: // clear previous selection and select element (including all its children) // element: DOMNode // The element to select. // nochangefocus: Boolean // Boolean indicating if the focus should be changed. IE only. var range; var doc = win.doc; var global = win.global; element = dom.byId(element); if(has("ie") < 9 && win.body().createTextRange){ try{ var tg = element.tagName ? element.tagName.toLowerCase() : ""; if(tg === "img" || tg === "table"){ range = win.body().createControlRange(); }else{ range = win.body().createRange(); } range.addElement(element); if(!nochangefocus){ range.select(); } }catch(e){ this.selectElementChildren(element,nochangefocus); } }else if(global.getSelection){ var selection = global.getSelection(); range = doc.createRange(); if(selection.removeAllRanges){ // Mozilla // FIXME: does this work on Safari? if(has("opera")){ //Opera works if you use the current range on //the selection if present. if(selection.getRangeAt(0)){ range = selection.getRangeAt(0); } } range.selectNode(element); selection.removeAllRanges(); selection.addRange(range); } } }, inSelection: function(node){ // summary: // This function determines if 'node' is // in the current selection. // tags: // public if(node){ var newRange; var doc = win.doc; var range; if(win.global.getSelection){ //WC3 var sel = win.global.getSelection(); if(sel && sel.rangeCount > 0){ range = sel.getRangeAt(0); } if(range && range.compareBoundaryPoints && doc.createRange){ try{ newRange = doc.createRange(); newRange.setStart(node, 0); if(range.compareBoundaryPoints(range.START_TO_END, newRange) === 1){ return true; } }catch(e){ /* squelch */} } }else if(doc.selection){ // Probably IE, so we can't use the range object as the pseudo // range doesn't implement the boundry checking, we have to // use IE specific crud. range = doc.selection.createRange(); try{ newRange = node.ownerDocument.body.createControlRange(); if(newRange){ newRange.addElement(node); } }catch(e1){ try{ newRange = node.ownerDocument.body.createTextRange(); newRange.moveToElementText(node); }catch(e2){/* squelch */} } if(range && newRange){ // We can finally compare similar to W3C if(range.compareEndPoints("EndToStart", newRange) === 1){ return true; } } } } return false; // boolean } }); return dijit._editor.selection; });