GUI操作時に自動生成されるJavaScriptコードについて – Kaizen Platform ヘルプセンター

このページについて

このページでは、UI エディターでGUI操作を行った際に自動的に生成される JavaScript コードについて説明します。

自動評価 (Auto Eval) について

エディターのコンテキストメニューから行った動作は、JavaScriptコードに変換され自動で JavaScriptタブ内に書き込まれます
UI エディターが生成する jQuery コードの各行の先頭には以下の様なコメントが付きます。

/*!kz:autoeval*/

このコメントが付く行の jQuery コードは、該当の要素が現れると即時に評価されます。

これによって、描画の遅延を防ぐことができます。

該当ページの読み込み完了 (DOMContentLoaded) 時まで評価されずに残ったコードは、その時点でまとめて評価されます。

※ 自動評価対象の要素が存在していないと、それ以降の JavaScriptタブに記述された編集内容は実行を中断されます。複数ページを対象にデザイン作成する場合はご注意ください。

JavaScriptタブ内に自動生成される「:Eq(0)」の意味

GUIエディターで編集を行うと、エディター下部のJavaScriptタブにソースコードが自動生成されます。
その時に「div:eq(0)」や「p:eq(3)」のように記述されることがあります。
この「:eq(数字)」というのは、左の要素がソースコード上の何番目にあるかを指定するものになります。
数字は0が1番目となります。
下記に例題を記載します。

「div:eq(0)」の場合
div要素の1番目を指定しております。

「p:eq(2)」の場合
p要素の3番目を指定しております。

内包されている要素も数えます。
「div:eq(3)」の場合
内包されているdiv要素も含めた4番目のdiv要素を指定しております。

内包されてる要素を数えない記述もあります。
「body > div:eq(3)」の場合
内包されているdiv要素は除外した4番目のdiv要素を指定しております。

jQuery メソッド

エディター内で利用できる jQuery のバージョンは 1.10.2 です。
jQuery のメソッドに関してはこちらもご参照ください。

HTML を編集

以下のメソッドを用いて、設定された HTML の状態に、最短のコードで変更を加えます。

スタイルを編集

attr メソッドで style 属性を設定します。

attr(properties)

属性を編集

以下のメソッドを用いて、設定した属性に変更します。

attr(properties): 属性の追加・値の変更
removeAttr(name): 属性の削除

背景画像を設定

設定した画像の URL を用いて css({ "background-image": "画像の URL" }) の様な JavaScript コードを追加します。

css(properties)

jQuery コードの追加

任意の jQuery コードを追加できます。jQuery リファレンスを参照して下さい。

要素を削除

remove()

ドラッグして移動

以下の様なコードを用いて、親要素からの相対的な座標を設定します。

$("#element").css({"position":"relative","left":"150px","top":"69px"});

css(properties)

画像を挿入

append(content) メソッドを用いて、<img> タグを挿入します。

append(content)

HTML を挿入

before(content): 要素の前に HTML を挿入する。
insertBefore(content): 要素を指定した他の要素の前に挿入する。
after(content): 要素の後に HTML を追加する。
insertAfter(content): 要素を指定した他の要素の後に挿入する。
prepend(content): HTML を要素の先頭に挿入する。
append(content): HTML を要素の末尾に追加する。
wrap(html): HTML で要素を囲う。
wrapInner(html): 子要素を HTML で要素を囲う。
clone(): 要素のクローンを作成し、そのクローンを選択状態にする。

※注意点
エディターの仕様上「HTMLを挿入」から要素を追加した場合、「;(セミコロン)」をつけるとSyntax errorになる場合があります。
対処法は二つの方法があります。

ex. .after(“テスト”) でSyntax errorが出る

「;(セミコロン)」をエスケープする
.after("<a href=\"javascript:void(0)\;\">テスト</a>")
「;(セミコロン)」を削除する
.after("<a href=\"javascript:void(0)\">テスト</a>")