Prototype JavaScript framework: Prototype 1.5 and the Documentation is Here

Prototype 1.5 and the Documentation is Here

by Justin Palmer | January 18th, 2007

Ever since the initial announcement of the documentation effort, we’ve been busy planning and preparing Prototype for its rebirth. Along with the official 1.5 release, we’d like to welcome you to the official home of Prototype. This site will serve as the center of our community and help developers everywhere become familiar with Prototype and its continued progress.

Prototype 1.5 release

We’ve been squashing some nasty bugs getting ready for the 1.5 release. You can get the full scoop on all the fixes and improvements in the CHANGELOG.

The API gets documentation

While there has always been some great documentation on Prototype, we’ve been the victim of a famous quote from *“The Man Who Shot Liberty Valance”:

When the legend becomes fact, print the legend.

We’re moving past those times, however. We’ve worked really hard to fully document the API. This is something we’ll be improving over time, but it’s a great start. Here are some of the features:

Guessable URLs

The documentation site has guessable URLs. For instance, if you’re looking for documentation on Element.show, then you can find that documentation at a url like: http://prototypejs.org/api/element/show. If you’re looking for Form.Element.focus you can find it at: http://prototypejs.org/api/form/element/focus.

Atom feeds

Each Object has its own atom feed. This opens the doors for integrated documentation. For instance, if you want the XML file for Form.Element, you can find it at: http://prototypejs.org/feed/api/form/element/atom.xml. This feed will always contain the most up-to-date documentation for Form.Element.

Tips and Tutorials

We’ve also added an article section where you can find tips, tutorials, and a variety of articles for Prototype. We plan on adding many more articles to this area over time, so keep your eyes peeled.

A special thanks

We’ve added three new core members to our team. Chris, Mislav, and Tobie were already avid contributors to Prototype, and they were the driving force behind the documentation effort. We all worked really hard on it, but these guys deserve most of the credit.

Rough around the edges

We’re not perfect, so if you catch any spots in the documentation that are incorrect, or if you’d like to improve parts of the documentation shoot one of us an email. We’ll try to get an official email posted later so you can send in improvements or additions to the documentation. Until then, please enjoy the site!

Update: Rails 1.2 has been announced and includes Prototype 1.5 with the release! Congrats to the Rails team.

Comments

Thomas Fuchs #

This rocks! :)

January 18th, 2007 @ 04:19 PM
Soryu #

Indeed it does. Very nice site, clean design and horay for the content!

January 18th, 2007 @ 04:27 PM
Joce #

thanks ;-)

January 18th, 2007 @ 04:30 PM
Manu #

Very nice ;)

January 18th, 2007 @ 04:37 PM
fxbois #

This site is so much greater than the CHANGELOG in the trac ;) 1.5 is a wonderful news and a great work. You rock !

January 18th, 2007 @ 04:43 PM
Daniel Morrison #

You mean I never again have to try googling ”$$()”?

Amen.

Great work gang!

January 18th, 2007 @ 04:48 PM
Chris R. #

Finally some decent API documentation, a great thanks to the team who put it together, i can’t live without it anymore :)

January 18th, 2007 @ 04:49 PM
Kirill Maximov #

Good site for the great tool. From my point of view, top navigation isn’t easy discoverable. I searched for a Download link in content for at least a minute.

January 18th, 2007 @ 04:49 PM
Thijs van der Vossen #

Excellent work!

January 18th, 2007 @ 04:55 PM
bofe #

I’m so happy! This made my day.

January 18th, 2007 @ 04:59 PM
Michael #

hopefully this is a start of something great! really looking forward to see how this mission progresses. All the best of luck guys!

January 18th, 2007 @ 04:59 PM
Matteo Alessani #

Thanks very much for all of your work!

January 18th, 2007 @ 05:12 PM
Kroc Camen #

Now we have to hold out hope for Script.aculo.us getting some real documentation; It’s as if people don’t want us using their products!

Well done on the great documentation, I’ve already discovered the ease of using Templates that I had missed before.

January 18th, 2007 @ 05:24 PM
nicolash #

finally – thank you. (the link to the changelog doesn’t work “You can get the full scoop on all the fixes and improvements in the CHANGELOG.” =>No node /spinoffs/prototype/CHANGELOG at revision 5997) and please get a favicon so i can find you in my tab-chaos ;-)

January 18th, 2007 @ 05:37 PM
Tarellel #

