Author: SeanRogers
Date: 2011-03-14 22:18:30 -0400 (Mon, 14 Mar 2011)
New Revision: 22213
Modified:
trunk/examples/richfaces-showcase/src/main/webapp/richfaces/dragDrop/dragDrop.xhtml
trunk/examples/richfaces-showcase/src/main/webapp/richfaces/dragDrop/dragIndicator.xhtml
Log:
Revised showcase text for Drag and Drop: RFPL1220
Modified:
trunk/examples/richfaces-showcase/src/main/webapp/richfaces/dragDrop/dragDrop.xhtml
===================================================================
---
trunk/examples/richfaces-showcase/src/main/webapp/richfaces/dragDrop/dragDrop.xhtml 2011-03-15
01:40:09 UTC (rev 22212)
+++
trunk/examples/richfaces-showcase/src/main/webapp/richfaces/dragDrop/dragDrop.xhtml 2011-03-15
02:18:30 UTC (rev 22213)
@@ -6,13 +6,14 @@
<ui:composition>
<p>The Richfaces Drag-n-Drop component suite includes three
- components: <b>dragSource</b>, <b>dropTarget </b>and
<b>dragIndicator</b>.</p>
+ components: <b>rich:dragSource</b>, <b>rich:dropTarget</b>, and
<b>rich:dragIndicator</b>.</p>
- <p>That demo shows most important feature of the RichFaces drag and
- drop mechanism. You could mark several different components as
- 'draggable' and define different drag <b>type</b>'s for them
via
- attribute. Then you could add corresponding drop zones and use
<b>acceptType</b>'s
- attributes to define which drop zone will process corresponding dragged
+ <p>This example demonstrates the basic features of the RichFaces drag and
+ drop mechanism. You can mark several different components as
+ 'draggable' with the <b>rich:dragSource</b> component and define
drag
+ types with the <b>type</b> attribute. Then, add corresponding drop zones
+ with the <b>rich:dropTarget</b> and use the <b>acceptType</b>
+ attribute to define which drop zone corresponds to the dragged
elements.</p>
<ui:include src="#{demoNavigator.sampleIncludeURI}" />
@@ -23,38 +24,45 @@
<ui:param name="hideLabel" value="Hide Source" />
</ui:include>
- <p><b>rich:dragSource </b>is used to point to the JSF component
- that becomes draggable. If you want to add a draggable feature to the
- existing component, attach dragSupport as a child component to it.</p>
+ <p>The <b>rich:dragSource</b> component defines the JSF component
+ that becomes draggable. If you want to add a draggable feature to an
+ existing component, attach <b>rich:dragSupport</b> as a child
component.</p>
- <p><b>rich:dropSupport </b>is similar to the dragSupport, but
it's
- used to define the drog zone. dropSupport has a built-in Ajax support.
- I.e. it allows to send an Ajax request and re-render the specified area
- on a page when the Ajax response is returned back. With the <b>dropListener
+ <p>The <b>rich:dropTarget</b> component is
+ used to define the drop zone. The <b>rich:dropTarget</b> component has a
built-in
+ Ajax support: it can send an Ajax request and render the specified area
+ on a page when the Ajax response is returned.
+ <!--
+ With the <b>dropListener
</b>attribute you can point to a method of the backing bean that accepts
<b>
DropEvent </b>as a parameter. This event contains information provided by
<b>
dropValue </b>and <b>dragValue </b>attributes of dropSupport and
- dragSupport.</p>
+ dragSupport.
+ -->
+ </p>
- <p><b>rich:dragIndicator</b> is a special visual representation of
- a dragged object. By default if the component not defined we create a
- copy of dragged elements. But the markup could be redefined by defining
- the markup of the indicator using nested components.</p>
- <fieldset><legend>Note:</legend> That sample shows simple
- usage without indicator defined. We just using predefined CSS classes
- to customize look for different states.</fieldset>
- <p>Note: The parent component for dragSupport and dropSupport
- should be designed to render its children and has two attribute
- "onmouseover" and "onmouseout". You can use
<a4j:outputPanel> as
- a container if the component is not satisfy this requirements. Use
- <a4j:outputPanel> layout="block" to wrap the component with a
- block type layout.</p>
+ <p>The <b>rich:dragIndicator</b> is a visual representation of
+ a dragged object. The markup can be defined
+ the markup of the indicator using nested components. By default, if the
+ component is not defined a
+ copy of the dragged elements are created.</p>
+
+ <fieldset><legend>Note:</legend> This example shows basic
+ usage without an indicator defined. We are just using predefined CSS classes
+ to customize the appearance for different states.</fieldset>
+
+ <p>Note that the parent component for the <b>rich:dragSource</b> and
<b>rich:dropTarget</b>
+ components should be designed to render its children, and should have the
+ <b>mouseover</b> and <b>mouseout</b> event attributes. You can
use <b>a4j:outputPanel</b> as
+ a container if the component does not satisfy these requirements. Use
+ <b><a4j:outputPanel layout="block"></b> to wrap the
component with a
+ block layout.</p>
- <p>The following example demonstrates the drag-n-drop functionality
- on practice. The left list contains the examples of Ajax frameworks. Do
- you know them? The demo helps you to sort them out. Drag one and drag
- over the headers of three panels. If the draggable framework is
+ <p>The following example demonstrates the drag-and-drop functionality
+ in practice. The left list contains the examples of Ajax frameworks. Do
+ you know them? The demonstration helps you to sort them out. Drag an item
+ over the headers of the other three panels. If the draggable framework is
suitable for a certain framework family, it will be accepted and moved
- from source panel to the target list.</p>
+ from the source list to the target list.</p>
</ui:composition>
-</html>
\ No newline at end of file
+</html>
Modified:
trunk/examples/richfaces-showcase/src/main/webapp/richfaces/dragDrop/dragIndicator.xhtml
===================================================================
---
trunk/examples/richfaces-showcase/src/main/webapp/richfaces/dragDrop/dragIndicator.xhtml 2011-03-15
01:40:09 UTC (rev 22212)
+++
trunk/examples/richfaces-showcase/src/main/webapp/richfaces/dragDrop/dragIndicator.xhtml 2011-03-15
02:18:30 UTC (rev 22213)
@@ -5,10 +5,11 @@
xmlns:ui="http://java.sun.com/jsf/facelets">
<ui:composition>
- <p>This sample uses the same code but also there is custom
- indicator defined. That custom indicator uses styling attributes for look
customization.
- However it's still possible to use the same predefined classes as for
- previous sample.'</p>
+ <p>This sample uses the same code as the basic example, but additionally defines a
custom
+ indicator using the <b>rich:dragIndicator</b> component. The custom
indicator uses
+ styling attributes for a customized appearance.</p>
+ <p>It is still possible to use the same predefined classes as for the
+ previous sample.</p>
<ui:include src="#{demoNavigator.sampleIncludeURI}" />
<ui:include src="/templates/includes/source-view.xhtml">
<ui:param name="src" value="#{demoNavigator.sampleIncludeURI}"
/>
@@ -17,4 +18,4 @@
<ui:param name="hideLabel" value="Hide Source" />
</ui:include>
</ui:composition>
-</html>
\ No newline at end of file
+</html>