Behold jquery-radio

Author: Tom Boutell

README.md

@@ -1,34 +1,31 @@
-# jquery-images-ready
+# jquery-radio
 
-<a href="http://apostrophenow.org/"><img src="https://raw.github.com/punkave/jquery-images-ready/master/logos/logo-box-madefor.png" align="right" /></a>
+<a href="http://apostrophenow.org/"><img src="https://raw.github.com/punkave/jquery-radio/master/logos/logo-box-madefor.png" align="right" /></a>
 
-imagesReady waits until the size of certain images is known, then tells you the maximum width, maximum height, and maximum ratio of height to width of all the images. This is super useful for implementing slideshows and anything else where you need to know the worst case before proceeding, or simply for any situation where you need to be sure of the image dimensions before proceeding. Well-tested back to IE8.
+`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()`.
 
 ## How to Use
 
-$('.my-images').imagesReady(function(maxWidth, maxHeight, maxHeightToWidth) {
-  // Your code here
-});
+Select *all* of the buttons in the group and call `.radio()`:
 
-Note that `imagesReady` will wait for all of the images either matching the selector directly or contained within elements that do match the selector. This is very useful when you wish to wait for all of the images in a slideshow. If you want to match only certain images, though, you can use filters in your selector to be more specific.
+    // 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();
 
-*The reported sizes are always the true size, regardless of any CSS that may be in effect.*
-
-"Why `maxHeightToWidth`?" This ratio is useful when you are using `width: 100%` to size images and allowing the height to scale freely. In that situation it is important to know what the greatest height will be, so that you can size a slideshow intelligently to avoid jumpiness when the user scrolls below the slideshow. You can determine this maximum height by multiplying the width of the containing element by `maxHeightToWidth`.
-
-For a sweet jQuery slideshow plugin that takes advantage of this, check out [projector](http://github.com/punkave/jquery-projector).
+This example assumes you have several radio buttons that all have the `.my-radio-group` class.
 
 ### Requirements
 
-You need jQuery, of course. `jquery-images-ready` is actively supported with jQuery 1.9 and 2.0 but may work with older versions.
+You need jQuery, of course. `jquery-radio` is actively supported with jQuery 1.9 and 2.0 but should work fine with older versions.
 
 ## About P'unk Avenue and Apostrophe
 
-`jquery-images-ready` 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-images-ready` you should definitely [check out apostrophenow.org](http://apostrophenow.org). Also be sure to visit us on [github](http://github.com/punkave).
+`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).
 
 ## Support
 
-Feel free to open issues on [github](http://github.com/punkave/jquery-images-ready).
+Feel free to open issues on [github](http://github.com/punkave/jquery-radio).
 
-<a href="http://punkave.com/"><img src="https://raw.github.com/punkave/jquery-images-ready/master/logos/logo-box-builtby.png" /></a>
+<a href="http://punkave.com/"><img src="https://raw.github.com/punkave/jquery-radio/master/logos/logo-box-builtby.png" /></a>
 

images-ready.jquery.json

@@ -0,0 +1,23 @@
+// radio: a jQuery plugin that makes it easy to set or get the
+// current value of a group of radio buttons.
+//
+// Copyright 2013 P'unk Avenue LLC
+//
+// Please see:
+//
+// https://github.com/punkave/jquery-radio
+//
+// For complete documentation.
+
+(function( $ ){
+  $.fn.radio = function(value) {
+    var $els = this;
+    if (value === undefined) {
+      return $els.filter(':checked').val();
+    } else {
+      $.each($els, function() {
+        $(this).attr('checked', $(this).attr('value') === value);
+      });
+    }
+  };
+})( jQuery );

jquery.images-ready.js

@@ -0,0 +1,36 @@
+{
+  "name": "radio",
+  "title": "radio",
+  "description": "radio lets you get and set the current value of a group of radio buttons, filling a gap in jQuery's $.val. It is not a replacement for radio buttons. It just makes working with them pleasant.",
+  "keywords": ["radio", "button", "apostrophe", "punkave"],
+  "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-radio/LICENSE"
+    }
+  ],
+  "bugs": "https://github.com/punkave/jquery-radio/issues",
+  "homepage": "https://github.com/punkave/jquery-radio",
+  "docs": "https://github.com/punkave/jquery-radio",
+  "download": "https://github.com/punkave/jquery-radio",
+  "dependencies": {
+    "jquery": ">=1.9"
+  }
+}