Skripting: Unterschied zwischen den Versionen

Aus GeoGebra Manual
Wechseln zu: Navigation, Suche
K (Textersetzung - „version=4.0“ durch „version=4.2“)
(removed chapter about USB logger)
 
Zeile 1: Zeile 1:
<noinclude>{{Manual Page|version=4.2}}</noinclude>{{objects|property}}
+
<noinclude>{{Manual Page|version=5.0}}</noinclude>{{objects|property}}
Skripte sind eine Abfolge von Befehlen, die nacheinander ausgeführt werden. GeoGebra bietet zwei Möglichkeiten die Befehle anzugegeben -- GGBScript und JavaScript (zwei Skriptsprachen). Die Ausführung eines Skriptes kann ausgelöst werden durch:
+
Skripte sind eine Abfolge von Befehlen, die nacheinander ausgeführt werden. GeoGebra bietet zwei Skriptsprachen um Befehle anzugegeben - GGBScript und JavaScript . Die Ausführung eines Skriptes kann ausgelöst werden durch:
* Klicken oder Aktualisierung (''Wert-Veränderung, Neudefinition'') eines bestimmten Objektes
+
* Klicken auf ein bestimmtes Objekt
 +
* Aktualisierung (''Wert-Veränderung, Neudefinition'') eines bestimmten Objektes
 
* Laden der Datei (im Fall von JavaScript)
 
* Laden der Datei (im Fall von JavaScript)
 
* Javascript Listeners (siehe auch [http://wiki.geogebra.org/en/Reference:JavaScript JavaScript])
 
* Javascript Listeners (siehe auch [http://wiki.geogebra.org/en/Reference:JavaScript JavaScript])
  
Die Skripte werden im Kartenreiter "Skripting" im [[Eigenschaften-Dialog]] eines Objektes eingegeben.
+
Die Skripte werden im Tab "Skripting" im [[File:Menu-options.svg|link=|16px]] [[Eigenschaften-Dialog]] eines Objektes eingegeben.
  
Sie können die Skript-Funktion mithilfe des allgemeinen [[Einstellungs-Dialog]] einschalten, was allerdings normalerweise am Anfang nicht notwendig ist. Gehen Sie dazu auf den Kartenreiter ''Erweitert'' und setzten Sie ein Häkchen bei ''Ermögliche Skripting''.
 
 
==Beispiele für Skripte==
 
 
===GGBScript===  
 
===GGBScript===  
Sie können Skripte erzeugen, die einfach nur eine Auflistung von GeoGebra-Befehlen enthalten, wie man sie auch in der Eingabezeile eingeben kann. Beim Aufruf des Skriptes, werden die Befehle hintereinander ausgeführt.
+
Sie können Skripte erzeugen, die einfach nur eine Auflistung von GeoGebra-Befehlen enthalten, wie man sie auch in der [[Eingabezeile]] eingeben kann. Beim Aufruf des Skriptes, werden die Befehle hintereinander ausgeführt.
 
{{Example|1=<div>
 
{{Example|1=<div>
* ''a'' ist ein [[Schieberegler_(Werkzeug)|Schieberegler]] von 1 bis 3, der nur ganzzahlige Werte zulässt
+
* ''a'' ist ein [[Schieberegler_(Werkzeug)|Schieberegler]] von 1 bis 3, der nur ganzzahlige Werte zulässt (d.h. die Schrittweite beträgt 1)
* <code><nowiki>liste1 = {"rot", "grün", "blau"}</nowiki></code>
+
* Geben Sie <code><nowiki>Liste1 = {"rot", "grün", "blau"}</nowiki></code> ein.
* in den Eigenschaften von ''a'' tragen Sie als Skript im Tab "Bei Update" ein  
+
* Gn den Eigenschaften von ''a'' tragen Sie als Skript im Tab "Bei Update" ein: <code>SetzeFarbe[a, Element[Liste1, a]]</code>
::<code>SetzeFarbe[a, Element[liste1, a]]</code>
 
 
* Wenn Sie nun den Schieberegler bewegen ändert er seine Farbe</div>}}
 
* Wenn Sie nun den Schieberegler bewegen ändert er seine Farbe</div>}}
  
'''Erklärung:''' Jedes Mal wenn der Schieberegler bewegt wird findet ein "Update" statt. Dann wird auch jedes Mal das Skript aufgerufen, was dann den Wert vom Schieberegler a nutzt, um die Farbe aus der Liste auszulesen und die Farbe von a zu ändern.
+
'''Erklärung:''' Jedes Mal wenn der Schieberegler bewegt wird findet ein "Update" statt. Dann wird auch jedes Mal das Skript aufgerufen, was dann den Wert vom Schieberegler ''a'' nutzt, um die Farbe aus der Liste auszulesen und die Farbe von ''a'' zu ändern.
  
 
{{note|Es gibt einige Befehle, die speziell für das Skripting gedacht sind. Sie finden diese auf der Seite [[Skripting_(Befehle)]]}}
 
{{note|Es gibt einige Befehle, die speziell für das Skripting gedacht sind. Sie finden diese auf der Seite [[Skripting_(Befehle)]]}}
Zeile 37: Zeile 34:
 
}}
 
}}
  
