Autocomplete an input field to enable users quickly finding and selecting some value from a set provided by the server. By giving an autocompleted field focus or entering something into it, the plugin starts searching for matching entries and displays a list of values to choose from. By entering more characters, the user can filter down the list to better matches. This can be used to enter previous selected values, eg. for tags, to complete an address, eg. enter a city name and get the zip code, or maybe enter email addresses from an addressbook.
See also JQueryjaxHelper for examples on how to integrate autocompletion into Foswiki. Caution: the original author of this plugin discontinued to support this plugin. A replacement has been added to the JQueryUI package. Here is a Migration Guide for the autocompletion plugin.autocomplete
attribute value does not equal off
.
It can either be list of candidate values, or an URL, in which case candidate values are queried from an AJAX backend.
The current input prefix is provided via the q
URL parameter. The backend must return a list of matching values
separated by newlines.
data
section of this topic.
See also JQueryTextboxList
First, here's the set of values we want to pick from: Here's the code that the client browser runs:
%STARTSECTION{"data"}%%SEARCH{ "^ \* (%ENCODE{"%URLPARAM{"q"}%" old="$comma, " new="|,"}%).*$" web="%WEB%" topic="%TOPIC%" type="regex" multiple="on" nonoise="on" format=" $pattern(.*?\* ([^ ]*).*) " separator="$n" }% %ENDSECTION{"data"}%
%STARTSECTION{"data_fp"}%%FORMATLIST{ " backup bash emulation games irc linux mercurial patches perl php python site surfing tag test foswiki web wiki windows windsurfing wine " include=".*%URLPARAM{"q"}%.*" split="\n" format=" $1 " separator="$n" }%%ENDSECTION{"data_fp"}%