From 2abe5934f6793606c8717b6282f54d7eca1bd42c Mon Sep 17 00:00:00 2001
From: John Resig <jeresig@gmail.com>
Date: Sat, 23 Dec 2006 06:26:08 +0000
Subject: [PATCH] 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).
---
src/jquery/jquery.js | 22 ++++++++++++++++++++++
1 file changed, 22 insertions(+)
diff --git a/src/jquery/jquery.js b/src/jquery/jquery.js
index 358c165..57915bf 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>
--
1.7.10.4