API Documentation Content Bugs

[SebTardif]

http://docs.sencha.com/ext-js/4-0/#!...container.Card is wrong

It says: the only way to move from one Component to the next is by calling setActiveItem, passing the id or index of the next panel to display.

Correction: you can also pass an instance of a panel (which is more readable), see http://docs.sencha.com/ext-js/4-0/#!...-getActiveItem

[renku]

Thanks campersau1 and SebTardif. These issues are now fixed internally.

[skirtle]

http://docs.sencha.com/ext-js/4-0/#!...nent-cfg-xtype

The documentation for xtype is very misleading. It describes how it used to work in ExtJS 2 but it does not work this way in ExtJS 3 or 4. Many people (including some ExtJS developers I've spoken to) still believe that xtypes give them lazy rendering or lazy instantiation as described here. It doesn't.

In the example given there are 2 panels. In the first example the button is created just before the panel. In the second example it will be created by the panel's constructor. Though the timing is subtly different there isn't any real difference in the end result. It certainly does not do what is described in the docs.

I really like xtypes. It seems a shame that the real benefits aren't documented and this historical use case is still the one most people give for using them.

[nick_p]

Hi skirtle,

We're updating the xtype docs which should be live in the not too distant future. Thanks for pointing out the inaccuracies

Nick

[tonyx]

In the documentation, we are told

handler : Function
A function called when the icon is clicked. The handler is passed the following parameters:

• view : TableViewThe owning TableView.
• rowIndex : NumberThe row index clicked on.
• colIndex : NumberThe column index clicked on.
• item : ObjectThe clicked item (or this Column if multiple items were not configured).
• e : EventThe click event.

However, I recently discovered that this isn't true. These are the console outputs for each of the argument to the handler function, in order.

Ext.grid.View <Soc.model.Survey>  [6] { id="gridview-1032"}
 <td id="ext-gen1294" class=" x-grid-cell x-grid-cell-actioncolumn-1029   x-action-col-cell x-grid-cell-last">
 0
 3
 [Trial] Ext.EventObjectImpl {}
 Object { scope=Soc.view.survey.Grid,  uievent=function()}
 Object {}

Clearly, the second argument is not rowIndex. I think it is actually the cell in which the icons are rendered.

[slemmon]

Should parentMenu still be a config for menu/items? I don't see it any longer in the documentation, but I do see it used in the source.

[hexawing]

http://docs.sencha.com/ext-js/4-0/#!...dow.MessageBox

When viewing the examples in this page, toggle to "Preview" mode, then toggle to "Code" mode, then try to toggle to "Preview" mode again, it alerts "TypeError: a.parentNode is null" and cannot continue...

[renku]

Actioncolumn handler documentation bug?
[--]
Clearly, the second argument is not rowIndex.

I tested with ext-4.0.2a and ext-4.0.6 and everything seems to work just fine for me. For example look at the live example of ActionColumn: http://docs.sencha.com/ext-js/4-0/#!....column.Action

This wouldn't work if the second argument were not a rowIndex.

Should parentMenu still be a config for menu/items? I don't see it any longer in the documentation, but I do see it used in the source.

Not really a config option, but a property. Should be documented in next docs update.

http://docs.sencha.com/ext-js/4-0/#!/api/Ext.window.MessageBox

When viewing the examples in this page, toggle to "Preview" mode, then toggle to "Code" mode, then try to toggle to "Preview" mode again, it alerts "TypeError: a.parentNode is null" and cannot continue...

Yeah, something goes wrong there. For some reason using the singleton Ext.Msg breaks things, while instantiating Ext.window.MessageBox manually works just fine. Will take a closer look at this.

[rex.staples]

Small typo in the Further Reading section of the Getting Started guide:

http://docs.sencha.com/ext-js/4-0/#!...etting_started

4. Further Reading

Layouts and Containsers

Containers has an extra -s-.

[campersau1]

The xtype is missing in Ext.form.FieldSet http://docs.sencha.com/ext-js/4-0/#!....form.FieldSet