Commit eb3fc7cf authored by Klimov Paul's avatar Klimov Paul

code doc fix

parent c330c0e2
language: php
php: php:
- 5.4 - 5.4
- 5.5 - 5.5
- 5.6 - 5.6
- 7.0 - 7.0
- 7.1 - 7.1
matrix: matrix:
include: include:
- php: hhvm - php: hhvm
...@@ -16,6 +19,7 @@ matrix: ...@@ -16,6 +19,7 @@ matrix:
- wget https://phar.phpunit.de/phpunit-4.5.1.phar - wget https://phar.phpunit.de/phpunit-4.5.1.phar
script: script:
- php phpunit-4.5.1.phar --verbose $PHPUNIT_FLAGS - php phpunit-4.5.1.phar --verbose $PHPUNIT_FLAGS
sudo: false sudo: false
# cache vendor dirs # cache vendor dirs
......
...@@ -21,7 +21,7 @@ use yii\helpers\ArrayHelper; ...@@ -21,7 +21,7 @@ use yii\helpers\ArrayHelper;
* - [[inline]]/[[inline()]] is used to render inline [[checkboxList()]] and [[radioList()]] * - [[inline]]/[[inline()]] is used to render inline [[checkboxList()]] and [[radioList()]]
* - [[enableError]] can be set to `false` to disable to the error * - [[enableError]] can be set to `false` to disable to the error
* - [[enableLabel]] can be set to `false` to disable to the label * - [[enableLabel]] can be set to `false` to disable to the label
* - [[label()]] can be used with a `boolean` argument to enable/disable the label * - [[label()]] can be used with a `bool` argument to enable/disable the label
* *
* There are also some new placeholders that you can use in the [[template]] configuration: * There are also some new placeholders that you can use in the [[template]] configuration:
* *
...@@ -91,7 +91,7 @@ use yii\helpers\ArrayHelper; ...@@ -91,7 +91,7 @@ use yii\helpers\ArrayHelper;
class ActiveField extends \yii\widgets\ActiveField class ActiveField extends \yii\widgets\ActiveField
{ {
/** /**
* @var boolean whether to render [[checkboxList()]] and [[radioList()]] inline. * @var bool whether to render [[checkboxList()]] and [[radioList()]] inline.
*/ */
public $inline = false; public $inline = false;
/** /**
...@@ -136,17 +136,17 @@ class ActiveField extends \yii\widgets\ActiveField ...@@ -136,17 +136,17 @@ class ActiveField extends \yii\widgets\ActiveField
*/ */
public $inlineRadioListTemplate = "{label}\n{beginWrapper}\n{input}\n{error}\n{endWrapper}\n{hint}"; public $inlineRadioListTemplate = "{label}\n{beginWrapper}\n{input}\n{error}\n{endWrapper}\n{hint}";
/** /**
* @var boolean whether to render the error. Default is `true` except for layout `inline`. * @var bool whether to render the error. Default is `true` except for layout `inline`.
*/ */
public $enableError = true; public $enableError = true;
/** /**
* @var boolean whether to render the label. Default is `true`. * @var bool whether to render the label. Default is `true`.
*/ */
public $enableLabel = true; public $enableLabel = true;
/** /**
* @inheritdoc * {@inheritdoc}
*/ */
public function __construct($config = []) public function __construct($config = [])
{ {
...@@ -156,7 +156,7 @@ class ActiveField extends \yii\widgets\ActiveField ...@@ -156,7 +156,7 @@ class ActiveField extends \yii\widgets\ActiveField
} }
/** /**
* @inheritdoc * {@inheritdoc}
*/ */
public function render($content = null) public function render($content = null)
{ {
...@@ -188,7 +188,7 @@ class ActiveField extends \yii\widgets\ActiveField ...@@ -188,7 +188,7 @@ class ActiveField extends \yii\widgets\ActiveField
} }
/** /**
* @inheritdoc * {@inheritdoc}
*/ */
public function checkbox($options = [], $enclosedByLabel = true) public function checkbox($options = [], $enclosedByLabel = true)
{ {
...@@ -213,7 +213,7 @@ class ActiveField extends \yii\widgets\ActiveField ...@@ -213,7 +213,7 @@ class ActiveField extends \yii\widgets\ActiveField
} }
/** /**
* @inheritdoc * {@inheritdoc}
*/ */
public function radio($options = [], $enclosedByLabel = true) public function radio($options = [], $enclosedByLabel = true)
{ {
...@@ -238,7 +238,7 @@ class ActiveField extends \yii\widgets\ActiveField ...@@ -238,7 +238,7 @@ class ActiveField extends \yii\widgets\ActiveField
} }
/** /**
* @inheritdoc * {@inheritdoc}
*/ */
public function checkboxList($items, $options = []) public function checkboxList($items, $options = [])
{ {
...@@ -266,7 +266,7 @@ class ActiveField extends \yii\widgets\ActiveField ...@@ -266,7 +266,7 @@ class ActiveField extends \yii\widgets\ActiveField
} }
/** /**
* @inheritdoc * {@inheritdoc}
*/ */
public function radioList($items, $options = []) public function radioList($items, $options = [])
{ {
...@@ -298,7 +298,7 @@ class ActiveField extends \yii\widgets\ActiveField ...@@ -298,7 +298,7 @@ class ActiveField extends \yii\widgets\ActiveField
* @param array $options the tag options in terms of name-value pairs. These will be rendered as * @param array $options the tag options in terms of name-value pairs. These will be rendered as
* the attributes of the resulting tag. There are also a special options: * the attributes of the resulting tag. There are also a special options:
* *
* - encode: boolean, whether value should be HTML-encoded or not. * - encode: bool, whether value should be HTML-encoded or not.
* *
* @return $this the field object itself * @return $this the field object itself
* @since 2.0.5 * @since 2.0.5
...@@ -312,7 +312,7 @@ class ActiveField extends \yii\widgets\ActiveField ...@@ -312,7 +312,7 @@ class ActiveField extends \yii\widgets\ActiveField
} }
/** /**
* @inheritdoc * {@inheritdoc}
*/ */
public function label($label = null, $options = []) public function label($label = null, $options = [])
{ {
......
...@@ -84,7 +84,7 @@ class ActiveForm extends \yii\widgets\ActiveForm ...@@ -84,7 +84,7 @@ class ActiveForm extends \yii\widgets\ActiveForm
/** /**
* @inheritdoc * {@inheritdoc}
*/ */
public function init() public function init()
{ {
...@@ -99,7 +99,7 @@ class ActiveForm extends \yii\widgets\ActiveForm ...@@ -99,7 +99,7 @@ class ActiveForm extends \yii\widgets\ActiveForm
} }
/** /**
* @inheritdoc * {@inheritdoc}
* @return ActiveField the created ActiveField object * @return ActiveField the created ActiveField object
*/ */
public function field($model, $attribute, $options = []) public function field($model, $attribute, $options = [])
......
...@@ -48,7 +48,7 @@ class BaseHtml extends \yii\helpers\Html ...@@ -48,7 +48,7 @@ class BaseHtml extends \yii\helpers\Html
* @param array $options the tag options in terms of name-value pairs. These will be rendered as * @param array $options the tag options in terms of name-value pairs. These will be rendered as
* the attributes of the resulting tag. There are also a special options: * the attributes of the resulting tag. There are also a special options:
* *
* - encode: boolean, whether value should be HTML-encoded or not. * - encode: bool, whether value should be HTML-encoded or not.
* *
* @return string generated HTML * @return string generated HTML
* @see http://getbootstrap.com/css/#forms-controls-static * @see http://getbootstrap.com/css/#forms-controls-static
......
...@@ -33,7 +33,7 @@ class Button extends Widget ...@@ -33,7 +33,7 @@ class Button extends Widget
*/ */
public $label = 'Button'; public $label = 'Button';
/** /**
* @var boolean whether the label should be HTML-encoded. * @var bool whether the label should be HTML-encoded.
*/ */
public $encodeLabel = true; public $encodeLabel = true;
......
...@@ -56,7 +56,7 @@ class ButtonDropdown extends Widget ...@@ -56,7 +56,7 @@ class ButtonDropdown extends Widget
*/ */
public $dropdown = []; public $dropdown = [];
/** /**
* @var boolean whether to display a group of split-styled button group. * @var bool whether to display a group of split-styled button group.
*/ */
public $split = false; public $split = false;
/** /**
...@@ -64,7 +64,7 @@ class ButtonDropdown extends Widget ...@@ -64,7 +64,7 @@ class ButtonDropdown extends Widget
*/ */
public $tagName = 'button'; public $tagName = 'button';
/** /**
* @var boolean whether the label should be HTML-encoded. * @var bool whether the label should be HTML-encoded.
*/ */
public $encodeLabel = true; public $encodeLabel = true;
/** /**
......
...@@ -49,11 +49,11 @@ class ButtonGroup extends Widget ...@@ -49,11 +49,11 @@ class ButtonGroup extends Widget
* *
* - label: string, required, the button label. * - label: string, required, the button label.
* - options: array, optional, the HTML attributes of the button. * - options: array, optional, the HTML attributes of the button.
* - visible: boolean, optional, whether this button is visible. Defaults to true. * - visible: bool, optional, whether this button is visible. Defaults to true.
*/ */
public $buttons = []; public $buttons = [];
/** /**
* @var boolean whether to HTML-encode the button labels. * @var bool whether to HTML-encode the button labels.
*/ */
public $encodeLabels = true; public $encodeLabels = true;
......
...@@ -39,13 +39,12 @@ use yii\helpers\ArrayHelper; ...@@ -39,13 +39,12 @@ use yii\helpers\ArrayHelper;
class Carousel extends Widget class Carousel extends Widget
{ {
/** /**
* @var array|boolean the labels for the previous and the next control buttons. * @var array|bool the labels for the previous and the next control buttons.
* If false, it means the previous and the next control buttons should not be displayed. * If false, it means the previous and the next control buttons should not be displayed.
*/ */
public $controls = ['‹', '›']; public $controls = ['‹', '›'];
/** /**
* @var boolean * @var bool whether carousel indicators (<ol> tag with anchors to items) should be displayed or not.
* If false carousel indicators (<ol> tag with anchors to items) should not be displayed.
*/ */
public $showIndicators = true; public $showIndicators = true;
/** /**
......
...@@ -58,7 +58,7 @@ class Collapse extends Widget ...@@ -58,7 +58,7 @@ class Collapse extends Widget
* group with the following structure: * group with the following structure:
* *
* - label: string, required, the group header label. * - label: string, required, the group header label.
* - encode: boolean, optional, whether this label should be HTML-encoded. This param will override * - encode: bool, optional, whether this label should be HTML-encoded. This param will override
* global `$this->encodeLabels` param. * global `$this->encodeLabels` param.
* - content: array|string|object, required, the content (HTML) of the group * - content: array|string|object, required, the content (HTML) of the group
* - options: array, optional, the HTML attributes of the group * - options: array, optional, the HTML attributes of the group
...@@ -87,11 +87,11 @@ class Collapse extends Widget ...@@ -87,11 +87,11 @@ class Collapse extends Widget
*/ */
public $items = []; public $items = [];
/** /**
* @var boolean whether the labels for header items should be HTML-encoded. * @var bool whether the labels for header items should be HTML-encoded.
*/ */
public $encodeLabels = true; public $encodeLabels = true;
/** /**
* @var boolean whether to close other items if an item is opened. Defaults to `true` which causes an * @var bool whether to close other items if an item is opened. Defaults to `true` which causes an
* accordion effect. Set this to `false` to allow keeping multiple items open at once. * accordion effect. Set this to `false` to allow keeping multiple items open at once.
* @since 2.0.7 * @since 2.0.7
*/ */
......
...@@ -39,10 +39,10 @@ class Dropdown extends Widget ...@@ -39,10 +39,10 @@ class Dropdown extends Widget
* or an array representing a single menu with the following structure: * or an array representing a single menu with the following structure:
* *
* - label: string, required, the label of the item link. * - label: string, required, the label of the item link.
* - encode: boolean, optional, whether to HTML-encode item label. * - encode: bool, optional, whether to HTML-encode item label.
* - url: string|array, optional, the URL of the item link. This will be processed by [[\yii\helpers\Url::to()]]. * - url: string|array, optional, the URL of the item link. This will be processed by [[\yii\helpers\Url::to()]].
* If not set, the item will be treated as a menu header when the item has no sub-menu. * If not set, the item will be treated as a menu header when the item has no sub-menu.
* - visible: boolean, optional, whether this menu item is visible. Defaults to true. * - visible: bool, optional, whether this menu item is visible. Defaults to true.
* - linkOptions: array, optional, the HTML attributes of the item link. * - linkOptions: array, optional, the HTML attributes of the item link.
* - options: array, optional, the HTML attributes of the item. * - options: array, optional, the HTML attributes of the item.
* - items: array, optional, the submenu items. The structure is the same as this property. * - items: array, optional, the submenu items. The structure is the same as this property.
...@@ -54,7 +54,7 @@ class Dropdown extends Widget ...@@ -54,7 +54,7 @@ class Dropdown extends Widget
*/ */
public $items = []; public $items = [];
/** /**
* @var boolean whether the labels for header items should be HTML-encoded. * @var bool whether the labels for header items should be HTML-encoded.
*/ */
public $encodeLabels = true; public $encodeLabels = true;
/** /**
......
...@@ -59,30 +59,30 @@ class Nav extends Widget ...@@ -59,30 +59,30 @@ class Nav extends Widget
* *
* - label: string, required, the nav item label. * - label: string, required, the nav item label.
* - url: optional, the item's URL. Defaults to "#". * - url: optional, the item's URL. Defaults to "#".
* - visible: boolean, optional, whether this menu item is visible. Defaults to true. * - visible: bool, optional, whether this menu item is visible. Defaults to true.
* - linkOptions: array, optional, the HTML attributes of the item's link. * - linkOptions: array, optional, the HTML attributes of the item's link.
* - options: array, optional, the HTML attributes of the item container (LI). * - options: array, optional, the HTML attributes of the item container (LI).
* - active: boolean, optional, whether the item should be on active state or not. * - active: bool, optional, whether the item should be on active state or not.
* - dropDownOptions: array, optional, the HTML options that will passed to the [[Dropdown]] widget. * - dropDownOptions: array, optional, the HTML options that will passed to the [[Dropdown]] widget.
* - items: array|string, optional, the configuration array for creating a [[Dropdown]] widget, * - items: array|string, optional, the configuration array for creating a [[Dropdown]] widget,
* or a string representing the dropdown menu. Note that Bootstrap does not support sub-dropdown menus. * or a string representing the dropdown menu. Note that Bootstrap does not support sub-dropdown menus.
* - encode: boolean, optional, whether the label will be HTML-encoded. If set, supersedes the $encodeLabels option for only this item. * - encode: bool, optional, whether the label will be HTML-encoded. If set, supersedes the $encodeLabels option for only this item.
* *
* If a menu item is a string, it will be rendered directly without HTML encoding. * If a menu item is a string, it will be rendered directly without HTML encoding.
*/ */
public $items = []; public $items = [];
/** /**
* @var boolean whether the nav items labels should be HTML-encoded. * @var bool whether the nav items labels should be HTML-encoded.
*/ */
public $encodeLabels = true; public $encodeLabels = true;
/** /**
* @var boolean whether to automatically activate items according to whether their route setting * @var bool whether to automatically activate items according to whether their route setting
* matches the currently requested route. * matches the currently requested route.
* @see isItemActive * @see isItemActive
*/ */
public $activateItems = true; public $activateItems = true;
/** /**
* @var boolean whether to activate parent menu items when one of the corresponding child menu items is active. * @var bool whether to activate parent menu items when one of the corresponding child menu items is active.
*/ */
public $activateParents = false; public $activateParents = false;
/** /**
......
...@@ -56,18 +56,18 @@ class NavBar extends Widget ...@@ -56,18 +56,18 @@ class NavBar extends Widget
*/ */
public $containerOptions = []; public $containerOptions = [];
/** /**
* @var string|boolean the text of the brand or false if it's not used. Note that this is not HTML-encoded. * @var string|bool the text of the brand or false if it's not used. Note that this is not HTML-encoded.
* @see https://getbootstrap.com/docs/3.3/components/#navbar * @see https://getbootstrap.com/docs/3.3/components/#navbar
*/ */
public $brandLabel = false; public $brandLabel = false;
/** /**
* @var string|boolean src of the brand image or false if it's not used. Note that this param will override `$this->brandLabel` param. * @var string|bool src of the brand image or false if it's not used. Note that this param will override `$this->brandLabel` param.
* @see https://getbootstrap.com/docs/3.3/components/#navbar * @see https://getbootstrap.com/docs/3.3/components/#navbar
* @since 2.0.8 * @since 2.0.8
*/ */
public $brandImage = false; public $brandImage = false;
/** /**
* @var array|string|boolean $url the URL for the brand's hyperlink tag. This parameter will be processed by [[\yii\helpers\Url::to()]] * @var array|string|bool $url the URL for the brand's hyperlink tag. This parameter will be processed by [[\yii\helpers\Url::to()]]
* and will be used for the "href" attribute of the brand link. Default value is false that means * and will be used for the "href" attribute of the brand link. Default value is false that means
* [[\yii\web\Application::homeUrl]] will be used. * [[\yii\web\Application::homeUrl]] will be used.
* You may set it to `null` if you want to have no link at all. * You may set it to `null` if you want to have no link at all.
...@@ -88,7 +88,7 @@ class NavBar extends Widget ...@@ -88,7 +88,7 @@ class NavBar extends Widget
*/ */
public $screenReaderToggleText = 'Toggle navigation'; public $screenReaderToggleText = 'Toggle navigation';
/** /**
* @var boolean whether the navbar content should be included in an inner div container which by default * @var bool whether the navbar content should be included in an inner div container which by default
* adds left and right padding. Set this to false for a 100% width navbar. * adds left and right padding. Set this to false for a 100% width navbar.
*/ */
public $renderInnerContainer = true; public $renderInnerContainer = true;
......
...@@ -63,7 +63,7 @@ class Progress extends Widget ...@@ -63,7 +63,7 @@ class Progress extends Widget
*/ */
public $label; public $label;
/** /**
* @var integer the amount of progress as a percentage. * @var int the amount of progress as a percentage.
*/ */
public $percent = 0; public $percent = 0;
/** /**
......
...@@ -65,7 +65,7 @@ class Tabs extends Widget ...@@ -65,7 +65,7 @@ class Tabs extends Widget
* tab with the following structure: * tab with the following structure:
* *
* - label: string, required, the tab header label. * - label: string, required, the tab header label.
* - encode: boolean, optional, whether this label should be HTML-encoded. This param will override * - encode: bool, optional, whether this label should be HTML-encoded. This param will override
* global `$this->encodeLabels` param. * global `$this->encodeLabels` param.
* - headerOptions: array, optional, the HTML attributes of the tab header. * - headerOptions: array, optional, the HTML attributes of the tab header.
* - linkOptions: array, optional, the HTML attributes of the tab header link tags. * - linkOptions: array, optional, the HTML attributes of the tab header link tags.
...@@ -73,12 +73,12 @@ class Tabs extends Widget ...@@ -73,12 +73,12 @@ class Tabs extends Widget
* - url: string, optional, an external URL. When this is specified, clicking on this tab will bring * - url: string, optional, an external URL. When this is specified, clicking on this tab will bring
* the browser to this URL. This option is available since version 2.0.4. * the browser to this URL. This option is available since version 2.0.4.
* - options: array, optional, the HTML attributes of the tab pane container. * - options: array, optional, the HTML attributes of the tab pane container.
* - active: boolean, optional, whether this item tab header and pane should be active. If no item is marked as * - active: bool, optional, whether this item tab header and pane should be active. If no item is marked as
* 'active' explicitly - the first one will be activated. * 'active' explicitly - the first one will be activated.
* - visible: boolean, optional, whether the item tab header and pane should be visible or not. Defaults to true. * - visible: bool, optional, whether the item tab header and pane should be visible or not. Defaults to true.
* - items: array, optional, can be used instead of `content` to specify a dropdown items * - items: array, optional, can be used instead of `content` to specify a dropdown items
* configuration array. Each item can hold three extra keys, besides the above ones: * configuration array. Each item can hold three extra keys, besides the above ones:
* * active: boolean, optional, whether the item tab header and pane should be visible or not. * * active: bool, optional, whether the item tab header and pane should be visible or not.
* * content: string, required if `items` is not set. The content (HTML) of the tab pane. * * content: string, required if `items` is not set. The content (HTML) of the tab pane.
* * contentOptions: optional, array, the HTML attributes of the tab content container. * * contentOptions: optional, array, the HTML attributes of the tab content container.
*/ */
...@@ -105,7 +105,7 @@ class Tabs extends Widget ...@@ -105,7 +105,7 @@ class Tabs extends Widget
*/ */
public $linkOptions = []; public $linkOptions = [];
/** /**
* @var boolean whether the labels for header items should be HTML-encoded. * @var bool whether the labels for header items should be HTML-encoded.
*/ */
public $encodeLabels = true; public $encodeLabels = true;
/** /**
...@@ -113,7 +113,7 @@ class Tabs extends Widget ...@@ -113,7 +113,7 @@ class Tabs extends Widget
*/ */
public $navType = 'nav-tabs'; public $navType = 'nav-tabs';
/** /**
* @var boolean whether to render the `tab-content` container and its content. You may set this property * @var bool whether to render the `tab-content` container and its content. You may set this property
* to be false so that you can manually render `tab-content` yourself in case your tab contents are complex. * to be false so that you can manually render `tab-content` yourself in case your tab contents are complex.
* @since 2.0.1 * @since 2.0.1
*/ */
......
...@@ -46,13 +46,13 @@ class ToggleButtonGroup extends InputWidget ...@@ -46,13 +46,13 @@ class ToggleButtonGroup extends InputWidget
*/ */
public $labelOptions = []; public $labelOptions = [];
/** /**
* @var boolean whether the items labels should be HTML-encoded. * @var bool whether the items labels should be HTML-encoded.
*/ */
public $encodeLabels = true; public $encodeLabels = true;
/** /**
* @inheritdoc * {@inheritdoc}
*/ */
public function init() public function init()
{ {
...@@ -63,7 +63,7 @@ class ToggleButtonGroup extends InputWidget ...@@ -63,7 +63,7 @@ class ToggleButtonGroup extends InputWidget
} }
/** /**
* @inheritdoc * {@inheritdoc}
*/ */
public function run() public function run()
{ {
......
...@@ -14,7 +14,21 @@ ...@@ -14,7 +14,21 @@
"authors": [ "authors": [
{ {
"name": "Qiang Xue", "name": "Qiang Xue",
"email": "qiang.xue@gmail.com" "email": "qiang.xue@gmail.com",
"homepage": "http://www.yiiframework.com/"
},
{
"name": "Alexander Makarov",
"email": "sam@rmcreative.ru",
"homepage": "http://rmcreative.ru/"
},
{
"name": "Antonio Ramirez",
"email": "amigo.cobos@gmail.com"
},
{
"name": "Paul Klimov",
"email": "klimov.paul@gmail.com"
} }
], ],
"require": { "require": {
......
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<phpunit bootstrap="./tests/bootstrap.php" <phpunit bootstrap="./tests/bootstrap.php"
colors="true" colors="true"
verbose="true"
convertErrorsToExceptions="true" convertErrorsToExceptions="true"
convertNoticesToExceptions="true" convertNoticesToExceptions="true"
convertWarningsToExceptions="true" convertWarningsToExceptions="true"
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment