Back to Aframe

xr-mode-ui

docs/components/xr-mode-ui.md

1.7.11.2 KB
Original Source

The xr-mode-ui component configures or disables the enter VR and AR buttons. Buttons only display if the browser supports the corresponding modes (AR or VR). The xr-mode-ui component applies only to the <a-scene> element. If we wish to simply toggle the UI, use CSS instead.

Example

html
<a-scene xr-mode-ui="enabled: false"></a-scene>

Properties

PropertyDescriptionDefault Value
enabledWhether or not to display UI related to entering VR.true
enterVRButtonSelector to a custom VR button. On click, the button will enter VR.''
enterVREnabledIf the VR button is displayed when applicable.true
enterARButtonSelector to a custom AR button. On click, the button will enter AR.''
enterAREnabledIf the AR button is displayed when applicable.true
XRModeIf the AR button (ar), VR button (vr), or both buttons will be displayed (xr).vr

Specifying Custom Enter VR and AR Buttons

html
<a-scene
  xr-mode-ui="enterVRButton: #myEnterVRButton; enterARButton: #myEnterARButton; XRMode: xr;">
  <!-- Style the button with images and/or custom CSS. -->
  <a id="myEnterVRButton" href="#"></a>
  <a id="myEnterARButton" href="#"></a>
</a-scene>