add()

Add a new field to the form.
Please note - this property requires the Editor extension for DataTables.

Description

Fields in an Editor form can be dynamically added and removed from the form at any point, using this method and the clear() method.

By default, fields added using this method are automatically appended to the end of the form. As of Editor 1.5.6 you can optionally use the second parameter to determine where in the form's field order the new field should be inserted, or, for older versions, use the order() method to change the field order after the new field has been added.

You may also wish to use hide() if you do not wish the field to be visible immediately - call hide() with the second parameter set to false to disable animation.

Fields are typically set up during instance initialisation using the fields configuration option (which calls this API method internally) but this option provides the flexibility to modify the fields in the form - for example you might wish to ask for an extra input if a particular option is selected in a select list.

Type

add( config [, after ] )

Examples

var editor = new DataTable.Editor({
	ajax: 'php/index.php',
	table: '#example'
}).add({
	label: 'Name:',
	name: 'name'
});

editor.add({
	label: 'Name:',
	name: 'name',
	data: 'user_name',
	fieldInfo: 'Enter the system user name (first name + last name)'
});

editor.add(
	{
		label: 'Name:',
		name: 'name'
	},
	null
);

editor.add(
	{
		label: 'Middle name(s):',
		name: 'middle_name'
	},
	'first_name'
);