"By Example" : CHtml - link()

Серия рецентов "By Example" пытается предоставить для разработчиков примеры использования самых распостраненных действий в Yii. Учимся использовать CHtml::link() на примерах!

[+update 8/10/2009]

CHtml::link() method

public static string link(string $text, mixed $url='#', array $htmlOptions=array ( ))

Создание линков (ссылок) с использованием CHtml

Пример 1: Ссылка на действие контроллера

<?php echo CHtml::link('Link Text',array('controller/action')); ?>

Результат:

<a href="index.php?r=controller/action">Link Text</a>

Пример 2: Ссылка на действие контроллера с дополнительными параметрами

<?php echo CHtml::link('Link Text',array('controller/action',
                                         'param1'=>'value1')); ?>

Результат:

<a href="index.php?r=controller/action&param1=value1">Link Text</a>

Пример 3: Ссылка на действие контроллера с большим кол-вом дополнительных параметров

<?php echo CHtml::link('Link Text',array('controller/action',
                                         'param1'=>'value1',
                                         'param2'=>'value2',
                                         'param3'=>'value3')); ?>

Результат:

<a href="index.php?r=controller/action&param1=value1&param2=value2&param3=value3">Link Text</a>

Пример 4: Ссылка на действие внутри текущего контроллера

Предположим вы находитесь в PostController/view и хотите перейти в PostController/create. Для этого просто укажите название экшинса без указания контроллера! Если хотите перейти на другой контроллер - используйте примеры указанные выше.

<?php echo CHtml::link('Link Text',array('action')); ?>

Пример 5: Ссылка на контроллер от корня

Предположим вы находитесь в модуле и хотите сделать ссылку на корневой контроллер. В этом случае добавьте косую черту в начале строки URL. Это имеет смысл только если вы работаете с модулями

<?php echo CHtml::link('Link Text',array('/controller/action')); ?>

Пример 6: Ссылка на действие контроллера в другом модуле

<?php echo CHtml::link('Link Text',array('/module-id/controller/action')); ?>

Пример 7: Ссылка на действие контроллера со стороны модуля

<?php echo CHtml::link('Link Text',array('/{$this->module->id}/controller/action')); ?>

• Оригинал "By Example: CHtml" [англ.]