com.jgeppert.struts2.jquery.components.Head Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package com.jgeppert.struts2.jquery.components;
import com.opensymphony.xwork2.inject.Inject;
import com.opensymphony.xwork2.util.ValueStack;
import org.apache.commons.lang.StringUtils;
import org.apache.struts2.StrutsConstants;
import org.apache.struts2.views.annotations.StrutsTag;
import org.apache.struts2.views.annotations.StrutsTagAttribute;
import org.apache.struts2.views.annotations.StrutsTagSkipInheritance;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Arrays;
/**
*
*
* The "head" tag renders required JavaScript code to configure jQuery and is
* required in order to use any of the tags included in the jQuery plugin.
*
*
*
*
* Some tags like the "datepicker" can use different locales, to use a locale
* that is different from the request locale.
*
*
* The "locale" attribute configures jQuery locale for datepicker. Default is
* "en" you can use all locales that are bundled with jQuery. e.g. "de, "fr", "
* ja", ...
*
*
*
* Examples
*
*
*
* <%@ taglib prefix="sj" uri="/struts-jquery-tags" %>
* <head>
* <title>My page</title>
* <sj:head/>
* </head>
*
*
*
*
* <%@ taglib prefix="sj" uri="/struts-jquery-tags" %>
* <head>
* <title>My page</title>
* <sj:head compressed="false" locale="de" jquerytheme="cupertino"/>
* </head>
*
*
*
* @author Johannes Geppert
*/
@StrutsTag(name = "head", tldBodyContent = "empty", tldTagClass = "com.jgeppert.struts2.jquery.views.jsp.ui.HeadTag", description = "Render a chunk of HEAD for your HTML file", allowDynamicAttributes = false)
@StrutsTagSkipInheritance
public class Head extends org.apache.struts2.components.Head {
public static final String TEMPLATE = "head";
private static final String[] timeLocals = {"af", "am", "bg", "ca", "cs", "de", "da", "el", "es", "et", "eu", "fa", "fi", "fr", "gl",
"he", "hr", "hu", "id", "it", "ja", "ko", "lt", "lv", "nl", "no", "pl", "pt", "pt-BR", "ro", "ru", "sk", "sl", "sq", "sr-RS", "sr-YU", "sv", "th",
"tr", "uk", "vi", "zh-CN", "zh-TW"};
private static final String[] gridLocals = {"ar", "bg", "ca", "cn", "cs", "de", "da", "dk", "el", "en", "es",
"en-GB", "fa", "fi", "fr", "fr-CH", "gl", "he", "hr", "hu", "id", "is", "it", "ja", "lt", "mne", "nl", "no",
"pl", "pt", "pt-BR", "ro", "ru", "sk", "sr", "sv", "th", "tr", "ua", "vi", "zh", "zh-CN", "zh-TW"};
private static final String[] jqueryLocals = {"af", "ar", "ar-DZ", "az", "be", "bg", "bs", "ca", "cs", "cy-GB",
"da", "de", "el", "en", "en-AU", "en-GB", "en-NZ", "eo", "es", "et", "eu", "fa", "fi", "fo", "fr", "fr-CA",
"fr-CH", "ge", "gl", "he", "hi", "hr", "hu", "hy", "id", "is", "it", "ja", "ka", "kk", "km", "ko", "kr",
"ky", "kz", "lt", "lb", "lv", "mk", "ml", "ms", "nb", "nl-BE", "nl", "nn", "no", "pl", "pt", "pt-BR", "rm",
"ro", "ru", "sk", "sl", "sq", "sr-SR", "sv", "ta", "th", "tj", "tr", "uk", "vi", "zh-CN", "zh-HK",
"zh-TW"};
private static final String[] datatablesLocals = {"af", "ar", "ar-DZ", "az", "be", "bg", "bn", "ca", "cs", "cy-GB",
"da", "de", "el", "en", "en-AU", "en-GB", "en-NZ", "es", "et", "eu", "fa", "fi", "fil", "fr", "fr-CA",
"fr-CH", "gl", "he", "hi", "hr", "hu", "hy", "id", "is", "it", "it-CH", "ja", "ka", "ko", "ky", "lt", "lv",
"mk", "mn", "ms", "nb", "nl-BE", "nl", "nn", "pl", "ps", "pt", "pt-BR", "ro", "ru", "si", "sk", "sl", "sq",
"sr", "sv", "sw", "ta", "te", "th", "tr", "uk", "ur", "uz", "vi", "zh-CN", "zh-TW"};
private static final String PARAM_JQUERY = "jquery";
private static final String PARAM_JQUERYUI = "jqueryui";
private static final String PARAM_COMPRESSED = "compressed";
private static final String PARAM_JQUERYTHEME = "jquerytheme";
private static final String PARAM_CUSTOM_BASEPATH = "customBasepath";
private static final String PARAM_LOAD_FROM_GOOGLE = "loadFromGoogle";
private static final String PARAM_AJAXCACHE = "ajaxcache";
private static final String PARAM_AJAXHISTORY = "ajaxhistory";
private static final String PARAM_DEFAULT_INDICATOR = "defaultIndicator";
private static final String PARAM_DEFAULT_LOADING_TEXT = "defaultLoadingText";
private static final String PARAM_DEFAULT_ERROR_TEXT = "defaultErrorText";
private static final String PARAM_LOAD_AT_ONCE = "loadAtOnce";
private static final String PARAM_DEBUG = "debug";
private static final String PARAM_SCRIPT_PATH = "scriptPath";
private static final String PARAM_GRID_LOCALE = "gridLocale";
private static final String PARAM_TIME_LOCALE = "timeLocale";
private static final String PARAM_JQUERY_LOCALE = "jqueryLocale";
private static final String PARAM_DATATABLES_LOCALE = "datatablesLocale";
protected String compressed;
protected String locale;
protected String jquery;
protected String jquerytheme;
protected String jqueryui;
protected String customBasepath;
protected String loadFromGoogle;
protected String ajaxcache;
protected String ajaxhistory;
protected String defaultIndicator;
protected String defaultLoadingText;
protected String defaultErrorText;
protected String loadAtOnce;
protected String debug;
protected String scriptPath;
private String defaultLocale;
public Head(ValueStack stack, HttpServletRequest request, HttpServletResponse response) {
super(stack, request, response);
}
@Override
protected String getDefaultTemplate() {
return TEMPLATE;
}
@Override
public void evaluateParams() {
super.evaluateParams();
if (this.jquery != null) {
addParameter(PARAM_JQUERY, findValue(this.jquery, Boolean.class));
}
if (this.jqueryui != null) {
addParameter(PARAM_JQUERYUI, findValue(this.jqueryui, Boolean.class));
}
if (this.compressed != null) {
addParameter(PARAM_COMPRESSED, findValue(this.compressed, Boolean.class));
}
if (this.jquerytheme != null) {
addParameter(PARAM_JQUERYTHEME, findString(this.jquerytheme));
}
if (this.customBasepath != null) {
addParameter(PARAM_CUSTOM_BASEPATH, findString(this.customBasepath));
}
if (this.loadFromGoogle != null) {
addParameter(PARAM_LOAD_FROM_GOOGLE, findValue(this.loadFromGoogle, Boolean.class));
}
if (this.ajaxcache != null) {
addParameter(PARAM_AJAXCACHE, findValue(this.ajaxcache, Boolean.class));
}
if (this.ajaxhistory != null) {
addParameter(PARAM_AJAXHISTORY, findValue(this.ajaxhistory, Boolean.class));
}
if (this.defaultIndicator != null) {
addParameter(PARAM_DEFAULT_INDICATOR, findString(this.defaultIndicator));
}
if (this.defaultLoadingText != null) {
addParameter(PARAM_DEFAULT_LOADING_TEXT, findString(this.defaultLoadingText));
}
if (this.defaultErrorText != null) {
addParameter(PARAM_DEFAULT_ERROR_TEXT, findString(this.defaultErrorText));
}
if (this.loadAtOnce != null) {
addParameter(PARAM_LOAD_AT_ONCE, findValue(this.loadAtOnce, Boolean.class));
}
if (this.debug != null) {
addParameter(PARAM_DEBUG, findValue(this.debug, Boolean.class));
}
if (this.scriptPath != null) {
addParameter(PARAM_SCRIPT_PATH, findString(this.scriptPath));
}
String loc = null;
if (this.locale != null) {
loc = StringUtils.replace(findString(this.locale), "_", "-");
} else if (defaultLocale != null) {
loc = StringUtils.replace(defaultLocale, "_", "-");
}
if (loc != null) {
addParameter(PARAM_GRID_LOCALE, validateLocal(gridLocals, loc));
addParameter(PARAM_TIME_LOCALE, validateLocal(timeLocals, loc));
addParameter(PARAM_JQUERY_LOCALE, validateLocal(jqueryLocals, loc));
addParameter(PARAM_DATATABLES_LOCALE, validateLocal(datatablesLocals, loc));
}
}
@Inject(value = StrutsConstants.STRUTS_LOCALE, required = false)
public void setDefaultLocale(String val) {
defaultLocale = val;
}
@Override
@StrutsTagSkipInheritance
public void setTheme(String theme) {
super.setTheme(theme);
}
@Override
public String getTheme() {
return "jquery";
}
@StrutsTagAttribute(description = "Include jQuery Script", defaultValue = "true", type = "Boolean")
public void setJquery(String jquery) {
this.jquery = jquery;
}
public boolean isJqueryui() {
return jqueryui != null && Boolean.parseBoolean(jqueryui);
}
@StrutsTagAttribute(description = "enable jQuery UI Scripts", defaultValue = "true", type = "Boolean")
public void setJqueryui(String jqueryui) {
this.jqueryui = jqueryui;
}
@StrutsTagAttribute(description = "use compressed version of jquery and jquery-ui", defaultValue = "true", type = "Boolean")
public void setCompressed(String compressed) {
this.compressed = compressed;
}
@StrutsTagAttribute(description = "jQuery UI theme", defaultValue = "smoothness")
public void setJquerytheme(String jquerytheme) {
this.jquerytheme = jquerytheme;
}
@StrutsTagAttribute(description = "import jQuery i18n scripts.", defaultValue = "en or struts.local value")
public void setLocale(String locale) {
this.locale = locale;
}
@StrutsTagAttribute(description = "base path for custom jQuery designs")
public void setCustomBasepath(String customBasepath) {
this.customBasepath = customBasepath;
}
@StrutsTagAttribute(description = "Load JavaScript from google content distribution network", defaultValue = "false", type = "Boolean")
public void setLoadFromGoogle(String loadFromGoogle) {
this.loadFromGoogle = loadFromGoogle;
}
@StrutsTagAttribute(description = "If set to false it will force the pages that you request to not be cached by the browser.", defaultValue = "false", type = "Boolean")
public void setAjaxcache(String ajaxcache) {
this.ajaxcache = ajaxcache;
}
@StrutsTagAttribute(description = "If set to true it will enable history and bookmarking for AJAX content and jQuery UI Tabs.", defaultValue = "false", type = "Boolean")
public void setAjaxhistory(String ajaxhistory) {
this.ajaxhistory = ajaxhistory;
}
@StrutsTagAttribute(description = "The default indicator for all AJAX actions")
public void setDefaultIndicator(String defaultIndicator) {
this.defaultIndicator = defaultIndicator;
}
@StrutsTagAttribute(description = "The default loading text for all AJAX actions")
public void setDefaultLoadingText(String defaultLoadingText) {
this.defaultLoadingText = defaultLoadingText;
}
@StrutsTagAttribute(description = "The default error text for all AJAX actions")
public void setDefaultErrorText(String defaultErrorText) {
this.defaultErrorText = defaultErrorText;
}
@StrutsTagAttribute(description = "do not use the on demand load for jquery ui resources", defaultValue = "false", type = "Boolean")
public void setLoadAtOnce(String loadAtOnce) {
this.loadAtOnce = loadAtOnce;
}
private static String validateLocal(String[] locals, String local) {
String retString = "en";
// Array must be sorted for binarySearch
Arrays.sort(locals);
if (Arrays.binarySearch(locals, local) > -1) {
retString = local;
} else if (local.length() > 2 && Arrays.binarySearch(locals, local.substring(0, 2)) > -1) {
retString = local.substring(0, 2);
}
return retString;
}
@StrutsTagAttribute(description = "enable debug logging", defaultValue = "false", type = "Boolean")
public void setDebug(String debug) {
this.debug = debug;
}
@StrutsTagAttribute(description = "path to the JavaScript ressources", defaultValue = "#your context root#/struts/")
public void setScriptPath(String scriptPath) {
this.scriptPath = scriptPath;
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy