Commit 2ca4f999 by Alexander Makarov

Revert "Minor fixes for helper-html.md [skip ci]"

parent 0830b2fe
...@@ -88,6 +88,7 @@ could be converted there and forth by using [[yii\helpers\Html::cssStyleFromArra ...@@ -88,6 +88,7 @@ could be converted there and forth by using [[yii\helpers\Html::cssStyleFromArra
[[yii\helpers\Html::cssStyleToArray()|cssStyleToArray()]]. The [[yii\helpers\Html::removeCssStyle()|removeCssStyle()]] [[yii\helpers\Html::cssStyleToArray()|cssStyleToArray()]]. The [[yii\helpers\Html::removeCssStyle()|removeCssStyle()]]
method accepts an array of properties to remove. If it's going to be a single property it could be specified as string. method accepts an array of properties to remove. If it's going to be a single property it could be specified as string.
Encoding and decoding content <a name="encoding-and-decoding-content"></a> Encoding and decoding content <a name="encoding-and-decoding-content"></a>
-------------------------------------------------------------------------- --------------------------------------------------------------------------
...@@ -103,7 +104,8 @@ $userName = Html::encode($user->name); ...@@ -103,7 +104,8 @@ $userName = Html::encode($user->name);
echo $userName; echo $userName;
$decodedUserName = Html::decode($userName); $decodedUserName = Html::decode($userName);
``` ```
Forms Forms
----- -----
...@@ -156,10 +158,10 @@ directly. ...@@ -156,10 +158,10 @@ directly.
The most generic methods are: The most generic methods are:
```php ```php
// type, input name, input value, options type, input name, input value, options
<?= Html::input('text', 'username', $user->name, ['class' => $username]) ?> <?= Html::input('text', 'username', $user->name, ['class' => $username]) ?>
// type, model, model attribute name, options type, model, model attribute name, options
<?= Html::activeInput('text', $user, 'name', ['class' => $username]) ?> <?= Html::activeInput('text', $user, 'name', ['class' => $username]) ?>
``` ```
...@@ -211,6 +213,7 @@ If not, use radio list: ...@@ -211,6 +213,7 @@ If not, use radio list:
<?= Html::activeRadioList($user, 'role', ArrayHelper::map($roleModels, 'id', 'name')) ?> <?= Html::activeRadioList($user, 'role', ArrayHelper::map($roleModels, 'id', 'name')) ?>
``` ```
### Labels and errors ### Labels and errors
...@@ -221,7 +224,7 @@ that accepts data directly: ...@@ -221,7 +224,7 @@ that accepts data directly:
<?= Html::label('User name', 'username', ['class' => 'label username']) ?> <?= Html::label('User name', 'username', ['class' => 'label username']) ?>
<?= Html::activeLabel($user, 'username', ['class' => 'label username']) <?= Html::activeLabel($user, 'username', ['class' => 'label username'])
``` ```
In order to display form errors from a model or models as a summary you could use: In order to display form errors from a model or models as a summary you could use:
```php ```php
...@@ -233,9 +236,10 @@ To display individual error: ...@@ -233,9 +236,10 @@ To display individual error:
```php ```php
<?= Html::error($post, 'title', ['class' => 'error']) ?> <?= Html::error($post, 'title', ['class' => 'error']) ?>
``` ```
### Names and values ### Names and values
There are methods to get names, ids and values for input fields based on the model. These are mainly used internally There are methods to get names, ids and values for input fields based on the model. These are mainly used internally
but could be handy sometimes: but could be handy sometimes:
...@@ -267,7 +271,8 @@ In order to get attribute name without suffixes or prefixes one can use the foll ...@@ -267,7 +271,8 @@ In order to get attribute name without suffixes or prefixes one can use the foll
// dates // dates
echo Html::getAttributeName('dates[0]'); echo Html::getAttributeName('dates[0]');
``` ```
Styles and scripts Styles and scripts
------------------ ------------------
...@@ -277,14 +282,14 @@ There two methods to generate tags wrapping embedded styles and scripts: ...@@ -277,14 +282,14 @@ There two methods to generate tags wrapping embedded styles and scripts:
```php ```php
<?= Html::style('.danger { color: #f00; }') ?> <?= Html::style('.danger { color: #f00; }') ?>
// Gives you Gives you
<style>.danger { color: #f00; }</style> <style>.danger { color: #f00; }</style>
<?= Html::script('alert("Hello!");', ['defer' => true]); <?= Html::script('alert("Hello!");', ['defer' => true]);
// Gives you Gives you
<script defer>alert("Hello!");</script> <script defer>alert("Hello!");</script>
``` ```
...@@ -294,7 +299,7 @@ If you want to link external style from CSS file: ...@@ -294,7 +299,7 @@ If you want to link external style from CSS file:
```php ```php
<?= Html::cssFile('@web/css/ie5.css', ['condition' => 'IE 5']) ?> <?= Html::cssFile('@web/css/ie5.css', ['condition' => 'IE 5']) ?>
// generates generates
<!--[if IE 5]> <!--[if IE 5]>
<link href="http://example.com/css/ie5.css" /> <link href="http://example.com/css/ie5.css" />
...@@ -316,12 +321,12 @@ To link JavaScript file: ...@@ -316,12 +321,12 @@ To link JavaScript file:
Same as with CSS first argument specifies link to the file to be included. Options could be passed as the second argument. Same as with CSS first argument specifies link to the file to be included. Options could be passed as the second argument.
In options you can specify `condition` in the same way as in options for `cssFile`. In options you can specify `condition` in the same way as in options for `cssFile`.
Links Links
----- -----
There's a method to generate hyperlink conveniently: There's a method to generate hyperlink conveniently:
```php ```php
<?= Html::a('Profile', ['user/view', 'id' => $id], ['class' => 'profile-link']) ?> <?= Html::a('Profile', ['user/view', 'id' => $id], ['class' => 'profile-link']) ?>
``` ```
...@@ -335,7 +340,8 @@ In you need to generate `mailto` link you can use the following code: ...@@ -335,7 +340,8 @@ In you need to generate `mailto` link you can use the following code:
```php ```php
<?= Html::mailto('Contact us', 'admin@example.com') ?> <?= Html::mailto('Contact us', 'admin@example.com') ?>
``` ```
Images Images
------ ------
...@@ -344,17 +350,17 @@ In order to generate image tag use the following: ...@@ -344,17 +350,17 @@ In order to generate image tag use the following:
```php ```php
<?= Html::img('@web/images/logo.png', ['alt' => 'My logo']) ?> <?= Html::img('@web/images/logo.png', ['alt' => 'My logo']) ?>
// generates generates
<img src="http://example.com/images/logo.png" alt="My logo" /> <img src="http://example.com/images/logo.png" alt="My logo" />
``` ```
Aside [aliases](concept-aliases.md) the first argument can accept routes, parameters and URLs. Same way as Aside [aliases](concept-aliases.md) the first argument can accept routes, parameters and URLs. Same way as
[Url::to()](helper-url.md) does. [Url::to()](helper-url.md) does.
Lists Lists
----- -----
Unordered list could be generated like the following: Unordered list could be generated like the following:
```php ```php
...@@ -367,4 +373,4 @@ Unordered list could be generated like the following: ...@@ -367,4 +373,4 @@ Unordered list could be generated like the following:
}]) ?> }]) ?>
``` ```
In order to get ordered list use `Html::ol()` instead. In order to get ordered list use `Html::ol()` instead.
\ No newline at end of file
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