PHP Класс WhGridView

This grid is an extended version of TbGridView. Features are: - Display an extended summary of the records shown. The extended summary can be configured to any of the WhOperation type of widgets. - Automatic chart display (using WhHighCharts widget), where user can 'switch' between views.
Автор: Antonio Ramirez ([email protected])
Наследование: extends TbGridView
Показать файл Открыть проект Примеры использования класса

Открытые свойства

Свойство Тип Описание
$chartOptions array if configured, the extended view will display a highcharts chart.
$componentsAfterAjaxUpdate array has scripts that will be executed after components have updated. It is used internally to render scripts required for components to work correctly. You may use it for your own scripts, just make sure it is of type array.
$componentsReadyScripts array hold scripts that will be executed on document ready. It is used internally to render scripts required for components to work correctly. You may use it for your own scripts, just make sure it is of type array.
$extendedSummary array displays an extended summary version. There are different types of summary types, please, see {@link TbSumOperation}, {@link TbSumOfTypeOperation},{@link TbPercentOfTypeGooglePieOperation} {@link TbPercentOfTypeOperation} and {@link TbPercentOfTypeEasyPieOperation}. The following is an example, please review the different types of TbOperation classes to find out more about its configuration parameters.
 'extendedSummary' => array(
     'title' => '',      // the extended summary title
     'columns' => array( // the 'columns' that will be displayed at the extended summary
         'id' => array(  // column name "id"
             'class' => 'TbSumOperation', // what is the type of TbOperation we are going to display
             'label' => 'Sum of Ids'     // label is name of label of the resulted value (ie Sum of Ids:)
         ),
         'results' => array(   // column name "results"
             'class' => 'TbPercentOfTypeGooglePieOperation', // the type of TbOperation
             'label' => 'How Many Of Each? ', // the label of the operation
             'types' => array(               // TbPercentOfTypeGooglePieOperation "types" attributes
                 '0' => array('label' => 'zeros'),   // a value of "0" will be labelled "zeros"
                 '1' => array('label' => 'ones'),    // a value of "1" will be labelled "ones"
                 '2' => array('label' => 'twos'))    // a value of "2" will be labelled "twos"
         )
     )
),
$extendedSummaryCssClass string is the class name of the layer containing the extended summary
$extendedSummaryOptions array the HTML attributes of the layer containing the extended summary
$fixedHeader boolean if set to true will keep the header fixed position
$headerOffset integer , when $fixedHeader is set to true, headerOffset will position table header top position at $headerOffset. If you are using bootstrap and has navigation top fixed, its height is 40px, so it is recommended to use $headerOffset=40;
$responsiveTable whether to make the grid responsive
$template the template to be used to control the layout of various sections in the view. These tokens are recognized: {extendedSummary}, {summary}, {items} and {pager}. They will be replaced with the extended summary, summary text, the items, and the pager.

Защищенные свойства (Protected)

Свойство Тип Описание
$displayExtendedSummary boolean a helper property that is set to true if we have to render the extended summary
$extendedSummaryOperations array hold the supported operation types
$extendedSummaryTypes WhOperation[] hold the current configured TbOperation that will process column values.

Открытые методы

Метод Описание
getColumnByName ( string $name ) : CDataColumn | null Helper function to get a column by its name
init ( ) Widget initialization
registerCustomClientScript ( ) Registers required css, js and scripts Note: This script must be run at the end of content rendering not at the beginning as it is common with normal CGridViews
renderContent ( ) Renders grid content
renderExtendedSummary ( ) Renders summary
renderExtendedSummaryContent ( ) Renders summary content. Will be appended to
renderTableFooter ( ) Renders the table footer.
renderTableHeader ( ) Renders grid header
renderTableRow ( integer $row ) Renders a table body row.

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

Метод Описание
getAttribute ( CActiveRecord $data, string $attribute ) : mixed Helper function to get an attribute from the data
getPrimaryKey ( CActiveRecord $data ) : null | string Helper function to return the primary key of the $data IMPORTANT: composite keys on CActiveDataProviders will return the keys joined by comma
getSummaryOperationInstance ( string $name, array $config ) : mixed Each type of 'extended' summary
initColumns ( ) Creates column objects and initializes them.
parseColumnValue ( CDataColumn $column, integer $row ) : string Parses the value of a column by an operation

Описание методов

getAttribute() защищенный Метод

Helper function to get an attribute from the data
protected getAttribute ( CActiveRecord $data, string $attribute ) : mixed
$data CActiveRecord
$attribute string the attribute to get
Результат mixed the attribute value null if none found

getColumnByName() публичный Метод

Helper function to get a column by its name
public getColumnByName ( string $name ) : CDataColumn | null
$name string
Результат CDataColumn | null

getPrimaryKey() защищенный Метод

