Struct DragPreview 

pub struct DragPreview<'a> {
    pub drag_state: &'a DragState,
    pub config: DragPreviewConfig,
}

Overlay widget that renders a drag preview at the cursor position.

The preview renders either a custom widget (from DragState::preview) or a text-based fallback from DragPayload::display_text.

Rendering

1. Pushes the configured opacity onto the buffer’s opacity stack.
2. Optionally fills the background.
3. Renders the custom preview widget or fallback text.
4. Optionally draws a border.
5. Pops the opacity.

Invariants

• The preview is always clamped to the viewport bounds.
• Opacity is always restored (pop matches push) even if the area is empty.
• At EssentialOnly degradation or below, the preview is not rendered (it is decorative).

Fields

drag_state: &'a DragState

Current drag state (position, payload, optional custom preview).

config: DragPreviewConfig

Visual configuration.

Implementations

impl<'a> DragPreview<'a>

pub fn new(drag_state: &'a DragState) -> Self

Create a new drag preview for the given state.

pub fn with_config(drag_state: &'a DragState, config: DragPreviewConfig) -> Self

Create a drag preview with custom configuration.

Trait Implementations

impl Widget for DragPreview<'_>

fn render(&self, area: Rect, frame: &mut Frame<'_>)

Render the widget into the frame at the given area.

fn is_essential(&self) -> bool

Whether this widget is essential and should always render.