horizon/doc/source/ref/tables.rst
guoshan a7da1dae4d Tutorials related to class Meta should use new style
The tutorials still use the old style class declaration.
class MyTable(DataTable):
    name = Column('name')
    email = Column('email')

    class Meta:
        name = "my_table"
        table_actions = (MyAction, MyOtherAction)
        row_actions - (MyAction)
It should use new style (inherit from 'object').

Change-Id: Icad23f6359f5f4866c5819f351f5c5cf1c3521fd
closes-bug:#1564193
2016-05-11 09:17:21 +08:00

2.2 KiB

Horizon DataTables

horizon.tables

Horizon includes a componentized API for programmatically creating tables in the UI. Why would you want this? It means that every table renders correctly and consistently, table- and row-level actions all have a consistent API and appearance, and generally you don't have to reinvent the wheel or copy-and-paste every time you need a new table!

For usage information, tips & tricks and more examples check out the DataTables Topic Guide </topics/tables>.

DataTable

The core class which defines the high-level structure of the table being represented. Example:

class MyTable(DataTable):
    name = Column('name')
    email = Column('email')

    class Meta(object):
        name = "my_table"
        table_actions = (MyAction, MyOtherAction)
        row_actions - (MyAction)

A full reference is included below:

DataTable

DataTable Options

The following options can be defined in a Meta class inside a .DataTable class. Example:

class MyTable(DataTable):
    class Meta(object):
        name = "my_table"
        verbose_name = "My Table"

horizon.tables.base.DataTableOptions

FormsetDataTable

You can integrate the .DataTable with a Django Formset using one of following classes:

horizon.tables.formset.FormsetDataTableMixin

horizon.tables.formset.FormsetDataTable

Table Components

Column

Row

Actions

Action

LinkAction

FilterAction

FixedFilterAction

BatchAction

DeleteAction

UpdateAction

Class-Based Views

Several class-based views are provided to make working with DataTables easier in your UI.

DataTableView

MultiTableView