UIScrollView Content Size Ambiguity: 10 मिनट में कैसे ठीक करें

परिचय: "जादू" UIScrollView जो काम करना बंद कर देता है

क्या आपने कभी ऐसी स्थिति का सामना किया है: आप अपने Swift प्रोजेक्ट में UIScrollView जोड़ते हैं, Auto Layout सेट करते हैं, ऐप चलाते हैं — और कुछ भी स्क्रॉल नहीं होता? या इससे भी बुरा, Xcode एक रहस्यमयी त्रुटि देता है: "UIScrollView scrollable content size ambiguity"? यदि हाँ — तो आप अकेले नहीं हैं। इस प्रश्न ने Stack Overflow पर हजारों व्यूज़ एकत्र किए हैं, और आज हम हमेशा के लिए समझेंगे कि मामला क्या है।

कल्पना करें: आप एक लंबी रजिस्ट्रेशन फॉर्म या एक लेख के साथ एक स्क्रीन बना रहे हैं जो एक स्क्रीन पर फिट नहीं होता। आप UIScrollView जोड़ते हैं, उसमें सभी तत्व डालते हैं, कॉन्स्ट्रेंट सेट करते हैं — और... सन्नाटा। स्क्रॉल काम नहीं करता। परिचित लगता है? Auto Layout को "समझने में असमर्थ" कहने वाले डेवलपर्स के क्लब में आपका स्वागत है।

वास्तव में, Content Size Ambiguity समस्या iOS का बग नहीं है, बल्कि एक तार्किक जाल है। सिस्टम बस यह नहीं जानता कि आपकी सामग्री कितनी बड़ी होनी चाहिए। इस ट्यूटोरियल में, हम कारण, तीन समाधान विधियों का विश्लेषण करेंगे और वास्तविक कार्यशील कोड लिखेंगे। चलिए शुरू करते हैं!

Content Size Ambiguity क्या है और यह क्यों होती है?

UIScrollView UIKit की दुनिया में एक विशेष प्राणी है। सामान्य व्यू के विपरीत, यह अपने आकार को चाइल्ड एलिमेंट के कॉन्स्ट्रेंट से निर्धारित नहीं करता है। इसके बजाय, यह contentSize (प्रकार CGSize) प्रॉपर्टी का उपयोग करता है, जो इंगित करता है कि "अंडर-द-हुड" कैनवास कितना बड़ा है। यदि contentSize स्वयं UIScrollView के आकार से छोटा या बराबर है, तो स्क्रॉल... ठीक है, ज़रूरी नहीं है।

Scrollable Content Size Ambiguity त्रुटि तब होती है जब Auto Layout स्क्रॉल-व्यू के अंदर कॉन्स्ट्रेंट के आधार पर contentSize की स्पष्ट रूप से गणना नहीं कर सकता। सामान्य परिदृश्य:

\n
• आपने आंतरिक सामग्री की ऊंचाई या चौड़ाई के लिए कॉन्स्ट्रेंट सेट नहीं किए हैं।
\n
• कॉन्स्ट्रेंट "फ्लोट" कर रहे हैं (उदाहरण के लिए, स्क्रॉल-व्यू के ऊपर और नीचे से कोई संबंध नहीं है)।
\n
• आप UIScrollView के अंदर UIStackView का उपयोग कर रहे हैं, लेकिन इसके आकार को कॉन्फ़िगर नहीं किया है।
\n
• आप भूल गए हैं कि UIScrollView को किनारे से किनारे तक कॉन्स्ट्रेंट की पूरी श्रृंखला की आवश्यकता होती है।
\n

Xcode कंसोल में आप कुछ इस तरह देखेंगे:

Unable to simultaneously satisfy constraints.\nWill attempt to recover by breaking constraint.\n...\nUIScrollView scrollable content size ambiguity

यह डरावना लगता है, लेकिन समाधान सरल है। आइए कोड लिखें।

चरण 1: प्रोजेक्ट बनाएं और UIScrollView जोड़ें

Xcode खोलें, App टेम्पलेट (iOS, Swift) के साथ एक नया प्रोजेक्ट बनाएं। इसे नाम दें, उदाहरण के लिए, ScrollFixDemo। ViewController.swift पर जाएं और सभी कोड को निम्नलिखित से बदलें:

import UIKit\n\nclass ViewController: UIViewController {\n    \n    override func viewDidLoad() {\n        super.viewDidLoad()\n        setupScrollView()\n    }\n    \n    private func setupScrollView() {\n        // 1. UIScrollView बनाएं\n        let scrollView = UIScrollView()\n        scrollView.translatesAutoresizingMaskIntoConstraints = false\n        scrollView.backgroundColor = .systemGray6\n        view.addSubview(scrollView)\n        \n        // 2. scrollView के लिए कॉन्स्ट्रेंट (पूरी स्क्रीन भरें)\n        NSLayoutConstraint.activate([\n            scrollView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),\n            scrollView.leadingAnchor.constraint(equalTo: view.leadingAnchor),\n            scrollView.trailingAnchor.constraint(equalTo: view.trailingAnchor),\n            scrollView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor)\n        ])\n        \n        // 3. contentView बनाएं - सभी सामग्री के लिए कंटेनर\n        let contentView = UIView()\n        contentView.translatesAutoresizingMaskIntoConstraints = false\n        contentView.backgroundColor = .white\n