Note: This documentation is for the old 0.4.0 version of A-Frame. Check out the documentation for the current 1.5.0 version

The vive-controls component interfaces with the HTC Vive controllers/wands. It wraps the tracked-controls component while adding button mappings, events, and a Vive controller model that highlights the pressed buttons (trigger, grip, menu, system) and trackpad.


<a-entity vive-controls="hand: left"></a-entity>
<a-entity vive-controls="hand: right"></a-entity>


Property Description Default Value
buttonColor Button colors when not pressed. #FAFAFA (off-white)
buttonHighlightColor Button colors when pressed and active. #22D1EE (light blue)
hand The hand that will be tracked (i.e., right, left). left
model Whether the Vive controller model is loaded. true
rotationOffset Offset to apply to model rotation. 0


Event Name Description
gripdown Grip button pressed.
gripup Grip button released.
menudown Menu button pressed.
menuup Menu button released.
systemdown System button pressed.
systemup System button released.
trackpaddown Trackpad pressed.
trackpadup Trackpad released.
triggerdown Trigger pressed.
triggerup Trigger released.