laravel模板继承中yield和section的区别

laravel模板继承中,经常使用的两种方式即为yield和section.laravel

@section('sidebar')
            这是 master 的侧边栏。
        @show
section命令正如其名字所暗示的同样是用来定义一个视图区块的,其中每每还有内容,模板继承的时候
yield指令是用来显示指定区块的内容的git

当子页面继承布局以后,便可使用 @section 命令将内容注入于布局的 @section 区块中github

sidebar 区块利用了 @parent 命令追加布局中的 sidebar 区块中的内容,若是不使用则会覆盖掉布局中的这部份内容。 @parent 命令会在视图被渲染时替换为布局中的内容。app

-------------------------框架

这篇文章主要介绍了Laravel模板引擎Blade中section的一些标签的区别介绍,本文讲解了@yield  @section@show  @stop@append  @override的区别,须要的朋友能够参考下编辑器

Laravel 框架中的 Blade 模板引擎,很好用,可是在官方文档中有关 Blade 的介绍并不详细,有些东西没有写出来,而有些则是没有说清楚。好比,使用中可能会遇到这样的问题:ide

1.@yield  @section 均可以预约义可替代的区块,这二者有什么区别呢?
2.@section 能够用 @show, @stop, @overwrite 以及 @append 来结束,又有什么区别呢?布局

本文试对这些问题作一个比较浅显可是直观的介绍。网站

@yield 与 @section

首先,@yield 是不可扩展的,若是你要定义的部分没有默认内容让子模板扩展的,那么用 @yield($name, $default) 的形式会比较方便,若是你在子模板中并无指定这个区块的内容,它就会显示默认内容,若是定义了,就会显示你定义的内容。非此即彼。spa

与之相比, @section 则既能够被替代,又能够被扩展,这是最大的区别。好比:
代码以下:

{{-- layout.master --}}
@yield('title','默认标题')

@section('content')
默认的内容
@show

代码以下:

{{-- home.index --}}
@extends('layout.master')

@section('title')
@parent
新的标题
@stop

@section('content')
@parent
扩展的内容
@stop

上面的例子中,模板用 @yield  @section 分别定义了一个区块,而后在子模板中去定义内容,因为 @yield 不能被扩展,因此即便加上了 @parent 也不起做用,输出的内容只有“新的标题”,替换了“默认的标题”。所以最终生成的页面只能是“默认的标题”或者“新的标题”,不能并存。而 @section 定义的部分,因为使用了 @parent 关键字,父模板中的内容会被保留,而后再扩展后添加的内容进去,输出的内容会是 “默认的内容 扩展的内容”。

官方网站上的文档中并无涉及 @parent 关键字,说的是默认行为是“扩展”,要覆盖须要用 @override 来结束,这是错的,[github 上的最新文档][docs] 已经作了修正。@section 加上 @stop,默认是替换(注入),必须用 @parent 关键字才能扩展。而 @override 关键字实际上有另外的应用场景。

@show 与 @stop

接下来再说说与 @section 对应的结束关键字,@show, @stop 有什么区别呢?(网上的部分文章,以及一些编辑器插件还会提示 @endsection, 这个在 4.0 版本中已经被移除,虽然向下兼容,可是不建议使用)。

@show 指的是执行到此处时将该 section 中的内容输出到页面,而 @stop 则只是进行内容解析,而且再也不处理当前模板中后续对该section的处理,除非用 @override覆盖(详见下一部分)。一般来讲,在首次定义某个 section 的时候,应该用 @show,而在替换它或者扩展它的时候,不该该用 @show,应该用 @stop。下面用例子说明:

代码以下:

{{-- layout.master --}}
<div id="zoneA">
@section('zoneA')
AAA
@show
</div>

<div id="zoneB">
@section('zoneB')
BBB
@stop
</div>

<div id="zoneC">
@section('zoneC')
CCC
@show
</div>

代码以下:

{{-- page.view --}}
@extends('layout.master')

@section('zoneA')
aaa
@stop

@section('zoneB')
bbb
@stop

@section('zoneC')
ccc
@show

 layout.master 中,用 @stop 来结束 "zoneB",因为整个模板体系中,没有以 @show 结束的 "zoneB" 的定义,所以这个区块不会被显示。而在 page.view 中,用 @show 定义了 'zoneC',这会在执行到这里时当即显示内容,并按照模板继承机制继续覆盖内容,所以最终显示的内容会是:

代码以下:

ccc // 来自 page.view
<div class="zoneA">
aaa
</div>

<div class="zoneB">

</div>

<div class="zoneC">
ccc
</div>

从结果能够看到,zoneB 的内容丢失,由于没有用 @show 告诉引擎输出这部分的内容,而 zoneC 的内容会显示两次,而且还破坏了 layout.master 的页面结构,由于 @show 出现了两次。

@append 和 @override

刚才说到了,@override 并非在子模板中指明内容替换父模板的默认内容,而是另有用途,那么是如何使用呢?这又涉及到一个 section 在模板中能够屡次使用的问题。也即咱们所定义的每个 section ,在随后的子模板中实际上是能够屡次出现的。好比:

代码以下:

{{-- master --}}
<div>
@yield('content')
</div>

代码以下:

{{-- subview --}}
@extends('master')

@section('content')
加一行内容
@append

@section('content')
再加一行内容
@append

@section('content')
加够了,到此为止吧。
@stop

在上例中,我在父级模板中只定义了一个名为 "content" 的 section,而在子模板中三次指定了这个 section 的内容。 这个例子最终的输出是:

代码以下:

<div>
加一行内容
再加一行内容
加够了,到此为止吧。
</div>

三次指定的内容都显示出来了,关键就在于 @append 这个关键字,它代表“此处的内容添加到”,所以内容会不断扩展。而最后用了 @stop,表示这个 section 的处理到此为止。若是在后面继续用 @append 或者 @stop 来指定这个 section 的内容,都不会生效。除非用 @override 来处理。 @override 的意思就是“覆盖以前的全部定义,以此次的为准”。好比:

代码以下:

{{-- master --}}
<div>
@yield('content')
@yield('message')
</div>

代码以下:

{{-- master --}}
<div>
@section('content')
加一行内容
@append
@section('content')
再加一行内容
@append
@section('content')
加够了,结束吧
@stop
@section('content')
都不要了,我说的。
@override
</div>

这个例子和刚才的相似,只不过最后加了一组定义。最终的输出会是:

代码以下:

<div>
都不要了,我说的。
</div>

因此,在正式的项目中,有时候须要对数据进行遍历输出的,可使用 @append,而若是遍历到了某个数据发现前面的都错了呢?用 @override 就能够所有推翻。


参考地址:http://www.jb51.net/article/60957.htm

相关文章
相关标签/搜索