Datatables functionality

Events

gtCreateDataTable events:

It’s call before return the request parameters, pass the parameter to be send, and require return of data

datatable_inits : {
  "events": {
    filter: function(data){
                    return data;
            }
    }
}

Columns render functions

• yesnoprint: Print fa-check-circle icon and text Yes o fa-times-circle and text No if No

• objShowBool: Print fa-check-circle icon and text Yes o fa-times-circle and text No if No

• emptyprint: Print —- if object is none

• selectobjprint: Print an object using display_name attribute, also support pass the display_name key to be used

  {data: "country", name: "country__name", title: "Country", type: "string", visible: true,
                                                  render: selectobjprint({display_name: "name"}) },
  

• gt_print_list_object(display_name): Print object or List of objects using the display_name parameter as key

• showlink: Use data to create an A tag and print More text.

• downloadlink: Use data to create download link and print Download text.

• objshowlink: Use data to create an A tag, require the next structured on data returned from API

  {
      url: 'https://...',
      class: 'a class',
      display_name: 'text to display'
  }
  

• objnode: Use data to create an XX tag, require the next structured on data returned from API

  {
      url: 'https://...',
      class: 'a class',
      display_name: 'text to display',
      tagName: 'span',
      extraattr: ''
  }
  

Working with date and datetime fields

When managing dates, it’s necessary to take into account the date formats.

{data: "last_time", name: "last_time", title: gettext("Last Time"), type: "date",
render: DataTable.render.datetime(), "dateformat":  document.datetime_format, visible: true},
{data: "born_date", name: "born_date", title: gettext("Born date"), type: "date",
render: DataTable.render.date(),  "dateformat":  document.date_format, visible: true},

In this case, it is assumed that the template provides the following formats in the document object using the template tags provided to determine the format configured in Django.

{% load timejs %}
document.datetime_format="{% get_datetime_format %}";
document.date_format="{% get_date_format %}";

Working with date and datetime fields on Server API

Django Rest framework serializers for Date and Datetime fields has problems dealing with empty string “”, so when your date field is no required fail with validation error so we provide 2 serializers.

from djgentelella.serializers import GTDateField, GTDateTimeField

class Myserializer(serializers.Serializer):
    creation_date = GTDateField()
    modification_datetime = GTDateTimeField()