Great work guys, every bit of your effort is very much appreciated. I can’t wait to get started and see what I’ve missed along the way.

January 18th, 2007 @ 05:45 PM
Justin Palmer #

Thanks for the heads up. The CHANGELOG link should be working now.

January 18th, 2007 @ 05:50 PM
Andrew Dupont #

The URL for the changelog changed on Tuesday when Sam reorganized the repository (to add the standard “branches,” “tags,” and “trunk” folders). That was sneaky of him. :)

January 18th, 2007 @ 06:02 PM
Scott Boms #

Justin – awesome work as always!

January 18th, 2007 @ 06:12 PM
Dave Woodward #

This is great work (very luxurious)!

January 18th, 2007 @ 06:25 PM
Jonathan Snook #

Congrats! this is fantastic news.

January 18th, 2007 @ 07:41 PM
ajaxq #

Great new site to go with your visionary library!

January 18th, 2007 @ 07:50 PM
David T #

Freekin awesome! Thanks.

January 18th, 2007 @ 07:52 PM
Felix #

Congrats on the new site. At last! The documentation has been released

January 18th, 2007 @ 08:19 PM
Samir #

Thanks!

January 18th, 2007 @ 08:20 PM
Mark Holton #

Awesome! Thanks again, Prototype!

January 18th, 2007 @ 08:45 PM
JJ Pagac #

I think it’s great that you have updated your site. The one thing that I would really like is for you to add forums. They seem to be so much easier to use and search for things than mailing lists. There really isn’t a good forum for prototype on the web…

Also…. I am confused why you don’t use much prototype on this site? It might make going through the api docs more fun :)

Thanks for the great library!

January 18th, 2007 @ 08:54 PM
Chris #

Thanks! The new site looks great, as do the docs. I’m looking forward to looking through the ‘Learn” section; hopefully, that’ll encourage me to use Prototype on some of the stuff I’m working on. I’ve been meaning to look into it for some time, and this removes just about any excuse I could use to excuse myself from learning Prototype.

Good work.

January 18th, 2007 @ 09:02 PM
Ken Snyder #

This is wonderful! I would love to contribute to a code-snippet collection for prototype-based widgets (or as other JS libraries call them “plug-ins”). Would it be possible to set up such a collection here? Or is there another place we should gather our prototype-based scripts?

January 18th, 2007 @ 09:23 PM
Uncle Billy #

Hey guys – been using prototype since 1.4 as a framework for a major media website. It’s always been rock-solid. I wanted to make sure that 1.5 is backwards-compatible – I assume that it is? Perhaps a mention of that somewhere on the site would be warranted.

January 18th, 2007 @ 09:34 PM
Justin Palmer #
Uncle Billy: There is a simple change that you’ll need to do (assuming you’ve written code like this).
```
//Old way 
Element.hide('element', 'another', 'evenanother'); 

//New way 
$w('element another evenanother').each(Element.hide); 

//Or 
['element', 'another', 'evenanother'].each(Element.hide); 
```
It’s always wise to test the upgrade in some kind of staging environment too if possible.
January 18th, 2007 @ 09:48 PM
Joey Guerra #

Nice job guys. I haven’t seen the docs yet, but will get to them after this comment. I’ve been reading about Yahoo!’s UI and jQuery and subconsciously comparing the syntax with Prototypes. I don’t know what it is, but I really “get” Prototype much easier than the other’s I’ve researched. So, it’s nice to see that the documentation is coming along.

January 18th, 2007 @ 10:02 PM
Aaron #

I just created a really simple bookmarklet based upon the guessable URLs

Create a new bookmark and set its location to: javascript:p=prompt(“View docs for?”);p=p.replace(/\./g, ”/”);window.location=”http://prototypejs.org/api/”+p.toLowerCase();

You can then add this to your quick launch or assign it a keyword shortcut in FF.

It prompts you for the code snippet you want to search for, using the example above: Form.Element.focus and then redirects you to the correct (hopefully) page in the documentation which in this case would be: http://prototypejs.org/api/form/element/focus

Nothing mind blowing but is a handy shortcut to have :)

January 18th, 2007 @ 10:07 PM
Marty Stake #

Freakin awesome. Congrats all involved. Hopefully this will bring around a very active community of developers! I’d love to know if the scripts I’m making pass muster with this very smart group.

January 18th, 2007 @ 10:18 PM
Son Nguyen #

