{hero}

stateRestore.state().load()

Since: StateRestore 1.0.0

Load a state from StateRestore into the table.
Please note - this property requires the StateRestore extension for DataTables.

Description

This method provides the ability to load a state that is managed by the stateRestore extension into the table.

stateRestore.state().load() takes no arguments. It loads the state retrieved by the previous call to stateRestore.state().

A Datatables API is returned so that further chaining can occur.

Type

function stateRestore.state().load()

Description:

Loads a stored state from the StateRestore extension into the table.

Returns:

Returns a DataTables API for chaining.

Example

Load a state called 'New State':

$(document).ready(function() {
    var table = $('#example').DataTable({
        dom: 'Blfrtip',
        buttons:['createState', 'savedStates']
    });

    table.stateRestore.state("New State").load()
});

Related

The following options are directly related and may also be useful in your application development.