uCosminexus Portal Framework ポートレット開発ガイド
URL変換タグライブラリは,URLを指定する属性を持つHTML/CHTML/HDMLの要素をラッピングしたものです。必要に応じて,指定された相対パス形式のURLをURL変換し,HTML/CHTML/HDML要素として出力します。HTML/CHTML/HDMLで必須属性として定義されている属性はURL変換タグライブラリでも必須となります。
URL変換タグライブラリは,HTML/CHTML/HDMLの次のバージョンに従います。
- HTML4.01
- iモード対応 HTML2.0
- Version 3.3 for HDML
URL変換タグライブラリでは,HttpServletResponse#encodeURLが呼び出されるので,ポートレット開発時に明示的にencodeURLを呼び出す必要はありません。また,例外発生時には,javax.servlet.jsp.JspExceptionが発生します。
URL変換タグライブラリは次の点で通常の使用方法と異なります。
- 開始,終了タグおよび属性名は,要素ごとに大文字または小文字に統一する必要があります。
- HTML/CHTML/HDMLで属性値だけを指定できる属性は,タグライブラリでは属性名=属性値として記述する必要があります。
- HTML/CHTML/HDMLで空要素となる要素には,内容を記述できません。空要素として記述します。
- 次の属性名は,HTMLの属性名とタグライブラリの属性名が異なります。正しく指定してください。HTMLの属性名とタグライブラリの属性を次の表に示します。
表3-1 HTMLの属性名とタグライブラリの属性
HTMLの属性名 タグライブラリの属性名 class hclass id hid accept-charset accept_charset - 次の属性はタグライブラリでは使用できません。次の属性を使用するには,HTMLタグを使用して記述し,PortletURIクラスでURL変換してください。タグライブラリで使用できない属性を次の表に示します。
表3-2 タグライブラリで使用できない属性
要素名 属性名 area nohref img ismap input ismap,checked,disable,readonly object declare script defer - URLを指定する属性およびonで始まるイベント属性は,JSPスクリプトレット式で評価されます。JSPスクリプトレット式で評価される属性については,「14.2 ポートレットユティリティタグライブラリ」を参照してください。
All Rights Reserved. Copyright (C) 2009, 2013, Hitachi, Ltd.
All Rights Reserved. Copyright (C) 2009, 2013, Hitachi INS Software, Ltd.