With a more complete documentation, we will consider using Prototype more extensively. Thanks for everyone’s effort.

January 18th, 2007 @ 10:25 PM
Argus #

Nice Page~ Thanks~ :)

January 18th, 2007 @ 10:28 PM
qureyoon #

wow ! a blog ! great ! and thanks for the release ^^

January 18th, 2007 @ 10:59 PM
Nowgoo #

Greate work! Thanks, many many thanks.

January 18th, 2007 @ 11:00 PM
Joey #

http://prototypejs.org/api/template

doesn’t display some of the custom syntaxes code in Safari Version 2.0.4 (419.3). It’s displaying: var syntax = /(^{|.|\r|\n)(\’
var t = new Template(‘}
Name: <= name %>, Age: <=age%>
’, syntax); t.evaluate( {name:’John Smith’, age:26} ); // ->
Name: John Smith, Age: 26

Here’s the fix for it: var syntax = /(|.|\r|\n)(\<=\s\s\>)/; //matches symbols like ’<%= field %>’

January 18th, 2007 @ 11:14 PM
Joey #

Sorry, my previous comment didn’t display correctly either:)

var syntax… line just need to html encode the less than and greater symbols.

January 18th, 2007 @ 11:15 PM
Sasha Sydoruk #

Wow. Amazing. I never thought that this day would come. Finally there is official site for Prototype and documentation is included! Just Amazing!

Thank you!

January 19th, 2007 @ 12:05 AM
adriano #

good work! 10++

January 19th, 2007 @ 01:00 AM
Tobie Langel #

Joey, that should be fixed now.

Thanks for the heads up.

January 19th, 2007 @ 01:08 AM
Raymond #

Finally. this site is a godsend

January 19th, 2007 @ 01:57 AM
Markus Fischer #

I really like the work on the documentation, but compared to Sergio Pereira it took my longer to find things.

Why? Simple because the one page approach from Sergio really works very well. You everything on one page, just use your browser to search inside the page and it’s there. Right now here isn’t even a search implemented. I also need much more clicks to find something because I can’t search easily across pages.

I also think that the content of the API Docs start page should more interesting things like, some kind of overview or most common used practices, etc, not some boring paragraphs actually bringing nothing of importance to the reader.

I highly appreciate the works into a good Prototype documentation, I just don’t think that this result is something practical to use to find things fast.

January 19th, 2007 @ 02:42 AM
Alexey Kupershtokh #

Awesome news! Good luck to the site :)

January 19th, 2007 @ 02:47 AM
Saimon Moore #

First off, this is very welcome.

It’s obvious that a huge effort has been put into this and it really has paid off.

Great design and great documentation.

Markus, once google has indexed the site you should have no problem finding things quickly, although I agree a search across the api would be helpful.

Apart from that a very well done to all involved.

January 19th, 2007 @ 02:51 AM

Saimon Moore #

Just marking up Aaron’s bookmarklet:


javascript:p=prompt("View docs for?");p=p.replace(/\./g, "/");window.location="http://prototypejs.org/api/"+p.toLowerCase();

January 19th, 2007 @ 02:58 AM

Mads Pedersen #

Excellent news. Congratulations on the new release/site/blog and most of all THANKS for the documentation. Oh, and I’d vote for doc search too.

January 19th, 2007 @ 03:08 AM
Mislav #

Markus, nice feedback and suggestion. We’ll take it into consideration!

January 19th, 2007 @ 03:14 AM
Copongcopong #

the long wait is over!

January 19th, 2007 @ 03:25 AM
Walter #

Hi,

using prototype just got even easier. Great work!

Thanks, Walter

January 19th, 2007 @ 03:41 AM
Justin Palmer #

API search is coming soon, it just didn’t make it on the first round because of technical issues.

January 19th, 2007 @ 03:50 AM
Steve #

I’ve released a compressed version that shrinks prototype.js down to about 30K, 14K if you factor in further gzip compression from the web server.

http://www.stevekallestad.com/blog/prototype_150_compressed.html

I usually release a compressed version pretty quickly.

January 19th, 2007 @ 04:11 AM
Raphael #

Great work!!!!

Thanks for the API doc!!

January 19th, 2007 @ 04:21 AM
markdbd #

Thanks for including the documentation. Now all will be much easier to develop. Great work :)

January 19th, 2007 @ 04:40 AM
Christian #

