内置组件(Built-In Components)

本章通过适当的示例介绍了Tapestry的内置组件。 Tapestry支持超过65种内置组件。您还可以创建自定义组件。让我们详细介绍一些值得注意的组件。

如果是组件

if组件用于有条件地呈现块。通过测试参数检查条件。

创建一个页面IfSample.java如下所示 -

package com.example.MyFirstApplication.pages;  
public class Ifsample {
   public String getUser() { 
      return "user1"; 
   } 
}

现在，创建一个相应的模板文件，如下所示 -

<html t:type = "newlayout" title = "About MyFirstApplication" 
   xmlns:t = "http://tapestry.apache.org/schema/tapestry_5_4.xsd" 
   xmlns:p = "tapestry:parameter"> 
   <h3>If-else component example </h3> 
   <t:if test = "user"> 
      Hello ${user} 
      <p:else>
         <h4> You are not a Tapestry user </h4> 
      </p:else> 
   </t:if> 
</html>

请求页面将呈现如下所示的结果。

Result - http:// localhost:8080/MyFirstApplication/ifsample

除非和委托组件

unless component恰好与上面讨论的if组件相反。虽然， delegate component本身不进行任何渲染。相反，它通常将标记委托给块元素。除非组件可以使用委托和块来有条件地交换动态内容。

创建一个页面， Unless.java如下。

package com.example.MyFirstApplication.pages;  
import org.apache.tapestry5.Block; 
import org.apache.tapestry5.annotations.Property; 
import org.apache.tapestry5.ioc.annotations.Inject; 
import org.apache.tapestry5.PersistenceConstants; 
import org.apache.tapestry5.annotations.Persist;  
public class Unless { 
   @Property 
   @Persist(PersistenceConstants.FLASH) 
   private String value;  
   @Property 
   private Boolean bool; 
   @Inject 
   Block t, f, n;  
   public Block getCase() { 
      if (bool == Boolean.TRUE ) { 
         return t; 
      } else { 
         return f; 
      } 
   }   
}

现在，创建一个相应的模板文件，如下所示 -

<html t:type = "newlayout" title = "About MyFirstApplication" 
   xmlns:t = "http://tapestry.apache.org/schema/tapestry_5_4.xsd" 
   xmlns:p = "tapestry:parameter"> 
   <h4> Delegate component </h4> 
   <div class = "div1"> 
      <t:delegate to = "case"/> 
   </div> 
   <h4> If-Unless component </h4>  
   <div class = "div1"> 
      <t:if test = "bool"> 
         <t:delegate to = "block:t"/> 
      </t:if> 
      <t:unless test = "bool"> 
         <t:delegate to = "block:notT"/> 
      </t:unless> 
   </div>  
   <t:block id = "t"> 
      bool == Boolean.TRUE. 
   </t:block> 
   <t:block id = "notT"> 
      bool = Boolean.FALSE. 
   </t:block> 
   <t:block id = "f"> 
      bool == Boolean.FALSE. 
   </t:block> 
</html>

请求页面将呈现如下所示的结果。

Result - http:// localhost:8080/MyFirstApplication/unless

循环组件

循环组件是循环集合项的基本组件，并为每个值/迭代渲染正文。

创建一个Loop页面，如下所示 -

Loop.java

package com.example.MyFirstApplication.pages;  
import org.apache.tapestry5.annotations.Property;  
public class Loop { 
   @Property 
   private int i; 
}

然后，创建相应的模板Loop.tml

Loop.tml

<html t:type = "newlayout" title = "About MyFirstApplication" 
   xmlns:t = "http://tapestry.apache.org/schema/tapestry_5_4.xsd" 
   xmlns:p = "tapestry:parameter">  
   <p>This is sample parameter rendering example...</p> 
   <ol>
      <li t:type = "loop" source = "1..5" value = "var:i">${var:i}</li> 
   </ol> 
</html>

循环组件有以下两个参数 -

source - 收集源。 1 ... 5是用于创建具有指定范围的数组的属性扩展。
var - 渲染变量。用于呈现模板正文中的当前值。

请求页面将呈现如下所示的结果 -

PageLink组件

PageLink组件用于将页面从一个页面链接到另一个页面。创建一个PageLink测试页面如下 - PageLink.java 。

package com.example.MyFirstApplication.pages;  
   public class PageLink { 
}

然后，创建一个相应的模板文件，如下所示 -

PageLink.tml

<html t:type = "newlayout" title = "About MyFirstApplication" 
   xmlns:t = "http://tapestry.apache.org/schema/tapestry_5_4.xsd" 
   xmlns:p = "tapestry:parameter">  
   <body> 
      <h3><u>Page Link</u> </h3> 
      <div class = "page"> 
         <t:pagelink page = "Index">Click here to navigate Index page</t:pagelink>
         <br/> 
      </div> 
   </body> 
