YII 类库手册
> YII 类库手册 > CLinkColumn
包 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被设置，将呈现一个图像链接。

公共属性

属性 类型 描述 定义在
cssClassExpression string 计算PHP表达式中每一个数据元件， 其结果作为这个数据元件的CSS类名。在这个表达式中， 变量$row是行号（零基础）； $data是该行的数据模型； $this是列的对象。 CGridColumn
footerHtmlOptions array 尾部单元标记的HTML选项。 CLinkColumn
grid CGridView 拥有此列的表格视图对象。 CGridColumn
hasFooter boolean 确定此列是否有底部元件。 这决定基于是否footer已设置。 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

公共方法

方法 描述 定义在
__call() 如果类中没有调的方法名，则调用这个方法。 CComponent
__construct() 构造方法。 CGridColumn
__get() 返回一个属性值、一个事件处理程序列表或一个行为名称。 CComponent
__isset() 检查一个属性是否为null。 CComponent
__set() 设置一个组件的属性值。 CComponent
__unset() 设置一个组件的属性为null。 CComponent
asa() 返回这个名字的行为对象。 CComponent
attachBehavior() 附加一个行为到组件。 CComponent
attachBehaviors() 附加一个行为列表到组件。 CComponent
attachEventHandler() 为事件附加一个事件处理程序。 CComponent
canGetProperty() 确定属性是否可读。 CComponent
canSetProperty() 确定属性是否可写。 CComponent
detachBehavior() 从组件中分离一个行为。 CComponent
detachBehaviors() 从组件中分离所有行为。 CComponent
detachEventHandler() 分离一个存在的事件处理程序。 CComponent
disableBehavior() 禁用一个附加行为。 CComponent
disableBehaviors() 禁用组件附加的所有行为。 CComponent
enableBehavior() 启用一个附加行为。 CComponent
enableBehaviors() 启用组件附加的所有行为。 CComponent
evaLuateExpression() 计算一个PHP表达式，或根据组件上下文执行回调。 CComponent
getEventHandlers() 返回一个事件的附加处理程序列表。 CComponent
getHasFooter() 返回确定此列是否有底部元件。 这决定基于是否footer已设置。 CGridColumn
hasEvent() 确定一个事件是否定义。 CComponent
hasEventHandler() 检查事件是否有附加的处理程序。 CComponent
hasProperty() 确定属性是否被定义。 CComponent
init() 初始化列。 CGridColumn
raiseEvent() 发起一个事件。 CComponent
renderDataCell() 渲染一个数据元件。 CGridColumn
renderFilterCell() 渲染过滤器元件。 CGridColumn
renderFooterCell() 渲染底部元件。 CGridColumn
renderHeaderCell() 渲染头部元件。 CGridColumn

受保护方法

方法 描述 定义在
renderDataCellContent() 呈现数据的单元格的内容。 CLinkColumn
renderFilterCellContent() Renders the filter cell content. CGridColumn
renderFooterCellContent() Renders the footer cell content. CGridColumn
renderHeaderCellContent() Renders the header cell content. CGridColumn

属性详细

footerHtmlOptions 属性
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
labelExpression 属性
public string $labelExpression;

一个PHP表达式将被评估为每一个数据单元， 其结果将作为呈现的数据单元格的超链接的标签。在这个表达式， 变量$row行数（从零开始）；$data该行的数据模型； 和$this是列对象。

linkHtmlOptions 属性
public array $linkHtmlOptions;

超链接的HTML选项

url 属性
public string $url;

数据单元格的超链接的URL。 如果urlExpression设置，此属性将被忽略。

参见

  • 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);
}

呈现数据的单元格的内容。 这种方法呈现数据的单元格中的超链接。

上一篇：