---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.3
alternate:
  - https://divkit.tech/docs/en/concepts/divs/2/div-image-background.md
  - https://divkit.tech/docs/ru/concepts/divs/2/div-image-background.md
---
> **Documentation Index:** Fetch the complete configuration index at https://divkit.tech/docs/ru/llms.txt

# div-image-background
Фоновое изображение.

## Параметры
| Параметры | Описание |
| --- | --- |
| `image_url` | <p>**string**</p><p>Обязательный параметр.</p><p>Ссылка на изображение.</p><p>Значение должно быть валидным URL.</p> |
| `type` | <p>**string**</p><p>Обязательный параметр.</p><p>Значение всегда должно равняться `image`.</p> |
| `alpha` | <p>**number**</p><p>Прозрачность изображения.</p><p>Ограничение для значения `x`: `x >= 0.0 && x <= 1.0`.</p><p>Значение по умолчанию: `1.0`.</p> |
| `content_alignment_horizontal` | <p>**string**</p><p>Горизонтальное выравнивание изображения.</p><p>Возможные значения: `left`, `center`, `right`, `start`, `end`.</p><p>Значение по умолчанию: `center`.</p> |
| `content_alignment_vertical` | <p>**string**</p><p>Вертикальное выравнивание изображения.</p><p>Возможные значения: `top`, `center`, `bottom`, `baseline`.</p><p>Значение по умолчанию: `center`.</p> |
| `filters` | <p>**array**</p><p>Фильтры для изображений.</p><p>Список возможных значений:<li>[div-blur](div-blur.md#div-blur)</li><li>[div-filter-rtl-mirror](div-filter-rtl-mirror.md#div-filter-rtl-mirror)</li></p> |
| `preload_required` | <p>**bool_int**</p><p>До показа необходимо предварительно загрузить фоновое изображение.</p><p>Значение по умолчанию: `false`.</p><p>Доступные платформы: Android, iOS.</p> |
| `scale` | <p>**string**</p><p>Масштабирование изображения.</p><p>Возможные значения: `fill`, `no_scale`, `fit`, `stretch`.</p><p>Значение по умолчанию: `fill`.</p> |

<details>
<summary>JSON</summary>

```json
{
  type*: "image",
  alpha: "number",
  content_alignment_horizontal: "string",
  content_alignment_vertical: "string",
  filters: [ div-filter, ... ],
  image_url*: "string",
  preload_required: "bool_int",
  scale: "string"
}
```
</details>