Customize Look and Feel of ZK Components Using CSS3"

From Documentation
Line 47: Line 47:
  
 
</source>
 
</source>
: To view the full source code of button.css.dsp please click [[Media:button.css.zip]].
+
: To view the full source code of button.css.dsp please click [[File:button.css.zip]].
  
 
<li>Create button-css3sample.zul file to test<ref name="ftn41">Test with different browsers (FF, Chrome, IE 9 etc.) that supports CSS3 and check the ZUL file created above [[Image:project_css3.jpg]]</ref></li>
 
<li>Create button-css3sample.zul file to test<ref name="ftn41">Test with different browsers (FF, Chrome, IE 9 etc.) that supports CSS3 and check the ZUL file created above [[Image:project_css3.jpg]]</ref></li>

Revision as of 08:07, 29 November 2011

DocumentationSmall Talks2011DecemberCustomize Look and Feel of ZK Components Using CSS3
Customize Look and Feel of ZK Components Using CSS3

Author
Vincent Jian, Engineer, Potix Corporation
Date
December 04, 2011
Version
ZK5+

Introduction: ZK & CSS3

This article will guide users through customizing the look and feel of a ZK component using CSS3 and DSP[1] and some EL expression used in DSP. Two case examples – the button component & the window component will be demonstrated to show the process and implementation.

Case Examples

Button Component

  1. Re-design from original styles
  2. Default button component provides trendy and os mold. Here we use os mold to modify since it is much easier than trendy mold.
  3. Create “button.css.dsp” file in web application
  4. In line 1, we define prefix “c” in order to use EL expression. Because not all browsers support CSS3, we use “<c:if>” tag in line 2 to determine whether or not we override the origin CSS class or not.
    <%@ taglib uri="http://www.zkoss.org/dsp/web/core" prefix="c" %>
    <c:if test="${c:browser('gecko2') || c:browser('ie9') || c:browser('opera') || c:browser('safari')}">
    .z-button-os {
    	color: #FFFFFF;
    	font-weight: bold;
    	text-shadow: 0 -1px 0 rgba(0,0,0,1), 0 0 0 rgba(252,0,21,0);
    	padding: 7px 17px;
    	border: 1px solid #000000;
    	border-radius: 3px;
    	-moz-border-radius: 3px;
    	-webkit-border-radius: 3px;
    	/* IE9 SVG, needs conditional override of 'filter' to 'none' */
    	background: url(data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiA/Pgo8c3ZnIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgdmlld0JveD0iMCAwIDEgMSIgcHJlc2VydmVBc3BlY3RSYXRpbz0ibm9uZSI+CiAgPGxpbmVhckdyYWRpZW50IGlkPSJncmFkLXVjZ2ctZ2VuZXJhdGVkIiBncmFkaWVudFVuaXRzPSJ1c2VyU3BhY2VPblVzZSIgeDE9IjAlIiB5MT0iMCUiIHgyPSIwJSIgeTI9IjEwMCUiPgogICAgPHN0b3Agb2Zmc2V0PSIwJSIgc3RvcC1jb2xvcj0iIzJlMmUyZSIgc3RvcC1vcGFjaXR5PSIxIi8+CiAgICA8c3RvcCBvZmZzZXQ9IjEwMCUiIHN0b3AtY29sb3I9IiMwMzAzMDMiIHN0b3Atb3BhY2l0eT0iMSIvPgogIDwvbGluZWFyR3JhZGllbnQ+CiAgPHJlY3QgeD0iMCIgeT0iMCIgd2lkdGg9IjEiIGhlaWdodD0iMSIgZmlsbD0idXJsKCNncmFkLXVjZ2ctZ2VuZXJhdGVkKSIgLz4KPC9zdmc+);
    	background: -moz-linear-gradient(top, rgba(46,46,46,1) 0%, rgba(3,3,3,1) 100%); /* FF3.6+ */
    	background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,rgba(46,46,46,1)), color-stop(100%,rgba(3,3,3,1))); /* Chrome,Safari4+ */
    	background: -webkit-linear-gradient(top, rgba(46,46,46,1) 0%,rgba(3,3,3,1) 100%); /* Chrome10+,Safari5.1+ */
    	background: -o-linear-gradient(top, rgba(46,46,46,1) 0%,rgba(3,3,3,1) 100%); /* Opera 11.10+ */
    	background: -ms-linear-gradient(top, rgba(46,46,46,1) 0%,rgba(3,3,3,1) 100%); /* IE10+ */
    	background: linear-gradient(top, rgba(46,46,46,1) 0%,rgba(3,3,3,1) 100%); /* W3C */
    	filter: none\0/;
    	box-shadow: 0 3px 0 rgba(0,0,0,1), inset 0 0 1px rgba(255,255,255,0.6);
    	-moz-box-shadow: 0 3px 0 rgba(0,0,0,1), inset 0 0 1px rgba(255,255,255,0.6);
    	-webkit-box-shadow: 0 3px 0 rgba(0,0,0,1), inset 0 0 1px rgba(255,255,255,0.6);
    	cursor: pointer;
    }
    </c:if>
    
    To view the full source code of button.css.dsp please click File:Button.css.zip.
  5. Create button-css3sample.zul file to test[2]
  6. In line 1, we use “<?link ?>” directive to include “button.css.dsp” file.
    <?link rel="stylesheet" type="text/css" href="css/button.css.dsp"?>
    <zk>
    	<button label="os mold" mold="os" width="200px" height="50px" />
    </zk>
    
  7. Visit http://localhost:8080/projectName/button-css3sample.zul to show result and keep tweaking the style until you are satisfied with it.
  8. normal button mouse over the button button pressed disabled button

