add removeTagByName

README.markdown

@@ -201,6 +201,11 @@ Adds new tag to the list. The `additionalClass` parameter is an optional way to
 
     $("#mytags").tagit("createTag", "brand-new-tag");
 
+### removeTagByName(tagName, animate)
+Finds the tag with the value `tagName` and removes it. If no such tag is found, it'll throw an exception.
+
+    $("#mytags").tagit("removeTagByName", "my-tag");
+
 ### removeAll()
 Clears the widget of all tags -- removes each tag it contains, so the onTagRemoved event callback (if set in the options) will be called for each.
 

examples.html

@@ -203,6 +203,7 @@ <h3>Methods</h3>
 			<p>Demos the available widget methods. Click the links below the widget to try them.</p>
 			<ul id="methodTags"></ul>
             <p><a href="#" onclick="var inp=prompt('Enter a tag value to test the createTag method.');$('#methodTags').tagit('createTag', inp);return false;">Create tag</a></p>
+            <p><a href="#" onclick="var inp=prompt('Enter a tag value to test the removeTagByName method.');$('#methodTags').tagit('removeTagByName', inp);return false;">Remove tag by name</a></p>
             <p><a href="#" onclick="$('#methodTags').tagit('removeAll');return false;">Clear tags</a></p>
 			<input type="submit" value="Submit">
 	    </form>

js/tag-it.js

@@ -391,6 +391,14 @@
             }
         },
 
+        removeTagByName: function(tagName, animate) {
+            var toRemove = this._tags().find("input[value='" + tagName + "']").closest('.tagit-choice');
+            if (toRemove.length === 0) {
+                throw "No such tag exists with the name '" + tagName + "'";
+            }
+            this.removeTag(toRemove, animate);
+        },
+
         removeAll: function() {
             // Removes all tags.
             var that = this;