{{Note|Das Skripting mit JavaScript ist aufgrund der Kontrollstrukturen sehr viel mächtiger. Allerdings lassen sich viele Aufgaben mit dem einfacheren GeoGebraScript bewältigen.}}  
+
{{Note|Das Skripting mit JavaScript ist aufgrund der Kontrollstrukturen sehr vielseitig einsetzbar. Allerdings lassen sich viele Aufgaben mit dem einfacheren GeoGebraScript bewältigen.}}  
  
 
GeoGebra beinhaltet seine eigene JavaScript-Engine. Wenn Sie [[Export-Dialog für Arbeitsblätter|dynamische Arbeitsblätter]] exportieren, können Sie zwischen dieser Engine oder derjenigen, die im Browser verwendet wird, auswählen. Wenn Sie JavaScript auf einer HTML Seite bearbeiten, so wird die ggbApplet-Variable nicht initialisiert. Sie müssen zuerst <code>ggbApplet=document.applets[0];</code> eingeben, um das ggbApplet korrekt verwenden zu können.
 
GeoGebra beinhaltet seine eigene JavaScript-Engine. Wenn Sie [[Export-Dialog für Arbeitsblätter|dynamische Arbeitsblätter]] exportieren, können Sie zwischen dieser Engine oder derjenigen, die im Browser verwendet wird, auswählen. Wenn Sie JavaScript auf einer HTML Seite bearbeiten, so wird die ggbApplet-Variable nicht initialisiert. Sie müssen zuerst <code>ggbApplet=document.applets[0];</code> eingeben, um das ggbApplet korrekt verwenden zu können.
  
 
===Global JavaScript===
 
===Global JavaScript===
Im ''Global JavaScript'' Teil des ''Skripting'' Kartenreiters im [[Eigenschaften-Dialog]] können auch Funktionen oder Anweisungen definiert werden, die vor dem Laden der Konstruktion ausgeführt werden. Sie können auch Funktionen wie ''ggbOnInit()'' eingeben, welche automatisch ausgerufen werden, sobald Ihre Konstruktion geladen wird. Die Funktion ''ggbOnInit()'' kann auch für ''Listeners'' benutzt werden, wie das folgende Beispiel zeigt:
+
Im ''Global JavaScript'' Teil des Tabs ''Skripting'' im [[File:Menu-options.svg|link=|16px]] ''Eigenschaften-Dialog'' können auch '''Funktionen''' oder '''Anweisungen''' definiert werden, die vor dem Laden der Konstruktion ausgeführt werden und auch für andere Skripts verfügbar sind. Sie können auch Funktionen wie ''ggbOnInit()'' eingeben, welche automatisch ausgerufen werden, sobald Ihre Konstruktion geladen wird. Die Funktion ''ggbOnInit()'' kann auch für ''Listeners'' benutzt werden, wie das folgende Beispiel zeigt:
 
