时间:2021-07-01 10:21:17 帮助过:3人阅读
视图块放在 $scripts_for_layout,并提供一个允许你在视图/布局中任意位置定义插槽或者块的灵活的 API。 块是实现类似边栏这样的东东的理想方法,或者是在布局的头/尾加载资源的好地方。块有两种定义方式:作为捕获块,或者通过直接赋值。start()、 append() 和 end() 方法是和捕获块一同工作的:
1 // 建立一个边栏块 2 $this->start('sidebar'); 3 echo $this->element('sidebar/recent_topics'); 4 echo $this->element('sidebar/recent_comments'); 5 $this->end(); 6 8 // 随后添加一个边栏 9 $this->append('sidebar'); 10 echo $this->element('sidebar/popular_topics'); 11 $this->end();
也可以多次使用 start() 添加进一个块。 任何时候都可以使用 assign() 清除或者覆盖一个块:
1 // 清除之前定义的边栏块的内容。 2 $this->assign('sidebar', '');
在 2.3 版本中,新加了几个与块一同工作的方法。prepend() 预置一个已存在的块的内容:
1 // 预置到边栏。 2 $this->prepend('sidebar', 'this content goes on top of sidebar');
startIfEmpty() 方法在一个块为空或者未定义时生成一个块。如果块已经存在,则 startIfEmpty() 定义的内容被忽略。当你想要在块不存在时为其定义默认内容时,可以使用这一方法::
1 // 在视图文件中。 2 // 创建一个导航栏块。 3 $this->startIfEmpty('navbar'); 4 echo $this->element('navbar'); 5 echo $this->element('notifications'); 6 $this->end(); 7 8 // 在父视图/布局中。 9 $this->startIfEmpty('navbar'); 10 Default content 11 $this->end(); 12 13 echo $this->fetch('navbar');
上面的例子中,navbar 块包含在第一部分中添加的内容。一旦在子视图中定义了这个块,其默认内容将被忽略。
显示块
可以使用 fetch() 方法显示块。 fetch 将安全地输出一个块,如果块不存在,就返回 ‘’。
1 echo $this->fetch('sidebar');
还可以根据一个块是否存在来决定是否显示其内容。要想在布局、继承视图文件中有条件的显示头或者其它标签时,这种方法非常有用:
1 // 在 app/View/Layouts/default.ctp 中 2 if ($this->fetch('menu')): ?> 3 class="menu"> 4Menu options
5 echo $this->fetch('menu'); ?> 6 7 endif; ?>
在 2.3.0 版,还可以在块没有内容时为其提供默认值。这使为空状态添加占位符变得更容易。可以使用两个参数提供默认值:
1 class="shopping-cart"> 2Your Cart
3 echo $this->fetch('cart', 'Your cart is empty'); 4
块替代了被废弃的 $scripts_for_layout 布局变量。HtmlHelper 关联到视图块,它的 script() 、 css() 和 meta()方法在与 inline = false 选项共同使用时使用相同的相同的名字更新一个块。
1 2 // 在视图文件中。 3 $this->Html->script('carousel', array('inline' => false)); 4 $this->Html->css('carousel', null, array('inline' => false)); 5 ?> 6 7 // 在布局文件中。 8 9 10 11echo $this->fetch('title'); ?> 12 echo $this->fetch('script'); ?> 13 echo $this->fetch('css'); ?> 14 15 // 下面是剩余的布局尊容...
HtmlHelper 还允许你控制使用哪个 scripts 和 CSS 块:
1 // 在视图文件中。 2 $this->Html->script('carousel', array('block' => 'scriptBottom')); 3 4 // 在布局文件中。 5 echo $this->fetch('scriptBottom');