Jmol.js Javascriptライブラリ　－　レベル１

レベル１

jmolInitialize　－　初期化

書式
jmolInitialize(Jmolフォルダ)
機能

Jmol.js JavaScriptライブラリを初期化します。 記述するのは<head>要素内でも<body>要素内でも構いませんが、Jmol.js の関数を呼び出して使用する前に jmolInitialize を呼び出す必要があります。 パラメータ"Jmolフォルダ"は、JmolApplet0.jarおよびその他のアプレットファイルがあるディレクトリ（Jmolフォルダー）を相対パスで指定します。

例
jmolInitialize("../jmol")

jmolApplet　－　Jmolアプレットの埋め込み（パネルの作成)

表示パネルを作成します。JSmolではアプレットを利用する訳ではありませんが、Jmolとの互換性を優先して、同じコマンド名を使用します。

書式
jmolApplet (パネルサイズ, 命令)
機能

パネルサイズ
表示するパネルの辺の長さを指定します。値を１つだけ指定すると正方形で、カンマで区切って２つの値を指定すると長方形で表示されます。長さの値はピクセル単位あるいはWebページのウィンドウまたはコンテナ要素の大きさに対する割合で指定することができます。指定方法と指定可能な値の範囲は次の通りです。

ピクセル：　単位なし、指定可能な値の範囲は25～2000。例：400,　[300, 500]
パーセント：　数値の直後の%を付け、値をダブルクォートで囲む。例："50%", ["90%", "60%"]
割合：　単位なし、指定可能な値の範囲は0～1。例： 0.5, [0.5, 1.0]

命令
２つ目の引数には、動作させるスクリプトを指定します。通常は、分子構造データを読み込んで表示させます。

例
jmolApplet (400, "load sample.mol")
jmolApplet ([300, 500], "load sample.pdb")

jmolButton　－　ボタンの設置

書式
jmolButton (命令, ラベル )
機能

ボタンをクリックすると命令が実行されます。

命令
一連のJmolスクリプト

ラベル
ボタンに表示されるテキスト

例
jmolButton ("spacefill on", "空間充填模型")

jmolLink　－　ハイパーリンクの設置

書式
jmolLink (命令, テキスト )
機能

テキストに設定されたリンクをクリックすると命令が実行されます。

例
jmolLink ("spacefill on", "空間充填模型")

jmolCheckbox　－　チェックボックスの設置

書式
jmolCheckbox (チェックされている時に実行する命令, チェックされていない時に実行する命令, テキスト [, フラッグ] )
機能

命令
チェックボックスがチェックされているか否かによって異なる命令を実行します。

テキスト
チェックボックスの後に表示されます。

フラッグ
ページが読み込まれた際にチェックされた状態にするには、False以外の値を指定します。デフォールトはuncheckedです。

例
jmolCheckbox ("spin on", "spin off", "回転")
jmolCheckbox ("set showHydrogens on", "set showHydrogens off", "水素", "checked")

jmolRadioGroup　－　グループ内でどれか１つを選択するラジオボタンの設置

書式
jmolRadioGroup (ラジオボタンの引数の配列,   [, HTMLでの区切り]  [, グループ名] )
機能

ラジオボタンの引数の配列
命令, テキスト [, フラッグ] からなる引数の配列

　命令
　該当するラジオボタンが選択された際に実行される命令を記述します。

　テキスト
　ラジオボタンの後に表示する文字列を指定します。

　フラッグ
　ページが読み込まれた際にチェックされた状態にするには、False以外の値を指定します。デフォールトはuncheckedです。

HTMLでの区切り
それぞれのラジオボタンの後に置かれるHTMLコードを指定します。改行して縦に並べる場合は、"<br>" を指定します。

例1
jmolRadioGroup ( [
    ["spacefill off", "Off"],
    ["spacefill 20%", "20%", "checked"],
    ["spacefill 100%", "100%"]
    ] )
例2
var x = new Array()
x[0] =   ["spacefill off", "Off"]
x[1] =   ["spacefill 20%", "20%", "checked"],
x[2] =   ["spacefill 100%", "100%"]
jmolRadioGroup (x, "<br>")

jmolMenu　－　プルダウンメニューの設置

書式
jmolMenu (引数の配列)
機能

引数の配列
命令, テキスト [, フラッグ] からなる引数の配列

　命令
　該当するメニューが選択された際に実行される命令を記述します。

　テキスト
　メニューに表示する文字列を指定します。

　フラッグ
　ページが読み込まれた際に選択された状態にするには、False以外の値を指定します。デフォールトはFalseです。

例1
jmolMenu ( [
    ["spacefill off", "Off"],
    ["spacefill 20%", "20%", "true"],
    ["spacefill 100%", "100%"]
    ] )
例2
var x = new Array()
x[0] =   ["spacefill off", "Off"]
x[1] =   ["spacefill 20%", "20%", "true"],
x[2] =   ["spacefill 100%", "100%"]
jmolMenu (x)

Return