From 9758d426ed7505582d6c27ee7dc216158f6aa30f Mon Sep 17 00:00:00 2001
From: TJ VanToll <tj.vantoll@gmail.com>
Date: Thu, 5 Sep 2013 08:48:22 -0400
Subject: [PATCH 1/2] Adding article on jQuery widget method invocation.

---
 .../widget-method-invocation.md               | 63 +++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 page/jquery-ui/widget-factory/widget-method-invocation.md

diff --git a/page/jquery-ui/widget-factory/widget-method-invocation.md b/page/jquery-ui/widget-factory/widget-method-invocation.md
new file mode 100644
index 00000000..a38340c4
--- /dev/null
+++ b/page/jquery-ui/widget-factory/widget-method-invocation.md
@@ -0,0 +1,63 @@
+---
+title: Widget Method Invocation
+level: intermediate
+---
+
+Widgets created with [the widget factory](/jquery-ui/widget-factory/) use methods to change their state and perform actions after initialization. There are two ways widget methods can be invoked - through the plugin created by the widget factory, or by invoking the method on the element's instance object.
+
+### Plugin Invocation
+
+To invoke a method using the widget's plugin, pass the name of the method as a string. For example, here is how you call the [dialog widget's `close()` method](http://api.jqueryui.com/dialog/#method-close).
+
+```
+$( ".selector" ).dialog( "close" );
+```
+
+If the method requires arguments, pass them as additional parameters to the plugin. Here is how you call [dialog's `option()` method](http://api.jqueryui.com/dialog/#method-option).
+
+```
+$( ".selector" ).dialog( "option", "height" );
+```
+
+This returns the value of the [dialog's `height` option](http://api.jqueryui.com/dialog/#option-height).
+
+### Instance Invocation
+
+Under the hoods, every instance of every widget is stored on the element using [`jQuery.data()`](http://api.jquery.com/jQuery.data/). To retrieve the instance object, call `jQuery.data()` using the widget's full name as the key. Let's look at each.
+
+```
+var dialog = $( ".selector" ).data( "ui-dialog" );
+```
+
+After you have a reference to the instance object, methods can be invoked on it directly.
+
+```
+var dialog = $( ".selector" ).data( "ui-dialog" );
+dialog.close();
+```
+
+In jQuery UI 1.11, the new `instance()` method will make this process even easier.
+
+```
+$( ".selector" ).dialog( "instance" ).close();
+```
+
+### Return Types
+
+Most methods invoked through the widget's plugin will return a `jQuery` object so the method call can be chained with additional jQuery methods.
+
+```
+$( ".selector" )
+	.dialog( "close" )
+	.css( "color", "red" );
+```
+
+The exception to this are methods that return information about the widget. For example [dialog's `isOpen()` method](http://api.jqueryui.com/dialog/#method-isOpen).
+
+```
+$( ".selector" )
+	.dialog( "isOpen" )
+	.css( "color", "red" );
+```
+
+This produces an error as `isOpen()` returns a boolean, not a `jQuery` object.
\ No newline at end of file

From 2359c85bbe0dfff5cb1a759b8842e8c5a126710b Mon Sep 17 00:00:00 2001
From: TJ VanToll <tj.vantoll@gmail.com>
Date: Fri, 6 Sep 2013 15:46:47 -0400
Subject: [PATCH 2/2] Clarify where in the second example the error will be
 thrown.

---
 page/jquery-ui/widget-factory/widget-method-invocation.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/page/jquery-ui/widget-factory/widget-method-invocation.md b/page/jquery-ui/widget-factory/widget-method-invocation.md
index a38340c4..9ec783d4 100644
--- a/page/jquery-ui/widget-factory/widget-method-invocation.md
+++ b/page/jquery-ui/widget-factory/widget-method-invocation.md
@@ -57,7 +57,8 @@ The exception to this are methods that return information about the widget. For
 ```
 $( ".selector" )
 	.dialog( "isOpen" )
+	// This will throw a TypeError
 	.css( "color", "red" );
 ```
 
-This produces an error as `isOpen()` returns a boolean, not a `jQuery` object.
\ No newline at end of file
+This produces a `TypeError` error as `isOpen()` returns a boolean, not a jQuery object.
\ No newline at end of file