PDA

View Full Version : Something wrong with the Api ?



Edoc
20 Jun 2010, 4:51 AM
Hello everybody,
i'm very new with sencha touch and with Ext JS as well.
I'm trying to do a very simple thing : showing toolbar with some buttons on it.
So i opened the toolbars example to understand how all of this work.
I see at the end of the file :

new Ext.Panel({
id: 'toolbartxt',
html: 'Pick a button, any button. <br /><small>By using SASS, all of the buttons on this screen can be restyled dynamically. The only images used are masks.</small>',
fullscreen: true,
dockedItems: dockedItems
});

The problem is i can't find in the Api the dockedItems property.
The same with doLayout() if i try a search in the main api's page i can see it but when i go to a link no way to find it...

Am i misunderstanding something ?

Thanks a lot for help !

mrsunshine
20 Jun 2010, 5:00 AM
your right its missing in the api doc, i'll add this to the bug thread.

dockedItems you can for example add a array with item configuration like to items in extjs

example:

dockedItems: [{
dock: 'top',
xtype: 'toolbar',
title: 'Standard Titlebar'
},{
dock: 'top',
xtype: 'toolbar',
type: 'light',
items: [{
text: 'Test Button'
}]
}],

Edoc
20 Jun 2010, 5:27 AM
Allright thanks a lot mrsunshine :-)
Could you tell me what others values the dock property is able to take besides top and bottom ? Because i can't find any documentation about dock in the api either...

mrsunshine
20 Jun 2010, 5:47 AM
The components must include a 'dock' paramater on each component to indicate where it should be docked ('top', 'right', 'bottom', 'left')

also missing in the api :-)
my tip if you need information to undocumented propertys or features take a look to the source code for example Ext.Panel (http://www.sencha.com/deploy/touch/docs/source/Panel.html#cls-Ext.Panel)

Edoc
20 Jun 2010, 7:01 AM
Ok i'll check the source code before posting from now :)
Thanks for your help !

mrsunshine
20 Jun 2010, 7:02 AM
Ok i'll check the source code before posting from now :)
Thanks for your help !
your welcome, good luck ;-)

Edoc
20 Jun 2010, 1:13 PM
Hello again
i'm a bit confused with the api because it seems it is still uncomplete.
When i compare the sencha touch api with the ext js api i see that sencha touch api is uncomplete and for example all layouts are similary documented like there isn't any differences between them. Then i check in ext js api and i see all the differences about properties. So what to do?

Another example, when i tried to understand the kithen sink demo i see :


Ext.ns('sink', 'demos', 'Ext.ux');

Ext.ux.UniversalUI = Ext.extend(Ext.Panel, {
...

again nothing in the sencha touch api about Ext.ns and Ext.ux, the only way is to have a look at the ext js api...
For me it's ok to look only in ext js api instead of sencha touch api but i guess that everything is not compatible.
I could look each time in the source code but finally it takes quite a lot of time...

I'd like to know when the devlelopment team will realase a complete api ?
Otherewise great job ! :)

mrsunshine
20 Jun 2010, 1:44 PM
Ext.ns is a shortcut for Ext.namespace() and Ext.ux is the namespace for reusable user classes.

Your right the API documentation have to be reworked but keep in mind this is the first public beta of sencha touch ;)