YII 类库手册

protected function createDataColumn($text)
{
    if(!preg_match('/^([\w\.]+)(:(\w*))?(:(.*))?$/',$text,$matches))
        throw new CException(Yii::t('zii','The column must be specified in the format of "Name:Type:Label", where "Type" and "Label" are optional.'));
    $column=new CDataColumn($this);
    $column->name=$matches[1];
    if(isset($matches[3]) && $matches[3]!=='')
        $column->type=$matches[3];
    if(isset($matches[5]))
        $column->header=$matches[5];
    return $column;
}

public function getFormatter()
{
    if($this->_formatter===null)
        $this->_formatter=Yii::app()->format;
    return $this->_formatter;
}

public function getHasFooter()
{
    foreach($this->columns as $column)
        if($column->getHasFooter())
            return true;
    return false;
}

public function init()
{
    parent::init();

    if(!isset($this->htmlOptions['class']))
        $this->htmlOptions['class']='grid-view';

    if($this->baseScriptUrl===null)
        $this->baseScriptUrl=Yii::app()->getAssetManager()->publish(Yii::getPathOfAlias('zii.widgets.assets')).'/gridview';

    if($this->cssFile!==false)
    {
        if($this->cssFile===null)
            $this->cssFile=$this->baseScriptUrl.'/styles.css';
        Yii::app()->getClientScript()->registerCssFile($this->cssFile);
    }

    $this->initColumns();
}

protected function initColumns()
{
    if($this->columns===array())
    {
        if($this->dataProvider instanceof CActiveDataProvider)
            $this->columns=$this->dataProvider->model->attributeNames();
        else if($this->dataProvider instanceof IDataProvider)
        {
            // use the keys of the first row of data as the default columns
            $data=$this->dataProvider->getData();
            if(isset($data[0]) && is_array($data[0]))
                $this->columns=array_keys($data[0]);
        }
    }
    $id=$this->getId();
    foreach($this->columns as $i=>$column)
    {
        if(is_string($column))
            $column=$this->createDataColumn($column);
        else
        {
            if(!isset($column['class']))
                $column['class']='CDataColumn';
            $column=Yii::createComponent($column, $this);
        }
        if(!$column->visible)
        {
            unset($this->columns[$i]);
            continue;
        }
        if($column->id===null)
            $column->id=$id.'_c'.$i;
        $this->columns[$i]=$column;
    }

    foreach($this->columns as $column)
        $column->init();
}

public function registerClientScript()
{
    $id=$this->getId();

    if($this->ajaxUpdate===false)
        $ajaxUpdate=false;
    else
        $ajaxUpdate=array_unique(preg_split('/\s*,\s*/',$this->ajaxUpdate.','.$id,-1,PREG_SPLIT_NO_EMPTY));
    $options=array(
        'ajaxUpdate'=>$ajaxUpdate,
        'ajaxVar'=>$this->ajaxVar,
        'pagerClass'=>$this->pagerCssClass,
        'loadingClass'=>$this->loadingCssClass,
        'filterClass'=>$this->filterCssClass,
        'tableClass'=>$this->itemsCssClass,
        'selectableRows'=>$this->selectableRows,
    );
    if($this->ajaxUrl!==null)
        $options['url']=CHtml::normalizeUrl($this->ajaxUrl);
    if($this->updateSelector!==null)
        $options['updateSelector']=$this->updateSelector;
    if($this->enablePagination)
        $options['pageVar']=$this->dataProvider->getPagination()->pageVar;
    if($this->beforeAjaxUpdate!==null)
        $options['beforeAjaxUpdate']=(strpos($this->beforeAjaxUpdate,'js:')!==0 ? 'js:' : '').$this->beforeAjaxUpdate;
    if($this->afterAjaxUpdate!==null)
        $options['afterAjaxUpdate']=(strpos($this->afterAjaxUpdate,'js:')!==0 ? 'js:' : '').$this->afterAjaxUpdate;
    if($this->ajaxUpdateError!==null)
        $options['ajaxUpdateError']=(strpos($this->ajaxUpdateError,'js:')!==0 ? 'js:' : '').$this->ajaxUpdateError;
    if($this->selectionChanged!==null)
        $options['selectionChanged']=(strpos($this->selectionChanged,'js:')!==0 ? 'js:' : '').$this->selectionChanged;

    $options=CJavaScript::encode($options);
    $cs=Yii::app()->getClientScript();
    $cs->registerCoreScript('jquery');
    $cs->registerCoreScript('bbq');
    $cs->registerScriptFile($this->baseScriptUrl.'/jquery.yiigridview.js',CClientScript::POS_END);
    $cs->registerScript(__CLASS__.'#'.$id,"jQuery('#$id').yiiGridView($options);");
}

public function renderFilter()
{
    if($this->filter!==null)
    {
        echo "<tr class=\"{$this->filterCssClass}\">\n";
        foreach($this->columns as $column)
            $column->renderFilterCell();
        echo "</tr>\n";
    }
}

public function renderItems()
{
    if($this->dataProvider->getItemCount()>0 || $this->showTableOnEmpty)
    {
        echo "<table class=\"{$this->itemsCssClass}\">\n";
        $this->renderTableHeader();
        ob_start();
        $this->renderTableBody();
        $body=ob_get_clean();
        $this->renderTableFooter();
        echo $body; // TFOOT must appear before TBODY according to the standard.
        echo "</table>";
    }
    else
        $this->renderEmptyText();
}

public function renderTableBody()
{
    $data=$this->dataProvider->getData();
    $n=count($data);
    echo "<tbody>\n";

    if($n>0)
    {
        for($row=0;$row<$n;++$row)
            $this->renderTableRow($row);
    }
    else
    {
        echo '<tr><td colspan="'.count($this->columns).'">';
        $this->renderEmptyText();
        echo "</td></tr>\n";
    }
    echo "</tbody>\n";
}

public function renderTableFooter()
{
    $hasFilter=$this->filter!==null && $this->filterPosition===self::FILTER_POS_FOOTER;
    $hasFooter=$this->getHasFooter();
    if($hasFilter || $hasFooter)
    {
        echo "<tfoot>\n";
        if($hasFooter)
        {
            echo "<tr>\n";
            foreach($this->columns as $column)
                $column->renderFooterCell();
            echo "</tr>\n";
        }
        if($hasFilter)
            $this->renderFilter();
        echo "</tfoot>\n";
    }
}

public function renderTableHeader()
{
    if(!$this->hideHeader)
    {
        echo "<thead>\n";

        if($this->filterPosition===self::FILTER_POS_HEADER)
            $this->renderFilter();

        echo "<tr>\n";
        foreach($this->columns as $column)
            $column->renderHeaderCell();
        echo "</tr>\n";

        if($this->filterPosition===self::FILTER_POS_BODY)
            $this->renderFilter();

        echo "</thead>\n";
    }
    else if($this->filter!==null && ($this->filterPosition===self::FILTER_POS_HEADER || $this->filterPosition===self::FILTER_POS_BODY))
    {
        echo "<thead>\n";
        $this->renderFilter();
        echo "</thead>\n";
    }
}

public function renderTableRow($row)
{
    if($this->rowCssClassExpression!==null)
    {
        $data=$this->dataProvider->data[$row];
        echo '<tr class="'.$this->evaluateExpression($this->rowCssClassExpression,array('row'=>$row,'data'=>$data)).'">';
    }
    else if(is_array($this->rowCssClass) && ($n=count($this->rowCssClass))>0)
        echo '<tr class="'.$this->rowCssClass[$row%$n].'">';
    else
        echo '<tr>';
    foreach($this->columns as $column)
        $column->renderDataCell($row);
    echo "</tr>\n";
}

public function setFormatter($value)
{
    $this->_formatter=$value;
}