Window Component

  1. Re-design from original styles
  2. Default window component consists of four parts (top, head, content and bottom, for more details, please refer to Window Style). The top and bottom part are only used for rounded corners. Therefore, we can set width and height of the top and bottom part to zero, and still keep the DOM structure.
  3. Create “window.css.dsp” file
  4. a) Include DSP taglib and define prefix “c” in order to use EL expression.
    <%@ taglib uri="http://www.zkoss.org/dsp/web/core" prefix="c" %>
    
    b) Determine whether to override origin CSS class by browser type.
    <c:if test="${c:browser('gecko2') || c:browser('ie9') || c:browser('opera') || c:browser('safari')}">
    <%-- override css --%>
    ...
    </c:if>
    
    c) Adjust top part CSS classes, make the height to 0 and add to head part.
     
    .z-window-embedded-tl,
    .z-window-embedded-tr {
    	height: 0px;
    	background-image: none;
    }
    .z-window-embedded-hl {
    	background: none;
    	background: #5eeeff; /* Old browsers */
    	/* IE9 SVG, needs conditional override of 'filter' to 'none' */
    	background: url(data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiA/Pgo8c3ZnIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgdmlld0JveD0iMCAwIDEgMSIgcHJlc2VydmVBc3BlY3RSYXRpbz0ibm9uZSI+CiAgPGxpbmVhckdyYWRpZW50IGlkPSJncmFkLXVjZ2ctZ2VuZXJhdGVkIiBncmFkaWVudFVuaXRzPSJ1c2VyU3BhY2VPblVzZSIgeDE9IjAlIiB5MT0iMCUiIHgyPSIxMDAlIiB5Mj0iMCUiPgogICAgPHN0b3Agb2Zmc2V0PSIwJSIgc3RvcC1jb2xvcj0iIzVlZWVmZiIgc3RvcC1vcGFjaXR5PSIxIi8+CiAgICA8c3RvcCBvZmZzZXQ9IjEwMCUiIHN0b3AtY29sb3I9IiNjNGZmMDUiIHN0b3Atb3BhY2l0eT0iMSIvPgogIDwvbGluZWFyR3JhZGllbnQ+CiAgPHJlY3QgeD0iMCIgeT0iMCIgd2lkdGg9IjEiIGhlaWdodD0iMSIgZmlsbD0idXJsKCNncmFkLXVjZ2ctZ2VuZXJhdGVkKSIgLz4KPC9zdmc+) no-repeat;
    	background: -moz-linear-gradient(left, #5eeeff 0%, #c4ff05 100%); /* FF3.6+ */
    	background: -webkit-gradient(linear, left top, right top, color-stop(0%,#5eeeff), color-stop(100%,#c4ff05)); /* Chrome,Safari4+ */
    	background: -webkit-linear-gradient(left, #5eeeff 0%,#c4ff05 100%); /* Chrome10+,Safari5.1+ */
    	background: -o-linear-gradient(left, #5eeeff 0%,#c4ff05 100%); /* Opera 11.10+ */
    	background: -ms-linear-gradient(left, #5eeeff 0%,#c4ff05 100%); /* IE10+ */
    	background: linear-gradient(left, #5eeeff 0%,#c4ff05 100%); /* W3C */
    	filter: none\0/; /*IE9 hack*/
    	border: 1px solid rgba(17, 17, 17, 0.4);
    	border-bottom: 0px;
    	border-radius: 5px 5px 0 0;
    	-moz-border-radius: 5px 5px 0 0;
    	-webkit-border-radius: 5px 5px 0 0;
    	padding-left: 0;
    }
    .z-window-embedded-hr {
    	background: none;
    	border-top: 1px solid #FFFFFF;
    	border-radius: 5px 5px 0 0;
    	-moz-border-radius: 5px 5px 0 0;
    	-webkit-border-radius: 5px 5px 0 0;
    	padding-right: 0px;
    }
    .z-window-embedded-hm {
    	background: none;
    	padding: 5px 6px;
    }
    .z-window-embedded-header {
    	overflow: hidden;
    	color: #363636;
    	padding: 0 0 2px;
    	cursor: default;
    	overflow: hidden;
    }
    
    d) The close, maximize and minimize icons in head part still need image. However we can use transparent image and gradient background at the same time due to CSS spec.

    Wnd-icon.jpg

    .z-window-embedded-icon {
        height: 14px;
        width: 26px;
        border: 1px solid #363636;
    	-webkit-border-radius: 5px;
    	-moz-border-radius: 5px;
    	border-radius: 5px;
    }
    .z-window-embedded-close {
    	background: url('../img/wnd-icon.png') no-repeat scroll -1px -52px, #ddf1f9; /* Old browsers */
    	/* IE9 SVG, needs conditional override of 'filter' to 'none' */
    	background: url('../img/wnd-icon.png') no-repeat scroll -1px -52px, url(data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiA/Pgo8c3ZnIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgdmlld0JveD0iMCAwIDEgMSIgcHJlc2VydmVBc3BlY3RSYXRpbz0ibm9uZSI+CiAgPHJhZGlhbEdyYWRpZW50IGlkPSJncmFkLXVjZ2ctZ2VuZXJhdGVkIiBncmFkaWVudFVuaXRzPSJ1c2VyU3BhY2VPblVzZSIgY3g9IjUwJSIgY3k9IjUwJSIgcj0iNzUlIj4KICAgIDxzdG9wIG9mZnNldD0iMCUiIHN0b3AtY29sb3I9IiNkZGYxZjkiIHN0b3Atb3BhY2l0eT0iMSIvPgogICAgPHN0b3Agb2Zmc2V0PSIxMDAlIiBzdG9wLWNvbG9yPSIjZmVmZmZmIiBzdG9wLW9wYWNpdHk9IjEiLz4KICA8L3JhZGlhbEdyYWRpZW50PgogIDxyZWN0IHg9Ii01MCIgeT0iLTUwIiB3aWR0aD0iMTAxIiBoZWlnaHQ9IjEwMSIgZmlsbD0idXJsKCNncmFkLXVjZ2ctZ2VuZXJhdGVkKSIgLz4KPC9zdmc+) no-repeat;
    	background: url('../img/wnd-icon.png') no-repeat scroll -1px -52px, -moz-radial-gradient(center, ellipse cover, #ddf1f9 0%, #feffff 100%); /* FF3.6+ */
    	background: url('../img/wnd-icon.png') no-repeat scroll -1px -52px, -webkit-gradient(radial, center center, 0px, center center, 100%, color-stop(0%,#ddf1f9), color-stop(100%,#feffff)); /* Chrome,Safari4+ */
    	background: url('../img/wnd-icon.png') no-repeat scroll -1px -52px, -webkit-radial-gradient(center, ellipse cover, #ddf1f9 0%, #feffff 100%); /* Chrome10+,Safari5.1+ */
    	background: url('../img/wnd-icon.png') no-repeat scroll -1px -52px, -o-radial-gradient(center, ellipse cover, #ddf1f9 0%, #feffff 100%); /* Opera 12+ */
    	background: url('../img/wnd-icon.png') no-repeat scroll -1px -52px, -ms-radial-gradient(center, ellipse cover, #ddf1f9 0%, #feffff 100%); /* IE10+ */
    	background: url('../img/wnd-icon.png') no-repeat scroll -1px -52px, radial-gradient(center, ellipse cover, #ddf1f9 0%, #feffff 100%); /* W3C */
    	filter: none\0/; /*IE9 hack*/
    }
    
    e) Adjust bottom part CSS classes, make the height to 0 and add to content part.
    .z-window-embedded-bl,
    .z-window-embedded-br {
    	height: 0px; 
    	background: none;
    }
    .z-window-embedded-cl {
    	background: none;
    	background: #5eeeff; /* Old browsers */
    	/* IE9 SVG, needs conditional override of 'filter' to 'none' */
    	background: url(data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiA/Pgo8c3ZnIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgdmlld0JveD0iMCAwIDEgMSIgcHJlc2VydmVBc3BlY3RSYXRpbz0ibm9uZSI+CiAgPGxpbmVhckdyYWRpZW50IGlkPSJncmFkLXVjZ2ctZ2VuZXJhdGVkIiBncmFkaWVudFVuaXRzPSJ1c2VyU3BhY2VPblVzZSIgeDE9IjAlIiB5MT0iMCUiIHgyPSIxMDAlIiB5Mj0iMCUiPgogICAgPHN0b3Agb2Zmc2V0PSIwJSIgc3RvcC1jb2xvcj0iIzVlZWVmZiIgc3RvcC1vcGFjaXR5PSIxIi8+CiAgICA8c3RvcCBvZmZzZXQ9IjEwMCUiIHN0b3AtY29sb3I9IiNjNGZmMDUiIHN0b3Atb3BhY2l0eT0iMSIvPgogIDwvbGluZWFyR3JhZGllbnQ+CiAgPHJlY3QgeD0iMCIgeT0iMCIgd2lkdGg9IjEiIGhlaWdodD0iMSIgZmlsbD0idXJsKCNncmFkLXVjZ2ctZ2VuZXJhdGVkKSIgLz4KPC9zdmc+) no-repeat;
    	background: -moz-linear-gradient(left,  #5eeeff 0%, #c4ff05 100%); /* FF3.6+ */
    	background: -webkit-gradient(linear, left top, right top, color-stop(0%,#5eeeff), color-stop(100%,#c4ff05)); /* Chrome,Safari4+ */
    	background: -webkit-linear-gradient(left,  #5eeeff 0%,#c4ff05 100%); /* Chrome10+,Safari5.1+ */
    	background: -o-linear-gradient(left,  #5eeeff 0%,#c4ff05 100%); /* Opera 11.10+ */
    	background: -ms-linear-gradient(left,  #5eeeff 0%,#c4ff05 100%); /* IE10+ */
    	background: linear-gradient(left,  #5eeeff 0%,#c4ff05 100%); /* W3C */
    	filter: none\0/; /*IE9 hack*/
    	border: 1px solid rgba(17, 17, 17, 0.4);
    	border-top: 0px;
    	border-radius: 0 0 5px 5px;
    	-moz-border-radius: 0 0 5px 5px;
    	-webkit-border-radius: 0 0 5px 5px;
    	padding-left: 0;
    }
    .z-window-embedded-cr {
    	background: none;
    	border-bottom: 1px solid #FFFFFF;
    	border-radius: 0 0 5px 5px;
    	-moz-border-radius: 0 0 5px 5px;
    	-webkit-border-radius: 0 0 5px 5px;
    	padding-right: 0px;
    }
    .z-window-embedded-cm {
    	background: none;
    	border: none;
    	padding: 0 6px 5px;
    	margin: 0;
    }
    .z-window-embedded-cnt {
    	border: 1px solid #CCCCCC;
    	background-color: #FFFFFF;
    	margin: 0;
    	padding: 4px;
    	overflow: hidden;
    }
    
    To view the full source code of window.css.dsp please click here.
  5. Create window-css3sample.zul file to test[2]
  6. <?link rel="stylesheet" type="text/css" href="css/window.css.dsp"?>
    <?link rel="stylesheet" type="text/css" href="css/button.css.dsp"?>
    <zk>
    	<window id="win" title="Hello World!!" width="300px" border="normal" minimizable="true" maximizable="true" closable="true">
    		<vlayout>
    			<label id="lbl" value="CSS3 Window" />
    			<button label="os mold" mold="os" />
    		</vlayout>
    	</window>
    </zk>
    
  7. Visit http://localhost:8080/projectName/window-css3sample.zul to show result and keep tweaking the style until you are satisfied with it Window css3.jpg

Conclusion

This customization method improves client side performance as it avoids the necessity to load huge amounts of images while the look and feel of a component can be tweaked at will. However, note that in order to prevent component failure due to customization, it is suggested not to change any DOM structure of a component.

References



  1. A JSP-like template technology, for more detail please refer to here
  2. 2.0 2.1 Test with different browsers (FF, Chrome, IE 9 etc.) that supports CSS3 and check the ZUL file created above Project css3.jpg



Comments



Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.