Merge branch 'master' of github.com:jquery/web-learn-jquery-com

* 'master' of github.com:jquery/web-learn-jquery-com:
  add excercises to jquery-basics
  Added manipulating elements and meta changes to jquery-basics

Author: ajpiano

content/jquery-fundamentals/jquery-basics/attributes.md

@@ -1,13 +1,15 @@
 ---
-chapter : "jqfundamentals"
-section : "4"
-title   : "Attributes"
+chapter : jqfundamentals
+section : 4
+title   : Attributes
+attribution:  jQuery Fundamentals
 ---
 ## Attributes
 
 An element's attributes can contain useful information for your application, so it's important to be able to get and set them.
 
-The `$.fn.attr` method acts as both a getter and a setter. As with the `$.fn.css` method, `$.fn.attr` as a setter can accept either a key and a value, or an object containing one or more key/value pairs.
+The `$.fn.attr` method acts as both a getter and a setter. 
+As with the `$.fn.css` method, `$.fn.attr` as a setter can accept either a key and a value, or an object containing one or more key/value pairs.
 
 <div class="example" markdown="1">
 Setting attributes
@@ -19,7 +21,9 @@ Setting attributes
     });
 </div>
 
-This time, we broke the object up into multiple lines. Remember, whitespace doesn't matter in JavaScript, so you should feel free to use it liberally to make your code more legible! You can use a minification tool later to strip out unnecessary whitespace for production.
+This time, we broke the object up into multiple lines. 
+Remember, whitespace doesn't matter in JavaScript, so you should feel free to use it liberally to make your code more legible! 
+You can use a minification tool later to strip out unnecessary whitespace for production.
 
 <div class="example" markdown="1">
 Getting attributes

content/jquery-fundamentals/jquery-basics/css-styling-dimensions.md

@@ -1,7 +1,8 @@
 ---
-chapter : "jqfundamentals"
-section : "3"
-title   : "CSS, Styling, & Dimensions"
+chapter : jqfundamentals
+section : 3
+title   : CSS, Styling, & Dimensions
+attribution:  jQuery Fundamentals
 ---
 ## CSS, Styling, & Dimensions
 

content/jquery-fundamentals/jquery-basics/document-ready.md

@@ -1,7 +1,8 @@
 ---
-chapter : "jqfundamentals"
-section : "1"
-title   : "$(document).ready()"
+chapter : jqfundamentals
+section : 1
+title   : $(document).ready()
+attribution:  jQuery Fundamentals
 ---
 ## $(document).ready()
 

content/jquery-fundamentals/jquery-basics/exercises.md

@@ -0,0 +1,54 @@
+---
+chapter : jqfundamentals
+section : 7
+title   : Exercises
+attribution:  jQuery Fundamentals
+---
+## Exercises
+
+### Selecting
+
+Open the file `/exercises/index.html` in your browser. 
+Use the file `/exercises/js/sandbox.js` or work in Firebug to accomplish the following:
+
+1.	Select all of the div elements that have a class of "module".
+
+2.	Come up with three selectors that you could use to get the third item in the #myList unordered list. Which is the best to use? Why?
+
+3.	Select the label for the search input using an attribute selector.
+
+4.	Figure out how many elements on the page are hidden (hint: .length).
+
+5.	Figure out how many image elements on the page have an alt attribute.
+
+6.	Select all of the odd table rows in the table body.
+
+### Traversing
+
+Open the file `/exercises/index.html` in your browser. Use the file `/exercises/js/sandbox.js` or work in Firebug to accomplish the following:
+
+1.	Select all of the image elements on the page; log each image's alt attribute.
+
+2.	Select the search input text box, then traverse up to the form and add a class to the form.
+
+3.	Select the list item inside `#myList` that has a class of "current" and remove that class from it; add a class of "current" to the next list item.
+
+4.	Select the select element inside `#specials`; traverse your way to the submit button.
+
+5.	Select the first list item in the #slideshow element; add the class "current" to it, and then add a class of "disabled" to its sibling elements.
+
+### Manipulating
+
+Open the file `/exercises/index.html` in your browser. Use the file `/exercises/js/sandbox.js` or work in Firebug to accomplish the following:
+
+1.	Add five new list items to the end of the unordered list `#myList`. Hint:
+
+    for (var i = 0; i<5; i++) { ... }
+
+2.	Remove the odd list items
+
+3. 	Add another h2 and another paragraph to the last div.module
+
+4.	Add another option to the select element; give the option the value "Wednesday"
+
+5.	Add a new div.module to the page after the last one; put a copy of one of the existing images inside of it.

