Browse Source

code doc fix

tags/2.0.8
Klimov Paul 7 years ago
parent
commit
eb3fc7cf67
  1. 34
      .travis.yml
  2. 24
      ActiveField.php
  3. 4
      ActiveForm.php
  4. 2
      BaseHtml.php
  5. 2
      Button.php
  6. 4
      ButtonDropdown.php
  7. 4
      ButtonGroup.php
  8. 5
      Carousel.php
  9. 6
      Collapse.php
  10. 6
      Dropdown.php
  11. 12
      Nav.php
  12. 8
      NavBar.php
  13. 2
      Progress.php
  14. 12
      Tabs.php
  15. 6
      ToggleButtonGroup.php
  16. 16
      composer.json
  17. 1
      phpunit.xml.dist

34
.travis.yml

@ -1,21 +1,25 @@
language: php
php:
- 5.4
- 5.5
- 5.6
- 7.0
- 7.1
- 5.4
- 5.5
- 5.6
- 7.0
- 7.1
matrix:
include:
- php: hhvm
sudo: true
dist: trusty
group: edge
cache:
directories: "$HOME/.composer/cache"
before_install:
- wget https://phar.phpunit.de/phpunit-4.5.1.phar
script:
- php phpunit-4.5.1.phar --verbose $PHPUNIT_FLAGS
- php: hhvm
sudo: true
dist: trusty
group: edge
cache:
directories: "$HOME/.composer/cache"
before_install:
- wget https://phar.phpunit.de/phpunit-4.5.1.phar
script:
- php phpunit-4.5.1.phar --verbose $PHPUNIT_FLAGS
sudo: false
# cache vendor dirs

24
ActiveField.php

@ -21,7 +21,7 @@ use yii\helpers\ArrayHelper;
* - [[inline]]/[[inline()]] is used to render inline [[checkboxList()]] and [[radioList()]]
* - [[enableError]] can be set to `false` to disable to the error
* - [[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:
*
@ -91,7 +91,7 @@ use yii\helpers\ArrayHelper;
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;
/**
@ -136,17 +136,17 @@ class ActiveField extends \yii\widgets\ActiveField
*/
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;
/**
* @var boolean whether to render the label. Default is `true`.
* @var bool whether to render the label. Default is `true`.
*/
public $enableLabel = true;
/**
* @inheritdoc
* {@inheritdoc}
*/
public function __construct($config = [])
{
@ -156,7 +156,7 @@ class ActiveField extends \yii\widgets\ActiveField
}
/**
* @inheritdoc
* {@inheritdoc}
*/
public function render($content = null)
{
@ -188,7 +188,7 @@ class ActiveField extends \yii\widgets\ActiveField
}
/**
* @inheritdoc
* {@inheritdoc}
*/
public function checkbox($options = [], $enclosedByLabel = true)
{
@ -213,7 +213,7 @@ class ActiveField extends \yii\widgets\ActiveField
}
/**
* @inheritdoc
* {@inheritdoc}
*/
public function radio($options = [], $enclosedByLabel = true)
{
@ -238,7 +238,7 @@ class ActiveField extends \yii\widgets\ActiveField
}
/**
* @inheritdoc
* {@inheritdoc}
*/
public function checkboxList($items, $options = [])
{
@ -266,7 +266,7 @@ class ActiveField extends \yii\widgets\ActiveField
}
/**
* @inheritdoc
* {@inheritdoc}
*/
public function radioList($items, $options = [])
{
@ -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
* 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
* @since 2.0.5
@ -312,7 +312,7 @@ class ActiveField extends \yii\widgets\ActiveField
}
/**
* @inheritdoc
* {@inheritdoc}
*/
public function label($label = null, $options = [])
{

4
ActiveForm.php

@ -84,7 +84,7 @@ class ActiveForm extends \yii\widgets\ActiveForm
/**
* @inheritdoc
* {@inheritdoc}
*/
public function init()
{
@ -99,7 +99,7 @@ class ActiveForm extends \yii\widgets\ActiveForm
}
/**
* @inheritdoc
* {@inheritdoc}
* @return ActiveField the created ActiveField object
*/
public function field($model, $attribute, $options = [])

2
BaseHtml.php

@ -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
* 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
* @see http://getbootstrap.com/css/#forms-controls-static

2
Button.php

@ -33,7 +33,7 @@ class Button extends Widget
*/
public $label = 'Button';
/**
* @var boolean whether the label should be HTML-encoded.
* @var bool whether the label should be HTML-encoded.
*/
public $encodeLabel = true;

4
ButtonDropdown.php

@ -56,7 +56,7 @@ class ButtonDropdown extends Widget
*/
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;
/**
@ -64,7 +64,7 @@ class ButtonDropdown extends Widget
*/
public $tagName = 'button';
/**
* @var boolean whether the label should be HTML-encoded.
* @var bool whether the label should be HTML-encoded.
*/
public $encodeLabel = true;
/**

4
ButtonGroup.php

@ -49,11 +49,11 @@ class ButtonGroup extends Widget
*
* - label: string, required, the button label.
* - 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 = [];
/**
* @var boolean whether to HTML-encode the button labels.
* @var bool whether to HTML-encode the button labels.
*/
public $encodeLabels = true;

5
Carousel.php

@ -39,13 +39,12 @@ use yii\helpers\ArrayHelper;
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.
*/
public $controls = ['‹', '›'];
/**
* @var boolean
* If false carousel indicators (<ol> tag with anchors to items) should not be displayed.
* @var bool whether carousel indicators (<ol> tag with anchors to items) should be displayed or not.
*/
public $showIndicators = true;
/**

6
Collapse.php

@ -58,7 +58,7 @@ class Collapse extends Widget
* group with the following structure:
*
* - 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.
* - content: array|string|object, required, the content (HTML) of the group
* - options: array, optional, the HTML attributes of the group
@ -87,11 +87,11 @@ class Collapse extends Widget
*/
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;
/**
* @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.
* @since 2.0.7
*/

6
Dropdown.php

@ -39,10 +39,10 @@ class Dropdown extends Widget
* or an array representing a single menu with the following structure:
*
* - 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()]].
* 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.
* - options: array, optional, the HTML attributes of the item.
* - items: array, optional, the submenu items. The structure is the same as this property.
@ -54,7 +54,7 @@ class Dropdown extends Widget
*/
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;
/**

12
Nav.php

@ -59,30 +59,30 @@ class Nav extends Widget
*
* - label: string, required, the nav item label.
* - 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.
* - 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.
* - 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.
* - 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.
*/
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;
/**
* @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.
* @see isItemActive
*/
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;
/**

8
NavBar.php

@ -56,18 +56,18 @@ class NavBar extends Widget
*/
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
*/
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
* @since 2.0.8
*/
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
* [[\yii\web\Application::homeUrl]] will be used.
* You may set it to `null` if you want to have no link at all.
@ -88,7 +88,7 @@ class NavBar extends Widget
*/
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.
*/
public $renderInnerContainer = true;

2
Progress.php

@ -63,7 +63,7 @@ class Progress extends Widget
*/
public $label;
/**
* @var integer the amount of progress as a percentage.
* @var int the amount of progress as a percentage.
*/
public $percent = 0;
/**

12
Tabs.php

@ -65,7 +65,7 @@ class Tabs extends Widget
* tab with the following structure:
*
* - 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.
* - headerOptions: array, optional, the HTML attributes of the tab header.
* - linkOptions: array, optional, the HTML attributes of the tab header link tags.
@ -73,12 +73,12 @@ class Tabs extends Widget
* - 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.
* - 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.
* - 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
* 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.
* * contentOptions: optional, array, the HTML attributes of the tab content container.
*/
@ -105,7 +105,7 @@ class Tabs extends Widget
*/
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;
/**
@ -113,7 +113,7 @@ class Tabs extends Widget
*/
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.
* @since 2.0.1
*/

6
ToggleButtonGroup.php

@ -46,13 +46,13 @@ class ToggleButtonGroup extends InputWidget
*/
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;
/**
* @inheritdoc
* {@inheritdoc}
*/
public function init()
{
@ -63,7 +63,7 @@ class ToggleButtonGroup extends InputWidget
}
/**
* @inheritdoc
* {@inheritdoc}
*/
public function run()
{

16
composer.json

@ -14,7 +14,21 @@
"authors": [
{
"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": {

1
phpunit.xml.dist

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<phpunit bootstrap="./tests/bootstrap.php"
colors="true"
verbose="true"
convertErrorsToExceptions="true"
convertNoticesToExceptions="true"
convertWarningsToExceptions="true"

Loading…
Cancel
Save