Как вставить картинку в html на фон: Как добавить фоновый рисунок на веб-страницу?

Не делайте этого:

Что делать, если автор должен иметь CSS-изображение в div, который содержит контент

Иногда в стеке CSS есть зависимости и возня с это может привести к нарушению дизайна и верстки сайта или запросу изменить код мог зависнуть в одобрении от различных заинтересованные стороны. В случаях, когда автор должен иметь фон изображение в

Это хак, потому что семантически альтернативный текст не включен. элемент, который на самом деле имеет изображение. Однако с экрана точка зрения читателя <дел> с фоновым изображением игнорируется, поэтому размещение <диапазон> сразу после него будет предоставлять эту информацию таким образом, что будет казаться, что альтернативный текст находится в том же месте, что и изображение на заднем плане.

Сводка

• Старайтесь не использовать CSS для важных информационных изображений
• Для фоновых изображений, созданных с помощью CSS, рекомендуется предоставить альтернативный текст. При этом поместите изображение в собственное пустой с меткой aria-label и role="изображение Это также верно, в ситуации где CSS должен использоваться для информационного содержания.
• Если
  с изображением CSS абсолютно ДОЛЖЕН содержать другой контент, затем укажите пустой с aria-label и role="img" сразу после

  , который имеет изображение.

Не стесняйтесь комментировать в Твиттере @davidmacd

Информация об авторе:

Дэвид Макдональд — ветеран-член WCAG, соредактор книги «Использование WAI ARIA в HTML5 и член Целевой группы по доступности HTML5. Мнения мои собственные.

Все статьи блога

next/image | Next.js

• Компонент изображения

Версия	Изменения
v13.2.0	добавлена ​​конфигурация contentDispositionType .
v13.0.6	ссылка добавлена ​​опора.
v13.0.0	оболочка удалена. layout , objectFit , objectPosition , lazyBoundary , lazyRoot реквизит удален. Требуется или . onLoadingComplete получает ссылку на img элемент. Конфиг встроенного загрузчика удален.
v12.3.0	remotePatterns и неоптимизированные конфигурация стабильна.
v12.2.0	Экспериментальная добавлена ​​конфигурация remotePatterns и экспериментальная неоптимизированная . layout="raw" удален.
v12.1.1	добавлен стиль . Экспериментальная* поддержка 9Добавлено 0005 layout=»raw» .
v12.1.0	добавлено опасное разрешение SVG и contentSecurityPolicy . Добавлен
v12. 0.9	lazyRoot .
v12.0.0	добавлена ​​конфигурация форматов . Добавлена ​​поддержка AVIF. Оболочка изменена на .
v11.1.0	добавлены реквизиты onLoadingComplete и lazyBoundary .
v11.0.0	src prop поддерживает статический импорт. заполнитель добавлен реквизит. blurDataURL добавлен реквизит.
v10.0.5	загрузчик проп добавлен.
v10.0.1	макет 9Добавлен реквизит 0006.
v10.0.0	следующее/изображение введено.

Примечание : Эта страница является справочной информацией по API для компонента next/image . Обзор функций и информацию об использовании см. в документации по компоненту изображения и оптимизации изображения.

Примечание . Если вы используете версию Next.js до 13, вам следует использовать документацию next/legacy/image, поскольку компонент был переименован.

Этот компонент next/image использует встроенную ленивую загрузку браузера, которая может вернуться к быстрой загрузке для старых браузеров до Safari 15.4. При использовании заполнителя размытия старые браузеры до Safari 12 будут использовать пустой заполнитель. При использовании стилей с шириной / высотой из auto можно вызвать сдвиг макета в старых браузерах до Safari 15, которые не сохраняют соотношение сторон. Подробнее см. в этом видео MDN.

