summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog21
-rw-r--r--doc/dev-conventions.txt34
2 files changed, 45 insertions, 10 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index bd5cb7b..1eb4787 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,24 @@
+2007-07-12 Dieter Hametner <dh+vdr at gekrumbel dot de>
+
+ Changed the javascript base of live. We now use the 'mootools'
+ framework (see http://www.mootools.net for infos) to handle
+ javascript in a browser independend fashion and for nifty Web 2.0
+ features.
+
+ Based on this framework we have now tooltips that use the XHTML
+ standard 'title' attribute and Web-2.0 popup windows for epg
+ information. This Epg information is loaded on demand and once
+ loaded, they are cached in the page for further viewing.
+
+ On the other hand this also provides us with a solution to have
+ live functioning without javascript at all. When done right, the
+ same functionality can be achieved with or without enabled
+ javascript in the browser. Currently there still are javascript
+ only features, which will be resolved in the next weeks.
+
+ This is a rather big change on many files, so they are not all
+ mentioned here.
+
2007-06-22 Dieter Hametner <dh+vdr at gekrumbel dot de>
Start of new 'standalone' javascript source directory
diff --git a/doc/dev-conventions.txt b/doc/dev-conventions.txt
index 07d026d..2b80eab 100644
--- a/doc/dev-conventions.txt
+++ b/doc/dev-conventions.txt
@@ -18,16 +18,30 @@ Here WEB 2.0 features can improve the users experience.
With or without ECMAScript
--------------------------
-Since not all browsers support ECMAScript, we suggest the following
-rule to activate functionality with and without ECMAScript support:
-
-Use anchors analog to this example
-
- <a href="show_content.html?ref=additional_content_ref"
- onclick="makefalse(requestbox('additional_content_ref'));">link</a>
-
-to retrieve and display extra information either in a WEB 2.0 fashion
-in an popup box or on a separte page in a html fashion.
+Since not all browsers support ECMAScript, we need to make sure all
+functions live wants to provide need to be accessible through links.
+
+With the mootools framework and its selection functions we can enhance
+the user experience through ECMAScript by selecting the relevant
+elements in the DOM and attaching event handlers from the loaded
+script files. Thus when the user disables ECMAScript in his browser
+(or the browser does not support it) the traditional web technique of
+jumping between pages provides the functions. With enabled ECMAScript
+the event handlers can take over and provide a nifty Web 2.0 technique
+solution to the user.
+
+To enable a tooltip just add a 'title' attribute on the element and
+load 'hinttips.js' in your pages (Actually this will be allready done
+for you if you use the live page-framework).
+
+For popup windows that asynchronously load its contents you need to
+use normal links like <a href="epginfo.html?eventid=evnt_identifier">
+your link text here </a>. If 'infowin.js' is loaded it will enhance
+these links with AJAX functionality. If not the link will change to a
+new page with the requested information.
+
+This means that both users with and without ECMAScript support will
+benefit from the functions in live.
Themeing