jquery-textrange

Replace the selected text with: +

- \ No newline at end of file + From fa14083d624b898603685a86efd03cff5d329c46 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Tue, 24 Jul 2012 17:42:09 -0500 Subject: [PATCH 03/57] Adding a live demonstration for the plugin. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index b99c8e5..0d4e306 100644 --- a/README.md +++ b/README.md @@ -6,4 +6,4 @@ This jQuery plugin is for easily finding the starting and ending positions of se * [$().textrange('replace')](https://github.com/dwieeb/jquery-textrange/wiki/Replace) ## Demo -* http://jsfiddle.net/F29Qz/ \ No newline at end of file +* http://dwieeb.github.com/jquery-textrange/ \ No newline at end of file From a3caae175868453ba45dfa06f13718b0a25f40b5 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Sat, 28 Jul 2012 14:45:25 -0500 Subject: [PATCH 04/57] Adding some commands for people to compile a minified version. --- README.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0d4e306..1f8c033 100644 --- a/README.md +++ b/README.md @@ -6,4 +6,12 @@ This jQuery plugin is for easily finding the starting and ending positions of se * [$().textrange('replace')](https://github.com/dwieeb/jquery-textrange/wiki/Replace) ## Demo -* http://dwieeb.github.com/jquery-textrange/ \ No newline at end of file +* http://dwieeb.github.com/jquery-textrange/ + +## Minified Version +A minified version of this plugin can be generated using Google's Closure Compiler (preferred). + + wget http://closure-compiler.googlecode.com/files/compiler-latest.tar.gz + tar -zvxf compiler-latest.tar.gz compiler.jar + wget https://raw.github.com/dwieeb/jquery-textrange/master/jquery-textrange.js + java -jar compiler.jar --js jquery-textrange.js --js_output_file jquery-textrange.min.js From 982c9c7d59297e968542a318629af924f8d6bf80 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Wed, 1 Aug 2012 13:20:09 -0500 Subject: [PATCH 05/57] Adding LICENSE.TXT --- LICENSE.TXT | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 LICENSE.TXT diff --git a/LICENSE.TXT b/LICENSE.TXT new file mode 100644 index 0000000..39a257d --- /dev/null +++ b/LICENSE.TXT @@ -0,0 +1,13 @@ + DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE + Version 2, December 2004 + + Copyright (C) 2004 Sam Hocevar + + Everyone is permitted to copy and distribute verbatim or modified + copies of this license document, and changing it is allowed as long + as the name is changed. + + DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. You just DO WHAT THE FUCK YOU WANT TO. From 72df639206f5900600a3fdd3c4956a71ae686250 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Wed, 14 Nov 2012 14:58:58 -0600 Subject: [PATCH 06/57] Changing api for efficency's sake. --- jquery-textrange.js | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index 715c1f7..bc8a6ba 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -30,16 +30,13 @@ set: function(start, end) { if(typeof start === 'undefined') { start = 0; - } - else if(start === 'all') { - start = 0; - end = 'end'; + end = -1; } if(typeof end === 'undefined') { end = start; } - else if(end === 'end') { + else if(end === -1) { end = this.val().length; } From adeda0c34174294a824945edcbc8018cb06887af Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Sat, 1 Dec 2012 05:03:27 -0600 Subject: [PATCH 07/57] this seemed to be an issue with set, and I may as well apply it to all --- jquery-textrange.js | 3 +++ 1 file changed, 3 insertions(+) diff --git a/jquery-textrange.js b/jquery-textrange.js index bc8a6ba..08b3682 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -68,6 +68,7 @@ var _textrange = { xul: { get: function(property) { + this[0].focus(); var props = { position: this[0].selectionStart, start: this[0].selectionStart, @@ -80,11 +81,13 @@ }, set: function(start, end) { + this[0].focus(); this[0].selectionStart = start; this[0].selectionEnd = end; }, replace: function(text) { + this[0].focus(); var start = this[0].selectionStart; this.val(this.val().substring(0, this[0].selectionStart) + text + this.val().substring(this[0].selectionEnd, this.val().length)); this[0].selectionStart = start; From 3c4c50e269a12c12633a47188d862e96f2ef61c6 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Thu, 24 Jan 2013 17:19:27 -0600 Subject: [PATCH 08/57] preparing plugin for plugins.jquery.com --- LICENSE | 7 +++++++ LICENSE.TXT | 13 ------------- textrange.jquery.json | 44 +++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 51 insertions(+), 13 deletions(-) create mode 100644 LICENSE delete mode 100644 LICENSE.TXT create mode 100644 textrange.jquery.json diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..5a5d65b --- /dev/null +++ b/LICENSE @@ -0,0 +1,7 @@ +Copyright (c) 2012 Daniel Imhoff + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. \ No newline at end of file diff --git a/LICENSE.TXT b/LICENSE.TXT deleted file mode 100644 index 39a257d..0000000 --- a/LICENSE.TXT +++ /dev/null @@ -1,13 +0,0 @@ - DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE - Version 2, December 2004 - - Copyright (C) 2004 Sam Hocevar - - Everyone is permitted to copy and distribute verbatim or modified - copies of this license document, and changing it is allowed as long - as the name is changed. - - DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE - TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION - - 0. You just DO WHAT THE FUCK YOU WANT TO. diff --git a/textrange.jquery.json b/textrange.jquery.json new file mode 100644 index 0000000..eae5b93 --- /dev/null +++ b/textrange.jquery.json @@ -0,0 +1,44 @@ +{ + "name": "textrange", + "title": "jQuery TextRange", + "description": "jQuery plugin for getting, setting, and replacing the selected text in input fields and textareas.", + "keywords": [ + "text", + "range", + "caret", + "cursor", + "textrange", + "select", + "highlight", + "selection", + "field", + "input", + "textarea", + "replace" + ], + "version": "1.0", + "author": { + "name": "Daniel Imhoff", + "url": "http://www.danielimhoff.com" + }, + "maintainers": [ + { + "name": "Daniel Imhoff", + "email": "dwieeb@gmail.com", + "url": "http://www.danielimhoff.com" + } + ], + "licenses": [ + { + "type": "MIT", + "url": "https://github.com/dwieeb/jquery-textrange/blob/master/LICENSE" + } + ], + "bugs": "", + "homepage": "http://dwieeb.github.com/jquery-textrange", + "docs": "https://github.com/dwieeb/jquery-textrange/wiki", + "demo": "http://dwieeb.github.com/jquery-textrange", + "dependencies": { + "jquery": ">=1.4.4" + } +} \ No newline at end of file From a3b3009e42d5d82e2d2095fb0bd9fd0c2ffb08ab Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Thu, 24 Jan 2013 17:38:09 -0600 Subject: [PATCH 09/57] semver! --- textrange.jquery.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/textrange.jquery.json b/textrange.jquery.json index eae5b93..0fa5c91 100644 --- a/textrange.jquery.json +++ b/textrange.jquery.json @@ -16,7 +16,7 @@ "textarea", "replace" ], - "version": "1.0", + "version": "1.0.0", "author": { "name": "Daniel Imhoff", "url": "http://www.danielimhoff.com" From 27031a9834b59e452628f9b46cd7fb404c66da17 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Thu, 24 Jan 2013 17:52:02 -0600 Subject: [PATCH 10/57] a little manifest and license cleanup --- LICENSE | 17 ++++++++++++++--- textrange.jquery.json | 10 ++-------- 2 files changed, 16 insertions(+), 11 deletions(-) diff --git a/LICENSE b/LICENSE index 5a5d65b..dcf879b 100644 --- a/LICENSE +++ b/LICENSE @@ -1,7 +1,18 @@ Copyright (c) 2012 Daniel Imhoff -Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: -The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. \ No newline at end of file +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. \ No newline at end of file diff --git a/textrange.jquery.json b/textrange.jquery.json index 0fa5c91..5f3b647 100644 --- a/textrange.jquery.json +++ b/textrange.jquery.json @@ -19,19 +19,13 @@ "version": "1.0.0", "author": { "name": "Daniel Imhoff", + "email": "dwieeb@gmail.com", "url": "http://www.danielimhoff.com" }, - "maintainers": [ - { - "name": "Daniel Imhoff", - "email": "dwieeb@gmail.com", - "url": "http://www.danielimhoff.com" - } - ], "licenses": [ { "type": "MIT", - "url": "https://github.com/dwieeb/jquery-textrange/blob/master/LICENSE" + "url": "https://raw.github.com/dwieeb/jquery-textrange/master/LICENSE" } ], "bugs": "", From 895d5e95c4a7d68fb2f238b44b035e2314678331 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 10 May 2013 18:05:44 -0500 Subject: [PATCH 11/57] adding bower package manager json file --- bower.json | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 bower.json diff --git a/bower.json b/bower.json new file mode 100644 index 0000000..7c9edc6 --- /dev/null +++ b/bower.json @@ -0,0 +1,14 @@ +{ + "name": "jquery-textrange", + "version": "1.0.1", + "main": "jquery-textrange.js", + "dependencies": { + "jquery": ">=1.3" + }, + "ignore": [ + "LICENSE", + "README.md", + "demo.html", + "textrange.jquery.json" + ] +} From cb54268eaf9ec44f315beefec6e79ab65fdc6775 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 10 May 2013 18:06:36 -0500 Subject: [PATCH 12/57] updating jquery plugin manifest --- textrange.jquery.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/textrange.jquery.json b/textrange.jquery.json index 5f3b647..efb153e 100644 --- a/textrange.jquery.json +++ b/textrange.jquery.json @@ -16,7 +16,7 @@ "textarea", "replace" ], - "version": "1.0.0", + "version": "1.0.1", "author": { "name": "Daniel Imhoff", "email": "dwieeb@gmail.com", @@ -33,6 +33,6 @@ "docs": "https://github.com/dwieeb/jquery-textrange/wiki", "demo": "http://dwieeb.github.com/jquery-textrange", "dependencies": { - "jquery": ">=1.4.4" + "jquery": ">=1.3" } -} \ No newline at end of file +} From b68549800f4073aca6a133c1b2b818484cdb7e33 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 7 Jun 2013 15:40:59 -0500 Subject: [PATCH 13/57] The parameters of set() have changed. Now using length instead of end for ease of use and better support for negative numbers. --- bower.json | 5 +- demo.html | 65 ++++---- jquery-textrange.js | 374 +++++++++++++++++++++++------------------- textrange.jquery.json | 6 +- 4 files changed, 240 insertions(+), 210 deletions(-) diff --git a/bower.json b/bower.json index 7c9edc6..3feb0fc 100644 --- a/bower.json +++ b/bower.json @@ -1,14 +1,11 @@ { "name": "jquery-textrange", - "version": "1.0.1", + "version": "1.1.0", "main": "jquery-textrange.js", "dependencies": { "jquery": ">=1.3" }, "ignore": [ - "LICENSE", - "README.md", - "demo.html", "textrange.jquery.json" ] } diff --git a/demo.html b/demo.html index fb89b9b..a9c7774 100644 --- a/demo.html +++ b/demo.html @@ -24,46 +24,47 @@ @@ -91,7 +92,7 @@

jquery-textrange

-Select a substring starting at and ending at +Select a substring starting at with a length of

Replace the selected text with: diff --git a/jquery-textrange.js b/jquery-textrange.js index 08b3682..7d21a4e 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -1,178 +1,208 @@ /** * jquery-textrange * A jQuery plugin for getting, setting and replacing the selected text in input fields and textareas. + * See the [wiki](https://github.com/dwieeb/jquery-textrange/wiki) for usage and examples. * - * (c) 2012 Daniel Imhoff - danielimhoff.com + * (c) 2013 Daniel Imhoff - danielimhoff.com */ (function($) { - var browserType; - - var textrange = { - /** - * $().textrange() or $().textrange('get') - * Retrieves an object containing the start and end location of the text range, the length of the range and the - * substring of the range. - * - * @param (optional) property - * @return An object of properties including position, start, end, length, and text or a specific property. - */ - get: function(property) { - return _textrange[browserType].get.apply(this, [property]); - }, - - /** - * $().textrange('set') - * Sets the selected text of an object by specifying the start and end of the selection. - * - * @param start The starting position of the selection, or the position of the cursor, if end is not given. - * @param (optional) end The ending position of the selection. - */ - set: function(start, end) { - if(typeof start === 'undefined') { - start = 0; - end = -1; - } - - if(typeof end === 'undefined') { - end = start; - } - else if(end === -1) { - end = this.val().length; - } - - _textrange[browserType].set.apply(this, [start, end]); - - return this; - }, - - /** - * $().textrange('replace') - * Replaces the selected text in the input field or textarea with text. - * - * @param text The text to replace the selection with. - */ - replace: function(text) { - _textrange[browserType].replace.apply(this, [text]); - - return this; - }, - - /** - * Alias for $().textrange('replace') - */ - insert: function(text) { - return this.textrange('replace', text); - } - }; - - var _textrange = { - xul: { - get: function(property) { - this[0].focus(); - var props = { - position: this[0].selectionStart, - start: this[0].selectionStart, - end: this[0].selectionEnd, - length: this[0].selectionEnd - this[0].selectionStart, - text: this.val().substring(this[0].selectionStart, this[0].selectionEnd) - }; - - return typeof property === 'undefined' ? props : props[property]; - }, - - set: function(start, end) { - this[0].focus(); - this[0].selectionStart = start; - this[0].selectionEnd = end; - }, - - replace: function(text) { - this[0].focus(); - var start = this[0].selectionStart; - this.val(this.val().substring(0, this[0].selectionStart) + text + this.val().substring(this[0].selectionEnd, this.val().length)); - this[0].selectionStart = start; - this[0].selectionEnd = start + text.length; - } - }, - - msie: { - get: function(property) { - this[0].focus(); - - var range = document.selection.createRange(); - - if(typeof range === 'undefined') { - return { - position: 0, - start: 0, - end: this[0].val().length, - length: this[0].val().length, - text: this.val() - }; - } - - var rangetext = this[0].createTextRange(); - var rangetextcopy = rangetext.duplicate(); - - rangetext.moveToBookmark(range.getBookmark()); - rangetextcopy.setEndPoint('EndToStart', rangetext); - - return { - position: rangetextcopy.text.length, - start: rangetextcopy.text.length, - end: rangetextcopy.text.length + range.text.length, - length: range.text.length, - text: range.text - }; - }, - - set: function(start, end) { - this[0].focus(); - - var range = this[0].createTextRange(); - - if(typeof range === 'undefined') { - return this; - } - - if(typeof start !== 'undefined') { - range.moveStart('character', start); - range.collapse(); - } - - if(typeof end !== 'undefined') { - range.moveEnd('character', end - start); - } - - range.select(); - }, - - replace: function(text) { - this[0].focus(); - - document.selection.createRange().text = text; - } - } - }; - - $.fn.textrange = function(method) { - if(typeof browserType === 'undefined') { - browserType = 'selectionStart' in this[0] ? 'xul' : document.selection ? 'msie' : 'unknown'; - } - - // I don't know how to support this browser. :c - if(browserType === 'unknown') { - return this; - } - - if(typeof method === 'undefined' || typeof method !== 'string') { - return textrange.get.apply(this); - } - else if(typeof textrange[method] === 'function') { - return textrange[method].apply(this, Array.prototype.slice.call(arguments, 1)); - } - else { - $.error("Method " + method + " does not exist in jQuery.textrange"); - } - }; -})(jQuery); \ No newline at end of file + var browserType, + + textrange = { + + /** + * $().textrange() or $().textrange('get') + * + * Retrieves an object containing the start and end location of the text range, the length of the range and the + * substring of the range. + * + * @param (optional) property + * @return An object of properties including position, start, end, length, and text or a specific property. + */ + get: function(property) { + return _textrange[browserType].get.apply(this, [property]); + }, + + /** + * $().textrange('set') + * + * Sets the selected text of an object by specifying the start and length of the selection. + * + * The start and length parameters are identical to PHP's substr() function with the following changes: + * - excluding start will select all the text in the field. + * - passing 0 for length will set the cursor at start. See $().textrange('setcursor') + * + * @param (optional) start + * @param (optional) length + * + * @see http://php.net/manual/en/function.substr.php + */ + set: function(start, length) { + var s = parseInt(start), + l = parseInt(length), + e; + + if (typeof start === 'undefined') { + s = 0; + } + else if (start < 0) { + s = this.val().length + s; + } + + if (typeof length === 'undefined') { + e = this.val().length; + } + else if (length >= 0) { + e = s + l; + } + else { + e = this.val().length + l; + } + + _textrange[browserType].set.apply(this, [s, e]); + + return this; + }, + + /** + * $().textrange('setcursor') + * + * Sets the cursor at a position of the text field. + * + * @param position + */ + setcursor: function(position) { + return this.textrange('set', position, 0); + }, + + /** + * $().textrange('replace') + * Replaces the selected text in the input field or textarea with text. + * + * @param text The text to replace the selection with. + */ + replace: function(text) { + _textrange[browserType].replace.apply(this, [text]); + + return this; + }, + + /** + * Alias for $().textrange('replace') + */ + insert: function(text) { + return this.textrange('replace', text); + } + }, + + _textrange = { + xul: { + get: function(property) { + this[0].focus(); + var props = { + position: this[0].selectionStart, + start: this[0].selectionStart, + end: this[0].selectionEnd, + length: this[0].selectionEnd - this[0].selectionStart, + text: this.val().substring(this[0].selectionStart, this[0].selectionEnd) + }; + + return typeof property === 'undefined' ? props : props[property]; + }, + + set: function(start, end) { + this[0].focus(); + this[0].selectionStart = start; + this[0].selectionEnd = end; + }, + + replace: function(text) { + this[0].focus(); + var start = this[0].selectionStart; + this.val(this.val().substring(0, this[0].selectionStart) + text + this.val().substring(this[0].selectionEnd, this.val().length)); + this[0].selectionStart = start; + this[0].selectionEnd = start + text.length; + } + }, + + msie: { + get: function(property) { + this[0].focus(); + + var range = document.selection.createRange(); + + if (typeof range === 'undefined') { + return { + position: 0, + start: 0, + end: this[0].val().length, + length: this[0].val().length, + text: this.val() + }; + } + + var rangetext = this[0].createTextRange(); + var rangetextcopy = rangetext.duplicate(); + + rangetext.moveToBookmark(range.getBookmark()); + rangetextcopy.setEndPoint('EndToStart', rangetext); + + return { + position: rangetextcopy.text.length, + start: rangetextcopy.text.length, + end: rangetextcopy.text.length + range.text.length, + length: range.text.length, + text: range.text + }; + }, + + set: function(start, end) { + this[0].focus(); + + var range = this[0].createTextRange(); + + if (typeof range === 'undefined') { + return this; + } + + if (typeof start !== 'undefined') { + range.moveStart('character', start); + range.collapse(); + } + + if (typeof end !== 'undefined') { + range.moveEnd('character', end - start); + } + + range.select(); + }, + + replace: function(text) { + this[0].focus(); + + document.selection.createRange().text = text; + } + } + }; + + $.fn.textrange = function(method) { + if (typeof browserType === 'undefined') { + browserType = 'selectionStart' in this[0] ? 'xul' : document.selection ? 'msie' : 'unknown'; + } + + // I don't know how to support this browser. :c + if (browserType === 'unknown') { + return this; + } + + if (typeof method === 'undefined' || typeof method !== 'string') { + return textrange.get.apply(this); + } + else if (typeof textrange[method] === 'function') { + return textrange[method].apply(this, Array.prototype.slice.call(arguments, 1)); + } + else { + $.error("Method " + method + " does not exist in jQuery.textrange"); + } + }; +})(jQuery); diff --git a/textrange.jquery.json b/textrange.jquery.json index efb153e..f3aa7d9 100644 --- a/textrange.jquery.json +++ b/textrange.jquery.json @@ -14,9 +14,11 @@ "field", "input", "textarea", - "replace" + "replace", + "substring", + "substr" ], - "version": "1.0.1", + "version": "1.1.0", "author": { "name": "Daniel Imhoff", "email": "dwieeb@gmail.com", From 72716e93459f385165588b506130987765ea9a69 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 7 Jun 2013 23:51:39 -0500 Subject: [PATCH 14/57] Update README.md --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 1f8c033..e870129 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,7 @@ This jQuery plugin is for easily finding the starting and ending positions of se ## Methods * [$().textrange('get')](https://github.com/dwieeb/jquery-textrange/wiki/Get) * [$().textrange('set')](https://github.com/dwieeb/jquery-textrange/wiki/Set) +* [$().textrange('setcursor')](https://github.com/dwieeb/jquery-textrange/wiki/SetCursor) * [$().textrange('replace')](https://github.com/dwieeb/jquery-textrange/wiki/Replace) ## Demo From ae883681b2e1dd7af32be8b56160b5540627f714 Mon Sep 17 00:00:00 2001 From: Daniel Wittner Date: Wed, 13 Nov 2013 16:17:24 +0100 Subject: [PATCH 15/57] Update jquery-textrange.js Call focus function of element in function 'get' for IE only, if it's not the active element yet. --- jquery-textrange.js | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index 7d21a4e..20bfe61 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -127,7 +127,9 @@ msie: { get: function(property) { - this[0].focus(); + if (document.activeElement !== this[0]) { + this[0].focus(); + } var range = document.selection.createRange(); From 76182b68c929c6eff78b0e9b3d07b965f5d34d2f Mon Sep 17 00:00:00 2001 From: Daniel Wittner Date: Thu, 14 Nov 2013 08:33:25 +0100 Subject: [PATCH 16/57] Update jquery-textrange.js 'if' statement for focus call added in functions 'set' and 'replace' for IE. --- jquery-textrange.js | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index 20bfe61..0a4b56a 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -159,7 +159,9 @@ }, set: function(start, end) { - this[0].focus(); + if (document.activeElement !== this[0]) { + this[0].focus(); + } var range = this[0].createTextRange(); @@ -180,7 +182,9 @@ }, replace: function(text) { - this[0].focus(); + if (document.activeElement !== this[0]) { + this[0].focus(); + } document.selection.createRange().text = text; } From 09027ea2238ba97500ba862d20bc8f2f4b74c5bc Mon Sep 17 00:00:00 2001 From: Daniel Wittner Date: Mon, 18 Nov 2013 09:47:05 +0100 Subject: [PATCH 17/57] Update jquery-textrange.js General use of focus function. --- jquery-textrange.js | 38 +++++++++++++++++++++++--------------- 1 file changed, 23 insertions(+), 15 deletions(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index 0a4b56a..ff0bdad 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -6,6 +6,23 @@ * (c) 2013 Daniel Imhoff - danielimhoff.com */ (function($) { + + /** + * Sets the focus to the specified element if it isn't focused yet. + * + * Prevents unpleasant behaviour for textareas in IE: + * If you have a textarea which is too wide to be displayed entirely and therfore has to be scrolled horizontally, + * then typing one character after another will scroll the page automatically to the right at the moment you reach + * the right border of the visible part. But calling the focus function causes the page to be scrolled to the left + * edge of the textarea. Immediately after that jump to the left side, the content is scrolled back to the cursor + * position, which leads to a flicker page every time you type a character. + */ + function focus(element) { + if (document.activeElement !== element) { + element.focus(); + } + } + var browserType, textrange = { @@ -98,7 +115,7 @@ _textrange = { xul: { get: function(property) { - this[0].focus(); + focus(this[0]); var props = { position: this[0].selectionStart, start: this[0].selectionStart, @@ -111,13 +128,13 @@ }, set: function(start, end) { - this[0].focus(); + focus(this[0]); this[0].selectionStart = start; this[0].selectionEnd = end; }, replace: function(text) { - this[0].focus(); + focus(this[0]); var start = this[0].selectionStart; this.val(this.val().substring(0, this[0].selectionStart) + text + this.val().substring(this[0].selectionEnd, this.val().length)); this[0].selectionStart = start; @@ -127,10 +144,7 @@ msie: { get: function(property) { - if (document.activeElement !== this[0]) { - this[0].focus(); - } - + focus(this[0]); var range = document.selection.createRange(); if (typeof range === 'undefined') { @@ -159,10 +173,7 @@ }, set: function(start, end) { - if (document.activeElement !== this[0]) { - this[0].focus(); - } - + focus(this[0]); var range = this[0].createTextRange(); if (typeof range === 'undefined') { @@ -182,10 +193,7 @@ }, replace: function(text) { - if (document.activeElement !== this[0]) { - this[0].focus(); - } - + focus(this[0]); document.selection.createRange().text = text; } } From 89d11560e0e40387a13d2ce03e9903746ccb9ab7 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Sat, 7 Dec 2013 11:26:39 -0600 Subject: [PATCH 18/57] putting focus check that ran on all methods in entry method --- jquery-textrange.js | 34 +++++++++++----------------------- 1 file changed, 11 insertions(+), 23 deletions(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index ff0bdad..609cf5e 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -6,23 +6,7 @@ * (c) 2013 Daniel Imhoff - danielimhoff.com */ (function($) { - - /** - * Sets the focus to the specified element if it isn't focused yet. - * - * Prevents unpleasant behaviour for textareas in IE: - * If you have a textarea which is too wide to be displayed entirely and therfore has to be scrolled horizontally, - * then typing one character after another will scroll the page automatically to the right at the moment you reach - * the right border of the visible part. But calling the focus function causes the page to be scrolled to the left - * edge of the textarea. Immediately after that jump to the left side, the content is scrolled back to the cursor - * position, which leads to a flicker page every time you type a character. - */ - function focus(element) { - if (document.activeElement !== element) { - element.focus(); - } - } - + var browserType, textrange = { @@ -115,7 +99,6 @@ _textrange = { xul: { get: function(property) { - focus(this[0]); var props = { position: this[0].selectionStart, start: this[0].selectionStart, @@ -128,13 +111,11 @@ }, set: function(start, end) { - focus(this[0]); this[0].selectionStart = start; this[0].selectionEnd = end; }, replace: function(text) { - focus(this[0]); var start = this[0].selectionStart; this.val(this.val().substring(0, this[0].selectionStart) + text + this.val().substring(this[0].selectionEnd, this.val().length)); this[0].selectionStart = start; @@ -144,7 +125,6 @@ msie: { get: function(property) { - focus(this[0]); var range = document.selection.createRange(); if (typeof range === 'undefined') { @@ -173,7 +153,6 @@ }, set: function(start, end) { - focus(this[0]); var range = this[0].createTextRange(); if (typeof range === 'undefined') { @@ -193,7 +172,6 @@ }, replace: function(text) { - focus(this[0]); document.selection.createRange().text = text; } } @@ -209,6 +187,16 @@ return this; } + // Prevents unpleasant behaviour for textareas in IE: + // If you have a textarea which is too wide to be displayed entirely and therfore has to be scrolled horizontally, + // then typing one character after another will scroll the page automatically to the right at the moment you reach + // the right border of the visible part. But calling the focus function causes the page to be scrolled to the left + // edge of the textarea. Immediately after that jump to the left side, the content is scrolled back to the cursor + // position, which leads to a flicker page every time you type a character. + if (document.activeElement !== this[0]) { + this[0].focus(); + } + if (typeof method === 'undefined' || typeof method !== 'string') { return textrange.get.apply(this); } From e74ffbbd8f2410e28b33e4a44254d6e773524c66 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 1 Aug 2014 19:31:00 -0500 Subject: [PATCH 19/57] Fix for #11 --- jquery-textrange.js | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index 609cf5e..2229505 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -143,13 +143,15 @@ rangetext.moveToBookmark(range.getBookmark()); rangetextcopy.setEndPoint('EndToStart', rangetext); - return { + var props = { position: rangetextcopy.text.length, start: rangetextcopy.text.length, end: rangetextcopy.text.length + range.text.length, length: range.text.length, text: range.text }; + + return typeof property === 'undefined' ? props : props[property]; }, set: function(start, end) { From ef7c424d511513d6ea44b2df0625a0beff44d695 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 1 Aug 2014 19:35:00 -0500 Subject: [PATCH 20/57] cutting new release for bugfix #11 --- bower.json | 2 +- textrange.jquery.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/bower.json b/bower.json index 3feb0fc..1e786f8 100644 --- a/bower.json +++ b/bower.json @@ -1,6 +1,6 @@ { "name": "jquery-textrange", - "version": "1.1.0", + "version": "1.1.1", "main": "jquery-textrange.js", "dependencies": { "jquery": ">=1.3" diff --git a/textrange.jquery.json b/textrange.jquery.json index f3aa7d9..d515ef9 100644 --- a/textrange.jquery.json +++ b/textrange.jquery.json @@ -18,7 +18,7 @@ "substring", "substr" ], - "version": "1.1.0", + "version": "1.1.1", "author": { "name": "Daniel Imhoff", "email": "dwieeb@gmail.com", From ba1ca29371f309dde71c296961cfc1eb481f5991 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 1 Aug 2014 20:36:11 -0500 Subject: [PATCH 21/57] achieves #10 --- jquery-textrange.js | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index 2229505..2f12c89 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -5,7 +5,13 @@ * * (c) 2013 Daniel Imhoff - danielimhoff.com */ -(function($) { +(function(factory) { + if (typeof define === 'function' && define.amd) { + define(['jquery'], factory); + } else { + factory(jQuery); + } +})(function($) { var browserType, @@ -209,4 +215,4 @@ $.error("Method " + method + " does not exist in jQuery.textrange"); } }; -})(jQuery); +}); From 6c881fc16a7769acaca27d8756cbb5af7567f02d Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 1 Aug 2014 20:37:39 -0500 Subject: [PATCH 22/57] cutting new release for feature addition #10 --- bower.json | 2 +- jquery-textrange.js | 2 +- textrange.jquery.json | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/bower.json b/bower.json index 1e786f8..a164722 100644 --- a/bower.json +++ b/bower.json @@ -1,6 +1,6 @@ { "name": "jquery-textrange", - "version": "1.1.1", + "version": "1.2.0", "main": "jquery-textrange.js", "dependencies": { "jquery": ">=1.3" diff --git a/jquery-textrange.js b/jquery-textrange.js index 2f12c89..561a8a1 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -3,7 +3,7 @@ * A jQuery plugin for getting, setting and replacing the selected text in input fields and textareas. * See the [wiki](https://github.com/dwieeb/jquery-textrange/wiki) for usage and examples. * - * (c) 2013 Daniel Imhoff - danielimhoff.com + * (c) 2012-2014 Daniel Imhoff - danielimhoff.com */ (function(factory) { if (typeof define === 'function' && define.amd) { diff --git a/textrange.jquery.json b/textrange.jquery.json index d515ef9..9cd9629 100644 --- a/textrange.jquery.json +++ b/textrange.jquery.json @@ -18,7 +18,7 @@ "substring", "substr" ], - "version": "1.1.1", + "version": "1.2.0", "author": { "name": "Daniel Imhoff", "email": "dwieeb@gmail.com", From 819e0cc0e7cb6be56749af4da9b8c1bc361c7200 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 1 Aug 2014 20:46:46 -0500 Subject: [PATCH 23/57] Update README.md --- README.md | 73 ++++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 67 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index e870129..87f595b 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,75 @@ This jQuery plugin is for easily finding the starting and ending positions of selected text in text fields and textareas. It can also be used to set the selection, and replace the selection with given text (or insert text wherever the cursor is in the text field or textarea). -## Methods -* [$().textrange('get')](https://github.com/dwieeb/jquery-textrange/wiki/Get) -* [$().textrange('set')](https://github.com/dwieeb/jquery-textrange/wiki/Set) -* [$().textrange('setcursor')](https://github.com/dwieeb/jquery-textrange/wiki/SetCursor) -* [$().textrange('replace')](https://github.com/dwieeb/jquery-textrange/wiki/Replace) - ## Demo + * http://dwieeb.github.com/jquery-textrange/ +## Methods + +You can use this method to get all the information on the selected text of an element or a specific bit of information. + +### 'get' + +##### Get everything + + $('input[name="example"]').textrange('get'); + +or for short: + + $('input[name="example"]').textrange(); + +This will return a JSON object with the following information: + + { + position: (cursor location in the text field), + start: (starting position of the selected text in the text field), + end: (ending position of the selected text in the text field), + length: (the length of the selected text in the text field), + text: (the text that is selected) + } + +##### Get a particular property + +This function can also be used to get a particular property of the object. + +For example, this will obtain the starting location of the selected text: + + var start = $('input[name="example"]').textrange('get', 'start'); + +### 'set' + +You can use this method to set the starting and ending locations of the selected text in an element. + +It works much like [PHP's substr()](http://php.net/manual/en/function.substr.php) and [Ruby's String#slice](http://ruby-doc.org/core-2.0/String.html#method-i-slice), so if you're familiar with one of those, it should be a breeze! Here are some examples, anyway. + +For the following examples, let's say `input[name="example"]` contains the text `abcdef`. + + $('input[name="example"]').textrange('set'); // selects "abcdef" (select all) + $('input[name="example"]').textrange('set', 2); // selects "cdef" + $('input[name="example"]').textrange('set', 2, 3); // selects "cde" + $('input[name="example"]').textrange('set', 2, -2); // selects "cd" + $('input[name="example"]').textrange('set', -3); // selects "def" + $('input[name="example"]').textrange('set', -2, 1); // selects "e" + $('input[name="example"]').textrange('set', -4, -1); // selects "cde" + +If you're looking to set the cursor at one specific location, you can use `0` for length, or you can use [$().textrange('setcursor')](https://github.com/dwieeb/jquery-textrange/wiki/SetCursor). + +### 'setcursor' + +You can use this method to set the location of the cursor in your text field. + +To set the cursor at the fifth character position: + + $('input[name="example"]').textrange('setcursor', 5); + +### 'replace' + +You can use this method to replace the selection with given text. + + $('input[name="example"]').textrange('replace', 'some text'); + +There is also an `insert` alias for `replace` if you're using this method to insert text at the cursor location. They work the same way. + ## Minified Version A minified version of this plugin can be generated using Google's Closure Compiler (preferred). From d58c9702a16050a6205d5e0a6cb1ccb64d340995 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 1 Aug 2014 20:59:03 -0500 Subject: [PATCH 24/57] Update README.md --- README.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/README.md b/README.md index 87f595b..42f2eb0 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,23 @@ This jQuery plugin is for easily finding the starting and ending positions of se * http://dwieeb.github.com/jquery-textrange/ +## Include + +Works with + + + + +Or, with RequireJS (**note**: jquery-textrange can be loaded through any [AMD](https://github.com/amdjs/amdjs-api/blob/master/AMD.md)-compatible Javascript Module Loader): + + requirejs.config({ + "baseUrl": "lib", + "paths": { + "jquery": "//code.jquery.com/jquery-latest.min.js", + "jquery-textrange": "jquery-plugins/jquery-textrange" + } + }); + ## Methods You can use this method to get all the information on the selected text of an element or a specific bit of information. From 2fdb4d35fa15463b1fa9fd83f3c380043d4fdedf Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 1 Aug 2014 21:00:01 -0500 Subject: [PATCH 25/57] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 42f2eb0..79b7fb2 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ This jQuery plugin is for easily finding the starting and ending positions of se ## Include -Works with +Include the file directly using From 0539aae40f7efe39ecfa12b7a5e5b24fb1a51f60 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 1 Aug 2014 21:00:41 -0500 Subject: [PATCH 26/57] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 79b7fb2..0a6884a 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ This jQuery plugin is for easily finding the starting and ending positions of se ## Include -Include the file directly using From 6c640d494dc7b19718cce7eafee09dfe3bc1bd05 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Sat, 2 Aug 2014 00:13:43 -0500 Subject: [PATCH 27/57] supporting Node/CommonJS and becoming UMD compliant. achieves #12 --- jquery-textrange.js | 2 ++ 1 file changed, 2 insertions(+) diff --git a/jquery-textrange.js b/jquery-textrange.js index 561a8a1..4f254c7 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -8,6 +8,8 @@ (function(factory) { if (typeof define === 'function' && define.amd) { define(['jquery'], factory); + } else if (typeof exports === 'object') { + factory(require('jquery')); } else { factory(jQuery); } From aeb38b6fef64f1b051216548a22286e426557b2a Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Sat, 2 Aug 2014 00:15:59 -0500 Subject: [PATCH 28/57] cutting new release for feature addition #12 --- bower.json | 2 +- textrange.jquery.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/bower.json b/bower.json index a164722..e1df092 100644 --- a/bower.json +++ b/bower.json @@ -1,6 +1,6 @@ { "name": "jquery-textrange", - "version": "1.2.0", + "version": "1.3.0", "main": "jquery-textrange.js", "dependencies": { "jquery": ">=1.3" diff --git a/textrange.jquery.json b/textrange.jquery.json index 9cd9629..ba24b57 100644 --- a/textrange.jquery.json +++ b/textrange.jquery.json @@ -18,7 +18,7 @@ "substring", "substr" ], - "version": "1.2.0", + "version": "1.3.0", "author": { "name": "Daniel Imhoff", "email": "dwieeb@gmail.com", From deabac761375587a197832119b828e1f1b4c849e Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Sat, 9 Aug 2014 18:13:44 -0500 Subject: [PATCH 29/57] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 0a6884a..05cc7f0 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,7 @@ Include the file directly using ` -Or, with RequireJS (**note**: jquery-textrange can be loaded through any [AMD](https://github.com/amdjs/amdjs-api/blob/master/AMD.md)-compatible Javascript Module Loader): +Or, with RequireJS (**note**: jquery-textrange can be loaded through any [UMD](https://github.com/umdjs/umd/blob/master/README.md)-compatible Javascript Module Loader): requirejs.config({ "baseUrl": "lib", @@ -69,7 +69,7 @@ For the following examples, let's say `input[name="example"]` contains the text $('input[name="example"]').textrange('set', -2, 1); // selects "e" $('input[name="example"]').textrange('set', -4, -1); // selects "cde" -If you're looking to set the cursor at one specific location, you can use `0` for length, or you can use [$().textrange('setcursor')](https://github.com/dwieeb/jquery-textrange/wiki/SetCursor). +If you're looking to set the cursor at one specific location, you can use `0` for length, or you can use `$().textrange('setcursor')` (see below). ### 'setcursor' From b9cfebb97d7d3ba171488e63a3565409e4b6873a Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Tue, 12 Aug 2014 16:17:12 -0500 Subject: [PATCH 30/57] Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 05cc7f0..265294b 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ This jQuery plugin is for easily finding the starting and ending positions of selected text in text fields and textareas. It can also be used to set the selection, and replace the selection with given text (or insert text wherever the cursor is in the text field or textarea). +* jquery-textrange may not work with WYSIWYG editors. See [issue #3](https://github.com/dwieeb/jquery-textrange/issues/3) and [this question](http://wordpress.stackexchange.com/questions/105961/insert-text-a-cursor-position-in-to-tinymce-text-editor). + ## Demo * http://dwieeb.github.com/jquery-textrange/ From e77c14dc75f5738013c550ccbe9979bfa0d4185d Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Tue, 12 Aug 2014 16:22:03 -0500 Subject: [PATCH 31/57] Update README.md --- README.md | 84 ++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 52 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index 265294b..0475102 100644 --- a/README.md +++ b/README.md @@ -10,18 +10,22 @@ This jQuery plugin is for easily finding the starting and ending positions of se Include the file directly using ` - +```html + + +``` Or, with RequireJS (**note**: jquery-textrange can be loaded through any [UMD](https://github.com/umdjs/umd/blob/master/README.md)-compatible Javascript Module Loader): - requirejs.config({ - "baseUrl": "lib", - "paths": { - "jquery": "//code.jquery.com/jquery-latest.min.js", - "jquery-textrange": "jquery-plugins/jquery-textrange" - } - }); +```javascript +requirejs.config({ + "baseUrl": "lib", + "paths": { + "jquery": "//code.jquery.com/jquery-latest.min.js", + "jquery-textrange": "jquery-plugins/jquery-textrange" + } +}); +``` ## Methods @@ -31,21 +35,27 @@ You can use this method to get all the information on the selected text of an el ##### Get everything - $('input[name="example"]').textrange('get'); +```javascript +$('input[name="example"]').textrange('get'); +``` or for short: - $('input[name="example"]').textrange(); +```javascript +$('input[name="example"]').textrange(); +``` This will return a JSON object with the following information: - { - position: (cursor location in the text field), - start: (starting position of the selected text in the text field), - end: (ending position of the selected text in the text field), - length: (the length of the selected text in the text field), - text: (the text that is selected) - } +```javascript +{ + "position": // cursor location in the text field) + "start": //starting position of the selected text in the text field + "end": // ending position of the selected text in the text field + "length": // the length of the selected text in the text field + "text": // the text that is selected +} +``` ##### Get a particular property @@ -53,7 +63,9 @@ This function can also be used to get a particular property of the object. For example, this will obtain the starting location of the selected text: - var start = $('input[name="example"]').textrange('get', 'start'); +```javascript +var start = $('input[name="example"]').textrange('get', 'start'); +``` ### 'set' @@ -63,13 +75,15 @@ It works much like [PHP's substr()](http://php.net/manual/en/function.substr.php For the following examples, let's say `input[name="example"]` contains the text `abcdef`. - $('input[name="example"]').textrange('set'); // selects "abcdef" (select all) - $('input[name="example"]').textrange('set', 2); // selects "cdef" - $('input[name="example"]').textrange('set', 2, 3); // selects "cde" - $('input[name="example"]').textrange('set', 2, -2); // selects "cd" - $('input[name="example"]').textrange('set', -3); // selects "def" - $('input[name="example"]').textrange('set', -2, 1); // selects "e" - $('input[name="example"]').textrange('set', -4, -1); // selects "cde" +```javascript +$('input[name="example"]').textrange('set'); // selects "abcdef" (select all) +$('input[name="example"]').textrange('set', 2); // selects "cdef" +$('input[name="example"]').textrange('set', 2, 3); // selects "cde" +$('input[name="example"]').textrange('set', 2, -2); // selects "cd" +$('input[name="example"]').textrange('set', -3); // selects "def" +$('input[name="example"]').textrange('set', -2, 1); // selects "e" +$('input[name="example"]').textrange('set', -4, -1); // selects "cde" +``` If you're looking to set the cursor at one specific location, you can use `0` for length, or you can use `$().textrange('setcursor')` (see below). @@ -79,20 +93,26 @@ You can use this method to set the location of the cursor in your text field. To set the cursor at the fifth character position: - $('input[name="example"]').textrange('setcursor', 5); +```javascript +$('input[name="example"]').textrange('setcursor', 5); +``` ### 'replace' You can use this method to replace the selection with given text. - $('input[name="example"]').textrange('replace', 'some text'); +```javascript +$('input[name="example"]').textrange('replace', 'some text'); +``` There is also an `insert` alias for `replace` if you're using this method to insert text at the cursor location. They work the same way. ## Minified Version A minified version of this plugin can be generated using Google's Closure Compiler (preferred). - wget http://closure-compiler.googlecode.com/files/compiler-latest.tar.gz - tar -zvxf compiler-latest.tar.gz compiler.jar - wget https://raw.github.com/dwieeb/jquery-textrange/master/jquery-textrange.js - java -jar compiler.jar --js jquery-textrange.js --js_output_file jquery-textrange.min.js +```bash +wget http://closure-compiler.googlecode.com/files/compiler-latest.tar.gz +tar -zvxf compiler-latest.tar.gz compiler.jar +wget https://raw.github.com/dwieeb/jquery-textrange/master/jquery-textrange.js +java -jar compiler.jar --js jquery-textrange.js --js_output_file jquery-textrange.min.js +``` From ffc8eb12e9cd4f531384ffb173ef7dadc040bec3 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Tue, 12 Aug 2014 16:35:38 -0500 Subject: [PATCH 32/57] Style changes and updating comment block --- jquery-textrange.js | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index 4f254c7..42676c3 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -1,18 +1,23 @@ /** * jquery-textrange * A jQuery plugin for getting, setting and replacing the selected text in input fields and textareas. - * See the [wiki](https://github.com/dwieeb/jquery-textrange/wiki) for usage and examples. + * See the [README](https://github.com/dwieeb/jquery-textrange/blob/1.x/README.md) for usage and examples. * * (c) 2012-2014 Daniel Imhoff - danielimhoff.com */ + (function(factory) { + if (typeof define === 'function' && define.amd) { define(['jquery'], factory); - } else if (typeof exports === 'object') { + } + else if (typeof exports === 'object') { factory(require('jquery')); - } else { + } + else { factory(jQuery); } + })(function($) { var browserType, @@ -197,12 +202,7 @@ return this; } - // Prevents unpleasant behaviour for textareas in IE: - // If you have a textarea which is too wide to be displayed entirely and therfore has to be scrolled horizontally, - // then typing one character after another will scroll the page automatically to the right at the moment you reach - // the right border of the visible part. But calling the focus function causes the page to be scrolled to the left - // edge of the textarea. Immediately after that jump to the left side, the content is scrolled back to the cursor - // position, which leads to a flicker page every time you type a character. + // Focus on the element before operating upon it. if (document.activeElement !== this[0]) { this[0].focus(); } From 70ba6b71d4f878cf1aa7f7fce7bcad7d5fa40691 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Tue, 12 Aug 2014 16:36:00 -0500 Subject: [PATCH 33/57] Fixing undefined error if no selection is made. --- jquery-textrange.js | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/jquery-textrange.js b/jquery-textrange.js index 42676c3..a746e45 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -193,6 +193,10 @@ }; $.fn.textrange = function(method) { + if (typeof this[0] === 'undefined') { + return this; + } + if (typeof browserType === 'undefined') { browserType = 'selectionStart' in this[0] ? 'xul' : document.selection ? 'msie' : 'unknown'; } From f20fe4b816573a00a5abfcf1756454c580cf4d68 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Tue, 12 Aug 2014 16:42:04 -0500 Subject: [PATCH 34/57] optimizing replace method for xul browsers --- jquery-textrange.js | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index a746e45..0355766 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -129,8 +129,11 @@ }, replace: function(text) { + text = String(text); var start = this[0].selectionStart; - this.val(this.val().substring(0, this[0].selectionStart) + text + this.val().substring(this[0].selectionEnd, this.val().length)); + var end = this[0].selectionEnd; + var val = this.val(); + this.val(val.substring(0, start) + text + val.substring(end, val.length)); this[0].selectionStart = start; this[0].selectionEnd = start + text.length; } From 3ed8577b37e778d3c3e0440dd435b1df11b0cf14 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Tue, 12 Aug 2014 16:43:54 -0500 Subject: [PATCH 35/57] casting in entry method instead of xul browser method --- jquery-textrange.js | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index 0355766..8130a2e 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -96,7 +96,7 @@ * @param text The text to replace the selection with. */ replace: function(text) { - _textrange[browserType].replace.apply(this, [text]); + _textrange[browserType].replace.apply(this, [String(text)]); return this; }, @@ -129,7 +129,6 @@ }, replace: function(text) { - text = String(text); var start = this[0].selectionStart; var end = this[0].selectionEnd; var val = this.val(); From 841083880909f2e8818f3bc4da7c11a40b0be6e5 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Tue, 12 Aug 2014 16:46:19 -0500 Subject: [PATCH 36/57] cutting new release for a few bug fixes --- bower.json | 2 +- textrange.jquery.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/bower.json b/bower.json index e1df092..565c5a3 100644 --- a/bower.json +++ b/bower.json @@ -1,6 +1,6 @@ { "name": "jquery-textrange", - "version": "1.3.0", + "version": "1.3.1", "main": "jquery-textrange.js", "dependencies": { "jquery": ">=1.3" diff --git a/textrange.jquery.json b/textrange.jquery.json index ba24b57..b1c18eb 100644 --- a/textrange.jquery.json +++ b/textrange.jquery.json @@ -18,7 +18,7 @@ "substring", "substr" ], - "version": "1.3.0", + "version": "1.3.1", "author": { "name": "Daniel Imhoff", "email": "dwieeb@gmail.com", From b694b21f8d07beba134d1d370cfa59dbec124359 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Wed, 13 Aug 2014 23:12:33 -0500 Subject: [PATCH 37/57] fixing focus-on-hover issue with demo --- demo.html | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/demo.html b/demo.html index a9c7774..a9ac206 100644 --- a/demo.html +++ b/demo.html @@ -31,7 +31,11 @@ $('h1').css('border-color', orange ? 'transparent' : '#fa4500'); }, 500); - $('#textarea').bind('updateInfo keyup mousedown mousemove mouseup', function() { + $('#textarea').bind('updateInfo keyup mousedown mousemove mouseup', function(event) { + if (document.activeElement !== $(this)[0]) { + return; + } + var range = $(this).textrange(); $('#info .property').each(function() { From 5656761976e555ece575da9dc4b6d0dd1578fad0 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Sun, 21 Sep 2014 23:29:25 -0500 Subject: [PATCH 38/57] Adding package.json for npm installation --- package.json | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 package.json diff --git a/package.json b/package.json new file mode 100644 index 0000000..8f42224 --- /dev/null +++ b/package.json @@ -0,0 +1,39 @@ +{ + "name": "jquery-textrange", + "version": "1.3.1", + "description": "A jQuery plugin for getting, setting and replacing the selected text in input fields and textareas.", + "main": "jquery-textrange.js", + "dependencies": { + "jquery": "*" + }, + "devDependencies": {}, + "scripts": { + "test": "echo \"Error: no test specified\" && exit 1" + }, + "repository": { + "type": "git", + "url": "https://github.com/dwieeb/jquery-textrange.git" + }, + "keywords": [ + "jquery", + "caret", + "cursor", + "field", + "highlight", + "input", + "range", + "replace", + "select", + "selection", + "substr", + "substring", + "text", + "textarea", + "textrange" + ], + "author": "Daniel Imhoff", + "license": "MIT", + "bugs": { + "url": "https://github.com/dwieeb/jquery-textrange/issues" + } +} From b14db5f8144bc9fd91c148a22839a1674073211c Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Mon, 22 Sep 2014 00:17:39 -0500 Subject: [PATCH 39/57] Fixing possible problem with fallback --- jquery-textrange.js | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index 8130a2e..85b3fc4 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -143,13 +143,15 @@ var range = document.selection.createRange(); if (typeof range === 'undefined') { - return { + var props = { position: 0, start: 0, - end: this[0].val().length, - length: this[0].val().length, + end: this.val().length, + length: this.val().length, text: this.val() }; + + return typeof property === 'undefined' ? props : props[property]; } var rangetext = this[0].createTextRange(); From 08146a538103635fb4e3e1cb196a92b5f7be75ec Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Tue, 11 Nov 2014 00:08:52 -0600 Subject: [PATCH 40/57] fixing text selection for msie 5 through 8. achieves #15 --- jquery-textrange.js | 35 ++++++++++++++++++++++++++--------- 1 file changed, 26 insertions(+), 9 deletions(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index 85b3fc4..bca94bb 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -154,17 +154,34 @@ return typeof property === 'undefined' ? props : props[property]; } - var rangetext = this[0].createTextRange(); - var rangetextcopy = rangetext.duplicate(); - - rangetext.moveToBookmark(range.getBookmark()); - rangetextcopy.setEndPoint('EndToStart', rangetext); + var start = 0; + var end = 0; + var length = this[0].value.length; + var lfValue = this[0].value.replace(/\r\n/g, '\n'); + var rangeText = this[0].createTextRange(); + var rangeTextEnd = this[0].createTextRange(); + rangeText.moveToBookmark(range.getBookmark()); + rangeTextEnd.collapse(false); + + if (rangeText.compareEndPoints('StartToEnd', rangeTextEnd) === -1) { + start = -rangeText.moveStart('character', -length); + start += lfValue.slice(0, start).split('\n').length - 1; + + if (rangeText.compareEndPoints('EndToEnd', rangeTextEnd) === -1) { + end = -rangeText.moveEnd('character', -length); + end += lfValue.slice(0, end).split('\n').length - 1; + } else { + end = length; + } + } else { + end = length; + } var props = { - position: rangetextcopy.text.length, - start: rangetextcopy.text.length, - end: rangetextcopy.text.length + range.text.length, - length: range.text.length, + position: start, + start: start, + end: end, + length: length, text: range.text }; From f4e37fb744ab9e44fe497646594d8612f14078e8 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Tue, 11 Nov 2014 00:09:16 -0600 Subject: [PATCH 41/57] adding browser support section to readme --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index 0475102..2ee905c 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,14 @@ This jQuery plugin is for easily finding the starting and ending positions of se * http://dwieeb.github.com/jquery-textrange/ +## Browser Support + +Tested in the following major browsers: + +* Internet Explorer 5.5+ +* Firefox 2+ +* Chrome + ## Include Include the file directly using ` + ``` -Or, with RequireJS (**note**: jquery-textrange can be loaded through any [UMD](https://github.com/umdjs/umd/blob/master/README.md)-compatible Javascript Module Loader): - -```javascript -requirejs.config({ - "baseUrl": "lib", - "paths": { - "jquery": "//code.jquery.com/jquery-latest.min.js", - "jquery-textrange": "jquery-plugins/jquery-textrange" - } -}); -``` +:memo: *note*: jquery-textrange can be loaded through any +[UMD](https://github.com/umdjs/umd/blob/master/README.md)-compatible Javascript +Module Loader. ## Methods -You can use this method to get all the information on the selected text of an element or a specific bit of information. +You can use this method to get all the information on the selected text of an +element or a specific bit of information. ### 'get' @@ -77,11 +74,15 @@ var start = $('input[name="example"]').textrange('get', 'start'); ### 'set' -You can use this method to set the starting and ending locations of the selected text in an element. +You can use this method to set the starting and ending locations of the +selected text in an element. -It works much like [PHP's substr()](http://php.net/manual/en/function.substr.php) and [Ruby's String#slice](http://ruby-doc.org/core-2.0/String.html#method-i-slice), so if you're familiar with one of those, it should be a breeze! Here are some examples, anyway. +It works much like [PHP's +substr()](https://secure.php.net/manual/en/function.substr.php), so if you're +familiar with that, it should be a breeze! Here are some examples, anyway. -For the following examples, let's say `input[name="example"]` contains the text `abcdef`. +For the following examples, let's say `input[name="example"]` contains the text +`abcdef`. ```javascript $('input[name="example"]').textrange('set'); // selects "abcdef" (select all) @@ -93,7 +94,8 @@ $('input[name="example"]').textrange('set', -2, 1); // selects "e" $('input[name="example"]').textrange('set', -4, -1); // selects "cde" ``` -If you're looking to set the cursor at one specific location, you can use `0` for length, or you can use `$().textrange('setcursor')` (see below). +If you're looking to set the cursor at one specific location, you can use `0` +for length, or you can use `$().textrange('setcursor')` (see below). ### 'setcursor' @@ -107,18 +109,11 @@ $('input[name="example"]').textrange('setcursor', 5); ### 'replace' -You can use this method to replace the selection with given text. +You can use this method to replace the selection with given text. ```javascript $('input[name="example"]').textrange('replace', 'some text'); ``` -There is also an `insert` alias for `replace` if you're using this method to insert text at the cursor location. They work the same way. - -## Minified Version -A minified version of this plugin can be generated using UglifyJS during your build process or via CLI tools: - -```bash -npm i -g uglify-js -uglifyjs jquery-textrange.js > jquery-textrange.min.js -``` +There is also an `insert` alias for `replace` if you're using this method to +insert text at the cursor location. They work the same way. diff --git a/demo.html b/demo.html index a9ac206..af378c5 100644 --- a/demo.html +++ b/demo.html @@ -3,7 +3,7 @@ - + body, h1 { margin:0; } @@ -74,7 +74,7 @@

jquery-textrange

-created by Daniel Imhoff +created by Daniel Imhoff See the wiki for all features and documentation.

Some more content. diff --git a/jquery-textrange.js b/jquery-textrange.js index 97bfe34..0c6c758 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -4,7 +4,7 @@ * A jQuery plugin for getting, setting and replacing the selected text in input fields and textareas. * See the [README](https://github.com/dwieeb/jquery-textrange/blob/1.x/README.md) for usage and examples. * - * (c) 2012-2017 Daniel Imhoff <dwieeb@gmail.com> - danielimhoff.com + * (c) 2012-2017 Daniel Imhoff <dwieeb@gmail.com> - dwieeb.com */ (function(factory) { @@ -48,7 +48,7 @@ * @param (optional) start * @param (optional) length * - * @see http://php.net/manual/en/function.substr.php + * @see https://secure.php.net/manual/en/function.substr.php */ set: function(start, length) { var s = parseInt(start), diff --git a/textrange.jquery.json b/textrange.jquery.json index 6913a8d..3d5eeeb 100644 --- a/textrange.jquery.json +++ b/textrange.jquery.json @@ -22,7 +22,7 @@ "author": { "name": "Daniel Imhoff", "email": "dwieeb@gmail.com", - "url": "http://www.danielimhoff.com" + "url": "https://www.dwieeb.com" }, "licenses": [ { @@ -31,9 +31,9 @@ } ], "bugs": "", - "homepage": "http://dwieeb.github.com/jquery-textrange", + "homepage": "https://dwieeb.github.com/jquery-textrange", "docs": "https://github.com/dwieeb/jquery-textrange/wiki", - "demo": "http://dwieeb.github.com/jquery-textrange", + "demo": "https://dwieeb.github.com/jquery-textrange", "dependencies": { "jquery": ">=1.3" } From 1ff7c41cc2af6e6b02741af3d8dbe248072d169b Mon Sep 17 00:00:00 2001 From: Daniel Imhoff <dwieeb@gmail.com> Date: Fri, 28 Apr 2017 20:49:56 -0500 Subject: [PATCH 50/57] ditch jquery plugin registry use `jquery-plugin` npm tag as per https://plugins.jquery.com/ --- package.json | 1 + textrange.jquery.json | 40 ---------------------------------------- 2 files changed, 1 insertion(+), 40 deletions(-) delete mode 100644 textrange.jquery.json diff --git a/package.json b/package.json index a9e8006..dc073e1 100644 --- a/package.json +++ b/package.json @@ -16,6 +16,7 @@ }, "keywords": [ "jquery", + "jquery-plugin", "caret", "cursor", "field", diff --git a/textrange.jquery.json b/textrange.jquery.json deleted file mode 100644 index 3d5eeeb..0000000 --- a/textrange.jquery.json +++ /dev/null @@ -1,40 +0,0 @@ -{ - "name": "textrange", - "title": "jQuery TextRange", - "description": "jQuery plugin for getting, setting, and replacing the selected text in input fields and textareas.", - "keywords": [ - "text", - "range", - "caret", - "cursor", - "textrange", - "select", - "highlight", - "selection", - "field", - "input", - "textarea", - "replace", - "substring", - "substr" - ], - "version": "1.3.3", - "author": { - "name": "Daniel Imhoff", - "email": "dwieeb@gmail.com", - "url": "https://www.dwieeb.com" - }, - "licenses": [ - { - "type": "MIT", - "url": "https://raw.github.com/dwieeb/jquery-textrange/master/LICENSE" - } - ], - "bugs": "", - "homepage": "https://dwieeb.github.com/jquery-textrange", - "docs": "https://github.com/dwieeb/jquery-textrange/wiki", - "demo": "https://dwieeb.github.com/jquery-textrange", - "dependencies": { - "jquery": ">=1.3" - } -} From a38d524536ce0e225a45113bc581cb92d6ad0f81 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff <dwieeb@gmail.com> Date: Fri, 28 Apr 2017 21:19:45 -0500 Subject: [PATCH 51/57] wiki -> readme --- demo.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/demo.html b/demo.html index af378c5..21e62b9 100644 --- a/demo.html +++ b/demo.html @@ -75,7 +75,7 @@ <body> <h1><a href="https://github.com/dwieeb/jquery-textrange/">jquery-textrange</a></h1> <span class="copyright"><a href="https://www.dwieeb.com">created by Daniel Imhoff</a></span> -<span class="description"><a href="https://github.com/dwieeb/jquery-textrange/wiki/">See the wiki for all features and documentation.</a></span> +<span class="description"><a href="https://github.com/dwieeb/jquery-textrange/blob/1.x/README.md">See README.md for all features and documentation.</a></span> <div id="fields"> <textarea id="textarea" name="textarea">Some more content. Isn't this cool? @@ -93,7 +93,7 @@ <h1><a href="https://github.com/dwieeb/jquery-textrange/">jquery-textrange</a></ <span id="text" class="property line">text: "<span class="value"></span>"</span> <span class="line">}</span> </code> -<input type="button" id="console-log" name="console-log" value="console.log() this bad boy"> +<input type="button" id="console-log" name="console-log" value="console.log() this object"> </div> <div> Select a substring starting at <input type="text" id="char-start" name="char-start" value="30"> with a length of <input type="text" id="char-end" name="char-end" value="15"> <input type="button" id="selection-set" name="selection-set" value="Go!!"> From 6804caff6b88e2c684af3e750c56349e18d01902 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff <dwieeb@gmail.com> Date: Fri, 28 Apr 2017 21:20:54 -0500 Subject: [PATCH 52/57] first arg can be string or object alternative implementation of https://github.com/dwieeb/jquery-textrange/pull/20 --- jquery-textrange.js | 54 +++++++++++++++++++++++++++------------------ 1 file changed, 32 insertions(+), 22 deletions(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index 0c6c758..1ccd5e7 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -217,31 +217,41 @@ } }; - $.fn.textrange = function(method) { - if (typeof this[0] === 'undefined') { - return this; - } + $.fn.extend({ + textrange: function(arg) { + var method = 'get'; + var options = {}; - if (typeof browserType === 'undefined') { - browserType = 'selectionStart' in this[0] ? 'xul' : document.selection ? 'msie' : 'unknown'; - } + if (typeof this[0] === 'undefined') { + return this; + } - // I don't know how to support this browser. :c - if (browserType === 'unknown') { - return this; - } + if (typeof arg === 'string') { + method = arg; + } else if (typeof arg === 'object') { + method = arg.method || method; + options = arg; + } - // Focus on the element before operating upon it. - if (document.activeElement !== this[0]) { - this[0].focus(); - } + if (typeof browserType === 'undefined') { + browserType = 'selectionStart' in this[0] ? 'xul' : document.selection ? 'msie' : 'unknown'; + } + + // I don't know how to support this browser. :c + if (browserType === 'unknown') { + return this; + } - if (typeof method === 'undefined' || typeof method !== 'string') { - return textrange.get.apply(this); - } else if (typeof textrange[method] === 'function') { - return textrange[method].apply(this, Array.prototype.slice.call(arguments, 1)); - } else { - $.error("Method " + method + " does not exist in jQuery.textrange"); + // Focus on the element before operating upon it. + if (!options.nofocus && document.activeElement !== this[0]) { + this[0].focus(); + } + + if (typeof textrange[method] === 'function') { + return textrange[method].apply(this, Array.prototype.slice.call(arguments, 1)); + } else { + $.error("Method " + method + " does not exist in jQuery.textrange"); + } } - }; + }); }); From 96826ee56bfe57861be9a97d9c687d85390910f7 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff <dwieeb@gmail.com> Date: Fri, 28 Apr 2017 21:29:24 -0500 Subject: [PATCH 53/57] 1.4.0 --- bower.json | 2 +- package.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/bower.json b/bower.json index 8f0cb9a..9ad6aeb 100644 --- a/bower.json +++ b/bower.json @@ -1,6 +1,6 @@ { "name": "jquery-textrange", - "version": "1.3.3", + "version": "1.4.0", "main": "jquery-textrange.js", "dependencies": { "jquery": ">=1.3" diff --git a/package.json b/package.json index dc073e1..028f3c0 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "jquery-textrange", - "version": "1.3.3", + "version": "1.4.0", "description": "A jQuery plugin for getting, setting and replacing the selected text in input fields and textareas.", "main": "jquery-textrange.js", "dependencies": { From 61ac7420dcfb76da1c9b222dadc63365a378b6b8 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff <dwieeb@gmail.com> Date: Fri, 28 Apr 2017 21:30:34 -0500 Subject: [PATCH 54/57] no longer need to ignore nonexistant file --- bower.json | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/bower.json b/bower.json index 9ad6aeb..66de129 100644 --- a/bower.json +++ b/bower.json @@ -4,8 +4,5 @@ "main": "jquery-textrange.js", "dependencies": { "jquery": ">=1.3" - }, - "ignore": [ - "textrange.jquery.json" - ] + } } From 8d4eb637fb1b26766e94aa0ce4283cf00d1f253e Mon Sep 17 00:00:00 2001 From: Daniel Imhoff <dwieeb@gmail.com> Date: Fri, 28 Apr 2017 21:37:29 -0500 Subject: [PATCH 55/57] document options --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 8a1934e..27f79f6 100644 --- a/README.md +++ b/README.md @@ -117,3 +117,17 @@ $('input[name="example"]').textrange('replace', 'some text'); There is also an `insert` alias for `replace` if you're using this method to insert text at the cursor location. They work the same way. + +### Options + +For the first parameter of each method, you can pass an object instead of a +string with additional options: + +```javascript +$('input[name="example"]').textrange({ method: 'get' }); +$('input[name="example"]').textrange({ method: 'set', nofocus: true }, 2); +$('input[name="example"]').textrange({ method: 'get', nofocus: true }, 'start'); +``` + +* `nofocus`: Do not call `.focus()` on the dom element. See [PR + #20](https://github.com/dwieeb/jquery-textrange/pull/20). From be56e3f19205584a4d1b0176d01a85eb8d4f3060 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff <dwieeb@gmail.com> Date: Fri, 28 Apr 2017 21:39:00 -0500 Subject: [PATCH 56/57] also add method --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 27f79f6..31c40c3 100644 --- a/README.md +++ b/README.md @@ -118,7 +118,7 @@ $('input[name="example"]').textrange('replace', 'some text'); There is also an `insert` alias for `replace` if you're using this method to insert text at the cursor location. They work the same way. -### Options +## Options For the first parameter of each method, you can pass an object instead of a string with additional options: @@ -129,5 +129,6 @@ $('input[name="example"]').textrange({ method: 'set', nofocus: true }, 2); $('input[name="example"]').textrange({ method: 'get', nofocus: true }, 'start'); ``` +* `method` (defaults to `'get'`): One of the methods above. * `nofocus`: Do not call `.focus()` on the dom element. See [PR - #20](https://github.com/dwieeb/jquery-textrange/pull/20). + 20](https://github.com/dwieeb/jquery-textrange/pull/20). From 344dd6327a88a16384829078ad262b28ab09f8af Mon Sep 17 00:00:00 2001 From: Daniel Imhoff <dwieeb@gmail.com> Date: Fri, 28 Apr 2017 21:39:36 -0500 Subject: [PATCH 57/57] literally a pound sign --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 31c40c3..2227a8d 100644 --- a/README.md +++ b/README.md @@ -131,4 +131,4 @@ $('input[name="example"]').textrange({ method: 'get', nofocus: true }, 'start'); * `method` (defaults to `'get'`): One of the methods above. * `nofocus`: Do not call `.focus()` on the dom element. See [PR - 20](https://github.com/dwieeb/jquery-textrange/pull/20). + #20](https://github.com/dwieeb/jquery-textrange/pull/20).