DragControls: Add mouseButtons

[puxiao]

This PR introduces a new property mouseButtons to DragControls.

This enhancement allows users to customize which mouse button can trigger drag interactions.

This makes it easy to use DragControls with other controllers.

For example: DragControls + OrbitControls

const myOrbitControls = new OrbitControls(...)

const myDragControls = new DragControls(...)
+ myDragControls.mouseButtons = { LEFT: MOUSE.DRAG, MIDDLE: null, RIGHT: null }

myDragControls.addEventListener('dragstart', () =>{
  myOrbitControls.enabled = false
})

myDragControls.addEventListener('dragend', () =>{
  myOrbitControls.enabled = true
})

I can achieve the following results:

• MOUSE.LEFT (selected) - drag mesh
• MOUSE.LEFT (no selected) - rotation of the camera
• MOUSE.RIGH - camera panning
• MOUSE.MIDDLE - camera zooming

[Mugen87]

What I don't like about our control classes is the fact that stuff like this is implemented differently in each module.

IMO, it's time to think about THREE.Controls which acts as an abstract upper class for all concrete controls. Mouse and keyboard configuration could be part of THREE.Controls. E.g.

class Controls extends EventDispatcher {

	constructor( object, domElement ) {

		super();

		this.object = object;
		this.domElement = domElement;

		this.enabled = true;

		this.keys = {};
		this.mouseButtons = { LEFT: null, MIDDLE: null, RIGHT: null };
		this.touches = { ONE: null, TWO: null };

	}

	connect() {}

	disconnect() {}

	dispose() {}

	update() {}

}

I don't think getters and setters are required though. Controls can predefine keys, mouseButtons and touches and the developer can overwrite these properties if required.

[puxiao]

IMO, it's time to think about THREE.Controls which acts as an abstract upper class for all concrete controls. Mouse and keyboard configuration could be part of THREE.Controls. E.g.

I hope that day comes soon.

I have revised this PR, I don't know if it meets your expectations.

[github-actions]

📦 Bundle size

Full ESM build, minified and gzipped.

Filesize dev	Filesize PR	Diff
685.1 kB (169.6 kB)	685.1 kB (169.6 kB)	+7 B

🌳 Bundle size after tree-shaking

Minimal build including a renderer, camera, empty scene, and dependencies.

Filesize dev	Filesize PR	Diff
462 kB (111.5 kB)	462 kB (111.5 kB)	+0 B

[Mugen87]

I have refactored DragControls based on your PR. Would these changes work for you as well?

#29079

[puxiao]

Good job !!!