Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

L’attribut capture d’un champ de fichier : user et environment

Dans un champ de fichier, `capture` indique une préférence pour créer un nouveau fichier multimédia. Pour les photos et les vidéos, `user` privilégie la caméra avant et `environment` la caméra tournée vers l’extérieur.

Version : W3C HTML Media Capture Recommendation (2018); implementation support varies

Syntaxe

<input type="file" accept="image/*" capture="user">
<input type="file" accept="image/*" capture="environment">

capture est un attribut de HTML Media Capture qui s’utilise sur un élément input de type="file". Indiquez le type de fichier attendu avec accept : image/* pour les images, video/* pour les vidéos ou audio/* pour le son. Le champ reste un champ de fichier : l’attribut ne fournit pas de flux en direct à la page et n’envoie pas le fichier.

Pour les photos et les vidéos, capture="user" privilégie la caméra tournée vers la personne, généralement celle de l’avant. capture="environment" privilégie la caméra tournée vers l’extérieur, généralement celle de l’arrière. Précisez la valeur : capture seul ne sélectionne aucune de ces deux orientations.

C’est une indication, pas une obligation. Si l’orientation souhaitée n’est pas disponible, le navigateur peut utiliser son mode par défaut. Selon l’appareil et la prise en charge, il peut aussi afficher un menu ou un sélecteur de fichiers classique. S’il est important de pouvoir choisir un fichier existant, proposez un champ distinct sans capture. accept ne vérifie pas le contenu des fichiers : validez côté serveur ceux qui y sont envoyés.

Exemples

<!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>

Résultat

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.

Le premier champ privilégie la caméra avant, le deuxième la caméra arrière et le troisième ne demande pas de capture. Comparez ce que chacun ouvre sur mobile et sur ordinateur. L’exemple n’envoie aucun fichier.

Leçons associées

  • HTML · Leçon 7 · Intermédiaire · Version : 2

Sources