CGridColumn
| Пакет | zii.widgets.grid |
|---|---|
| Наследование | абстрактный класс CGridColumn » CComponent |
| Подклассы | CButtonColumn, CCheckBoxColumn, CDataColumn, CLinkColumn |
| С версии | 1.1 |
| Исходный код | framework/zii/widgets/grid/CGridColumn.php |
Объект 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 |
Защищенные методы
| Метод | Описание | Определено в |
|---|---|---|
| renderDataCellContent() | Отображает содержимое ячейки данных. | CGridColumn |
| renderFilterCellContent() | Отображает содержимое ячейки фильтра. | CGridColumn |
| renderFooterCellContent() | Отображает содержимое ячейки подвала. | CGridColumn |
| renderHeaderCellContent() | Отображает содержимое ячейки заголовка. | CGridColumn |
Подробное описание свойств
cssClassExpression свойство
public string $cssClassExpression;
PHP-выражение, которое вычисляется для каждой ячейки данных, и результат которого используется в качестве имени класса CSS для ячейки данных. В этом выражении можно использовать следующие переменные:
-
$rowномер строки (нумерация с нуля) -
$dataмодель данных для строки -
$thisобъект столбца
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 | представление таблицы, которому принадлежит этот столбец. |
public function __construct($grid)
{
$this->grid=$grid;
}
Конструктор.
getDataCellContent() метод (доступно начиная с v1.1.16)
public string getDataCellContent(integer $row) | ||
| $row | целое число | номер строки (нумерация с нуля) Данные для этой строки доступны через $this->grid->dataProvider->data[$row];
|
| {return} | строка | содержимое ячейки данных. |
public function getDataCellContent($row)
{
return $this->grid->blankDisplay;
}
Возвращает содержимое ячейки данных. Этот метод ДОЛЖЕН быть переопределен для настройки отображения ячейки данных.
getFilterCellContent() метод (доступно начиная с v1.1.16)
public string getFilterCellContent() | ||
| {return} | строка | содержимое ячейки фильтра. |
public function getFilterCellContent()
{
return $this->grid->blankDisplay;
}
Возвращает содержимое ячейки фильтра. По умолчанию возвращается пустой столбец. Этот метод можно переопределить для настройки отображения ячейки фильтра (если она есть).
getFooterCellContent() метод (доступно начиная с v1.1.16)
public string getFooterCellContent() | ||
| {return} | строка | содержимое ячейки подвала. |
public function getFooterCellContent()
{
return trim($this->footer)!=='' ? $this->footer : $this->grid->blankDisplay;
}
Возвращает содержимое ячейки подвала. По умолчанию возвращает footer. Этот метод можно переопределить для настройки отображения ячейки подвала.
getHasFooter() метод
public boolean getHasFooter() | ||
| {return} | булево | признак наличия ячейки подвала у этого столбца. Определяется на основе наличия footer. |
public function getHasFooter()
{
return $this->footer!==null;
}
getHeaderCellContent() метод (доступно начиная с v1.1.16)
public string getHeaderCellContent() | ||
| {return} | строка | содержимое ячейки заголовка. |
public function getHeaderCellContent()
{
return trim($this->header)!=='' ? $this->header : $this->grid->blankDisplay;
}
Возвращает содержимое ячейки заголовка. По умолчанию возвращает header. Этот метод можно переопределить для настройки отображения ячейки заголовка.
init() метод
public void init() |
Инициализирует столбец. Вызывается представлением таблицы при инициализации перед отображением. Можно переопределить этот метод для подготовки столбца к отображению.
renderDataCell() метод
public void renderDataCell(integer $row) | ||
| $row | целое число | номер строки (нумерация с нуля) |
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 | смешанный тип | данные, связанные со строкой |
protected function renderDataCellContent($row,$data)
{
echo $this->getDataCellContent($row);
}
Отображает содержимое ячейки данных.
renderFilterCell() метод (доступен начиная с v1.1.1)
public void renderFilterCell() |
public function renderFilterCell()
{
echo CHtml::openTag('td',$this->filterHtmlOptions);
$this->renderFilterCellContent();
echo "</td>";
}
Отображает ячейку фильтра.
renderFilterCellContent() метод (доступен начиная с v1.1.1)
protected void renderFilterCellContent() |
protected function renderFilterCellContent()
{
echo $this->getFilterCellContent();
}
Отображает содержимое ячейки фильтра.
renderFooterCell() метод
public void renderFooterCell() |
public function renderFooterCell()
{
echo CHtml::openTag('td',$this->footerHtmlOptions);
$this->renderFooterCellContent();
echo '</td>';
}
Отображает ячейку подвала.
renderFooterCellContent() метод
protected void renderFooterCellContent() |
protected function renderFooterCellContent()
{
echo $this->getFooterCellContent();
}
Отображает содержимое ячейки подвала.
renderHeaderCell() метод
public void renderHeaderCell() |
public function renderHeaderCell()
{
$this->headerHtmlOptions['id']=$this->id;
echo CHtml::openTag('th',$this->headerHtmlOptions);
$this->renderHeaderCellContent();
echo "</th>";
}
Отображает ячейку заголовка.
renderHeaderCellContent() метод
protected void renderHeaderCellContent() |
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