Auto-complete, also referred to as auto-suggest, is a feature that suggests values in a dropdown list as you type into a textbox. In Profound UI, textbox widgets have a set of auto-complete properties that can either provide a static suggestion list or link to a database for suggestions.
To enable scrolling for the auto-complete choices, you must specify the 'max height' property for the textbox.
Auto-Complete Choices
These properties allow you to provide a static or program provided list of auto-complete choices.
Choices
Specifies the options for a textbox with auto-complete. The options should be comma separated. Options cannot be empty.
Promptable? YES
Possible Values: Comma separated list of valid choices
Bindable? YES
Product: ProfoundUI, Genie
Choice Values
Specifies alternate option values to send to the application for a textbox with auto-complete. The values should be comma separated. Options cannot be empty.
Promptable? YES
Possible Values: Comma separated list of valid values to be returned to application.
Bindable? YES
Product: ProfoundUI, Genie
Database-Driven Auto-Complete
These properties allow you to provide the needed information to retrieve the list of auto-complete choices from a database file.
Choices Database File
Database file to be used for a dynamic database-driven textbox with auto-complete.
Promptable? NO
Possible Values: Any valid database file name. Can be specified with library in 'LIBRARY/FILE' format.
Bindable? YES
Product: ProfoundUI, Genie
Choice Options Field
Database field name used to retrieve the options for a textbox with autocomplete. Multiple fields can be specified and should be comma separated.
Promptable? YES
Possible Values: Any valid database field name(s) from the Choices Database File
Bindable? YES
Product: ProfoundUI, Genie
Choice Values Field
Database field name used to retrieve the values sent back to the application. If omitted, the choice options field is used. If multiple option fields were specified, the first option field is returned.
Promptable? YES
Possible Values: Any valid database field name from the Choices Database File
Bindable? YES
Product: ProfoundUI, Genie
Choices Selection Criteria
Optional expression identifying which records should be retrieved from the choices database file.
Promptable? YES
Possible Values: Any valid selection criteria for the Choices Database File. Selection criteria should be formatted like a SQL "Where" clause.
Bindable? YES
Product: ProfoundUI, Genie
Max Choices
Optional maximum number of choices to provide for auto-complete. This property controls the size of the auto-complete dropdown list. If not set it defaults to 10.
Promptable? NO
Possible Values: Any positive integer value
Bindable? YES
Product: ProfoundUI, Genie
Contains Match
When set to true, the auto-complete query finds records that contain the search text. When set to false, the auto-complete query finds records that start with the search text. The default is false.
Promptable? DROPDOWN
Possible Values: True, False
Bindable? YES
Product: ProfoundUI, Genie
Case Sensitive
When set to true, the auto-complete query does not convert the search text or database search column to upper case before comparing. When false, the database column and search text are converted to upper case before comparing. The default is false.
Promptable? DROPDOWN
Possible Values: True, False
Bindable? YES
Product: ProfoundUI, Genie
Dynamic Auto-Complete
This method allows auto-complete choices to be retrieved from a web service.
Choices URL
Sets the url to a Web service that returns the choice options and values in JSON format. The service can be provided with Profound Logic's RPGsp or another web development framework. RPGsp provides an easy to use platform for developing Web services using ILE RPG. If a choices url is used, the database file, choice options field, choice value field, and max choices properties are ignored. A POST parameter named "query" is automatically submitted to the URL that contains the current contents of the widget that is using this property; this is updated every time a request to the URL is made such as on every keystroke within the widget.
Promptable? YES
Possible Values: A valid web service URL
Bindable? YES
Product: ProfoundUI, Genie
Events
Onselect
Initiates a client-side script when a selection is made form the selection list of an auto-complete textbox or a combo box. In the case of an auto-complete textbox, the selected record is passed to the function as a JSON object that has properties named after the selected fields.
Promptable? YES
Possible Values: Any valid JavaScript code
Bindable? YES
Product: ProfoundUI, Genie