-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Welcome to the Wiki page for SAR (Smart Auto-Complete). Read on for more information.
Like any other auto-complete script, SAR will show a list of matching strings as the user types into the search field. A result can be selected with the mouse or the keyboard (using the up/down arrow keys and then pressing Enter).
SAR handles searching on multiple columns of a database by allowing you to present each field separately with its own markup. It also handles cases where a column contains an empty result (is null) and allows you to specify a replacement string for each column.
If SAR is used inside a form that creates records and certain fields are pulled from other tables, SAR can be used to search them. If, however, the user cannot find the correct matching record because it does not exist, SAR can be used to add missing information on all columns that are being searched (partially or all fields). The information is added through hidden input fields and can be accessed when the form is submitted. No need to go add the missing information first!
Don’t hose your server down with wasted queries; SAR sends requests only on certain conditions:
- A minimum number of characters has been entered
- A minimum amount of time has passed between two requests
- The search string is different from the previous request
- jQuery 1.3.x
- Backend capable of outputting JSON