Ambigüedad del Tamaño del Contenido de UIScrollView: cómo solucionarlo en 10 minutos

Introducción: La "magia" de UIScrollView que deja de funcionar

¿Alguna vez te has encontrado con esta situación: agregas un UIScrollView a tu proyecto en Swift, configuras Auto Layout, ejecutas la aplicación y... no se desplaza nada? O, peor aún, Xcode muestra un error misterioso: "UIScrollView scrollable content size ambiguity"? Si es así, no estás solo. Esta pregunta ha acumulado miles de visitas en Stack Overflow, y hoy vamos a entender de una vez por todas de qué se trata.

Imagina: creas una pantalla con un formulario de registro largo o un artículo que no cabe en una sola pantalla. Agregas un UIScrollView, colocas todos los elementos dentro, estableces las constraints y... silencio. El desplazamiento no funciona. ¿Te suena familiar? Bienvenido al club de desarrolladores que han maldecido a Auto Layout por su "falta de comprensión".

En realidad, el problema de la Ambigüedad del Tamaño del Contenido no es un error de iOS, sino una trampa lógica. El sistema simplemente no sabe qué tan grande debe ser tu contenido. En este tutorial, analizaremos la causa, tres métodos de solución y escribiremos código funcional real. ¡Allá vamos!

¿Qué es la Ambigüedad del Tamaño del Contenido y por qué ocurre?

UIScrollView es una bestia especial en el mundo de UIKit. A diferencia de las vistas normales, no determina su tamaño basándose en las constraints de los elementos hijos. En su lugar, utiliza la propiedad contentSize (de tipo CGSize), que indica qué tan grande es el "lienzo interno". Si contentSize es menor o igual al tamaño del propio UIScrollView, el desplazamiento... bueno, no es necesario.

El error Scrollable Content Size Ambiguity ocurre cuando Auto Layout no puede calcular de manera inequívoca el contentSize basándose en las constraints dentro de la vista de desplazamiento. Escenarios típicos:

• No has definido constraints para la altura o el ancho del contenido interno.
• Las constraints son "flotantes" (por ejemplo, no hay conexión con la parte superior e inferior de la scroll view).
• Usas un UIStackView dentro de un UIScrollView, pero no has configurado sus tamaños.
• Olvidaste que UIScrollView requiere una cadena completa de constraints de borde a borde.

En la consola de Xcode verás algo como:

Unable to simultaneously satisfy constraints.Will attempt to recover by breaking constraint....UIScrollView scrollable content size ambiguity

Suena aterrador, pero la solución es simple. Escribamos el código.

Paso 1: Crear el proyecto y agregar UIScrollView

Abre Xcode, crea un nuevo proyecto con la plantilla App (iOS, Swift). Nómbralo, por ejemplo, ScrollFixDemo. Ve a ViewController.swift y reemplaza todo el código con lo siguiente:

import UIKit

class ViewController: UIViewController {        override func viewDidLoad() {        super.viewDidLoad()        setupScrollView()    }        private func setupScrollView() {        // 1. Crear UIScrollView        let scrollView = UIScrollView()        scrollView.translatesAutoresizingMaskIntoConstraints = false        scrollView.backgroundColor = .systemGray6        view.addSubview(scrollView)                // 2. Constraints para scrollView (llenar toda la pantalla)        NSLayoutConstraint.activate([            scrollView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),            scrollView.leadingAnchor.constraint(equalTo: view.leadingAnchor),            scrollView.trailingAnchor.constraint(equalTo: view.trailingAnchor),            scrollView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor)        ])                // 3. Crear contentView - contenedor para todo el contenido        let contentView = UIView()        contentView.translatesAutoresizingMaskIntoConstraints = false        contentView.backgroundColor = .white