jquery-textrange

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

Replace the selected text with: From b22ba355d32379c2c248368eef40885c03413ea9 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Fri, 7 Jun 2013 19:15:44 -0500 Subject: [PATCH 4/9] updating plugin file --- jquery-textrange.js | 374 ++++++++++++++++++++++++-------------------- 1 file changed, 202 insertions(+), 172 deletions(-) diff --git a/jquery-textrange.js b/jquery-textrange.js index 715c1f7..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; - } - else if(start === 'all') { - start = 0; - end = 'end'; - } - - if(typeof end === 'undefined') { - end = start; - } - else if(end === 'end') { - 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) { - 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].selectionStart = start; - this[0].selectionEnd = end; - }, - - replace: function(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)); - 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); From c506d452006f96683f832b2890c156b88dc79590 Mon Sep 17 00:00:00 2001 From: Daniel Imhoff Date: Wed, 13 Aug 2014 23:18:52 -0500 Subject: [PATCH 5/9] updating gh-pages with current files --- index.html | 14 +++++-------- jquery-textrange.js | 50 ++++++++++++++++++++++++++++++--------------- 2 files changed, 39 insertions(+), 25 deletions(-) diff --git a/index.html b/index.html index f7a7ceb..a9ac206 100644 --- a/index.html +++ b/index.html @@ -21,9 +21,6 @@ #info .property { margin-left:30px; } #textarea { display:block; width:300px; height:90px; } #char-start, #char-end { width:40px; } -#links { width:580px; text-align:center; } -#links a { display:inline-block; background:#000; border-radius: 40px; margin:0 10px; padding:10px 20px; } -#links a:hover, #links a:active, #links a:focus { background:#fa4500; } + body, h1 { margin:0; } @@ -74,8 +74,8 @@

jquery-textrange

-created by Daniel Imhoff -See the readme for all features and documentation. +created by Daniel Imhoff +See README.md for all features and documentation.

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(obj)"> +<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!!"> diff --git a/jquery-textrange.js b/jquery-textrange.js index c66c6c9..1ccd5e7 100644 --- a/jquery-textrange.js +++ b/jquery-textrange.js @@ -1,9 +1,10 @@ /** * jquery-textrange + * * 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-2014 Daniel Imhoff <dwieeb@gmail.com> - danielimhoff.com + * (c) 2012-2017 Daniel Imhoff <dwieeb@gmail.com> - dwieeb.com */ (function(factory) { @@ -47,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), @@ -216,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"); + } } - }; + }); });