ITables in Quarto

How to use ITables in Quarto

Activate ITables (same as in Jupyter, VS Code, PyCharm, Google Colab…)

import itables

itables.init_notebook_mode(all_interactive=True)

init_notebook_modetrusted

… and all DataFrames become interactive!

itables.sample_dfs.get_countries(html=False)

Search:

	region	country	capital	longitude	latitude
code
AW	Latin America & Caribbean	Aruba	Oranjestad	-70.0167	12.5167
AF	South Asia	Afghanistan	Kabul	69.1761	34.5228
AO	Sub-Saharan Africa	Angola	Luanda	13.242	-8.81155
AL	Europe & Central Asia	Albania	Tirane	19.8172	41.3317
AD	Europe & Central Asia	Andorra	Andorra la Vella	1.5218	42.5075

Showing 1 to 5 of 208 entries

How to make my table fit in one slide?

How to make your table smaller

display only a few rows with lengthMenu,
adjust the style or font with a custom css

This document uses

from IPython.display import display, HTML


# show 5 rows per 'page'
itables.options.lengthMenu = [5]

# don't show the length control
itables.options.layout["topStart"] = None

# use a smaller font (default is medium)
# see https://developer.mozilla.org/en-US/docs/Web/CSS/font-size
display(HTML("<style>.dt-container { font-size: medium; }</style>"))

Advanced Parameters

Parameters

ITables’ advanced parameters:

Can be set globally on itables.options, or
Passed as arguments to the show function.
Table-specific arguments like caption are only available in show.

Global Options and Quarto’s cache

Quarto uses a cache that may prevent your changes on itables.options to become effective when you run quarto render.

In that case, use --cache-refresh or even --execute-daemon-restart.

About ITables

GitHub Star

ITables is developed by Marc Wouts on GitHub, under a MIT license. ITables is a wrapper for datatables.net which is developed by Allan Jardine (sponsor him!), also under a MIT license.

Under the hood

ITables renders Pandas or Polars DataFrames as interactive HTML tables using the JavaScript DataTables library.

Documentation

Learn More about ITables in the documentation.