スクリプティング

このページは印刷とpdf用の公式マニュアルの一部です。構造上の問題から通常のユーザーはこのページを編集できません。誤りを見つけた場合は私たちに連絡して下さい。ユーザーが編集できるバージョンへ

スクリプトとはコマンドの列であって，それらが順に実行されるようなものである。GeoGebraでは2種類のスクリプト言語をサポートしている。それはGGBScript と Javascriptである。スクリプトは以下の場合に実行(triggered)される：

特定の対象をクリックしたとき
特定の対象をアップデートした時（その対象の値やプロパティが変更されたとき）
ファイルを読み込んだ時（JavaScriptの場合）
Javascript のイベントリスナーが発動した時( リファレンス：JavaScript を参照のこと)

ユーザーは，オブジェクトのプロパティの中の「スクリプティング(Scripting)」というタブを通してスクリプトをセットすることができる。

GGBScript

GeoGebraコマンドから構成されるようなスクリプトを作ることができます。Inputバーに入力する方法と同じように使えます。スクリプトを実行する(triggering)と，（スクリプトの中のコマンドが）順番に一つ一つ実行されます。

例:

a を整数に値をとるスライダーで，１から３までの値をとるものとします。 (したがって1ずつ増やせるようになっています。)
list1 = {"red", "green", "blue"} とタイプしてください
'a のプロパティを開き，"On Update" スクリプトのところに SetColor(a, Element(list1, a)) とタイプしてください。
スライダーを動かすたびごとに色が変わります。

解説： スライダーが動かされるたびに，アップデート（のキュー）が発生します。ですから，動くたびごとに，スクリプトは呼び出され，リストの中から一つの色が呼び出されて，スライダー a の色が変更されます。

メモ: 文頭に # があるとコメント行になります

メモ: スクリプトでのみ使用できるコメントもあります。それらはスクリプティング　コマンドのページで見ることができます。

JavaScript

JavaScriptは多くのインターネット技術で用いられているプログラム言語である。GeoGebra スクリプトとは違って，JavaScriptではコマンドたちは一列に並んだ順に実行されなければいけないわけではなく，コントロールフロー (if, while, for) を用いることができる。一般的なJavaScriptについては， developer.mozilla.orgにわかりやすいチュートリアルがある。 . GeoGebraでは，作図を変更するような，特別なJavaScriptのメソッドを使用することができる。これらのメソッドはggbAppletという対象(object)に属しており， ggbApplet.method_name(parameter,..,parameter)という方法で呼び出すことができる。これらのメソッドのリストについてはリファレンス：JavaScriptを参照してほしい。

例:

for(var i =0;i<10;i++) 
   ggbApplet.evalCommand("A_"+i+"=(random()*10,random()*10)");

このスクリプトは，乱数によって座標が決められた，10個のA₀ から A₉という点を生成することができる。

メモ: JavaScript によるスクリプトはいろいろなことができるが，多くの作業はより単純なGeoGebraScriptを用いても実現可能である。

Global JavaScript

プロパティのスクリプティングタグにある「グローバルJavaScript」では，（変数ではなく）「関数」を定義することができ，ここで定義した関数は（同じファイル内の）他のスクリプトでも用いることができる。ggbOnInit()という関数を定義することができ，これは作図が読み込まれたときに自動的に一度実行される。このggbOnInit関数は以下にしめしたような，いくつかのイベントリスナーを登録するのに用いることができる。

例:

function onAdd(name){
    alert("Object "+name+" was added.");
}

function ggbOnInit(){
    ggbApplet.registerAddListener("onAdd");
}

まず，onAddという関数を定義してある。ここでは，引数の文字列に依存したメッセージを表示するようにしてある。そのあとで，ggbOnInit関数を用いて，GeoGebraに新しい対象物が定義されるたびにこの関数を呼び出すように設定している。一度作図をリロードすると，ggbOnInit関数が再度実行され，その後はたとえば点Aを追加したならば"Object A was added"というメッセージが表示されるだろう。

イベントリスナーは，名前の再定義，消去，クリアなどの動作に対して行うことができる。リファレンス：JavaScriptにすべてのリストが説明されている。

メモ: グローバルJavaScriptにおいてggbOnInitの外でggbAppletメソッドを用いると，意図したようには作動しない。というのは，これらは作図が読み込まれる前に実行されるメソッドだからだ。

スクリプティング

GeoGebra オブジェクト

GGBScript

JavaScript

Global JavaScript