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