Что такое clipsToBounds?

Что такое clipsToBounds в iOS?

clipsToBounds — это булево свойство класса UIView в iOS, которое определяет, будет ли контент, выходящий за пределы границ (bounds) представления, отсекаться (обрезаться) или отображаться за его пределами. Это один из фундаментальных инструментов управления визуальным слоем (CALayer) в иерархии представлений.

Механизм работы и аналогия

Простыми словами, представьте, что каждое UIView — это прямоугольная рамка (её границы определяются свойствами frame или bounds). Внутри этой рамки размещается визуальное содержимое: дочерние представления (subviews), изображения, градиенты, тени и т.д.

• Если clipsToBounds = false (значение по умолчанию для большинства представлений), содержимое, которое выходит за границы этой рамки, будет видно. Это похоже на картину, которая нарисована за пределами холста, но всё равно висит на стене.
• Если clipsToBounds = true, содержимое, выходящее за границы, обрезается и становится невидимым. Это аналогично тому, как фотография обрезается паспарту в рамке — видна только часть, которая попадает в "окно".

Практическое применение и примеры

Это свойство критически важно для создания аккуратного интерфейса и решения распространённых задач.

1. Создание закруглённых углов (cornerRadius) Наиболее частый кейс — обрезка контента при использовании layer.cornerRadius. Без активации clipsToBounds закруглённые углы применятся только к фону представления, а его контент (например, изображение внутри UIImageView) останется с острыми углами и будет "выглядывать".

let imageView = UIImageView(frame: CGRect(x: 50, y: 50, width: 100, height: 100))
imageView.image = UIImage(named: "photo")
imageView.layer.cornerRadius = 20.0 // Устанавливаем закругление

print(imageView.clipsToBounds) // По умолчанию false для UIImageView? Контент не обрезается.

// Чтобы изображение тоже стало закруглённым, необходимо:
imageView.clipsToBounds = true // Теперь углы изображения будут обрезаны по радиусу 20pt.

2. Управление вложенными представлениями Когда вы добавляете одно представление (subview) в качестве дочернего к другому (superview), вы можете контролировать его видимость относительно родителя.

let containerView = UIView(frame: CGRect(x: 50, y: 50, width: 200, height: 200))
containerView.backgroundColor = .systemBlue

let childView = UIView(frame: CGRect(x: 150, y: 150, width: 100, height: 100))
childView.backgroundColor = .systemRed

containerView.addSubview(childView)

// Без clipsToBounds красный childView будет виден полностью, даже если частично вылезает за синий containerView.
// С clipsToBounds видимая часть redView будет ограничена прямоугольником containerView.
containerView.clipsToBounds = true

3. Отличие от masksToBounds Под капотом clipsToBounds — это удобная Objective-C/Swift обёртка над свойством Core Animation CALayer.masksToBounds. При изменении clipsToBounds система фактически меняет значение у нижележащего layer.

view.clipsToBounds = true
// Эквивалентно:
view.layer.masksToBounds = true

Важные нюансы и производительность

1. Производительность. Включение clipsToBounds (или masksToBounds) заставляет систему выполнять дополнительные вычисления по отсечению пикселей. Это может негативно сказаться на производительности, особенно для сложных иерархий представлений или в анимациях (например, в UICollectionView или UITableView с множеством ячеек). В таких случаях стоит оценить необходимость его использования.
2. Влияние на тени (shadow). Существует ключевое противоречие: для отображения тени (свойства layer.shadow*) представление НЕ должно обрезать границы (masksToBounds должно быть false), потому что тень отрисовывается за пределами bounds. Часто для решения этой проблемы тень добавляют не к самому элементу, а к отдельному родительскому контейнеру.
3. Значение по умолчанию. Для UIScrollView и его подклассов (например, UITableView, UICollectionView) значение по умолчанию clipsToBounds = true. Это логично, так как контент внутри скролла не должен "расползаться" за его видимую область.

Заключение

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