Let’s start with the basics. In this howto we model a gender selection, a choice between two different options, that finally could be represented using radio buttons.

We start by placing a List-identifier. We will call the List-identifier Gender.

Notice the x, y in the triangle’s and the n behind the brackets. The x stands for the minimum number of choices the user has to make. The y stands for the maximum number of choices the user can make and the n for the total number of possible choices.

In this case it’s quite easy. We have two choices either male and female (n=2) and only one can be chosen (y=1).

Now let’s say it’s mandatory for the user to choose a gender (x=1). Just add a grey shadow below the List-identifier. The grey shadow indicates when something is mandatory.

You probably want to inform the user what they have to do in the form. So We will have to add a text label identifier to specify this. We will call the text label identifier “Gender selection text”. To finish the model we will also have to add the gender text label identifier. This is inside of the List-identifier. You can add all the options in the table witch will be explained below.

So now that we are done with the modeling part, we have to add the documentation to it. For every element you draw, you have to add a table to the documentation so that you can specify it’s purpose Let’s start with the List-identifier.

Now that we are done with the List-identifier we have to specify the text above the selection.

And finally we will add the text label with the name of the choices. Since you can have multiple options you will have to specify behind the brackets which option it is.

When you start building your website it can look something like this.

Note however that the we haven't specified that the selection will be represented by radiobuttons. A drop-down list, checkboxes and any other way to represent a choice are also valid representation of the UiaML core SelectList element.

Specifying that the SelectList will indeed be represented by radiobuttons is a property that will be added by the Graphical Design plugin.

 written by Victor Geerdink