视图渲染器¶

使用视图渲染器
类参考

使用视图渲染器 ¶

view() 方法是一种便捷功能，可以获取 renderer 服务实例，然后可以设置数据并显示视图。这种方式是我们常用的方式，但有时候我们需要一种更为直接的使用方式；在这种情况下你可以直接以视图服务的形式调用它:

$view = \Config\Services::renderer();

如果不使用 View 类作为默认渲染器，则可以直接实例化它:

$view = new \CodeIgniter\View\View();

重要

你应该只在控制器内创建、使用服务。如果你想在其他类（Library）中使用，则应在类的构造函数中将其设置为依赖项。

然后，您可以使用它提供的三种标准方法中的任何一种: render(viewpath, options, save), setVar(name, value, context) 和 setData(data, context).

它是做什么的 ¶

View 类将视图的参数提取到可在脚本内部访问的PHP变量后，处理存储在应用程序视图路径中的标准 HTML/PHP 脚本。这意味着视图中的参数名称必须是合法的 PHP 变量名。

View 类在内部使用一个关联数组，以保存视图参数，直到调用 render() 方法为止。这意味着视图参数（或变量）名称必须是唯一的，否则后面变量的值将覆盖前面的变量。

同时，这还会影响脚本中不同上下文的参数值，你将必须为每个值赋予唯一的参数名称。

数组类型的值没有任何特殊含义，可以根据自己的 PHP 代码处理数组。

链式调用方法 ¶

setVar() 和 setData() 方法支持链式调用，允许将多个不同的调用组合到一个方法链中使用:

$view->setVar('one', $one)
     ->setVar('two', $two)
     ->render('myView');

转义数据 ¶

当你将数据传递给 setVar() 和 setData() 方法时，可以选择转义数据以防止跨站点脚本攻击。作为这两种方法中的最后一个参数，你可以传递所需的上下文，以选择是否对数据进行转义。

如果你不想对数据进行转义，你可以向每个方法的最后一个参数传递 null 或 raw，这样将不会对数据进行转义:

$view->setVar('one', $one, 'raw');

如果选择不转义数据，或者要传递对象实例，则可以使用 esc() 辅助方法在视图中手动转义数据。第一个参数是要转义的字符串，第二个参数是用于转义数据的上下文（请参见下文）:

<?= \esc($object->getStat()) ?>

注解

译者注：框架内部使用 \Zend\Escaper\Escaper 类中以 escape 开头的相关方法对数据进行的转义处理。

转义上下文¶

默认情况下，esc() 方法认为要转义的数据会在 HTML 中使用。如果数据打算用于 Javascript、CSS 或 href 属性时，需要不同的转义规则才能生效。你可以传入转义类型名称作为第二个参数，选择合适的规则。规则支持 ‘html’, ‘js’, ‘css’, ‘url’ 和 ‘attr’:

<a href="<?= esc($url, 'url') ?>" data-foo="<?= esc($bar, 'attr') ?>">Some Link</a>

<script>
        var siteName = '<?= esc($siteName, 'js') ?>';
</script>

<style>
        body {
                background-color: <?= esc('bgColor', 'css') ?>
        }
</style>