📝
Form & input fields
Create native forms with different input formats
Add forms in your apps to receive data from users! Use different input types to create native forms in your apps.
Bravo supports the following input types for the forms. See the example design to see how to set them up in the design file.
Single-line text
Create a single-line text input.
[component:input-text]
Multi-line text (text area)
Create a multi-line text box.
[component:input-textarea]
Number
Create a numeric input
[component:input-number]
Email
Create a text input in email format
[component:input-email]
Phone
Create an input for a phone number
[component:input-tel]
Date
Create an input with a date picker
[component:input-date]
In case you want to send the date as per ISO 8601 (
yyyy-MM-dd'T'HH:mm:ss'Z'), you can use the following tag (note that the hour will be sent as 00:00:00):[component:input-date:datetime]
Time
Create an input with a time picker
[component:input-time]
URL
Create an input for a URL
[component:input-url]
Password
Create an input for a password. The characters in the input will be hidden while the user inputs them.
[component:input-password]
Selector
Create a dropdown selector with different options. You can specify the options in the design file, or obtain them via API request. See this page to see how to set it up.
[component:input-select]
Image (from phone camera)
Allows to take a picture with the phone camera and upload it in the form. The phone camera is opened when the user presses the area with the input tag.
[component:input-image]
Video (from phone camera)
Allows to record a video with the phone camera and upload it in the form. The phone camera is opened when the user presses the area with the input tag.
The maximum video size is 200MB.
[component:input-video]
File
Allows to upload a file that already exists in the phone storage. The option to select a file is opened when the user presses the area with the input tag.
[component:input-file]
You can easily make an input field required (mandatory for the user to fill in before sending the form), by appending
:required at the end of the input tag. For instance, [component:input-text:required].If a user tries to submit the form without filling in all the required fields in the form (if any), an alert message will be displayed, and the form won't be submitted.
To create a form in your app, add as many of the inputs above as you wish. Each input type will require a different setup, check out the example design file to see how to create them.
Once you have added all the inputs, surround them with a container. All the form inputs must be inside the same container.
Finally, add a button that will trigger the submit action when pressing it, once the user has filled in the form fields. This button must be inside the form container. To add it, create the button design, and attach the
action:submit tag to it.
Also, note that all the form inputs need to be in the same app screen, together with the submit button.
Once the design file with the form is imported into Bravo, an API request needs to be bound to the form and its inputs. There are two different types of requests that can be bound to forms:
- A PATCH request, to update an existing record in the database.
Once the API request has been created, the form input fields need to be bound to the UI elements as explained in the following pages:
See the example below to see how to set it up!
Last modified 3mo ago