jquery-get-outer-html: small yet useful

Author: Tom Boutell

README.md

@@ -1,31 +1,24 @@
-# jquery-radio
+# jquery-get-outer-html
 
-<a href="http://apostrophenow.org/"><img src="https://raw.github.com/punkave/jquery-radio/master/logos/logo-box-madefor.png" align="right" /></a>
+<a href="http://apostrophenow.org/"><img src="https://raw.github.com/punkave/jquery-getOuterHTML/master/logos/logo-box-madefor.png" align="right" /></a>
 
-`jquery-radio` makes it easy to get or set the current value of a group of radio buttons, filling a gap in jQuery's `$.val()`.
+`jquery-get-outer-html` provides a simple way to get the "outer HTML" for an element, including the element itself, even in browsers that do not support that natively. Unlike other plugins it does not include a setter for outerHTML, so it is best suited to those who do not need the extra code for a setter in their project.
 
 ## How to Use
 
-Select *all* of the buttons in the group and call `.radio()`:
-
-    // Check the box with value="5"
-    $('input.my-radio-group').radio(5);
-    // Get the value of the checked box
-    var value = $('input.my-radio-group').radio();
-
-This example assumes you have several radio buttons that all have the `.my-radio-group` class.
+    $('.my-element').getOuterHTML();
 
 ### Requirements
 
-You need jQuery, of course. `jquery-radio` is actively supported with jQuery 1.9 and 2.0 but should work fine with older versions.
+You need jQuery, of course. `jquery-getOuterHTML` is actively supported with jQuery 1.9 and 2.0 but should work fine with older versions.
 
 ## About P'unk Avenue and Apostrophe
 
-`jquery-radio` was created at [P'unk Avenue](http://punkave.com) for use in Apostrophe, an open-source content management system built on node.js. If you like `jquery-radio` you should definitely [check out apostrophenow.org](http://apostrophenow.org). Also be sure to visit us on [github](http://github.com/punkave).
+`jquery-get-outer-html` was created at [P'unk Avenue](http://punkave.com) for use in Apostrophe, an open-source content management system built on node.js. If you like `jquery-get-outer-html` you should definitely [check out apostrophenow.org](http://apostrophenow.org). Also be sure to visit us on [github](http://github.com/punkave).
 
 ## Support
 
-Feel free to open issues on [github](http://github.com/punkave/jquery-radio).
+Feel free to open issues on [github](http://github.com/punkave/jquery-get-outer-html).
 
-<a href="http://punkave.com/"><img src="https://raw.github.com/punkave/jquery-radio/master/logos/logo-box-builtby.png" /></a>
+<a href="http://punkave.com/"><img src="https://raw.github.com/punkave/jquery-get-outer-html/master/logos/logo-box-builtby.png" /></a>
 

get-outer-html.jquery.json

@@ -0,0 +1,36 @@
+{
+  "name": "get-outer-html",
+  "title": "Get Outer HTML",
+  "description": "Get Outer HTML lets you get the \"outer HTML\" of an element, including the element itself, even in browsers that do not natively support that. This is a very small plugin which does not include a setter for those who don't need a setter.",
+  "keywords": ["get-outer-html", "dom", "polyfill" ],
+  "version": "0.1.0",
+  "author": {
+    "name": "P'unk Avenue",
+    "url": "http://punkave.com/"
+  },
+  "maintainers": [
+    {
+      "name": "Tom Boutell",
+      "email": "tom@punkave.com",
+      "url": "http://punkave.com"
+    },
+    {
+      "name": "Kyle Stetz",
+      "email": "kyle@punkave.com",
+      "url": "http://punkave.com"
+    }
+  ],
+  "licenses": [
+    {
+      "type": "MIT",
+      "url": "https://github.com/punkave/jquery-get-outer-html/LICENSE.md"
+    }
+  ],
+  "bugs": "https://github.com/punkave/jquery-get-outer-html/issues",
+  "homepage": "https://github.com/punkave/jquery-get-outer-html",
+  "docs": "https://github.com/punkave/jquery-get-outer-html",
+  "download": "https://github.com/punkave/jquery-get-outer-html",
+  "dependencies": {
+    "jquery": ">=1.9"
+  }
+}

jquery.get-outer-html.js

@@ -0,0 +1,18 @@
+// get-outer-html: a jQuery plugin that makes it easy to get the
+// outer HTML of an element, including the element itself.
+//
+// Copyright 2013 P'unk Avenue LLC
+//
+// Please see:
+//
+// https://github.com/punkave/jquery-get-outer-html
+//
+// For complete documentation.
+
+(function( $ ){
+  $.fn.getOuterHTML = function() {
+    var wrapper = $('<div></div>');
+    wrapper.append(this.clone());
+    return wrapper.html();
+  };
+})( jQuery );