|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.wicket.behavior.Behavior org.apache.wicket.extensions.yui.calendar.DatePicker
public class DatePicker
Pops up a YUI calendar component so that the user can select a date. On selection, the date is
set in the component it is coupled to, after which the popup is closed again. This behavior can
only be used with components that either implement AbstractTextComponent.ITextFormatProvider
or that use
DateConverter
configured with an instance of SimpleDateFormat
(like Wicket's
default configuration has).
To use, simply add a new instance to your component, which would typically a TextField, like
DateTextField
.
The CalendarNavigator can be configured by overriding #configure(Map)
and setting the
property or by returning true
for enableMonthYearSelection()
.
Field Summary | |
---|---|
static java.lang.String |
FORMAT_DATE
Format to be used when configuring YUI calendar. |
static java.lang.String |
FORMAT_PAGEDATE
For specifying which page (month/year) to show in the calendar, use this format for the date. |
Constructor Summary | |
---|---|
DatePicker()
Construct. |
Method Summary | |
---|---|
void |
afterRender(Component component)
Called when a component that has this behavior coupled was rendered. |
protected boolean |
alignWithIcon()
Whether to position the date picker relative to the trigger icon. |
protected boolean |
autoHide()
Indicates whether the calendar should be hidden when the user clicks on an area of the document outside of the dialog. |
void |
bind(Component component)
Bind this handler to the given component. |
protected void |
configure(java.util.Map<java.lang.String,java.lang.Object> widgetProperties,
IHeaderResponse response,
java.util.Map<java.lang.String,java.lang.Object> initVariables)
Gives overriding classes the option of adding (or even changing/ removing) configuration properties for the javascript widget. |
protected boolean |
enableMonthYearSelection()
Indicates whether plain text is rendered or two select boxes are used to allow direct selection of month and year. |
protected java.lang.String[] |
filterEmpty(java.lang.String[] stringArray)
Filter all empty elements (workaround for DateFormatSymbols returning arrays with
empty elements). |
protected java.lang.String |
getAdditionalJavaScript()
Override this method to further customize the YUI Calendar with additional JavaScript code. |
protected java.lang.String |
getComponentMarkupId()
Gets the id of the component that the calendar widget will get attached to. |
protected java.lang.String |
getDatePattern()
Gets the date pattern to use for putting selected values in the coupled component. |
protected java.lang.String |
getEscapedComponentMarkupId()
Gets the escaped DOM id that the calendar widget will get attached to. |
protected java.lang.CharSequence |
getIconAltText()
Gets the icon alt text for the datepicker icon |
protected java.lang.String |
getIconId()
Gets the id of the icon that triggers the popup. |
protected java.lang.String |
getIconStyle()
Gets the style of the icon that triggers the popup. |
protected java.lang.CharSequence |
getIconTitle()
Gets the title attribute of the datepicker icon |
protected java.lang.CharSequence |
getIconUrl()
Gets the url for the popup button. |
protected java.util.Locale |
getLocale()
Gets the locale that should be used to configure this widget. |
protected boolean |
hideOnSelect()
Indicates whether the calendar should be hidden after a date was selected. |
protected boolean |
includeYUILibraries()
Controls whether or not datepicker will contribute YUI libraries to the page as part of its rendering lifecycle. |
boolean |
isEnabled(Component component)
Called when a components is rendering and wants to render this behavior. |
protected void |
localize(java.util.Map<java.lang.String,java.lang.Object> widgetProperties,
IHeaderResponse response,
java.util.Map<java.lang.String,java.lang.Object> initVariables)
Configure the localized strings for the datepicker widget. |
protected boolean |
notifyComponentOnDateSelected()
Whether to notify the associated component when a date is selected. |
void |
renderHead(Component component,
IHeaderResponse response)
Render to the web response whatever the component wants to contribute to the head section. |
protected void |
renderHeadInit(IHeaderResponse response)
Renders yui & wicket calendar js module loading. |
protected boolean |
renderOnLoad()
Indicates whether the calendar should be rendered after it has been loaded. |
DatePicker |
setAutoHide(boolean autoHide)
|
DatePicker |
setShowOnFieldClick(boolean show)
|
protected boolean |
showOnFieldClick()
Indicates whether the calendar should be shown when corresponding text input is clicked. |
protected java.lang.String[] |
substring(java.lang.String[] array,
int len)
Makes a copy of the provided array and for each element copy the substring 0..len to the new array |
protected java.lang.String[] |
substring(java.lang.String[] array,
int start,
int len)
Makes a copy of the provided array and for each element copy the substring 0..len to the new array |
Methods inherited from class org.apache.wicket.behavior.Behavior |
---|
beforeRender, canCallListenerInterface, detach, getStatelessHint, isTemporary, onComponentTag, onConfigure, onEvent, onException, unbind |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static java.lang.String FORMAT_DATE
public static java.lang.String FORMAT_PAGEDATE
Constructor Detail |
---|
public DatePicker()
Method Detail |
---|
public void bind(Component component)
bind
in class Behavior
component
- the component to bind topublic void afterRender(Component component)
afterRender
in class Behavior
component
- the component that has this behavior coupledprotected boolean includeYUILibraries()
false
.
true
by default.public void renderHead(Component component, IHeaderResponse response)
renderHead
in interface IComponentAwareHeaderContributor
renderHead
in class Behavior
component
- component which is contributing to the response. This parameter is here to give
the component as the context for component-awares implementing this interfaceresponse
- Response objectprotected void renderHeadInit(IHeaderResponse response)
response
- header responseprotected boolean alignWithIcon()
protected void configure(java.util.Map<java.lang.String,java.lang.Object> widgetProperties, IHeaderResponse response, java.util.Map<java.lang.String,java.lang.Object> initVariables)
#localize(Map)
manually if you like localized strings to be added.
widgetProperties
- the current widget propertiesresponse
- the header responseinitVariables
- variables passed to the Wicket.DateTime.init() js methodprotected final java.lang.String[] filterEmpty(java.lang.String[] stringArray)
DateFormatSymbols
returning arrays with
empty elements).
stringArray
- array to filter
protected final java.lang.String getComponentMarkupId()
protected java.lang.String getDatePattern()
protected final java.lang.String getEscapedComponentMarkupId()
protected final java.lang.String getIconId()
protected java.lang.String getIconStyle()
protected java.lang.CharSequence getIconTitle()
protected java.lang.CharSequence getIconAltText()
protected java.lang.CharSequence getIconUrl()
protected java.util.Locale getLocale()
protected void localize(java.util.Map<java.lang.String,java.lang.Object> widgetProperties, IHeaderResponse response, java.util.Map<java.lang.String,java.lang.Object> initVariables)
DateFormatSymbols
and some slight string manupilation to get the strings for months
and week days. Also, the first week day is set according to the Locale
returned by
getLocale()
. It should work well for most locales.
This method is called from #configureWidgetProperties(Map)
and can be overridden if
you want to customize setting up the localized strings but are happy with the rest of
#configureWidgetProperties(Map)
's behavior. Note that you can call (overridable)
method getLocale()
to get the locale that should be used for setting up the widget.
See YUI Calendar's German and Japanese examples for more info.
widgetProperties
- the current widget propertiesresponse
- the header responseinitVariables
- variables passed to the Wicket.DateTime.init() js methodprotected boolean notifyComponentOnDateSelected()
AjaxEventBehavior
to that component to get a call back to the server. The
default is true.
protected final java.lang.String[] substring(java.lang.String[] array, int len)
array
- array to copy fromlen
- size of substring for each element to copy
protected final java.lang.String[] substring(java.lang.String[] array, int start, int len)
array
- array to copy fromstart
- start position of the substringlen
- size of substring for each element to copy
protected boolean enableMonthYearSelection()
true
if select boxes should be rendered to allow month and year
selection.false
to render just plain text.protected boolean hideOnSelect()
true
(default) if the calendar should be hidden after the date selection false
if the calendar should remain visible after the date selection.protected boolean showOnFieldClick()
true
false
(default)public DatePicker setShowOnFieldClick(boolean show)
show
- a flag indicating whether to show the picker on click event
this
instance to be able to chain calls#showOnFieldClick()}
protected boolean autoHide()
true
false
(default)public DatePicker setAutoHide(boolean autoHide)
autoHide
- a flag indicating whether to hide the picker on click event
this
instance to be able to chain calls#autoHide()}
protected boolean renderOnLoad()
true
if the calendar should be rendered after it has been loaded.false
(default) if it's initially hidden.protected java.lang.String getAdditionalJavaScript()
${calendar}
in
your code.protected String getAdditionalJavaScript() { return "${calendar}.addRenderer(\"10/3\", ${calendar}.renderCellStyleHighlight1);"; }
public boolean isEnabled(Component component)
isEnabled
in class Behavior
component
- the component that has this behavior coupled
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |