HTML attribute: capture

Draft

This page is not complete.

The capture attribute specifies that, optionally, a new file should be captured, and which device should be used to capture that new media of a type defined by the accept attribute. Values include user and environment. The capture attribute is supported on the file input type.

The capture attribute takes as it's value a string that specifies which camera to use for capture of image or video data, if the accept attribute indicates that the input should be of one of those types.

Value Description
user The user-facing camera and/or microphone should be used.
environment The outward-facing camera and/or microphone should be used

Note: capture was previously a Boolean attribute which, if present, requested that the device's media capture device(s) such as camera or microphone be used instead of requesting a file input.

Examples

When set on a file input type, operating systems with microphones and cameras will display a user interface allowing the selection from an existing file or the creating of a new one.

<p>
	<label for="soundFile">What does your voice sound like?:</label>
	<input type="file" id="soundFile" capture="user" accept="audio/*">
	</p>
	<p>
	<label for="videoFile">Upload a video:</label>
	<input type="file" id="videoFile" capture="environment" accept="video/*">
	</p>
	<p>
	<label for="imageFile">Upload a photo of yourself:</label>
	<input type="file" id="imageFile" capture="user" accept="image/*">
	</p>

Note these work better on mobile devices; if your device is a desktop computer, you'll likely get a typical file picker.

Specifications

Specification Status
HTML Media Capture
The definition of 'capture attribute' in that specification.
Recommendation

Browser compatibility

No compatibility data found for html.elements.attribute.capture.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.

See also