Description
The FormRow component is a helper to more easily achieve often used DNB form layout setups.
Deprecation
In order to replace FormSet or FormRow you may use the Eufemia Provider and Flex as well as the Eufemia Forms Extension.
e.g. before:
<FormSet label_direction="vertical"> <H2 top={0}>Heading</H2> <FormRow label={<span className="dnb-h--medium">Legend</span>}> <Input label="Label A" right /> <Input label="Label B" /> </FormRow> </FormSet>
e.g. after (two examples):
<Provider formElement={{ label_direction: 'vertical', }} > <Form.Handler> <H2 top={0}>Heading</H2> <FieldBlock label={<span className="dnb-h--medium">Legend</span>}> <Flex.Horizontal> <Input label="Label A" /> <Input label="Label B" /> </Flex.Horizontal> </FieldBlock> </Form.Handler> </Provider>
<Form.Handler> <Flex.Stack> <Form.MainHeading>Heading</Form.MainHeading> <FieldBlock label={<span className="dnb-h--medium">Legend</span>}> <Flex.Horizontal> <Field.String label="Label A" width="medium" /> <Field.String label="Label B" width="large" /> </Flex.Horizontal> </FieldBlock> </Flex.Stack> </Form.Handler>
Fieldset and Legend
By default a FormRow
is using the <fieldset>
and <legend>
HTML elements - if a label property is provided.
Layout direction
The default direction is horizontal
.
You can combine several FormRow's (example below) and the direction to achieve the wanted UX layout. You can also send the layout properties along from a FormSet (example below).
There are three possible layout properties for the FormRow children:
label_direction
Children's label directiondirection
Children components directionvertical
Forces both to be vertically
label_direction
The property: <FormRow label_direction="vertical"> <Input label="Label" right /> <Input label="Label" /> </FormRow>
direction
The property: <FormRow direction="vertical"> <Input label="Label" bottom /> <Input label="Label" /> </FormRow>
vertical
The property: <FormRow vertical> <Input label="Label" bottom /> <Input label="Label" /> </FormRow>
Default
This is how it looks if you don't make any definitions.
<FormRow> <Input label="Label" right /> <Input label="Label" /> </FormRow>
Spacing
To give a FormRow space, properties from Space are supported:
{/* The FormRow will then have a "margin-top: 2.5rem;" */} <FormRow top="large x-small"> <Input label="Input label">Value</Input> </FormRow> {/* ... or go crazy */} <FormRow top="large medium small"> <Input label="Input label">Value</Input> </FormRow>
Provider
You can send down the FormRow
as an application-wide property (Context). More info about the provider usage.
Responsiveness
The FormRow component provides by default responsiveness.
But if you also want the form components to be responsive. E.g. the label of the input should be wrapped to be vertical / above the input, then you have to set the responsive
prop to true
.
<FormRow responsive={true}> <Input label="Input label">Value</Input> </FormRow>
Wrapping happens then if the viewport (screen) is less than max-width: 40em
.
You can also make use of the helper class, e.g. <FormRow className="dnb-responsive-component">...</FormRow>
.