Finally… there’s a place to stop by while searching for docs. I really learned a lot from Sergio Pereira’s site, but it was stuck at version 1.4. This is much better.

Thanks!

January 19th, 2007 @ 04:44 AM
Gunnar Vogelsang #

Weeeeee ;)

January 19th, 2007 @ 04:45 AM
Mandy #

Finally! :) This is really great and will silence the critics of the prototype library (esp for documentation) for some time :)

January 19th, 2007 @ 04:50 AM
Paul Rooney #

Awesome, It may have taken a while coming but looks worth the wait. Prototype is an amazing piece of work and now we have a community and proper documentation.

Cheers to all involved.

January 19th, 2007 @ 04:54 AM
Peera P #

I cannot coding without prototype

Great JOB :)

January 19th, 2007 @ 05:06 AM
Tommy Skaue #

Congratulations on the new website!! So far it looks very smashing ;-)

..oh, and prototype r0x!

January 19th, 2007 @ 05:48 AM

Vital #

Nice start :) So now we have place to discuss about prototype!

1. It will be great to add “comments” to documentation (like in PHP manual or other online manuals)

2. Compiled manual, i mean .chm. Yes we can do it by download whole pages… but..

3. What about multilanguage support (at least for manual), as i know very much non-english people do it already, so it’s a good place to join them all..

4. Links to “plugins”, yes, many people do it already, but it’s extremaly hard to find :)

5. When prototype.js will handle “real onload”? I mean something like this:


(OnReady = {
    initialize: function() {
        var browser = navigator.userAgent.toLowerCase()
        if ((/mozilla/.test(browser) && !/compatible/.test(browser)) ||
            /opera/.test(browser)) {
            document.addEventListener( "DOMContentLoaded", OnReady.fire, false );
        } else if (/msie/.test(browser) && !/opera/.test(browser)) {
            document.write("<scr><\/script>");
            var script = document.getElementById("__ie_init");
            script.onreadystatechange = function() {
            if (this.readyState == "complete")
                OnReady.fire();
            };
            script = null;
        } else if (/webkit/.test(browser)) {
            OnReady.safariTimer = setInterval(function() {
                if (document.readyState == "loaded" || document.readyState == "complete") {
                    clearInterval( OnReady.safariTimer );
                    OnReady.safariTimer = null;
                    OnReady.fire();
                }
            }, 10);
        }
        Event.observe(window, 'load', OnReady.fire);
    },

    isReady: false,
    readyList: [],

    register: function(func) {
        if (OnReady.isReady )
            func.apply( document );
        else
            OnReady.readyList.push(func);
        return this;
    },

    fire: function() {
        if (!OnReady.isReady) {
            OnReady.isReady = true;
            if (OnReady.readyList) {
                for (var i = 0, func; func = OnReady.readyList[i]; ++i)
                    func.apply(document);
                OnReady.readyList = null;
            }
        }
    }
}).initialize();

Thanx :)

January 19th, 2007 @ 06:10 AM

Bas Wenneker #

Ahh yes, finally!

January 19th, 2007 @ 06:28 AM
DeadMoroz #
Can anybody explain me why Array.each and Hash.each use iterators with different signatures?
```
Array.each = function(value, index){};

Hash.each = function(pair){};
```
So that iterator’s signature depends on iterable object it’s applied to. Why not to make Hash’s each the same as Array’s one?
January 19th, 2007 @ 06:49 AM
Justin Palmer #
A hash is a key/value pair, where an array is a value with an index.

For instance, you can do this with the Hash:
```
$H({name: 'tom', age: 25}).each(function(pair) {
  pair.key;
  pair.value;
}));
```
January 19th, 2007 @ 07:07 AM
realtebo #

Can you add a downloadable version of documentation+tricks ?

thanx for your excellent work !!!

January 19th, 2007 @ 07:10 AM
Jonas #

Thanks for a great framework! You guys should win a Nobel price!

January 19th, 2007 @ 07:24 AM
Motorcycle Guy #

Awesome work! thanks!

January 19th, 2007 @ 09:32 AM
Kirpichtion #

API Docs? I can’t believe it :)

January 19th, 2007 @ 09:46 AM
Aaron #

Your articles section needs a printer friendly version! It puts the blue lines down the sides of my pages and wastes tons of ink on backgrounds and extra pages.

January 19th, 2007 @ 10:02 AM
Justin Palmer #

Alex, thanks for the swift kick. :-) I completely forgot about a printer friendly stylesheet. I’ll get it in soon.

