Layout

Layout#

By default, datatables that don’t fit in one page come with a search box, a pagination control, a table summary, etc. You can select which elements are actually displayed using DataTables’ layout option with e.g.:

import itables

itables.init_notebook_mode()
df = itables.sample_dfs.get_countries(html=False)
itables.show(df, layout={"topStart": "search", "topEnd": None})
Loading ITables v2.4.0rc1 from the init_notebook_mode cell... (need help?)

The available positions are topStart, topEnd, bottomStart, bottomEnd. You can also use top2Start, etc… (see more in the DataTables documentation).

Like for the other arguments of show, you can change the default value of the dom option with e.g.:

itables.options.layout =  {
    "topStart": "pageLength",
    "topEnd": "search",
    "bottomStart": "info",
    "bottomEnd": "paging"
}  # (default value)

Tip

The layout option was introduced with itables==2.0 and DataTables==2.0 and replaced the former dom option.