Form Array

Style-agnostic form array component.

python 9 params

Preview

Usage

views.py
python
from djust import LiveView
from djust.decorators import event_handler
from djust.components import FormArray


class MyView(LiveView):
    template_name = "my_template.html"

    def mount(self, request, **kwargs):
        self.component = FormArray()

    @event_handler()
    def add_row(self, **kwargs):
        self.component.rows = ...  # `append_row` — see this component's docs

    @event_handler()
    def remove_row(self, **kwargs):
        pass  # your app acts on 'remove_row'; no component state moves
my_template.html
django
{{ component }}

Events this component sends to the view: add_row, remove_row.

Parameters

NameTypeDefaultDescription
namestr'items'Field name prefix
rowslist | NoneNoneList of row dicts with values
minint1Minimum number of rows (default: 1)
maxint10Maximum number of rows (default: 10)
add_eventstr — renames the event'add_row'djust event for adding a row
remove_eventstr — renames the event'remove_row'djust event for removing a row
add_labelstr'Add row'Add button text
custom_classstr''Additional CSS classes
**kwargs— passed to `Component.__init__`: `id=` sets `component.id`, and any other keyword is kept as state——
Source & styles
FilePathNotes
moduledjust.components.components.form_arraySubclass it, or pass custom_class, to change how it renders.
cssdjust_components/components.cssDefines 5 of this component's classes at line 1858, 1859, 1860, 1861, 1863. Override those rules, or the custom properties they read, in a stylesheet loaded after it.