From 2fac251a17d229e84b804c6eb21c78103c93d3e4 Mon Sep 17 00:00:00 2001
From: Musachy Barroso <musachy@apache.org>
Date: Wed, 30 May 2007 16:42:42 +0000
Subject: [PATCH] Improve datetimepicker tag documentation

git-svn-id: https://svn.apache.org/repos/asf/struts/struts2/trunk@542869 13f79535-47bb-0310-9956-ffa450edef68
---
 .../dojo/components/DateTimePicker.java       | 44 +++++++++++++++----
 1 file changed, 36 insertions(+), 8 deletions(-)

diff --git a/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/DateTimePicker.java b/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/DateTimePicker.java
index 1daf43efc..3e1a9a31c 100644
--- a/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/DateTimePicker.java
+++ b/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/DateTimePicker.java
@@ -118,20 +118,48 @@ import com.opensymphony.xwork2.util.ValueStack;
  * <b>Examples</b>
  *
  * <pre>
- * <!-- START SNIPPET: expl1 -->
+ * <!-- START SNIPPET: example1 -->
  *
  * Example 1:
- *     &lt;s:datetimepicker name="order.date" label="Order Date" /&gt;
+ *     &lt;sx:datetimepicker name="order.date" label="Order Date" /&gt;
  * Example 2:
- *     &lt;s:datetimepicker name="delivery.date" label="Delivery Date" displayFormat="yyyy-MM-dd"  /&gt;
+ *     &lt;sx:datetimepicker name="delivery.date" label="Delivery Date" displayFormat="yyyy-MM-dd"  /&gt;
  * Example 3:   
- *      &lt;s:datetimepicker name="delivery.date" label="Delivery Date" value="%{date}"  /&gt;
+ *      &lt;sx:datetimepicker name="delivery.date" label="Delivery Date" value="%{date}"  /&gt;
  *  Example 3:    
- *      &lt;s:datetimepicker name="delivery.date" label="Delivery Date" value="%{'2007-01-01'}"  /&gt;     
- * <!-- END SNIPPET: expl1 -->
+ *      &lt;sx:datetimepicker name="delivery.date" label="Delivery Date" value="%{'2007-01-01'}"  /&gt;     
+ * <!-- END SNIPPET: example1 -->
  * </pre>
- * <p/>
- *
+ * 
+ * <!-- START SNIPPET: example2 -->
+ * <p>Getting and getting the datetimepicker value, from JavaScript</p>
+ * <pre>
+ * &lt;sx:datetimepicker id="picker" label="Order Date" /&gt;
+ * &lt;script type="text/javascript"&gt;
+ *   function setValue() {
+ *      var picker = dojo.widget.byId("picker");
+ *      
+ *      //string value
+ *      picker.setValue('2007-01-01');
+ *      
+ *      //Date value
+ *      picker.setValue(new Date());
+ *   }
+ *   
+ *   function showValue() {
+ *      var picker = dojo.widget.byId("picker");
+ *      
+ *      //string value
+ *      var stringValue = picker.getValue();
+ *      alert(stringValue);
+ *      
+ *      //date value
+ *      var dateValue = picker.getDate();
+ *      alert(dateValue);
+ *   }
+ * &lt;/script&gt;
+ * </pre>
+ * <!-- END SNIPPET: example2 -->
  */
 @StrutsTag(name="datetimepicker", tldTagClass="org.apache.struts2.dojo.views.jsp.ui.DateTimePickerTag", description="Render datetimepicker")
 public class DateTimePicker extends UIBean {