Spec-Zone.ru › Yii 1.1

CGridColumn

Пакет zii.widgets.grid
Наследование абстрактный класс CGridColumn » CComponent
Подклассы CButtonColumn, CCheckBoxColumn, CDataColumn, CLinkColumn
С версии 1.1
Исходный код framework/zii/widgets/grid/CGridColumn.php
CGridColumn — базовый класс для всех классов столбцов представления таблицы.

Объект CGridColumn представляет собой спецификацию для отображения ячеек в конкретном столбце представления таблицы.

В столбце есть одна ячейка заголовка, несколько ячеек данных и необязательная ячейка подвала. Подклассы могут переопределять renderHeaderCellContent, renderDataCellContent и renderFooterCellContent для настройки отображения этих ячеек.

Свойства

Свойство Тип Описание Определено
cssClassExpression строка PHP выражение, которое вычисляется для каждой ячейки данных, и результат используется как имя класса CSS для ячейки данных. CGridColumn
filterCellContent строка Возвращает содержимое ячейки фильтра. CGridColumn
filterHtmlOptions массив HTML атрибуты тега ячейки фильтра. CGridColumn
footer строка текст ячейки подвала. CGridColumn
footerCellContent строка Возвращает содержимое ячейки подвала. CGridColumn
footerHtmlOptions массив HTML атрибуты тега ячейки подвала. CGridColumn
grid CGridView объект представления таблицы, владеющий этим столбцом. CGridColumn
hasFooter логическое указывает, имеет ли этот столбец ячейку подвала. CGridColumn
header строка текст ячейки заголовка. CGridColumn
headerCellContent строка Возвращает содержимое ячейки заголовка. CGridColumn
headerHtmlOptions массив HTML атрибуты тега ячейки заголовка. CGridColumn
htmlOptions массив HTML атрибуты тегов ячеек данных. CGridColumn
id строка идентификатор этого столбца. CGridColumn
visible логическое указывает, виден ли этот столбец. CGridColumn

Общедоступные методы

Метод Описание Определено
__call() Вызывает метод, который не является методом класса. CComponent
__construct() Конструктор. CGridColumn
__get() Возвращает значение свойства, список обработчиков событий или поведение на основе его имени. CComponent
__isset() Проверяет, является ли значение свойства нулевым. 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
getDataCellContent() Возвращает содержимое ячейки данных. CGridColumn
getEventHandlers() Возвращает список присоединенных обработчиков событий для события. CComponent
getFilterCellContent() Возвращает содержимое ячейки фильтра. CGridColumn
getFooterCellContent() Возвращает содержимое ячейки подвала. CGridColumn
getHasFooter() Возвращает, имеет ли этот столбец ячейку подвала. Это определяется на основе того, задано ли footer. CGridColumn
getHeaderCellContent() Возвращает содержимое ячейки заголовка. CGridColumn
hasEvent() Определяет, определено ли событие. CComponent
hasEventHandler() Проверяет, есть ли присоединенные обработчики для события с указанным именем. CComponent
hasProperty() Определяет, определено ли свойство. CComponent
init() Инициализирует столбец. CGridColumn
raiseEvent() Вызывает событие. CComponent
renderDataCell() Отображает ячейку данных. CGridColumn
renderFilterCell() Отображает ячейку фильтра. CGridColumn
renderFooterCell() Отображает ячейку подвала. CGridColumn
renderHeaderCell() Отображает ячейку заголовка. CGridColumn
END_OF_DOCUMENT_MARKER

Защищенные методы

Метод Описание Определено в
renderDataCellContent() Отображает содержимое ячейки данных. CGridColumn
renderFilterCellContent() Отображает содержимое ячейки фильтра. CGridColumn
renderFooterCellContent() Отображает содержимое ячейки подвала. CGridColumn
renderHeaderCellContent() Отображает содержимое ячейки заголовка. CGridColumn

Подробное описание свойств

cssClassExpression свойство

public string $cssClassExpression;

PHP-выражение, которое вычисляется для каждой ячейки данных, и результат которого используется в качестве имени класса CSS для ячейки данных. В этом выражении можно использовать следующие переменные:

  • $row номер строки (нумерация с нуля)
  • $data модель данных для строки
  • $this объект столбца
PHP-выражение будет вычислено с помощью evaluateExpression.

PHP-выражение может быть любым PHP-кодом, имеющим значение. Чтобы узнать больше о том, что такое выражение, обратитесь к руководству PHP.

filterCellContent свойство только для чтения (доступно начиная с версии v1.1.16)

public string getFilterCellContent()

Возвращает содержимое ячейки фильтра. По умолчанию возвращается пустой столбец. Этот метод можно переопределить для настройки отображения ячейки фильтра (если она есть).

filterHtmlOptions свойство

public array $filterHtmlOptions;

HTML-атрибуты тега ячейки фильтра.

footer свойство

public string $footer;

Текст ячейки подвала. Обратите внимание, что он не будет HTML-кодирован.

footerCellContent свойство только для чтения (доступно начиная с версии v1.1.16)

public string getFooterCellContent()

Возвращает содержимое ячейки подвала. По умолчанию возвращает footer. Этот метод можно переопределить для настройки отображения ячейки подвала.

footerHtmlOptions свойство

public array $footerHtmlOptions;

HTML-атрибуты тега ячейки подвала.

grid свойство

public CGridView $grid;

Объект представления таблицы, которому принадлежит этот столбец.

hasFooter свойство только для чтения

public boolean getHasFooter()

Признак наличия ячейки подвала у этого столбца. Определяется на основе наличия footer.

header свойство

public string $header;

Текст ячейки заголовка. Обратите внимание, что он не будет HTML-кодирован.

headerCellContent свойство только для чтения (доступно начиная с версии v1.1.16)

public string getHeaderCellContent()

Возвращает содержимое ячейки заголовка. По умолчанию возвращает header. Этот метод можно переопределить для настройки отображения ячейки заголовка.

headerHtmlOptions свойство

public array $headerHtmlOptions;

HTML-атрибуты тега ячейки заголовка.

htmlOptions свойство

public array $htmlOptions;

HTML-атрибуты тегов ячеек данных.

id свойство

public string $id;

Идентификатор этого столбца. Это значение должно быть уникальным среди всех столбцов представления таблицы. Если не задано, будет присвоено автоматически.

visible свойство

public boolean $visible;

Признак видимости этого столбца. По умолчанию true.

Подробное описание методов

__construct() метод

public void __construct(CGridView $grid)
$grid CGridView представление таблицы, которому принадлежит этот столбец.
Исходный код: framework/zii/widgets/grid/CGridColumn.php#89 (показать)
public function __construct($grid)
{
    
$this->grid=$grid;
}

Конструктор.

getDataCellContent() метод (доступно начиная с v1.1.16)

public string getDataCellContent(integer $row)
$row целое число номер строки (нумерация с нуля) Данные для этой строки доступны через $this->grid->dataProvider->data[$row];
{return} строка содержимое ячейки данных.
Исходный код: framework/zii/widgets/grid/CGridColumn.php#218 (показать)
public function getDataCellContent($row)
{
    return 
$this->grid->blankDisplay;
}

Возвращает содержимое ячейки данных. Этот метод ДОЛЖЕН быть переопределен для настройки отображения ячейки данных.

getFilterCellContent() метод (доступно начиная с v1.1.16)

public string getFilterCellContent()
{return} строка содержимое ячейки фильтра.
Исходный код: framework/zii/widgets/grid/CGridColumn.php#241 (показать)
public function getFilterCellContent()
{
    return 
$this->grid->blankDisplay;
}

Возвращает содержимое ячейки фильтра. По умолчанию возвращается пустой столбец. Этот метод можно переопределить для настройки отображения ячейки фильтра (если она есть).

getFooterCellContent() метод (доступно начиная с v1.1.16)

public string getFooterCellContent()
{return} строка содержимое ячейки подвала.
Исходный код: framework/zii/widgets/grid/CGridColumn.php#196 (показать)
public function getFooterCellContent()
{
    return 
trim($this->footer)!=='' ? $this->footer : $this->grid->blankDisplay;
}

Возвращает содержимое ячейки подвала. По умолчанию возвращает footer. Этот метод можно переопределить для настройки отображения ячейки подвала.

getHasFooter() метод

public boolean getHasFooter()
{return} булево признак наличия ячейки подвала у этого столбца. Определяется на основе наличия footer.
Исходный код: framework/zii/widgets/grid/CGridColumn.php#107 (показать)
public function getHasFooter()
{
    return 
$this->footer!==null;
}

