django-crispy-forms/django-crispy-forms
Django Crispy Forms
django-crispy-forms is a Django form rendering library used to generate styled HTML output from forms. It employs a programmatic form layout engine that allows the composition of form structures and styling using Python objects rather than handwritten HTML templates.
The library uses a template pack system to decouple form logic from visual styling, enabling the application of different CSS frameworks through configuration settings. This ensures frontend UI consistency by swapping the set of HTML templates used for various frameworks.
The tool provides a Django template filter to produce complete styled markup and utilizes a compositional layout model to organize form fields and components. These capabilities allow for the definition of reusable form structures and the management of visual layouts without manual markup.
Features
- Django Form Renderers - Rendering Django forms into HTML without writing templates, controlling layout and markup through a Python API.
- Form Renderers - A library that renders Django forms into HTML using programmable layouts without writing custom templates.
- Form Rendering Helpers - Attaches layout and styling settings to a form object via a FormHelper instance, altering rendering behaviour without subclassing.
- Form Layout Compositions - Builds form output from a tree of Python objects (Div, Field, ButtonHolder) that map to structured HTML.
- Theme Switching Configurations - Switching between Bootstrap, Tailwind, or other CSS frameworks for form appearance with a single setting change.
- Field Grouping Containers - Wraps individual fields in reusable layout primitives that control CSS classes, labels, and field ordering.
- Template-Free Form Renderers - A renderer that outputs form HTML directly via Django template tags and filters, eliminating handwritten templates.
- Multi-Theme Template Packs - Switches between CSS frameworks by loading a consistent set of named templates from a configurable pack directory.
- Template Tag Overrides - Intercepts Django form rendering via a template filter or tag that delegates to a programmable layout pipeline.
- CSS Frameworks - A tool that toggles between frontend CSS frameworks with a single setting to change visual styling of forms.
- Declarative Rendering - The form library applies a filter or tag to render web forms directly to HTML, producing elegant layouts without custom templates.
- Programmatic Layout Engines - An engine that defines form layouts programmatically and applies them across multiple forms for consistent markup.
- Programmatic Layouts - The form library allows defining form layouts in code and rendering them directly to HTML, giving full control over the generated markup.
- Programmatic Form Layouts - Defining form structures in Python code, arranging fields and buttons in a configurable layout instead of templates.
- CSS Framework Switchers - The form library permits switching between frontend CSS frameworks to change form visual styles with a single setting.
- Uni-Form Output Conventions - Produces HTML that adheres to the uni-form standard for consistent styling and extensibility across forms.
- Form Markup Generators - Generating full form HTML using a simple template filter, producing elegant div-based layouts without custom templates.
- Reusable - The form library supports packaging a form layout into a reusable object to apply consistent markup across multiple forms.
- Form Handling - Renders forms in a clean, DRY manner.
