|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.zkoss.zk.ui.AbstractComponent
org.zkoss.zul.Style
public class Style
The style component used to specify CSS styles for the owner desktop.
Note: a style component can appear anywhere in a ZUML page, but it affects all components in the same desktop.
There are two formats when used in a ZUML page:
Method 1: Specify the URL of the CSS file
<style src="my.css"/>
Method 2: Specify the CSS directly
<style>
.mycls {
border: 1px outset #777;
}
</style>
Note: if the src and content properties are both set, the later one overrides the previous one.
Nested Class Summary | |
---|---|
protected class |
Style.ExtraCtrl
A utility class to implement AbstractComponent.getExtraCtrl() . |
Nested classes/interfaces inherited from class org.zkoss.zk.ui.AbstractComponent |
---|
AbstractComponent.Children |
Field Summary |
---|
Fields inherited from class org.zkoss.zk.ui.AbstractComponent |
---|
_visible |
Fields inherited from interface org.zkoss.zk.ui.Component |
---|
APPLICATION_SCOPE, COMPONENT_SCOPE, DESKTOP_SCOPE, PAGE_SCOPE, REQUEST_SCOPE, SESSION_SCOPE, SPACE_SCOPE |
Fields inherited from interface org.zkoss.zk.ui.sys.ComponentCtrl |
---|
CE_BUSY_IGNORE, CE_DUPLICATE_IGNORE, CE_IMPORTANT, CE_NON_DEFERRABLE, CE_REPEAT_IGNORE |
Constructor Summary | |
---|---|
Style()
|
|
Style(java.lang.String src)
|
Method Summary | |
---|---|
java.lang.String |
getContent()
Returns the content of the style element. |
java.lang.String |
getSrc()
Returns the URI of an external style sheet. |
protected boolean |
isChildable()
Not childable. |
boolean |
isDynamic()
Deprecated. As of release 5.0.0, it is decided automatically. |
protected java.lang.Object |
newExtraCtrl()
Used by AbstractComponent.getExtraCtrl() to create extra controls. |
protected void |
renderProperties(ContentRenderer renderer)
Called by ( ComponentCtrl.redraw(java.io.Writer) ) to render the
properties, excluding the enclosing tag and children. |
void |
setContent(java.lang.String content)
Sets the content of the style element. |
void |
setDynamic(boolean dynamic)
Deprecated. As of release 5.0.0, it is decided automatically. |
void |
setSrc(java.lang.String src)
Sets the URI of an external style sheet. |
boolean |
setVisible(boolean visible)
Not allowd. |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public Style()
public Style(java.lang.String src)
src
- the URI of an external style sheet.Method Detail |
---|
public void setDynamic(boolean dynamic)
Style
Default: false.
setDynamic
in interface Style
Style.isDynamic()
public boolean isDynamic()
Style
Due to IE's limitation, there is no effect if the style component is
added or removed dynamically and if Style.isDynamic()
is false.
If Style.isDynamic()
is true, this component can be added and removed
dynamically and the rules will be attached and detached accordingly.
Note: in this case, the HTML LINK tag is generated when this component is
initialized at the client, so the style will be loaded to the client
after all components are initialized.
Default: false.
isDynamic
in interface Style
public java.lang.String getSrc()
Default: null.
getSrc
in interface Style
public void setSrc(java.lang.String src)
Calling this method implies setContent(null).
In other words, the last invocation of setSrc(java.lang.String)
overrides
the previous setContent(java.lang.String)
, if any.
setSrc
in interface Style
src
- the URI of an external style sheetsetContent(java.lang.String)
public java.lang.String getContent()
Default: null.
Deriving class can override this method to return whatever it prefers (ignored if null).
getContent
in interface Style
public void setContent(java.lang.String content)
Calling this method implies setSrc(null).
In other words, the last invocation of setContent(java.lang.String)
overrides
the previous setSrc(java.lang.String)
, if any.
setContent
in interface Style
setSrc(java.lang.String)
protected void renderProperties(ContentRenderer renderer) throws java.io.IOException
AbstractComponent
ComponentCtrl.redraw(java.io.Writer)
) to render the
properties, excluding the enclosing tag and children.
Default: it renders AbstractComponent.getId()
if it was assigned,
and event names if listened (and listed in AbstractComponent.getClientEvents()
).
Note: it doesn't render AbstractComponent.getWidgetClass()
, AbstractComponent.getUuid()
and AbstractComponent.getMold()
, which are caller's job.
renderProperties
in class AbstractComponent
java.io.IOException
public boolean setVisible(boolean visible)
setVisible
in interface Component
setVisible
in class AbstractComponent
protected boolean isChildable()
isChildable
in class AbstractComponent
protected java.lang.Object newExtraCtrl()
AbstractComponent
AbstractComponent.getExtraCtrl()
to create extra controls.
It is used only by component developers.
Default: return null.
To provide extra controls, it is simpler to override this method
instead of AbstractComponent.getExtraCtrl()
.
By use of AbstractComponent.newExtraCtrl()
, you don't need to care of
cloning and serialization.
newExtraCtrl
in class AbstractComponent
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |