Field Container
Inherits from Xamarin.Forms.Layout
You know those fancy input fields that have the nice labels, borders, required field markers, and all that? Well, the FieldContainer view handles all that fancy work for you.
A FieldContainer displays views that implement the IRockField interface. You can find all the views that implement this interface in the Form Fields section of the documentation. All of these views implement the required properties to get the title of the field as well as know if the field should be considered required.
The fields can be displayed in one of two ways. Either as individual fields or as grouped fields. An example of the grouped fields would be the login block. The username and password fields are displayed in a single grouping that contains both fields. While a good example of individual fields would be the workflow entry block, each field is displayed one at a time.
Usually, you will want to display fields individually, unless you have full control over the titles. The reason for this is that the titles take up much more space in a Grouped layout vs an Individual layout. So if you are, for example, displaying attributes in a Grouped layout, some of those attributes might have names consisting of 10-15 words, which will just look really odd in the Grouped layout.
Finally, on the layout, some fields require an Individual layout. One example of this is the Address field. It actually displays its components in a grouped stack already, so trying to force that inside another Grouped layout will result in a visual headache.
Properties
Property | Type | Description |
Title | string | When in Grouped layout, this value provides the title that will be used above the entire group. If not set or set to an empty string, then no group title will be displayed. |
FieldLayout | The type of layout to use when rendering the fields. Defaults to Automatic. |
Field Layout
Value | Description |
Automatic | The container will examine its own contents and determine the best layout to use. If only a single field has been provided or if any of the fields require Individual layout, then Individual layout will be used. Otherwise Grouped layout will be used. |
Individual | Each field will be displayed with a title above and then the field itself will be displayed full-width below. |
Grouped | A single group title will be displayed above all the fields, then each field will be displayed with a title on the left and the field on the right in a sort of grid. |
Examples
The above will render as a Grouped layout with a title for the entire group of Your Name
and then will display the individual fields for First Name
(which will be marked as required) and Last Name
in a single group below.
The above will render an Individual field (since there is only one). It will display the label Your Name
above and then have the text input box placed below it.
The above is very similar to our first example. But because we are specifically requesting Individual layout, you will first get the First Name
label with the related text input below it. Then slightly further down you will have the Last Name
label with the related text input below it.
Last updated