<a-light>

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

A light changes the lighting and shading of the scene.

Examples

<!-- Red directional light shining from the top left. -->
<a-light color="red" position="-1 1 0"></a-light>

<!-- Blue point light, 5 meters in the air. -->
<a-light type="point" color="blue" position="0 5 0"></a-light>

<!-- Dim ambient lighting. -->
<a-light type="ambient" color="#222"></a-light>

Attributes

Attribute Component Mapping Default Value
angle light.angle 60
color light.color #fff
decay light.decay 1
distance light.distance 0.0
ground-color light.groundColor #fff
intensity light.intensity 1.0
penumbra light.penumbra 0.0
type light.type directional
target light.target null

Differences with the Default Lighting

When we add a light, A-Frame will remove the default lighting setup (i.e., one directional light from the top-left, and one small ambient light).