summaryrefslogtreecommitdiff
path: root/js/prototype-window-1.3/documentation/debug.html
blob: c38b0a82aaae783dc0f40b84c3ca0a15f1d4d1cc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
	"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" version="-//W3C//DTD XHTML 1.1//EN" xml:lang="en">
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>

	<title>Prototype Window Class : Debug</title>
	<!--  Prototype Window Class Part -->
  <script type="text/javascript" src="../javascripts/prototype.js"> </script> 
	<script type="text/javascript" src="../javascripts/effects.js"> </script>
	<script type="text/javascript" src="../javascripts/window.js"> </script>
	<script type="text/javascript" src="../javascripts/debug.js"> </script>
  <script type="text/javascript" src="../javascripts/extended_debug.js"> </script>
	
	<link href="../themes/default.css" rel="stylesheet" type="text/css" >	 </link>
	<link href="../themes/debug.css" rel="stylesheet" type="text/css" >	 </link>
	
  <!--  Doc Part-->
  <link href="stylesheets/style.css" rel="stylesheet" type="text/css" >	 </link>
	<script type="text/javascript" src="js/application.js"> </script>  		
</head>

<body>
  <script>Application.insertNavigation('debug')</script>
  <div id="wrapper">
  <div id= "content" class="content">
  
In addtion of <tt>window.js</tt>, there is a little javascript <tt>debug.js</tt> more usefull than the alert javascript function to display debug information.

There are few functions:
<ul>
  <li> <tt>showDebug()</tt> : to open the debug window.</li>
  <li> <tt>hideDebug()</tt> to remove it.</li>
  <li> <tt>debug(message, reverse)</tt>: to display a message in the debug window. reverse is optional if you want to append text at the beginning of the window instead of the end.</li>
  <li> <tt>clearDebug()</tt>: to clear debug window content.</li>
</ul>
Just add this lines in your HTML page
<xmp><script type="text/javascript" src="/javascripts/prototype.js"> </script>
<script type="text/javascript" src="/javascripts/window.js"> </script>
<script type="text/javascript" src="/javascripts/debug.js"> </script>

<link href="/stylesheets/themes/default.css" rel="stylesheet" type="text/css"></link>
<link href="/stylesheets/themes/debug.css" rel="stylesheet" type="text/css"></link>
</xmp>

<br/>And this in your code
<xmp><script>showDebug()</script>
</xmp>
<br/>This window uses setCookie() to save its size and position. You will see after using it you cannot live without :).<br/>
<a href="javascript:showDebugWindow()">Click here</a> to open the debug window that displays mouse coordinates.

<script>
var mouseTracker = null;
var MouseTracker = Class.create();
MouseTracker.prototype = {
    initialize: function() {    
        this.eventMouseMove = this.mouseMoved.bindAsEventListener(this);
        Event.observe(document, "mousemove", this.eventMouseMove);
    },
    destroy: function() {
      Event.stopObserving(document, "mousemove", this.eventMouseMove);
    },
    mouseMoved: function(event) {
        var pointer = [Event.pointerX(event), Event.pointerY(event)];
        clearDebug();
        debug("Mouse  : " + pointer[0] + "," + + pointer[1]);
    }
}

function showDebugWindow() {
    if (mouseTracker == null)
        mouseTracker = new MouseTracker();
    hideDebug();
    showDebug();
}

</script>

<h2 id="addon">Add on</h2>
Nick Hemsley has done a nice add-on to the debug window that allows you to inspect any object.<br/>
<a href="javascript:editAddOn()">Click here</a> to inspect the H2 "Add on" title.

<script>
function editAddOn(){
  if (mouseTracker != null) {
    mouseTracker.destroy();
    mouseTracker = null;
  }
  showDebug();
  clearDebug();
  inspect($('addon'));
}
</script>

<h2 id="addon">Add on - extended</h2>
Jason Pollard has included the Nick's add-on inside the window debug by adding a "inspect" icon in the top bar. <br/>
Click on the <img src="../themes/default/inspect.gif"> icon and then click on an element in the page you want to inspect.<br/>
He has also included an eval text field with history (use up and down keys).<br/><br/>
To use it just include <tt>extended_debug.js</tt> after <tt>debug.js</tt>.<br/>

<a href="javascript:showExtendedDebug()">Click here</a> to open the extended debug window.

  </div>
</div>
<script type="text/javascript">Application.addRightColumn()</script>

</body>
</html>