• Safari 15 и 16 отображают серую рамку при загрузке. Safari 16.4 исправил эту проблему. Возможные решения:
  • Используйте CSS @supports (шрифт: -apple-system-body) и (-webkit-appearance: нет) { img[loading="lazy"] { clip-path: inset(0. 6px) } }
  • Использовать приоритет , если изображение находится выше сгиба
• Firefox 67+ отображает белый фон при загрузке. Возможные решения:
  • Включить форматы AVIF
  • Использовать заполнитель = "размытие"

Для компонента требуются следующие свойства.

src

Должен быть одним из следующих:

1. Статически импортированный файл изображения или
2. Строка пути. Это может быть абсолютный внешний URL, или внутренний путь в зависимости от реквизита загрузчика.

При использовании внешнего URL-адреса необходимо добавить его в remotePatterns в next.config.js .

width

Свойство width представляет ширину рендеринга в пикселях, поэтому оно влияет на размер изображения.

Требуется, за исключением статически импортированных изображений или изображений со свойством fill .

height

Свойство height представляет визуализируемую высоту в пикселях, поэтому оно влияет на размер изображения.

Требуется, за исключением статически импортированных изображений или изображений с заполните свойство .

alt

Свойство alt используется для описания изображения для программ чтения с экрана и поисковых систем. Это также резервный текст, если изображения были отключены или при загрузке изображения возникла ошибка.

Должен содержать текст, который мог бы заменить изображение без изменения смысла страницы. Он не предназначен для дополнения изображения и не должен повторять информацию, уже представленную в подписях над или под изображением.

Если изображение чисто декоративное или не предназначено для пользователя, свойство alt должно быть пустой строкой ( alt="" ).

Подробнее

Компонент принимает ряд дополнительных свойств помимо тех, которые требуются. В этом разделе описаны наиболее часто используемые свойства компонента Image. Подробнее о редко используемых свойствах см. в разделе «Дополнительные реквизиты».

загрузчик

Пользовательская функция, используемая для разрешения URL-адресов изображений.

Загрузчик — это функция, возвращающая строку URL для изображения при следующих параметрах:

• src
• ширина
• качество

Вот пример использования пользовательского загрузчика:

 импортировать изображение из 'next/image'
const myLoader = ({ источник, ширина, качество }) => {
  return `https://example.com/${src}?w=${width}&q=${качество || 75}`
}
const MyImage = (реквизит) => {
  возвращаться (
    <Изображение
      загрузчик = {мой загрузчик}
      источник = "me.png"
      alt="Изображение автора"
      ширина={500}
      высота={500}
    />
  )
}
 

В качестве альтернативы вы можете использовать конфигурацию loaderFile в файле next. config.js для настройки каждого экземпляра next/image в вашем приложении без передачи реквизита.

fill

Логическое значение, которое заставляет изображение заполнять родительский элемент вместо установки ширины и высоты .

Родительский элемент должен назначить позицию : "относительная" , позиция : "фиксированная" или позиция : "абсолютная" стиль.

По умолчанию элементу img будет автоматически присвоена позиция : «абсолютный» стиль .

По умолчанию изображение подгоняется под размер контейнера. Вы можете предпочесть установить object-fit: "contain" для изображения, которое помещено в почтовый ящик, чтобы соответствовать контейнеру и сохранить соотношение сторон.

В качестве альтернативы, object-fit: "cover" приведет к тому, что изображение заполнит весь контейнер и будет обрезано для сохранения соотношения сторон. Чтобы это выглядело правильно, переполнение: "скрытый" стиль должен быть присвоен родительскому элементу.

См. также:

• позиция
• подходит для объекта
• объект-позиция

размеры

Строка, предоставляющая информацию о том, насколько широким будет изображение в различных контрольных точках. Значение размера сильно повлияет на производительность изображений, использующих заливку или стилизованных под адаптивный размер.

Свойство размеры служит двум важным целям, связанным с производительностью изображения:

