autocomplete_deluxe.api.php

<?php
// $Id$

/**
 * @file
 * This contains documentation only.
 */

/**
 * Using the Autocomplete Deluxe element.
 *
 * When you want to use the Autocomplete Deluxe element, you have to choose
 * between two types sources for the suggestion data: Ajax Callbacks or Lists.
 * You can set the source type by using the appropriate options:
 * - #autocomplete_deluxe_path expects a string with an url, that points to the ajax
 *   callback. The response should be encoded as json(like for the core
 *   autocomplete).
 * - #autocomplete_options needs an array in the form of an array(similar to #options in core
 *   for selects or checkboxes): array('a', 'b', 'c') or array(1 => 'a', 2 =>
 *   'b', 3 => 'c').
 *
 * Besides this two, there are three other options, wich autocomplete deluxe
 * accepts:
 * - #multiple Indicates whether the user may select more than one item. Expects
 *   TRUE or FALSE, by default it is set to FALSE.
 * - #autocomplete_multiple_delimiter If #multiple is TRUE, then you can use
 *   this option to set a seperator for multiple values. By default a string
 *   with the follwing content will be used: ', '.
 * - #autocomplete_min_length Indicates how many characters must be entered
 *   until, the suggesion list can be opened. Especially helpfull, when your
 *   ajax callback returns only valid suggestion for a minimum characters.
 *   The default is 0.
 */
function somefunction() {
  switch ($type) {
    case 'list':
      $element = array(
        '#type' => 'autocomplete_deluxe',
        '#autocomplete_options' => $options,
        '#multiple' => FALSE,
        '#autocomplete_min_length' => 0,
      );
      break;
    case 'ajax':
      $element = array(
        '#type' => 'autocomplete_deluxe',
        '#autocomplete_deluxe_path' => url('some_uri', array('absolute' => TRUE)),
        '#multiple' => TRUE,
        '#autocomplete_min_length' => 1,
        '#autocomplete_multiple_delimiter' => '|',
      );
      break;
  }
}