diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/ChangeLog | 21 | ||||
-rw-r--r-- | doc/dev-conventions.txt | 34 |
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 |