SIGN IN SIGN UP

docs(scraps): Add drag handle best practices (#122551)

`dragHandle.mdx` covered the props and the accessibility contract but
not the part people actually get wrong, which is what to do with the
delta the handle reports. Adds a Best practices section drawn from what
`SplitPanel` and `useColumnResize` already do rather than general
advice: clamp the delta yourself since the handle holds no size, pass
back the size you rendered, accumulate through the drag and commit once
at the end, and check the drag moved before committing.

Also corrects a sentence that was wrong. The docs said setting
`isSizedFirst` to `false` keeps the cursor and the keys pointing the
direction the divider can move. It only changes the cursor.
`useDragSeparator` never passes it to `useDragMove`, and the keyboard
branch is pure screen direction, which is why `SplitPanel` flips the
sign itself. Anyone who trusted it and built a trailing edge panel got
an inverted drag and an inverted keyboard.

Frontmatter gains WCAG 2.5.8, which the 24px pointer target already
satisfies and just was not listed.

Docs only, no source changes. Closes DE-1366
C
Chrisandra committed
d0ae37b2083e971ef11925eb119ba72760ff1ef7
Parent: 86f1236
Committed by GitHub <noreply@github.com> on 8/28/2026, 6:59:27 PM