当前位置: 首页 > 工具软件 > N2CMS > 使用案例 >

N2CMS Mvc Examples 学习记录 (4) – 母版页和视图

安奇
2023-12-01

看母版页和视图会看到很多呈现方面的细节,包括如何使用N2的一些工具类来生成导航菜单、站点路径,如何在页面中放一个Zone(用于容纳Parts),以及如何显示模型对象的数据。不过N2CMS的API文档不是很详细,甚至根本没有说明,有时候不容易想出来一些方法具体实现的什么功能。

1. 母版页(Site.Master)

(1)显示管理工具栏

   1: <n2:SlidingCurtain runat="server">
   2:     <n2:DragDropControlPanel runat="server" />
   3: 
    
    n2:SlidingCurtain>

加上这段代码,管理员登录后可以在页面左看到管理面板工具栏。

(2)生成导航菜单

   1: <ul id="mainMenu">
   2:     <li><a href="<%= N2.Find.StartPage.Url %>">Home
    
    a>
     
     li>
   3:     <%= N2.Web.Tree.From(N2.Find.StartPage, 2).Filters(new N2.Collections.NavigationFilter()).ExcludeRoot(true)%>
   4:     <li><%= Html.ActionLink("Static controller", "Items", "Static", new { id = "from the menu" }, null)%>
    
    li>
   5: 
    
    ul>

N2.Find.StartPage获取到起始页(即首页)的内容项。

N2.Web.Tree.From从指定内容项(这里是起始页)开始查找树结果,查找的深度为2层,并从中用导航过滤器找到所有的内容项,再排除根(即起始页,这个已经显示过了),最后以LI呈现出来。

(3)左边栏内容

   1: <div class="leftColumn">
   2:     <h2><%= N2.Utility.Evaluate(N2.Find.AtLevel(N2.Find.CurrentPage, N2.Find.StartPage, 2), "Title") %>
    
    h2>
   3:     <ul>
   4:         <%= N2.Web.Tree.Between(N2.Find.CurrentPage, N2.Find.StartPage, true, 2).Filters(new N2.Collections.NavigationFilter()).ExcludeRoot(true) %>
   5:     
    
    ul>
   6:     <% Html.DroppableZone("Left").Render(); %>
   7: 
    
    div>
     
     --/leftColumn-->

N2.Find.AtLevel(N2.Find.CurrentPage, N2.Find.StartPage, 2),第一个参数(当前页)是终点(子结点),第二个参数(起始页)是起点(父结点),这两个参数构成了一个树,在这个树结构内从起点确定深度为2级的项,然后用N2.Utility.Evaluate尝试获取它的标题。

N2.Web.Tree.Between(N2.Find.CurrentPage, N2.Find.StartPage, true, 2)应该是找出前两个参数之间的项,第三个参数不是很理解,第四个参数表示开始的层次,这里是从第2层开始,即起始页将不在内。找出来的项不一定都要显示出来,比如新闻容器下的新闻项就不应该显示出来,另外这些项的根顶也不需要,所以后面的工作就是过滤和排除,最后把项用LI呈现。

最后的<% Html.DroppableZone("Left").Render; %>是在此处呈现一个名为"Left"的Zone,这里可以在管理界面中把TextPart放到这里。

(4)右边栏内容

   1: <div class="rightColumn">
   2:     <p>
   3:     <% foreach(N2.ContentItem item in N2.Find.EnumerateBetween(N2.Find.StartPage, N2.Find.CurrentPage, false)) { %>
   4:         <%= N2.Web.Link.To(item) %> /
   5:     <% } %>
   6:     <%= N2.Utility.Evaluate(N2.Find.CurrentPage, "Title") %>
   7:     
    
    p>
   8:     <asp:ContentPlaceHolder ID="MainContentPlaceHolder" runat="server">
   9:     
    
    asp:ContentPlaceHolder>
  10: 
    
    div>
     
     --/rightColumn-->

N2.Find.EnumerateBetween(N2.Find.StartPage, N2.Find.CurrentPage, false)返回两个内容项之间的所有项的迭代(IEnumerable ),false排除了最深层的页面,即当前页面。<%= N2.Web.Link.To(item) %>显示到这些项的链接。最后显示当前页的标题:<%= N2.Utility.Evaluate(N2.Find.CurrentPage, “Titlt”) %>。

下面的占位符把呈现工作交给各个视图模板来实现了。

2. 视图模板