{{example|1=
 
{{example|1=
 
<pre>
 
<pre>
Zeile 57: Zeile 54:
  
 
Sie können ''Listeners'' aber auch benutzen um Objekte umzubenennen, zu löschen oder Konstruktionen zu löschen. Eine komplette Auflistung finden Sie unter [http://wiki.geogebra.org/en/Reference:JavaScript JavaScript].
 
Sie können ''Listeners'' aber auch benutzen um Objekte umzubenennen, zu löschen oder Konstruktionen zu löschen. Eine komplette Auflistung finden Sie unter [http://wiki.geogebra.org/en/Reference:JavaScript JavaScript].
{{Note|Wird eine ggbApplet-Methode in ''Global JavaScript'' außerhalb von ''ggbOnInit'' benutzt, so funktioniert diese Methode erst richtig, wenn sie aufgerufen wird bevor die Konstruktion geladen wird.}}
+
{{Note|Die Verwendung einer ggbApplet-Methode in ''Global JavaScript'' außerhalb von ''ggbOnInit'' wird eventuell nicht wie geplant funktionieren, da die Methode vor der Konstruktion geladen wird.}}
 
 
===USB Datenerfassung===
 
Für Datenerfassung von Vernier USB Data Loggers, z. B. ''Go!Motion'' und ''Go!Temp'' können Sie einen Logger-Listener definieren, indem Sie die Methode ''registerLoggerListener'' verwenden. So ein Listener kann folgendermaßen aussehen:
 
<pre>
 
function logger(value) {
 
  var d = value * 1;
 
  ggbApplet.evalCommand("(CopyFreeObject[a],"+d+")");
 
  ggbApplet.evalCommand("SetValue[a,a+1]");
 
}
 
</pre>
 
Dieses Skript nimmt an, dass es eine freie Zahl ''a'' in der Konstruktion gibt. Jedes mal, wenn ''d'' erfasst wird, wird der Punkt ''(a,d)'' konstruiert und ''a'' wird erhöht.
 

Aktuelle Version vom 30. Oktober 2015, 17:27 Uhr


Skripte sind eine Abfolge von Befehlen, die nacheinander ausgeführt werden. GeoGebra bietet zwei Skriptsprachen um Befehle anzugegeben - GGBScript und JavaScript . Die Ausführung eines Skriptes kann ausgelöst werden durch:

  • Klicken auf ein bestimmtes Objekt
  • Aktualisierung (Wert-Veränderung, Neudefinition) eines bestimmten Objektes
  • Laden der Datei (im Fall von JavaScript)
  • Javascript Listeners (siehe auch JavaScript)

Die Skripte werden im Tab "Skripting" im Menu-options.svg Eigenschaften-Dialog eines Objektes eingegeben.

GGBScript

Sie können Skripte erzeugen, die einfach nur eine Auflistung von GeoGebra-Befehlen enthalten, wie man sie auch in der Eingabezeile eingeben kann. Beim Aufruf des Skriptes, werden die Befehle hintereinander ausgeführt.

Beispiel:
  • a ist ein Schieberegler von 1 bis 3, der nur ganzzahlige Werte zulässt (d.h. die Schrittweite beträgt 1)
  • Geben Sie Liste1 = {"rot", "grün", "blau"} ein.
  • Gn den Eigenschaften von a tragen Sie als Skript im Tab "Bei Update" ein: SetzeFarbe[a, Element[Liste1, a]]
  • Wenn Sie nun den Schieberegler bewegen ändert er seine Farbe

Erklärung: Jedes Mal wenn der Schieberegler bewegt wird findet ein "Update" statt. Dann wird auch jedes Mal das Skript aufgerufen, was dann den Wert vom Schieberegler a nutzt, um die Farbe aus der Liste auszulesen und die Farbe von a zu ändern.

Anmerkung: Es gibt einige Befehle, die speziell für das Skripting gedacht sind. Sie finden diese auf der Seite Skripting_(Befehle)

JavaScript

JavaScript ist eine Programmiersprache, die vor allem im Internet eingesetzt wird. Im Gegensatz zu GeoGebraScript können Sie damit Befehle nicht nur einfach hintereinander ausführen lassen, sondern es können auch Kontrollstrukturen wie if, while und for verwendet werden. Sie finden eine gute Anleitung zur Verwendung von JavaScript auf developer.mozilla.org.

Im Falle von GeoGebra müssen Sie spezielle JavaScript-Methoden benutzen, um die Konstruktion zu verändern. Diese Methoden gehören zu dem ggbApplet-Objekt, was bedeutet, dass sie Befehle der Art ggbApplet.method_name(parameter,..,parameter) aufrufen müssen. Die vollständige Liste der Methoden finden Sie unter JavaScript.

Beispiel:
for(var i =0;i<10;i++) 
   ggbApplet.evalCommand("A_"+i+"=(random()*10,random()*10)");
Dieses Skript erzeugt 10 Punkte von A0 bis A9 mit zufälligen Koordinaten.
Anmerkung: Das Skripting mit JavaScript ist aufgrund der Kontrollstrukturen sehr vielseitig einsetzbar. Allerdings lassen sich viele Aufgaben mit dem einfacheren GeoGebraScript bewältigen.

GeoGebra beinhaltet seine eigene JavaScript-Engine. Wenn Sie dynamische Arbeitsblätter exportieren, können Sie zwischen dieser Engine oder derjenigen, die im Browser verwendet wird, auswählen. Wenn Sie JavaScript auf einer HTML Seite bearbeiten, so wird die ggbApplet-Variable nicht initialisiert. Sie müssen zuerst ggbApplet=document.applets[0]; eingeben, um das ggbApplet korrekt verwenden zu können.

Global JavaScript

Im Global JavaScript Teil des Tabs Skripting im Menu-options.svg Eigenschaften-Dialog können auch Funktionen oder Anweisungen definiert werden, die vor dem Laden der Konstruktion ausgeführt werden und auch für andere Skripts verfügbar sind. Sie können auch Funktionen wie ggbOnInit() eingeben, welche automatisch ausgerufen werden, sobald Ihre Konstruktion geladen wird. Die Funktion ggbOnInit() kann auch für Listeners benutzt werden, wie das folgende Beispiel zeigt:

Beispiel:
function onAdd(name){
    alert("Objekt "+name+" wurde hinzugefügt.");
}

function ggbOnInit(){
    ggbApplet.registerAddListener("onAdd");
}
Erklärung: Zuerst haben wir die Funktion onAdd definiert, die eine Nachricht zeigt, die vom gegebenen String abhängt. Danach legen wir fest, dass GeoGebra die Funktion ggbOnInit aufruft, sobald ein neues Objekt hinzugefügt wird. Wird unsere Konstruktion neu geladen, so wird die Funktion ggbOnInit aufgerufen. Ab diesem Zeitpunkt wird, wenn der Benutzer einen Punkt A hinzufügt, die Nachricht "Objekt A wurde hinzugefügt" angezeigt.

Sie können Listeners aber auch benutzen um Objekte umzubenennen, zu löschen oder Konstruktionen zu löschen. Eine komplette Auflistung finden Sie unter JavaScript.

Anmerkung: Die Verwendung einer ggbApplet-Methode in Global JavaScript außerhalb von ggbOnInit wird eventuell nicht wie geplant funktionieren, da die Methode vor der Konstruktion geladen wird.

Kommentare

Ausführliche Anleitungen[Bearbeiten]

Spezielle Anwendungen[Bearbeiten]

Skripting mit Kontrollkästchen verwenden[Bearbeiten]

Mit Skripting kann man die Möglichkeiten der Kontrollkästchen erweitern. Beispiele und eine Anleitung finden Sie auf der Seite zum Kontrollkästchen.

Zufallszahlen mit Skripten verwenden[Bearbeiten]

Bei der Verwendung von Skripten und Zufallszahlen gilt es eine Grundregel bzgl. der Zufallszahlen zu beachten:

Sobald ein Objekt neu berechnet wird, in dessen Definition eine Zufallszahl vorkommt, wird auch die Zufallszahl neu berechnet.
Beispiel: Hat man eine Zahl definiert durch z=Zufallszahl[1,2]*a, wobei a ein Schieberegler ist, dann wird z auch dann neu berechnet, inklusive neuer Zufallszahl, wenn man den Wert des Schiebereglers verändert.

Man muss deshalb beim Erstellen einer Zeichnung darauf achten, dass das Objekt, das die Zufallszahl enthält, nicht neudefiniert wird, wenn man die "alte" Zufallszahl behalten will. Das ist zum Beispiel dann der Fall, wenn man per Zufall Aufgaben erstellen und sie dann automatisch kontrollieren lassen will.

Mögliche Lösungen:

  1. Man sichert das gesuchte Ergebnis in einer Variable, die nicht mehr von einer Zufallszahl abhängig ist. Dazu nutzt man den Befehl KopiereFreiesObjekt und merkt sich so das Ergebnis, auch wenn sich die Zufallszahl ändert.
  2. Man verwendet gleich KopiereFreiesObjekt , um das Objekt vor einer Neuberechnung zu bewahren.


© 2024 International GeoGebra Institute