January 19th, 2007 @ 10:14 AM
Jay #

Cool…the long awaited stuff is live now…!!! A moment to cherish…Good job…

January 19th, 2007 @ 11:26 AM
Mertas #

Great! I’ve been using this library for many months and never regreted that!

January 19th, 2007 @ 12:01 PM
Veysel Özer #

good job guys, looks like a good start into the new year ;)

January 19th, 2007 @ 12:03 PM
Ard #

This is just great news! Many thanks! (the design is lovely, btw)

January 19th, 2007 @ 12:18 PM

DeadMoroz #

2Justin Palmer: But wouldn’t it be more beautiful:

$H({name: 'tom', age: 25}).each(function(age, name) {
  name;
  age;
}));

So we could traverse different structures with the same iterator.

var iterator = function(value, index) {
  alert(index + ': ' + value);
};

$H({name: 'tom', age: 25}).each(iterator);
['A', 'B', 'C'].each(iterator);

What’s the reason to not implement such an interface?

January 19th, 2007 @ 12:31 PM

nick99 #

that rocks

January 19th, 2007 @ 12:42 PM
Justin Palmer #

What’s the purpose of the iterator in your first example? If you want to use an argument for every key in a hash, there is no need to iterate over them.

You don’t even need the $H() wrapper, your just accessing known keys.

obj.name, obj.age

I think your misunderstanding Objects vs. Arrays. What if you had 3 keys? How would you use the same iterator? Arrays and Hashes are different data types, and thus require different iteration mechanisms. One is a collection of key/value pairs, the other is a collection of values, each with an numerical index.

January 19th, 2007 @ 12:50 PM
ilia #

site seems slow to me.

January 19th, 2007 @ 01:43 PM
Justin Palmer #

I think that might have something to do with the 60,000+ page views and 16,000 unique visitors we’ve had already today. :-)

January 19th, 2007 @ 01:55 PM
Troy Galloway #

This rock!

Good job to everyone who helped get this up. No more code hunting ;-)

January 19th, 2007 @ 02:41 PM
Pradesh #

Thanks.

Lack of documentation and a sold development team has long been an arguement against propotype, but we see now that there was a lot of work behind the scenes,

You’ve just helped me make up my mind on important decisions.

January 19th, 2007 @ 02:43 PM
Thomas Aylott #

Trying to write a workable textmate command to search the new API. Is there a chance you guys will make a quick go-to command, so I can just do http://prototypejs.org/api/getElementsByClassName instead of http://prototypejs.org/api/element/getElementsByClassName

If we had that, the command would be a simple onelines, taking the current word and popping it at the end of the url. With the class name as a requirement in the url, I’ll have to change the scoping all around or create some sort of lookup table or something to match the method names with the class names.

Thank, great stuff!

January 19th, 2007 @ 02:46 PM
louenas #

Hello, I have a problem that is related to what is described on http://prototypejs.org/api/array . I use multiples scripts and one of them uses Prototype but others not. The others (those I can’t change) have problems with the Array class because they use for…in loops to browse thru the array values. Consequently the function without of the Prototype’s Array get called unintentionally. I’m wondering whether there is a work around I can try knowing that right now I can’t change those scripts? Thanks in advance, Louenas

January 19th, 2007 @ 03:54 PM
Kjell Bublitz #

Do you plan to put up e-mail notification about changes in the docs?

January 19th, 2007 @ 04:02 PM
Justin Palmer #

@Thomas: Great to hear your working on something for Textmate!

On your point…Unfortunately we can’t really do that. Mephisto would regognize /getElementsByClassName as a section, when in fact, it’s a page.

I had some ideas about doc tooltips in Textmate by pulling down the atom files for the sections. We put the syntax and a short blurb in the excerpts with the intentions of doing just that.

@louenas: Not much you can do about that. See Andrew’s post on that topic.

@Kjell Bublitz: ATM, there are no plans for this. You can, however, subscribe to a section feed and tell your feed reader to mark updated items as unread. I know most Mac feedreaders have this feature.

January 19th, 2007 @ 04:41 PM
jonathan reid #

i heart prototype.

January 19th, 2007 @ 06:54 PM
DeadMoroz #

2Justin Palmer: probably, my misunderstanding you talking about is based on using php+json to pass data from server into javascript on client.

