JavaScript and CSS support
(You might want to check out Adding Javascript or CSS using a Resource also.)
Overview
There are two ways of adding CSS/JavaScript support to a Wicket page. The first is by using the <wicket:head> section, while the other is by simply providing a link to a CSS/JavaScript page.
...
In general terms, when you create a panel and want to contribute something to the page head, you would use this type of structure:
Code Block | ||
---|---|---|
| ||
| ||
<wicket:head>panel header</wicket:head> <wicket:panel> panel panel </wicket:panel> |
So, assuming that your page output looks something like this:
Code Block | ||
---|---|---|
| ||
| ||
<html> <body> ... </body> </html>
<html>
<body>
...
</body>
</html>
|
The output generated, including the contribution to head made by the panel above, will look something like:
Code Block | ||
---|---|---|
| ||
| ||
<html><html> <head><wicket:head>panel header</wicket:head></head> <body> <span <body> <span wicket:id="panel"><wicket:panel> panel panel </wicket:panel></span> </body> </html> |
Panel |
---|
Note: since the head of a "normal" page is automatically |
...
If we are able to use the <wicket:head> section above to contribute to the page model, then we can certainly use it to reference a CSS resource!
First, the html:
Code Block | ||||
---|---|---|---|---|
| ||||
<html>
<wicket:head>
<link | ||||
Panel | ||||
<html> <wicket:head> <link wicket:id="mycss" rel="Stylesheet" type="text/css" href="styles/main.css"/> </wicket:head> <wicket:panel> panel panel </wicket:panel> </html> |
And now, the java:
Panelcode |
---|
import wicket.markup.html.WebMarkupContainer; ...WebMarkupContainer css = new WebMarkupContainer( WebMarkupContainer css = new WebMarkupContainer( "mycss" ); add( css ); |
That's it!
Customizing CSS output based on some parameters
You can customize CSS output based on various parameters, such as local, browser agent, etc. The easiest way is to use an anonymous class as follows.
In your html:
Code Block | ||
---|---|---|
| ||
| ||
<link wicket:id="mycss" rel="Stylesheet" type="text/css" href="styles/main.css"/> |
In your java:
Panel |
---|
Code Block |
import wicket.markup.html.WebComponent;
import wicket.model.IModel;
import wicket.model.Model;
import wicket.AttributeModifier;
import wicket.Component;
...
WebComponent c = new WebComponent( "mycss" );
IModel model = new Model()
{
public Object getObject( Component c )
{
if ( someConditionIsTrue )
return "stylesheetx.css";
else
return "stylesheety.css";
}
};
c.add( new AttributeModifier( "href", model ) );
add( c );
|
A word of caution about the <body> tag
There is one more thing to mention. The onLoad attribute of <body> is sometimes used to initialize certain functionality. E.g.
Code Block | ||||
---|---|---|---|---|
Panel | ||||
| ||||
<wicket:head>panel header</wicket:head> <body onload="function()"> <wicket:panel> panel panel </wicket:panel> </body> |
Wicket will not only inject the <wicket:head> region into the output, it will also (anymore) append the <body> onLoad attribute to the Page's onLoad attribute. The output generated may look like:
Panel |
---|
<html xmlns:wicket> |
To append javascript to the onLoad, have your component implement IHeaderContributor and add it there.
Linking directly to a CSS page
...
To the CSS file(s), insert something like this in your markup:
Code Block | ||||
---|---|---|---|---|
| ||||
<link | ||||
Panel | ||||
<link wicket:id="pageCSS" rel="Stylesheet" type="text/css" href="css/page.css"/> |
and this in your Page Java file for Wicket 1.1:
Panelcode |
---|
WebMarkupContainer pageCSS = new WebMarkupContainer("pageCSS"); add(pageCSS); PackageResourceReference pageCSSResource = new PackageResourceReference(getClass(), "css/page.css"); pageCSS.add(new AttributeModifier("href", false, new Model(urlFor(pageCSSResource.getPath())))); |
or this for Wicket 1.2:
Panelcode |
---|
add(new StyleSheetReference("pageCSS", getClass(), "css/page.css")); |