getHeaderCellContent() метод (доступно начиная с v1.1.16)

public string getHeaderCellContent()
{return} строка содержимое ячейки заголовка.
Исходный код: framework/zii/widgets/grid/CGridColumn.php#175 (показать)
public function getHeaderCellContent()
{
    return 
trim($this->header)!=='' ? $this->header : $this->grid->blankDisplay;
}

Возвращает содержимое ячейки заголовка. По умолчанию возвращает header. Этот метод можно переопределить для настройки отображения ячейки заголовка.

init() метод

public void init()
Исходный код: framework/zii/widgets/grid/CGridColumn.php#99 (показать)
public function init()
{
}

Инициализирует столбец. Вызывается представлением таблицы при инициализации перед отображением. Можно переопределить этот метод для подготовки столбца к отображению.

renderDataCell() метод

public void renderDataCell(integer $row)
$row целое число номер строки (нумерация с нуля)
Исходный код: framework/zii/widgets/grid/CGridColumn.php#138 (показать)
public function renderDataCell($row)
{
    
$data=$this->grid->dataProvider->data[$row];
    
$options=$this->htmlOptions;
    if(
$this->cssClassExpression!==null)
    {
        
$class=$this->evaluateExpression($this->cssClassExpression,array('row'=>$row,'data'=>$data));
        if(!empty(
$class))
        {
            if(isset(
$options['class']))
                
$options['class'].=' '.$class;
            else
                
$options['class']=$class;
        }
    }
    echo 
CHtml::openTag('td',$options);
    
$this->renderDataCellContent($row,$data);
    echo 
'</td>';
}

Отображает ячейку данных.

renderDataCellContent() метод

protected void renderDataCellContent(integer $row, mixed $data)
$row целое число номер строки (нумерация с нуля)
$data смешанный тип данные, связанные со строкой
Исходный код: framework/zii/widgets/grid/CGridColumn.php#229 (показать)
protected function renderDataCellContent($row,$data)
{
    echo 
$this->getDataCellContent($row);
}

Отображает содержимое ячейки данных.

renderFilterCell() метод (доступен начиная с v1.1.1)

public void renderFilterCell()
Исходный код: framework/zii/widgets/grid/CGridColumn.php#116 (показать)
public function renderFilterCell()
{
    echo 
CHtml::openTag('td',$this->filterHtmlOptions);
    
$this->renderFilterCellContent();
    echo 
"</td>";
}

Отображает ячейку фильтра.

renderFilterCellContent() метод (доступен начиная с v1.1.1)

protected void renderFilterCellContent()
Исходный код: framework/zii/widgets/grid/CGridColumn.php#251 (показать)
protected function renderFilterCellContent()
{
    echo 
$this->getFilterCellContent();
}

Отображает содержимое ячейки фильтра.

renderFooterCell() метод

public void renderFooterCell()
Исходный код: framework/zii/widgets/grid/CGridColumn.php#161 (показать)
public function renderFooterCell()
{
    echo 
CHtml::openTag('td',$this->footerHtmlOptions);
    
$this->renderFooterCellContent();
    echo 
'</td>';
}

Отображает ячейку подвала.

renderFooterCellContent() метод

protected void renderFooterCellContent()
Исходный код: framework/zii/widgets/grid/CGridColumn.php#205 (показать)
protected function renderFooterCellContent()
{
    echo 
$this->getFooterCellContent();
}

Отображает содержимое ячейки подвала.

renderHeaderCell() метод

public void renderHeaderCell()
Исходный код: framework/zii/widgets/grid/CGridColumn.php#126 (показать)
public function renderHeaderCell()
{
    
$this->headerHtmlOptions['id']=$this->id;
    echo 
CHtml::openTag('th',$this->headerHtmlOptions);
    
$this->renderHeaderCellContent();
    echo 
"</th>";
}

Отображает ячейку заголовка.

renderHeaderCellContent() метод

protected void renderHeaderCellContent()
Исходный код: framework/zii/widgets/grid/CGridColumn.php#184 (показать)
protected function renderHeaderCellContent()
{
    echo 
$this->getHeaderCellContent();
}

Отображает содержимое ячейки заголовка.

© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc/api/1.1/CGridColumn

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API