Во-первых, значение размера используется браузером для определения размера загружаемого изображения из автоматически сгенерированного исходного набора next/image . Когда браузер делает выбор, ему еще не известен размер изображения на странице, поэтому он выбирает изображение того же или большего размера, чем область просмотра. Свойство размеры позволяет вам сообщить браузеру, что изображение на самом деле будет меньше, чем полноэкранный режим. Если вы не укажете размер в изображении со свойством fill используется значение по умолчанию 100vw (на всю ширину экрана).

Во-вторых, свойство размеры настраивает, как next/image автоматически создает исходный набор изображений. Если значение размеров отсутствует, создается небольшой исходный набор, подходящий для изображения фиксированного размера. Если определено размеров , создается большой исходный набор, подходящий для адаптивного изображения. Если размеры включает такие размеры, как 50vw , которые представляют собой процент ширины области просмотра, тогда исходный набор обрезается, чтобы не включать какие-либо значения, которые слишком малы, чтобы когда-либо быть необходимыми.

Например, если вы знаете, что ваш стиль приведет к тому, что изображение будет отображаться во всю ширину на мобильных устройствах, в макете с двумя столбцами на планшетах и ​​в макете с тремя столбцами на дисплеях настольных компьютеров, вы должны включить свойство размеров, такое как следующее:

 импортировать изображение из 'следующего/изображения'
const Пример = () => (
  

    <Изображение
      исходный код="/example. png"
      наполнять
     
    />
  
)
 

Этот пример размеров может существенно повлиять на показатели производительности. Без размеров 33vw изображение, выбранное с сервера, было бы в 3 раза шире, чем нужно. Поскольку размер файла пропорционален квадрату ширины, без размеров пользователь загрузит изображение в 9 раз больше, чем необходимо.

Подробнее о размерах srcset и :

• web.dev
• мдн

качество

Качество оптимизированного изображения, целое число от 1 до 100 , где 100 — это наилучшее качество и, следовательно, наибольший размер файла. По умолчанию 75 .

priority

При значении true изображение будет иметь высокий приоритет и предварительная загрузка. Ленивая загрузка автоматически отключается для изображений с приоритетом .

Вы должны использовать свойство priority для любого изображения, обнаруженного как элемент Largest Contentful Paint (LCP). Может оказаться целесообразным иметь несколько приоритетных изображений, поскольку разные изображения могут быть элементами LCP для разных размеров области просмотра.

Следует использовать только тогда, когда изображение видно выше сгиба. По умолчанию false .

заполнитель

Заполнитель для использования во время загрузки изображения. Возможные значения: размытие или пустое . По умолчанию пусто .

Когда blur , свойство blurDataURL будет использоваться в качестве заполнителя. Если src — это объект из статического импорта, а импортированное изображение — .jpg , .png , .webp или .avif , тогда blurDataURL будет заполнено автоматически.

Для динамических изображений необходимо указать свойство blurDataURL . Такие решения, как Plaiceholder, могут помочь с созданием base64 .

Когда пусто , во время загрузки изображения не будет заполнителя, только пустое пространство.

Попробуйте:

• Демонстрация размытия заполнитель
• Демонстрация эффекта мерцания с помощью blurDataURL prop
• Демонстрация цветового эффекта с помощью blurDataURL prop

В некоторых случаях может потребоваться более расширенное использование. Компонент дополнительно принимает следующие расширенные свойства.

стиль

Позволяет передавать стили CSS базовому элементу изображения.

Также имейте в виду, что необходимые реквизиты ширины и высоты могут взаимодействовать с вашим стилем. Если вы используете стиль для изменения width , вы также должны установить стиль height="auto" , иначе ваше изображение будет искажено.

onLoadingComplete

Функция обратного вызова, которая вызывается после полной загрузки изображения и удаления заполнителя.

Функция обратного вызова будет вызываться с одним аргументом, ссылкой на базовый элемент .

onLoad

Функция обратного вызова, которая вызывается при загрузке изображения.

