Description

The autocomplete tag is a combobox that can autocomplete text entered on the input box. If an action is used to populate the autocompleter, the output of the action must be a well formed JSON string.

The autocompleter follows this rule to find its datasource:

1. If the response is an array, assume that it contains 2-dimension array elements, like:

[
     ["Alabama", "AL"],
     ["Alaska", "AK"]
]

2. If a value is specified in the "dataFieldName" attribute, and the response has a field with that name, assume that's the datasource, which can be an array of 2-dimension array elements, or a map, like (assuming dataFieldName="state"):

{
     "state" : [
          ["Alabama","AL"],
          ["Alaska","AK"]
     ]
}     
or
{
     "state" : {
           "Alabama" : "AL",
           "Alaska" : "AK"
     }
}

3. If there is a field that starts with the value specified on the "name" attribute, assume that's the datasource, like (assuming name="state"):

{
     "states" : [
          ["Alabama","AL"],
          ["Alaska","AK"]
     ]
}

4. Use first array that is found, like:

{
     "anything" : [
           ["Alabama", "AL"],
           ["Alaska", "AK"]
    ]       
}

5. If the response is a map, use it (recommended as it is the easiest one to generate):

{
     "Alabama" : "AL",
     "Alaska" : "AK"
}

Parameters

Examples

Get list from an action:

Uses a list:

Autocompleter that reloads its content everytime the text changes (and the length of the text is greater than 3):

Linking two autocompleters:

Set/Get selected values using JavaScript:

Using beforeNotifyTopics:

Using errorNotifyTopics:

Using errorNotifyTopics:

Using valueNotifyTopics:

Caveats

• The service that is producing the HTTP Response with JSON response to the Autocompleter tag must set the HTTP Header Response Content-Type to text/json. JSON has its own MIME type, which this tag expects.

• Since 2.0.9, there is a change in the value:key order. Now, the value must come before the key.