From 546921bd683159dee8cefd23601da9a330ffba5f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Go=C5=82e=CC=A8biowski-Owczarek?=
 <m.goleb@gmail.com>
Date: Thu, 2 Sep 2021 12:23:48 +0200
Subject: [PATCH] Accordion: Document the new header signature in UI 1.13

Ref jquery/jquery-ui#1904
---
 entries/accordion.xml | 25 +++++++++++++++++++++----
 1 file changed, 21 insertions(+), 4 deletions(-)

diff --git a/entries/accordion.xml b/entries/accordion.xml
index 20e706b0..e3b8f383 100644
--- a/entries/accordion.xml
+++ b/entries/accordion.xml
@@ -107,10 +107,27 @@
 		<option name="event" type="String" default='"click"' example-value='"mouseover"'>
 			<desc>The event that accordion headers will react to in order to activate the associated panel. Multiple events can be specified, separated by a space.</desc>
 		</option>
-		<option name="header" type="Selector" default='"> li > :first-child,> :not(li):even"' example-value='"h3"'>
-			<desc>
-				<p>Selector for the header element, applied via <code>.find()</code> on the main accordion element. Content panels must be the sibling immediately after their associated headers.</p>
-			</desc>
+		<option name="header" default='function( elem ) { return elem.find( "> li > :first-child" ).add( elem.find( "> :not(li)" ).even() ); }' example-value='"h3"'>
+			<desc>Data identifying the header element. Content panels must be the sibling immediately after their associated headers.</desc>
+			<type name="Selector">
+				<desc>Selector for the header element, applied via <code>.find()</code> on the main accordion element.</desc>
+			</type>
+			<type name="Function">
+				<argument name="accordionElement" type="jQuery">
+					<desc>The accordion element</desc>
+				</argument>
+				<desc>A function accepting the accordion element and returning the header element.</desc>
+			</type>
+			<example>
+				<desc>Initialize the accordion with the <code>header</code> option specified as a function:</desc>
+				<code>
+$( ".selector" ).accordion({
+  header: function ( accordionElement ) {
+    return accordionElement.find( "h3" );
+  }
+});
+				</code>
+			</example>
 		</option>
 		<option name="heightStyle" type="String" default='"auto"' example-value='"fill"'>
 			<desc>