Обратите внимание, что событие загрузки может произойти до удаления заполнителя и полного декодирования изображения.

Вместо этого используйте onLoadingComplete .

onError

Функция обратного вызова, которая вызывается, если изображение не загружается.

загрузка

Внимание : Это свойство предназначено только для расширенного использования. Переключение изображение для загрузки с нетерпеливым обычно снижает производительность .

Мы рекомендуем использовать свойство приоритета вместо этого, которое правильно загружает изображение практически для всех случаев использования.

Поведение загрузки изображения. По умолчанию ленивый .

Когда ленивый , отложить загрузку изображения до тех пор, пока оно не достигнет расчетного расстояния от окно просмотра.

Когда хочет , немедленно загрузить образ.

Подробнее

blurDataURL

URL-адрес данных для использоваться в качестве изображения-заполнителя перед src 9Изображение 0006 успешно загружается. Действует только при объединении с заполнителем ="размытие" .

Должно быть изображение в кодировке base64. Оно будет увеличено и размыто, поэтому очень маленькое изображение (10 пикселей или меньше) рекомендуется. Включение больших изображений в качестве заполнителей может снизить производительность вашего приложения.

Попробуйте:

• Демо по умолчанию blurDataURL prop
• Демонстрация эффекта мерцания с помощью blurDataURL prop
• Демонстрация цветового эффекта с blurDataURL реквизит

Вы также можете сгенерировать сплошной URL-адрес данных, соответствующий изображению.

неоптимизированный

При значении true исходное изображение будет отображаться как есть вместо изменения качества, размер или формат. По умолчанию false .

 импорт изображения из 'следующего/изображения'
const UnoptimizedImage = (реквизит) => {
  вернуть <изображение {... реквизит} неоптимизированное />
}
 

Начиная с Next.js 12.3.0, этот реквизит можно назначить всем изображениям путем обновления next.config.js со следующей конфигурацией:

 module.exports = {
  изображений: {
    неоптимизированный: правда,
  },
}
 

Другие свойства компонента будут переданы базовому элемент img за исключением следующего:

• srcSet . Вместо этого используйте размеры устройств.
• расшифровка . Это всегда "асинхронный" .

Удаленные шаблоны

Для защиты вашего приложения от злоумышленников требуется настройка для использования внешних образов. Это гарантирует, что через Next.js Image Optimization API можно будет обслуживать только внешние изображения из вашей учетной записи. Эти внешние образы можно настроить с помощью 9Свойство 0005 remotePatterns в файле next.config.js , как показано ниже:

 module.exports = {
  изображений: {
    удаленные шаблоны: [
      {
        протокол: 'https',
        имя хоста: 'example.com',
        порт: '',
        путь: '/account123/**',
      },
    ],
  },
}
 

Примечание. В приведенном выше примере свойство src для next/image должно начинаться с https://example.com/account123/ . Любой другой протокол, имя хоста, порт или несоответствующий путь ответят ошибкой 400 Bad Request.

Ниже приведен еще один пример свойства remotePatterns в файле next.config.js :

 module.exports = {
  изображений: {
    удаленные шаблоны: [
      {
        протокол: 'https',
        имя хоста: '**. example.com',
      },
    ],
  },
}
 

Примечание. В приведенном выше примере свойство src для next/image должно начинаться с https://img1.example.com или https://me.avatar.example.com или любое количество поддоменов. Любой другой протокол или несоответствующее имя хоста ответит ошибкой 400 Bad Request.

Подстановочные знаки могут использоваться как для pathname , так и для hostname и иметь следующий синтаксис:

• * соответствует одному сегменту пути или поддомену
• ** соответствует любому количеству сегментов пути в конце или поддоменов в начале

Синтаксис ** не работает в середине шаблона.

Домены

Примечание. Мы рекомендуем вместо этого использовать remotePatterns , чтобы вы могли ограничить протокол и путь.

