.. _howto-datagrid: ================= DataGrid HowTo ================= Introduzione ------------ Questo howto mostra come usare :ref:`ref-datagrid` Immaginiamo di avere una classe Person di questo tipo:: class CompanyDataGrid(KiDataGrid): full_name = Column("Name", sortable=True, link=True) website = UrlColumn("Website", sortable=True) vat_number = Columt_numbern("VAT", sortable=True) Creiamo la DataTable :: class CompanyDataGrid(KiDataGrid): full_name = Column("Name", sortable=True, link=True) website = UrlColumn("Website", sortable=True) vat_number = Column("VAT", sortable=True) codice_fiscale = Column("Codice Fiscale", sortable=True) def __init__(self, request, queryset=Company.objects.all(), title="", extra_context={}, optimize_sorts=True): KiDataGrid.__init__(self, request, queryset, "Company", extra_context, optimize_sorts) self.default_sort = ['full_name'] self.default_columns = ['full_name', 'website', 'vat_number', ] ... la relativa view:: def company_list(request): return CompanyDataGrid(request).render_to_response('crm/company/list.html') ... ed il template da utilizzare ('crm/company/list.html') :: {% load datagrid %} {% block extrahead %} {{block.super}} {% datagridmedia %} {% endblock %} {% block main %} {% grid %} {% endblock %} .. warning:: DataGrid necessita del :ref:`ref-models-kiuserprofile` Link ----------------- Definire nella classe un metodo tipo:: @staticmethod def link_to_object(user, value): return reverse( 'crm.views.company_edit', kwargs={'id' :user.contact.pk}) Colonne collegate ----------------- Se si ha la necessita di visualizzare una colonna relativa ad una ForeignKey è possibile farlo con l'utilizzo del parametro **field_name** nella dichiarazione della colonna:: full_name = Column('Nome', field_name='contact__full_name', sortable=True, link=True) Campi di ricrerca ----------------- Per abilitare il form di ricerca è necessario indicare l'elenco dei campi da ricercare:: search_fields = ('person__full_name',) Ogni nome può essere preceduto da un marcatore che indica il tipo di ricerca da effettuare, in caso di assenza verrà usato '__icontains' marker funzione di ricerca ====== =================== ^ __istartswith = __iexact @ __search Personalizzare il css --------------------- Poichè DataGrid effettua delle chiamate ajax in varie occasioni la personalizzazione dei css tramite jQuery deve essere ripetuta ogni volta::