public class InputCalendarTag
extends javax.servlet.jsp.tagext.TagSupport
以下の項目をメッセージリソースファイルに記述することで、
カレンダー入力機能の設定を変更することができる。
なお、メッセージリソースファイル名は「calendar」固定とする。
例:「calendar.properties」、「calendar_en.properties」
機能詳細 | メッセージリソースファイルに以下のように記述することで カレンダーの休日を指定することができる。 メッセージリソースキーは、「calendar.holiday.」部分を固定として、 その後に、「1」から連番を振ることとする。 パラメータは、「年」「月」「日」「休日概要」を「,(カンマ)」で 区切って記述することとする。 毎年同じ日付の休日定義は「年」を「0」と 指定することで毎年と認識する。 |
設定例 |
calendar.holiday.1=0,1,1,元日 calendar.holiday.2=0,2,11,建国記念の日 calendar.holiday.3=0,4,29,昭和の日 calendar.holiday.4=0,5,3,憲法記念日 calendar.holiday.5=0,5,4,みどりの日 calendar.holiday.6=0,5,5,こどもの日 calendar.holiday.7=0,11,3,文化の日 calendar.holiday.8=0,11,23,勤労感謝の日 calendar.holiday.9=0,12,23,天皇誕生日 calendar.holiday.10=2009,1,12,成人の日 calendar.holiday.11=2009,3,20,春分の日 calendar.holiday.12=2009,7,20,海の日 calendar.holiday.13=2009,9,21,敬老の日 calendar.holiday.14=2009,9,23,秋分の日 calendar.holiday.15=2009,10,12,体育の日 : |
機能詳細 | メッセージリソースファイルに以下のように記述することで カレンダーを表示するボタンの文字列を変更することができる。 メッセージリソースキーは、「calendar.button.string」固定とする。 デフォルトは「Calendar」となる。 |
設定例 | calendar.button.string=カレンダー |
機能詳細 |
メッセージリソースファイルに以下のように記述することで
カレンダーにて使用するスタイルシートのプレフィックス、
および画像ファイルのプレフィックスを変更することができる。
メッセージリソースキーは、「calendar.style.themeprefix」固定とする。 デフォルトは「BlueStyle」となる。 |
設定例 | calendar.style.themeprefix=BlueStyle |
機能詳細 |
メッセージリソースファイルに以下のように記述することで
カレンダーの下部に表示される現在日付に付与する文字列を
変更することができる。
メッセージリソースキーは、「calendar.today.string」固定とする。 デフォルトは「Today is 」となる。 |
設定例 | calendar.today.string=Today is |
機能詳細 |
メッセージリソースファイルに以下のように記述することで
カレンダー入力機能にて使用する画像の保存場所を変更することができる。
最後は「/」で終わる必要がある。
画像の保存場所は変更可能だが、画像ファイルの名前は変更することができない。
メッセージリソースキーは、「calendar.img.dir」固定とする。 デフォルトは「img/calendar/」となる。 |
設定例 | calendar.img.dir=image/ |
機能詳細 |
メッセージリソースファイルに以下のように記述することで
カレンダー入力機能にて使用するスタイルシートの保存場所を
変更することができる。最後は「/」で終わる必要がある。
この機能で使用するスタイルシートのファイル名は、
「<プレフィックス> + InputCalendar.css」である。
メッセージリソースキーは、「calendar.stylesheet.dir」固定とする。 デフォルトは「css/」となる。 |
設定例 | calendar.stylesheet.dir=style/ |
機能詳細 |
メッセージリソースファイルに以下のように記述することで
カレンダー入力機能にて使用する外部JavaScriptの保存場所を
変更することができる。最後は「/」で終わる必要がある。
この機能で使用するJavaScriptのファイル名は、
「InputCalendar.js」である。
メッセージリソースキーは、「calendar.javascript.dir」固定とする。 デフォルトは「js/」となる。 |
設定例 | calendar.javascript.dir=javascript/ |
以下のように、入力フィールドと対となるように記述する。 カレンダー入力機能のfor属性には、対象となる入力フィールドの名前を 指定する。以下の例では、text要素のproperty属性が入力フィールドの 名前となるため、for属性には、text要素のproperty属性と同じ値を 指定する。
<html:text property="value" />
<t:inputCalendar for="value" format="yyyy-MM-dd" />
カレンダー入力機能では、以下の属性をサポートする。
属性名 | デフォルト値 | 必須性 | 実行時式 | 概要 |
for |
- |
true |
true |
選択した日付を入力する入力フィールドを指定する。 |
format |
yyyy/MM/dd |
false |
true |
カレンダーのフォーマットを指定する。 指定できる日付形式は「y(年)」「M(月)」「d(日)」、 区切文字としては「/」「-」「.」「半角スペース」 のいずれかである。また、区切り文字は、一文字のみを使用すること。 「yyyy/MM-dd」のように複数の区切り文字を使用することはできない。 |
formatKey |
- |
false |
true |
カレンダーのフォーマットをメッセージリソースから 取得するためのキー値を指定する。 |
修飾子とタイプ | フィールドと説明 |
---|---|
protected static String |
CALENDAR_BUTTON_VALUE
カレンダー入力機能にて使用するボタン表示文字列を
メッセージリソースから取得するための取得キー。
|
protected static String |
CALENDAR_DEFAULT_BUTTON_VALUE
デフォルトのカレンダーボタン表示文字列。
|
protected static String |
CALENDAR_DEFAULT_FORMAT
デフォルトのフォーマット。
|
protected static String |
CALENDAR_DEFAULT_IMAGE_PATH
デフォルトの画像保存場所パス。
|
protected static String |
CALENDAR_DEFAULT_JAVASCRIPT_DIR
デフォルトのカレンダー外部JavaScript保存場所。
|
protected static String |
CALENDAR_DEFAULT_STYLEPREFIX_NAME
デフォルトスタイルプレフィックス名。
|
protected static String |
CALENDAR_DEFAULT_STYLESHEET_DIR
デフォルトのスタイルシート保存場所。
|
protected static String |
CALENDAR_HOLIDAY_PREFIX
カレンダー入力機能にて使用する休日定義情報を
メッセージリソースから取得するための取得キー。
|
protected static String |
CALENDAR_IMG_DIR
カレンダー入力機能にて使用するカレンダー画像保存場所を
メッセージリソースから取得するための取得キー。
|
protected static String |
CALENDAR_JAVASCRIPT_DIR
カレンダー入力機能にて使用するカレンダー外部JavaScript保存場所を
メッセージリソースから取得するための取得キー。
|
protected static String |
CALENDAR_JAVASCRIPT_FILE_NAME
カレンダー入力機能して使用するJavaScriptのファイル名。
|
protected static String |
CALENDAR_STYLE_THEMEPREFIX
カレンダー入力機能にて使用するスタイルプレフィックスを
メッセージリソースから取得するための取得キー。
|
protected static String |
CALENDAR_STYLESHEET_DIR
カレンダー入力機能にて使用するスタイルシート保存場所を
メッセージリソースから取得するための取得キー。
|
protected static String |
CALENDAR_STYLESHEET_FILE_NAME
カレンダー入力機能して使用するスタイルシートのファイル名(プレフィックス無し)。
|
protected static String |
CALENDAR_TODAY_STRING
カレンダー入力機能にて使用する現在日付付与文字列を
メッセージリソースから取得するための取得キー。
|
protected static String |
FORMAT_VALUE
対応しているフォーマット文字群。
|
protected static String |
INPUTCALENDAR_FLG
出力状態フラグキー。
|
コンストラクタと説明 |
---|
InputCalendarTag() |
修飾子とタイプ | メソッドと説明 |
---|---|
protected String |
createFormat(String format)
引数の文字列に対してデートフォーマットの精査を行う。
|
protected String |
defineArrayVariable(String arrayName,
String[] array)
引数にて渡された配列を
JavaScript の
Array 型として編集して返却する。 |
protected void |
defineButton(ResourceBundle calendarBundle)
カレンダー画面を表示するためのボタンを出力する。
|
protected void |
defineJavaScript(ResourceBundle calendarBundle)
JavaScriptの定義部分を出力する。
|
protected String |
defineObjectVariable(String name,
String value)
引数にて渡された値を
JavaScript の
Object 宣言として、返却する。 |
protected String |
defineStringVariable(String name,
String value)
引数にて渡された値を
JavaScript の
String 宣言として返却する。 |
int |
doStartTag()
タグ評価開始時に呼ばれるメソッド。
|
String |
getFor()
対応テキストフィールド指定属性の値を返却する。
|
String |
getFormat()
フォーマット指定属性の値を返却する。
|
String |
getFormatKey()
フォーマットキー指定属性の値を返却する。
|
protected List<Map<String,String>> |
getHolidayList(ResourceBundle calendarBundle)
メッセージリソースに定義された休日定義を取得する。
|
protected boolean |
getPageContextFlg(javax.servlet.jsp.PageContext pageContext,
String key)
指定されたKEYにて取得した値を真偽値に変換して返却する。
|
protected String |
getParameter(ResourceBundle calendarBundle,
String key,
String def)
メッセージリソースからキーを元に値を取得して返却する。
|
protected String[] |
mapMonths(DateFormatSymbols symbols)
指定されたデートフォーマットシンボルから「月」を取得して返却する。
|
protected String[] |
mapWeekdays(DateFormatSymbols symbols)
指定されたデートフォーマットシンボルから「曜日」を取得して返却する。
|
void |
release()
すべてのアロケートされた資源を解放する。
|
void |
setFor(String forId)
対応テキストフィールド指定属性の値を設定する。
|
void |
setFormat(String format)
フォーマット指定属性の値を設定する。
|
void |
setFormatKey(String formatKey)
フォーマットキー指定属性の値を設定する。
|
protected void |
setPageContextFlg(javax.servlet.jsp.PageContext pageContext,
String key)
ページコンテキストに対して、指定されたKEYのフラグを設定する。
|
protected static final String CALENDAR_IMG_DIR
protected static final String CALENDAR_TODAY_STRING
protected static final String CALENDAR_BUTTON_VALUE
protected static final String CALENDAR_STYLE_THEMEPREFIX
protected static final String CALENDAR_STYLESHEET_DIR
protected static final String CALENDAR_JAVASCRIPT_DIR
protected static final String CALENDAR_HOLIDAY_PREFIX
protected static final String CALENDAR_DEFAULT_FORMAT
protected static final String CALENDAR_DEFAULT_STYLEPREFIX_NAME
protected static final String CALENDAR_DEFAULT_IMAGE_PATH
protected static final String CALENDAR_DEFAULT_BUTTON_VALUE
protected static final String CALENDAR_DEFAULT_STYLESHEET_DIR
protected static final String CALENDAR_DEFAULT_JAVASCRIPT_DIR
protected static final String CALENDAR_JAVASCRIPT_FILE_NAME
protected static final String CALENDAR_STYLESHEET_FILE_NAME
public String getFor()
public void setFor(String forId)
forId
- 設定する値public String getFormat()
public void setFormat(String format)
format
- 設定する値public String getFormatKey()
public void setFormatKey(String formatKey)
formatKey
- 設定する値public int doStartTag() throws javax.servlet.jsp.JspException
doStartTag
インタフェース内 javax.servlet.jsp.tagext.Tag
doStartTag
クラス内 javax.servlet.jsp.tagext.TagSupport
javax.servlet.jsp.JspException
- JSP例外protected void defineJavaScript(ResourceBundle calendarBundle) throws javax.servlet.jsp.JspException
calendarBundle
- カレンダー入力機能用リソースバンドルjavax.servlet.jsp.JspException
- JSP例外protected List<Map<String,String>> getHolidayList(ResourceBundle calendarBundle)
calendarBundle
- カレンダー入力機能用リソースバンドルprotected void defineButton(ResourceBundle calendarBundle) throws javax.servlet.jsp.JspException
calendarBundle
- カレンダー入力機能用リソースバンドルjavax.servlet.jsp.JspException
- JSP例外protected String getParameter(ResourceBundle calendarBundle, String key, String def)
calendarBundle
- カレンダー入力機能用リソースバンドルkey
- メッセージリソースのキーdef
- デフォルトとなる値protected String defineStringVariable(String name, String value)
JavaScript
の
String
宣言として返却する。kanji
」、値「漢字」⇒
「var kanji = "漢字";\n
」となる。name
- JavaScript
で宣言する変数名value
- 変数の値protected String defineObjectVariable(String name, String value)
JavaScript
の
Object
宣言として、返却する。obj1
」、
値「document.forms[0]
」
⇒「var obj1 = document.forms[0];\n
」となる。name
- JavaScript
で宣言する変数名value
- 変数の値protected String defineArrayVariable(String arrayName, String[] array)
JavaScript
の
Array
型として編集して返却する。array
」、値「10,20,30
」
⇒「var obj1 = new Array("10","20","30");\n
」arrayName
- JavaScript
で宣言する変数名array
- Array
として作成する値を保持する配列protected String[] mapWeekdays(DateFormatSymbols symbols)
symbols
- デートフォーマットシンボル(ロケール設定済み)protected String[] mapMonths(DateFormatSymbols symbols)
symbols
- デートフォーマットシンボル(ロケール設定済み)protected boolean getPageContextFlg(javax.servlet.jsp.PageContext pageContext, String key)
pageContext
- ページコンテキストkey
- FLGを取得するKEYprotected void setPageContextFlg(javax.servlet.jsp.PageContext pageContext, String key)
pageContext
- ページコンテキストkey
- FLGを設定するKEYprotected String createFormat(String format)
null
、または空白の場合は、
そのまま返却する。
また、文字列がデートフォーマットに対応していない場合は、無視する。format
- デートフォーマットpublic void release()
release
インタフェース内 javax.servlet.jsp.tagext.Tag
release
クラス内 javax.servlet.jsp.tagext.TagSupport
Copyright © 2015. All Rights Reserved.