Portlet Factory, Version 6.1.2

---

 

About the Value Element and Label Element inputs

In general, the Value Element and Label Element builder inputs are used to associate a visible label with an invisible value that is actually submitted to the IBM® WebSphere Portlet Factory servlet. The Label Element input specifies which value in a multi-valued source should become the text or visible label of an item in a select list. For example, if the output of some service call is a list in which each item is composed of three parts, the Label Element input allows specification of one of those parts as the item label, which will be visible in the list at runtime.

Consider the following structure:

<options>
  <option>
      <color>blue</color>
      <colorvalue>a</colorvalue>
      <extratag>extrainfo</extrainfo>
  </option>
  <option>
      <color>yellow</color>
      <colorvalue>b</colorvalue>
      <extratag>extrainfo2</extrainfo>
  </option>
  <option>
      <color>green</color>
      <colorvalue>c</colorvalue>
      <extratag>extrainfo3</extratag>
  </option>
</options>

The Value Element specifies which value in a multiple-valued source should be assigned to the value attribute of the <option> tags in the list produced at runtime. It is this value that is actually posted when a form containing a select list is submitted. In the example above, if color is specified in the Label Element input and colorvalue is specified in the Value Element input, then when the yellow option is selected by the user and the form is posted, the value b would be transmitted to WebSphere Portlet Factory, although this value would not be visible to the user.

Parent topic: Checkbox Group builder

---

Library | Support |