CKTIS / HTML
Het attribuut capture op bestandsvelden: user en environment
Op een bestandsveld geeft `capture` een voorkeur aan voor het maken van een nieuw mediabestand. Voor foto’s en video’s vraagt `user` om de camera aan de voorkant en `environment` om de naar buiten gerichte camera.
Versie: W3C HTML Media Capture Recommendation (2018); implementation support varies
Syntax
<input type="file" accept="image/*" capture="user">
<input type="file" accept="image/*" capture="environment">capture is een attribuut uit HTML Media Capture voor een input met type="file". Geef met accept het verwachte bestandstype aan: image/* voor afbeeldingen, video/* voor video of audio/* voor audio. Het blijft een bestandsveld: het attribuut geeft de pagina geen livestream en uploadt het bestand niet.
Voor foto’s en video geeft capture="user" de voorkeur aan een camera die naar de gebruiker is gericht, meestal die aan de voorkant. capture="environment" geeft de voorkeur aan een camera die naar buiten is gericht, meestal die aan de achterkant. Schrijf de waarde expliciet: capture zonder waarde kiest geen van beide richtingen.
Het is een aanwijzing, geen verplichting. Is de gewenste richting niet beschikbaar, dan kan de browser de standaardinstelling gebruiken. Afhankelijk van het apparaat en de browserondersteuning kan er ook een menu of een gewoon bestandskeuzevenster verschijnen. Als het belangrijk is om een bestaand bestand te kunnen kiezen, bied dan een apart veld zonder capture aan. accept controleert de inhoud niet: valideer geüploade bestanden op de server.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Photo capture preferences</title>
</head>
<body>
<p>
<label for="front-photo">Take a selfie (front camera preferred)</label><br>
<input id="front-photo" type="file" accept="image/*" capture="user">
</p>
<p>
<label for="rear-photo">Take a photo (rear camera preferred)</label><br>
<input id="rear-photo" type="file" accept="image/*" capture="environment">
</p>
<p>
<label for="image-file">Choose an image file</label><br>
<input id="image-file" type="file" accept="image/*">
</p>
<script>
const controls = [...document.querySelectorAll('input[type="file"]')];
const descriptions = new Map([
['user', 'requests a front-facing camera'],
['environment', 'requests an outward-facing camera'],
[null, 'makes no capture request']
]);
const expectedPreferences = [...descriptions.keys()];
const isVisible = element =>
element.getClientRects().length > 0 &&
getComputedStyle(element).visibility === 'visible';
// Check the controls and their markup, not which picker or camera opens.
if (controls.length !== expectedPreferences.length ||
!controls.every((control, index) =>
isVisible(control) &&
[...control.labels].some(label => isVisible(label) && label.innerText.trim()) &&
control.accept === 'image/*' &&
control.getAttribute('capture') === expectedPreferences[index] &&
!control.form)) {
throw new Error('Expected three visible, labeled image file controls with the specified capture preferences and no upload form.');
}
const [first, second, third] = controls.map(control =>
descriptions.get(control.getAttribute('capture'))
);
console.log(
'The page displays three labeled image file controls. ' +
`The first ${first}, the second ${second}, and the third ${third}. ` +
'The browser and device determine what opens when each control is activated. ' +
'The page does not upload anything.'
);
</script>
</body>
</html>Resultaat
The page displays three labeled image file controls. The first requests a front-facing camera, the second requests an outward-facing camera, and the third makes no capture request. The browser and device determine what opens when each control is activated. The page does not upload anything.
Het eerste veld geeft de voorkeur aan de camera aan de voorkant, het tweede aan die aan de achterkant. Het derde vraagt niet om een opname. Vergelijk wat elk veld op een mobiel apparaat en op een desktopcomputer opent. Het voorbeeld uploadt niets.
Gerelateerde lessen
- HTML · Les 7 · Gemiddeld · Versie: 2