/*
* Smart GWT (GWT for SmartClient)
* Copyright 2008 and beyond, Isomorphic Software, Inc.
*
* Smart GWT is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License version 3
* as published by the Free Software Foundation. Smart GWT is also
* available under typical commercial license terms - see
* http://smartclient.com/license
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*/
package org.vaadin.smartgwt.server.layout;
import org.vaadin.smartgwt.client.ui.layout.VSectionStackSection;
import org.vaadin.smartgwt.server.Canvas;
import org.vaadin.smartgwt.server.core.ComponentList;
import org.vaadin.smartgwt.server.core.ComponentPropertyPainter;
import org.vaadin.smartgwt.server.core.RefDataClass;
import com.vaadin.terminal.PaintException;
import com.vaadin.terminal.PaintTarget;
import com.vaadin.ui.ClientWidget;
// @formatter:off
/**
* Section descriptor used by a SectionStack to describe a section of items which are shown or hidden together, and their
* associated header.
*/
@ClientWidget(value=VSectionStackSection.class)
public class SectionStackSection extends RefDataClass {
// public static SectionStackSection getOrCreateRef(JavaScriptObject jsObj) {
// if(jsObj == null) return null;
// RefDataClass obj = RefDataClass.getRef(jsObj);
// if(obj != null) {
// obj.setJsObj(jsObj);
// return (SectionStackSection) obj;
// } else {
// return new SectionStackSection(jsObj);
// }
// }
// public SectionStackSection(){
// setID(com.smartgwt.client.util.SC.generateID("SectionStackSection"));
// }
// public SectionStackSection(JavaScriptObject jsObj){
// super(jsObj);
// }
// ********************* Properties / Attributes ***********************
/**
* This attribute controls whether or not the expand/collapse UI control is shown on the header of this section. Any
* section can still be expanded/collapsed programmatically, regardless of this setting.
*
* @param canCollapse canCollapse Default value is true
* @see <a href="http://www.smartclient.com/smartgwt/showcase/#layout_sections_expand_collapse" target="examples">Expand / Collapse Example</a>
*/
public void setCanCollapse(Boolean canCollapse) {
setAttribute("canCollapse", canCollapse);
}
/**
* When explicitly set to false, disallows drop before this member in the Layout.
*
* @param canDropBefore canDropBefore Default value is null
* @see com.smartgwt.client.widgets.layout.Layout
* @see com.smartgwt.client.docs.LayoutMember LayoutMember overview and related methods
*/
public void setCanDropBefore(Boolean canDropBefore) {
setAttribute("canDropBefore", canDropBefore);
}
/**
* If set to false, then this sectionHeader will not be able to be dragged to perform a drag reorder, if {@link
* com.smartgwt.client.widgets.layout.SectionStack#getCanReorderSections canReorderSections} is true. You can also disable
* dropping other sections before this one by setting {@link com.smartgwt.client.widgets.Canvas#getCanDropBefore
* canDropBefore} to false.
*
* @param canReorder canReorder Default value is null
*/
public void setCanReorder(Boolean canReorder) {
setAttribute("canReorder", canReorder);
}
/**
* If true, the header for this Section will be included in the page's tab order for accessibility. May also be set at the
* {@link com.smartgwt.client.widgets.layout.SectionStack} level via {@link
* com.smartgwt.client.widgets.layout.SectionStack#getCanTabToHeaders canTabToHeaders}. <P> See {@link
* com.smartgwt.client.docs.Accessibility}.
*
* @param canTabToHeader canTabToHeader Default value is null
*/
public void setCanTabToHeader(Boolean canTabToHeader) {
setAttribute("canTabToHeader", canTabToHeader);
}
/**
* If true, the header for this Section will be included in the page's tab order for accessibility. May also be set at the
* {@link com.smartgwt.client.widgets.layout.SectionStack} level via {@link
* com.smartgwt.client.widgets.layout.SectionStack#getCanTabToHeaders canTabToHeaders}. <P> See {@link
* com.smartgwt.client.docs.Accessibility}.
*
*
* @return Boolean
*/
public Boolean getCanTabToHeader() {
return getAttributeAsBoolean("canTabToHeader");
}
/**
* Optional ID for the section. If {@link com.smartgwt.client.widgets.layout.SectionStackSection#getUseGlobalSectionIDs
* useGlobalSectionIDs} is true, this property will be applied to the generated SectionStackHeader widget as a standard
* widget ID, meaning it should be unique within a page. <P> <b>Backcompat Note</b>: Section stack sections may be uniquely
* identified within a stack via the {@link com.smartgwt.client.widgets.layout.SectionStackSection#getName name} attribute
* (introduced in Jan 2010). Prior to this, the section ID attribute was used in this way (and would not be applied to the
* section header as a widget ID). For backwards compatibility this is still supported: If <code>section.name</code> is
* unspecified for a section but <code>section.ID</code> is set, the ID will be used as a default name attribute for the
* section. For backwards compatibility we also disable the standard behavior of having the <code>section.ID</code> being
* applied to the generated section header (thereby avoiding the page-level uniqueness requirement) by defaulting {@link
* com.smartgwt.client.widgets.layout.SectionStackSection#getUseGlobalSectionIDs useGlobalSectionIDs} to false.
*
* @param ID ID Default value is null
*/
public void setID(String ID) {
setAttribute("ID", ID);
}
/**
* Optional ID for the section. If {@link com.smartgwt.client.widgets.layout.SectionStackSection#getUseGlobalSectionIDs
* useGlobalSectionIDs} is true, this property will be applied to the generated SectionStackHeader widget as a standard
* widget ID, meaning it should be unique within a page. <P> <b>Backcompat Note</b>: Section stack sections may be uniquely
* identified within a stack via the {@link com.smartgwt.client.widgets.layout.SectionStackSection#getName name} attribute
* (introduced in Jan 2010). Prior to this, the section ID attribute was used in this way (and would not be applied to the
* section header as a widget ID). For backwards compatibility this is still supported: If <code>section.name</code> is
* unspecified for a section but <code>section.ID</code> is set, the ID will be used as a default name attribute for the
* section. For backwards compatibility we also disable the standard behavior of having the <code>section.ID</code> being
* applied to the generated section header (thereby avoiding the page-level uniqueness requirement) by defaulting {@link
* com.smartgwt.client.widgets.layout.SectionStackSection#getUseGlobalSectionIDs useGlobalSectionIDs} to false.
*
*
* @return String
*/
public String getID() {
return getAttributeAsString("ID");
}
/**
* Identifier for the section. This can be used later in calls to {@link com.smartgwt.client.widgets.layout.SectionStack}
* APIs such as {@link com.smartgwt.client.widgets.layout.SectionStack#expandSection SectionStack.expandSection} and {@link
* com.smartgwt.client.widgets.layout.SectionStack#collapseSection SectionStack.collapseSection}. Note that if no name is
* specified for the section, one will be auto-generated when the section is created. This property should be a string
* which may be used as a valid JavaScript identifier (should start with a letter and not contain space or special
* characters such as "*").
*
* @param name name Default value is null
*/
public void setName(String name) {
setAttribute("name", name);
}
/**
* Identifier for the section. This can be used later in calls to {@link com.smartgwt.client.widgets.layout.SectionStack}
* APIs such as {@link com.smartgwt.client.widgets.layout.SectionStack#expandSection SectionStack.expandSection} and {@link
* com.smartgwt.client.widgets.layout.SectionStack#collapseSection SectionStack.collapseSection}. Note that if no name is
* specified for the section, one will be auto-generated when the section is created. This property should be a string
* which may be used as a valid JavaScript identifier (should start with a letter and not contain space or special
* characters such as "*").
*
*
* @return String
*/
public String getName() {
return getAttributeAsString("name");
}
/**
* If set to false, then the items in this section will not be resized by sectionHeader repositioning. You may also set
* this flag directly on any of the items in any section to cause that item to not be resizeable.
*
* @param resizeable resizeable Default value is null
* @see <a href="http://www.smartclient.com/smartgwt/showcase/#layout_sections_resize" target="examples">Resize Sections Example</a>
*/
public void setResizeable(Boolean resizeable) {
setAttribute("resizeable", resizeable);
}
/**
* If true, a header will be shown for this section. If false, no header will be shown.
*
* @param showHeader showHeader Default value is true
*/
public void setShowHeader(Boolean showHeader) {
setAttribute("showHeader", showHeader);
}
// ********************* Methods ***********************
// ********************* Static Methods ***********************
// ***********************************************************
/**
* Title to show for the section
*
* @param title title Default value is null
*/
public void setTitle(String title) {
if(stack == null || !stack.isDrawn()) {
setAttribute("title", title);
} else {
stack.setSectionTitle(getName(), title);
}
}
/**
* Title to show for the section
*
* @return String
*/
// public String getTitle() {
// if(stack == null || !stack.isDrawn()) {
// return getAttributeAsString("title");
// } else {
// return stack.getSection(getName()).getAttribute("title");
// }
// }
/**
* Sections default to the collapsed state unless {@link
* com.smartgwt.client.widgets.layout.SectionStackSection#getShowHeader showHeader} is set to <code>false</code> in which
* case they default to the expanded state. This attribute allows you to explicitly control the expand/collapse state of
* the section by overriding the above default behavior.
*
* @param expanded expanded Default value is false
*/
public void setExpanded(Boolean expanded) {
if(stack == null || !stack.isDrawn()) // {
setAttribute("expanded", expanded);
// } else {
// if(expanded) {
// stack.expandSection(getName());
// } else {
// stack.collapseSection(getName());
// }
// }
}
/**
* Sections default to the visible state. This attribute allows you to explicitly control the visible/hidden state of the
* section by overriding the above default behavior.
*
* @param hidden hidden Default value is false
*/
public void setHidden(Boolean hidden) {
if(stack == null || !stack.isDrawn()) //{
setAttribute("hidden", hidden);
// } else {
// if(hidden) {
// stack.hideSection(getName());
// } else {
// stack.showSection(getName());
// }
// }
}
// /**
// * List of Canvases that constitute the section. These Canvases will be shown and hidden together.
// *
// * @param items list of Canvases that constitute the section
// */
// public void setItems(Canvas... items) {
// for (Canvas item : items) {
// addItem(item);
// }
// }
// /**
// * Return the items in this SectionStackSection
// *
// * @return the items in this SectionStackSection
// */
// public native Canvas[] getItems() /*-{
// var jsObj = this.@com.smartgwt.client.core.DataClass::getJsObj()();
//
// if(!jsObj.items) {
// jsObj.items = @com.smartgwt.client.util.JSOHelper::createJavaScriptArray()();
// }
// return @com.smartgwt.client.widgets.Canvas::convertToCanvasArray(Lcom/google/gwt/core/client/JavaScriptObject;)(jsObj.items);
// }-*/;
// public void addItem(Canvas item) {
// addItemJS(item.getOrCreateJsObj());
// }
// private native void addItemJS(JavaScriptObject componentJS) /*-{
// var jsObj = this.@com.smartgwt.client.core.DataClass::getJsObj()();
//
// if(!jsObj.items) {
// jsObj.items = @com.smartgwt.client.util.JSOHelper::createJavaScriptArray()();
// }
// jsObj.items.push(componentJS);
// }-*/;
// /**
// * Custom controls to be shown on top of this section header.
// * @param controls
// */
// public void setControls(Canvas... controls) {
// setAttribute("controls", controls);
// }
//
// public native Canvas[] getControls () /*-{
// var jsObj = this.@com.smartgwt.client.core.DataClass::getJsObj()();
// if (jsObj.controls == null) return null;
// return @com.smartgwt.client.widgets.Canvas::convertToCanvasArray(Lcom/google/gwt/core/client/JavaScriptObject;)(jsObj.controls);
// }-*/;
/**
* Once a SectionStackSection has been applied to a SectionStack, this method may be used to return a pointer to the
* SectionStack in which this section header is embedded.
*
* @return the SectionStack in which this section is embedded
*/
protected SectionStack stack;
public SectionStack getSectionStack() {
return stack;
}
// /**
// * Once a SectionStackSection has been applied to a SectionStack, this method may be used to return a pointer to the
// * SectionHeader for this section
// * @return the SectionHeader for the section
// */
// public native SectionHeader getSectionHeader () /*-{
// var jsObj = this.@com.smartgwt.client.core.DataClass::getJsObj()();
// if (jsObj == null) return null;
//
// var sectionHeader = jsObj.getSectionHeader != null ? jsObj.getSectionHeader() : null;
// if (sectionHeader == null) return null;
//
// return @com.smartgwt.client.widgets.layout.SectionHeader::getOrCreateRef(Lcom/google/gwt/core/client/JavaScriptObject;)(sectionHeader);
// }-*/;
public void setIcon(String icon)
{
setAttribute("icon", icon);
}
//@formatter:on
private final ComponentPropertyPainter propertyPainter = new ComponentPropertyPainter(this);
private final ComponentList<Canvas> items = propertyPainter.addComponentList("items");
public SectionStackSection() {
}
public SectionStackSection(String title) {
setTitle(title);
}
/**
* Return the items in this SectionStackSection
*
* @return the items in this SectionStackSection
*/
public Canvas[] getItems() {
return items.toArray(new Canvas[0]);
}
/**
* List of Canvases that constitute the section. These Canvases will be shown and hidden together.
*
* @param items
* list of Canvases that constitute the section
*/
public void setItems(Canvas... items) {
for (Canvas item : items) {
addItem(item);
}
}
public void addItem(Canvas item) {
items.add(item);
}
@Override
public void paintContent(PaintTarget target) throws PaintException {
propertyPainter.paintContent(target);
super.paintContent(target);
}
}