| 包 | zii.widgets.grid |
|---|---|
| 继承 | class CLinkColumn » CGridColumn » CComponent |
| 源自 | 1.1 |
| 版本 | $Id: CLinkColumn.php 3424 2011-10-24 20:13:19Z mdomba $ |
| 源码 |
CLinkColumn代表网格视图列呈现在它的每一个数据单元格的超链接。
label和url属性决定如何呈现每个超链接。 labelExpression，urlExpression属性可以用来代替如果它们可用。 此外，如果imageUrl被设置，将呈现一个图像链接。
label和url属性决定如何呈现每个超链接。 labelExpression，urlExpression属性可以用来代替如果它们可用。 此外，如果imageUrl被设置，将呈现一个图像链接。
公共属性
| 属性 | 类型 | 描述 | 定义在 |
|---|---|---|---|
| cssClassExpression | string | 计算PHP表达式中每一个数据元件，
其结果作为这个数据元件的CSS类名。在这个表达式中，
变量$row是行号（零基础）； $data是该行的数据模型；
$this是列的对象。 |
CGridColumn |
| footer | string | 底部元件文本。请注意，它不会变成HTML编码。 | CGridColumn |
| footerHtmlOptions | array | 尾部单元标记的HTML选项。 | CLinkColumn |
| grid | CGridView | 拥有此列的表格视图对象。 | CGridColumn |
| hasFooter | boolean | 确定此列是否有底部元件。 这决定基于是否footer已设置。 | CGridColumn |
| header | string | 头部元件文本。请注意，它不会变成HTML编码。 | CGridColumn |
| headerHtmlOptions | array | 头部单元标记的HTML选项。 | CLinkColumn |
| htmlOptions | array | 数据单元标记的HTML选项。 | CLinkColumn |
| id | string | the ID of this column. | CGridColumn |
| imageUrl | string | 图像的URL。如果此项设置，将呈现一个图像链接。 | CLinkColumn |
| label | string | 在数据单元格的超链接的标签。请注意，标签渲染的HTML将不会被HTML-encoded。 如果labelExpression设置，此属性将被忽略。 | CLinkColumn |
| labelExpression | string | 一个PHP表达式将被评估为每一个数据单元，
其结果将作为呈现的数据单元格的超链接的标签。在这个表达式，
变量$row行数（从零开始）；$data该行的数据模型；
和$this是列对象。 |
CLinkColumn |
| linkHtmlOptions | array | 超链接的HTML选项 | CLinkColumn |
| url | string | 数据单元格的超链接的URL。 如果urlExpression设置，此属性将被忽略。 | CLinkColumn |
| urlExpression | string | 一个PHP表达式将被评估为每一个数据单元，
其结果将作为呈现的数据单元格的超链接的URL。在这个表达式，
变量$row行数（从零开始）；$data该行的数据模型；
和$this是列对象。 |
CLinkColumn |
| visible | boolean | 此列是否可见。默认为true。 | CGridColumn |
公共方法
受保护方法
| 方法 | 描述 | 定义在 |
|---|---|---|
| renderDataCellContent() | 呈现数据的单元格的内容。 | CLinkColumn |
| renderFilterCellContent() | Renders the filter cell content. | CGridColumn |
| renderFooterCellContent() | Renders the footer cell content. | CGridColumn |
| renderHeaderCellContent() | Renders the header cell content. | CGridColumn |
属性详细
public array $footerHtmlOptions;
尾部单元标记的HTML选项。
headerHtmlOptions
属性
public array $headerHtmlOptions;
头部单元标记的HTML选项。
htmlOptions
属性
public array $htmlOptions;
数据单元标记的HTML选项。
imageUrl
属性
public string $imageUrl;
图像的URL。如果此项设置，将呈现一个图像链接。
label
属性
public string $label;
在数据单元格的超链接的标签。请注意，标签渲染的HTML将不会被HTML-encoded。 如果labelExpression设置，此属性将被忽略。
labelExpression
属性
public string $labelExpression;
一个PHP表达式将被评估为每一个数据单元，
其结果将作为呈现的数据单元格的超链接的标签。在这个表达式，
变量$row行数（从零开始）；$data该行的数据模型；
和$this是列对象。
linkHtmlOptions
属性
public array $linkHtmlOptions;
超链接的HTML选项
url
属性
public string $url;
数据单元格的超链接的URL。 如果urlExpression设置，此属性将被忽略。
urlExpression
属性
public string $urlExpression;
一个PHP表达式将被评估为每一个数据单元，
其结果将作为呈现的数据单元格的超链接的URL。在这个表达式，
变量$row行数（从零开始）；$data该行的数据模型；
和$this是列对象。
方法详细
renderDataCellContent()
方法
|
protected void renderDataCellContent(integer $row, mixed $data)
| ||
| $row | integer | 行号（从零开始） |
| $data | mixed | 与该行相关的数据 |
protected function renderDataCellContent($row,$data)
{
if($this->urlExpression!==null)
$url=$this->evaluateExpression($this->urlExpression,array('data'=>$data,'row'=>$row));
else
$url=$this->url;
if($this->labelExpression!==null)
$label=$this->evaluateExpression($this->labelExpression,array('data'=>$data,'row'=>$row));
else
$label=$this->label;
$options=$this->linkHtmlOptions;
if(is_string($this->imageUrl))
echo CHtml::link(CHtml::image($this->imageUrl,$label),$url,$options);
else
echo CHtml::link($label,$url,$options);
}
呈现数据的单元格的内容。 这种方法呈现数据的单元格中的超链接。