/yii/framework/zii/widgets/jui/CJuiSortable.php
PHP | 86 lines | 21 code | 7 blank | 58 comment | 0 complexity | 0041bbccd901f7cfef661300be8ec360 MD5 | raw file
Possible License(s): BSD-2-Clause, BSD-3-Clause, LGPL-2.1
- <?php
- /**
- * CJuiSortable class file.
- *
- * @author Sebastian Thierer <sebathi@gmail.com>
- * @link http://www.yiiframework.com/
- * @copyright Copyright © 2008-2010 Yii Software LLC
- * @license http://www.yiiframework.com/license/
- */
- Yii::import('zii.widgets.jui.CJuiWidget');
- /**
- * CJuiSortable displays an accordion widget.
- *
- * CJuiSortable encapsulates the {@link http://jqueryui.com/demos/sortable/ JUI Sortable}
- * plugin.
- *
- * To use this widget, you may insert the following code in a view:
- * <pre>
- * $this->widget('zii.widgets.jui.CJuiSortable', array(
- * 'items'=>array(
- * 'id1'=>'Item 1',
- * 'id2'=>'Item 2',
- * 'id3'=>'Item 3',
- * ),
- * // additional javascript options for the accordion plugin
- * 'options'=>array(
- * 'delay'=>'300',
- * ),
- * ));
- * </pre>
- *
- * By configuring the {@link options} property, you may specify the options
- * that need to be passed to the JUI Sortable plugin. Please refer to
- * the {@link http://jqueryui.com/demos/sortable/ JUI Sortable} documentation
- * for possible options (name-value pairs).
- *
- * If you are using javascript code anywhere in the code, please add "js:" at the
- * start of the js code definition and Yii will use this string as js code.
- *
- * @author Sebastian Thierer <sebathi@gmail.com>
- * @version $Id: CJuiSortable.php 2326 2010-08-20 17:02:07Z qiang.xue $
- * @package zii.widgets.jui
- * @since 1.1
- */
- class CJuiSortable extends CJuiWidget
- {
- /**
- * @var array list of sortable items (id=>item content).
- * Note that the item contents will not be HTML-encoded.
- */
- public $items=array();
- /**
- * @var string the name of the container element that contains all items. Defaults to 'ul'.
- */
- public $tagName='ul';
- /**
- * @var string 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.
- */
- public $itemTemplate='<li id="{id}">{content}</li>';
- /**
- * Run this widget.
- * This method registers necessary javascript and renders the needed HTML code.
- */
- public function run()
- {
- $id=$this->getId();
- $this->htmlOptions['id']=$id;
- $options=empty($this->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);
- }
- }