(1)Content/Index.aspx

   1: <%@ Page Title="" Language="C#" MasterPageFile="~/Views/Shared/Site.Master" AutoEventWireup="true" Inherits="ViewPage
    
    
     
     " %>
    
    
   2: <%@ Import Namespace="MvcTest.Models"%>
   3: <asp:Content ID="Content1" ContentPlaceHolderID="MainContentPlaceHolder" runat="server">
   4: <h1>< %= Model.Title % >
    
    h1>
   5: < %= Model.Text % >
   6: 
    
    asp:Content>

显示ContentPage中的标题(Title)和文本(Text),后者本身就是富文本,直接显示就行了。

(2)News/*

a. News.aspx

   1:  <%@ Page Language="C#" MasterPageFile="~/Views/Shared/Site.Master" Inherits="ViewPage
   
   
    
    " %>
   
   
   2:  <%@ Import Namespace="MvcTest.Views.News"%>
   3:  <asp:Content ID="Content1" ContentPlaceHolderID="MainContentPlaceHolder" runat="server">
   4:      <h1><%= Model.News.Title %>
   
   h1>
   5:      <%= Model.News.Text%>
   6:      <div class="comments">
   7:      <% foreach (MvcTest.Models.CommentItem comment in Model.Comments){ %>
   8:          <div>
   9:              <h3><%= comment.Title %>
   
   h3>
  10:              <%= comment.Text %>
  11:          
   
   div>
  12:      <%} %>
  13:      
   
   div>
  14:      <hr />
  15:      <%= N2.Web.Link.To(Model.Back).Text("Back").Class("back") %>
  16:      <%= Html.ActionLink("Comment", "Comment", new { @class = "comment" }) %>
  17:  
   
   asp:Content>

(换了个插入代码的插件,原来用的也挺好,不过对<% %>支持不好,现在好了。)

这里用到了NewViewData类,定义如下:

   1:  public class NewsViewData
   2:  {
   3:      public ContentItem Back { get; set; }
   4:      public NewsPage News { get; set; }
   5:      public IEnumerable
  
  
   
    Comments { get; set; }
   6:  }

控制器负责创建NewsViewData而不是NewsPage的实例并传递给视图。

视图模板中的第15行显示后退到新闻列表页面的链接,第16行则产生到添加评论表单的链接,写法不同。

b. Comment.aspx

   1:  <%@ Page Title="" Language="C#" MasterPageFile="~/Views/Shared/Site.Master" Inherits="ViewPage
   
   
    
    " %>
   
   
   2:  <%@ Import Namespace="MvcTest.Models"%>
   3:  <%@ Import Namespace="MvcTest.Controllers"%>
   4:  <asp:Content ID="Content1" ContentPlaceHolderID="MainContentPlaceHolder" runat="server">
   5:      <% Html.BeginForm("Submit", "News"); %>
   6:          <h1><%= string.Format("Add comment to '{0}'", Model.Title) %>
   
   h1>
   7:          <p>
   8:              <label>Subject
   
   label>
   9:              <%= Html.TextBox("title") %>
  10:          
   
   p>
  11:          <p>
  12:              <label>Comment
   
   label>
  13:              <%= Html.TextArea("text", "") %>
  14:          
   
   p>
  15:          <p>
  16:              <input type="submit" />
  17:              <%= Html.ActionLink("Back", "index") %>
  18:          
   
   p>
  19:      <% Html.EndForm(); %>
  20:  
   
   asp:Content>

这个表单会提交给NewsController的Submit这个Action,最终被存储到数据库中。

(3)NewsContainer/Index.aspx

   1:  <%@ Page Language="C#" MasterPageFile="~/Views/Shared/Site.Master" Inherits="ViewPage
   
   
    
    " %>
   
   
   2:  <%@ Import Namespace="MvcTest.Views.NewsContainer"%>
   3:  <asp:Content ID="Content1" ContentPlaceHolderID="MainContentPlaceHolder" runat="server">
   4:      <h1><%= Model.Container.Title %>
   
   h1>
   5:      <ul class="newsList">
   6:      <% foreach (MvcTest.Models.NewsPage item in Model.News) { %>
   7:          <li><%= N2.Web.Link.To(item) %>
   
   li>
   8:      <% } %>
   9:      
   
   ul>
  10:  
   
   asp:Content>

新闻容器页面,显示新闻项列表。这里也用到了视图数据类,NewsContainerViewData:

   1:  public class NewsContainerViewData
   2:  {
   3:      public Models.NewsContainer Container { get; set; }
   4:      public IEnumerable
  
  
   
    News { get; set; }
   5:  }

不必多说,继续。

(4)TextPart/Index.ascx

   1:  <%@ Control Language="C#" Inherits="System.Web.Mvc.ViewUserControl" %>
   2:  <%= Html.DisplayContent("Text") %>

它可以嵌入到母版页中左边栏上定义的Zone内。

 类似资料: