База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

Атрибутът capture в поле за избор на файл: user и environment

Атрибутът `capture` в поле за избор на файл подсказва как да се създаде нов мултимедиен файл. За снимки и видео `user` предпочита предната камера, а `environment` — камерата, насочена към околната среда.

Версия: W3C HTML Media Capture Recommendation (2018); implementation support varies

Синтаксис

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

capture е атрибут от HTML Media Capture за елемент input с type="file". Използвай accept, за да посочиш очаквания вид файл: image/* за изображения, video/* за видео или audio/* за звук. Това остава поле за избор на файл: атрибутът не предоставя на страницата поток на живо и не качва файла.

За снимки и видео capture="user" предпочита камерата, насочена към потребителя, обикновено предната. capture="environment" предпочита камерата, насочена към околната среда, обикновено задната. Посочи стойността изрично: capture без стойност не избира нито една от двете посоки.

Това е подсказка, а не изискване. Ако предпочитаната посока не е налична, браузърът може да използва режима си по подразбиране. В зависимост от устройството и поддръжката в браузъра може да се покаже меню или обикновен прозорец за избор на файл. Ако е важно да може да се избере съществуващ файл, предложи отделно поле без capture. accept не проверява съдържанието на файловете: ако ги приемаш на сървър, проверявай ги там.

Примери

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

Резултат

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.

Първото поле предпочита предната камера, второто — задната, а третото не заявява заснемане. Сравни какво се отваря на мобилно устройство и на настолен компютър. Примерът не качва файлове.

Свързани уроци

  • HTML · Урок 7 · Средно · Версия: 2

Източници