Подобно remotePatterns , конфигурация доменов может использоваться для предоставления списка разрешенных имен хостов для внешних образов.

Однако конфигурация доменов не поддерживает сопоставление шаблонов с подстановочными знаками и не может ограничивать протокол, порт или имя пути.

Ниже приведен пример domains свойство в файле next.config.js :

 module.exports = {
  изображений: {
    домены: ['assets.acme.com'],
  },
}
 

Конфигурация загрузчика

Если вы хотите использовать облачного провайдера для оптимизации изображений вместо использования встроенного API оптимизации изображений Next.js, вы можете настроить loaderFile в вашем next.config.js , как показано ниже. :

 модуль.экспорт = {
  изображений: {
    загрузчик: "пользовательский",
    loaderFile: './my/image/loader.js',
  },
}
 

Это должно указывать на файл относительно корня вашего приложения Next.js. Файл должен экспортировать функцию по умолчанию, которая возвращает строку, например:

 экспортировать функцию по умолчанию myImageLoader({ src, width, quality }) {
  return `https://example. com/${src}?w=${width}&q=${качество || 75}`
}
 

Кроме того, вы можете использовать реквизит загрузчика для настройки каждого экземпляра next/image .

Примеры:

• Пользовательская конфигурация загрузчика изображений

Следующая конфигурация предназначена для расширенных вариантов использования и обычно не требуется. Если вы решите настроить приведенные ниже свойства, вы переопределите любые изменения значений по умолчанию Next.js в будущих обновлениях.

Размеры устройств

Если вы знаете ожидаемую ширину устройства ваших пользователей, вы можете указать список контрольных точек ширины устройства, используя свойство deviceSizes в next.config.js . Эти значения ширины используются, когда компонент next/image использует размеры prop, чтобы обеспечить правильное изображение для устройства пользователя.

Если конфигурация не указана, используется значение по умолчанию, указанное ниже.

 модуль.экспорт = {
  изображений: {
    размер устройства: [640, 750, 828, 1080, 1200, 1920, 2048, 3840],
  },
}
 

Размеры изображений

Список ширины изображений можно указать с помощью свойства images.imageSizes в файле next.config.js . Эти значения ширины объединяются с массивом размеров устройств для формирования полного массива размеров, используемого для создания наборов srcset изображений.

Причина существования двух отдельных списков заключается в том, что imageSizes используется только для изображений, которые обеспечивают размеров prop, что указывает на то, что изображение меньше полной ширины экрана. Поэтому все размеры в imageSizes должны быть меньше наименьшего размера в deviceSizes.

Если конфигурация не указана, используется значение по умолчанию, указанное ниже.

 модуль.экспорт = {
  изображений: {
    Размер изображения: [16, 32, 48, 64, 96, 128, 256, 384],
  },
}
 

Допустимые форматы

API оптимизации изображений по умолчанию автоматически определяет поддерживаемые браузером форматы изображений с помощью заголовка запроса Accept .

Если заголовок Accept соответствует более чем одному из настроенных форматов, используется первое совпадение в массиве. Поэтому порядок массива имеет значение. Если совпадений нет (или исходное изображение анимировано), API оптимизации изображений вернется к исходному формату изображения.

Если конфигурация не указана, используется значение по умолчанию, указанное ниже.

 модуль.экспорт = {
  изображений: {
    форматы: ['изображение/webp'],
  },
}
 

Вы можете включить поддержку AVIF со следующей конфигурацией.

 модуль.экспорт = {
  изображений: {
    форматы: ['изображение/avif', 'изображение/webp'],
  },
}
 

Примечание. Обычно для кодирования AVIF требуется на 20 % больше времени, но сжатие на 20 % меньше по сравнению с WebP. Это означает, что при первом запросе изображения оно обычно выполняется медленнее, а последующие кэшированные запросы будут выполняться быстрее.

Примечание. Если вы самостоятельно размещаете прокси-сервер или CDN перед Next.js, вы должны настроить прокси-сервер для пересылки заголовка Accept .

