PDA

View Full Version : Can't find items in documentation for Ext



Specks
25 May 2007, 3:31 PM
Hey guys,

I'm pretty new to the whole DHTML, AJAX and Web 2.0 thing. I've been trying to learn how to use JavaScript to enhance the user experience and had been bouncing around from library to library. I started with prototype then went to Dojo wooed by the widgets that were a part of the library. Then after looking to to Dojo the code seemed convoluted and unstable and the documentation nearly nonexistent. I'm a Perl/PHP programmer and I'm not quite used to the way things are done as far as Javascript goes. I have to hand it to the Ext team though. You guys really have it together. The problem with the documentation that I have is that while playing with layouts I tried to find all the options available for Ext.BorderLayout for a panel definition. I can't find it anywhere in the documentation (not even when I go to LayoutManager). I'm very unfamiliar with the way the documentation is put together or I'm just blind. Can someone please help me out in finding where the options for the different widgets/methods are?

Much appreciated for the help. As soon as I get to know the library better I'll be able to contribute back.

Specks

tryanDLS
25 May 2007, 3:54 PM
The majority of config options for layout related stuff is on LayoutRegion and ContentPanel, both of which list the configs in the doc. Also, you might want to refer to recently added Layout tutorial on the home page for a general overview.

Thomas H.
27 May 2007, 4:17 AM
Hello,

me too. :-/ Hmm, maybe I

tryanDLS
27 May 2007, 9:18 AM
The Form stuff is fairly new so doc may be a little behind. While the generated doc may not have the info, a lot of doc has been added to the source since the last doc creation, so you may find additional info by looking at the comments in the source code.

Thomas H.
28 May 2007, 10:21 AM
Hello Tim,

thank you for your answer.

I have tried to look in the source, but I have not found any comments. I have looked in form-debug.js. Maybe this is the wrong place? Can you please give me a hint where I can find the comment?

Bye Thomas

tryanDLS
28 May 2007, 10:24 AM
Look at form.js - most of that code is commented. Config options are denoted in the comments by '@cfg'

Thomas H.
28 May 2007, 10:33 AM
Tim, thank you for your fast answer!
I have looked at form.js and I did not found any '@cfg' in that file. Maybe I

tryanDLS
28 May 2007, 12:12 PM
They are in 1.0.1a source\widgets\form. Note that some of them are in BasicForm - the parent of Form.

Thomas H.
28 May 2007, 1:04 PM
Hello Tim,

thank you, I found now the correct file with the comments. Unfortunately there is as much explanation, as in the generated help files. For example I was looking for the options of submit


submit : function(options){
this.doAction('submit', options);
},
/**
* Shortcut to do a load action
* @param {Object} options The options to pass to the action
*/
But the options are not explained above. Nevertheless I have now figured out the options by reading the examples and the forum.
Compared to other frameworks I used, the Ext documentation is very good. For other newbies like me it would be helpful to improve these details for the next version.
Thanks again for your help!

Greetings Thomas