Tables

NetBox employs the django-tables2 library for rendering dynamic object tables. These tables display lists of objects, and can be sorted and filtered by various parameters.

NetBoxTable

To provide additional functionality beyond what is supported by the stock Table class in django-tables2, NetBox provides the NetBoxTable class. This custom table class includes support for:

User-configurable column display and ordering
Custom field & custom link columns
Automatic prefetching of related objects

It also includes several default columns:

pk - A checkbox for selecting the object associated with each table row
id - The object's numeric database ID, as a hyperlink to the object's view
actions - A dropdown menu presenting object-specific actions available to the user.

Example

# tables.py
import django_tables2 as tables
from netbox.tables import NetBoxTable
from .models import MyModel

class MyModelTable(NetBoxTable):
    name = tables.Column(
        linkify=True
    )
    ...

    class Meta(NetBoxTable.Meta):
        model = MyModel
        fields = ('pk', 'id', 'name', ...)
        default_columns = ('pk', 'name', ...)

Table Configuration

The NetBoxTable class supports dynamic configuration to support pagination and to effect user preferences. To configure a table for a specific request, simply call its configure() method and pass the current HTTPRequest object. For example:

table = MyModelTable(data=MyModel.objects.all())
table.configure(request)

If using a generic view provided by NetBox, table configuration is handled automatically.

Columns

The table column classes listed below are supported for use in plugins. These classes can be imported from netbox.tables.columns.

::: netbox.tables.BooleanColumn rendering: show_source: false selection: members: false

::: netbox.tables.ChoiceFieldColumn rendering: show_source: false selection: members: false

::: netbox.tables.ColorColumn rendering: show_source: false selection: members: false

::: netbox.tables.ColoredLabelColumn rendering: show_source: false selection: members: false

::: netbox.tables.ContentTypeColumn rendering: show_source: false selection: members: false

::: netbox.tables.ContentTypesColumn rendering: show_source: false selection: members: false

::: netbox.tables.MarkdownColumn rendering: show_source: false selection: members: false

::: netbox.tables.TagColumn rendering: show_source: false selection: members: false

::: netbox.tables.TemplateColumn rendering: show_source: false selection: members: false

2.8 KiB Raw Blame History

Tables

NetBoxTable

Example

Table Configuration

Columns

2.8 KiB

Raw Blame History