PDA

View Full Version : Documentation



nickelj
14 Oct 2010, 5:07 PM
Hi,

I was going through the API documentation and I noticed a few things - some you may want to fix, and others you may not.

Under Class Ext.Window (http://dev.sencha.com/deploy/dev/docs/source/Window.html#cls-Ext.Window)

- You don't mention "frame" at all. There is a config option called frame that is a boolean - defaults to true. Allows the frame of the windows to be completely hidden if false.

- You have references to a config option "floating", but you don't have an entry for it. For example, the config option of shadow references floating=true

I am continuing to learn and go through the documentation....let me know if you wish me to post more of these...otherwise I won't bother.

Jim

evant
14 Oct 2010, 5:11 PM
Windows are framed and floating as true by default and the options aren't really meant to be modified, which is why they aren't documented.

nickelj
14 Oct 2010, 5:55 PM
Thanks for your reply. I do understand that they are both true by default.

However, there are times when a developer may want to enclose a item inside a window but not have the frame visible.

Anyway....you guys are awesome! Do what you think is best.

Jim

Animal
14 Oct 2010, 9:44 PM
It's explicitly hidden because it's expected that a Window is framed by a nice border.

It's actually probably a good idea to unhide it because in Ext 3, to get a floating, resizable BoxComponent, you must create a Window tweaked to not look like a window:



new Ext.Window({
border: false, // Override Window's default
frame: false, // Override Window's default
draggable: false, // Override Window's default
closable: false, // Override Window's default
elements: 'body', // Override Window's default
baseCls: 'x-panel', // Override Window's default
floating: {shadow: false}, // Override Window's default
resizeHandles: 'se,sw',
height: 200,
width: 200,
x: 100,
y: 100,
bodyStyle: 'background-color:red' // just so you can see it.
}).show()


So that you get

http://i131.photobucket.com/albums/p286/TimeTrialAnimal/floatingbox.jpg

In Ext 4, floatability, resizability etc are where they should be in the hierarchy: At the Component level so everything gets that ability.