JBoss Rich Faces SVN: r20747 - in trunk: ui/input/ui/src/main/java/org/richfaces/model and 1 other directories.
by richfaces-svn-commits＠lists.jboss.org
Author: amarkhel
Date: 2010-12-22 11:02:27 -0500 (Wed, 22 Dec 2010)
New Revision: 20747
Modified:
trunk/examples/input-demo/src/main/java/org/richfaces/demo/CalendarDataModelImpl.java
trunk/examples/input-demo/src/main/java/org/richfaces/demo/CalendarDataModelItemImpl.java
trunk/ui/input/ui/src/main/java/org/richfaces/model/CalendarDataModel.java
trunk/ui/input/ui/src/main/java/org/richfaces/model/CalendarDataModelItem.java
trunk/ui/input/ui/src/test/java/org/richfaces/component/CalendarDataModelImpl.java
trunk/ui/input/ui/src/test/java/org/richfaces/component/CalendarDataModelItemImpl.java
Log:
RF-9916 calendar datamodel: add all the methods from 3.3.x back
Modified: trunk/examples/input-demo/src/main/java/org/richfaces/demo/CalendarDataModelImpl.java
===================================================================
--- trunk/examples/input-demo/src/main/java/org/richfaces/demo/CalendarDataModelImpl.java 2010-12-22 15:41:42 UTC (rev 20746)
+++ trunk/examples/input-demo/src/main/java/org/richfaces/demo/CalendarDataModelImpl.java 2010-12-22 16:02:27 UTC (rev 20747)
@@ -67,4 +67,8 @@
return item;
}
+
+ public Object getToolTip(Date date) {
+ return null;
+ }
}
Modified: trunk/examples/input-demo/src/main/java/org/richfaces/demo/CalendarDataModelItemImpl.java
===================================================================
--- trunk/examples/input-demo/src/main/java/org/richfaces/demo/CalendarDataModelItemImpl.java 2010-12-22 15:41:42 UTC (rev 20746)
+++ trunk/examples/input-demo/src/main/java/org/richfaces/demo/CalendarDataModelItemImpl.java 2010-12-22 16:02:27 UTC (rev 20747)
@@ -54,5 +54,21 @@
public void setStyleClass(String styleClass) {
this.styleClass = styleClass;
+ }
+
+ public Object getData() {
+ return null;
+ }
+
+ public boolean hasToolTip() {
+ return false;
+ }
+
+ public Object getToolTip() {
+ return null;
+ }
+
+ public int getDay() {
+ return 0;
}
}
Modified: trunk/ui/input/ui/src/main/java/org/richfaces/model/CalendarDataModel.java
===================================================================
--- trunk/ui/input/ui/src/main/java/org/richfaces/model/CalendarDataModel.java 2010-12-22 15:41:42 UTC (rev 20746)
+++ trunk/ui/input/ui/src/main/java/org/richfaces/model/CalendarDataModel.java 2010-12-22 16:02:27 UTC (rev 20747)
@@ -36,5 +36,10 @@
* This method will be called in Ajax mode when Calendar renders new page.
* */
CalendarDataModelItem[] getData(Date[] dateArray);
-
+
+ /**
+ * @return tool tip when it's used in "single" mode
+ * This method used when tool tips are displayed in "single" mode
+ * */
+ public Object getToolTip(Date date);
}
Modified: trunk/ui/input/ui/src/main/java/org/richfaces/model/CalendarDataModelItem.java
===================================================================
--- trunk/ui/input/ui/src/main/java/org/richfaces/model/CalendarDataModelItem.java 2010-12-22 15:41:42 UTC (rev 20746)
+++ trunk/ui/input/ui/src/main/java/org/richfaces/model/CalendarDataModelItem.java 2010-12-22 16:02:27 UTC (rev 20747)
@@ -40,7 +40,27 @@
* For example it may be �relevant holyday� � that mean class will be like �rich-cal-day relevant holyday�.
* Default implementation return empty string.
* */
- public String getStyleClass();
+ public String getStyleClass();
+
+ /**
+ * @return any additional payload that must be JSON-serialazable object.
+ * May be used in custom date representation on calendar (inside custom facet).*/
+ public Object getData();
+
+ /**
+ * @return true if given date has an associated with it tooltip data.
+ * Default implementation return false.*/
+ public boolean hasToolTip();
+
+ /**
+ *@return tool tip data that will be used in �batch� tooltip loading mode.
+ **/
+ public Object getToolTip();
+
+ /**
+ *@return day of the month on which data must be shown.
+ **/
+ public int getDay();
}
Modified: trunk/ui/input/ui/src/test/java/org/richfaces/component/CalendarDataModelImpl.java
===================================================================
--- trunk/ui/input/ui/src/test/java/org/richfaces/component/CalendarDataModelImpl.java 2010-12-22 15:41:42 UTC (rev 20746)
+++ trunk/ui/input/ui/src/test/java/org/richfaces/component/CalendarDataModelImpl.java 2010-12-22 16:02:27 UTC (rev 20747)
@@ -61,4 +61,8 @@
return item;
}
+
+ public Object getToolTip(Date date) {
+ return null;
+ }
}
Modified: trunk/ui/input/ui/src/test/java/org/richfaces/component/CalendarDataModelItemImpl.java
===================================================================
--- trunk/ui/input/ui/src/test/java/org/richfaces/component/CalendarDataModelItemImpl.java 2010-12-22 15:41:42 UTC (rev 20746)
+++ trunk/ui/input/ui/src/test/java/org/richfaces/component/CalendarDataModelItemImpl.java 2010-12-22 16:02:27 UTC (rev 20747)
@@ -54,5 +54,21 @@
public void setStyleClass(String styleClass) {
this.styleClass = styleClass;
+ }
+
+ public Object getData() {
+ return null;
+ }
+
+ public boolean hasToolTip() {
+ return false;
+ }
+
+ public Object getToolTip() {
+ return null;
+ }
+
+ public int getDay() {
+ return 0;
}
}
14 years
JBoss Rich Faces SVN: r20746 - trunk/ui/input/ui/src/main/java/org/richfaces/renderkit.
by richfaces-svn-commits＠lists.jboss.org
Author: amarkhel
Date: 2010-12-22 10:41:42 -0500 (Wed, 22 Dec 2010)
New Revision: 20746
Modified:
trunk/ui/input/ui/src/main/java/org/richfaces/renderkit/CalendarRendererBase.java
Log:
RF-9779 Calendar: component broken when monthLabels evaluated to null
-added changes for weekDayLabels and weekDayLabelsShort
Modified: trunk/ui/input/ui/src/main/java/org/richfaces/renderkit/CalendarRendererBase.java
===================================================================
--- trunk/ui/input/ui/src/main/java/org/richfaces/renderkit/CalendarRendererBase.java 2010-12-22 15:34:44 UTC (rev 20745)
+++ trunk/ui/input/ui/src/main/java/org/richfaces/renderkit/CalendarRendererBase.java 2010-12-22 15:41:42 UTC (rev 20746)
@@ -448,14 +448,14 @@
int monthMin = calendar.getActualMinimum(Calendar.MONTH);
String [] weekDayLabels = RenderKitUtils.asArray(calendarComponent.getWeekDayLabels());
- if (weekDayLabels == null) {
+ if (isEmptyArray(weekDayLabels)) {
weekDayLabels = dateFormat.getWeekdays();
weekDayLabels = shiftDates(minimum, maximum, weekDayLabels);
}
RenderKitUtils.addToScriptHash(map, WEEK_DAY_LABELS, weekDayLabels);
String [] weekDayLabelsShort = RenderKitUtils.asArray(calendarComponent.getWeekDayLabelsShort());
- if (weekDayLabelsShort == null) {
+ if (isEmptyArray(weekDayLabelsShort)) {
weekDayLabelsShort = dateFormat.getShortWeekdays();
weekDayLabelsShort = shiftDates(minimum, maximum, weekDayLabelsShort);
}
14 years
JBoss Rich Faces SVN: r20745 - trunk/ui/input/ui/src/main/java/org/richfaces/renderkit.
by richfaces-svn-commits＠lists.jboss.org
Author: amarkhel
Date: 2010-12-22 10:34:44 -0500 (Wed, 22 Dec 2010)
New Revision: 20745
Modified:
trunk/ui/input/ui/src/main/java/org/richfaces/renderkit/CalendarRendererBase.java
Log:
RF-9779 Calendar: component broken when monthLabels evaluated to null
Modified: trunk/ui/input/ui/src/main/java/org/richfaces/renderkit/CalendarRendererBase.java
===================================================================
--- trunk/ui/input/ui/src/main/java/org/richfaces/renderkit/CalendarRendererBase.java 2010-12-22 15:14:43 UTC (rev 20744)
+++ trunk/ui/input/ui/src/main/java/org/richfaces/renderkit/CalendarRendererBase.java 2010-12-22 15:34:44 UTC (rev 20745)
@@ -462,14 +462,14 @@
RenderKitUtils.addToScriptHash(map, WEEK_DAY_LABELS_SHORT, weekDayLabelsShort);
String [] monthLabels = RenderKitUtils.asArray(calendarComponent.getMonthLabels());
- if (monthLabels == null) {
+ if (isEmptyArray(monthLabels)) {
monthLabels = dateFormat.getMonths();
monthLabels = shiftDates(monthMin, monthMax, monthLabels);
}
RenderKitUtils.addToScriptHash(map, MONTH_LABELS, monthLabels);
String [] monthLabelsShort = RenderKitUtils.asArray(calendarComponent.getMonthLabelsShort());
- if (monthLabelsShort == null) {
+ if (isEmptyArray(monthLabelsShort)) {
monthLabelsShort = dateFormat.getShortMonths();
monthLabelsShort = shiftDates(monthMin, monthMax, monthLabelsShort);
}
@@ -500,6 +500,17 @@
return map;
}
+ private boolean isEmptyArray(String[] array) {
+ if (array != null) {
+ for (String str : array) {
+ if (str.trim().length() > 0) {
+ return false;
+ }
+ }
+ }
+ return true;
+ }
+
public String getStyleWithZindex(FacesContext facesContext, UIComponent component) {
AbstractCalendar calendar = (AbstractCalendar) component;
String style = HtmlUtil.concatStyles("z-index: " + calendar.getZindex(), calendar.getStyle());
14 years
JBoss Rich Faces SVN: r20744 - in trunk/ui/iteration/ui/src/main/java/org/richfaces: renderkit and 1 other directory.
by richfaces-svn-commits＠lists.jboss.org
Author: abelevich
Date: 2010-12-22 10:14:43 -0500 (Wed, 22 Dec 2010)
New Revision: 20744
Modified:
trunk/ui/iteration/ui/src/main/java/org/richfaces/component/UIDataTableBase.java
trunk/ui/iteration/ui/src/main/java/org/richfaces/renderkit/SortingFilteringRowsRenderer.java
Log:
RF-9931
Modified: trunk/ui/iteration/ui/src/main/java/org/richfaces/component/UIDataTableBase.java
===================================================================
--- trunk/ui/iteration/ui/src/main/java/org/richfaces/component/UIDataTableBase.java 2010-12-22 14:52:52 UTC (rev 20743)
+++ trunk/ui/iteration/ui/src/main/java/org/richfaces/component/UIDataTableBase.java 2010-12-22 15:14:43 UTC (rev 20744)
@@ -117,7 +117,7 @@
public abstract Collection<Object> getSelection();
@Attribute
- public abstract Collection<?> getSortPriority();
+ public abstract Collection<Object> getSortPriority();
@Attribute
public abstract SortMode getSortMode();
Modified: trunk/ui/iteration/ui/src/main/java/org/richfaces/renderkit/SortingFilteringRowsRenderer.java
===================================================================
--- trunk/ui/iteration/ui/src/main/java/org/richfaces/renderkit/SortingFilteringRowsRenderer.java 2010-12-22 14:52:52 UTC (rev 20743)
+++ trunk/ui/iteration/ui/src/main/java/org/richfaces/renderkit/SortingFilteringRowsRenderer.java 2010-12-22 15:14:43 UTC (rev 20744)
@@ -24,8 +24,7 @@
import java.util.Collection;
import java.util.Iterator;
-import java.util.LinkedList;
-import java.util.List;
+import java.util.LinkedHashSet;
import java.util.Map;
import javax.el.ELContext;
@@ -95,7 +94,13 @@
}
protected void decodeSorting(FacesContext context, UIDataTableBase dataTableBase, String value) {
- List<Object> sortPriority = new LinkedList<Object>();
+
+ Collection<Object> sortPriority = dataTableBase.getSortPriority();
+
+ if(sortPriority == null) {
+ sortPriority = new LinkedHashSet<Object>();
+ }
+
String[] values = value.split(SEPARATOR);
if (Boolean.parseBoolean(values[2]) || SortMode.single.equals(dataTableBase.getSortMode())) {
for (Iterator<UIComponent> iterator = dataTableBase.columns(); iterator.hasNext();) {
@@ -109,10 +114,10 @@
}
} else {
updateSortOrder(context, dataTableBase.findComponent(values[0]), values[1]);
- Collection<?> priority = dataTableBase.getSortPriority();
- if (priority != null) {
- priority.remove(values[0]);
- sortPriority.addAll(priority);
+ sortPriority = dataTableBase.getSortPriority();
+ if (sortPriority != null) {
+ sortPriority.remove(values[0]);
+ sortPriority.addAll(sortPriority);
}
sortPriority.add(values[0]);
}
14 years
JBoss Rich Faces SVN: r20743 - in modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest: richExtendedDataTable and 1 other directory.
by richfaces-svn-commits＠lists.jboss.org
Author: lfryc(a)redhat.com
Date: 2010-12-22 09:52:52 -0500 (Wed, 22 Dec 2010)
New Revision: 20743
Modified:
modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richDataTable/TestDataTableSortingUsingColumn.java
modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richDataTable/TestDataTableSortingUsingComponentControl.java
modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richExtendedDataTable/TestExtendedDataTableSortingUsingComponentControl.java
Log:
issue tracking for RF-9931 and RF-9932
Modified: modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richDataTable/TestDataTableSortingUsingColumn.java
===================================================================
--- modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richDataTable/TestDataTableSortingUsingColumn.java 2010-12-22 13:56:58 UTC (rev 20742)
+++ modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richDataTable/TestDataTableSortingUsingColumn.java 2010-12-22 14:52:52 UTC (rev 20743)
@@ -26,6 +26,7 @@
import java.net.URL;
import org.richfaces.tests.metamer.ftest.abstractions.DataTableSortingTest;
+import org.richfaces.tests.metamer.ftest.annotations.IssueTracking;
import org.richfaces.tests.metamer.ftest.model.DataTable;
import org.testng.annotations.BeforeClass;
import org.testng.annotations.Test;
@@ -96,6 +97,7 @@
@Test
@Override
+ @IssueTracking("https://issues.jboss.org/browse/RF-9932")
public void testSortModeMultiRerenderAll() {
super.testSortModeMultiRerenderAll();
}
Modified: modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richDataTable/TestDataTableSortingUsingComponentControl.java
===================================================================
--- modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richDataTable/TestDataTableSortingUsingComponentControl.java 2010-12-22 13:56:58 UTC (rev 20742)
+++ modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richDataTable/TestDataTableSortingUsingComponentControl.java 2010-12-22 14:52:52 UTC (rev 20743)
@@ -26,6 +26,7 @@
import java.net.URL;
import org.richfaces.tests.metamer.ftest.abstractions.DataTableSortingTest;
+import org.richfaces.tests.metamer.ftest.annotations.IssueTracking;
import org.richfaces.tests.metamer.ftest.model.DataTable;
import org.testng.annotations.BeforeClass;
import org.testng.annotations.Test;
@@ -66,6 +67,7 @@
@Test
@Override
+ @IssueTracking("https://issues.jboss.org/browse/RF-9932")
public void testSortModeSingleRerenderAll() {
super.testSortModeSingleRerenderAll();
}
@@ -78,30 +80,35 @@
@Test
@Override
+ @IssueTracking("https://issues.jboss.org/browse/RF-9931")
public void testSortModeMulti() {
super.testSortModeMulti();
}
@Test
@Override
+ @IssueTracking("https://issues.jboss.org/browse/RF-9931")
public void testSortModeMultiReverse() {
super.testSortModeMultiReverse();
}
@Test
@Override
+ @IssueTracking("https://issues.jboss.org/browse/RF-9931")
public void testSortModeMultiReplacingOldOccurences() {
super.testSortModeMultiReplacingOldOccurences();
}
@Test
@Override
+ @IssueTracking({ "https://issues.jboss.org/browse/RF-9931", "https://issues.jboss.org/browse/RF-9932" })
public void testSortModeMultiRerenderAll() {
super.testSortModeMultiRerenderAll();
}
@Test
@Override
+ @IssueTracking("https://issues.jboss.org/browse/RF-9931")
public void testSortModeMultiFullPageRefresh() {
super.testSortModeMultiFullPageRefresh();
}
Modified: modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richExtendedDataTable/TestExtendedDataTableSortingUsingComponentControl.java
===================================================================
--- modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richExtendedDataTable/TestExtendedDataTableSortingUsingComponentControl.java 2010-12-22 13:56:58 UTC (rev 20742)
+++ modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richExtendedDataTable/TestExtendedDataTableSortingUsingComponentControl.java 2010-12-22 14:52:52 UTC (rev 20743)
@@ -26,6 +26,7 @@
import java.net.URL;
import org.richfaces.tests.metamer.ftest.abstractions.DataTableSortingTest;
+import org.richfaces.tests.metamer.ftest.annotations.IssueTracking;
import org.richfaces.tests.metamer.ftest.model.ExtendedDataTable;
import org.testng.annotations.BeforeClass;
import org.testng.annotations.Test;
@@ -96,6 +97,7 @@
@Test
@Override
+ @IssueTracking("https://issues.jboss.org/browse/RF-9932")
public void testSortModeMultiRerenderAll() {
super.testSortModeMultiRerenderAll();
}
14 years
JBoss Rich Faces SVN: r20742 - in trunk/ui/input/ui/src/main: templates and 1 other directory.
by richfaces-svn-commits＠lists.jboss.org
Author: abelevich
Date: 2010-12-22 08:56:58 -0500 (Wed, 22 Dec 2010)
New Revision: 20742
Modified:
trunk/ui/input/ui/src/main/resources/META-INF/resources/org.richfaces/inplaceInput.js
trunk/ui/input/ui/src/main/templates/inplaceSelect.template.xml
Log:
RF-9853, RF-10053
Modified: trunk/ui/input/ui/src/main/resources/META-INF/resources/org.richfaces/inplaceInput.js
===================================================================
--- trunk/ui/input/ui/src/main/resources/META-INF/resources/org.richfaces/inplaceInput.js 2010-12-22 13:01:27 UTC (rev 20741)
+++ trunk/ui/input/ui/src/main/resources/META-INF/resources/org.richfaces/inplaceInput.js 2010-12-22 13:56:58 UTC (rev 20742)
@@ -53,11 +53,12 @@
case rf.KEYS.ESC:
e.preventDefault();
this.cancel();
+ this.onblur(e);
break;
case rf.KEYS.RETURN:
e.preventDefault();
this.save();
- return false;
+ this.onblur(e);
break;
}
},
Modified: trunk/ui/input/ui/src/main/templates/inplaceSelect.template.xml
===================================================================
--- trunk/ui/input/ui/src/main/templates/inplaceSelect.template.xml 2010-12-22 13:01:27 UTC (rev 20741)
+++ trunk/ui/input/ui/src/main/templates/inplaceSelect.template.xml 2010-12-22 13:56:58 UTC (rev 20742)
@@ -64,11 +64,11 @@
<span class="rf-is-shdw-b"></span>
<span id="#{clientId}Btn" style="position : relative;">
- <input type="image" name="#{clientId}Okbtn" id="#{clientId}Okbtn"
+ <input type="image" id="#{clientId}Okbtn"
src="#{getResourcePath(facesContext, 'org.richfaces', 'ico_ok.gif')}"
class="rf-is-btn" onmousedown="this.className='rf-is-btn-press'"
onmouseout="this.className='rf-is-btn'" onmouseup="this.className='rf-is-btn'" />
- <input name="#{clientId}Okbtn" type="image" id="#{clientId}Cancelbtn"
+ <input type="image" id="#{clientId}Cancelbtn"
src="#{getResourcePath(facesContext,'org.richfaces', 'ico_cancel.gif')}"
class="rf-is-btn" onmousedown="this.className='rf-is-btn-press'"
onmouseout="this.className='rf-is-btn'" onmouseup="this.className='rf-is-btn'" />
14 years
JBoss Rich Faces SVN: r20741 - in trunk/ui/output/ui/src/main: templates and 1 other directory.
by richfaces-svn-commits＠lists.jboss.org
Author: amarkhel
Date: 2010-12-22 08:01:27 -0500 (Wed, 22 Dec 2010)
New Revision: 20741
Modified:
trunk/ui/output/ui/src/main/java/org/richfaces/component/AbstractProgressBar.java
trunk/ui/output/ui/src/main/templates/progressBar.template.xml
Log:
RF-9950 Faces-config: progress bar missing attributes style and styleClass
Modified: trunk/ui/output/ui/src/main/java/org/richfaces/component/AbstractProgressBar.java
===================================================================
--- trunk/ui/output/ui/src/main/java/org/richfaces/component/AbstractProgressBar.java 2010-12-22 07:13:10 UTC (rev 20740)
+++ trunk/ui/output/ui/src/main/java/org/richfaces/component/AbstractProgressBar.java 2010-12-22 13:01:27 UTC (rev 20741)
@@ -138,6 +138,12 @@
@Attribute(hidden = true)
public abstract String getResource();
+ @Attribute
+ public abstract String getStyle();
+
+ @Attribute
+ public abstract String getStyleClass();
+
public void encodeMetaComponent(FacesContext context, String metaComponentId) throws IOException {
((MetaComponentRenderer) getRenderer(context)).encodeMetaComponent(context, this, metaComponentId);
}
Modified: trunk/ui/output/ui/src/main/templates/progressBar.template.xml
===================================================================
--- trunk/ui/output/ui/src/main/templates/progressBar.template.xml 2010-12-22 07:13:10 UTC (rev 20740)
+++ trunk/ui/output/ui/src/main/templates/progressBar.template.xml 2010-12-22 13:01:27 UTC (rev 20741)
@@ -16,7 +16,9 @@
<cc:implementation>
- <div id="#{clientId}" cdk:passThroughWithExclusions="" class="#{concatClasses('rf-pb', component.attributes['styleClass'])}">
+ <div id="#{clientId}" cdk:passThroughWithExclusions=""
+ class="#{concatClasses('rf-pb', component.attributes['styleClass'])}"
+ style="#{component.attributes['style']}">
<cdk:object name="encoder" value="#{getEncoder(facesContext, component)}" type="ProgressBarStateEncoder" />
<cdk:object name="currentState" value="#{getCurrentState(facesContext, component)}" type="ProgressBarState" />
14 years
JBoss Rich Faces SVN: r20740 - in modules/docs/trunk: Migration_Guide/src/main/docbook/en-US and 1 other directory.
by richfaces-svn-commits＠lists.jboss.org
Author: SeanRogers
Date: 2010-12-22 02:13:10 -0500 (Wed, 22 Dec 2010)
New Revision: 20740
Modified:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/Component_Reference.xml
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Drag_and_drop.xml
modules/docs/trunk/Migration_Guide/src/main/docbook/en-US/Changes_and_new_features.xml
Log:
Draft of drag and drop RFPL-974
Modified: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/Component_Reference.xml
===================================================================
--- modules/docs/trunk/Component_Reference/src/main/docbook/en-US/Component_Reference.xml 2010-12-22 02:44:21 UTC (rev 20739)
+++ modules/docs/trunk/Component_Reference/src/main/docbook/en-US/Component_Reference.xml 2010-12-22 07:13:10 UTC (rev 20740)
@@ -25,9 +25,7 @@
<xi:include href="chap-Component_Reference-Trees.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="chap-Component_Reference-Menus_and_toolbars.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="chap-Component_Reference-Output_and_messages.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <!--
<xi:include href="chap-Component_Reference-Drag_and_drop.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- -->
<xi:include href="chap-Component_Reference-Layout_and_appearance.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="chap-Component_Reference-Functions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<!--
Modified: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Drag_and_drop.xml
===================================================================
--- modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Drag_and_drop.xml 2010-12-22 02:44:21 UTC (rev 20739)
+++ modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Drag_and_drop.xml 2010-12-22 07:13:10 UTC (rev 20740)
@@ -3,50 +3,154 @@
]>
<chapter id="chap-Component_Reference-Drag_and_drop">
<title>Drag and drop</title>
- <para>
- Incomplete
- </para>
- <section id="sect-Component_Reference-Drag_and_drop-richdragIndicator">
- <title><sgmltag><rich:dragIndicator></sgmltag></title>
+ <!-- In development notification -->
+ <important>
+ <title>Documentation in development</title>
<para>
- Incomplete
+ Some concepts covered in this chapter may refer to the previous version of <productname>Richfaces</productname>, version 3.3.3. This chapter is scheduled for review to ensure all information is up to date.
</para>
- </section>
+ </important>
- <section id="sect-Component_Reference-Drag_and_drop-richdragSupport">
- <title><sgmltag><rich:dragSupport></sgmltag></title>
+ <para>
+ Read this chapter for details on adding drag and drop support to controls.
+ </para>
+
+ <!-- <rich:dragBehavior> -->
+ <section id="sect-Component_Reference-Drag_and_drop-richdragBehavior">
+ <title><sgmltag><rich:dragBehavior></sgmltag></title>
<para>
- Incomplete
+ The <sgmltag><rich:dragBehavior></sgmltag> behavior can be added to a component to indicate it is capable of being dragged by the user. The dragged item can then be dropped into a compatible drop area, designated using the <sgmltag><rich:dropBehavior></sgmltag> behavior.
</para>
+
+ <section id="sect-Component_Reference-richdragBehavior-Basic_usage">
+ <title>Basic usage</title>
+ <para>
+ To add drag support to a component, attach the <sgmltag><rich:dragBehavior></sgmltag> behavior as a child element.
+ </para>
+ <para>
+ The <varname>type</varname> attribute must be specified, and can be any identifying string. Dragged items can only be dropped in drop zones where the <varname>type</varname> attribute of the <sgmltag><rich:dragBehavior></sgmltag> behavior is listed in the <varname>acceptedTypes</varname> attribute of the <sgmltag><rich:dropBehavior></sgmltag> behavior.
+ </para>
+ </section>
+
+ <section id="sect-Component_Reference-richdragBehavior-Dragging_bound_data">
+ <title>Dragging bound data</title>
+ <para>
+ To bind data to the dragged object, use the <varname>dragValue</varname> attribute. The <varname>dragValue</varname> attribute specifies an item in a data model, which is then bound to the parent component when it is dragged. This facilitates handling event data during a drop event.
+ </para>
+ </section>
+
+ <section id="sect-Component_Reference-richdragBehavior-Reference_data">
+ <title>Reference data</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <parameter>component-type</parameter>: <classname>org.richfaces.DragBehavior</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>component-class</parameter>: <classname>org.richfaces.component.html.HtmlDragBehavior</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>component-family</parameter>: <classname>org.richfaces.DragBehavior</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>renderer-type</parameter>: <classname>org.richfaces.DragBehaviorRenderer</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>tag-class</parameter>: <classname>org.richfaces.taglib.DragBehaviorTag</classname>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
</section>
-
- <section id="sect-Component_Reference-Drag_and_drop-richdropSupport">
- <title><sgmltag><rich:dropSupport></sgmltag></title>
+
+ <!-- <rich:dropBehavior> -->
+ <section id="sect-Component_Reference-Drag_and_drop-richdropBehavior">
+ <title><sgmltag><rich:dropBehavior></sgmltag></title>
<para>
- Incomplete
+ The <sgmltag><rich:dropBehavior></sgmltag> behavior can be added to a component so that the component can accept dragged items. The dragged items must support the <sgmltag><rich:dragBehavior></sgmltag> behavior, and be of a compatible drop type.
</para>
+
+ <section id="sect-Component_Reference-richdropBehavior-Basic_usage">
+ <title>Basic usage</title>
+ <para>
+ To allow dragged items to be dropped on a component, attach the <sgmltag><rich:dropBehavior></sgmltag> behavior as a child element to the component.
+ </para>
+ <para>
+ The <varname>acceptedTypes</varname> attribute must be specified. The <varname>acceptedTypes</varname> attribute is a comma-separated list of strings that match the types of dragged items. Dragged items can only be dropped in drop zones where the <varname>type</varname> attribute of the <sgmltag><rich:dragBehavior></sgmltag> behavior is listed in the <varname>acceptedTypes</varname> attribute of the <sgmltag><rich:dropBehavior></sgmltag> behavior.
+ </para>
+ </section>
+
+ <section id="sect-Component_Reference-richdropBehavior-Handling_dropped_data">
+ <title>Handling dropped data</title>
+ <para>
+ To provide additional parameters for a drop event, use the <varname>dropValue</varname> attribute.
+ </para>
+ <para>
+ The <sgmltag><rich:dropBehavior></sgmltag> behavior raises the <varname>DropEvent</varname> server-side event when an object is dropped. The event uses the following parameters:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ The <parameter>dragComponent</parameter> identifies the component being dragged (the parent of the <sgmltag><rich:dragBehavior></sgmltag> behavior).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The <parameter>dropComponent</parameter> parameter identifies the drop zone component (the parent of the <sgmltag><rich:dropBehavior></sgmltag> behavior).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The <parameter>dragSource</parameter> parameter is the content of the <sgmltag><rich:dragBehavior></sgmltag> behavior's <varname>dragValue</varname> attribute.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The <parameter>dropSource</parameter> parameter is the content of the <sgmltag><rich:dropBehavior></sgmltag> behavior's <varname>dropValue</varname> attribute.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+
+ <section id="sect-Component_Reference-richdropBehavior-Reference_data">
+ <title>Reference data</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <parameter>component-type</parameter>: <classname>org.richfaces.DropBehavior</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>component-class</parameter>: <classname>org.richfaces.component.html.HtmlDropBehavior</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>component-family</parameter>: <classname>org.richfaces.DropBehavior</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>renderer-type</parameter>: <classname>org.richfaces.DropBehaviorRenderer</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>tag-class</parameter>: <classname>org.richfaces.taglib.DropBehaviorTag</classname>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
</section>
-
- <section id="sect-Component_Reference-Drag_and_drop-richdragListener">
- <title><sgmltag><rich:dragListener></sgmltag></title>
- <para>
- Incomplete
- </para>
- </section>
-
- <section id="sect-Component_Reference-Drag_and_drop-richdropListener">
- <title><sgmltag><rich:dropListener></sgmltag></title>
- <para>
- Incomplete
- </para>
- </section>
-
- <section id="sect-Component_Reference-Drag_and_drop-richdndParam">
- <title><sgmltag><rich:dndParam></sgmltag></title>
- <para>
- Incomplete
- </para>
- </section>
</chapter>
Modified: modules/docs/trunk/Migration_Guide/src/main/docbook/en-US/Changes_and_new_features.xml
===================================================================
--- modules/docs/trunk/Migration_Guide/src/main/docbook/en-US/Changes_and_new_features.xml 2010-12-22 02:44:21 UTC (rev 20739)
+++ modules/docs/trunk/Migration_Guide/src/main/docbook/en-US/Changes_and_new_features.xml 2010-12-22 07:13:10 UTC (rev 20740)
@@ -854,9 +854,9 @@
</section>
<section id="sect-Migration_Guide-Feature_changes-a4jmessage_and_a4jmessages">
- <title><sgmltag><a4j:message></sgmltag> and <sgmltag><a4j:messages></sgmltag></title>
+ <title><sgmltag><rich:message></sgmltag> and <sgmltag><rich:messages></sgmltag></title>
<para>
- Both the <sgmltag><a4j:message></sgmltag> and <sgmltag><a4j:messages></sgmltag> components can be automatically updated by any Ajax request, except those requests with <code>limitRender = true</code>. Attributes from previously-passed states are now cleared.
+ Both the <sgmltag><rich:message></sgmltag> and <sgmltag><rich:messages></sgmltag> components can be automatically updated by any Ajax request, except those requests with <code>limitRender = true</code>. Attributes from previously-passed states are now cleared.
</para>
</section>
@@ -967,6 +967,13 @@
</para>
</section>
+ <section id="sect-Migration_Guide-Consolidated_or_renamed_components-richdragBehavior_and_richdropBehavior">
+ <title><sgmltag><rich:dragBehavior></sgmltag> and <sgmltag><rich:dropBehavior></sgmltag></title>
+ <para>
+ The <sgmltag><rich:dragBehavior></sgmltag> behavior replaces the old <sgmltag><rich:dragSupport></sgmltag> component. The <sgmltag><rich:dropBehavior></sgmltag> behavior replaces the old <sgmltag><rich:dropSupport></sgmltag> component.
+ </para>
+ </section>
+
<section id="sect-Migration_Guide-Consolidated_or_renamed_components-richextendedDataTable">
<title><sgmltag><rich:extendedDataTable></sgmltag></title>
<para>
@@ -1058,6 +1065,13 @@
</para>
</section>
+ <section id="sect-Migration_Guide-Deprecated_components_and_behaviors-richdragSupport_and_richdropSupport">
+ <title><sgmltag><rich:dragSupport></sgmltag> and <sgmltag><rich:dropSupport></sgmltag></title>
+ <para>
+ The functionality of the old <sgmltag><rich:dragSupport></sgmltag> component is now available through the <sgmltag><rich:dragBehavior></sgmltag> behavior. The functionality of the old <sgmltag><rich:dropSupport></sgmltag> component is now available through the <sgmltag><rich:dropBehavior></sgmltag> behavior.
+ </para>
+ </section>
+
<section id="sect-Migration_Guide-Deprecated_components_and_behaviors-richmodalPanel">
<title><sgmltag><rich:modalPanel></sgmltag></title>
<para>
@@ -1068,7 +1082,7 @@
<section id="sect-Migration_Guide-Deprecated_components_and_behaviors-richpanelBar_and_richpanelBarItem">
<title><sgmltag><rich:panelBar></sgmltag> and <sgmltag><rich:panelBarItem></sgmltag></title>
<para>
- The functionality of the old <sgmltag><rich:panelBar></sgmltag> component is now available through the <sgmltag><rich:accordion></sgmltag> component. The functionality of the old <sgmltag><rich:panelBarIten></sgmltag> component is now available through the <sgmltag><rich:accordionItem></sgmltag> component.
+ The functionality of the old <sgmltag><rich:panelBar></sgmltag> component is now available through the <sgmltag><rich:accordion></sgmltag> component. The functionality of the old <sgmltag><rich:panelBarItem></sgmltag> component is now available through the <sgmltag><rich:accordionItem></sgmltag> component.
</para>
</section>
14 years
JBoss Rich Faces SVN: r20739 - modules/docs/trunk/Component_Reference/src/main/docbook/en-US.
by richfaces-svn-commits＠lists.jboss.org
Author: SeanRogers
Date: 2010-12-21 21:44:21 -0500 (Tue, 21 Dec 2010)
New Revision: 20739
Modified:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Menus_and_toolbars.xml
Log:
Fixed build error
Modified: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Menus_and_toolbars.xml
===================================================================
--- modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Menus_and_toolbars.xml 2010-12-22 02:40:49 UTC (rev 20738)
+++ modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Menus_and_toolbars.xml 2010-12-22 02:44:21 UTC (rev 20739)
@@ -319,7 +319,7 @@
</para>
</section>
- <section id="sect-Component_Reference-richmenuGroup-Reference_data">
+ <section id="sect-Component_Reference-richmenuSeparator-Reference_data">
<title>Reference data</title>
<itemizedlist>
<listitem>
14 years
JBoss Rich Faces SVN: r20738 - in modules/docs/trunk/Component_Reference/src/main/docbook/en-US: extras and 1 other directories.
by richfaces-svn-commits＠lists.jboss.org
Author: SeanRogers
Date: 2010-12-21 21:40:49 -0500 (Tue, 21 Dec 2010)
New Revision: 20738
Added:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richmenuItem-Icon_facets.xml_sample
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richdropDownMenu-richdropDownMenu.png
Modified:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Menus_and_toolbars.xml
Log:
Completed draft of menu components RFPL-969
Modified: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Menus_and_toolbars.xml
===================================================================
--- modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Menus_and_toolbars.xml 2010-12-21 23:34:37 UTC (rev 20737)
+++ modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Menus_and_toolbars.xml 2010-12-22 02:40:49 UTC (rev 20738)
@@ -31,6 +31,19 @@
<para>
The <sgmltag><rich:dropDownMenu></sgmltag> component is used for creating a drop-down, hierarchical menu. It can be used with the <sgmltag><rich:toolbar></sgmltag> component to create menus in an application's toolbar.
</para>
+ <figure id="figu-Component_Reference-richdropDownMenu-richdropDownMenu">
+ <title><sgmltag><rich:dropDownMenu></sgmltag></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/figu-Component_Reference-richdropDownMenu-richdropDownMenu.png" format="PNG" />
+ </imageobject>
+ <textobject>
+ <para>
+ A <sgmltag><rich:dropDownMenu></sgmltag> component in a toolbar.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
<section id="sect-Component_Reference-richdropDownMenu-Basic_usage">
<title>Basic usage</title>
@@ -66,7 +79,7 @@
By default, the menu drops down when the title is clicked. To drop down with a different event, use the <varname>event</varname> attribute to define the event instead.
</para>
<para>
- Use the <varname>submitMode</varname> attribute to determine how the menu requests are submitted:
+ Use the <varname>mode</varname> attribute to determine how the menu requests are submitted:
</para>
<itemizedlist>
<listitem>
@@ -81,7 +94,7 @@
</listitem>
<listitem>
<para>
- <literal>none</literal> causes the <varname>action</varname> and <varname>actionListener</varname> items to be ignored, and the behavior is fully defined by the nested components instead of responses from submissions.
+ <literal>client</literal> causes the <varname>action</varname> and <varname>actionListener</varname> items to be ignored, and the behavior is fully defined by the nested components instead of responses from submissions.
</para>
</listitem>
</itemizedlist>
@@ -122,31 +135,220 @@
<section id="sect-Component_Reference-Menus_and_toolbars-Menu_sub-components">
<title>Menu sub-components</title>
<para>
- The <sgmltag><rich:menuGroup></sgmltag>, <sgmltag><rich:menuItem></sgmltag>, and <sgmltag><rich:menuSeparator></sgmltag> components are used to construct menus for the <sgmltag><rich:dropDownMenu></sgmltag> component. Refer to <xref linkend="sect-Component_Reference-Menus_and_toolbars-richdropDownMenu" /> for more details on the <sgmltag><rich:dropDownMenu></sgmltag> component.
+ The <sgmltag><rich:menuItem></sgmltag>, <sgmltag><rich:menuGroup></sgmltag>, and <sgmltag><rich:menuSeparator></sgmltag> components are used to construct menus for the <sgmltag><rich:dropDownMenu></sgmltag> component. Refer to <xref linkend="sect-Component_Reference-Menus_and_toolbars-richdropDownMenu" /> for more details on the <sgmltag><rich:dropDownMenu></sgmltag> component.
</para>
-
- <!--<rich:menuGroup>-->
- <section id="sect-Component_Reference-Menus_and_toolbars-richmenuGroup">
- <title><sgmltag><rich:menuGroup></sgmltag></title>
- <para>
- Incomplete
- </para>
- </section>
<!--<rich:menuItem>-->
<section id="sect-Component_Reference-Menus_and_toolbars-richmenuItem">
<title><sgmltag><rich:menuItem></sgmltag></title>
<para>
- Incomplete
+ The <sgmltag><rich:menuItem></sgmltag> component represents a single item in a menu control.
</para>
+
+ <section id="sect-Component_Reference-richmenuItem-Basic_usage">
+ <title>Basic usage</title>
+ <para>
+ The <sgmltag><rich:menuItem></sgmltag> component requires the <varname>value</varname> attribute for basic usage. The <varname>value</varname> attribute is the text label for the menu item.
+ </para>
+ </section>
+
+ <section id="sect-Component_Reference-richmenuItem-Appearance">
+ <title>Appearance</title>
+ <para>
+ Icons can be added to menu items through the use of two icon attributes. The <varname>icon</varname> attribute specifies the normal icon, while the <varname>iconDisabled</varname> attribute specifies the icon for a disabled item.
+ </para>
+ <para>
+ Alternatively, define facets with the names <literal>icon</literal> and <literal>iconDisabled</literal> to set the icons. If facets are defined, the <varname>icon</varname> and <varname>iconDisabled</varname> attributes are ignored. Using facets for icons allows more complex usage; example shows a checkbox being used in place of an icon.
+ </para>
+ <example id="exam-Component_Reference-richmenuItem-Icon_facets">
+ <title>Icon facets</title>
+ <programlisting language="XML" role="XML"><xi:include parse="text" href="extras/exam-Component_Reference-richmenuItem-Icon_facets.xml_sample" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting>
+ </example>
+ </section>
+
+ <section id="sect-Component_Reference-richmenuItem-Submission_modes">
+ <title>Submission modes</title>
+ <para>
+ Use the <varname>submitMode</varname> attribute to determine how the menu item requests are submitted:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>server</literal>, the default setting, submits the form normally and completely refreshes the page.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>ajax</literal> performs an Ajax form submission, and re-renders elements specified with the <varname>render</varname> attribute.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>client</literal> causes the <varname>action</varname> and <varname>actionListener</varname> items to be ignored, and the behavior is fully defined by the nested components instead of responses from submissions.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+
+ <section id="sect-Component_Reference-richmenuItem-Reference_data">
+ <title>Reference data</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <parameter>component-type</parameter>: <classname>org.richfaces.MenuItem</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>component-class</parameter>: <classname>org.richfaces.component.html.HtmlMenuItem</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>component-family</parameter>: <classname>org.richfaces.DropDownMenu</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>renderer-type</parameter>: <classname>org.richfaces.MenuItemRenderer</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>tag-class</parameter>: <classname>org.richfaces.taglib.MenuItemTag</classname>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
</section>
+ <!--<rich:menuGroup>-->
+ <section id="sect-Component_Reference-Menus_and_toolbars-richmenuGroup">
+ <title><sgmltag><rich:menuGroup></sgmltag></title>
+ <para>
+ The <sgmltag><rich:menuGroup></sgmltag> component represents an expandable sub-menu in a menu control. The <sgmltag><rich:menuGroup></sgmltag> component can contain a number of <sgmltag><rich:menuItem></sgmltag> components, or further nested <sgmltag><rich:menuGroup></sgmltag> components.
+ </para>
+
+ <section id="sect-Component_Reference-richmenuGroup-Basic_usage">
+ <title>Basic usage</title>
+ <para>
+ The <sgmltag><rich:menuGroup></sgmltag> component requires the <varname>value</varname> attribute for basic usage. The <varname>value</varname> attribute is the text label for the menu item.
+ </para>
+ <para>
+ Additionally, the <sgmltag><rich:menuGroup></sgmltag> component must contain child <sgmltag><rich:menuItem></sgmltag> components or <sgmltag><rich:menuGroup></sgmltag> components.
+ </para>
+ </section>
+
+ <section id="sect-Component_Reference-richmenuGroup-Appearance">
+ <title>Appearance</title>
+ <para>
+ Icons can be added to menu groups through the use of two icon attributes. The <varname>icon</varname> attribute specifies the normal icon, while the <varname>iconDisabled</varname> attribute specifies the icon for a disabled group.
+ </para>
+ <para>
+ Alternatively, define facets with the names <literal>icon</literal> and <literal>iconDisabled</literal> to set the icons. If facets are defined, the <varname>icon</varname> and <varname>iconDisabled</varname> attributes are ignored.
+ </para>
+ </section>
+
+ <section id="sect-Component_Reference-richmenuGroup-Submission_modes">
+ <title>Submission modes</title>
+ <para>
+ Use the <varname>submitMode</varname> attribute to determine how the menu item requests are submitted:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>server</literal>, the default setting, submits the form normally and completely refreshes the page.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>ajax</literal> performs an Ajax form submission, and re-renders elements specified with the <varname>render</varname> attribute.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>client</literal> causes the <varname>action</varname> and <varname>actionListener</varname> items to be ignored, and the behavior is fully defined by the nested components instead of responses from submissions.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+
+ <section id="sect-Component_Reference-richmenuGroup-Reference_data">
+ <title>Reference data</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <parameter>component-type</parameter>: <classname>org.richfaces.MenuGroup</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>component-class</parameter>: <classname>org.richfaces.component.html.HtmlMenuGroup</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>component-family</parameter>: <classname>org.richfaces.DropDownMenu</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>renderer-type</parameter>: <classname>org.richfaces.MenuGroupRenderer</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>tag-class</parameter>: <classname>org.richfaces.taglib.MenuGroupTag</classname>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ </section>
+
<!--<rich:menuSeparator>-->
<section id="sect-Component_Reference-Menus_and_toolbars-richmenuSeparator">
<title><sgmltag><rich:menuSeparator></sgmltag></title>
<para>
- Incomplete
+ The <sgmltag><rich:menuSeparator></sgmltag> component represents a separating divider in a menu control.
</para>
+
+ <section id="sect-Component_Reference-richmenuSeparator-Basic_usage">
+ <title>Basic usage</title>
+ <para>
+ The <sgmltag><rich:menuSeparator></sgmltag> component does not require any attributes for basic usage. Add it as a child to a menu component to separator menu items and menu groups.
+ </para>
+ </section>
+
+ <section id="sect-Component_Reference-richmenuGroup-Reference_data">
+ <title>Reference data</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <parameter>component-type</parameter>: <classname>org.richfaces.MenuSeparator</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>component-class</parameter>: <classname>org.richfaces.component.html.HtmlMenuSeparator</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>component-family</parameter>: <classname>org.richfaces.DropDownMenu</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>renderer-type</parameter>: <classname>org.richfaces.MenuSeparatorRenderer</classname>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>tag-class</parameter>: <classname>org.richfaces.taglib.MenuSeparatorTag</classname>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
</section>
</section>
Added: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richmenuItem-Icon_facets.xml_sample
===================================================================
--- modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richmenuItem-Icon_facets.xml_sample (rev 0)
+++ modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richmenuItem-Icon_facets.xml_sample 2010-12-22 02:40:49 UTC (rev 20738)
@@ -0,0 +1,5 @@
+<rich:menuItem value="Show comments">
+ <f:facet name="icon">
+ <h:selectBooleanCheckbox value="#{bean.property}"/>
+ </f:facet>
+</rich:menuItem>
Added: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richdropDownMenu-richdropDownMenu.png
===================================================================
(Binary files differ)
Property changes on: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richdropDownMenu-richdropDownMenu.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
14 years