---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.0
alternate:
  - https://divkit.tech/docs/en/concepts/extensions/aspect-correction.md
  - https://divkit.tech/docs/ru/concepts/extensions/aspect-correction.md
  - href: https://divkit.tech/docs/ru/concepts/extensions/aspect-correction.md
    type: text/markdown
    title: Markdown version
  - href: https://divkit.tech/docs/ru/llms.txt?revision=r22102947
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://divkit.tech/docs/ru/llms.txt?revision=r22102947

# Автоматическая коррекция соотношения сторон изображений

Для автоматического кадрирования изображений в [div-image](https://divkit.tech/docs/ru/concepts/divs/2/div-image.md) до ожидаемого соотношения сторон используйте расширение `aspect_correction` (только для iOS). Ожидаемое соотношение сторон задается свойством `aspect` элемента:

```json translate=no
{
  "type": "image",
  "image_url": "https://example.com/image.png",
  "aspect": {
    "ratio": 1.5
  },
  "extensions": [
    {
      "id": "aspect_correction"
    }
  ]
}
```

У расширения нет параметров. Допуск отклонения соотношения сторон задается в приложении при создании обработчика.

## Особенности работы {#behavior}

- Расширение применяется к элементу `div-image`, у которого задано свойство `aspect`.
- Изображение кадрируется, если его фактическое соотношение сторон отличается от ожидаемого больше чем на допуск.
- Если фактическое соотношение сторон меньше ожидаемого, изображение обрезается по высоте.
- Если фактическое соотношение сторон больше ожидаемого, изображение обрезается по ширине.

## Подключение {#connect}

```swift translate=no
DivKitComponents(
  ...
  extensionHandlers: [
    AspectCorrectionExtensionHandler(aspectTolerance: 0.001)
  ]
)
```

`aspectTolerance` — допуск отклонения соотношения сторон. Если фактическое соотношение сторон отличается от ожидаемого не больше чем на это значение, кадрирование не применяется. По умолчанию: `0.001`.

<!-- source: ru/_includes/index/troubleshooting.md -->
## Узнать больше {#troubleshooting}

Вы можете обсуждать интересующие вас темы в сообществе пользователей DivKit в Telegram: [https://t.me/divkit_community_ru](https://t.me/divkit_community_ru).



[Репозиторий DivKit](https://github.com/divkit/divkit)




<!-- endsource: ru/_includes/index/troubleshooting.md -->