局部视图是 Harp 中的最重要地部分，并且在所有的模板语言中都以同样的方式工作。一个局部视图可以被放在 EJS 或Jade 文件的任何地方，并且文件的内容会被混合起来。

• 使用局部视图
• 在 EJS 文件中使用局部视图
• 在 Jade 文件中使用局部视图
• Markdown 以及局部视图函数

为什么？

为了保持你的应用或者站点 “不要自我重复（DRY）”，你需要一个复用内容的方式。局部视图提供了一个简单的接口，在复用项目代码块方面有很大的灵活性，效率很高。

属性

• 局部视图路径 - (String) 你想包含的文件的相对路径。
• data [对象] - (String) 你希望传入局部视图的数据，可选。

使用局部视图

如果说你正在创建一个简单的网站，并且希望包含一个会出现在每个页面上的头部。项目有一个 index.ejs 文件和一个about.ejs 文件，想在两个文件中都包含存储在 _header.ejs 文件中的内容。

由于 _header.ejs 文件以下划线开头，所以不会被直接对外服务。然而，你可以使用局部视图函数将它包含到另一个文件中。

_header.ejs 文件的内容可以随你意地简单或者复杂，例如：

<h1>This is my site</h1>
<p>This content is in a Partial.</p>

在 EJS 文件中使用局部视图

index.ejs 文件中，调用 partial("_header") 将 _header.ejs 文件中的内容包含进来：

<%- partial("_header") %> 

在 _header.ejs 文件中，<h1> 标签中的标题时硬编码的，但是如果你想根据它是哪个文件的部分来改变的话，该怎么做呢？使用局部视图函数，这也是可以做到的。当一个文件通过局部视图被引用，数据也可以传进来，代替局部视图中的指定变量。

更新 _header.ejs 文件使得 <h1> 标签包含变量标题：

<h1><%- title %></h1>
<p>This content is in a Partial.</p>

<%- partial("_header", { title: "About me" }) %> 

<%- partial("_header", { title: "About me", description: "This is my about page" }) %> 

在 Jade 中使用局部视图与在 EJS 中使用非常相似。Jade 中的函数以 != 开头，而不是像 EJS 包裹在 <%- %> 中。在两种语言中，这都表明内容应该被渲染，这样无论局部视图中的是什么代码，都会被渲染，而不会被过滤。

h1
  != title
p This content i

!= partial("_header")

!= partial("_header", { title: "Contact me" }) 

!= partial("_header", { title: "Contact me", description: "This is my Jade contact page with an EJS header" }) %> 

Markdown 和局部视图

在 Markdown 文件中不太可能直接使用局部视图函数，因为 Markdown 不是一个模板语言。 然而，仍然可以使用局部视图函数将 Markdown 文件包含到 EJS 或者 Jade 文件中。在下面的例子中，_shared 目录中有一个叫做 an-example.md 的 Markdown 文件。如果将 an-example.md 的内容引入到一个 Jade 文件的 article 标签中，你可以使用下面的代码：

article!= partial("_shared/an-example") 

doctype
  head
    title An example
  body
    .main
      :markdown
        # now I can write Markdown here

        This is my Markdown post.
        1. Chocolate
        2. Strawberry
        3. Vanilla