As known, arrays in php can have not only numeric key but text ones as well. And json transformation I use works in the following way: - if array keys are 0, 1, 2 … and so on, it creates a javascript array; - but if they are not (let’s say “foo”, “bar”, “baz”... or even 1, 2, 3 (not a zero-based array)), it will create an object with corresponding properties.

So the iterator I have to use on client side depends on is the data passed a zero-based array or not. That’s what I meant.

Anyhow, thank you for the explanation.

January 19th, 2007 @ 07:11 PM
visor #

“off-line” API Documentation (CHM file) http://rapidshare.com/files/12532650/Prototype_Javascript_Framework.zip :-)

January 20th, 2007 @ 05:54 AM
Justin Palmer #

@visor: Do you mind putting that in a more sane area? The requirements to grab the CHM file are discouraging.

If you don’t have the hosting, we can put it up here if you don’t mind?

January 20th, 2007 @ 10:42 AM
louenas #

Thanks Justin. I’ve already red the Andrew’s post but it doesn’t help in my case. You know on Firefox it doesn’t behave the same as in IE i.e. the for..in loop iterates only over the values not the properties in Firefox. Is there a way to reduce the scope where of the extended Array? Thanks for your help Louenas

January 20th, 2007 @ 11:21 AM
Kjell Bublitz #

Heya.. and here comes my interpretation of an offline version :) Worked on this the whole night, plus this morning for the other half. Damn.. didnt know this framework growed so heavy. ^^ I marked up as good as i could and followed the same style as currently online available.

http://www.m3nt0r.de/devel/Prototype.chm

enjoy!

January 20th, 2007 @ 04:59 PM
Hasin Hayder #

Well, I am a long time fan of Prototype, but after I read the documentation created by sergio. This one simply rocks.

Kjell Bublitz, Kudos for your effort. I was aggresively looking for an offline version… Hats off.

January 21st, 2007 @ 03:25 AM
Andi Kalsch #

This is a compressed version of stable 1.5.0, that really works in all current browser without console errors – tested in Firefox/bird, IE5.5+, Opera8+:

http://aka-fotos.de/research/prototype/js/prototype1.5.0c.js

It’s compressed with Dean Edward’s packer and is based on a cleaned version with all necessary ”;”s and some little adaptations. So use this one, if you are goin to compress it yourself:

http://aka-fotos.de/research/prototype/js/prototype1.5.0clean4Compression.js

Yeah, 29 kB are much better than 73.

Andi

January 21st, 2007 @ 08:44 PM
visor #

@Justin Palmer: of course you can put it on your site! :)

January 21st, 2007 @ 10:59 PM
Phani #

Thanks everyone for this extensive documentation on Prototype. This will help me out in knowing more about this.

Prototype is great!!!!!

PS : Thanks Kjell Bublitz for the offline documentation.

January 22nd, 2007 @ 06:25 AM
David Lafon #

Amazing ! Great ! I can’t code without prototype or with difficulties ;-)

January 22nd, 2007 @ 08:11 AM
jennifer #

phenemonal!

i’d love to see more, myriad examples though….

January 22nd, 2007 @ 10:27 AM
Jay Tee #

Great!! I love the documentation!!!

By the way – is there any chance that the next version(s) can be minified? I know that JavaScript makes curly braces optional for one-liners, but it makes it tough to have a smaller version of the script. I’ve home-spun my own version of 1.5.0_rc1 to make it smaller and reduced the file down to about 40kb.

Thanks!

January 22nd, 2007 @ 02:16 PM
Mario Garcia #

Hi.

This is the most fantastic site. ;)

I waiting for a widgets community based in prototype for advance treeview, combo box, windows, tab panel, etc.

Excellent job.

Excellent material.

Thank’s for this beautiful job.

Mario

January 22nd, 2007 @ 02:48 PM
David Boccabella #

Thanks so much for the documentation.

One question.. You have a serialise form function..

Is there anyway to have a serialised array of object.

For instance – a grid has a row of control and you want to send that row off to the server.

You can put the controls into an array but how do you then send them to the server?.

Take Care Dave

January 23rd, 2007 @ 11:34 PM
Richard #

Hi Justin :o)

Any chance of a packaged documentation? Say a ZIP file?

I’d really love to be able to spend a weekend on my laptop somewhere without having to connect to the internet (wireless in Australia is expensive!)...

Cheers :o) Richard

January 24th, 2007 @ 06:14 PM
Wellington Castellani #

Tanks!!!

