{"id":664,"date":"2018-03-22T20:13:00","date_gmt":"2018-03-22T20:13:00","guid":{"rendered":"https:\/\/codenerix.com\/?p=664\/"},"modified":"2023-04-06T06:57:42","modified_gmt":"2023-04-06T06:57:42","slug":"genlist","status":"publish","type":"post","link":"https:\/\/codenerix.com\/en\/genlist\/","title":{"rendered":"GenList"},"content":{"rendered":"\n

\ud83c\uddea\ud83c\udde6 Leer en Espa\u00f1ol, \u201cGenList<\/a>\u201c<\/p>\n\n\n\n

Previously we talked about CodenerixModel<\/a> to understand how a functional model is built with CODE<\/span>NERIX<\/span><\/a>;<\/strong><\/span><\/strong> however, for everything to work in Django, in addition to models you also have to define views. To allow web content to be viewed, a set of inheritable views is <\/span>available to the programmer, all based on Django<\/strong>‘s Generic Views<\/strong>, which, following the CODE<\/span>NERIX<\/span><\/a><\/strong><\/span><\/strong> policy, are as simple to use as to inherit from them.<\/p>\n\n\n\n

In this article, we will talk about GenList<\/strong>, which is the generic view of CODE<\/span>NERIX<\/span><\/a><\/strong><\/span><\/strong> that allows you to view data as a list from the model. GenList<\/strong> inherits directly from Django<\/strong>‘s ViewList<\/strong>, so all properties of a ViewList<\/strong> are available in GenList<\/strong>. Let’s see what the list of a “Contact<\/strong>” model would look like:<\/p>\n\n\n\n

from codenerix.views import GenList\nfrom app.models import Contact\n\nclass ContactList(GenList):\n    model = Contact<\/pre>\n\n\n\n
As simple as that, and the visual result would be equivalent to something like this (if you use the CODE<\/span>NERIX<\/span><\/strong><\/span><\/strong> Examples<\/a>):<\/p>\n\n\n\n
<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
In this way we have managed to visualize the Contact model of the “agenda” example that you have here:<\/p>\n\n\n\n
class Contact(CodenerixModel):\n    first_name = models.CharField(verbose_name=_(u'Name(s)'), max_length=128)\n    last_name = models.CharField(verbose_name=_(u'Last name'), max_length=128, blank=True, null=True)\n    alias = models.CharField(verbose_name=_(u'Alias'), max_length=32, blank=True, null=True)\n    organization = models.CharField(verbose_name=_(u'Organizaci\u00f3n'), max_length=64, blank=True, null=True)\n    borndate = models.DateField(verbose_name=_(u'Cumplea\u00f1os'), blank=True, null=True)\n    address = models.TextField(verbose_name=_(u'Direcci\u00f3n'), blank=True, null=True)\n    created_by = models.ForeignKey(User, verbose_name=_(u'Creado por'), on_delete=models.CASCADE, related_name='contacts')\n\n    def __fields__(self, info):\n        return (\n            ('first_name', _(Name(s)')),\n            ('last_name', _(Last name')),\n            ('alias', _(u'Alias')),\n            ('organization', _(u'Organization')),\n        )<\/pre>\n\n\n\n
You may have already noticed that CODE<\/span>NERIX<\/span><\/a><\/strong><\/span><\/strong> has used the __fields__<\/em><\/strong> method of the model to discover which fields it should display in the list. In addition, it felt free enough to automatically<\/mark><\/strong> offer a list that enables cumulative ascending\/descending sorting <\/strong>in each of its fields (see “Last name” column in the following screenshot) and if we press the filter<\/strong> icon (light<\/mark> <\/mark>blue<\/mark><\/strong> colour in the following screenshot ) we can even see that it has also taken care of allowing us to search in each  field<\/strong> one by one (see “Organization” column where we search for “Inc” limiting the list to 2 results):<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
In short, by inheriting from GenList<\/strong> we have achieved a great job with an excellent visual result for our users.<\/p>\n\n\n\n
The following 3 tables show 3 columns:<\/p>\n\n\n\n
But GenList<\/strong>, like CodenerixModel<\/a><\/strong>, allows you to use the methods: __fields__<\/em>, __limitQ__<\/em>, __searchF__<\/em> and __searchQ__<\/em>. In this way, when one of these methods is created in a GenList<\/strong>, the CodenerixModel<\/a><\/strong><\/strong> or GenList<\/strong> method will be used as they exist. In fact, its operation is exactly the same as in CodenerixModel<\/a><\/strong>.<\/p>\n\n\n\n