6.7.1. < rich:dragIndicator > available since 3.0.0

### Create new RichFaces Documentation Jira issue

Summary
255 characters left
Description
Environment
This will launch the RichFaces Jira page - to complete your feedback please login if needed, and submit the Jira.

JBoss.org Community Documentation

- Prev
- Next

### 6.7.1. < rich:dragIndicator > available since 3.0.0

expand all

#### 6.7.1.1. Description

This is a component for defining what appears under the mouse cursor during drag-and-drop operations. The displayed drag indicator can show information about the dragged elements.

Figure 6.48. <rich:dragIndicator> component

#### 6.7.1.2. Key Features

- Customizable look and feel

- Customizable marker according to the type of dragable elements

#### 6.7.1.3. Details of Usage

expand all

In the simplest way the component could be defined empty - in that case a default indicator is shown like this:

Figure 6.49. The simplest <rich:dragIndicator>

For indicator customization you need to define one of the following facets:

- "single" — indicator shown when dragging a single item;

- "multiple" — indicator shown when dragging several items.

## Note:

The current implementation of the <rich:dragIndicator> component does not support multiple items selection. The feature is described for future releases.

Thus for specify a look-and-feel you have to define one of these facets and include into it a content that should be shown in indicator.

##### 6.7.1.3.1. Macro definitions

To place some data from drag or drop zones into component you can use macro definitions. They are being defining in the following way:

- <rich:dndParam> component with a specific name and value is being included into a drag/drop support component (an image can be defined as placed inside <rich:dndParam> without defining a value).

- in needed place a parameter value is included into the marking of indicator using syntax (name of parameter)

For instance, this:

    ...

    <rich:dropSupport...>

            <rich:dndParam name="testDrop">

                    <h:graphicImage value="/images/file-manager.png" />

            </rich:dndParam>

    </rich:dropSupport>

    ...

Is placed into indicator as follows:

    ...

    <f:facet name="single">

            {testDrop}

    </f:facet>

    ...

##### 6.7.1.3.2. Predefined macro definitions

Indicator can accept two default macro definitions:

- marker

- label

Thus including one of these elements in the marking of indicator, in other words after setting up appropriate parameters in DnD components and defining only default indicator - without specifying facets - a developer gets these parameters values displayed in indicator in the order "marker - label".

##### 6.7.1.3.3. Marker customization

The macro definition "marker" can be customized depending on what a draggable element is located over. For that you should define one of these three parameters (specify a parameter with one of three names):

- `accept`

Parameter will be set instead of {marker} into indicator when a draggable element is positioned over drop zone that accept this type of elements

- `reject`

Parameter is set instead of {marker} into indicator when a draggable element is positioned over drop zone that doesn't accept this type of elements

- `default`

Parameter is set instead of {marker} into indicator when a draggable element is positioned over all the rest of page elements

## Note:

If you use <rich:dragIndicator> inside a form do not forget to use id like `formId:indicatorID` defined in <rich:dragSupport> indicator attribute.

#### 6.7.1.4. Reference Data

Table of <rich:dragIndicator> attributes.

Table 6.68. Component Identification Parameters

Name | Value
--- | ---
component-type | org.richfaces.Draggable
component-class | org.richfaces.component.html.HtmlDragIndicator
component-family | org.richfaces.DragIndicator
renderer-type | org.richfaces.DragIndicatorRenderer
tag-class | org.richfaces.taglib.DragIndicatorTag

#### 6.7.1.5. Relevant Resources Links

On the component LiveDemo page you can see the example of <rich:dragIndicator> usage and sources for the given example.

- Prev6.7. Drag-Drop Support
- Top of page
- Front page
- Next6.7.2. < rich:dragSupport > ...