January 25th, 2007 @ 08:01 PM
Thomas Hansen #

Great, it’s about time! I think the library will be WAY more popular amongst juniors if you get some serious docs on it…

January 26th, 2007 @ 03:08 AM
Justin Palmer #

@Richard: You are aware that you can right click the link to save? Or for that matter click File->Save in your browser or copy it into those Text Editors we always have open.

January 26th, 2007 @ 09:15 AM
Fox #

Will there be a forum soon? I’ve found a problem with 1.5 and the $ function (vs 1.4 which works fine) but I’m apparently not technically savvy enough to isolate the issue on my own.

January 27th, 2007 @ 07:04 AM
Dustin Diaz #

I still want to make sure my comment gets in here. Just wanted to say congrats to a beautiful API documentation site and relaunch of Prototype. This was a giant leap and you guys are totally kicking ass. Congrats!

January 27th, 2007 @ 02:59 PM
Guru Prasath #

You can download the entire API documentation from http://aprasadh.googlepage.com.

January 29th, 2007 @ 11:36 AM

MARK #


function getDom(aurl){
    var temp;
    new Ajax.Request(aurl, {
      method: 'get',
      asynchronous:false,
      onSuccess: function(transport) {
        alert (transport.responseXML);// this is a xml obj
        temp = transport.responseXML;
      }
    });
    return temp;//why isn't xml obj ????
}

I want get a xml dom ,but i don’t know ,why the temp always =null

help me!

January 30th, 2007 @ 08:30 AM

mark2 #


function getxmlDom(aurl){
    var temp;
    new Ajax.Request(aurl, {
      method: 'get',
      asynchronous:false,
      onSuccess: function(transport) {
        alert (transport.responseXML);//this is show a xml dom obj.
        temp = transport.responseXML;
      }
    });
    return temp;//and this is show null.???? why ??
}

i want to get a xml dom obj , i don’t know why the temp always =null. help me! thanks.

January 30th, 2007 @ 08:36 AM

JoseSan #
Excellent! Keep up the good work!

Maybe it is a silly question, but I cannot get this to work (Win XP, Apache, IE 6):
```
 var url = 'services/srv_comboUpdate.php';
 var payload = {tableName:'sometable', tableFilterValue: '0', tableSortField: 'id'};

 var myAjax = new Ajax.Request(
   url, 
   {
    method: 'get', 
    parameters: payload, 
    // parameters: $H( payload ),
    onComplete: function(xhr){
         // ...
      }
   });
```
(url don’t get any data, either with $H() or not; but if parameters are passed in a string of key-value pairs separated by ampersands, everything works as expected). Did I miss something? I appreciate your help and suggestions
January 31st, 2007 @ 05:36 AM
JoseSan #

Disregard previous post. I was using kind of beta prototype.js. My mistake, sorry.

February 1st, 2007 @ 03:32 AM
manish #

plese give the detail example of the api documentation

February 1st, 2007 @ 08:42 AM
lanetas #

hey, look this file http://beta.bigmedium.com/bm~doc/prototype-api.pdf is a great work for the documentation of the api

February 1st, 2007 @ 02:30 PM
修文 #

有没有更加详细的文档？？？

February 3rd, 2007 @ 02:14 AM
timmy #

The docs has no samples?

February 6th, 2007 @ 08:34 PM
zen #

COOL SITE & INFO !!!

February 7th, 2007 @ 06:18 AM
Greyzone #

I cannot find your license file anywhere. The code itself refers to an “MIT style” license but nowhere do I see the actual license file itself. I’m very interested in this javascript library but my corporate legal won’t let me touch it until they can review and approve the license file.

So… can you tell me where I can find it? It really really REALLY should be a link off the main page.

February 7th, 2007 @ 11:20 AM
Juan #

a great tutorial!, but its necessary more exercises or free scripts, thanks.

February 8th, 2007 @ 11:59 AM
Bill #

Why on older versions of mozilla does the status bar say…. “Waiting for www.mydomain.com” whenever I make a call using your script… it sits and waits for something…and goes away once you refresh the page.

Is there anyway to kill the connection, it seems to stay stuck open with older mozilla… im using your basic example.

February 12th, 2007 @ 04:29 AM

Sorry, comments are closed for this article.

Search Blog

Search the prototype blog.

Prototype Javascript Framework

Prototype is a JavaScript Framework that aims to ease development of dynamic web applications.