The display decorator

mammadov115

Mehman Mammadov

Posted on June 13, 2024

The display decorator

When using a callable in the list_display, as in the cases of initialled_name and isbn13, we can use the admin.display decorator to specify the column name that will appear in the header of the change list using the description argument. We can also use it to get around the limitation of calculated fields not being sortable by specifying ordering on the callable. The empty_value argument can be used to specify how a None value or empty string is displayed. The default empty_value display is a single dash character:

@admin.display(ordering='isbn', description='ISBN-13', empty_value='-/-')
def isbn13(self, obj):
    """ '9780316769174' => '978-0-31-676917-4' """
    return "{}-{}-{}-{}-{}".format(obj.isbn[0:3], obj.isbn[3:4], obj.isbn[4:6], obj.isbn[6:12], obj.isbn[12:13])
Enter fullscreen mode Exit fullscreen mode

The boolean argument to admin.display can be used to flag a value to be represented in Boolean form:

@admin.display(boolean=True, description='Has ISBN')
def has_isbn(self, obj):
    """ '9780316769174' => True """
    return bool(obj.isbn)
Enter fullscreen mode Exit fullscreen mode

Together these display decorator settings will give us display columns that look like this:

Image description

Source

Web development with Django, Ben Shaw, Saurabh Badhwar, Chris Guest, Bharath Chandra K S

💖 đŸ’Ș 🙅 đŸš©
mammadov115
Mehman Mammadov

Posted on June 13, 2024

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related