# RotationHandle

`RotationHandle` rotates its controller around the frame center. It sits 24 CSS pixels beyond the top edge and uses an 8 CSS-pixel visual with a default 24 CSS-pixel hit region. Provide a writable radians signal and enable `rotate` on the controller.

```tsx
import { RotationHandle, useManipulation, useSignal } from "@pibbl/core";

const box = useSignal({ left: 40, top: 32, width: 180, height: 100 });
const rotation = useSignal(0);
const manipulation = useManipulation({ box, rotation, rotate: {} });

<RotationHandle controller={manipulation} />;
```

Related types: [PibblRotationHandleProps](/reference/types/events/#pibblrotationhandleprops).

Readout presentation uses `style.readout` with local inactive/focused/active overrides.
Use `formatReadout` for application-defined units; labels remain inside the visible canvas.
See [handle guides and readouts](/guides/manipulation/#handle-guides-and-readouts).

Related presentation types: [PibblRotationHandleStyle](/reference/types/events/#pibblrotationhandlestyle), [PibblManipulationReadoutStyle](/reference/types/events/#pibblmanipulationreadoutstyle).

## API details from source

<span id="api-RotationHandle"></span>

Draws an interactive handle for rotating a manipulation target.

```ts
RotationHandle: PibblPrimitiveComponent<PibblRotationHandleProps, PrimitiveInput<PibblRotationHandleProps, PibblRotationHandleStyle>>
```

Related API: [RotationHandle](/reference/components/rotation-handle/), [PibblPrimitiveComponent](/reference/types/elements-components/#pibblprimitivecomponent), [PibblRotationHandleProps](/reference/types/events/#pibblrotationhandleprops), [PrimitiveInput](/reference/types/styles/#primitiveinput), [PibblRotationHandleStyle](/reference/types/events/#pibblrotationhandlestyle).

### Parameters

- **`props`** — Authored component inputs, supplied through JSX or createElement. See the linked
props and style types.

### Throws

When called directly; Pibbl mounts this component through JSX or createElement.

### See also

[PibblRotationHandleProps](/reference/types/events/#pibblrotationhandleprops)

[PibblRotationHandleStyle](/reference/types/events/#pibblrotationhandlestyle)

[View source — packages/core/src/lib/manipulation/handles.ts:611](/source/packages/core/src/lib/manipulation/handles-ts/#L611)

## Implementation guidance for agents

Read the [Input, focus, and native HTML companion](/agents/topics/input/) for ownership, adaptation, failure modes, and verification. [Agent start](/agents/) provides the version-selection workflow.

## Complete minimal examples

- [Style resize and rotation handles](/minimal-examples/manipulation/handles/): Add corner handles, a rotation connector, an angle arc, and gesture readouts. [Plain source](/minimal/manipulation/handles.tsx)
## Documentation version

Documentation built with @pibbl/core 0.0.2, revision 272a94a. ALPHA — NOT FOR PRODUCTION USE.