[fix]: Add classes option for more widgets, update theming section

Author: jzaefferer

entries/autocomplete.xml

@@ -32,7 +32,7 @@
 
 		<ul>
 			<li><code>ui-autocomplete</code>: The <a href="/menu/#theming">menu</a> used to display matches to the user.</li>
-			<li><code>ui-autocomplete-input</code>: The input element that the Autocomplete widget was instantiated with.</li>
+			<li><code>ui-autocomplete-input</code>: The input element that the autocomplete widget was instantiated with. While requesting data to display to the user, the <code>ui-autocomplete-loading</code> class is also added to this element.</li>
 		</ul>
 
 		<h3>Dependencies</h3>
@@ -55,6 +55,10 @@
 		<option name="autoFocus" type="Boolean" default="false" example-value="true">
 			<desc>If set to <code>true</code> the first item will automatically be focused when the menu is shown.</desc>
 		</option>
+		<option name="classes" type="Object" default="{}">
+			<xi:include href="../includes/classes-option-desc.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+			<xi:include href="../includes/classes-option-example.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+		</option>
 		<option name="delay" type="Integer" default="300" example-value="500">
 			<desc>The delay in milliseconds between when a keystroke occurs and when a search is performed. A zero-delay makes sense for local data (more responsive), but can produce a lot of load for remote data, while being less responsive.</desc>
 		</option>

entries/button.xml

@@ -39,6 +39,13 @@
 	<note id="functional-css"/>
 	<added>1.8</added>
 	<options>
+		<option name="classes" type="Object">
+			<default>{
+	"ui-button": "ui-corner-all",
+}</default>
+			<xi:include href="../includes/classes-option-desc.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+			<xi:include href="../includes/classes-option-example.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+		</option>
 		<xi:include href="../includes/widget-option-disabled.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
 		<option name="icons" default="{ primary: null, secondary: null }" example-value='{ primary: "ui-icon-gear", secondary: "ui-icon-triangle-1-s" }'>
 			<desc>

entries/dialog.xml

@@ -55,7 +55,7 @@
 
 		<ul>
 			<li>
-				<code>ui-dialog</code>: The outer container of the dialog.
+				<code>ui-dialog</code>: The outer container of the dialog. If the <a href="#option-draggable"><code>draggable</code> option</a> is set, the <code>ui-dialog-dragging</code> class is added during a resize. If the <a href="#option-resizable"><code>resizable</code> option</a> is set, the <code>ui-dialog-resizing</code> class is added during a resize. If the <a href="#option-buttons"><code>buttons</code> option</a> is set, the <code>ui-dialog-buttons</code> class is added.
 				<ul>
 					<li>
 						<code>ui-dialog-titlebar</code>: The title bar containing the dialog's title and close button.
@@ -125,6 +125,14 @@
 				<desc>Each element of the array must be an object defining the attributes, properties, and event handlers to set on the button. In addition, a key of <code>icons</code> can be used to control <a href="/button/#option-icons">button's <code>icons</code> option</a>, and a key of <code>showText</code> can be used to control <a href="/button/#option-text">button's <code>text</code> option</a>.</desc>
 			</type>
 		</option>
+		<option name="classes" type="Object">
+			<default>{
+	"ui-dialog": "ui-corner-all",
+	"ui-dialog-titlebar": "ui-corner-all",
+}</default>
+			<xi:include href="../includes/classes-option-desc.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+			<xi:include href="../includes/classes-option-example.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+		</option>
 		<option name="closeOnEscape" default="true" example-value="false">
 			<desc>Specifies whether the dialog should close when it has focus and the user presses the escape (ESC) key.</desc>
 			<type name="Boolean" />

entries/droppable.xml

@@ -5,6 +5,12 @@
 	<longdesc>
 		<p>The jQuery UI Droppable plugin makes selected elements droppable (meaning they accept being dropped on by <a href="/draggable/">draggables</a>). You can specify which draggables each will accept.</p>
 
+		<xi:include href="../includes/widget-theming.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+
+		<ul>
+			<li><code>ui-droppable</code>: The droppable element. When a draggable that can be dropped on this dropppable is activated, the <code>ui-droppable-active</code> class is added. When dragging a draggable over this droppable, the <code>ui-droppable-hover</code> class is added.</li>
+		</ul>
+
 		<h3>Dependencies</h3>
 		<ul>
 			<li><a href="/category/ui-core/">UI Core</a></li>