Ниже описан алгоритм кэширования для загрузчика по умолчанию. Для всех других загрузчиков обратитесь к документации вашего облачного провайдера.

Изображения динамически оптимизируются по запросу и сохраняются в каталоге /cache/images . Оптимизированный файл изображения будет использоваться для последующих запросов до истечения срока действия. Когда делается запрос, который соответствует кэшированному, но просроченному файлу, просроченное изображение немедленно предоставляется устаревшим. Затем изображение снова оптимизируется в фоновом режиме (это также называется ревалидацией) и сохраняется в кэше с новой датой истечения срока действия.

Состояние кэша изображения можно определить, прочитав значение заголовка ответа x-nextjs-cache . Возможны следующие значения:

• MISS - путь отсутствует в кеше (встречается не более одного раза, при первом посещении)
• STALE — путь находится в кеше, но превышено время повторной проверки, поэтому он будет обновлен в фоновом режиме
• HIT - путь находится в кеше и не превысил время повторной проверки

Срок действия (или, скорее, максимальный возраст) определяется либо конфигурацией MinimumCacheTTL , либо заголовком Cache-Control восходящего потока изображения , в зависимости от того, что больше. В частности, используется значение max-age заголовка Cache-Control . Если найдены и s-maxage , и max-age , то предпочтительнее s-maxage . max-age также передается любым нижестоящим клиентам, включая CDN и браузеры.

• Можно настроить MinimumCacheTTL для увеличения продолжительности кэширования, если исходное изображение не включает заголовок Cache-Control или значение очень низкое.
• Можно настроить deviceSizes и imageSizes , чтобы уменьшить общее количество возможных генерируемых изображений.
• Вы можете настроить форматы, чтобы отключить несколько форматов в пользу одного формата изображения.

Минимальный TTL кэша

Можно настроить время жизни (TTL) в секундах для кэшированных оптимизированных изображений. Во многих случаях лучше использовать импорт статического изображения, который автоматически хеширует содержимое файла и навсегда кэширует изображение с Cache-Control заголовок неизменяемый .

 модуль.экспорт = {
  изображений: {
    минимальный кэшTTL: 60,
  },
}
 

Срок действия (или, скорее, максимальный возраст) оптимизированного образа определяется либо заголовком MinimumCacheTTL , либо заголовком восходящего образа Cache-Control , в зависимости от того, что больше.

Если вам нужно изменить поведение кэширования для каждого изображения, вы можете настроить заголовки , чтобы установить заголовок Cache-Control для исходного изображения (например, /some-asset.jpg , а не /_next/image ).

В настоящее время нет механизма для аннулирования кеша, поэтому лучше оставить MinimumCacheTTL на низком уровне. В противном случае вам может потребоваться вручную изменить реквизит src или удалить /cache/images .

Отключить статический импорт

Поведение по умолчанию позволяет импортировать статические файлы, такие как значок импорта из '. /icon.png , а затем передать его в src свойство.

В некоторых случаях вы можете захотеть отключить эту функцию, если она конфликтует с другими подключаемыми модулями, которые ожидают, что импорт будет вести себя по-другому.

Вы можете отключить импорт статических изображений внутри вашего next.config.js :

 module.exports = {
  изображений: {
    отключитьStaticImages: правда,
  },
}
 

Опасно разрешать SVG

Загрузчик по умолчанию не оптимизирует изображения SVG по нескольким причинам. Во-первых, SVG — это векторный формат, то есть его размер можно изменять без потерь. Во-вторых, SVG имеет многие из тех же функций, что и HTML/CSS, что может привести к уязвимостям без надлежащих заголовков Content Security Policy (CSP).

Если вам нужно обслуживать изображения SVG с помощью API оптимизации изображений по умолчанию, вы можете установить опасноAllowSVG внутри вашего next.config.js :

 module.