Note: This documentation is for the old 0.8.0 version of A-Frame. Check out the documentation for the current 1.6.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.
gripchanged Grip button changed.
menudown Menu button pressed.
menuup Menu button released.
menuchanged Menu button changed.
systemdown System button pressed.
systemup System button released.
systemchanged System button changed.
trackpaddown Trackpad pressed.
trackpadup Trackpad released.
trackpadchanged Trackpad button changed.
triggerdown Trigger pressed.
triggerup Trigger released.
triggerchanged Trigger changed.