| {snip}'
Have a look at each column's API reference to find which elements are supported.
If you need to add some extra attributes to column's tags rendered in the
footer, use key name ``tf``, as described in section on :ref:`css`.
Callables passed in this dict will be called, with optional kwargs ``table``,
``bound_column`` ``record`` and ``value``, with the return value added. For example::
class Table(tables.Table):
person = tables.Column(attrs={
"td": {
"data-length": lambda value: len(value)
}
})
will render the `` | ``'s in the tables ```` with a ``data-length`` attribute
containing the number of characters in the value.
.. note::
The keyword arguments ``record`` and ``value`` only make sense in the context of a row
containing data. If you supply a callable with one of these keyword arguments,
it will not be executed for the header and footer rows.
If you also want to customize the attributes of those tags, you must define a
callable with a catchall (``**kwargs``) argument::
def data_first_name(**kwargs):
first_name = kwargs.get("value", None)
if first_name is None:
return "header"
else:
return first_name
class Table(tables.Table):
first_name = tables.Column(attrs={
"td": {
'data-first-name': data_first_name
}
})
This `attrs` can also be defined when subclassing a column, to allow better reuse::
class PersonColumn(tables.Column):
attrs = {
"td": {
"data-first-name": lambda record: record.first_name
"data-last-name": lambda record: record.last_name
}
}
def render(self, record):
return "{} {}".format(record.first_name, record.last_name)
class Table(tables.Table):
person = PersonColumn()
is equivalent to the previous example.
.. _row-attributes:
Row attributes
~~~~~~~~~~~~~~
Row attributes can be specified using a dict defining the HTML attributes for
the `` |