CJuiSortable

$this->widget('zii.widgets.jui.CJuiSortable',array(
    'items'=>array(
        'id1'=>'Item 1',
        'id2'=>'Item 2',
        'id3'=>'Item 3',
    ),
    // additional javascript options for the JUI Sortable plugin
    'options'=>array(
        'delay'=>'300',
    ),
));

Property Details

itemTemplate property

public string $itemTemplate;

the template that is used to generated every sortable item. The token "{content}" in the template will be replaced with the item content, while "{id}" be replaced with the item ID.

items property

public array $items;

list of sortable items (id=>item content). Note that the item contents will not be HTML-encoded.

tagName property

public string $tagName;

the name of the container element that contains all items. Defaults to 'ul'.

Method Details

run() method

public void run()

public function run()
{
    $id=$this->getId();
    if(isset($this->htmlOptions['id']))
        $id=$this->htmlOptions['id'];
    else
        $this->htmlOptions['id']=$id;

    $options=CJavaScript::encode($this->options);
    Yii::app()->getClientScript()->registerScript(__CLASS__.'#'.$id,"jQuery('#{$id}').sortable({$options});");

    echo CHtml::openTag($this->tagName,$this->htmlOptions)."\n";
    foreach($this->items as $id=>$content)
        echo strtr($this->itemTemplate,array('{id}'=>$id,'{content}'=>$content))."\n";
    echo CHtml::closeTag($this->tagName);
}

Run this widget. This method registers necessary javascript and renders the needed HTML code.