Gecko [ ifk.uw.edu.pl ]

Name	Size	Permission
assets	[ DIR ]	drwxr-xr-x
IDataSource.php	507 B	-rw-r--r--
IItemDataRenderer.php	1.34 KB	-rw-r--r--
IListControlAdapter.php	1.22 KB	-rw-r--r--
IRepeatInfoUser.php	1.55 KB	-rw-r--r--
IStyleable.php	774 B	-rw-r--r--
TAccordion.php	16.08 KB	-rw-r--r--
TAccordionView.php	4.45 KB	-rw-r--r--
TAccordionViewCollection.php	1.57 KB	-rw-r--r--
TBaseDataList.php	5.45 KB	-rw-r--r--
TBaseValidator.php	19.79 KB	-rw-r--r--
TBoundColumn.php	7.11 KB	-rw-r--r--
TBulletStyle.php	913 B	-rw-r--r--
TBulletedList.php	12.14 KB	-rw-r--r--
TBulletedListDisplayMode.php	917 B	-rw-r--r--
TBulletedListEventParameter.ph...	993 B	-rw-r--r--
TButton.php	11.42 KB	-rw-r--r--
TButtonColumn.php	8.5 KB	-rw-r--r--
TButtonColumnType.php	791 B	-rw-r--r--
TButtonTag.php	705 B	-rw-r--r--
TButtonType.php	756 B	-rw-r--r--
TCaptcha.php	16.31 KB	-rw-r--r--
TCaptchaValidator.php	4 KB	-rw-r--r--
TCheckBox.php	15.02 KB	-rw-r--r--
TCheckBoxColumn.php	3.68 KB	-rw-r--r--
TCheckBoxItem.php	520 B	-rw-r--r--
TCheckBoxList.php	14.43 KB	-rw-r--r--
TCircleHotSpot.php	1.84 KB	-rw-r--r--
TClientScript.php	4.41 KB	-rw-r--r--
TClientSideValidationSummaryOp...	2.38 KB	-rw-r--r--
TColorPicker.php	6.83 KB	-rw-r--r--
TColorPickerClientSide.php	847 B	-rw-r--r--
TColorPickerMode.php	815 B	-rw-r--r--
TCompareValidator.php	7.5 KB	-rw-r--r--
TCompleteWizardStep.php	960 B	-rw-r--r--
TConditional.php	4.33 KB	-rw-r--r--
TContent.php	1.67 KB	-rw-r--r--
TContentDirection.php	811 B	-rw-r--r--
TContentPlaceHolder.php	1.73 KB	-rw-r--r--
TCustomValidator.php	4.46 KB	-rw-r--r--
TDataBoundControl.php	15.37 KB	-rw-r--r--
TDataGrid.php	48.32 KB	-rw-r--r--
TDataGridColumn.php	17.06 KB	-rw-r--r--
TDataGridColumnCollection.php	1.83 KB	-rw-r--r--
TDataGridCommandEventParameter...	2.06 KB	-rw-r--r--
TDataGridItem.php	3.62 KB	-rw-r--r--
TDataGridItemCollection.php	1.34 KB	-rw-r--r--
TDataGridItemEventParameter.ph...	1.4 KB	-rw-r--r--
TDataGridItemRenderer.php	539 B	-rw-r--r--
TDataGridPageChangedEventParam...	1.84 KB	-rw-r--r--
TDataGridPager.php	1.75 KB	-rw-r--r--
TDataGridPagerButtonType.php	1022 B	-rw-r--r--
TDataGridPagerEventParameter.p...	1.42 KB	-rw-r--r--
TDataGridPagerMode.php	1.04 KB	-rw-r--r--
TDataGridPagerPosition.php	1.16 KB	-rw-r--r--
TDataGridPagerStyle.php	7.44 KB	-rw-r--r--
TDataGridSortCommandEventParam...	1.93 KB	-rw-r--r--
TDataList.php	46.45 KB	-rw-r--r--
TDataListCommandEventParameter...	1.81 KB	-rw-r--r--
TDataListItem.php	3.29 KB	-rw-r--r--
TDataListItemCollection.php	1.06 KB	-rw-r--r--
TDataListItemEventParameter.ph...	1.16 KB	-rw-r--r--
TDataListItemRenderer.php	4.6 KB	-rw-r--r--
TDataRenderer.php	1.11 KB	-rw-r--r--
TDataSize.php	4.22 KB	-rw-r--r--
TDataSourceControl.php	1.36 KB	-rw-r--r--
TDataSourceSelectParameters.ph...	1.51 KB	-rw-r--r--
TDataSourceView.php	2.23 KB	-rw-r--r--
TDataTypeValidator.php	3.89 KB	-rw-r--r--
TDatePicker.php	26.21 KB	-rw-r--r--
TDatePickerClientScript.php	1.22 KB	-rw-r--r--
TDatePickerInputMode.php	746 B	-rw-r--r--
TDatePickerMode.php	1.08 KB	-rw-r--r--
TDatePickerPositionMode.php	766 B	-rw-r--r--
TDisplayStyle.php	994 B	-rw-r--r--
TDropDownList.php	4.58 KB	-rw-r--r--
TDropDownListColumn.php	10.06 KB	-rw-r--r--
TEditCommandColumn.php	7.97 KB	-rw-r--r--
TEmailAddressValidator.php	2.68 KB	-rw-r--r--
TExpression.php	1.42 KB	-rw-r--r--
TFileUpload.php	11.86 KB	-rw-r--r--
TFileUploadItem.php	4.03 KB	-rw-r--r--
TFlushOutput.php	2.25 KB	-rw-r--r--
TFont.php	8.93 KB	-rw-r--r--
TGravatar.php	4.65 KB	-rw-r--r--
THead.php	5 KB	-rw-r--r--
THeader1.php	675 B	-rw-r--r--
THeader2.php	675 B	-rw-r--r--
THeader3.php	675 B	-rw-r--r--
THeader4.php	674 B	-rw-r--r--
THeader5.php	674 B	-rw-r--r--
THeader6.php	674 B	-rw-r--r--
THiddenField.php	5.82 KB	-rw-r--r--
THorizontalAlign.php	921 B	-rw-r--r--
THotSpot.php	8.73 KB	-rw-r--r--
THotSpotCollection.php	1.02 KB	-rw-r--r--
THotSpotMode.php	901 B	-rw-r--r--
THtmlArea.php	12.41 KB	-rw-r--r--
THtmlArea5.php	11.53 KB	-rw-r--r--
THtmlElement.php	1.62 KB	-rw-r--r--
THyperLink.php	7.41 KB	-rw-r--r--
THyperLinkColumn.php	7.61 KB	-rw-r--r--
TImage.php	4.29 KB	-rw-r--r--
TImageButton.php	11.67 KB	-rw-r--r--
TImageClickEventParameter.php	1.52 KB	-rw-r--r--
TImageMap.php	6.86 KB	-rw-r--r--
TImageMapEventParameter.php	1.06 KB	-rw-r--r--
TInlineFrame.php	7.89 KB	-rw-r--r--
TInlineFrameAlign.php	1018 B	-rw-r--r--
TInlineFrameScrollBars.php	917 B	-rw-r--r--
TItemDataRenderer.php	2.17 KB	-rw-r--r--
TJavascriptLogger.php	2.8 KB	-rw-r--r--
TKeyboard.php	5.92 KB	-rw-r--r--
TLabel.php	3.95 KB	-rw-r--r--
TLinkButton.php	10.45 KB	-rw-r--r--
TListBox.php	6.57 KB	-rw-r--r--
TListControl.php	24.23 KB	-rw-r--r--
TListControlValidator.php	5.84 KB	-rw-r--r--
TListItem.php	4.93 KB	-rw-r--r--
TListItemType.php	1.11 KB	-rw-r--r--
TListSelectionMode.php	684 B	-rw-r--r--
TLiteral.php	2.82 KB	-rw-r--r--
TLiteralColumn.php	4.08 KB	-rw-r--r--
TMarkdown.php	1.99 KB	-rw-r--r--
TMetaTag.php	3.53 KB	-rw-r--r--
TMetaTagCollection.php	1.83 KB	-rw-r--r--
TMultiView.php	8.34 KB	-rw-r--r--
TOutputCache.php	15.99 KB	-rw-r--r--
TOutputCacheCalculateKeyEventP...	1.04 KB	-rw-r--r--
TOutputCacheCheckDependencyEve...	1.38 KB	-rw-r--r--
TOutputCacheTextWriterMulti.ph...	975 B	-rw-r--r--
TPageLoadTime.php	1.31 KB	-rw-r--r--
TPager.php	21.73 KB	-rw-r--r--
TPagerButtonType.php	714 B	-rw-r--r--
TPagerMode.php	838 B	-rw-r--r--
TPagerPageChangedEventParamete...	1.54 KB	-rw-r--r--
TPanel.php	6.39 KB	-rw-r--r--
TPanelStyle.php	8.09 KB	-rw-r--r--
TPlaceHolder.php	616 B	-rw-r--r--
TPolygonHotSpot.php	1.11 KB	-rw-r--r--
TRadioButton.php	9.39 KB	-rw-r--r--
TRadioButtonItem.php	533 B	-rw-r--r--
TRadioButtonList.php	2.29 KB	-rw-r--r--
TRangeValidationDataType.php	696 B	-rw-r--r--
TRangeValidator.php	9.76 KB	-rw-r--r--
TRatingList.php	8.75 KB	-rw-r--r--
TReCaptcha.php	11.79 KB	-rw-r--r--
TReCaptcha2.php	10.95 KB	-rw-r--r--
TReCaptcha2Validator.php	3.43 KB	-rw-r--r--
TReCaptchaValidator.php	4.19 KB	-rw-r--r--
TReadOnlyDataSource.php	1.1 KB	-rw-r--r--
TReadOnlyDataSourceView.php	1.01 KB	-rw-r--r--
TRectangleHotSpot.php	2.36 KB	-rw-r--r--
TRegularExpressionValidator.ph...	4.16 KB	-rw-r--r--
TRepeatDirection.php	681 B	-rw-r--r--
TRepeatInfo.php	13.51 KB	-rw-r--r--
TRepeatLayout.php	872 B	-rw-r--r--
TRepeater.php	23.8 KB	-rw-r--r--
TRepeaterCommandEventParameter...	1.81 KB	-rw-r--r--
TRepeaterItem.php	2.83 KB	-rw-r--r--
TRepeaterItemCollection.php	1.07 KB	-rw-r--r--
TRepeaterItemEventParameter.ph...	1.13 KB	-rw-r--r--
TRepeaterItemRenderer.php	1.24 KB	-rw-r--r--
TRequiredFieldValidator.php	4.56 KB	-rw-r--r--
TSafeHtml.php	2.07 KB	-rw-r--r--
TScrollBars.php	953 B	-rw-r--r--
TServerValidateEventParameter....	1.37 KB	-rw-r--r--
TSlider.php	14.93 KB	-rw-r--r--
TSliderClientScript.php	1.78 KB	-rw-r--r--
TSliderDirection.php	749 B	-rw-r--r--
TStatements.php	1.44 KB	-rw-r--r--
TStyle.php	9.84 KB	-rw-r--r--
TStyleSheet.php	3.62 KB	-rw-r--r--
TTabPanel.php	14.67 KB	-rw-r--r--
TTabView.php	4.83 KB	-rw-r--r--
TTabViewCollection.php	1.55 KB	-rw-r--r--
TTable.php	9.63 KB	-rw-r--r--
TTableCaptionAlign.php	862 B	-rw-r--r--
TTableCell.php	5.77 KB	-rw-r--r--
TTableCellCollection.php	1.1 KB	-rw-r--r--
TTableFooterRow.php	882 B	-rw-r--r--
TTableGridLines.php	902 B	-rw-r--r--
TTableHeaderCell.php	2.4 KB	-rw-r--r--
TTableHeaderRow.php	882 B	-rw-r--r--
TTableHeaderScope.php	766 B	-rw-r--r--
TTableItemStyle.php	5.5 KB	-rw-r--r--
TTableRow.php	3.8 KB	-rw-r--r--
TTableRowCollection.php	1.08 KB	-rw-r--r--
TTableRowSection.php	761 B	-rw-r--r--
TTableStyle.php	8.84 KB	-rw-r--r--
TTemplateColumn.php	7.93 KB	-rw-r--r--
TTemplatedWizardStep.php	2.93 KB	-rw-r--r--
TTextAlign.php	608 B	-rw-r--r--
TTextBox.php	19.32 KB	-rw-r--r--
TTextBoxAutoCompleteType.php	1.87 KB	-rw-r--r--
TTextBoxMode.php	2.3 KB	-rw-r--r--
TTextHighlighter.php	6.53 KB	-rw-r--r--
TTextProcessor.php	2.28 KB	-rw-r--r--
TValidationCompareOperator.php	959 B	-rw-r--r--
TValidationDataType.php	749 B	-rw-r--r--
TValidationSummary.php	11.78 KB	-rw-r--r--
TValidationSummaryDisplayMode....	1.09 KB	-rw-r--r--
TValidationSummaryDisplayStyle...	1017 B	-rw-r--r--
TValidatorClientSide.php	2.96 KB	-rw-r--r--
TValidatorDisplayStyle.php	951 B	-rw-r--r--
TVerticalAlign.php	836 B	-rw-r--r--
TView.php	2.23 KB	-rw-r--r--
TViewCollection.php	1.09 KB	-rw-r--r--
TWebControl.php	12.65 KB	-rw-r--r--
TWebControlAdapter.php	1.98 KB	-rw-r--r--
TWebControlDecorator.php	10.94 KB	-rw-r--r--
TWizard.php	41.24 KB	-rw-r--r--
TWizardFinishNavigationTemplat...	1.49 KB	-rw-r--r--
TWizardNavigationButtonStyle.p...	3.89 KB	-rw-r--r--
TWizardNavigationButtonType.ph...	825 B	-rw-r--r--
TWizardNavigationContainer.php	1.85 KB	-rw-r--r--
TWizardNavigationEventParamete...	2.15 KB	-rw-r--r--
TWizardNavigationTemplate.php	2.29 KB	-rw-r--r--
TWizardSideBarListItemTemplate...	907 B	-rw-r--r--
TWizardSideBarTemplate.php	1003 B	-rw-r--r--
TWizardStartNavigationTemplate...	1.21 KB	-rw-r--r--
TWizardStep.php	2.34 KB	-rw-r--r--
TWizardStepCollection.php	1.79 KB	-rw-r--r--
TWizardStepNavigationTemplate....	1.45 KB	-rw-r--r--
TWizardStepType.php	1.01 KB	-rw-r--r--
TXmlTransform.php	5.76 KB	-rw-r--r--

Code Editor : TRepeater.php

<?php
/**
 * TRepeater class file
 *
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @link https://github.com/pradosoft/prado
 * @license https://github.com/pradosoft/prado/blob/master/LICENSE
 */

namespace Prado\Web\UI\WebControls;

use Prado\Exceptions\TInvalidDataTypeException;
use Prado\Exceptions\TInvalidDataValueException;
use Prado\Collections\TMap;
use Prado\Collections\TList;
use Prado\Prado;
use Prado\Util\TDataFieldAccessor;
use Prado\Web\UI\ITemplate;

/**
 * TRepeater class.
 *
 * TRepeater displays its content repeatedly based on the data fetched from
 * {@link setDataSource DataSource}.
 * The repeated contents in TRepeater are called items, which are controls and
 * can be accessed through {@link getItems Items}. When {@link dataBind()} is invoked,
 * TRepeater creates an item for each row of data and binds the data row to the item.
 * Optionally, a repeater can have a header, a footer and/or separators between items.
 *
 * The layout of the repeated contents are specified by inline templates.
 * Repeater items, header, footer, etc. are being instantiated with the corresponding
 * templates when data is being bound to the repeater.
 *
 * Since v3.1.0, the layout can also be specified by renderers. A renderer is a control class
 * that can be instantiated as repeater items, header, etc. A renderer can thus be viewed
 * as an external template (in fact, it can also be non-templated controls).
 *
 * A renderer can be any control class.
 * - If the class implements {@link \Prado\IDataRenderer}, the Data
 * property will be set as the data row during databinding. Many PRADO controls
 * implement this interface, such as {@link TLabel}, {@link TTextBox}, etc.
 * - If the class implements {@link IItemDataRenderer}, the ItemIndex property will be set
 * as the zero-based index of the item in the repeater item collection, and
 * the ItemType property as the item's type (such as TListItemType::Item).
 * {@link TRepeaterItemRenderer} may be used as the convenient base class which
 * already implements {@link IDataItemRenderer}.
 *
 * The following properties are used to specify different types of template and renderer
 * for a repeater:
 * - {@link setItemTemplate ItemTemplate}, {@link setItemRenderer ItemRenderer}:
 * for each repeated row of data
 * - {@link setAlternatingItemTemplate AlternatingItemTemplate}, {@link setAlternatingItemRenderer AlternatingItemRenderer}:
 * for each alternating row of data. If not set, {@link setItemTemplate ItemTemplate} or {@link setItemRenderer ItemRenderer}
 * will be used instead.
 * - {@link setHeaderTemplate HeaderTemplate}, {@link setHeaderRenderer HeaderRenderer}:
 * for the repeater header.
 * - {@link setFooterTemplate FooterTemplate}, {@link setFooterRenderer FooterRenderer}:
 * for the repeater footer.
 * - {@link setSeparatorTemplate SeparatorTemplate}, {@link setSeparatorRenderer SeparatorRenderer}:
 * for content to be displayed between items.
 * - {@link setEmptyTemplate EmptyTemplate}, {@link setEmptyRenderer EmptyRenderer}:
 * used when data bound to the repeater is empty.
 *
 * If a content type is defined with both a template and a renderer, the latter takes precedence.
 *
 * When {@link dataBind()} is being called, TRepeater undergoes the following lifecycles for each row of data:
 * - create item based on templates or renderers
 * - set the row of data to the item
 * - raise {@link onItemCreated OnItemCreated}:
 * - add the item as a child control
 * - call dataBind() of the item
 * - raise {@link onItemDataBound OnItemDataBound}:
 *
 * TRepeater raises an {@link onItemCommand OnItemCommand} whenever a button control
 * within some repeater item raises a OnCommand event. Therefore,
 * you can handle all sorts of OnCommand event in a central place by
 * writing an event handler for {@link onItemCommand OnItemCommand}.
 *
 * When a page containing a repeater is post back, the repeater will restore automatically
 * all its contents, including items, header, footer and separators.
 * However, the data row associated with each item will not be recovered and become null.
 * To access the data, use one of the following ways:
 * - Use {@link getDataKeys DataKeys} to obtain the data key associated with
 * the specified repeater item and use the key to fetch the corresponding data
 * from some persistent storage such as DB.
 * - Save the whole dataset in viewstate, which will restore the dataset automatically upon postback.
 * Be aware though, if the size of your dataset is big, your page size will become big. Some
 * complex data may also have serializing problem if saved in viewstate.
 *
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @since 3.0
 */
class TRepeater extends TDataBoundControl implements \Prado\Web\UI\INamingContainer
{
	/**
	 * @var ITemplate template for repeater items
	 */
	private $_itemTemplate;
	/**
	 * @var ITemplate template for each alternating item
	 */
	private $_alternatingItemTemplate;
	/**
	 * @var ITemplate template for header
	 */
	private $_headerTemplate;
	/**
	 * @var ITemplate template for footer
	 */
	private $_footerTemplate;
	/**
	 * @var ITemplate template used for repeater when no data is bound
	 */
	private $_emptyTemplate;
	/**
	 * @var ITemplate template for separator
	 */
	private $_separatorTemplate;
	/**
	 * @var TRepeaterItemCollection list of repeater items
	 */
	private $_items;
	/**
	 * @var \Prado\Web\UI\TControl header item
	 */
	private $_header;
	/**
	 * @var \Prado\Web\UI\TControl footer item
	 */
	private $_footer;

/**
	 * @return string the class name for repeater items. Defaults to empty, meaning not set.
	 * @since 3.1.0
	 */
	public function getItemRenderer()
	{
		return $this->getViewState('ItemRenderer', '');
	}

/**
	 * Sets the item renderer class.
	 *
	 * If not empty, the class will be used to instantiate as repeater items.
	 * This property takes precedence over {@link getItemTemplate ItemTemplate}.
	 *
	 * @param string $value the renderer class name in namespace format.
	 * @see setItemTemplate
	 * @since 3.1.0
	 */
	public function setItemRenderer($value)
	{
		$this->setViewState('ItemRenderer', $value, '');
	}

/**
	 * @return string the class name for alternative repeater items. Defaults to empty, meaning not set.
	 * @since 3.1.0
	 */
	public function getAlternatingItemRenderer()
	{
		return $this->getViewState('AlternatingItemRenderer', '');
	}

/**
	 * Sets the alternative item renderer class.
	 *
	 * If not empty, the class will be used to instantiate as alternative repeater items.
	 * This property takes precedence over {@link getAlternatingItemTemplate AlternatingItemTemplate}.
	 *
	 * @param string $value the renderer class name in namespace format.
	 * @see setAlternatingItemTemplate
	 * @since 3.1.0
	 */
	public function setAlternatingItemRenderer($value)
	{
		$this->setViewState('AlternatingItemRenderer', $value, '');
	}

/**
	 * @return string the class name for repeater item separators. Defaults to empty, meaning not set.
	 * @since 3.1.0
	 */
	public function getSeparatorRenderer()
	{
		return $this->getViewState('SeparatorRenderer', '');
	}

/**
	 * Sets the repeater item separator renderer class.
	 *
	 * If not empty, the class will be used to instantiate as repeater item separators.
	 * This property takes precedence over {@link getSeparatorTemplate SeparatorTemplate}.
	 *
	 * @param string $value the renderer class name in namespace format.
	 * @see setSeparatorTemplate
	 * @since 3.1.0
	 */
	public function setSeparatorRenderer($value)
	{
		$this->setViewState('SeparatorRenderer', $value, '');
	}

/**
	 * @return string the class name for repeater header item. Defaults to empty, meaning not set.
	 * @since 3.1.0
	 */
	public function getHeaderRenderer()
	{
		return $this->getViewState('HeaderRenderer', '');
	}

/**
	 * Sets the repeater header renderer class.
	 *
	 * If not empty, the class will be used to instantiate as repeater header item.
	 * This property takes precedence over {@link getHeaderTemplate HeaderTemplate}.
	 *
	 * @param string $value the renderer class name in namespace format.
	 * @see setHeaderTemplate
	 * @since 3.1.0
	 */
	public function setHeaderRenderer($value)
	{
		$this->setViewState('HeaderRenderer', $value, '');
	}

/**
	 * @return string the class name for repeater footer item. Defaults to empty, meaning not set.
	 * @since 3.1.0
	 */
	public function getFooterRenderer()
	{
		return $this->getViewState('FooterRenderer', '');
	}

/**
	 * Sets the repeater footer renderer class.
	 *
	 * If not empty, the class will be used to instantiate as repeater footer item.
	 * This property takes precedence over {@link getFooterTemplate FooterTemplate}.
	 *
	 * @param string $value the renderer class name in namespace format.
	 * @see setFooterTemplate
	 * @since 3.1.0
	 */
	public function setFooterRenderer($value)
	{
		$this->setViewState('FooterRenderer', $value, '');
	}

/**
	 * @return string the class name for empty repeater item. Defaults to empty, meaning not set.
	 * @since 3.1.0
	 */
	public function getEmptyRenderer()
	{
		return $this->getViewState('EmptyRenderer', '');
	}

/**
	 * Sets the repeater empty renderer class.
	 *
	 * The empty renderer is created as the child of the repeater
	 * if data bound to the repeater is empty.
	 * This property takes precedence over {@link getEmptyTemplate EmptyTemplate}.
	 *
	 * @param string $value the renderer class name in namespace format.
	 * @see setEmptyTemplate
	 * @since 3.1.0
	 */
	public function setEmptyRenderer($value)
	{
		$this->setViewState('EmptyRenderer', $value, '');
	}

/**
	 * @return \Prado\Web\UI\ITemplate the template for repeater items
	 */
	public function getItemTemplate()
	{
		return $this->_itemTemplate;
	}

/**
	 * @param \Prado\Web\UI\ITemplate $value the template for repeater items
	 * @throws TInvalidDataTypeException if the input is not an {@link ITemplate} or not null.
	 */
	public function setItemTemplate($value)
	{
		if ($value instanceof \Prado\Web\UI\ITemplate || $value === null) {
			$this->_itemTemplate = $value;
		} else {
			throw new TInvalidDataTypeException('repeater_template_required', 'ItemTemplate');
		}
	}

/**
	 * @return \Prado\Web\UI\ITemplate the alternative template string for the item
	 */
	public function getAlternatingItemTemplate()
	{
		return $this->_alternatingItemTemplate;
	}

/**
	 * @param \Prado\Web\UI\ITemplate $value the alternative item template
	 * @throws TInvalidDataTypeException if the input is not an {@link ITemplate} or not null.
	 */
	public function setAlternatingItemTemplate($value)
	{
		if ($value instanceof \Prado\Web\UI\ITemplate || $value === null) {
			$this->_alternatingItemTemplate = $value;
		} else {
			throw new TInvalidDataTypeException('repeater_template_required', 'AlternatingItemTemplate');
		}
	}

/**
	 * @return \Prado\Web\UI\ITemplate the header template
	 */
	public function getHeaderTemplate()
	{
		return $this->_headerTemplate;
	}

/**
	 * @param \Prado\Web\UI\ITemplate $value the header template
	 * @throws TInvalidDataTypeException if the input is not an {@link ITemplate} or not null.
	 */
	public function setHeaderTemplate($value)
	{
		if ($value instanceof \Prado\Web\UI\ITemplate || $value === null) {
			$this->_headerTemplate = $value;
		} else {
			throw new TInvalidDataTypeException('repeater_template_required', 'HeaderTemplate');
		}
	}

/**
	 * @return \Prado\Web\UI\ITemplate the footer template
	 */
	public function getFooterTemplate()
	{
		return $this->_footerTemplate;
	}

/**
	 * @param \Prado\Web\UI\ITemplate $value the footer template
	 * @throws TInvalidDataTypeException if the input is not an {@link ITemplate} or not null.
	 */
	public function setFooterTemplate($value)
	{
		if ($value instanceof \Prado\Web\UI\ITemplate || $value === null) {
			$this->_footerTemplate = $value;
		} else {
			throw new TInvalidDataTypeException('repeater_template_required', 'FooterTemplate');
		}
	}

/**
	 * @return \Prado\Web\UI\ITemplate the template applied when no data is bound to the repeater
	 */
	public function getEmptyTemplate()
	{
		return $this->_emptyTemplate;
	}

/**
	 * @param \Prado\Web\UI\ITemplate $value the template applied when no data is bound to the repeater
	 * @throws TInvalidDataTypeException if the input is not an {@link ITemplate} or not null.
	 */
	public function setEmptyTemplate($value)
	{
		if ($value instanceof \Prado\Web\UI\ITemplate || $value === null) {
			$this->_emptyTemplate = $value;
		} else {
			throw new TInvalidDataTypeException('repeater_template_required', 'EmptyTemplate');
		}
	}

/**
	 * @return \Prado\Web\UI\ITemplate the separator template
	 */
	public function getSeparatorTemplate()
	{
		return $this->_separatorTemplate;
	}

/**
	 * @param \Prado\Web\UI\ITemplate $value the separator template
	 * @throws TInvalidDataTypeException if the input is not an {@link ITemplate} or not null.
	 */
	public function setSeparatorTemplate($value)
	{
		if ($value instanceof \Prado\Web\UI\ITemplate || $value === null) {
			$this->_separatorTemplate = $value;
		} else {
			throw new TInvalidDataTypeException('repeater_template_required', 'SeparatorTemplate');
		}
	}

/**
	 * @return \Prado\Web\UI\TControl the header item
	 */
	public function getHeader()
	{
		return $this->_header;
	}

/**
	 * @return \Prado\Web\UI\TControl the footer item
	 */
	public function getFooter()
	{
		return $this->_footer;
	}

/**
	 * @return TRepeaterItemCollection list of repeater item controls
	 */
	public function getItems()
	{
		if (!$this->_items) {
			$this->_items = new TRepeaterItemCollection();
		}
		return $this->_items;
	}

/**
	 * @return string the field of the data source that provides the keys of the list items.
	 */
	public function getDataKeyField()
	{
		return $this->getViewState('DataKeyField', '');
	}

/**
	 * @param string $value the field of the data source that provides the keys of the list items.
	 */
	public function setDataKeyField($value)
	{
		$this->setViewState('DataKeyField', $value, '');
	}

/**
	 * @return TList the keys used in the data listing control.
	 */
	public function getDataKeys()
	{
		if (($dataKeys = $this->getViewState('DataKeys', null)) === null) {
			$dataKeys = new TList();
			$this->setViewState('DataKeys', $dataKeys, null);
		}
		return $dataKeys;
	}

/**
	 * Creates a repeater item.
	 * This method invokes {@link createItem} to create a new repeater item.
	 * @param int $itemIndex zero-based item index.
	 * @param TListItemType $itemType item type
	 * @return \Prado\Web\UI\TControl the created item, null if item is not created
	 */
	private function createItemInternal($itemIndex, $itemType)
	{
		if (($item = $this->createItem($itemIndex, $itemType)) !== null) {
			$param = new TRepeaterItemEventParameter($item);
			$this->onItemCreated($param);
			$this->getControls()->add($item);
			return $item;
		} else {
			return null;
		}
	}

/**
	 * Creates a repeater item and performs databinding.
	 * This method invokes {@link createItem} to create a new repeater item.
	 * @param int $itemIndex zero-based item index.
	 * @param TListItemType $itemType item type
	 * @param mixed $dataItem data to be associated with the item
	 * @return \Prado\Web\UI\TControl the created item, null if item is not created
	 */
	private function createItemWithDataInternal($itemIndex, $itemType, $dataItem)
	{
		if (($item = $this->createItem($itemIndex, $itemType)) !== null) {
			$param = new TRepeaterItemEventParameter($item);
			if ($item instanceof \Prado\IDataRenderer) {
				$item->setData($dataItem);
			}
			$this->onItemCreated($param);
			$this->getControls()->add($item);
			$item->dataBind();
			$this->onItemDataBound($param);
			return $item;
		} else {
			return null;
		}
	}

/**
	 * Creates a repeater item instance based on the item type and index.
	 * @param int $itemIndex zero-based item index
	 * @param TListItemType $itemType item type
	 * @return \Prado\Web\UI\TControl created repeater item
	 */
	protected function createItem($itemIndex, $itemType)
	{
		$template = null;
		$classPath = null;
		switch ($itemType) {
			case TListItemType::Item:
				$classPath = $this->getItemRenderer();
				$template = $this->_itemTemplate;
				break;
			case TListItemType::AlternatingItem:
				if (($classPath = $this->getAlternatingItemRenderer()) === '' && ($template = $this->_alternatingItemTemplate) === null) {
					$classPath = $this->getItemRenderer();
					$template = $this->_itemTemplate;
				}
				break;
			case TListItemType::Header:
				$classPath = $this->getHeaderRenderer();
				$template = $this->_headerTemplate;
				break;
			case TListItemType::Footer:
				$classPath = $this->getFooterRenderer();
				$template = $this->_footerTemplate;
				break;
			case TListItemType::Separator:
				$classPath = $this->getSeparatorRenderer();
				$template = $this->_separatorTemplate;
				break;
			default:
				throw new TInvalidDataValueException('repeater_itemtype_unknown', $itemType);
		}
		if ($classPath !== '') {
			$item = Prado::createComponent($classPath);
			if ($item instanceof IItemDataRenderer) {
				$item->setItemIndex($itemIndex);
				$item->setItemType($itemType);
			}
		} elseif ($template !== null) {
			$item = new TRepeaterItem();
			$item->setItemIndex($itemIndex);
			$item->setItemType($itemType);
			$template->instantiateIn($item);
		} else {
			$item = null;
		}

return $item;
	}

/**
	 * Creates empty repeater content.
	 */
	protected function createEmptyContent()
	{
		if (($classPath = $this->getEmptyRenderer()) !== '') {
			$this->getControls()->add(Prado::createComponent($classPath));
		} elseif ($this->_emptyTemplate !== null) {
			$this->_emptyTemplate->instantiateIn($this);
		}
	}

/**
	 * Renders the repeater.
	 * This method overrides the parent implementation by rendering the body
	 * content as the whole presentation of the repeater. Outer tag is not rendered.
	 * @param \Prado\Web\UI\THtmlWriter $writer writer
	 */
	public function render($writer)
	{
		if ($this->_items && $this->_items->getCount() || $this->_emptyTemplate !== null || $this->getEmptyRenderer() !== '') {
			$this->renderContents($writer);
		}
	}

/**
	 * Saves item count in viewstate.
	 * This method is invoked right before control state is to be saved.
	 */
	public function saveState()
	{
		parent::saveState();
		if ($this->_items) {
			$this->setViewState('ItemCount', $this->_items->getCount(), 0);
		} else {
			$this->clearViewState('ItemCount');
		}
	}

/**
	 * Loads item count information from viewstate.
	 * This method is invoked right after control state is loaded.
	 */
	public function loadState()
	{
		parent::loadState();
		if (!$this->getIsDataBound()) {
			$this->restoreItemsFromViewState();
		}
		$this->clearViewState('ItemCount');
	}

/**
	 * Clears up all items in the repeater.
	 */
	public function reset()
	{
		$this->getControls()->clear();
		$this->getItems()->clear();
		$this->_header = null;
		$this->_footer = null;
	}

/**
	 * Creates repeater items based on viewstate information.
	 */
	protected function restoreItemsFromViewState()
	{
		$this->reset();
		if (($itemCount = $this->getViewState('ItemCount', 0)) > 0) {
			$items = $this->getItems();
			$hasSeparator = $this->_separatorTemplate !== null || $this->getSeparatorRenderer() !== '';
			$this->_header = $this->createItemInternal(-1, TListItemType::Header);
			for ($i = 0; $i < $itemCount; ++$i) {
				if ($hasSeparator && $i > 0) {
					$this->createItemInternal($i - 1, TListItemType::Separator);
				}
				$itemType = $i % 2 == 0 ? TListItemType::Item : TListItemType::AlternatingItem;
				$items->add($this->createItemInternal($i, $itemType));
			}
			$this->_footer = $this->createItemInternal(-1, TListItemType::Footer);
		} else {
			$this->createEmptyContent();
		}
		$this->clearChildState();
	}

/**
	 * Performs databinding to populate repeater items from data source.
	 * This method is invoked by dataBind().
	 * You may override this function to provide your own way of data population.
	 * @param \Traversable $data the data
	 */
	protected function performDataBinding($data)
	{
		$this->reset();

$keys = $this->getDataKeys();
		$keys->clear();
		$keyField = $this->getDataKeyField();

$items = $this->getItems();
		$itemIndex = 0;
		$hasSeparator = $this->_separatorTemplate !== null || $this->getSeparatorRenderer() !== '';
		foreach ($data as $key => $dataItem) {
			if ($keyField !== '') {
				$keys->add($this->getDataFieldValue($dataItem, $keyField));
			} else {
				$keys->add($key);
			}
			if ($itemIndex === 0) {
				$this->_header = $this->createItemWithDataInternal(-1, TListItemType::Header, null);
			}
			if ($hasSeparator && $itemIndex > 0) {
				$this->createItemWithDataInternal($itemIndex - 1, TListItemType::Separator, null);
			}
			$itemType = $itemIndex % 2 == 0 ? TListItemType::Item : TListItemType::AlternatingItem;
			$items->add($this->createItemWithDataInternal($itemIndex, $itemType, $dataItem));
			$itemIndex++;
		}
		if ($itemIndex > 0) {
			$this->_footer = $this->createItemWithDataInternal(-1, TListItemType::Footer, null);
		} else {
			$this->createEmptyContent();
			$this->dataBindChildren();
		}
		$this->setViewState('ItemCount', $itemIndex, 0);
	}

/**
	 * This method overrides parent's implementation to handle
	 * {@link onItemCommand OnItemCommand} event which is bubbled from
	 * repeater items and their child controls.
	 * This method should only be used by control developers.
	 * @param \Prado\Web\UI\TControl $sender the sender of the event
	 * @param \Prado\TEventParameter $param event parameter
	 * @return bool whether the event bubbling should stop here.
	 */
	public function bubbleEvent($sender, $param)
	{
		if ($param instanceof TRepeaterCommandEventParameter) {
			$this->onItemCommand($param);
			return true;
		} else {
			return false;
		}
	}

/**
	 * Raises OnItemCreated event.
	 * This method is invoked after a repeater item is created and instantiated with
	 * template, but before added to the page hierarchy.
	 * The repeater item control responsible for the event
	 * can be determined from the event parameter.
	 * If you override this method, be sure to call parent's implementation
	 * so that event handlers have chance to respond to the event.
	 * @param TRepeaterItemEventParameter $param event parameter
	 */
	public function onItemCreated($param)
	{
		$this->raiseEvent('OnItemCreated', $this, $param);
	}

/**
	 * Raises OnItemDataBound event.
	 * This method is invoked right after an item is data bound.
	 * The repeater item control responsible for the event
	 * can be determined from the event parameter.
	 * If you override this method, be sure to call parent's implementation
	 * so that event handlers have chance to respond to the event.
	 * @param TRepeaterItemEventParameter $param event parameter
	 */
	public function onItemDataBound($param)
	{
		$this->raiseEvent('OnItemDataBound', $this, $param);
	}

/**
	 * Raises OnItemCommand event.
	 * This method is invoked after a button control in
	 * a template raises OnCommand event.
	 * The repeater control responsible for the event
	 * can be determined from the event parameter.
	 * The event parameter also contains the information about
	 * the initial sender of the OnCommand event, command name
	 * and command parameter.
	 * You may override this method to provide customized event handling.
	 * Be sure to call parent's implementation so that
	 * event handlers have chance to respond to the event.
	 * @param TRepeaterCommandEventParameter $param event parameter
	 */
	public function onItemCommand($param)
	{
		$this->raiseEvent('OnItemCommand', $this, $param);
	}

/**
	 * Returns the value of the data at the specified field.
	 * If data is an array, TMap or TList, the value will be returned at the index
	 * of the specified field. If the data is a component with a property named
	 * as the field name, the property value will be returned.
	 * Otherwise, an exception will be raised.
	 * @param mixed $data data item
	 * @param string $field field name
	 * @throws TInvalidDataValueException if the data is invalid
	 * @return mixed data value at the specified field
	 */
	protected function getDataFieldValue($data, $field)
	{
		return TDataFieldAccessor::getDataFieldValue($data, $field);
	}
}

${this.title}

Code Editor : TRepeater.php