summaryrefslogtreecommitdiff
path: root/framework/Web/UI/WebControls
diff options
context:
space:
mode:
authorxue <>2006-01-14 03:30:53 +0000
committerxue <>2006-01-14 03:30:53 +0000
commit5a63c2c1989ed9fdcf8fbe00ec8161934768daf3 (patch)
tree4a43642be2e9a263c4a2d1a1160dc392c77cadab /framework/Web/UI/WebControls
parenta1594654a60d846f50dd2a5f52045dd76f5a33c2 (diff)
Added TBaseDataList (nearly completed).
Diffstat (limited to 'framework/Web/UI/WebControls')
-rw-r--r--framework/Web/UI/WebControls/TCheckBoxList.php34
-rw-r--r--framework/Web/UI/WebControls/TDataList.php1091
-rw-r--r--framework/Web/UI/WebControls/TRepeatInfo.php59
-rw-r--r--framework/Web/UI/WebControls/TRepeater.php89
-rw-r--r--framework/Web/UI/WebControls/TStyle.php1
5 files changed, 1163 insertions, 111 deletions
diff --git a/framework/Web/UI/WebControls/TCheckBoxList.php b/framework/Web/UI/WebControls/TCheckBoxList.php
index 28ab11ea..168c7ef0 100644
--- a/framework/Web/UI/WebControls/TCheckBoxList.php
+++ b/framework/Web/UI/WebControls/TCheckBoxList.php
@@ -102,19 +102,6 @@ class TCheckBoxList extends TListControl implements IRepeatInfoUser, INamingCont
}
/**
- * @return TRepeatInfo repeat information (primarily used by control developers)
- */
- protected function getRepeatInfo()
- {
- if(($repeatInfo=$this->getViewState('RepeatInfo',null))===null)
- {
- $repeatInfo=new TRepeatInfo;
- $this->setViewState('RepeatInfo',$repeatInfo,null);
- }
- return $repeatInfo;
- }
-
- /**
* @return string the alignment of the text caption, defaults to 'Right'.
*/
public function getTextAlign()
@@ -131,6 +118,20 @@ class TCheckBoxList extends TListControl implements IRepeatInfoUser, INamingCont
$this->setViewState('TextAlign',TPropertyValue::ensureEnum($value,array('Left','Right')),'Right');
}
+
+ /**
+ * @return TRepeatInfo repeat information (primarily used by control developers)
+ */
+ protected function getRepeatInfo()
+ {
+ if(($repeatInfo=$this->getViewState('RepeatInfo',null))===null)
+ {
+ $repeatInfo=new TRepeatInfo;
+ $this->setViewState('RepeatInfo',$repeatInfo,null);
+ }
+ return $repeatInfo;
+ }
+
/**
* @return integer the number of columns that the list should be displayed with. Defaults to 0 meaning not set.
*/
@@ -140,7 +141,6 @@ class TCheckBoxList extends TListControl implements IRepeatInfoUser, INamingCont
}
/**
- * Sets the number of columns that the list should be displayed with.
* @param integer the number of columns that the list should be displayed with.
*/
public function setRepeatColumns($value)
@@ -157,8 +157,7 @@ class TCheckBoxList extends TListControl implements IRepeatInfoUser, INamingCont
}
/**
- * Sets the direction of traversing the list (Vertical, Horizontal)
- * @param string the direction of traversing the list
+ * @param string the direction (Vertical, Horizontal) of traversing the list
*/
public function setRepeatDirection($value)
{
@@ -174,7 +173,6 @@ class TCheckBoxList extends TListControl implements IRepeatInfoUser, INamingCont
}
/**
- * Sets how the list should be displayed, using table or using line breaks (Table, Flow)
* @param string how the list should be displayed, using table or using line breaks (Table, Flow)
*/
public function setRepeatLayout($value)
@@ -259,7 +257,7 @@ class TCheckBoxList extends TListControl implements IRepeatInfoUser, INamingCont
* @param integer index of the item being rendered
* @return null
*/
- public function getItemStyle($itemType,$index)
+ public function generateItemStyle($itemType,$index)
{
return null;
}
diff --git a/framework/Web/UI/WebControls/TDataList.php b/framework/Web/UI/WebControls/TDataList.php
new file mode 100644
index 00000000..666a344a
--- /dev/null
+++ b/framework/Web/UI/WebControls/TDataList.php
@@ -0,0 +1,1091 @@
+<?php
+/**
+ * TDataList class file
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.pradosoft.com/
+ * @copyright Copyright &copy; 2005 PradoSoft
+ * @license http://www.pradosoft.com/license/
+ * @version $Revision: $ $Date: $
+ * @package System.Web.UI.WebControls
+ */
+
+/**
+ * Includes TBaseDataList class
+ */
+Prado::using('System.Web.UI.WebControls.TBaseDataList');
+
+
+/**
+ * TDataList class
+ *
+ * TDataList represents a data bound and updatable list control.
+ *
+ * It can be used to display and maintain a list of data items (rows, records).
+ * There are three kinds of layout determined by the <b>RepeatLayout</b>
+ * property. The <b>Table</b> layout displays a table and each table cell
+ * contains a data item. The <b>Flow</b> layout uses the span tag to organize
+ * the presentation of data items. The <b>Raw</b> layout displays all templated
+ * content without any additional decorations (therefore, you can use arbitrary
+ * complex UI layout). In case when the layout is Table or Flow,
+ * the number of table/flow columns is determined by the <b>RepeatColumns</b>
+ * property, and the data items are enumerated according to the <b>RepeatDirection</b> property.
+ *
+ * To use TDataList, sets its <b>DataSource</b> property and invokes dataBind()
+ * afterwards. The data will be populated into the TDataList and saved as data items.
+ * A data item can be at one of three states: normal, selected and edit.
+ * The state determines which template is used to display the item.
+ * In particular, data items are displayed using the following templates,
+ * <b>ItemTemplate</b>, <b>AlternatingItemTemplate</b>,
+ * <b>SelectedItemTemplate</b>, <b>EditItemTemplate</b>. In addition, the
+ * <b>HeaderTemplate</b>, <b>FooterTemplate</b>, and <b>SeparatorTemplate</b>
+ * can be used to decorate the overall presentation.
+ *
+ * To change the state of a data item, set either the <b>EditItemIndex</b> property
+ * or the <b>SelectedItemIndex</b> property.
+ *
+ * When an item template contains a button control that raises an <b>OnCommand</b>
+ * event, the event will be bubbled up to the data list control.
+ * If the event's command name is recognizable by the data list control,
+ * a corresponding item event will be raised. The following item events will be
+ * raised upon a specific command:
+ * - OnEditCommand, edit
+ * - OnCancelCommand, cancel
+ * - OnSelectCommand, select
+ * - OnDeleteCommand, delete
+ * - OnUpdateCommand, update
+ * The data list will always raise an <b>OnItemCommand</b>
+ * upon its receiving a bubbled <b>OnCommand</b> event.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Revision: $ $Date: $
+ * @package System.Web.UI.WebControls
+ * @since 3.0
+ */
+class TDataList extends TBaseDataList implements INamingContainer, IRepeatInfoUser
+{
+ /**
+ * Number of seconds that a cached template will expire after
+ */
+ const CACHE_EXPIRY=18000;
+ /**
+ * @var array in-memory cache of parsed templates
+ */
+ private static $_templates=array();
+ /**
+ * @var TDataListItemCollection item list
+ */
+ private $_items=null;
+ /**
+ * @var string Various item templates
+ */
+ private $_itemTemplate='';
+ private $_alternatingItemTemplate='';
+ private $_selectedItemTemplate='';
+ private $_editItemTemplate='';
+ private $_headerTemplate='';
+ private $_footerTemplate='';
+ private $_separatorTemplate='';
+
+ /**
+ * @return TDataListItemCollection item list
+ */
+ public function getItems()
+ {
+ if(!$this->_items)
+ $this->_items=new TDataListItemCollection;
+ return $this->_items;
+ }
+
+ /**
+ * @return integer number of items
+ */
+ public function getItemCount()
+ {
+ return $this->_items?$this->_items->getCount():0;
+ }
+
+ /**
+ * @return string the template for item
+ */
+ public function getItemTemplate()
+ {
+ return $this->_itemTemplate;
+ }
+
+ /**
+ * @param string the template for item
+ */
+ public function setItemTemplate($value)
+ {
+ $this->_itemTemplate=$value;
+ }
+
+ /**
+ * @return TTableItemStyle the style for item
+ */
+ public function getItemStyle()
+ {
+ if(($style=$this->getViewState('ItemStyle',null))===null)
+ {
+ $style=new TTableItemStyle;
+ $this->setViewState('ItemStyle',$style,null);
+ }
+ return $style;
+ }
+
+ /**
+ * @return string the template for each alternating item
+ */
+ public function getAlternatingItemTemplate()
+ {
+ return $this->_alternatingItemTemplate;
+ }
+
+ /**
+ * @param string the template for each alternating item
+ */
+ public function setAlternatingItemTemplate($value)
+ {
+ $this->_alternatingItemTemplate=$value;
+ }
+
+ /**
+ * @return TTableItemStyle the style for each alternating item
+ */
+ public function getAlternatingItemStyle()
+ {
+ if(($style=$this->getViewState('AlternatingItemStyle',null))===null)
+ {
+ $style=new TTableItemStyle;
+ $this->setViewState('AlternatingItemStyle',$style,null);
+ }
+ return $style;
+ }
+
+ /**
+ * @return TTableItemStyle the selected item template string
+ */
+ public function getSelectedItemTemplate()
+ {
+ return $this->_selectedItemTemplate;
+ }
+
+ /**
+ * @param string the selected item template
+ */
+ public function setSelectedItemTemplate($value)
+ {
+ $this->_selectedItemTemplate=$value;
+ }
+
+ /**
+ * @return TTableItemStyle the style for selected item
+ */
+ public function getSelectedItemStyle()
+ {
+ if(($style=$this->getViewState('SelectedItemStyle',null))===null)
+ {
+ $style=new TTableItemStyle;
+ $this->setViewState('SelectedItemStyle',$style,null);
+ }
+ return $style;
+ }
+
+ /**
+ * @return string the edit item template string
+ */
+ public function getEditItemTemplate()
+ {
+ return $this->_editItemTemplate;
+ }
+
+ /**
+ * @param string the edit item template
+ */
+ public function setEditItemTemplate($value)
+ {
+ $this->_editItemTemplate=$value;
+ }
+
+ /**
+ * @return TTableItemStyle the style for edit item
+ */
+ public function getEditItemStyle()
+ {
+ if(($style=$this->getViewState('EditItemStyle',null))===null)
+ {
+ $style=new TTableItemStyle;
+ $this->setViewState('EditItemStyle',$style,null);
+ }
+ return $style;
+ }
+
+ /**
+ * @return string the header template string
+ */
+ public function getHeaderTemplate()
+ {
+ return $this->_headerTemplate;
+ }
+
+ /**
+ * @param string the header template
+ */
+ public function setHeaderTemplate($value)
+ {
+ $this->_headerTemplate=$value;
+ }
+
+ /**
+ * @return TTableItemStyle the style for header
+ */
+ public function getHeaderStyle()
+ {
+ if(($style=$this->getViewState('HeaderStyle',null))===null)
+ {
+ $style=new TTableItemStyle;
+ $this->setViewState('HeaderStyle',$style,null);
+ }
+ return $style;
+ }
+
+ /**
+ * @return string the footer template string
+ */
+ public function getFooterTemplate()
+ {
+ return $this->_footerTemplate;
+ }
+
+ /**
+ * @param string the footer template
+ */
+ public function setFooterTemplate($value)
+ {
+ $this->_footerTemplate=$value;
+ }
+
+ /**
+ * @return TTableItemStyle the style for footer
+ */
+ public function getFooterStyle()
+ {
+ if(($style=$this->getViewState('FooterStyle',null))===null)
+ {
+ $style=new TTableItemStyle;
+ $this->setViewState('FooterStyle',$style,null);
+ }
+ return $style;
+ }
+
+ /**
+ * @return TTableItemStyle the separator template string
+ */
+ public function getSeparatorTemplate()
+ {
+ return $this->_separatorTemplate;
+ }
+
+ /**
+ * @param string the separator template
+ */
+ public function setSeparatorTemplate($value)
+ {
+ $this->_separatorTemplate=$value;
+ }
+
+ /**
+ * @return TTableItemStyle the style for separator
+ */
+ public function getSeparatorStyle()
+ {
+ if(($style=$this->getViewState('SeparatorStyle',null))===null)
+ {
+ $style=new TTableItemStyle;
+ $this->setViewState('SeparatorStyle',$style,null);
+ }
+ return $style;
+ }
+
+ /**
+ * @return integer the zero-based index of the selected item in {@link getItems Items}.
+ * A value -1 means no item selected.
+ */
+ public function getSelectedItemIndex()
+ {
+ return $this->getViewState('SelectedItemIndex',-1);
+ }
+
+ /**
+ * Selects an item by its index in {@link getItems Items}.
+ * Previously selected item will be un-selected.
+ * If the item to be selected is already in edit mode, it will remain in edit mode.
+ * If the index is less than 0, any existing selection will be cleared up.
+ * @param integer the selected item index
+ */
+ public function setSelectedItemIndex($value)
+ {
+ if(($value=TPropertyValue::ensureInteger($value))<0)
+ $value=-1;
+ if(($current=$this->getSelectedItemIndex())!==$value)
+ {
+ $this->setViewState('SelectedItemIndex',$value,-1);
+ $items=$this->getItems();
+ $itemCount=$items->getCount();
+ if($current>=0 && $current<$itemCount)
+ {
+ $item=$items->itemAt($current);
+ if($item->getItemType()!=='EditItem')
+ $item->setItemType($current%2?'AlternatingItem':'Item');
+ }
+ if($value>=0 && $value<$itemCount)
+ {
+ $item=$items->itemAt($value);
+ if($item->getItemType()!=='EditItem')
+ $item->setItemType('SelectedItem');
+ }
+ }
+ }
+
+ /**
+ * @return TDataListItem the selected item, null if no item is selected.
+ */
+ public function getSelectedItem()
+ {
+ $index=$this->getSelectedItemIndex();
+ $items=$this->getItems();
+ if($index>=0 && $index<$items->getCount())
+ return $items->itemAt($index);
+ else
+ return null;
+ }
+
+ /**
+ * @return integer the zero-based index of the edit item in {@link getItems Items}.
+ * A value -1 means no item is in edit mode.
+ */
+ public function getEditItemIndex()
+ {
+ return $this->getViewState('EditItemIndex',-1);
+ }
+
+ /**
+ * Edits an item by its index in {@link getItems Items}.
+ * Previously editting item will change to normal item state.
+ * If the index is less than 0, any existing edit item will be cleared up.
+ * @param integer the edit item index
+ */
+ public function setEditItemIndex($value)
+ {
+ if(($value=TPropertyValue::ensureInteger($value))<0)
+ $value=-1;
+ if(($current=$this->getEditItemIndex())!==$value)
+ {
+ $this->setViewState('EditItemIndex',$value,-1);
+ $items=$this->getItems();
+ $itemCount=$items->getCount();
+ if($current>=0 && $current<$itemCount)
+ $items->itemAt($current)->setItemType($current%2?'AlternatingItem':'Item');
+ if($value>=0 && $value<$itemCount)
+ $items->itemAt($value)->setItemType('EditItem');
+ }
+ }
+
+ /**
+ * @return TDataListItem the edit item
+ */
+ public function getEditItem()
+ {
+ $index=$this->getEditItemIndex();
+ $items=$this->getItems();
+ if($index>=0 && $index<$items->getCount())
+ return $items->itemAt($index);
+ else
+ return null;
+ }
+
+ /**
+ * @return boolean whether the header should be shown. Defaults to true.
+ */
+ public function getShowHeader()
+ {
+ return $this->getViewState('ShowHeader',true);
+ }
+
+ /**
+ * @param boolean whether to show header
+ */
+ public function setShowHeader($value)
+ {
+ $this->setViewState('ShowHeader',TPropertyValue::ensureBoolean($value),true);
+ }
+
+ /**
+ * @return boolean whether the footer should be shown. Defaults to true.
+ */
+ public function getShowFooter()
+ {
+ return $this->getViewState('ShowFooter',true);
+ }
+
+ /**
+ * @param boolean whether to show footer
+ */
+ public function setShowFooter($value)
+ {
+ $this->setViewState('ShowFooter',TPropertyValue::ensureBoolean($value),true);
+ }
+
+ /**
+ * @return TRepeatInfo repeat information (primarily used by control developers)
+ */
+ protected function getRepeatInfo()
+ {
+ if(($repeatInfo=$this->getViewState('RepeatInfo',null))===null)
+ {
+ $repeatInfo=new TRepeatInfo;
+ $this->setViewState('RepeatInfo',$repeatInfo,null);
+ }
+ return $repeatInfo;
+ }
+
+ /**
+ * @return integer the number of columns that the list should be displayed with. Defaults to 0 meaning not set.
+ */
+ public function getRepeatColumns()
+ {
+ return $this->getRepeatInfo()->getRepeatColumns();
+ }
+
+ /**
+ * @param integer the number of columns that the list should be displayed with.
+ */
+ public function setRepeatColumns($value)
+ {
+ $this->getRepeatInfo()->setRepeatColumns($value);
+ }
+
+ /**
+ * @return string the direction of traversing the list, defaults to 'Vertical'
+ */
+ public function getRepeatDirection()
+ {
+ return $this->getRepeatInfo()->getRepeatDirection();
+ }
+
+ /**
+ * @param string the direction (Vertical, Horizontal) of traversing the list
+ */
+ public function setRepeatDirection($value)
+ {
+ $this->getRepeatInfo()->setRepeatDirection($value);
+ }
+
+ /**
+ * @return string how the list should be displayed, using table or using line breaks. Defaults to 'Table'.
+ */
+ public function getRepeatLayout()
+ {
+ return $this->getRepeatInfo()->getRepeatLayout();
+ }
+
+ /**
+ * @param string how the list should be displayed, using table or using line breaks (Table, Flow)
+ */
+ public function setRepeatLayout($value)
+ {
+ $this->getRepeatInfo()->setRepeatLayout($value);
+ }
+
+ /**
+ * Handles <b>BubbleEvent</b>.
+ * This method overrides parent's implementation to handle
+ * {@link onItemCommand ItemCommand} event which is bubbled from
+ * {@link TDataListItem} child controls.
+ * If the event parameter is {@link TDataListCommandEventParameter} and
+ * the command name is a recognized one, which includes 'select', 'edit',
+ * 'delete', 'update', and 'cancel' (case-insensitive), then a
+ * corresponding command event is also raised (such as {@link onEditCommand EditCommand}).
+ * This method should only be used by control developers.
+ * @param TControl the sender of the event
+ * @param TEventParameter event parameter
+ * @return boolean whether the event bubbling should stop here.
+ */
+ protected function onBubbleEvent($sender,$param)
+ {
+ if($param instanceof TDataListCommandEventParameter)
+ {
+ $this->onItemCommand($param);
+ $command=$param->getCommandName();
+ if(strcasecmp($command,'select')===0)
+ {
+ $this->setSelectedIndex($param->getItem()->getItemIndex());
+ $this->onSelectedIndexChanged(null);
+ return true;
+ }
+ else if(strcasecmp($command,'edit')===0)
+ {
+ $this->onEditCommand($param);
+ return true;
+ }
+ else if(strcasecmp($command,'delete')===0)
+ {
+ $this->onDeleteCommand($param);
+ return true;
+ }
+ else if(strcasecmp($command,'update')===0)
+ {
+ $this->onUpdateCommand($param);
+ return true;
+ }
+ else if(strcasecmp($command,'cancel')===0)
+ {
+ $this->onCancelCommand($param);
+ return true;
+ }
+ }
+ return false;
+ }
+
+
+ /**
+ * Raises <b>ItemCreated</b> event.
+ * This method is invoked after a data list item is created and instantiated with
+ * template, but before added to the page hierarchy.
+ * The {@link TDataListItem} 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 TDataListItemEventParameter event parameter
+ */
+ public function onItemCreated($param)
+ {
+ $this->raiseEvent('ItemCreated',$this,$param);
+ }
+
+ /**
+ * Raises <b>ItemDataBound</b> event.
+ * This method is invoked right after an item is data bound.
+ * The {@link TDataListItem} 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 TDataListItemEventParameter event parameter
+ */
+ public function onItemDataBound($param)
+ {
+ $this->raiseEvent('ItemDataBound',$this,$param);
+ }
+
+ /**
+ * Raises <b>ItemCommand</b> event.
+ * This method is invoked when a child control of the data list
+ * raises an <b>Command</b> event.
+ * @param TDataListCommandEventParameter event parameter
+ */
+ protected function onItemCommand($param)
+ {
+ $this->raiseEvent('ItemCommand',$this,$param);
+ }
+
+ /**
+ * Raises <b>SelectCommand</b> event.
+ * This method is invoked when a child control of the data list
+ * raises an <b>Command</b> event and the command name is 'select' (case-insensitive).
+ * @param TDataListCommandEventParameter event parameter
+ */
+ protected function onSelectCommand($param)
+ {
+ $this->raiseEvent('SelectCommand',$this,$param);
+ }
+
+ /**
+ * Raises <b>EditCommand</b> event.
+ * This method is invoked when a child control of the data list
+ * raises an <b>Command</b> event and the command name is 'edit' (case-insensitive).
+ * @param TDataListCommandEventParameter event parameter
+ */
+ protected function onEditCommand($param)
+ {
+ $this->raiseEvent('EditCommand',$this,$param);
+ }
+
+ /**
+ * Raises <b>DeleteCommand</b> event.
+ * This method is invoked when a child control of the data list
+ * raises an <b>Command</b> event and the command name is 'delete' (case-insensitive).
+ * @param TDataListCommandEventParameter event parameter
+ */
+ protected function onDeleteCommand($param)
+ {
+ $this->raiseEvent('DeleteCommand',$this,$param);
+ }
+
+ /**
+ * Raises <b>UpdateCommand</b> event.
+ * This method is invoked when a child control of the data list
+ * raises an <b>Command</b> event and the command name is 'update' (case-insensitive).
+ * @param TDataListCommandEventParameter event parameter
+ */
+ protected function onUpdateCommand($param)
+ {
+ $this->raiseEvent('UpdateCommand',$this,$param);
+ }
+
+ /**
+ * Raises <b>CancelCommand</b> event.
+ * This method is invoked when a child control of the data list
+ * raises an <b>Command</b> event and the command name is 'cancel' (case-insensitive).
+ * @param TDataListCommandEventParameter event parameter
+ */
+ protected function onCancelCommand($param)
+ {
+ $this->raiseEvent('CancelCommand',$this,$param);
+ }
+
+ /**
+ * Returns a value indicating whether this control contains header item.
+ * This method is required by {@link IRepeatInfoUser} interface.
+ * @return boolean always false.
+ */
+ public function getHasHeader()
+ {
+ return ($this->getShowHeader() && $this->_headerTemplate!=='')
+ }
+
+ /**
+ * Returns a value indicating whether this control contains footer item.
+ * This method is required by {@link IRepeatInfoUser} interface.
+ * @return boolean always false.
+ */
+ public function getHasFooter()
+ {
+ return ($this->getShowFooter() && $this->_footerTemplate!=='')
+ }
+
+ /**
+ * Returns a value indicating whether this control contains separator items.
+ * This method is required by {@link IRepeatInfoUser} interface.
+ * @return boolean always false.
+ */
+ public function getHasSeparators()
+ {
+ return $this->_separatorTemplate!=='';
+ }
+
+ /**
+ * Returns a style used for rendering items.
+ * This method is required by {@link IRepeatInfoUser} interface.
+ * @param string item type (Header,Footer,Item,AlternatingItem,SelectedItem,EditItem,Separator,Pager)
+ * @param integer index of the item being rendered
+ * @return TStyle item style
+ */
+ public function generateItemStyle($itemType,$index)
+ {
+ if(($item=$this->getItem($itemType,$index))!==null && $item->getHasStyle())
+ return $item->getStyle();
+ else
+ return null;
+ }
+
+ private function getItem($itemType,$index)
+ {
+ switch($itemType)
+ {
+ case 'Header': return $this->getControls()->itemAt(0);
+ case 'Footer': return $this->getControls()->itemAt($this->getControls()->getCount()-1);
+ case 'Item':
+ case 'AlternatingItem':
+ case 'SelectedItem':
+ case 'EditItem':
+ return $this->getItems()->itemAt($index);
+ case 'Separator':
+ $i=$index+$index+1;
+ if($this->_headerTemplate!=='')
+ $i++;
+ return $this->getControls->itemAt($i);
+ }
+ return null
+ }
+
+ /**
+ * Initializes a data list item.
+ * The item is added as a child of the data list and the corresponding
+ * template is instantiated within the item.
+ * @param TRepeaterItem item to be initialized
+ */
+ protected function initializeItem($item)
+ {
+ $tplContent='';
+ switch($item->getItemType())
+ {
+ case 'Header': $tplContent=$this->_headerTemplate; break;
+ case 'Footer': $tplContent=$this->_footerTemplate; break;
+ case 'Item': $tplContent=$this->_itemTemplate; break;
+ case 'AlternatingItem':
+ if($this->_alternatingItemTemplate!=='')
+ $tplContent=$this->_alternatingItemTemplate;
+ else
+ $tplContent=$this->_itemTemplate;
+ break;
+ case 'Separator': $tplContent=$this->_separatorTemplate; break;
+ case 'SelectedItem':
+ if($this->_selectedItemTemplate==='')
+ {
+ if($item->getItemIndex()%2 && $this->_alternatingItemTemplate!=='')
+ $tplContent=$this->_alternatingItemTemplate;
+ else
+ $tplContent=$this->_itemTemplate;
+ }
+ else
+ $tplContent=$this->_selectedItemTemplate;
+ break;
+ case 'EditItem':
+ if($this->_editItemTemplate==='')
+ {
+ if($item->getItemIndex()===$this->getSelectedIndex() && $this->_selectedItemTemplate!=='')
+ $tplContent=$this->_selectedItemTemplate;
+ else if($item->getItemIndex()%2 && $this->_alternatingItemTemplate!=='')
+ $tplContent=$this->_alternatingItemTemplate;
+ else
+ $tplContent=$this->_itemTemplate;
+ }
+ else
+ $tplContent=$this->_editItemTemplate;
+ default: break;
+ }
+ if($tplContent!=='')
+ $this->createTemplate($tplContent)->instantiateIn($item);
+ }
+
+ protected function createTemplate($str)
+ {
+ $key=md5($str);
+ $contextPath=$this->getTemplateControl()->getTemplate()->getContextPath();
+ if(($cache=$this->getApplication()->getCache())!==null)
+ {
+ if(($template=$cache->get($key))===null)
+ {
+ $template=new TTemplate($str,$contextPath);
+ $cache->set($key,$template,self::CACHE_EXPIRY);
+ }
+ }
+ else
+ {
+ if(isset(self::$_templates[$key]))
+ $template=self::$_templates[$key];
+ else
+ {
+ $template=new TTemplate($str,$contextPath);
+ self::$_templates[$key]=$template;
+ }
+ }
+ return $template;
+ }
+
+ /**
+ * Renders an item in the list.
+ * This method is required by {@link IRepeatInfoUser} interface.
+ * @param THtmlWriter writer for rendering purpose
+ * @param TRepeatInfo repeat information
+ * @param string item type (Header,Footer,Item,AlternatingItem,SelectedItem,EditItem,Separator,Pager)
+ * @param integer zero-based index of the item in the item list
+ */
+ public function renderItem($writer,$repeatInfo,$itemType,$index)
+ {
+ $item=$this->getItems()->itemAt($index);
+ if($item->getHasAttributes())
+ $this->_repeatedControl->getAttributes()->copyFrom($item->getAttributes());
+ else if($this->_repeatedControl->getHasAttributes())
+ $this->_repeatedControl->getAttributes()->clear();
+ $this->_repeatedControl->setID("$index");
+ $this->_repeatedControl->setText($item->getText());
+ $this->_repeatedControl->setChecked($item->getSelected());
+ $this->_repeatedControl->setAttribute('value',$item->getValue());
+ $this->_repeatedControl->setEnabled($this->_isEnabled && $item->getEnabled());
+ $this->_repeatedControl->renderControl($writer);
+ }
+
+ // how to save item state??? c.f. TRepeater
+
+ /**
+ * Renders the checkbox list control.
+ * This method overrides the parent implementation.
+ * @param THtmlWriter writer for rendering purpose.
+ */
+ protected function render($writer)
+ {
+ if($this->getItemCount()>0)
+ {
+ $this->_isEnabled=$this->getEnabled(true);
+ $repeatInfo=$this->getRepeatInfo();
+ $accessKey=$this->getAccessKey();
+ $tabIndex=$this->getTabIndex();
+ $this->_repeatedControl->setTextAlign($this->getTextAlign());
+ $this->_repeatedControl->setAccessKey($accessKey);
+ $this->_repeatedControl->setTabIndex($tabIndex);
+ $this->setAccessKey('');
+ $this->setTabIndex(0);
+ $repeatInfo->renderRepeater($writer,$this);
+ $this->setAccessKey($accessKey);
+ $this->setTabIndex($tabIndex);
+ }
+ }
+}
+
+
+/**
+ * TDataListItemEventParameter class
+ *
+ * TDataListItemEventParameter encapsulates the parameter data for <b>OnItemCreated</b>
+ * event of TDataList controls.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version v1.0, last update on 2004/08/13 21:44:52
+ * @package System.Web.UI.WebControls
+ */
+class TDataListItemEventParameter extends TEventParameter
+{
+ /**
+ * The TDataListItem control responsible for the event.
+ * @var TDataListItem
+ */
+ public $item=null;
+}
+
+/**
+ * TDataListCommandEventParameter class
+ *
+ * TDataListCommandEventParameter encapsulates the parameter data for <b>OnItemCommand</b>
+ * event of TDataList controls.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version v1.0, last update on 2004/08/13 21:44:52
+ * @package System.Web.UI.WebControls
+ */
+class TDataListCommandEventParameter extends TCommandEventParameter
+{
+ /**
+ * The TDataListItem control responsible for the event.
+ * @var TDataListItem
+ */
+ public $item=null;
+ /**
+ * The control originally raises the <b>OnCommand</b> event.
+ * @var TControl
+ */
+ public $source=null;
+}
+
+
+class TDataListItemCollection extends TCollection
+{
+ protected $list=null;
+
+ public function __construct($list)
+ {
+ parent::__construct();
+ $this->list=$list;
+ }
+
+ protected function onAddItem($item)
+ {
+ if($item instanceof TDataListItem)
+ {
+ $this->list->addBody($item);
+ return true;
+ }
+ else
+ return false;
+ }
+
+ protected function onRemoveItem($item)
+ {
+ $this->list->getBodies()->remove($item);
+ }
+}
+
+
+/**
+ * TDataGridItem class
+ *
+ * A TDataGridItem control represents an item in the TDataGrid control, such
+ * as heading section, footer section, data item, or pager section. The
+ * item type can be determined by <b>Type</b> property.
+ * The data items are stored in the <b>Items</b> property of TDataGrid control.
+ * The index and data value of the item can be accessed via <b>Index</b>
+ * and <b>Data</b> properties, respectively.
+ *
+ * Since TDataGridItem inherits from TTableRow, you can also access
+ * the <b>Cells</b> property to get the table cells in the item.
+ *
+ * Namespace: System.Web.UI.WebControls
+ *
+ * Properties
+ * - <b>ItemIndex</b>, mixed
+ * <br>Gets or sets the index of the data item in the Items collection of datagrid.
+ * - <b>Data</b>, mixed
+ * <br>Gets or sets the value of the data item.
+ * - <b>Type</b>, mixed
+ * <br>Gets or sets the type of the item (Header, Footer, Item, AlternatingItem, EditItem, SelectedItem, Separator)
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version v1.0, last update on 2004/08/13 21:44:52
+ * @package System.Web.UI.WebControls
+ */
+class TDataGridItem extends TTableRow
+{
+ /**
+ * Header
+ */
+ const TYPE_HEADER='Header';
+ /**
+ * Footer
+ */
+ const TYPE_FOOTER='Footer';
+ /**
+ * Data item
+ */
+ const TYPE_ITEM='Item';
+ /**
+ * Alternating data item
+ */
+ const TYPE_ALTERNATING_ITEM='AlternatingItem';
+ /**
+ * Selected item
+ */
+ const TYPE_SELECTED_ITEM='SelectedItem';
+ /**
+ * Edit item
+ */
+ const TYPE_EDIT_ITEM='EditItem';
+ /**
+ * Pager
+ */
+ const TYPE_PAGER='Pager';
+ /**
+ * index of the data item
+ * @var mixed
+ */
+ private $index='';
+ /**
+ * value of the data item
+ * @var mixed
+ */
+ private $data=null;
+ /**
+ * type of the TDataGridItem
+ * @var string
+ */
+ private $type='';
+
+ /**
+ * Constructor.
+ * Initializes the type to 'Item'.
+ */
+ public function __construct()
+ {
+ $this->type=self::TYPE_ITEM;
+ parent::__construct();
+ }
+
+ /**
+ * @return mixed the index of the data item
+ */
+ public function getItemIndex()
+ {
+ return $this->index;
+ }
+
+ /**
+ * Sets the index of the data item
+ * @param mixed the data item index
+ */
+ public function setItemIndex($value)
+ {
+ $this->index=$value;
+ }
+
+ /**
+ * @return mixed the value of the data item
+ */
+ public function getData()
+ {
+ return $this->data;
+ }
+
+ /**
+ * Sets the value of the data item
+ * @param mixed the value of the data item
+ */
+ public function setData($value)
+ {
+ $this->data=$value;
+ }
+
+ /**
+ * @return string the item type
+ */
+ public function getType()
+ {
+ return $this->type;
+ }
+
+ /**
+ * Sets the item type
+ * @param string the item type
+ */
+ public function setType($value)
+ {
+ $this->type=$value;
+ }
+
+ /**
+ * Handles <b>OnBubbleEvent</b>.
+ * This method overrides parent's implementation to bubble
+ * <b>OnItemCommand</b> event if an <b>OnCommand</b>
+ * event is bubbled from a child control.
+ * This method should only be used by control developers.
+ * @param TControl the sender of the event
+ * @param TEventParameter event parameter
+ * @return boolean whether the event bubbling should stop here.
+ */
+ protected function onBubbleEvent($sender,$param)
+ {
+ if($param instanceof TCommandEventParameter)
+ {
+ $ce=new TDataGridCommandEventParameter;
+ $ce->name=$param->name;
+ $ce->parameter=$param->parameter;
+ $ce->source=$sender;
+ $ce->item=$this;
+ $this->raiseBubbleEvent($this,$ce);
+ return true;
+ }
+ else
+ return false;
+ }
+
+ /**
+ * Renders the body content of this table.
+ * @return string the rendering result
+ */
+ protected function renderBody()
+ {
+ $content="\n";
+ $cols=$this->getParent()->getColumns();
+ $n=$cols->length();
+ foreach($this->getCells() as $index=>$cell)
+ {
+ if($cell->isVisible())
+ {
+ if(!isset($cols[$index]) || $cols[$index]->isVisible() || $this->getType()===self::TYPE_PAGER)
+ $content.=$cell->render()."\n";
+ }
+ }
+ return $content;
+ }
+}
+
+?> \ No newline at end of file
diff --git a/framework/Web/UI/WebControls/TRepeatInfo.php b/framework/Web/UI/WebControls/TRepeatInfo.php
index 40787bb4..ce6efe8d 100644
--- a/framework/Web/UI/WebControls/TRepeatInfo.php
+++ b/framework/Web/UI/WebControls/TRepeatInfo.php
@@ -42,7 +42,7 @@ interface IRepeatInfoUser
* @param integer zero-based index of the current rendering item.
* @return TStyle CSS style used for rendering items (including header, footer and separators)
*/
- public function getItemStyle($itemType,$index);
+ public function generateItemStyle($itemType,$index);
/**
* Renders an item.
* @param THtmlWriter writer for the rendering purpose
@@ -72,14 +72,6 @@ interface IRepeatInfoUser
class TRepeatInfo extends TComponent
{
/**
- * @var string caption of the table used to organize the repeated items
- */
- private $_caption='';
- /**
- * @var string alignment of the caption of the table used to organize the repeated items
- */
- private $_captionAlign='NotSet';
- /**
* @var integer number of columns that the items should be arranged in
*/
private $_repeatColumns=0;
@@ -93,39 +85,6 @@ class TRepeatInfo extends TComponent
private $_repeatLayout='Table';
/**
- * @return string caption of the table layout
- */
- public function getCaption()
- {
- return $this->_caption;
- }
-
- /**
- * @param string caption of the table layout
- */
- public function setCaption($value)
- {
- $this->_caption=$value;
- }
-
- /**
- * @return string alignment of the caption of the table layout. Defaults to 'NotSet'.
- */
- public function getCaptionAlign()
- {
- return $this->_captionAlign;
- }
-
- /**
- * @return string alignment of the caption of the table layout.
- * Valid values include 'NotSet','Top','Bottom','Left','Right'.
- */
- public function setCaptionAlign($value)
- {
- $this->_captionAlign=TPropertyValue::ensureEnum($value,array('NotSet','Top','Bottom','Left','Right'));
- }
-
- /**
* @return integer the number of columns that the repeated items should be displayed in. Defaults to 0, meaning not set.
*/
public function getRepeatColumns()
@@ -138,7 +97,9 @@ class TRepeatInfo extends TComponent
*/
public function setRepeatColumns($value)
{
- $this->_repeatColumns=TPropertyValue::ensureInteger($value);
+ if(($value=TPropertyValue::ensureInteger($value))<0)
+ throw new TInvalidDataValueException('repeatinfo_repeatcolumns_invalid');
+ $this->_repeatColumns=$value;
}
/**
@@ -232,7 +193,7 @@ class TRepeatInfo extends TComponent
{
if($column==0)
$writer->renderBeginTag('tr');
- if(($style=$user->getItemStyle('Item',$i))!==null)
+ if(($style=$user->generateItemStyle('Item',$i))!==null)
$style->addAttributesToRender($writer);
$writer->renderBeginTag('td');
$user->renderItem($writer,$this,'Item',$i);
@@ -240,7 +201,7 @@ class TRepeatInfo extends TComponent
$writer->writeLine();
if($hasSeparators && $i!=$itemCount-1)
{
- if(($style=$user->getItemStyle('Separator',$i))!==null)
+ if(($style=$user->generateItemStyle('Separator',$i))!==null)
$style->addAttributesToRender($writer);
$writer->renderBeginTag('td');
$user->renderItem($writer,$this,'Separator',$i);
@@ -337,7 +298,7 @@ class TRepeatInfo extends TComponent
if($index>=$itemCount)
continue;
$renderedItems++;
- if(($style=$user->getItemStyle('Item',$index))!==null)
+ if(($style=$user->generateItemStyle('Item',$index))!==null)
$style->addAttributesToRender($writer);
$writer->renderBeginTag('td');
$user->renderItem($writer,$this,'Item',$index);
@@ -352,7 +313,7 @@ class TRepeatInfo extends TComponent
$writer->renderEndTag();
$writer->renderBeginTag('tr');
}
- if(($style=$user->getItemStyle('Separator',$index))!==null)
+ if(($style=$user->generateItemStyle('Separator',$index))!==null)
$style->addAttributesToRender($writer);
$writer->renderBeginTag('td');
$user->renderItem($writer,$this,'Separator',$index);
@@ -431,7 +392,7 @@ class TRepeatInfo extends TComponent
if($columns>1)
$writer->addAttribute('colspan',"$columns");
$writer->addAttribute('scope','col');
- if(($style=$user->getItemStyle('Header',-1))!==null)
+ if(($style=$user->generateItemStyle('Header',-1))!==null)
$style->addAttributesToRender($writer);
$writer->renderBeginTag('th');
$user->renderItem($writer,$this,'Header',-1);
@@ -461,7 +422,7 @@ class TRepeatInfo extends TComponent
$writer->renderBeginTag('tr');
if($columns>1)
$writer->addAttribute('colspan',"$columns");
- if(($style=$user->getItemStyle('Footer',-1))!==null)
+ if(($style=$user->generateItemStyle('Footer',-1))!==null)
$style->addAttributesToRender($writer);
$writer->renderBeginTag('td');
$user->renderItem($writer,$this,'Footer',-1);
diff --git a/framework/Web/UI/WebControls/TRepeater.php b/framework/Web/UI/WebControls/TRepeater.php
index d0d513b0..664faa68 100644
--- a/framework/Web/UI/WebControls/TRepeater.php
+++ b/framework/Web/UI/WebControls/TRepeater.php
@@ -49,6 +49,10 @@ class TRepeater extends TDataBoundControl implements INamingContainer
*/
const CACHE_EXPIRY=18000;
/**
+ * @var array in-memory cache of parsed templates
+ */
+ private static $_templates=array();
+ /**
* @var string template for each item
*/
private $_itemTemplate='';
@@ -80,10 +84,6 @@ class TRepeater extends TDataBoundControl implements INamingContainer
* @var TRepeaterItem footer item
*/
private $_footer=null;
- /**
- * @var array in-memory cache of parsed templates
- */
- private static $_templates=array();
/**
* No body content should be added to repeater.
@@ -268,29 +268,32 @@ class TRepeater extends TDataBoundControl implements INamingContainer
break;
}
if($tplContent!=='')
+ $this->createTemplate($tplContent)->instantiateIn($item);
+ }
+
+ protected function createTemplate($str)
+ {
+ $key=md5($str);
+ $contextPath=$this->getTemplateControl()->getTemplate()->getContextPath();
+ if(($cache=$this->getApplication()->getCache())!==null)
{
- $key=md5($tplContent);
- $contextPath=$this->getTemplateControl()->getTemplate()->getContextPath();
- if(($cache=$this->getApplication()->getCache())!==null)
+ if(($template=$cache->get($key))===null)
{
- if(($template=$cache->get($key))===null)
- {
- $template=new TTemplate($tplContent,$contextPath);
- $cache->set($key,$template,self::CACHE_EXPIRY);
- }
+ $template=new TTemplate($str,$contextPath);
+ $cache->set($key,$template,self::CACHE_EXPIRY);
}
+ }
+ else
+ {
+ if(isset(self::$_templates[$key]))
+ $template=self::$_templates[$key];
else
{
- if(isset(self::$_templates[$key]))
- $template=self::$_templates[$key];
- else
- {
- $template=new TTemplate($tplContent,$contextPath);
- self::$_templates[$key]=$template;
- }
+ $template=new TTemplate($str,$contextPath);
+ self::$_templates[$key]=$template;
}
- $template->instantiateIn($item);
}
+ return $template;
}
/**
@@ -387,13 +390,34 @@ class TRepeater extends TDataBoundControl implements INamingContainer
}
/**
+ * Handles <b>BubbleEvent</b>.
+ * This method overrides parent's implementation to handle
+ * {@link onItemCommand ItemCommand} event which is bubbled from
+ * {@link TRepeaterItem} child controls.
+ * This method should only be used by control developers.
+ * @param TControl the sender of the event
+ * @param TEventParameter event parameter
+ * @return boolean whether the event bubbling should stop here.
+ */
+ protected function onBubbleEvent($sender,$param)
+ {
+ if($param instanceof TRepeaterCommandEventParameter)
+ {
+ $this->onItemCommand($param);
+ return true;
+ }
+ else
+ return false;
+ }
+
+ /**
* Raises <b>ItemCreated</b> event.
* This method is invoked after a repeater item is created and instantiated with
* template, but before added to the page hierarchy.
* The {@link TRepeaterItem} 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.
- * can be determined from the event parameter.
* @param TRepeaterItemEventParameter event parameter
*/
protected function onItemCreated($param)
@@ -405,9 +429,9 @@ class TRepeater extends TDataBoundControl implements INamingContainer
* Raises <b>ItemDataBound</b> event.
* This method is invoked right after an item is data bound.
* The {@link TRepeaterItem} 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.
- * can be determined from the event parameter.
* @param TRepeaterItemEventParameter event parameter
*/
protected function onItemDataBound($param)
@@ -416,27 +440,6 @@ class TRepeater extends TDataBoundControl implements INamingContainer
}
/**
- * Handles <b>BubbleEvent</b>.
- * This method overrides parent's implementation to handle
- * {@link onItemCommand ItemCommand} event which is bubbled from
- * {@link TRepeaterItem} child controls.
- * This method should only be used by control developers.
- * @param TControl the sender of the event
- * @param TEventParameter event parameter
- * @return boolean whether the event bubbling should stop here.
- */
- protected function onBubbleEvent($sender,$param)
- {
- if($param instanceof TRepeaterCommandEventParameter)
- {
- $this->onItemCommand($param);
- return true;
- }
- else
- return false;
- }
-
- /**
* Raises <b>ItemCommand</b> event.
* This method is invoked after a button control in
* a template raises <b>Command</b> event.
diff --git a/framework/Web/UI/WebControls/TStyle.php b/framework/Web/UI/WebControls/TStyle.php
index bc77bfcf..112efbca 100644
--- a/framework/Web/UI/WebControls/TStyle.php
+++ b/framework/Web/UI/WebControls/TStyle.php
@@ -617,5 +617,4 @@ class TTableItemStyle extends TStyle
}
}
-
?> \ No newline at end of file