Skip to content

fsinfuhh/django-spectre-css

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

django-spectre-css

This Module uses spectre.css (https://picturepan2.github.io/spectre/) to style a Django application.

Installation

Install:

pip install django-spectre-css

To use include static/css/lib/\*.css in your base templates css files or in your CSS pipeline

add it to your installed apps:

INSTALLED_APPS = [
    '...',
    'django_spectre_css',
    'widget_tweaks',
]

Warning

The help_text from models is marked as save in the template and therefore it is possible to have html e.g. links in the help_text. This means that help_text of an ModelField should never be directly based on user input.

Examples:

This module defines the following tags to make displaying forms easier.

  • render the form header (csrf-token and non-field errors) for the form 'form':

    {% load spectre_css %}

    {% render_form_header form %} [...]
  • render a field user of the form 'form':

    {% extends base.html %} {% load spectre_css %}

    [...] {% render_form_field form.user %}

  • render the whole form:

    {% extends base.html %} {% load spectre_css %}

    {% render_form form %}
  • render the first two parts of a MultiValueField as independent Fields:

    {% extends base.html %} {% load spectre_css %}

    [...] {% render_form_field form.datetime 0 label_text="Date"%} {% render_form_field form.datetime 1 label_text="Time" %}

render_form_field takes the following keyword arguments:

  • switch=True|False for checkboxes, if True renders the checkbox as switch
  • add_choices=[(value,text),...] to add the choices of an select to the select
  • replace_choices=[(value,text),...] to set the choices of an select manually
  • empty_option=value to generate an empty option if None is selected with the text value (only select widgets)
  • value=value overwrites the initial value of the field (not Checkbox and Select) with value

Upgrades

From < 0.3

'django-spectre-css' has to be changed into 'django_spectre_css' in th INSTALLED_APPS in Django settings.py