Apache-tapestry-built-in-components

提供：Dev Guides
移動先:案内、検索

Apache Tapestry-組み込みコンポーネント

この章では、Tapestryに組み込まれているコンポーネントについて、適切な例を使用して説明します。 Tapestryは65以上の組み込みコンポーネントをサポートしています。 カスタムコンポーネントを作成することもできます。 注目すべきコンポーネントのいくつかを詳細に説明しましょう。

Ifコンポーネント

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>

ページをリクエストすると、次のように結果がレンダリングされます。

結果-http：//localhost：8080/MyFirstApplication/ifsample

Ifコンポーネントの結果

除外コンポーネントと委任コンポーネント

  • unlessコンポーネント*は、上記で説明したifコンポーネントのちょうど反対です。 一方、* delegateコンポーネント*はそれ自体ではレンダリングを行いません。 代わりに、通常、マークアップをブロック要素に委任します。 コンポーネントがデリゲートとブロックを使用して動的コンテンツを条件付きで交換できる場合を除きます。

次のようにページ 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>

ページをリクエストすると、次のように結果がレンダリングされます。

結果-http：//localhost：8080/MyFirstApplication/unless

デリゲートコンポーネント

ループコンポーネント

ループコンポーネントは、コレクションアイテムをループ処理し、値/反復ごとにボディをレンダリングする基本コンポーネントです。

以下に示すように、ループページを作成します-

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>

ループコンポーネントには次の2つのパラメータがあります-

  • 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コンポーネントには、ターゲットのタペストリーページを参照するページパラメーターがあります。

結果-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には次の2つのパラメータがあります-

  • Event -EventLinkコンポーネントでトリガーされるイベントの名前。 デフォルトでは、コンポーネントのIDを指します。
  • コンテキスト-オプションのパラメータです。 リンクのコンテキストを定義します。

結果-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 メソッドが呼び出されます。

結果-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>

アラートには3つの重大度レベルがあります。

  • Info
  • Warn *エラー

上記のテンプレートは、情報アラートを使用して作成されます。* alert-info *として定義されています。 必要に応じて、他の重大度を作成できます。

ページを要求すると、次の結果が生成されます- 

*http：//localhost：8080/myFirstApplication/Alerts*

アラート

「https://www.finddevguides.com/index.php?title=Apache-tapestry-built-in-components&oldid=30281」から取得
Powered by MediaWiki