Browse Source

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

tags/2.0.2
Alexander Makarov 10 years ago
parent
commit
2ca4f999ef
  1. 38
      docs/guide/helper-html.md

38
docs/guide/helper-html.md

@ -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()]]
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>
--------------------------------------------------------------------------
@ -103,7 +104,8 @@ $userName = Html::encode($user->name);
echo $userName;
$decodedUserName = Html::decode($userName);
```
```
Forms
-----
@ -156,10 +158,10 @@ directly.
The most generic methods are:
```php
// type, input name, input value, options
type, input name, input value, options
<?= 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]) ?>
```
@ -211,6 +213,7 @@ If not, use radio list:
<?= Html::activeRadioList($user, 'role', ArrayHelper::map($roleModels, 'id', 'name')) ?>
```
### Labels and errors
@ -221,7 +224,7 @@ that accepts data directly:
<?= Html::label('User name', '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:
```php
@ -233,9 +236,10 @@ To display individual error:
```php
<?= Html::error($post, 'title', ['class' => 'error']) ?>
```
### Names and values
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:
@ -267,7 +271,8 @@ In order to get attribute name without suffixes or prefixes one can use the foll
// dates
echo Html::getAttributeName('dates[0]');
```
Styles and scripts
------------------
@ -277,14 +282,14 @@ There two methods to generate tags wrapping embedded styles and scripts:
```php
<?= Html::style('.danger { color: #f00; }') ?>
// Gives you
Gives you
<style>.danger { color: #f00; }</style>
<?= Html::script('alert("Hello!");', ['defer' => true]);
// Gives you
Gives you
<script defer>alert("Hello!");</script>
```
@ -294,7 +299,7 @@ If you want to link external style from CSS file:
```php
<?= Html::cssFile('@web/css/ie5.css', ['condition' => 'IE 5']) ?>
// generates
generates
<!--[if IE 5]>
<link href="http://example.com/css/ie5.css" />
@ -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.
In options you can specify `condition` in the same way as in options for `cssFile`.
Links
-----
There's a method to generate hyperlink conveniently:
```php
<?= 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:
```php
<?= Html::mailto('Contact us', 'admin@example.com') ?>
```
Images
------
@ -344,17 +350,17 @@ In order to generate image tag use the following:
```php
<?= Html::img('@web/images/logo.png', ['alt' => 'My logo']) ?>
// generates
generates
<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
[Url::to()](helper-url.md) does.
Lists
-----
Unordered list could be generated like the following:
```php
@ -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.

Loading…
Cancel
Save