ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / letacommog / letaweb / protected / extensions / yiibooster / widgets

<?php
/**
 *## TbRelationalColumn class file
 *
 * @author: antonio ramirez <antonio@clevertech.biz>
 * @copyright Copyright &copy; Clevertech 2012-
 * @license http://www.opensource.org/licenses/bsd-license.php New BSD License
 */

/**
 *## TbRelationalColumn class
 *
 * Displays a clickable column that will make an ajax request and display its resulting data
 * into a new row.
 *
 * @package booster.widgets.grids.columns
 */
class TbRelationalColumn extends TbDataColumn {
	
	/**
	 * @var string $url the route to call via AJAX to get the data from
	 */
	public $url;

/**
	 * @var string $cssClass the class name that will wrap up the cell content.
	 * Important Note: this class will be used as the trigger for the AJAX call, so make sure is unique for the
	 * column.
	 */
	public $cssClass = 'tbrelational-column';

/**
	 * @var bool $cacheData if set to true, there won't be more than one AJAX request. If set to false, the widget will
	 * continuously make AJAX requests. This is useful if the data could vary. If the data doesn't change then is better
	 * to set it to true. Defaults to true.
	 */
	public $cacheData = true;

/**
	 * @var string a javascript function that will be invoked if an AJAX call occurs.
	 *
	 * The function signature is <code>function(tr, rowid, data)</code>
	 * <ul>
	 * <li><code>tr</code> is the newly created TR HTML object that will display the returned server data.</li>
	 * <li><code>rowid</code> the model id of the row.</li>
	 * <li><code>data</code> is the data returned by the server that is already displayed on the row.</li>
	 * </ul>
	 * Note: This handler is not called for JSONP requests.
	 *
	 * Example (add in a call to TbRelationalColumn):
	 * <pre>
	 *  ...
	 *  'afterAjaxUpdate'=>'js:function(tr,rowid, data){ console.log(rowid); }',
	 *  ...
	 * </pre>
	 */
	public $afterAjaxUpdate;

/**
	 * @var string $ajaxErrorMessage the message that is displayed on the newly created row in case there is an AJAX
	 * error.
	 */
	public $ajaxErrorMessage = 'Error';
	
	/**
	 * @var array $submitData allows you to merge extra data into the query string being sent to the server.
	 * normally the row id is sent as 'id'
	 */
	public $submitData=array();

/**
	 * widget initialization
	 */
	public function init() {
		
		parent::init();

if (empty($this->url))
			$this->url = Yii::app()->getRequest()->requestUri;

$this->registerClientScript();
	}

/**
	 * Overrides CDataColumn renderDataCell in order to wrap up its content with the object that will be used as a
	 * trigger.
	 * Important: Making use of links as a content for this of column is an error.
	 *
	 * @param int $row
	 */
	public function renderDataCell($row) {
		
		$data = $this->grid->dataProvider->data[$row];
		$options = $this->htmlOptions;

if ($this->cssClassExpression !== null) {
			$class = $this->evaluateExpression($this->cssClassExpression, array('row' => $row, 'data' => $data));
			if (isset($options['class'])) {
				$options['class'] .= ' ' . $class;
			} else {
				$options['class'] = $class;
			}
		}

echo CHtml::openTag('td', $options);
		echo CHtml::openTag('span', array('class' => $this->cssClass, 'data-rowid' => $this->getPrimaryKey($data)));
		$this->renderDataCellContent($row, $data);
		echo CHtml::closeTag('span');
		echo CHtml::closeTag('td');
	}

/**
	 * Helper function to return the primary key of the $data
	 *  * IMPORTANT: composite keys on CActiveDataProviders will return the keys joined by two dashes: `--`
	 *
	 * @param CActiveRecord $data
	 *
	 * @return null|string
	 */
	protected function getPrimaryKey($data) {
		
		if ($this->grid->dataProvider instanceof CActiveDataProvider) {
			$key = $this->grid->dataProvider->keyAttribute === null ? $data->getPrimaryKey()
				: $data->{$this->grid->dataProvider->keyAttribute};
			return is_array($key) ? implode('--', $key) : $key;
		}

if ($this->grid->dataProvider instanceof CArrayDataProvider || $this->grid->dataProvider instanceof CSqlDataProvider) {
			return is_object($data) ? $data->{$this->grid->dataProvider->keyField}
				: $data[$this->grid->dataProvider->keyField];
		}

return null;
	}

/**
	 * Register script that will handle its behavior
	 */
	public function registerClientScript() {
		
        Booster::getBooster()->registerAssetCss('bootstrap-relational.css');

/** @var $cs CClientScript */
		$cs = Yii::app()->getClientScript();
		if ($this->afterAjaxUpdate !== null) {
			if ((!$this->afterAjaxUpdate instanceof CJavaScriptExpression)
				&& (strpos($this->afterAjaxUpdate,'js:') !== 0)
			) {
				$this->afterAjaxUpdate = new CJavaScriptExpression($this->afterAjaxUpdate);
			}
		} else {
			$this->afterAjaxUpdate = 'js:$.noop';
		}

$this->ajaxErrorMessage = CHtml::encode($this->ajaxErrorMessage);
		$afterAjaxUpdate = CJavaScript::encode($this->afterAjaxUpdate);
		$span = count($this->grid->columns);
		$loadingPic = CHtml::image(Booster::getBooster()->getAssetsUrl() . '/img/loading.gif');
		$cache = $this->cacheData ? 'true' : 'false';
		$data = !empty($this->submitData) && is_array($this->submitData) ? $this->submitData : 'js:{}';
		$data = CJavascript::encode($data);
		list($parentId) = explode('_',$this->id);
		$js = <<<EOD
$(document).on('click','#{$parentId} .{$this->cssClass}', function(){
	var span = $span;
	var that = $(this);
	var status = that.data('status');
	var rowid = that.data('rowid');
	var tr = $('#relatedinfo'+rowid);
	var parent = that.parents('tr').eq(0);
	var afterAjaxUpdate = {$afterAjaxUpdate};

if (status && status=='on'){return}
	that.data('status','on');

if (tr.length && !tr.is(':visible') && {$cache})
	{
		tr.slideDown();
		that.data('status','off');
		return;
	}else if (tr.length && tr.is(':visible'))
	{
		tr.slideUp();
		that.data('status','off');
		return;
	}
	if (tr.length)
	{
		tr.find('td').html('{$loadingPic}');
		if (!tr.is(':visible')){
			tr.slideDown();
		}
	}
	else
	{
		var td = $('<td/>').html('{$loadingPic}').attr({'colspan':$span});
		tr = $('<tr/>').prop({'id':'relatedinfo'+rowid}).append(td);
		/* we need to maintain zebra styles :) */
		var fake = $('<tr class="hide"/>').append($('<td/>').attr({'colspan':$span}));
		parent.after(tr);
		tr.after(fake);
	}
	var data = $.extend({$data}, {id:rowid});
	$.ajax({
		url: '{$this->url}',
		data: data,
		success: function(data){
			tr.find('td').html(data);
			that.data('status','off');
			if ($.isFunction(afterAjaxUpdate))
			{
				afterAjaxUpdate(tr,rowid,data);
			}
		},
		error: function()
		{
			tr.find('td').html('{$this->ajaxErrorMessage}');
			that.data('status','off');
		}
	});
});
EOD;
		$cs->registerScript(__CLASS__ . '#' . $this->id, $js);
	}
}

[+] ..
[-] TbTabView.php [edit]
[-] TbNavbar.php [edit]
[-] TbHighCharts.php [edit]
[-] TbPager.php [edit]
[-] TbLabel.php [edit]
[-] TbActiveForm.php [edit]
[-] TbPanel.php [edit]
[-] TbJsonButtonColumn.php [edit]
[-] TbModalManager.php [edit]
[-] TbToggleColumn.php [edit]
[-] TbUiLayout.php [edit]
[-] TbBaseMenu.php [edit]
[-] widgets.md [edit]
[-] TbEditableDetailView.php [edit]
[-] TbButtonGroup.php [edit]
[-] TbEditable.php [edit]
[-] TbFileUpload.php [edit]
[-] TbEditableField.php [edit]
[-] TbTags.php [edit]
[-] TbFormButtonElement.php [edit]
[-] TbFormInputElement.php [edit]
[-] TbJsonPager.php [edit]
[-] TbCollapse.php [edit]
[-] TbBulkActions.php [edit]
[-] TbRelationalColumn.php [edit]
[-] TbTabs.php [edit]
[-] TbModal.php [edit]
[-] TbExtendedGridView.php [edit]
[-] TbJumbotron.php [edit]
[-] TbImageGallery.php [edit]
[-] TbWidget.php [edit]
[-] TbMenu.php [edit]
[-] TbProgress.php [edit]
[-] TbButtonColumn.php [edit]
[-] TbJsonToggleColumn.php [edit]
[-] TbJsonPickerColumn.php [edit]
[-] TbColorPicker.php [edit]
[-] TbButtonGroupColumn.php [edit]
[-] TbSwitch.php [edit]
[-] TbHeroUnit.php [edit]
[-] TbDatePicker.php [edit]
[-] TbJsonCheckBoxColumn.php [edit]
[-] TbButton.php [edit]
[-] TbTypeahead.php [edit]
[-] TbForm.php [edit]
[-] TbPassfield.php [edit]
[-] TbEditableColumn.php [edit]
[-] TbMarkdownEditorJs.php [edit]
[-] TbPopoverColumn.php [edit]
[-] TbMarkdownEditor.php [edit]
[-] TbAlert.php [edit]
[-] TbGroupGridView.php [edit]
[-] TbBaseInputWidget.php [edit]
[-] TbWizard.php [edit]
[-] TbGroupButtonColumn.php [edit]
[-] TbExtendedFilter.php [edit]
[-] TbGoogleVisualizationChart.php [edit]
[-] TbHtml5Editor.php [edit]
[-] TbGridView.php [edit]
[-] TbListView.php [edit]
[-] TbTimePicker.php [edit]
[-] TbJsonGridView.php [edit]
[-] TbCKEditor.php [edit]
[-] TbTotalSumColumn.php [edit]
[-] TbDateRangePicker.php [edit]
[-] TbBadge.php [edit]
[-] TbDropdown.php [edit]
[-] TbBreadcrumbs.php [edit]
[-] TbJsonGridColumn.php [edit]
[-] TbDateTimePicker.php [edit]
[-] TbDataColumn.php [edit]
[-] TbCarousel.php [edit]
[-] TbJsonDataColumn.php [edit]
[-] TbRedactorJs.php [edit]
[-] TbThumbnails.php [edit]
[-] TbScrollSpy.php [edit]
[-] TbDetailView.php [edit]
[+] input
[-] TbSelect2.php [edit]
[-] TbImageColumn.php [edit]