Revision: 7160
Author: j...@google.com
Date: Tue Nov 24 14:38:02 2009
Log: Cleans up javadoc in layout panels (TODOs will be captured as issues).
Fix for non-standard gwt-Tab style name.
Review by: bruce (TBR)
http://code.google.com/p/google-web-toolkit/source/detail?r=7160
Modified:
/trunk/user/src/com/google/gwt/user/client/ui/DockLayoutPanel.java
/trunk/user/src/com/google/gwt/user/client/ui/LayoutPanel.java
/trunk/user/src/com/google/gwt/user/client/ui/RootLayoutPanel.java
/trunk/user/src/com/google/gwt/user/client/ui/SplitLayoutPanel.java
/trunk/user/src/com/google/gwt/user/client/ui/StackLayoutPanel.java
/trunk/user/src/com/google/gwt/user/client/ui/TabLayoutPanel.java
=======================================
--- /trunk/user/src/com/google/gwt/user/client/ui/DockLayoutPanel.java Wed
Nov 4 06:54:43 2009
+++ /trunk/user/src/com/google/gwt/user/client/ui/DockLayoutPanel.java Tue
Nov 24 14:38:02 2009
@@ -31,17 +31,10 @@
* declaration.
* </p>
*
- * <p>
- * NOTE: This class is still very new, and its interface may change without
- * warning. Use at your own risk.
- * </p>
- *
* <p>
* <h3>Example</h3>
* {...@example com.google.gwt.examples.DockLayoutPanelExample}
* </p>
- *
- * TODO(jgw): RTL support.
*/
public class DockLayoutPanel extends ComplexPanel implements
AnimatedLayout,
RequiresResize, ProvidesResize {
=======================================
--- /trunk/user/src/com/google/gwt/user/client/ui/LayoutPanel.java Wed Nov
4 06:54:43 2009
+++ /trunk/user/src/com/google/gwt/user/client/ui/LayoutPanel.java Tue Nov
24 14:38:02 2009
@@ -34,11 +34,6 @@
* declaration.
* </p>
*
- * <p>
- * NOTE: This class is still very new, and its interface may change without
- * warning. Use at your own risk.
- * </p>
- *
* <p>
* <h3>Example</h3>
* {...@example com.google.gwt.examples.LayoutPanelExample}
=======================================
--- /trunk/user/src/com/google/gwt/user/client/ui/RootLayoutPanel.java Wed
Oct 28 12:55:56 2009
+++ /trunk/user/src/com/google/gwt/user/client/ui/RootLayoutPanel.java Tue
Nov 24 14:38:02 2009
@@ -34,11 +34,6 @@
* declaration.
* </p>
*
- * <p>
- * NOTE: This class is still very new, and its interface may change without
- * warning. Use at your own risk.
- * </p>
- *
* <p>
* <h3>Example</h3>
* {...@example com.google.gwt.examples.LayoutPanelExample}
=======================================
--- /trunk/user/src/com/google/gwt/user/client/ui/SplitLayoutPanel.java Tue
Nov 24 14:14:51 2009
+++ /trunk/user/src/com/google/gwt/user/client/ui/SplitLayoutPanel.java Tue
Nov 24 14:38:02 2009
@@ -32,25 +32,24 @@
* </p>
*
* <p>
- * This widget will <em>only</em> work in standards mode, which requires
- * that the HTML page in which it is run have an explicit <!DOCTYPE>
+ * This widget will <em>only</em> work in standards mode, which requires
that
+ * the HTML page in which it is run have an explicit <!DOCTYPE>
* declaration.
* </p>
*
- * <p>
- * NOTE: This class is still very new, and its interface may change without
- * warning. Use at your own risk.
- * </p>
+ * <h3>CSS Style Rules</h3>
+ * <ul class='css'>
+ * <li>.gwt-SplitLayoutPanel { the panel itself }</li>
+ * <li>.gwt-SplitLayoutPanel .gwt-SplitLayoutPanel-HDragger { horizontal
dragger
+ * }</li>
+ * <li>.gwt-SplitLayoutPanel .gwt-SplitLayoutPanel-VDragger { vertical
dragger }
+ * </li>
+ * </ul>
*
* <p>
* <h3>Example</h3>
* {...@example com.google.gwt.examples.SplitLayoutPanelExample}
* </p>
- *
- * TODO(jgw):
- * - RTL Support.
- * - implement insert().
- * - Come up with a decent way to specify splitter style and size.
*/
public class SplitLayoutPanel extends DockLayoutPanel {
@@ -213,6 +212,7 @@
public SplitLayoutPanel() {
super(Unit.PX);
+ setStyleName("gwt-SplitLayoutPanel");
}
@Override
=======================================
--- /trunk/user/src/com/google/gwt/user/client/ui/StackLayoutPanel.java Tue
Nov 3 14:14:13 2009
+++ /trunk/user/src/com/google/gwt/user/client/ui/StackLayoutPanel.java Tue
Nov 24 14:38:02 2009
@@ -34,22 +34,10 @@
* declaration.
* </p>
*
- * <p>
- * NOTE: This class is still very new, and its interface may change without
- * warning. Use at your own risk.
- * </p>
- *
* <p>
* <h3>Example</h3>
* {...@example com.google.gwt.examples.StackLayoutPanelExample}
* </p>
- *
- * TODO(jgw):
- * - implement insert().
- * - add() methods with default widgets for headers.
- * - some way to get the header widget associated with a child.
- * - make animation configurable (with {...@link HasAnimation}).
- * - default style.
*/
public class StackLayoutPanel extends Composite implements HasWidgets,
RequiresResize, ProvidesResize {
=======================================
--- /trunk/user/src/com/google/gwt/user/client/ui/TabLayoutPanel.java Fri
Nov 20 13:07:53 2009
+++ /trunk/user/src/com/google/gwt/user/client/ui/TabLayoutPanel.java Tue
Nov 24 14:38:02 2009
@@ -39,24 +39,24 @@
* associated with them. The tabs can contain arbitrary text, HTML, or
widgets.
*
* <p>
- * This widget will <em>only</em> work in standards mode, which requires
- * that the HTML page in which it is run have an explicit <!DOCTYPE>
+ * This widget will <em>only</em> work in standards mode, which requires
that
+ * the HTML page in which it is run have an explicit <!DOCTYPE>
* declaration.
* </p>
*
- * <p>
- * NOTE: This class is still very new, and its interface may change without
- * warning. Use at your own risk.
- * </p>
+ * <h3>CSS Style Rules</h3>
+ * <ul class='css'>
+ * <li>.gwt-TabLayoutPanel { the panel itself }</li>
+ * <li>.gwt-TabLayoutPanel .gwt-TabLayoutPanelTabs { the tab bar element
}</li>
+ * <li>.gwt-TabLayoutPanel .gwt-TabLayoutPanelTab { an individual tab
}</li>
+ * <li>.gwt-TabLayoutPanel .gwt-TabLayoutPanelTabInner { an element nested
in
+ * each tab (useful for styling) }</li>
+ * </ul>
*
* <p>
* <h3>Example</h3>
* {...@example com.google.gwt.examples.TabLayoutPanelExample}
* </p>
- *
- * TODO:
- * - Aria, RTL, DebugId
- * - Update style mechanism (gwt-Tab, etc. not really sufficient).
*/
public class TabLayoutPanel extends ResizeComposite implements HasWidgets,
ProvidesResize, IndexedPanel, HasBeforeSelectionHandlers<Integer>,
@@ -72,8 +72,8 @@
getElement().appendChild(anchor =
Document.get().createAnchorElement());
setWidget(child);
- setStyleName("gwt-Tab");
- anchor.setClassName("gwt-TabInner");
+ setStyleName("gwt-TabLayoutPanelTab");
+ anchor.setClassName("gwt-TabLayoutPanelTabInner");
// TODO: float:left may not be enough. If there are tabs of
differeing
// heights, the shorter ones will top-align, rather than
bottom-align,
--
http://groups.google.com/group/Google-Web-Toolkit-Contributors
