drag
Drag a labeled source onto a labeled drop target
Drag-and-drop between two labeled elements (kanban cards, reorder lists, drop zones).
Syntax
When I drag "<source>" to "<target>" [by …]Find hints apply to the source only. The target uses auto-find.
Qualifiers
| Qualifier | Role | Example |
|---|---|---|
to | Drop target label | drag "Item A" to "Drop zone" |
by … | Optional find hint on the source | drag "card-1" by data-testid to "Done" |
Requirements
| Item | Contract |
|---|---|
| Element / control shape | Source and target both use general resolve (fill → click → checkbox) |
| How the label binds | Find hint applies to the source only; target is always auto-find |
| Qualifiers that change resolve | to = drop target label |
| Platform | Web only (v1) |
| Wrong shape → use instead | Non-draggable custom widgets without resolvable labels → expose id/testid/aria-label |
See also UI contracts.
Examples
When I drag "Item A" to "Drop zone"Notes
- Labeled action resolve auto-wait (~30s) applies to both source and target.
- Web only for v1 (Appium returns unsupported).