98 lines
3.1 KiB
PHP
98 lines
3.1 KiB
PHP
<?php
|
|
/**
|
|
* CJuiAutoComplete class file.
|
|
*
|
|
* @author Sebastian Thierer <sebathi@gmail.com>
|
|
* @link http://www.yiiframework.com/
|
|
* @copyright 2008-2013 Yii Software LLC
|
|
* @license http://www.yiiframework.com/license/
|
|
*/
|
|
|
|
Yii::import('zii.widgets.jui.CJuiInputWidget');
|
|
|
|
/**
|
|
* CJuiAutoComplete displays an autocomplete field.
|
|
*
|
|
* CJuiAutoComplete encapsulates the {@link http://jqueryui.com/autocomplete/ JUI
|
|
* autocomplete} plugin.
|
|
*
|
|
* To use this widget, you may insert the following code in a view:
|
|
* <pre>
|
|
* $this->widget('zii.widgets.jui.CJuiAutoComplete',array(
|
|
* 'name'=>'city',
|
|
* 'source'=>array('ac1','ac2','ac3'),
|
|
* // additional javascript options for the autocomplete plugin
|
|
* 'options'=>array(
|
|
* 'minLength'=>'2',
|
|
* ),
|
|
* 'htmlOptions'=>array(
|
|
* 'style'=>'height:20px;',
|
|
* ),
|
|
* ));
|
|
* </pre>
|
|
*
|
|
* By configuring the {@link options} property, you may specify the options
|
|
* that need to be passed to the JUI autocomplete plugin. Please refer to
|
|
* the {@link http://api.jqueryui.com/autocomplete/ JUI AutoComplete API}
|
|
* documentation for possible options (name-value pairs) and
|
|
* {@link http://jqueryui.com/autocomplete/ JUI AutoComplete page} for
|
|
* general description and demo.
|
|
*
|
|
* By configuring the {@link source} property, you may specify where to search
|
|
* the autocomplete options for each item. If source is an array, the list is
|
|
* used for autocomplete. You may also configure {@link sourceUrl} to retrieve
|
|
* autocomplete items from an ajax response.
|
|
*
|
|
* @author Sebastian Thierer <sebathi@gmail.com>
|
|
* @package zii.widgets.jui
|
|
* @since 1.1.2
|
|
*/
|
|
class CJuiAutoComplete extends CJuiInputWidget
|
|
{
|
|
/**
|
|
* @var mixed the entries that the autocomplete should choose from. This can be
|
|
* <ul>
|
|
* <li>an Array with local data</li>
|
|
* <li>a String, specifying a URL that returns JSON data as the entries.</li>
|
|
* <li>a javascript callback. Please make sure you wrap the callback with
|
|
* {@link CJavaScriptExpression} in this case.</li>
|
|
* </ul>
|
|
*/
|
|
public $source=array();
|
|
/**
|
|
* @var mixed the URL that will return JSON data as the autocomplete items.
|
|
* CHtml::normalizeUrl() will be applied to this property to convert the property
|
|
* into a proper URL. When this property is set, the {@link source} property will be ignored.
|
|
*/
|
|
public $sourceUrl;
|
|
|
|
/**
|
|
* Run this widget.
|
|
* This method registers necessary javascript and renders the needed HTML code.
|
|
*/
|
|
public function run()
|
|
{
|
|
list($name,$id)=$this->resolveNameID();
|
|
|
|
if(isset($this->htmlOptions['id']))
|
|
$id=$this->htmlOptions['id'];
|
|
else
|
|
$this->htmlOptions['id']=$id;
|
|
if(isset($this->htmlOptions['name']))
|
|
$name=$this->htmlOptions['name'];
|
|
|
|
if($this->hasModel())
|
|
echo CHtml::activeTextField($this->model,$this->attribute,$this->htmlOptions);
|
|
else
|
|
echo CHtml::textField($name,$this->value,$this->htmlOptions);
|
|
|
|
if($this->sourceUrl!==null)
|
|
$this->options['source']=CHtml::normalizeUrl($this->sourceUrl);
|
|
else
|
|
$this->options['source']=$this->source;
|
|
|
|
$options=CJavaScript::encode($this->options);
|
|
Yii::app()->getClientScript()->registerScript(__CLASS__.'#'.$id,"jQuery('#{$id}').autocomplete($options);");
|
|
}
|
|
}
|