Forms
Purpose of this document is to introduce you to differences and features of forms module available in
misago.core.forms package.Because Misago relies on JSON API endpoints to change application state by users, bulk of forms are be written as React.js components making AJAX requests to different
/api/ edges, either bypassing the forms altogether, or using them purely for data validation and cleaning.Finally, Misago defines few custom field types:
misago.core.forms.YesNoSwitch
misago.core.forms.YesNoSwitchThin wrapper around Django's
TypedChoiceField. In admin this field renders nice yes/no switch as its input.Warning!
YesNoSwitch coerces its value to int (eg. 0 or 1)! Remember about this when writing code dealing with forms containing this field!Template tags
Misago defines custom templates extension named
misago_forms. This extension contains two template tags for rendering form fields:form_row
form_rowThis tag takes form field as its first argument and renders field complete with label, help and errors. Accepts two extra arguments: label class and field class, allowing you to control size of horizontal forms:
1
{% load misago_forms %}
2
3
{% form_row form.somefield %}
4
{% form_row form.otherfield 'col-md-3' 'col-md-9' %}
Copied!
form_input
form_inputThis tag takes form field as its only argument and renders it's input.
Last modified 3yr ago
Copy link