.. _include:

`include`
---------

The `include` configuration is used to include or exclude parts programmatically. Let's start with a simple example of a table:



.. code-block:: python

    table = Table(
        auto__model=Album,
    )

.. raw:: html

    <div class="iframe_collapse" onclick="toggle('800b6310-9fb8-4d6c-a53e-278396bb7128', this)">▼ Hide result</div>
    <iframe id="800b6310-9fb8-4d6c-a53e-278396bb7128" src="doc_includes/include/test_include.html" style="background: white; display: ; width: 100%; min-height: 100px; border: 1px solid gray;"></iframe>
    <div class="show_structure_toggler"><span onclick="toggle_iframe_structure_overlay()">Toggle structure</span></div>

We could make the `name` column only visible for staff users:

.. code-block:: python

    table = Table(
        auto__model=Album,
        columns__name__include=lambda user, **_: user.is_staff,
    )

.. raw:: html

    <div class="iframe_collapse" onclick="toggle('d29fcb8e-1750-4052-aeab-4f2ac2e07cb8', this)">▼ Hide result</div>
    <iframe id="d29fcb8e-1750-4052-aeab-4f2ac2e07cb8" src="doc_includes/include/test_include1.html" style="background: white; display: ; width: 100%; min-height: 100px; border: 1px solid gray;"></iframe>
    <div class="show_structure_toggler"><span onclick="toggle_iframe_structure_overlay()">Toggle structure</span></div>