content/jquery-fundamentals/jquery-basics/manipulating-elements.md

@@ -0,0 +1,235 @@
+---
+chapter : jqfundamentals
+section : 6
+title   : Manipulating Elements
+attribution:  jQuery Fundamentals
+---
+## Manipulating Elements
+
+Once you've made a selection, the fun begins. You can change, move, remove, and clone elements. 
+You can also create new elements via a simple syntax.
+
+For complete documentation of jQuery manipulation methods, visit [http://api.jquery.com/category/manipulation/](http://api.jquery.com/category/manipulation/ "Manipulation documentation on api.jquery.com").
+
+### Getting and Setting Information about Elements
+
+There are any number of ways you can change an existing element. 
+Among the most common tasks you'll perform is changing the inner HTML or attribute of an element. 
+jQuery offers simple, cross-browser methods for these sorts of manipulations. 
+You can also get information about elements using many of the same methods in their getter incarnations. 
+We'll see examples of these throughout this section, but specifically, here are a few methods you can use to get and set information about elements.
+
+<div class="note" markdown="1">
+### Note
+
+Changing things about elements is trivial, but remember that the change will affect all elements in the selection. 
+If you just want to change one element, be sure to specify that in the selection before calling a setter method.
+</div>
+
+<div class="note" markdown="1">
+Note
+
+When methods act as getters, they generally only work on the first element in the selection. 
+They do not return a jQuery object, so you can't chain additional methods to them. 
+One notable exception is `$.fn.text`; as mentioned below, it gets the text for all elements in the selection.
+</div>
+
+#### $.fn.html
+Get or set the html contents.
+
+#### $.fn.text
+Get or set the text contents; HTML will be stripped.
+
+#### $.fn.attr
+Get or set the value of the provided attribute.
+
+#### $.fn.width
+Get or set the width in pixels of the first element in the selection as an integer.
+
+#### .fn.height
+Get or set the height in pixels of the first element in the selection as an integer.
+
+#### fn.position
+Get an object with position information for the first element in the selection, relative to its first positioned ancestor. _This is a getter only_.
+
+#### $.fn.val
+Get or set the value of form elements.
+
+<div class="example" markdown="1">
+Changing the HTML of an element
+
+    $('#myDiv p:first')
+        .html('New &lt;strong>first&lt;/strong> paragraph!');
+</div>
+
+### Moving, Copying, and Removing Elements
+
+There are a variety of ways to move elements around the DOM; generally, there are two approaches:
+
+*	Place the selected element(s) relative to another element
+
+*	Place an element relative to the selected element(s)
+
+For example, jQuery provides `$.fn.insertAfter` and `$.fn.after`. The `$.fn.insertAfter` method places the selected element(s) after the element that you provide as an argument; 
+the `$.fn.after` method places the element provided as an argument after the selected element. 
+Several other methods follow this pattern: `$.fn.insertBefore` and `$.fn.before`; 
+`$.fn.appendTo` and `$.fn.append`; and `$.fn.prependTo` and `$.fn.prepend`.
+
+The method that makes the most sense for you will depend on what elements you already have selected, and whether you will need to store a reference to the elements you're adding to the page. 
+If you need to store a reference, you will always want to take the first approach — placing the selected elements relative to another element — as it returns the element(s) you're placing. 
+In this case, `$.fn.insertAfter`, `$.fn.insertBefore`, `$.fn.appendTo`, and `$.fn.prependTo` will be your tools of choice.
+
+<div class="example" markdown="1">
+Moving elements using different approaches
+
+    // make the first list item the last list item
+    var $li = $('#myList li:first').appendTo('#myList');
+    
+    // another approach to the same problem
+    $('#myList').append($('#myList li:first'));
+    
+    // note that there's no way to access the
+    // list item that we moved, as this returns
+    // the list itself
+</div>
+
+### Cloning Elements
+
+When you use methods such as `$.fn.appendTo`, you are moving the element; sometimes you want to make a copy of the element instead. 
+In this case, you'll need to use `$.fn.clone` first.
+
+<div class="example" markdown="1">
+Making a copy of an element
+
+    // copy the first list item to the end of the list
+    $('#myList li:first').clone().appendTo('#myList');
+</div>
+
+<div class="note" markdown="1">
+### Note
+
+If you need to copy related data and events, be sure to pass true as an argument to `$.fn.clone`.
+</div>
+
+### Removing Elements
+
+There are two ways to remove elements from the page: `$.fn.remove` and `$.fn.detach`. 
+You'll use `$.fn.remove` when you want to permanently remove the selection from the page; 
+while the method does return the removed element(s), those elements will not have their associated data and events attached to them if you return them to the page.
+
+If you need the data and events to persist, you'll want to use `$.fn.detach` instead. 
+Like `$.fn.remove`, it returns the selection, but it also maintains the data and events associated with the selection, so you can restore the selection to the page at a later time.
+
+<div class="note" markdown="1">
+###Note
+
+The `$.fn.detach` method is extremely valuable if you are doing heavy manipulation to an element. 
+In that case, it's beneficial to `$.fn.detach` the element from the page, work on it in your code, and then restore it to the page when you're done. 
+This saves you from expensive "DOM touches" while maintaining the element's data and events.
+</div>
+
+If you want to leave the element on the page but simply want to remove its contents, you can use `$.fn.empty` to dispose of the element's inner HTML.
+
+### Creating New Elements
+
+jQuery offers a trivial and elegant way to create new elements using the same `$()` method you use to make selections.
+
+<div class="example" markdown="1">
+Creating new elements
+
+    $('&lt;p>This is a new paragraph&lt;/p>');
+    $('&lt;li class="new">new list item&lt;/li>');
+</div>
+
+<div class="example" markdown="1">
+Creating a new element with an attribute object
+
+$('&lt;a/>', {
+    html : 'This is a &lt;strong>new&lt;/strong> link',
+    'class' : 'new',
+    href : 'foo.html'
+});
+</div>
+
+Note that in the attributes object we included as the second argument, the property name class is quoted, while the property names text and href are not. 
+Property names generally do not need to be quoted unless they are reserved words (as class is in this case).
+
+When you create a new element, it is not immediately added to the page. 
+There are several ways to add an element to the page once it's been created.
+
+<div class="example" markdown="1">
+Getting a new element on to the page
+
+    var $myNewElement = $('&lt;p>New element&lt;/p>');
+    $myNewElement.appendTo('#content');
+    
+    $myNewElement.insertAfter('ul:last'); // this will remove the p from #content!
+    $('ul').last().after($myNewElement.clone());  // clone the p so now we have 2
+</div>
+
+Strictly speaking, you don't have to store the created element in a variable — you could just call the method to add the element to the page directly after the `$()`. 
+However, most of the time you will want a reference to the element you added, so you don't need to select it later.
+
+You can even create an element as you're adding it to the page, but note that in this case you don't get a reference to the newly created element.
+
+<div class="example" markdown="1">
+Creating and adding an element to the page at the same time
+
+    $('ul').append('&lt;li>list item&lt;/li>');
+</div>
+
+<div class="note" markdown="1">
+### Note
+
+The syntax for adding new elements to the page is so easy, it's tempting to forget that there's a huge performance cost for adding to the DOM repeatedly. If you are adding many elements to the same container, you'll want to concatenate all the html into a single string, and then append that string to the container instead of appending the elements one at a time. You can use an array to gather all the pieces together, then join them into a single string for appending.
+
+<div class="example" markdown="1">
+    var myItems = [], $myList = $('#myList');
+    
+    for (var i=0; i&lt;100; i++) {
+        myItems.push('&lt;li>item ' + i + '&lt;/li>');
+    }
+
+    $myList.append(myItems.join(''));
+</div>
+</div>
+
+### Manipulating Attributes
+
+jQuery's attribute manipulation capabilities are extensive. 
+Basic changes are simple, but the `$.fn.attr` method also allows for more complex manipulations. 
+It can either set an explicit value, or set a value using the return value of a function. 
+When the function syntax is used, the function receives two arguments: 
+the zero-based index of the element whose attribute is being changed, and the current value of the attribute being changed.
+
+<div class="example" markdown="1">
+Manipulating a single attribute
+
+    $('#myDiv a:first').attr('href', 'newDestination.html');
+</div>
+
+<div class="example" markdown="1">
+Manipulating multiple attributes
+
+    $('#myDiv a:first').attr({
+        href : 'newDestination.html',
+        rel : 'super-special'
+    });
+</div>
+
+<div class="example" markdown="1">
+Using a function to determine an attribute's new value
+
+    $('#myDiv a:first').attr({
+        rel : 'super-special',
+        href : function(idx, href) {
+            return '/new/' + href;
+        }
+    });
+</div>
+
+<div class="example" markdown="1">
+    $('#myDiv a:first').attr('href', function(idx, href) {
+        return '/new/' + href;
+    });
+</div>

content/jquery-fundamentals/jquery-basics/traversing.md

@@ -1,7 +1,8 @@
 ---
-chapter : "jqfundamentals"
-section : "5"
-title   : "Traversing"
+chapter : "qfundamentals
+section : 5
+title   : Traversing
+attribution:  jQuery Fundamentals
 ---
 ## Traversing
 
@@ -12,7 +13,8 @@ For complete documentation of jQuery traversal methods, visit [http://api.jquery
 <div class="note" markdown="1">
 ### Note
 
-Be cautious with traversing long distances in your documents — complex traversal makes it imperative that your document's structure remain the same, something that's difficult to guarantee even if you're the one creating the whole application from server to client. One- or two-step traversal is fine, but you generally want to avoid traversals that take you from one container to another.
+Be cautious with traversing long distances in your documents — complex traversal makes it imperative that your document's structure remain the same, something that's difficult to guarantee even if you're the one creating the whole application from server to client. 
+One- or two-step traversal is fine, but you generally want to avoid traversals that take you from one container to another.
 </div>
 
 <div class="example" markdown="1">
@@ -25,7 +27,10 @@ Moving around the DOM using traversal methods
     $('li.selected').siblings();
 </div>
 
-You can also iterate over a selection using `$.fn.each`. This method iterates over all of the elements in a selection, and runs a function for each one. The function receives the index of the current element and the DOM element itself as arguments. Inside the function, the DOM element is also available as `this` by default.
+You can also iterate over a selection using `$.fn.each`. 
+This method iterates over all of the elements in a selection, and runs a function for each one. 
+The function receives the index of the current element and the DOM element itself as arguments. 
+Inside the function, the DOM element is also available as `this` by default.
 
 <div class="example" markdown="1">
 Iterating over a selection

content/jquery-fundamentals/jquery-basics/working-with-selections.md

@@ -1,7 +1,8 @@
 ---
-chapter : "jqfundamentals"
-section : "3"
-title   : "Working with Selections"
+chapter : jqfundamentals
+section : 3
+title   : Working with Selections
+attribution:  jQuery Fundamentals
 ---
 ## Working with Selections