Simile Timeline einbinden: Unterschied zwischen den Versionen
Aus Contao Community Documentation
K (→Frontend-Modul anlegen) |
K (Korrektur) |
||
(4 dazwischenliegende Versionen von einem Benutzer werden nicht angezeigt) | |||
Zeile 4: | Zeile 4: | ||
|Version=ab 2.9 | |Version=ab 2.9 | ||
}} | }} | ||
− | Das Simile Timeline Widget ist eine JavaScript-basierte Komponente mit der Ereignisse auf einer (interaktiven) Zeitleiste angeordnet werden können. | + | Das ''Simile Timeline'' Widget ist eine JavaScript-basierte Komponente mit der Ereignisse auf einer (interaktiven) Zeitleiste angeordnet werden können. |
=Frontend-Modul anlegen= | =Frontend-Modul anlegen= | ||
− | Als erstes wird ein Platzhalter für die Zeitleiste benötigt | + | Als erstes wird ein Platzhalter für die Zeitleiste benötigt. Dazu legt man im aktuellen Theme ein neues Frontend-Modul mit dem Namen "Timeline" an und wählt als Modultyp "Eigener HTML-Code". |
<source lang="javascript"> | <source lang="javascript"> | ||
Zeile 22: | Zeile 22: | ||
<script src="http://static.simile.mit.edu/timeline/api-2.3.0/timeline-api.js?bundle=true" type="text/javascript"></script> | <script src="http://static.simile.mit.edu/timeline/api-2.3.0/timeline-api.js?bundle=true" type="text/javascript"></script> | ||
− | <script> | + | <script type="text/javascript"> |
var tl; | var tl; | ||
function onLoad() { | function onLoad() { | ||
Zeile 59: | Zeile 59: | ||
tl = Timeline.create(document.getElementById("tl"), bandInfos, Timeline.HORIZONTAL); | tl = Timeline.create(document.getElementById("tl"), bandInfos, Timeline.HORIZONTAL); | ||
// !! HIER DATEN LADEN !! | // !! HIER DATEN LADEN !! | ||
− | //tl.loadJSON(" | + | var mydata = "/timeline.json"; |
+ | //tl.loadJSON(mydata+"?ts="+ (new Date().getTime()), function(json, url) { eventSource.loadJSON(json, url); }); | ||
// !! HIER DATEN LADEN !! | // !! HIER DATEN LADEN !! | ||
} | } | ||
Zeile 77: | Zeile 78: | ||
=Daten laden= | =Daten laden= | ||
Um nun Ereignisse in die Zeitleiste zu bekommen kann man entweder die loadJSON-Zeile reaktivieren oder über ein weiteres HTML-Modul auf der jeweiligen Artikelseite einbinden. | Um nun Ereignisse in die Zeitleiste zu bekommen kann man entweder die loadJSON-Zeile reaktivieren oder über ein weiteres HTML-Modul auf der jeweiligen Artikelseite einbinden. | ||
+ | |||
+ | <source lang="javascript"> | ||
+ | <script type="text/javascript"> | ||
+ | //Hier tl eventuell durch eine Variable die einen Zeiger zu einer Timeline-Instanz hält ersetzen. | ||
+ | var mydata = "/timeline.json"; | ||
+ | //tl.loadJSON(mydata+"?ts="+ (new Date().getTime()), function(json, url) { eventSource.loadJSON(json, url); }); | ||
+ | </script> | ||
+ | </source> | ||
=Abschließendes= | =Abschließendes= | ||
− | Alternativ kann man das Frontend-Modul auch an anderen Stellen einbinden | + | Alternativ kann man das Frontend-Modul auch an anderen Stellen einbinden. Wichtig ist jedoch, das im jeweiligen Layout die entsprechenden Abhängigkeiten erfüllt sind! Besser wäre es auch das Timeline-DIV und das SCRIPT in ein einzelnes Modul zu verpacken, wobei die DIVs über unterschiedliche IDs angesprochen werden und somit auch mehrere Zeitleisten genutzt werden können. Eine genaue Anleitung (rund um das Widget) und Beschreibung der möglichen Datenformate (XML, JSON) findet sich unter http://www.simile-widgets.org/timeline/. |
--[[Benutzer:HowToMeetLadies|HowToMeetLadies]] 22:51, 27. Jun. 2011 (CEST) | --[[Benutzer:HowToMeetLadies|HowToMeetLadies]] 22:51, 27. Jun. 2011 (CEST) |
Aktuelle Version vom 5. Juli 2011, 20:17 Uhr
betrifft | |
---|---|
TYPOlight Version | ab 2.6 |
Contao Version | ab 2.9 |
Das Simile Timeline Widget ist eine JavaScript-basierte Komponente mit der Ereignisse auf einer (interaktiven) Zeitleiste angeordnet werden können.
Inhaltsverzeichnis
Frontend-Modul anlegen
Als erstes wird ein Platzhalter für die Zeitleiste benötigt. Dazu legt man im aktuellen Theme ein neues Frontend-Modul mit dem Namen "Timeline" an und wählt als Modultyp "Eigener HTML-Code".
<div id="tl" style="height: 300px; border: 1px solid #aaa"></div>
Layout anlegen
Nun kann ein Layout angelegt werden, was die benötigten JavaScript-Bibliotheken lädt und das Frontend-Modul einbindet.
Body onLoad: onLoad();
Zusätzliche <Head>-Tags:
<script src="http://static.simile.mit.edu/timeline/api-2.3.0/timeline-api.js?bundle=true" type="text/javascript"></script> <script type="text/javascript"> var tl; function onLoad() { var eventSource = new Timeline.DefaultEventSource(0); var theme = Timeline.ClassicTheme.create(); theme.event.bubble.width = 300; theme.event.bubble.height = 200; theme.mouseWheel = 'scroll'; var d = Timeline.DateTime.setIso8601Date(new Date(), "2011-06-27"); var bandInfos = [ Timeline.createBandInfo({ width: "80%", intervalUnit: Timeline.DateTime.DAY, intervalPixels: 100, eventSource: eventSource, date: d, theme: theme }), Timeline.createBandInfo({ width: "10%", intervalUnit: Timeline.DateTime.MONTH, intervalPixels: 150 }), Timeline.createBandInfo({ width: "10%", intervalUnit: Timeline.DateTime.YEAR, intervalPixels: 200 }) ]; bandInfos[1].syncWith = 0; bandInfos[1].highlight = true; bandInfos[2].syncWith = 1; bandInfos[2].highlight = true; tl = Timeline.create(document.getElementById("tl"), bandInfos, Timeline.HORIZONTAL); // !! HIER DATEN LADEN !! var mydata = "/timeline.json"; //tl.loadJSON(mydata+"?ts="+ (new Date().getTime()), function(json, url) { eventSource.loadJSON(json, url); }); // !! HIER DATEN LADEN !! } // bei bedarf var resizeTimerID = null; function onResize() { if (resizeTimerID == null) { resizeTimerID = window.setTimeout(function() { resizeTimerID = null; tl.layout(); }, 500); } } </script>
Daten laden
Um nun Ereignisse in die Zeitleiste zu bekommen kann man entweder die loadJSON-Zeile reaktivieren oder über ein weiteres HTML-Modul auf der jeweiligen Artikelseite einbinden.
<script type="text/javascript"> //Hier tl eventuell durch eine Variable die einen Zeiger zu einer Timeline-Instanz hält ersetzen. var mydata = "/timeline.json"; //tl.loadJSON(mydata+"?ts="+ (new Date().getTime()), function(json, url) { eventSource.loadJSON(json, url); }); </script>
Abschließendes
Alternativ kann man das Frontend-Modul auch an anderen Stellen einbinden. Wichtig ist jedoch, das im jeweiligen Layout die entsprechenden Abhängigkeiten erfüllt sind! Besser wäre es auch das Timeline-DIV und das SCRIPT in ein einzelnes Modul zu verpacken, wobei die DIVs über unterschiedliche IDs angesprochen werden und somit auch mehrere Zeitleisten genutzt werden können. Eine genaue Anleitung (rund um das Widget) und Beschreibung der möglichen Datenformate (XML, JSON) findet sich unter http://www.simile-widgets.org/timeline/.
--HowToMeetLadies 22:51, 27. Jun. 2011 (CEST)