a0651d3e07
- @lion/ajax@0.1.1 - @lion/button@0.1.1 - @lion/checkbox-group@0.1.1 - @lion/checkbox@0.1.1 - @lion/choice-input@0.1.1 - @lion/core@0.1.1 - @lion/field@0.1.1 - @lion/fieldset@0.1.1 - @lion/form-system@0.0.2 - @lion/form@0.1.1 - @lion/icon@0.1.1 - @lion/input-amount@0.1.1 - @lion/input-date@0.1.1 - @lion/input-email@0.1.1 - @lion/input-iban@0.1.1 - @lion/input@0.1.1 - @lion/localize@0.1.1 - @lion/overlays@0.1.1 - @lion/popup@0.1.1 - @lion/radio-group@0.1.1 - @lion/radio@0.1.1 - @lion/select@0.1.1 - @lion/steps@0.1.1 - @lion/textarea@0.1.1 - @lion/tooltip@0.1.1 - @lion/validate@0.1.1 |
||
|---|---|---|
| .. | ||
| docs | ||
| src | ||
| test | ||
| CHANGELOG.md | ||
| index.js | ||
| lion-field.js | ||
| package.json | ||
| README.md | ||
Form Fundaments
Fields are the most fundamental building block of the Form System. They are the basis of
both fields and fieldsets.
What are fields?
Fields are the actual form controls the end user interacts with.
They extend the LionField class, which on its turn uses the FormControlMixin.
Fields provide a normalized, predictable API for platform components and customly made form controls.
On top of this, they feature:
- data synchronization with models
- formatting of view values
- advanced validation possibilities
- creation of advanced user interaction scenarios via
interaction states - provision of labels, help texts in an easy, declaritive manner
- better focus management
- accessibility out of the box
- advanced styling possibilities: map your own Design System to the internal HTML structure
Platform wrappers
LionInput, a wrapper for<input>LionTextarea, a wrapper for<textarea>LionSelect, a wrapper for<select>
Custom wrappers
Whenever a native form control doesn't exist or is not sufficient, a custom form control should be created. One could think of components like:
- slider
- combobox
- autocomplete
- etc...
What are fieldsets?
Fieldsets are groups of fields. They can be considered fields on their own as well, since they
partly share the normalized api via FormControlMixin.
Fieldsets are the basis for:
LionFieldsetLionFormLionRadioGroupLionCheckboxGroup
Other Resources
FormControlMixin(TODO: document)LionField(TODO: document)Model valuesFormatMixinInteractionStateMixin(TODO: document)ValidateMixin(TODO: document)FocusMixin(TODO: document)FieldCustomMixin(TODO: document)