Skip to main content Link Menu Expand (external link) Copy Copied

Handles in controls can be enabled selectively.

showAll link

Hiding all handles:

// ...
const controls = ControlsManager.anchor(box);
controls.showAll(false); // or true to make all handles visible

showByNames link

Hiding handles selectively:

import { DEFAULT_HANDLE_GROUP_NAME } from 'three-freeform-controls';
// ...
const controls = ControlsManager.anchor(box);
], false); // or true to make these handles visible, if not already

The above snippet hides the positive translation, negative translation, and rotation z-handles. Details on the handle names can be found in the API docs.

If the user wants to show only some specific handles, it can be done by:

  1. showAll(false): to hide all the handles at first
  2. showByNames([handlesToShow], true): to display only selective handles

Since the handles are Three.js objects, we can modify their display property directly as well:

const controls = ControlsManager.anchor(box);
// hiding the rotation handle in the yz plane (x-axis is the normal)
controls.rotationX.visible = false;

View example

Next section: Customize Handles