Browse Source

Merge branch 'master' of git.yiisoft.com:yii2

tags/2.0.0-beta
Qiang Xue 12 years ago
parent
commit
185687b0a0
  1. 59
      docs/view_renderers.md

59
docs/view_renderers.md

@ -1,18 +1,25 @@
Yii2 view renderers Yii2 view renderers
=================== ===================
By default Yii uses PHP as template language but you can change it in your application. By default Yii uses PHP as template language but you can configure it to be able
The component responsible for rendering a view is called `view`. You can configure to render templates with special engines such as Twig or Smarty.
a custom template engine as follows:
The component responsible for rendering a view is called `view`. You can add
a custom template engines as follows:
```php ```php
array( array(
'components' => array( 'components' => array(
'view' => array( 'view' => array(
'class' => 'yii\base\View', 'class' => 'yii\base\View',
'renderer' => array( 'renderers' => array(
'class' => 'yii\renderers\TwigViewRenderer', 'tpl' => array(
// or 'class' => 'yii\renderers\SmartyViewRenderer', 'class' => 'yii\renderers\SmartyViewRenderer',
),
'twig' => array(
'class' => 'yii\renderers\TwigViewRenderer',
),
// ...
), ),
), ),
), ),
@ -22,39 +29,23 @@ array(
Twig Twig
---- ----
In order to use Twig you need to put you templates in files with extension `.twig`. In order to use Twig you need to put you templates in files with extension `.twig`
(or another one if configured differently).
Also you need to specify this extension explicitly when calling `$this->render()` Also you need to specify this extension explicitly when calling `$this->render()`
or `$this->renderPartial()` from your controller. or `$this->renderPartial()` from your controller:
```php
echo $this->render('renderer.twig', array('username' => 'Alex'));
```
Smarty Smarty
------ ------
In order to use Smarty you need to put you templates in files with extension `.tpl`. In order to use Smarty you need to put you templates in files with extension `.tpl`
(or another one if configured differently).
Also you need to specify this extension explicitly when calling `$this->render()` Also you need to specify this extension explicitly when calling `$this->render()`
or `$this->renderPartial()` from your controller. or `$this->renderPartial()` from your controller:
Using multiple view renderers in a single application
-----------------------------------------------------
If you need multiple view renderers at the same time in a single application you
can use `CompositeViewRenderer` as follows:
```php ```php
'components' => array( echo $this->render('renderer.tpl', array('username' => 'Alex'));
'view' => array( ```
'class' => 'yii\base\View',
'renderer' => array(
'class' => 'yii\renderers\CompositeViewRenderer',
'renderers' => array(
'tpl' => array(
'class' => 'yii\renderers\SmartyViewRenderer',
),
'twig' => array(
'class' => 'yii\renderers\TwigViewRenderer',
),
),
//'class' => 'yii\renderers\TwigViewRenderer',
),
),
),
```

Loading…
Cancel
Save