Skip to content

Commit 4844909

Browse files
committed
Tabs: Added note about restrictions on changing ajaxSettings inside beforeLoad events. Fixes jquery#93.
1 parent d23742e commit 4844909

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

entries/tabs.xml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -115,8 +115,10 @@
115115
</argument>
116116
</event>
117117
<event name="beforeLoad">
118-
<desc>Triggered when a remote tab is about to be loaded, after the <a href="#event-beforeActivate"><code>beforeActivate</code></a> event. Can be canceled to prevent the tab panel from loading content; though the panel will still be activated. This event is triggered just before the Ajax request is made, so modifications can be made to <code>ui.jqXHR</code> and <code>ui.ajaxSettings</code>.</desc>
119-
<argument name="event" type="Event"/>
118+
<desc>
119+
<p>Triggered when a remote tab is about to be loaded, after the <a href="#event-beforeActivate"><code>beforeActivate</code></a> event. Can be canceled to prevent the tab panel from loading content; though the panel will still be activated. This event is triggered just before the Ajax request is made, so modifications can be made to <code>ui.jqXHR</code> and <code>ui.ajaxSettings</code>.</p>
120+
<p><em>Note: Although <code>ui.ajaxSettings</code> is provided and can be modified, some of these settings have already been processed by jQuery. For example, <a href="http://api.jquery.com/jQuery.ajaxPrefilter/">prefilters</a> have been applied, <code>data</code> has been processed, and <code>type</code> has been determined. The <code>beforeLoad</code> event occurs at the same time, and therefore has the same restrictions, as the <code>beforeSend</code> callback from <a href="http://api.jquery.com/jQuery.ajax/"><code>jQuery.ajax()</code></a>.</em></p>
121+
</desc>
120122
<argument name="ui" type="Object">
121123
<property name="tab" type="jQuery">
122124
<desc>The tab that is being loaded.</desc>

0 commit comments

Comments
 (0)