@@ -29,6 +35,10 @@
 		<option name="addClasses" type="Boolean" default="true" example-value="false">
 			<desc>If set to <code>false</code>, will prevent the <code>ui-droppable</code> class from being added. This may be desired as a performance optimization when calling <code>.droppable()</code> init on hundreds of elements.</desc>
 		</option>
+		<option name="classes" type="Object" default="{}">
+			<xi:include href="../includes/classes-option-desc.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+			<xi:include href="../includes/classes-option-example.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+		</option>
 		<xi:include href="../includes/widget-option-disabled.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
 		<option name="greedy" type="Boolean" default="false" example-value="true">
 			<desc>By default, when an element is dropped on nested droppables, each droppable will receive the element. However, by setting this option to <code>true</code>, any parent droppables will not receive the element. The <code>drop</code> event will still bubble normally, but the <code>event.target</code> can be checked to see which droppable received the draggable element.</desc>

entries/menu.xml

@@ -71,12 +71,17 @@
 
 		<ul>
 			<li>
-				<code>ui-menu</code>: The outer container of the menu. This element will additionally have a <code>ui-menu-icons</code> class if the menu contains icons.
+				<code>ui-menu</code>: The outer container of the menu, as well as any nested sub menu. This top-level element will additionally have a <code>ui-menu-icons</code> class if the menu contains icons.
 				<ul>
 					<li>
-						<code>ui-menu-item</code>: The container for individual menu items.
+						<code>ui-menu-item</code>: The container for individual menu items. This contains the element for the item's text itself as well as the element for sub menus.
 						<ul>
-							<li><code>ui-menu-icon</code>: The submenu icons set via the <a href="#option-icons"><code>icons</code></a> option.</li>
+							<li>
+								<code>ui-menu-item-wrapper</code>: The text content of the item, along with the icon indicating sub menus.
+								<ul>
+									<li><code>ui-menu-icon</code>: The submenu icon set via the <a href="#option-icons"><code>icons</code></a> option.</li>
+								</ul>
+							</li>
 						</ul>
 					</li>
 					<li><code>ui-menu-divider</code>: Divider elements between menu items.</li>
@@ -94,13 +99,17 @@
 	<note id="functional-css"/>
 	<added>1.9</added>
 	<options>
+		<option name="classes" type="Object" default="{}">
+			<xi:include href="../includes/classes-option-desc.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+			<xi:include href="../includes/classes-option-example.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+		</option>
 		<xi:include href="../includes/widget-option-disabled.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
-		<option name="icons" type="Object" default='{ submenu: "ui-icon-carat-1-e" }' example-value='{ submenu: "ui-icon-circle-triangle-e" }'>
+		<option name="icons" type="Object" example-value='{ submenu: "ui-icon-circle-triangle-e" }'>
+			<default>{
+	submenu: "ui-icon-carat-1-e"
+}</default>
 			<desc>
 				Icons to use for submenus, matching <a href="/theming/icons/">an icon provided by the jQuery UI CSS Framework</a>.
-				<ul>
-					<li>submenu (string, default: "ui-icon-carat-1-e")</li>
-				</ul>
 			</desc>
 		</option>
 		<option name="items" type="String" default='"> *"' example-value='".custom-item"' init-only="true" added="1.11.0">

entries/progressbar.xml

@@ -14,7 +14,7 @@
 
 		<ul>
 			<li>
-				<code>ui-progressbar</code>: The outer container of the progressbar. This element will additionally have a class of <code>ui-progressbar-indeterminate</code> for indeterminate progressbars.
+				<code>ui-progressbar</code>: The outer container of the progressbar. This element will additionally have a class of <code>ui-progressbar-indeterminate</code> for indeterminate progressbars. For determinate progressbars, the <code>ui-progressbar-complete</code> class is added once the maximum value is reached.
 				<ul>
 					<li>
 						<code>ui-progressbar-value</code>: The element that represents the filled portion of the progressbar.
@@ -35,6 +35,15 @@
 	<note id="functional-css"/>
 	<added>1.6</added>
 	<options>
+		<option name="classes" type="Object">
+			<default>{
+	"ui-progressbar": "ui-corner-all",
+	"ui-progressbar-complete": "ui-corner-right",
+	"ui-progressbar-value": "ui-corner-left"
+}</default>
+			<xi:include href="../includes/classes-option-desc.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+			<xi:include href="../includes/classes-option-example.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+		</option>
 		<xi:include href="../includes/widget-option-disabled.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
 		<option name="max" default="100" type="Number" example-value="1024">
 			<desc>The maximum value of the progressbar.</desc>