buttons.buttons.destroy

Function that is called when the button is destroyed

1.0.0 Default function depends upon the button type. Please refer to the button type documentation destroy( dt, node, config ) DataTables API instance for the selected button - i.e. `b-api button()` for the button in question A DataTables API instance for the host DataTable jQuery instance for the button node in question The button's configuration object No return value is required or expected. No action is taken upon any value that is returned. The function given here is called when the button is destroyed either by a call to `b-api buttons().remove()`, when the Buttons instance is destroyed (`b-api buttons().destroy()`) or when the host DataTable is destroyed (`dt-api destroy()`). It is provided to allow authors to removed events from the button preventing memory leaks. This function is provided to allow button authors to be able to assign custom events to the host DataTable or the button's DOM node, and then cleanly remove those events when a button is destroyed, ensuring that there are no memory leaks. Of particular interest when using this method and the `b-init buttons.buttons.init` option to attach events, will be the `b-init buttons.buttons.namespace` option (accessible as the `namespace` parameter of the third parameter passed into this function). The `namespace` option is a unique namespacing string for every button, allowing events to be correctly removed without accidentally also removing other events.