From: John Resig <jeresig@gmail.com>
Date: Sat, 23 Dec 2006 06:26:08 +0000 (+0000)
Subject: Added back in some of Joern's new .html() docs, and made .text(String) (a lot of... 
X-Git-Tag: 1.1a~78
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=2abe5934f6793606c8717b6282f54d7eca1bd42c;p=jquery.git

Added back in some of Joern's new .html() docs, and made .text(String) (a lot of users expect this method to be a setter and a getter).
---

diff --git a/src/jquery/jquery.js b/src/jquery/jquery.js
index 358c16546..57915bf11 100644
--- a/src/jquery/jquery.js
+++ b/src/jquery/jquery.js
@@ -487,7 +487,27 @@ jQuery.fn = jQuery.prototype = {
 	 * @type String
 	 * @cat DOM
 	 */
+
+	/**
+	 * Set the text contents of all matched elements. This has the same
+	 * effect as calling .html() with your specified string.
+	 *
+	 * @example $("p").text("Some new text.");
+	 * @before <p>Test Paragraph.</p>
+	 * @result <p>Some new text.</p>
+	 *
+	 * @param String val The text value to set the contents of the element to.
+	 *
+	 * @name text
+	 * @type String
+	 * @cat DOM
+	 */
 	text: function(e) {
+		// A surprisingly high number of people expect the
+		// .text() method to do this, so lets do it!
+		if ( typeof e == "string" )
+			return this.html( e );
+
 		e = e || this;
 		var t = "";
 		for ( var j = 0; j < e.length; j++ ) {
@@ -2602,6 +2622,7 @@ jQuery.macros = {
 
 		/**
 		 * Get the html contents of the first matched element.
+		 * This property is not available on XML documents.
 		 *
 		 * @example $("div").html();
 		 * @before <div><input/></div>
@@ -2614,6 +2635,7 @@ jQuery.macros = {
 
 		/**
 		 * Set the html contents of every matched element.
+		 * This property is not available on XML documents.
 		 *
 		 * @example $("div").html("<b>new stuff</b>");
 		 * @before <div><input/></div>