* @link http://www.pradosoft.com/
* @copyright Copyright © 2013-2014 PradoSoft
* @license http://www.pradosoft.com/license/
* @package System.Web.UI.JuiControls
*/
Prado::using('System.Web.UI.JuiControls.TJuiControlAdapter');
Prado::using('System.Web.UI.ActiveControls.TActivePanel');
/**
* TJuiSortable class.
*
*
*
*
*
*
*
* $this->repeater1->DataSource=array('home', 'office', 'car', 'boat', 'plane');
* $this->repeater1->dataBind();
*
*
* @author Fabio Bas
* @package System.Web.UI.JuiControls
* @since 3.3
*/
class TJuiSortable extends TActivePanel implements IJuiOptions, ICallbackEventHandler
{
protected $_options;
/**
* Creates a new callback control, sets the adapter to
* TActiveControlAdapter. If you override this class, be sure to set the
* adapter appropriately by, for example, by calling this constructor.
*/
public function __construct()
{
parent::__construct();
$this->setAdapter(new TJuiControlAdapter($this));
}
/**
* Object containing defined javascript options
* @return TJuiControlOptions
*/
public function getOptions()
{
if($this->_options===null)
$this->_options=new TJuiControlOptions($this);
return $this->_options;
}
/**
* Array containing valid javascript options
* @return array()
*/
public function getValidOptions()
{
return array('appendTo', 'axis', 'cancel', 'connectWith', 'containment', 'cursor', 'cursorAt', 'delay', 'disabled', 'distance', 'dropOnEmpty', 'forceHelperSize', 'forcePlaceholderSize', 'grid', 'handle', 'helper', 'items', 'opacity', 'placeholder', 'revert', 'scroll', 'scrollSensitivity', 'scrollSpeed', 'tolerance', 'zIndex');
}
/**
* Array containing valid javascript events
* @return array()
*/
public function getValidEvents()
{
return array('activate', 'beforeStop', 'change', 'create', 'deactivate', 'out', 'over', 'receive', 'remove', 'sort', 'start', 'stop', 'update');
}
/**
* @return array list of callback options.
*/
protected function getPostBackOptions()
{
$options = $this->getOptions()->toArray();
$options['stop'] = new TJavaScriptLiteral("function( event, ui ) { Prado.Callback(".TJavascript::encode($this->getUniqueID()).", { 'order' : jQuery(this).sortable('toArray') }) }");
return $options;
}
/**
* Ensure that the ID attribute is rendered and registers the javascript code
* for initializing the active control.
*/
protected function addAttributesToRender($writer)
{
parent::addAttributesToRender($writer);
$writer->addAttribute('id',$this->getClientID());
$options=TJavascript::encode($this->getPostBackOptions());
$cs=$this->getPage()->getClientScript();
$code="jQuery('#".$this->getClientId()."_0').sortable(".$options.");";
$cs->registerEndScript(sprintf('%08X', crc32($code)), $code);
}
/**
* Raises callback event. This method is required bu {@link ICallbackEventHandler}
* interface.
* It raises the {@link onSort onSort} event, then, the {@link onCallback OnCallback} event
* This method is mainly used by framework and control developers.
* @param TCallbackEventParameter the parameter associated with the callback event
*/
public function raiseCallbackEvent($param)
{
$this->onSort($param->getCallbackParameter());
$this->onCallback($param);
}
/**
* Raises the onSort event.
* The order parameters are encapsulated into a {@link TJuiSortableEventParameter}
*
* @param object $params
*/
public function onSort($params)
{
$this->raiseEvent('onSort', $this, new TJuiSortableEventParameter ($this->getResponse(), $params));
}
/**
* This method is invoked when a callback is requested. The method raises
* 'OnCallback' event to fire up the event handlers. If you override this
* method, be sure to call the parent implementation so that the event
* handler can be invoked.
* @param TCallbackEventParameter event parameter to be passed to the event handlers
*/
public function onCallback($param)
{
$this->raiseEvent('OnCallback', $this, $param);
}
/**
* @var ITemplate template for repeater items
*/
private $_repeater=null;
/**
* @param array data source for Sortables.
*/
public function setDataSource($data)
{
$this->getSortables()->setDataSource($data);
}
/**
* Overrides parent implementation. Callback {@link renderSortables()} when
* page's IsCallback property is true.
*/
public function dataBind()
{
parent::dataBind();
if($this->getPage()->getIsCallback())
$this->renderSortables($this->getResponse()->createHtmlWriter());
}
/**
* @return TRepeater suggestion list repeater
*/
public function getSortables()
{
if($this->_repeater===null)
$this->_repeater = $this->createRepeater();
return $this->_repeater;
}
/**
* @return TRepeater new instance of TRepater to render the list of Sortables.
*/
protected function createRepeater()
{
$repeater = Prado::createComponent('System.Web.UI.WebControls.TRepeater');
$repeater->setHeaderTemplate(new TJuiSortableTemplate(''));
$repeater->setFooterTemplate(new TJuiSortableTemplate('
'));
$repeater->setItemTemplate(new TTemplate('<%# $this->Data %>',null));
$repeater->setEmptyTemplate(new TJuiSortableTemplate(''));
$this->getControls()->add($repeater);
return $repeater;
}
}
/**
* TJuiSortableTemplate class.
*
* TJuiSortableTemplate is the default template for TJuiSortableTemplate
* item template.
*
* @author Wei Zhuo
* @package System.Web.UI.ActiveControls
* @since 3.1
*/
class TJuiSortableTemplate extends TComponent implements ITemplate
{
private $_template;
public function __construct($template)
{
$this->_template = $template;
}
/**
* Instantiates the template.
* It creates a {@link TDataList} control.
* @param TControl parent to hold the content within the template
*/
public function instantiateIn($parent)
{
$parent->getControls()->add($this->_template);
}
}
/**
* TJuiSortableEventParameter class
*
* TJuiSortableEventParameter encapsulate the parameter
* data for OnSort event of TJuiSortable components
*
* @author Fabio Bas
* @license http://www.pradosoft.com/license
* @package System.Web.UI.JuiControls
*/
class TJuiSortableEventParameter extends TCallbackEventParameter
{
public function getOrder() { return $this->getCallbackParameter()->order; }
}