NaturalONE Version 8.3.7
 —  Natural for Ajax  —

NJX:FIELDLIST

The NJX:FIELDLIST control is used to arrange fields or groups of fields in a horizontal line. The difference of using the NJX:FIELDLIST control instead of individual fields is that the NJX:FIELDLIST control binds the contained fields to an array or array group in the application, while individual fields are bound to individual variables.

The following topics are covered below:


Example

Example

The XML code for the example looks as follows:

<rowarea name="Complex Field List">
    <itr>
        <njx:fieldlist fieldlistprop="columns" fieldcount="5" 
         hdist="60">
            <njx:fielditem valueprop="id" width="80"
             invisiblemode="cleared">
            </njx:fielditem>
        </njx:fieldlist>
    </itr>
    <itr>
        <njx:fieldlist fieldlistprop="columns" fieldcount="5"
         hdist="10">
            <njx:fielditem valueprop="last" width="130"
             invisiblemode="invisible">
            </njx:fielditem>
        </njx:fieldlist>
    </itr>
    <itr>
        <njx:fieldlist fieldlistprop="columns" fieldcount="5"
         hdist="40">
            <njx:fielditem valueprop="first" width="100"
             invisiblemode="invisible">
            </njx:fielditem>
        </njx:fieldlist>
    </itr>
</rowarea>
<rowarea name="Simple Field List">
    <itr>
        <njx:fieldlist fieldlistprop="simple" fieldcount="10">
            <njx:fieldvalue width="50">
            </njx:fieldvalue>
        </njx:fieldlist>
    </itr>
</rowarea>

Top of page

Adapter Interface

1 COLUMNS (1:*)
2 FIRST (A) DYNAMIC
2 ID (A) DYNAMIC
2 LAST (A) DYNAMIC
2 STATUS (A) DYNAMIC
1 SIMPLE (A/1:*) DYNAMIC

For all NJX:FIELDLIST controls that are bound to the same value in fieldlistprop (here: columns), one common structure array is generated (here: COLUMNS).

For each NJX:FIELDITEM control, an element in the structure is generated according to the value bound in valueprop (here: FIRST, ID and LAST).

For each occurrence of the structure array, a parameter with the fixed name STATUS is generated. This parameter can be used to control the status of the elements in a similar way as it is done with the statusprop of the FIELD control.

For a simple field list (one that contains an NJX:FIELDVALUE control), a simple array is generated according to the value bound in valueprop (here: SIMPLE).

Top of page

Built-in Events

The fields in the NJX:FIELDLIST control (NJX:FIELDITEM controls or NJX:FIELDVALUE controls) behave like FIELD controls.

Top of page

Properties

Basic
fieldlistprop

Name of the adapter parameter that represents the control in the adapter.

Obligatory  
fieldcount

Maximum count of fields in the fieldlist. If no fieldcount is defined then a default of 10 is assigned.

Optional  
hdist

Horizontal distance between the fields Can be specified either in pixels or as percentage value.

If no width is defined then a default width of 2 pixels is assigned.

Optional  
njx:natname

If a Natural variable with a name not valid for Application Designer (for instance #FIELD1) shall be bound to the control, a different name (for instance HFIELD1) can be bound instead. If the original name (in this case #FIELD1) is then specified in this attribute, the original name is generated into the parameter data area of the Natural adapter and a mapping between the two names is generated into the PROCESS PAGE statement of the Natural adapter. This mapping must not break a once defined group structure. If for instance a grid control that is bound to a name of GRID1 contains fields that are bound to FIELD1 and FIELD2 respectively, the corresponding njx:natname values may be #GRID1.#FIELD1 and #GRID1.#FIELD2, but not #GRID1.#FIELD1 and #MYGRID1.#FIELD2.

Optional  
njx:natcomment

The value of this attribute is generated as comment line into the parameter data area of the Natural adapter, before the field name. The Map Converter, for instance, uses this attributes to indicate for a generated statusprop variable to which field the statusprop belongs.

Optional  

Top of page