API Docs for: 1.0.0
Show:

jQuery Class

Module: jsp

Methods

jQuery.escapeCssSpecialChars

(
  • str
)

CSS書式の特殊文字をエスケープする。

セレクタ内にIDやclassなどのリテラルを連結する際に使用する。 参考: http://mathiasbynens.be/notes/css-escapes

Parameters:

  • str String

    エスケープ対象文字列

jQuery.expr.is-blank

()

対象の要素が空のに一致するセレクタ。

input, select, textarea, option であれば、jQuery.fn.val、 それ以外であればjQuery.fn.textの結果で判定する。

jQuery.expr.is-not-blank

()

対象の要素が空でない場合に一致するセレクタ。

input, select, textarea, option であれば、jQuery.fn.val、 それ以外であればjQuery.fn.textの結果で判定する。

jQuery.expr.is-value

(
  • values
)

対象の要素に引数の値のいずれかが含まれる場合に一致するセレクタ。

要素はカンマ区切りで指定できる。

Parameters:

  • values String

    一致する値(カンマ区切り)

jsp

(
  • src
)
JQuery static

JSPソースコードをDOMノードに変換する。

この際、IE8以前とそれ以外のブラウザではXMLの名前空間の扱いが異なるため、 jspタグ名とライブラリ名とのセパレータ文字 ":" を "__"に置換し、 一旦、タグ名の接頭辞に組み込む。

また、これとあわせて以下の事前処理を行う。

  1. JSPコメント(<%-- --%>)の除去。

  2. 属性値内に存在するタグを等価なEL式に置換 (属性値内にタグが記述されていると、DOMに変換できなくなるため)

  3. ブラウザが暗黙的にノード構造の書き換えを行なってしまう以下のタグについて として一旦退避し、html.jsで書き戻す。

    • title/style: HTMLの定義では子要素を持たないので、などのタグを 一律テキストノードに置換してしまう。

    • table/tr/td/th: 親子関係が厳格なため、tagfileやincludeファイル内でtrやtdを単独で配置 すると、ノードツリーから削除されてしまう。

  4. JSPファイル内のトップレベルに記述されたテキストノード(=ディレクティブ) は読み飛ばす。

Parameters:

  • src String

    JSPソースコード

Returns:

JQuery:

JSPタグのDOMノード

jsp_attrs

(
  • context
)
Object

jQuery結果セット中の最初の要素の属性値を格納した Object を返す。 各属性値中のel式は、引数のコンテキストを用いて評価される。

Parameters:

  • context Object

    コンテキスト変数を格納したObject

Returns:

Object:

JSPタグの属性値を格納したObject

Example:

$text = $('<field:text>', {cssClass:'(index % 2 == 0) ? "even" : "odd"'});

$text.jsp_attr({index:8}).cssClass // -> "even"

jsp_eval

(
  • [context]
)
JQuery

jQuery結果セット内のJSPタグを評価し、HTMLタグに変換する。

各タグは以下のように変換される。

  1. HTMLコメントノード (nodeType:8)

    なにもせずそのまま残す。

  2. テキストノード (nodeType:3)

    テキスト中のel式(${...})を評価後の値に置換する。

  3. HTMLタグノード

    属性値中のel式を評価後の値に置換する。。

  4. JSPタグノード

    jsp/taglib/(タグリブ名).js に処理をディスパッチする。 例えば、 <c:if> の変換は jsp/taglib/jstl.js で行なう。

Parameters:

  • [context] Object optional

    コンテキスト変数を格納したObject 省略時は jsp/context の内容を使用する。

Returns:

JQuery:

変換後のHTMLタグのDOMノードを格納したjQuery結果セット

loadTagfile

(
  • path
  • $tagBody
  • context
  • tagName
)
Boolean static

指定されたパス上のタグファイルをJSPタグの内容として展開する。

Parameters:

  • path String

    タグファイルのコンテキストルート配下からの相対パス。

  • $tagBody JQuery

    現在処理中のJSPタグを格納したjQuery結果セット

  • context Object

    現在のコンテキスト変数を格納したオブジェクト

  • tagName String

    現在処理中のJSPタグのタグ名

Returns:

Boolean:

常にfalseを返す。

widget

(
  • constructorOrCommand
  • [args]
)

jQueryプラグインメソッド。

このプラグインメソッドの処理内容は、以下の2点を除き、 $.fn.widgets() と同じである。

  1. wrappedSetの先頭要素のみを処理の対象とする。
  2. 戻り値として、ウィジェットインスタンス、もしくは、 ウィジェットに対して実行したメソッドの戻り値を返す。

Parameters:

  • constructorOrCommand Function | String

    初期化するウィジェットのコンストラクタまたは、実行するメソッド名。

  • [args] Anything optional multiple

    コンストラクタもしくはメソッドの引数。

widgetOption

(
  • widgetType
)
Object

jQueryプラグインメソッド

ノードのclass属性値をパースし、このウィジェットのオプション設定を取得する。 各オプションの値は必ず文字列もしくはnullとなる。

HTML: <div class="SomeWidget -flg1 -option1 val1 -option2 true -selector 'div li.end'/>

オプション: {"flg1": null, "option1": "val1", "true", "selector": "div li.end"}

Parameters:

  • widgetType String

    オプションを取得するウィジェットの識別子

Returns:

Object:

class属性値中に指定されたウィジェットのオプション

widgets

(
  • constructorOrCommand
  • [args]
)

jQueryプラグインメソッド。

このプラグインメソッドは、第一引数の型に従い、以下の2つの処理のいずれかを行う。

$.fn.widgets(constructor:Function, ...args) wrappedSet上の各要素を引数としてconstructorを実行し、 ウィジェットのインスタンスを初期化する。 第2引数以降は、コンストラクタの引数としてそのまま渡される。

なお、初期化されたウィジェットインスタンスは、ノードのdata属性に保存され、 同じノードに対して同じウィジェットの初期化処理が複数回行われた場合、 2回目以降の初期化処理は無視される。

$.fn.widget(command:String, ...args) wrappedSet上の各要素上にウィジェットのインスタンスが保持されている場合に、 第1引数で指定されたメソッドを呼び出し、その結果を格納したwrappedSetを返却する。 第2引数以降は、メソッドの引数としてそのまま渡される。

Parameters:

  • constructorOrCommand Function | String

    初期化するウィジェットのコンストラクタまたは、実行するメソッド名。

  • [args] Anything optional multiple

    コンストラクタもしくはメソッドの引数。