From 9606d2c90c9aabe222eac24c63dbf29c763c8b31 Mon Sep 17 00:00:00 2001
From: TJ VanToll
Date: Mon, 23 Sep 2013 08:39:38 -0400
Subject: [PATCH 1/8] Autocomplete: Documenting _renderItem() extension point.
---
entries/autocomplete.xml | 25 +++++++++++++++++++++++++
1 file changed, 25 insertions(+)
diff --git a/entries/autocomplete.xml b/entries/autocomplete.xml
index 48565212..f2fde8c7 100644
--- a/entries/autocomplete.xml
+++ b/entries/autocomplete.xml
@@ -177,6 +177,31 @@
Returns a jQuery object containing the menu element. Although the menu items are constantly created and destroyed, the menu element itself is created during initialization and is constantly reused.
+
+
+ Method that controls the creation of the <li> and <a> elements for each option in the widget's menu. The method must return a jQuery object containing the newly created <li>.
+
+ The <ul> element that the newly created <li> element must be appended to.
+
+
+
+ The string to display for the item.
+
+
+ The value to insert into the input when the item is selected.
+
+
+
+ Add the item's value as a data attribute on the <li>.
+
+
+
+
A simple jQuery UI Autocomplete
tag requirement in a note so it's easily axed in 1.11 when
the requirement is dropped.
---
entries/autocomplete.xml | 21 +++++++++++++--------
1 file changed, 13 insertions(+), 8 deletions(-)
diff --git a/entries/autocomplete.xml b/entries/autocomplete.xml
index f2fde8c7..515f923a 100644
--- a/entries/autocomplete.xml
+++ b/entries/autocomplete.xml
@@ -179,9 +179,12 @@
- Method that controls the creation of the <li> and <a> elements for each option in the widget's menu. The method must return a jQuery object containing the newly created <li>.
-
- The <ul> element that the newly created <li> element must be appended to.
+
+ Method that controls the creation of each option in the widget's menu. The method must create a new element to display the menu item, append it to the menu, and return it.
+ Note: At this time the menu item created must contain an <a> element for compatibility with the menu widget. See the example below.
+
+
+ The DOM element that the newly created menu item element must be appended to.
@@ -192,12 +195,14 @@
- Add the item's value as a data attribute on the <li>.
+ Use <li> elements with the item's value stored in a data-value attribute.
From 009cb92586c5221473223e08940c7722c3f475a3 Mon Sep 17 00:00:00 2001
From: TJ VanToll
Date: Tue, 24 Sep 2013 08:38:55 -0400
Subject: [PATCH 3/8] Autocomplete: _renderItem will always receive a
element
---
entries/autocomplete.xml | 14 +++++++-------
1 file changed, 7 insertions(+), 7 deletions(-)
diff --git a/entries/autocomplete.xml b/entries/autocomplete.xml
index 515f923a..d8910bae 100644
--- a/entries/autocomplete.xml
+++ b/entries/autocomplete.xml
@@ -180,11 +180,11 @@
- Method that controls the creation of each option in the widget's menu. The method must create a new element to display the menu item, append it to the menu, and return it.
- Note: At this time the menu item created must contain an <a> element for compatibility with the menu widget. See the example below.
+ Method that controls the creation of each option in the widget's menu. The method must create a new <li> element, append it to the menu, and return it.
+ Note: At this time the<ul> element created must contain an <a> element for compatibility with the menu widget. See the example below.
-
- The DOM element that the newly created menu item element must be appended to.
+
+ The <ul> element that the newly created <li> element must be appended to.
@@ -195,13 +195,13 @@
- Use <li> elements with the item's value stored in a data-value attribute.
+ Add the item's value as a data attribute on the <li>.
From 256bbaa888061fe181b7a13ea1a3be32a827a664 Mon Sep 17 00:00:00 2001
From: TJ VanToll
Date: Tue, 24 Sep 2013 08:56:10 -0400
Subject: [PATCH 4/8] Autocomplete: Document _renderMenu extension point.
---
entries/autocomplete.xml | 23 +++++++++++++++++++++++
1 file changed, 23 insertions(+)
diff --git a/entries/autocomplete.xml b/entries/autocomplete.xml
index d8910bae..519876ae 100644
--- a/entries/autocomplete.xml
+++ b/entries/autocomplete.xml
@@ -203,6 +203,29 @@ _renderItem: function( ul, item ) {
.append( $( "" ).text( item.label ) )
.appendTo( ul );
}
+]]>
+
+
+
+
+ Method that controls building the widget's menu. The method is passed an empty <ul> and an array of items that match the user typed term. Creation of the individual <li> elements should be delegated to _renderItemData().
+
+
+ An empty <ul> element to use as the widget's menu.
+
+
+ An Array of items that match the user typed term. Each item is an Object with label and value properties.
+
+
+ Add a CSS class name to the odd menu items.
+
From 7f90c491bfb82453ed70be45c1be10486fe10fdc Mon Sep 17 00:00:00 2001
From: TJ VanToll
Date: Wed, 25 Sep 2013 10:02:14 -0400
Subject: [PATCH 5/8] Autocomplete: Document the _resizeMenu extension point.
---
entries/autocomplete.xml | 11 +++++++++++
1 file changed, 11 insertions(+)
diff --git a/entries/autocomplete.xml b/entries/autocomplete.xml
index 519876ae..d0d60fa3 100644
--- a/entries/autocomplete.xml
+++ b/entries/autocomplete.xml
@@ -226,6 +226,17 @@ _renderMenu: function( ul, items ) {
});
$( ul ).find( "li:odd" ).addClass( "odd" );
}
+]]>
+
+
+
+ Method responsible for sizing the menu before it is displayed. The menu element is available at this.menu.element.
+
+ Always display the menu as 500 pixels wide.
+
From 9232d3e281c6af5f15da23c89a4b7ae48e49fe0d Mon Sep 17 00:00:00 2001
From: TJ VanToll
Date: Wed, 25 Sep 2013 20:33:09 -0400
Subject: [PATCH 6/8] Spinner: Document extension points.
---
entries/spinner.xml | 34 ++++++++++++++++++++++++++++++++++
1 file changed, 34 insertions(+)
diff --git a/entries/spinner.xml b/entries/spinner.xml
index 082c2098..db7a8bf9 100644
--- a/entries/spinner.xml
+++ b/entries/spinner.xml
@@ -168,6 +168,40 @@
+
+
+
+ Method that returns HTML to use for the spinner's increment and decrement buttons. Each button must be given a ui-spinner-button class name for the associated events to work.
+
+
+ Use <button> elements for the increment and decrement buttons.
+
+
+
+
+
+ Method that determines the HTML to use to wrap the spinner's <input> element.
+
+
+ Wrap the spinner with a <div> with no rounded corners.
+
+
+
+
From 38593a07900c927da71a83c3b78210ada7482887 Mon Sep 17 00:00:00 2001
From: TJ VanToll
Date: Thu, 26 Sep 2013 08:45:22 -0400
Subject: [PATCH 7/8] Dialog: Document _allowInteraction() extension point.
---
entries/dialog.xml | 16 ++++++++++++++++
1 file changed, 16 insertions(+)
diff --git a/entries/dialog.xml b/entries/dialog.xml
index 88c8a3d7..d0151e63 100644
--- a/entries/dialog.xml
+++ b/entries/dialog.xml
@@ -345,6 +345,22 @@
+
+
+
+ Modal dialogs do not allow users to interact with elements behind the dialog. This can be problematic for elements that are not children of the dialog, but are absolutely positioned to appear as though they are. The _allowInteraction() method determines whether the user should be allowed to interact with a given target element; therefore, it can be used to whitelist elements that are not children of the dialog but you want users to be able to use.
+
+
+
+ Allow the Select2 plugin to be used within modal dialogs. The _super() call ensures elements within the dialog can still be interacted with.
+
+
+
+
A simple jQuery UI Dialog
+
+
+
+ Method that determines whether clicks on the document should close any open menus. By default, menus are closed unless the click occurred a menu.
+
+
+
+ Never close menus on document click.
+
+
+
+