</html>

PageLink组件有一个页面参数，该参数应该引用目标tapestry页面。

Result - http:// localhost:8080/myFirstApplication/pagelink

EventLink组件

EventLink组件通过URL发送事件名称和相应的参数。创建一个EventsLink页面类，如下所示。

EventsLink.java

package com.example.MyFirstApplication.pages;  
import org.apache.tapestry5.annotations.Property;  
public class EventsLink { 
   @Property 
   private int x; 
   void onActivate(int count) { 
      this.x = x; 
   } 
   int onPassivate() { 
      return x; 
   } 
   void onAdd(int value) { 
      x += value; 
   }   
}

然后，创建相应的“EventsLink”模板文件，如下所示 -

EventsLink.tml

<html t:type = "newlayout" title = "About MyFirstApplication" 
   xmlns:t = "http://tapestry.apache.org/schema/tapestry_5_4.xsd" 
   xmlns:p = "tapestry:parameter"> 
   <h3> Event link example </h3> 
   AddedCount = ${x}. <br/> 
   <t:eventlink t:event = "add" t:context = "literal:1">
      Click here to add count
   </t:eventlink><br/>  
</html>

EventLink有以下两个参数 -

Event - 要在EventLink组件中触发的事件的名称。默认情况下，它指向组件的id。
Context - 它是一个可选参数。它定义了链接的上下文。

Result - http:// localhost:8080/myFirstApplication/EventsLink

单击计数值后，页面将在URL中显示事件名称，如以下输出屏幕截图所示。

ActionLink组件

ActionLink组件类似于EventLink组件，但它仅发送目标组件ID。默认事件名称是action。

创建一个页面“ActivationLinks.java”，如下所示，

ActivationLinks.java

package com.example.MyFirstApplication.pages;  
import org.apache.tapestry5.annotations.Property;  
public class ActivationLinks {  
   @Property 
   private int x;  
   void onActivate(int count) { 
      this.x = x; 
   }  
   int onPassivate() { 
      return x; 
   } 
   void onActionFromsub(int value) { 
      x -= value; 
   } 
}

现在，创建一个相应的模板文件，如下所示 -

ActivationLinks.tml

<html t:type = "Newlayout" title = "About MyFirstApplication" 
   xmlns:t = "http://tapestry.apache.org/schema/tapestry_5_4.xsd" 
   xmlns:p = "tapestry:parameter">  
   <div class = "div1"> 
      Count = ${count}. <br/> 
      <t:actionlink t:id = "sub" t:context = "literal:1">
         Decrement
      </t:actionlink><br/> 
   </div> 
</html>

这里，单击ActionLink组件时将调用OnActionFromSub方法。

Result - http:// localhost:8080/myFirstApplication/ActivationsLink

警报组件

警报对话框主要用于向用户发出警告消息。例如，如果输入字段需要一些必需的文本但用户不提供任何输入，那么作为验证的一部分，您可以使用警告框来发出警告消息。

创建一个“警报”页面，如以下程序所示。

Alerts.java

package com.example.MyFirstApplication.pages;  
public class Alerts { 
   public String getUser() { 
      return "user1"; 
   } 
}

然后，创建一个相应的模板文件，如下所示 -

Alerts.tml

<html t:type = "Newlayout" title = "About MyFirstApplication" 
   xmlns:t = "http://tapestry.apache.org/schema/tapestry_5_4.xsd"  
   xmlns:p = "tapestry:parameter">  
   <h3>Alerts</h3> 
   <div class = "alert alert-info"> 
      <h5> Welcome ${user} </h5> 
   </div>
</html>

警报有三个严重级别，分别是 -

Info
Warn
Error

使用信息警报创建上述模板。它被定义为alert-info 。您可以根据需要创建其他严重性。

请求页面将产生以下结果 -

http://localhost:8080/myFirstApplication/Alerts

<上一篇.Apache Tapestry - 组件( Components)

表单和验证组件(Forms & Validation Components).下一篇>

Apache Tapestry - 教程

Apache Tapestry - 概述

Apache Tapestry - 架构( Architecture)

Apache Tapestry - 安装

Apache Tapestry - 快速入门( Quick Start)

Apache Tapestry - 项目布局( Project Layout)

约定配置(Convention Over Configuration)

Apache Tapestry - Annotation( Annotation)

页面和组件(Pages and Components)

Apache Tapestry - 模板

Apache Tapestry - 组件( Components)