1 |
siliconforks |
2 |
== script.aculo.us web 2.0 javascript |
2 |
|
|
|
3 |
|
|
The Web is changing. The 30-year-old terminal-like technology it was originally |
4 |
|
|
is gradually giving way to new ways of doing things. The power of AJAX allows |
5 |
|
|
for rich user interaction without the trouble that has bugged traditional |
6 |
|
|
web applications. |
7 |
|
|
|
8 |
|
|
Building upon the wonderful Prototype JavaScript library, script.aculo.us |
9 |
|
|
provides you with some great additional ingredients to mix in. |
10 |
|
|
|
11 |
|
|
For more information, see http://script.aculo.us/ |
12 |
|
|
|
13 |
|
|
== What's new in this release? |
14 |
|
|
|
15 |
|
|
See the CHANGELOG file for information on what's new. |
16 |
|
|
|
17 |
|
|
== Installation/Usage |
18 |
|
|
|
19 |
|
|
script.aculo.us includes the Prototype JavaScript Framework |
20 |
|
|
V1.5.0. You can use later versions, as they become available |
21 |
|
|
(see http://prototype.conio.net). |
22 |
|
|
|
23 |
|
|
Put prototype.js, and the six files scriptaculous.js, |
24 |
|
|
builder.js, effects.js, dragdrop.js, controls.js and slider.js |
25 |
|
|
in a directory of your website, e.g. /javascripts. |
26 |
|
|
|
27 |
|
|
(The unittest.js file is optional and is only needed if you |
28 |
|
|
want to do unit testing on your own javascripts). |
29 |
|
|
|
30 |
|
|
Now, you can include the scripts by adding the following |
31 |
|
|
tags to the HEAD section of your HTML pages: |
32 |
|
|
|
33 |
|
|
<script src="/javascripts/prototype.js" type="text/javascript"></script> |
34 |
|
|
<script src="/javascripts/scriptaculous.js" type="text/javascript"></script> |
35 |
|
|
|
36 |
|
|
scriptaculous.js will automatically load the other files of the |
37 |
|
|
script.aculo.us distribution in, provided they are accessible |
38 |
|
|
via the same path. |
39 |
|
|
|
40 |
|
|
See http://wiki.script.aculo.us/scriptaculous/show/Usage for detailed |
41 |
|
|
usage instructions. |
42 |
|
|
|
43 |
|
|
== The distribution |
44 |
|
|
|
45 |
|
|
Besides the script.aculo.us files in src, there's a complete |
46 |
|
|
test tree included which holds functional and unit tests for |
47 |
|
|
script.aculo.us. |
48 |
|
|
|
49 |
|
|
If you need examples on how to implement things, the best place to |
50 |
|
|
start is by opening test/run_functional_tests.html or |
51 |
|
|
test/run_unit_tests.html in your browser, and looking at |
52 |
|
|
the sources of the examples provided. |
53 |
|
|
|
54 |
|
|
== License |
55 |
|
|
|
56 |
|
|
script.aculo.us is licensed under the terms of the MIT License, |
57 |
|
|
see the included MIT-LICENSE file. |