<?xml version="1.0" encoding="UTF-8" ?>
<dt-option library="Buttons">
	<name>buttons.dom.buttonLiner</name>
	<summary>DOM configuration of a button liner element</summary>
	<since>1.0.0</since>

	<type type="object">
		<description>
			Plain object which will can have the properties `tag` and / or `className` set.

			* `tag` - a `-type string` value which defines the HTML tag to use. There should be no spaces or any other formatting - e.g. it should simply be `span`, `a`, etc.
			* `className` - a `-type string` value which defines the element's class name. Multiple classes can be given using space separation.
		</description>
	</type>

	<type type="null">
		<description>
			When set to `null`, this option will disable the button liner element and the buttons will be created without a liner.
		</description>
	</type>

	<description>
	<![CDATA[
		This option controls the HTML tag that is used as the liner for each button. This can be particularly useful for adding complex styling rules to buttons. It can also be disabled if you wish to have minimal markup in your document.

		Please refer to the `b-init buttons.dom` documentation for an overview of the DOM structure that Buttons will create. In this specific case, this option controls the `<span>...</span>` button liner element that is shown in the example HTML there.
	]]>
	</description>

	<example title="DataTables initialisation: Use an `i` tag to line the button element"><![CDATA[

$('#myTable').DataTable( {
	buttons: {
		dom: {
			buttonLiner: {
				tag: 'i'
			}
		}
	}
} );

]]></example>

	<example title="Instance initialisation: Disable the button liner using `null` as the tag value"><![CDATA[

new $.fn.dataTable.Buttons( table, {
	buttons: {
		dom: {
			buttonLiner: null
		}
	]
} );

]]></example>
</dt-option>