Merge branch 'MAINT_3_4_1' into QA_3_4
[phpmyadmin/ammaryasirr.git] / js / common.js
blobb3e996c022d7f6d6bd34c0d4c421c6b5b0479f5b
1 /* vim: set expandtab sw=4 ts=4 sts=4: */
2 /**
3  * common functions used for communicating between main, navigation and querywindow
4  *
5  */
7 /**
8  * holds the browser query window
9  */
10 var querywindow = '';
12 /**
13  * holds the query to be load from a new query window
14  */
15 var query_to_load = '';
17 /**
18  * attach a function to object event
19  *
20  * <code>
21  * addEvent(window, 'load', PMA_initPage);
22  * </code>
23  * @param object or id
24  * @param string event type (load, mouseover, focus, ...)
25  * @param function to be attached
26  */
27 function addEvent(obj, type, fn)
29     if (obj.attachEvent) {
30         obj['e' + type + fn] = fn;
31         obj[type + fn] = function() {obj['e' + type + fn](window.event);}
32         obj.attachEvent('on' + type, obj[type + fn]);
33     } else {
34         obj.addEventListener(type, fn, false);
35     }
38 /**
39  * detach/remove a function from an object event
40  *
41  * @param object or id
42  * @param event type (load, mouseover, focus, ...)
43  * @param function naem of function to be attached
44  */
45 function removeEvent(obj, type, fn)
47     if (obj.detachEvent) {
48         obj.detachEvent('on' + type, obj[type + fn]);
49         obj[type + fn] = null;
50     } else {
51         obj.removeEventListener(type, fn, false);
52     }
55 /**
56  * get DOM elements by html class
57  *
58  * @param string class_name - name of class
59  * @param node node - search only sub nodes of this node (optional)
60  * @param string tag - search only these tags (optional)
61  */
62 function getElementsByClassName(class_name, node, tag)
64     var classElements = new Array();
66     if (node == null) {
67         node = document;
68     }
69     if (tag == null) {
70         tag = '*';
71     }
73     var j = 0, teststr;
74     var els = node.getElementsByTagName(tag);
75     var elsLen = els.length;
77     for (i = 0; i < elsLen; i++) {
78         if (els[i].className.indexOf(class_name) != -1) {
79             teststr = "," + els[i].className.split(" ").join(",") + ",";
80             if (teststr.indexOf("," + class_name + ",") != -1) {
81                 classElements[j] = els[i];
82                 j++;
83             }
84         }
85     }
86     return classElements;
89 /**
90  * sets current selected db
91  *
92  * @param    string    db name
93  */
94 function setDb(new_db) {
95     //alert('setDb(' + new_db + ')');
96     if (new_db != db) {
97         // db has changed
98         //alert( new_db + '(' + new_db.length + ') : ' + db );
100         var old_db = db;
101         db = new_db;
103         // the db name as an id exists only when LeftFrameLight is false
104         if (window.frame_navigation.document.getElementById(db) == null) {
105             // happens when LeftFrameLight is true
106             // db is unknown, reload complete left frame
107             refreshNavigation();
108         } else {
109             // happens when LeftFrameLight is false
110             unmarkDbTable(old_db);
111             markDbTable(db);
112         }
114         // TODO: add code to expand db in lightview mode
116         // refresh querywindow
117         refreshQuerywindow();
118     }
122  * sets current selected table (called from navigation.php)
124  * @param    string    table name
125  */
126 function setTable(new_table) {
127     //alert('setTable(' + new_table + ')');
128     if (new_table != table) {
129         // table has changed
130         //alert( new_table + '(' + new_table.length + ') : ' + table );
132         table = new_table;
134         if (window.frame_navigation.document.getElementById(db + '.' + table) == null
135          && table != '') {
136             // table is unknown, reload complete left frame
137             refreshNavigation();
139         }
140         // TODO: add code to expand table in lightview mode
142         // refresh querywindow
143         refreshQuerywindow();
144     }
148  * reloads main frame
150  * @uses     goTo()
151  * @uses     opendb_url
152  * @uses     token
153  * @uses     db
154  * @uses     server
155  * @uses     table
156  * @uses     lang
157  * @uses    collation_connection
158  * @uses    encodeURIComponent()
159  * @param    string    url    name of page to be loaded
160  */
161 function refreshMain(url) {
162     if (! url) {
163         if (db) {
164             url = opendb_url;
165         } else {
166             url = 'main.php';
167         }
168     }
169     //alert(db);
170     goTo(url + '?server=' + encodeURIComponent(server) +
171         '&token=' + encodeURIComponent(token) +
172         '&db=' + encodeURIComponent(db) +
173         '&table=' + encodeURIComponent(table) +
174         '&lang=' + encodeURIComponent(lang) +
175         '&collation_connection=' + encodeURIComponent(collation_connection),
176         'main');
180  * reloads navigation frame
182  * @uses     goTo()
183  * @uses     token
184  * @uses     db
185  * @uses     server
186  * @uses     table
187  * @uses     lang
188  * @uses    collation_connection
189  * @uses    encodeURIComponent()
190  * @param    boolean    force   force reloading 
191  */
192 function refreshNavigation(force) {
193     // The goTo() function won't refresh in case the target
194     // url is the same as the url given as parameter, but sometimes
195     // we want to refresh anyway. 
196     if (typeof force != undefined && force && window.parent && window.parent.frame_navigation) {
197         window.parent.frame_navigation.location.reload();
198     } else {
199         goTo('navigation.php?server=' + encodeURIComponent(server) +
200             '&token=' + encodeURIComponent(token)  +
201             '&db=' + encodeURIComponent(db)  +
202             '&table=' + encodeURIComponent(table) +
203             '&lang=' + encodeURIComponent(lang) +
204             '&collation_connection=' + encodeURIComponent(collation_connection)
205             );
206     }
209 function unmarkDbTable(db, table)
211     var element_reference = window.frame_navigation.document.getElementById(db);
212     if (element_reference != null) {
213         $(element_reference).parent().removeClass('marked');
214     }
216     element_reference = window.frame_navigation.document.getElementById(db + '.' + table);
217     if (element_reference != null) {
218         $(element_reference).parent().removeClass('marked');
219     }
222 function markDbTable(db, table)
224     var element_reference = window.frame_navigation.document.getElementById(db);
225     if (element_reference != null) {
226         $(element_reference).parent().addClass('marked');
227         // scrolldown
228         element_reference.focus();
229         // opera marks the text, we dont want this ...
230         element_reference.blur();
231     }
233     element_reference = window.frame_navigation.document.getElementById(db + '.' + table);
234     if (element_reference != null) {
235         $(element_reference).parent().addClass('marked');
236         // scrolldown
237         element_reference.focus();
238         // opera marks the text, we dont want this ...
239         element_reference.blur();
240     }
242     // return to main frame ...
243     window.frame_content.focus();
247  * sets current selected server, table and db (called from libraries/footer.inc.php)
248  */
249 function setAll( new_lang, new_collation_connection, new_server, new_db, new_table, new_token ) {
250     //alert('setAll( ' + new_lang + ', ' + new_collation_connection + ', ' + new_server + ', ' + new_db + ', ' + new_table + ', ' + new_token + ' )');
251     if (new_server != server || new_lang != lang
252       || new_collation_connection != collation_connection) {
253         // something important has changed
254         server = new_server;
255         db     = new_db;
256         table  = new_table;
257         collation_connection  = new_collation_connection;
258         lang  = new_lang;
259         token  = new_token;
260         refreshNavigation();
261     } else if (new_db != db || new_table != table) {
262         // save new db and table
263         var old_db    = db;
264         var old_table = table;
265         db        = new_db;
266         table     = new_table;
268         if (window.frame_navigation.document.getElementById(db) == null
269           && window.frame_navigation.document.getElementById(db + '.' + table) == null ) {
270             // table or db is unknown, reload complete left frame
271             refreshNavigation();
272         } else {
273             unmarkDbTable(old_db, old_table);
274             markDbTable(db, table);
275         }
277         // TODO: add code to expand db in lightview mode
279         // refresh querywindow
280         refreshQuerywindow();
281     }
284 function reload_querywindow(db, table, sql_query)
286     if ( ! querywindow.closed && querywindow.location ) {
287         if ( ! querywindow.document.sqlform.LockFromUpdate
288           || ! querywindow.document.sqlform.LockFromUpdate.checked ) {
289             querywindow.document.getElementById('hiddenqueryform').db.value = db;
290             querywindow.document.getElementById('hiddenqueryform').table.value = table;
292             if (sql_query) {
293                 querywindow.document.getElementById('hiddenqueryform').sql_query.value = sql_query;
294             }
296             querywindow.document.getElementById('hiddenqueryform').submit();
297         }
298     }
302  * brings query window to front and inserts query to be edited
303  */
304 function focus_querywindow(sql_query)
306     /* if ( querywindow && !querywindow.closed && querywindow.location) { */
307     if ( !querywindow || querywindow.closed || !querywindow.location) {
308         // we need first to open the window and cannot pass the query with it
309         // as we dont know if the query exceeds max url length
310         /* url = 'querywindow.php?' + common_query + '&db=' + db + '&table=' + table + '&sql_query=SELECT * FROM'; */
311         query_to_load = sql_query;
312         open_querywindow();
313         insertQuery(0);
314     } else {
315         //var querywindow = querywindow;
316         if ( querywindow.document.getElementById('hiddenqueryform').querydisplay_tab != 'sql' ) {
317             querywindow.document.getElementById('hiddenqueryform').querydisplay_tab.value = "sql";
318             querywindow.document.getElementById('hiddenqueryform').sql_query.value = sql_query;
319             querywindow.document.getElementById('hiddenqueryform').submit();
320             querywindow.focus();
321         } else {
322             querywindow.focus();
323         }
324     }
325     return true;
329  * inserts query string into query window textarea
330  * called from script tag in querywindow
331  */
332 function insertQuery() {
333     if (query_to_load != '' && querywindow.document && querywindow.document.getElementById && querywindow.document.getElementById('sqlquery')) {
334         querywindow.document.getElementById('sqlquery').value = query_to_load;
335         query_to_load = '';
336         return true;
337     }
338     return false;
341 function open_querywindow( url ) {
342     if ( ! url ) {
343         url = 'querywindow.php?' + common_query + '&db=' + encodeURIComponent(db) + '&table=' + encodeURIComponent(table);
344     }
346     if (!querywindow.closed && querywindow.location) {
347         goTo( url, 'query' );
348         querywindow.focus();
349     } else {
350         querywindow = window.open( url + '&init=1', '',
351             'toolbar=0,location=0,directories=0,status=1,menubar=0,' +
352             'scrollbars=yes,resizable=yes,' +
353             'width=' + querywindow_width + ',' +
354             'height=' + querywindow_height );
355     }
357     if ( ! querywindow.opener ) {
358        querywindow.opener = window.window;
359     }
361     if ( window.focus ) {
362         querywindow.focus();
363     }
365     return true;
368 function refreshQuerywindow( url ) {
370     if ( ! querywindow.closed && querywindow.location ) {
371         if ( ! querywindow.document.sqlform.LockFromUpdate
372           || ! querywindow.document.sqlform.LockFromUpdate.checked ) {
373             open_querywindow( url )
374         }
375     }
379  * opens new url in target frame, with default being left frame
380  * valid is 'main' and 'querywindow' all others leads to 'left'
382  * @param    string    targeturl    new url to load
383  * @param    string    target       frame where to load the new url
384  */
385 function goTo(targeturl, target) {
386     //alert(targeturl);
387     if ( target == 'main' ) {
388         target = window.frame_content;
389     } else if ( target == 'query' ) {
390         target = querywindow;
391         //return open_querywindow( targeturl );
392     } else if ( ! target ) {
393         target = window.frame_navigation;
394     }
396     if ( target ) {
397         if ( target.location.href == targeturl ) {
398             return true;
399         } else if ( target.location.href == pma_absolute_uri + targeturl ) {
400             return true;
401         }
403         if ( safari_browser ) {
404             target.location.href = targeturl;
405         } else {
406             target.location.replace(targeturl);
407         }
408     }
410     return true;
413 // opens selected db in main frame
414 function openDb(new_db) {
415     //alert('opendb(' +  new_db + ')');
416     setDb(new_db);
417     setTable('');
418     refreshMain(opendb_url);
419     return true;
422 function updateTableTitle( table_link_id, new_title ) {
423     //alert('updateTableTitle');
424     if ( window.parent.frame_navigation.document && window.parent.frame_navigation.document.getElementById(table_link_id) ) {
425         var left = window.parent.frame_navigation.document;
427         var link = left.getElementById(table_link_id);
428         link.title = window.parent.pma_text_default_tab + ': ' + new_title;
430         var link = left.getElementById('quick_' + table_link_id);
431         link.title = window.parent.pma_text_left_default_tab + ': ' + new_title;
433         return true;
434     }
436     return false;