Update quirks v. standards widget docs

[dankurka]

Originally reported on Google Code with ID 6098

These panels all claim to work only in quirks mode. In reality, they are still useful
in standards mode, but with...some quirks. Their javadoc needs to be updated accordingly,
especially since GWT now considers quirks mode to be deprecated.

user/src/com/google/gwt/user/client/ui/DecoratedStackPanel.java: * This widget will
<em>only</em> work in quirks mode. If your application is in
user/src/com/google/gwt/user/client/ui/DecoratedTabPanel.java: * This widget will <em>only</em>
work in quirks mode. If your application is in
user/src/com/google/gwt/user/client/ui/DecoratorPanel.java: * This widget will <em>only</em>
work in quirks mode in most cases.
user/src/com/google/gwt/user/client/ui/StackPanel.java: * This widget will <em>only</em>
work in quirks mode. If your application is in
user/src/com/google/gwt/user/client/ui/TabPanel.java: * This widget will <em>only</em>
work in quirks mode. If your application is in 

Reported by rjrjr@google.com on 2011-03-01 18:57:08

[dankurka]

Speaking only for myself, I simply do not care if my app looks the same in every browser.
 Given the variable nature of the data that drives my interface, that's not an issue.
 All I care about is that it looks reasonable in every browser, and that the gross
details (Widget 1 is to the left of widget 2 in all browsers, since widget 1 was added
to the HorizontalPanel before widget 2 was added) remain the same.

What I mainly care about is spending my time getting the "business logic" correct,
rather than spending it trying to figure out the correct size for each Panel.  I'm
sure that there are web designers out there who are fascinated by such details.  I'm
not one of them, and my company is highly unlikely to ever hire one of them for any
of the apps I'm working on.  So please don't force all of us to care about those details
(which is what the *LayoutPanels do).

Reported by dougherty.gregory@mayo.edu on 2011-03-01 20:11:35

[dankurka]

I'm still confused about the wider subject this issue raises.

TabPanel etc still say only for quirks mode.

https://developers.google.com/web-toolkit/doc/latest/DevGuideUiPanels#Design suggests
that LayoutPanel based widgets should only be used where you don't want document style
layout.

So if you want a StackPanel or TabPanel in standards mode and take up as much space
as they need (document layout) then GWT has nothing to offer?

Also StackPanel and TabPanel seemed to have been left to die as they don't allow things
like Widgets in the header.

Seems a weakness in my beloved GWT.

Reported by salk31 on 2013-04-22 18:33:26

[dankurka]

Reported by dankurka@google.com on 2013-06-02 17:44:37

• Status changed: PatchesWelcome
• Labels added: Category-Documentation
• Labels removed: Milestone-2_3