Column
extends BaseObject
in package
Column is the base class of all [[SpreadsheetExport]] column classes.
This class was originally developed by Paul Klimov klimov.paul@gmail.com and his project csv-grid (https://github.com/yii2tech/csv-grid).
Table of Contents
Properties
- $content : callable
- $dataType : string|null
- $footer : string
- $grid : SpreadsheetExport
- $header : string
- $styles : array<string|int, mixed>
- $visible : bool
Methods
- __call() : mixed
- Calls the named method which is not a class method.
- __construct() : mixed
- Constructor.
- __get() : mixed
- Returns the value of an object property.
- __isset() : bool
- Checks if a property is set, i.e. defined and not null.
- __set() : mixed
- Sets value of an object property.
- __unset() : mixed
- Sets an object property to null.
- canGetProperty() : bool
- Returns a value indicating whether a property can be read.
- canSetProperty() : bool
- Returns a value indicating whether a property can be set.
- className() : string
- Returns the fully qualified name of this class.
- hasMethod() : bool
- Returns a value indicating whether a method is defined.
- hasProperty() : bool
- Returns a value indicating whether a property is defined.
- init() : mixed
- Initializes the object.
- renderDataCellContent() : string
- Renders the data cell content.
- renderFooterCellContent() : string
- Renders the footer cell content.
- renderHeaderCellContent() : string
- Renders the header cell content.
Properties
$content
public
callable
$content
This is a callable that will be used to generate the content of each cell.
The signature of the function should be the following: function ($model, $key, $index, $column)
.
Where $model
, $key
, and $index
refer to the model, key and index of the row currently being rendered
and $column
is a reference to the [[Column]] object.
$dataType
public
string|null
$dataType
= null
specify data type
Tags
$footer
public
string
$footer
the footer cell content. Note that it will not be HTML-encoded.
$grid
public
SpreadsheetExport
$grid
the grid view object that owns this column.
$header
public
string
$header
the header cell content. Note that it will not be HTML-encoded.
$styles
public
array<string|int, mixed>
$styles
= []
containing style information
Tags
$visible
public
bool
$visible
= true
whether this column is visible. Defaults to true.
Methods
__call()
Calls the named method which is not a class method.
public
__call(string $name, array<string|int, mixed> $params) : mixed
Do not call this method directly as it is a PHP magic method that will be implicitly called when an unknown method is being invoked.
Parameters
- $name : string
-
the method name
- $params : array<string|int, mixed>
-
method parameters
Tags
Return values
mixed —the method return value
__construct()
Constructor.
public
__construct([array<string|int, mixed> $config = [] ]) : mixed
The default implementation does two things:
- Initializes the object with the given configuration
$config
. - Call [[init()]].
If this method is overridden in a child class, it is recommended that
- the last parameter of the constructor is a configuration array, like
$config
here. - call the parent implementation at the end of the constructor.
Parameters
- $config : array<string|int, mixed> = []
-
name-value pairs that will be used to initialize the object properties
__get()
Returns the value of an object property.
public
__get(string $name) : mixed
Do not call this method directly as it is a PHP magic method that
will be implicitly called when executing $value = $object->property;
.
Parameters
- $name : string
-
the property name
Tags
Return values
mixed —the property value
__isset()
Checks if a property is set, i.e. defined and not null.
public
__isset(string $name) : bool
Do not call this method directly as it is a PHP magic method that
will be implicitly called when executing isset($object->property)
.
Note that if the property is not defined, false will be returned.
Parameters
- $name : string
-
the property name or the event name
Tags
Return values
bool —whether the named property is set (not null).
__set()
Sets value of an object property.
public
__set(string $name, mixed $value) : mixed
Do not call this method directly as it is a PHP magic method that
will be implicitly called when executing $object->property = $value;
.
Parameters
- $name : string
-
the property name or the event name
- $value : mixed
-
the property value
Tags
__unset()
Sets an object property to null.
public
__unset(string $name) : mixed
Do not call this method directly as it is a PHP magic method that
will be implicitly called when executing unset($object->property)
.
Note that if the property is not defined, this method will do nothing. If the property is read-only, it will throw an exception.
Parameters
- $name : string
-
the property name
Tags
canGetProperty()
Returns a value indicating whether a property can be read.
public
canGetProperty(string $name[, bool $checkVars = true ]) : bool
A property is readable if:
- the class has a getter method associated with the specified name (in this case, property name is case-insensitive);
- the class has a member variable with the specified name (when
$checkVars
is true);
Parameters
- $name : string
-
the property name
- $checkVars : bool = true
-
whether to treat member variables as properties
Tags
Return values
bool —whether the property can be read
canSetProperty()
Returns a value indicating whether a property can be set.
public
canSetProperty(string $name[, bool $checkVars = true ]) : bool
A property is writable if:
- the class has a setter method associated with the specified name (in this case, property name is case-insensitive);
- the class has a member variable with the specified name (when
$checkVars
is true);
Parameters
- $name : string
-
the property name
- $checkVars : bool = true
-
whether to treat member variables as properties
Tags
Return values
bool —whether the property can be written
className()
Returns the fully qualified name of this class.
public
static className() : string
Tags
Return values
string —the fully qualified name of this class.
hasMethod()
Returns a value indicating whether a method is defined.
public
hasMethod(string $name) : bool
The default implementation is a call to php function method_exists()
.
You may override this method when you implemented the php magic method __call()
.
Parameters
- $name : string
-
the method name
Return values
bool —whether the method is defined
hasProperty()
Returns a value indicating whether a property is defined.
public
hasProperty(string $name[, bool $checkVars = true ]) : bool
A property is defined if:
- the class has a getter or setter method associated with the specified name (in this case, property name is case-insensitive);
- the class has a member variable with the specified name (when
$checkVars
is true);
Parameters
- $name : string
-
the property name
- $checkVars : bool = true
-
whether to treat member variables as properties
Tags
Return values
bool —whether the property is defined
init()
Initializes the object.
public
init() : mixed
This method is invoked at the end of the constructor after the object is initialized with the given configuration.
renderDataCellContent()
Renders the data cell content.
public
renderDataCellContent(mixed $model, mixed $key, int $index) : string
Parameters
- $model : mixed
-
the data model
- $key : mixed
-
the key associated with the data model
- $index : int
-
zero-based index of data model among models array returned by [[GridView::dataProvider]].
Return values
string —the rendering result
renderFooterCellContent()
Renders the footer cell content.
public
renderFooterCellContent() : string
The default implementation simply renders [[footer]]. This method may be overridden to customize the rendering of the footer cell.
Return values
string —the rendering result
renderHeaderCellContent()
Renders the header cell content.
public
renderHeaderCellContent() : string
The default implementation simply renders [[header]]. This method may be overridden to customize the rendering of the header cell.
Return values
string —the rendering result