Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

O atributo capture num campo de ficheiro: user e environment

Num campo de ficheiro, `capture` indica uma preferência ao criar um novo ficheiro multimédia. Para fotografias e vídeos, `user` privilegia a câmara frontal e `environment` a câmara virada para o exterior.

Versão: W3C HTML Media Capture Recommendation (2018); implementation support varies

Sintaxe

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

capture é um atributo de HTML Media Capture usado num elemento input com type="file". Usa accept para indicar o tipo de ficheiro esperado: image/* para imagens, video/* para vídeo ou audio/* para áudio. Continua a ser um campo de ficheiro: o atributo não fornece um fluxo multimédia em direto à página nem envia o ficheiro.

Para fotografias e vídeos, capture="user" dá preferência à câmara virada para o utilizador, normalmente a frontal. capture="environment" prefere a câmara virada para o exterior, normalmente a traseira. Indica o valor de forma explícita: capture sem valor não seleciona nenhuma destas orientações.

É uma indicação, não uma obrigação. Se a orientação pretendida não estiver disponível, o navegador pode usar o modo predefinido. Consoante o dispositivo e o suporte do navegador, também pode apresentar um menu ou um seletor de ficheiros normal. Se for importante escolher um ficheiro existente, disponibiliza um campo separado sem capture. accept não valida o conteúdo dos ficheiros: se forem enviados para um servidor, valida-os nesse servidor.

Exemplos

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

Resultado

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.

O primeiro campo prefere a câmara frontal, o segundo prefere a traseira e o terceiro não pede captura. Compara o que cada campo abre num telemóvel e num computador. O exemplo não envia ficheiros.

Lições relacionadas

  • HTML · Lição 7 · Intermédio · Versão: 2

Fontes