tailbone.forms.widgets

Form Widgets

class tailbone.forms.widgets.CasesUnitsWidget(**kw)

Widget for collecting case and/or unit quantities. Most useful when you need to ensure user provides cases or units but not both.

class tailbone.forms.widgets.CustomSelectWidget(**kw)

This widget is mostly for convenience. You can set extra kwargs for the serialize() method, e.g.:

widget.set_template_values(foo='bar')

class tailbone.forms.widgets.CustomerAutocompleteWidget(request, *args, **kwargs)

Autocomplete widget for a Customer reference field.

class tailbone.forms.widgets.CustomerDropdownWidget(request, *args, **kwargs)

Dropdown widget for a Customer reference field.

class tailbone.forms.widgets.DepartmentWidget(request, **kwargs)

Custom select widget for a Department reference field.

Constructor accepts the normal values kwarg but if not provided then the widget will fetch department list from Rattail DB.

Constructor also accepts required kwarg, which defaults to true unless specified.

class tailbone.forms.widgets.DynamicCheckboxWidget(**kw)

This checkbox widget can be “dynamic” in the sense that form logic can control its value and state.

class tailbone.forms.widgets.DynamicSelectWidget(**kw)

This is a “normal” select widget, but instead of (or in addition to) its values being set when constructed, they must be assigned dynamically in real-time, e.g. based on other user selections.

Really all this widget “does” is render some Vue.js-compatible HTML, but the page which contains the widget is ultimately responsible for wiring up the logic for things to work right.

class tailbone.forms.widgets.FalafelDateTimeWidget(**kw)

Custom widget for rattail UTC datetimes

class tailbone.forms.widgets.FalafelTimeWidget(*args, **kwargs)

Custom widget for simple time fields

class tailbone.forms.widgets.FileUploadWidget(*args, **kwargs)

Widget to handle file upload. Must override to add use_oruga to field template context.

class tailbone.forms.widgets.JQueryAutocompleteWidget(**kw)

Uses the jQuery autocomplete plugin, instead of whatever it is deform uses by default.

requirements = None

class tailbone.forms.widgets.JQueryDateWidget(**kw)

Uses the jQuery datepicker UI widget, instead of whatever it is deform uses by default.

requirements = None

class tailbone.forms.widgets.JQuerySelectWidget(**kw)

class tailbone.forms.widgets.JQueryTimeWidget(*args, **kwargs)

Uses the jQuery datepicker UI widget, instead of whatever it is deform uses by default.

requirements = None

class tailbone.forms.widgets.MultiFileUploadWidget(tmpstore, **kw)

Widget to handle multiple (arbitrary number) of file uploads.

class tailbone.forms.widgets.NumberInputWidget(**kw)

class tailbone.forms.widgets.NumericInputWidget(**kw)

This widget uses a <numeric-input> component, which will leverage the numeric.js functions to ensure user doesn’t enter any non-numeric values. Note that this still uses a normal “text” input on the HTML side, as opposed to a “number” input, since the latter is a bit ugly IMHO.

class tailbone.forms.widgets.PercentInputWidget(**kw)

Custom text input widget, used for “percent” type fields. This widget assumes that the underlying storage for the value is a “traditional” percent value, e.g. 0.36135 - but the UI should represent this as a “human-friendly” value, e.g. 36.135 %.

class tailbone.forms.widgets.PlainDateWidget(**kw)

class tailbone.forms.widgets.PlainSelectWidget(**kw)

class tailbone.forms.widgets.ReadonlyWidget(**kw)

class tailbone.forms.widgets.VendorAutocompleteWidget(request, *args, **kwargs)

Autocomplete widget for a Vendor reference field.

class tailbone.forms.widgets.VendorDropdownWidget(request, *args, **kwargs)

Dropdown widget for a Vendor reference field.

tailbone.forms.widgets.make_customer_widget(request, **kwargs)

Make a customer widget; will be either autocomplete or dropdown depending on config.

tailbone.forms.widgets.make_vendor_widget(request, **kwargs)

Make a vendor widget; will be either autocomplete or dropdown depending on config.