method

auto_complete_field

v1.0.0 - Show latest stable - Class: ActionView::Helpers::JavaScriptMacrosHelper

auto_complete_field(field_id, options = {})

public

Adds AJAX autocomplete functionality to the text input field with the DOM ID specified by field_id.

This function expects that the called action returns a HTML <ul> list, or nothing if no entries should be displayed for autocompletion.

You’ll probably want to turn the browser’s built-in autocompletion off, su be sure to include a autocomplete="off" attribute with your text input field.

Required options are:

:url: URL to call for autocompletion results in url_for format.

Addtional options are:

`:update:`	Specifies the DOM ID of the element whose innerHTML should be updated with the autocomplete entries returned by the AJAX request. Defaults to field_id + ‘_auto_complete’
`:with:`	A JavaScript expression specifying the parameters for the XMLHttpRequest. This defaults to ‘fieldname=value’.
`:indicator:`	Specifies the DOM ID of an element which will be displayed while autocomplete is running.
`:tokens:`	A string or an array of strings containing separator tokens for tokenized incremental autocompletion. Example: `:tokens => ','` would allow multiple autocompletion entries, separated by commas.
`:min_chars:`	The minimum number of characters that should be in the input field before an Ajax call is made to the server.
`:on_hide:`	A Javascript expression that is called when the autocompletion div is hidden. The expression should take two variables: element and update. Element is a DOM element for the field, update is a DOM element for the div from which the innerHTML is replaced.
`:on_show:`	Like on_hide, only now the expression is called then the div is shown.

# File actionpack/lib/action_view/helpers/java_script_macros_helper.rb, line 108
      def auto_complete_field(field_id, options = {})
        function =  "new Ajax.Autocompleter("
        function << "'#{field_id}', "
        function << "'" + (options[:update] || "#{field_id}_auto_complete") + "', "
        function << "'#{url_for(options[:url])}'"
        
        js_options = {}
        js_options[:tokens] = array_or_string_for_javascript(options[:tokens]) if options[:tokens]
        js_options[:callback]   = "function(element, value) { return #{options[:with]} }" if options[:with]
        js_options[:indicator]  = "'#{options[:indicator]}'" if options[:indicator]
        {:on_show => :onShow, :on_hide => :onHide, :min_chars => :min_chars}.each do |k,v|
          js_options[v] = options[k] if options[k]
        end
        function << (', ' + options_for_javascript(js_options) + ')')

        javascript_tag(function)
      end

2Notes

Moved to plugin "auto_complete"

Vidmantas · Aug 4, 20081 thank

This helper was moved to plugin "auto_complete" - http://svn.rubyonrails.org/rails/plugins/auto_complete/

Installation

Lauer · Nov 21, 2008

Install the plugin by typing script/plugin install auto_complete

Remember to restart webservice :)

auto_complete_field

2Notes

Moved to plugin "auto_complete"

Installation

Related methods