<?xml version="1.0" encoding="UTF-8" ?>
<dt-event>
	<name>length</name>
	<summary>Page length change event - fired when the page length is changed.</summary>
	<since>1.10</since>

	<type type="function">
		<signature>function( e, settings, len )</signature>
		<parameter type="object" name="e">
			jQuery event object
		</parameter>
		<parameter type="DataTables.Settings" name="settings">
			DataTables settings object
		</parameter>
		<parameter type="integer" name="len">
			New page length
		</parameter>
		<scope>HTML table element</scope>
	</type>

	<description>
		The `dt-event length` event is fired whenever the table's page length is changed. This can be through user interaction with the built in page length control, or via the API.

		Please note that, as with all DataTables emitted events, this event is triggered with the `dt` namespace. As such, to listen for this event, you must also use the `dt` namespace by simply appending `.dt` to your event name, as shown in the example below.
	</description>

	<example title="Write to console on page length change"><![CDATA[
$('#example').dataTable();

$('#example').on( 'length.dt', function ( e, settings, len ) {
	console.log( 'New page length: '+len );
} );
]]></example>

	<related type="option">paging</related>
	<related type="option">pagingType</related>
	<related type="api">page()</related>
	<related type="api">page.info()</related>
	<related type="api">page.len()</related>
	<related type="event">page</related>
</dt-event>