Helper function to return the primary key of the $data IMPORTANT: composite keys on CActiveDataProviders will return the keys joined by comma
protected getPrimaryKey ( CActiveRecord $data ) : null | string
$data CActiveRecord
Результат null | string

getSummaryOperationInstance() защищенный Метод

Each type of 'extended' summary
protected getSummaryOperationInstance ( string $name, array $config ) : mixed
$name string the name of the column
$config array the configuration of the column at the extendedSummary
Результат mixed

init() публичный Метод

Widget initialization
public init ( )

initColumns() защищенный Метод

Creates column objects and initializes them.
protected initColumns ( )

parseColumnValue() защищенный Метод

Parses the value of a column by an operation
protected parseColumnValue ( CDataColumn $column, integer $row ) : string
$column CDataColumn
$row integer the current row number
Результат string

registerCustomClientScript() публичный Метод

Registers required css, js and scripts Note: This script must be run at the end of content rendering not at the beginning as it is common with normal CGridViews

renderContent() публичный Метод

Renders grid content
public renderContent ( )

renderExtendedSummary() публичный Метод

Renders summary

renderExtendedSummaryContent() публичный Метод

Renders summary content. Will be appended to

renderTableFooter() публичный Метод

Renders the table footer.
public renderTableFooter ( )

renderTableHeader() публичный Метод

Renders grid header
public renderTableHeader ( )

renderTableRow() публичный Метод

Renders a table body row.
public renderTableRow ( integer $row )
$row integer the row number (zero-based).

Описание свойств

$chartOptions публичное свойство

if configured, the extended view will display a highcharts chart.
public array $chartOptions
Результат array

$componentsAfterAjaxUpdate публичное свойство

has scripts that will be executed after components have updated. It is used internally to render scripts required for components to work correctly. You may use it for your own scripts, just make sure it is of type array.
public array $componentsAfterAjaxUpdate
Результат array

$componentsReadyScripts публичное свойство

hold scripts that will be executed on document ready. It is used internally to render scripts required for components to work correctly. You may use it for your own scripts, just make sure it is of type array.
public array $componentsReadyScripts
Результат array

$displayExtendedSummary защищенное свойство

a helper property that is set to true if we have to render the extended summary
protected bool $displayExtendedSummary
Результат boolean

$extendedSummary публичное свойство

displays an extended summary version. There are different types of summary types, please, see {@link TbSumOperation}, {@link TbSumOfTypeOperation},{@link TbPercentOfTypeGooglePieOperation} {@link TbPercentOfTypeOperation} and {@link TbPercentOfTypeEasyPieOperation}. The following is an example, please review the different types of TbOperation classes to find out more about its configuration parameters.
 'extendedSummary' => array(
     'title' => '',      // the extended summary title
     'columns' => array( // the 'columns' that will be displayed at the extended summary
         'id' => array(  // column name "id"
             'class' => 'TbSumOperation', // what is the type of TbOperation we are going to display
             'label' => 'Sum of Ids'     // label is name of label of the resulted value (ie Sum of Ids:)
         ),
         'results' => array(   // column name "results"
             'class' => 'TbPercentOfTypeGooglePieOperation', // the type of TbOperation
             'label' => 'How Many Of Each? ', // the label of the operation
             'types' => array(               // TbPercentOfTypeGooglePieOperation "types" attributes
                 '0' => array('label' => 'zeros'),   // a value of "0" will be labelled "zeros"
                 '1' => array('label' => 'ones'),    // a value of "1" will be labelled "ones"
                 '2' => array('label' => 'twos'))    // a value of "2" will be labelled "twos"
         )
     )
),
public array $extendedSummary
Результат array

$extendedSummaryCssClass публичное свойство

is the class name of the layer containing the extended summary
public string $extendedSummaryCssClass
Результат string

$extendedSummaryOperations защищенное свойство

hold the supported operation types
protected array $extendedSummaryOperations
Результат array

$extendedSummaryOptions публичное свойство

the HTML attributes of the layer containing the extended summary
public array $extendedSummaryOptions
Результат array

$extendedSummaryTypes защищенное свойство

hold the current configured TbOperation that will process column values.
protected WhOperation[] $extendedSummaryTypes
Результат WhOperation[]

$fixedHeader публичное свойство

if set to true will keep the header fixed position
public bool $fixedHeader
Результат boolean

$headerOffset публичное свойство

, when $fixedHeader is set to true, headerOffset will position table header top position at $headerOffset. If you are using bootstrap and has navigation top fixed, its height is 40px, so it is recommended to use $headerOffset=40;
public int $headerOffset
Результат integer

$responsiveTable публичное свойство

whether to make the grid responsive
public $responsiveTable

$template публичное свойство

the template to be used to control the layout of various sections in the view. These tokens are recognized: {extendedSummary}, {summary}, {items} and {pager}. They will be replaced with the extended summary, summary text, the items, and the pager.
public $template