タグの共通仕様
機能説明
imartタグの共通事項について記述します。
id, name
- id name 属性およびそれに属する属性値は、値を指定した場合と省略した場合以下のように動作します。
| 未指定時 | 指定時 | |
| id | imui タグにより、id 属性が自動的に付与されます | 利用可能な文字列であるかどうかのチェックが実施され、違反時にはタグは何も出力しません |
| name | imui タグにより、name 属性が自動的に付与されます |
利用可能な文字列は以下になります。
- a-zA-Z0-9-_ のみが使用されていること
- 先頭の文字が a-zA-Z で始まること
- 利用可能な文字を変更しました。以下の文字の指定が可能です。
- a-zA-Z0-9!$%&()*+,-./:=?@[\]^_`{|}~
- 先頭に指定できる文字は、指定可能文字であればどの文字でも指定が可能です。
boolean
- 真偽値をとる属性は、以下のように出力されます。
- 属性が有効になる場合は、disabled="disabled"のように出力されます。
| 有効・無効 | 入力 | 出力 | |
| 属性のみ | 有効 | <imart type="imuiTextbox" disabled /> | <input type="text" disabled="disabled" /> |
| trueを指定 | 有効 | <imart type="imuiTextbox" disabled="true" /> | <input type="text" disabled="disabled" /> |
| falseを指定 | 無効 | <imart type="imuiTextbox" disabled="false" /> | <input type="text" /> |
| bind変数でtrueを指定 | 有効 | <imart type="imuiTextbox" disabled=$true /> | <input type="text" disabled="disabled" /> |
| bind変数でfalseを指定 | 無効 | <imart type="imuiTextbox" disabled=$false /> | <input type="text" /> |
| 空文字を指定 | 有効 | <imart type="imuiTextbox" disabled="" /> | <input type="text" disabled="disabled" /> |
| キーと同じ値を指定 | 有効 | <imart type="imuiTextbox" disabled="disabled" /> | <input type="text" disabled="disabled" /> |
| その他の値を指定 | 有効 | <imart type="imuiTextbox" disabled="sample" /> | <input type="text" disabled="disabled" /> |
国際化対応属性
- 国際化対応をしている属性は値に
"%メッセージID"を設定することでユーザロケールに応じたメッセージを表示させることができます。
無害化対応属性
- 無害化対応をしている属性は値がエスケープされて表示されます。
HTML5属性
- html5に対応したブラウザでのみ動作する属性です。
クライアントサイドJavaScriptイベントを扱う属性
- クライアントサイドJavaScriptイベントを扱う属性は、下記の文字列が使用できます。
- ただし、JavaScriptの予約語を使用することはできません。
- 英数字
- $
- _
- .(連続して使うことはできません)
タグの記述
- imartタグを記述する場合は、大文字小文字が区別されます。
- タグで定義されている属性名の通りの記述でない場合はユーザ定義の属性として解釈されます。
Ajaxの共通仕様
機能説明
Ajax関連メソッドの呼び出しについて記述します。
Ajax関連メソッドの処理の流れ
onAjaxParameterExtendに指定したメソッドについて
- 通信が発生する直前に呼び出されます。指定されている場合は一番最初に呼び出されます。
- 非同期通信のパラメータの拡張が行えます。
- 戻り値に指定した値がextensionプロパティに代入されます。
- 引数
- サーバに送信されるパラメータ または UIオブジェクト(詳細リスト、ガジェット)
- 戻り値
- パラメータのextensionプロパティに代入する値
onAjaxBeforeSendに指定したメソッドについて
- 通信が発生する直前に呼び出されます。
- falseを返却することで通信をキャンセルすることが出来ます。
- 引数
- 戻り値
- falseを返却することで通信をキャンセルします。
| 引数 | 値 |
| 第１引数 | XMLHTTPRequest |
| 第２引数 | jQueryのajaxオプション |
onAjaxSuccessに指定したメソッドについて
- 通信が成功した場合に呼び出されます。
- 引数
- 戻り値
- 受け付けません。
| 引数 | 値 |
| 第１引数 | 通信で受け取ったデータ |
| 第２引数 | 通信の状態を表したメッセージ |
| 第３引数 | XMLHTTPRequest |
onAjaxErrorに指定したメソッドについて
- 通信でエラーが発生した場合に呼び出されます。
- 通信エラー
- サーバエラー
- 引数
- 戻り値
- 受け付けません。
| 引数 | 値 |
| 第１引数 | XMLHTTPRequest |
| 第２引数 | 通信の状態を表したメッセージ |
| 第３引数 | 例外オブジェクト |
onAjaxCompleteに指定したメソッドについて
- 通信が終了した場合に呼び出されます。
- エラーであっても呼び出されます。
- 引数
- 戻り値
- 受け付けません。
| 引数 | 値 |
| 第１引数 | XMLHTTPRequest |
| 第２引数 | 通信の状態を表したメッセージ |