🌮 🈺 📎 UICollectionView सिर के आसपास: मक्खी पर दृश्य बदलना 🅰️ 💋 👨🏾‍🎓

नमस्कार, हेब्र! मैं आपके लिए " UICollectionView Tutorial: मक्खी पर प्रस्तुति बदलना " लेख का अनुवाद प्रस्तुत करता हूं ।

इस लेख में, हम तत्वों को प्रदर्शित करने के विभिन्न तरीकों के उपयोग के साथ-साथ उनके पुन: उपयोग और गतिशील परिवर्तन पर विचार करेंगे। यहां हम संग्रह और ऑटोलैयूट के साथ काम करने की मूल बातें पर चर्चा नहीं करेंगे।

परिणामस्वरूप, हमें एक उदाहरण मिलता है:

मोबाइल एप्लिकेशन विकसित करते समय, अक्सर ऐसी परिस्थितियां होती हैं जब टेबल दृश्य पर्याप्त नहीं होता है और आपको तत्वों की सूची को अधिक रोचक और अद्वितीय दिखाने की आवश्यकता होती है। इसके अलावा, तत्वों को प्रदर्शित करने के तरीके को बदलने की क्षमता आपके एप्लिकेशन में एक "चिप" बन सकती है।

उपरोक्त सभी विशेषताएं UICollectionView और UICollectionViewDelegateFlowLayout प्रोटोकॉल के विभिन्न कार्यान्वयनों का उपयोग करते हुए लागू करने के लिए काफी सरल हैं।

पूर्ण परियोजना कोड।

कार्यान्वयन के लिए हमें सबसे पहले क्या चाहिए:

वर्ग FruitViewController: UICollectionViewController।

फ्रूट डेटा मॉडल

struct Fruit { let name: String let icon: UIImage }

वर्ग FruitCollectionViewCell: UICollectionViewCell

फल प्रदर्शित करने के लिए UIImageView और UILabel के साथ सेल

हम पुन: उपयोग के लिए xib के साथ एक अलग फाइल में सेल बनाएंगे।

डिजाइन द्वारा, हम देखते हैं कि 2 संभावित सेल विकल्प हैं - नीचे पाठ और छवि के दाईं ओर पाठ के साथ।

पूरी तरह से विभिन्न प्रकार की कोशिकाएं हो सकती हैं, जिस स्थिति में आपको 2 अलग-अलग कक्षाएं बनाने और वांछित का उपयोग करने की आवश्यकता होती है। हमारे मामले में, ऐसी कोई आवश्यकता नहीं है और UIStackView के साथ 1 सेल पर्याप्त है।

सेल के लिए इंटरफ़ेस बनाने के लिए चरण:

UIView जोड़ें
इसके अंदर UIStackView (क्षैतिज) जोड़ें
इसके बाद, UIImageView और UILabel को UIStackView में जोड़ें।
यूबिल के लिए, क्षैतिज और ऊर्ध्वाधर के लिए सामग्री संपीड़न प्रतिरोध प्राथमिकता = 1000 का मान निर्धारित करें।
UIImageView पहलू अनुपात के लिए 1: 1 जोड़ें और प्राथमिकता को 750 में बदलें।

क्षैतिज मोड में सही प्रदर्शन के लिए यह आवश्यक है।

अगला, हम अपने सेल को क्षैतिज और ऊर्ध्वाधर दोनों मोड में प्रदर्शित करने के लिए तर्क लिखते हैं।

क्षैतिज प्रदर्शन के लिए मुख्य मानदंड सेल का आकार ही होगा। यानी यदि पर्याप्त जगह है - क्षैतिज मोड प्रदर्शित करें। यदि नहीं, तो ऊर्ध्वाधर। हम मानते हैं कि पर्याप्त जगह है जब चौड़ाई ऊंचाई से 2 गुना अधिक है, क्योंकि छवि चौकोर होनी चाहिए।

सेल कोड:

 class FruitCollectionViewCell: UICollectionViewCell { static let reuseID = String(describing: FruitCollectionViewCell.self) static let nib = UINib(nibName: String(describing: FruitCollectionViewCell.self), bundle: nil) @IBOutlet private weak var stackView: UIStackView! @IBOutlet private weak var ibImageView: UIImageView! @IBOutlet private weak var ibLabel: UILabel! override func awakeFromNib() { super.awakeFromNib() backgroundColor = .white clipsToBounds = true layer.cornerRadius = 4 ibLabel.font = UIFont.systemFont(ofSize: 18) } override func layoutSubviews() { super.layoutSubviews() updateContentStyle() } func update(title: String, image: UIImage) { ibImageView.image = image ibLabel.text = title } private func updateContentStyle() { let isHorizontalStyle = bounds.width > 2 * bounds.height let oldAxis = stackView.axis let newAxis: NSLayoutConstraint.Axis = isHorizontalStyle ? .horizontal : .vertical guard oldAxis != newAxis else { return } stackView.axis = newAxis stackView.spacing = isHorizontalStyle ? 16 : 4 ibLabel.textAlignment = isHorizontalStyle ? .left : .center let fontTransform: CGAffineTransform = isHorizontalStyle ? .identity : CGAffineTransform(scaleX: 0.8, y: 0.8) UIView.animate(withDuration: 0.3) { self.ibLabel.transform = fontTransform self.layoutIfNeeded() } } }

चलो मुख्य प्रकार पर चलते हैं - नियंत्रक और सेल प्रकारों को प्रदर्शित करने और स्विच करने के लिए तर्क।

सभी संभावित प्रदर्शन स्थितियों के लिए, एक एनुम प्रस्तुति प्रस्तुति बनाएं।
हम नेविगेशन बार में राज्यों के बीच स्विच करने के लिए एक बटन भी जोड़ते हैं।

 class FruitsViewController: UICollectionViewController { private enum PresentationStyle: String, CaseIterable { case table case defaultGrid case customGrid var buttonImage: UIImage { switch self { case .table: return imageLiteral(resourceName: "table") case .defaultGrid: return imageLiteral(resourceName: "default_grid") case .customGrid: return imageLiteral(resourceName: "custom_grid") } } } private var selectedStyle: PresentationStyle = .table { didSet { updatePresentationStyle() } } private var datasource: [Fruit] = FruitsProvider.get() override func viewDidLoad() { super.viewDidLoad() self.collectionView.register(FruitCollectionViewCell.nib, forCellWithReuseIdentifier: FruitCollectionViewCell.reuseID) collectionView.contentInset = .zero updatePresentationStyle() navigationItem.rightBarButtonItem = UIBarButtonItem(image: selectedStyle.buttonImage, style: .plain, target: self, action: #selector(changeContentLayout)) } private func updatePresentationStyle() { navigationItem.rightBarButtonItem?.image = selectedStyle.buttonImage } @objc private func changeContentLayout() { let allCases = PresentationStyle.allCases guard let index = allCases.firstIndex(of: selectedStyle) else { return } let nextIndex = (index + 1) % allCases.count selectedStyle = allCases[nextIndex] } } // MARK: UICollectionViewDataSource & UICollectionViewDelegate extension FruitsViewController { override func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int { return datasource.count } override func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell { guard let cell = collectionView.dequeueReusableCell(withReuseIdentifier: FruitCollectionViewCell.reuseID, for: indexPath) as? FruitCollectionViewCell else { fatalError("Wrong cell") } let fruit = datasource[indexPath.item] cell.update(title: fruit.name, image: fruit.icon) return cell } }

एक संग्रह में तत्वों को प्रदर्शित करने की विधि के बारे में सब कुछ UICollectionViewDelegateFlowLayout प्रोटोकॉल में वर्णित है। इसलिए, नियंत्रक से किसी भी कार्यान्वयन को हटाने और स्वतंत्र पुन: प्रयोज्य तत्वों को बनाने के लिए, हम प्रत्येक प्रकार के प्रदर्शन के लिए इस प्रोटोकॉल का एक अलग कार्यान्वयन बनाएंगे।

हालांकि, 2 बारीकियां हैं:

यह प्रोटोकॉल सेल चयन विधि का वर्णन भी करता है (didSelectItemAt :)
कुछ तरीकों और तर्क सभी एन मैपिंग विधियों (हमारे मामले में, एन = 3) के लिए समान हैं।

इसलिए, हम CollectionViewSelectableItemDelegate प्रोटोकॉल बनाएंगे, मानक UICollectionViewDelegateFlowLayout प्रोटोकॉल का विस्तार करेंगे, जिसमें हम सेल चयन को बंद करने को परिभाषित करते हैं और यदि आवश्यक हो, तो कोई अतिरिक्त गुण और विधियाँ (उदाहरण के लिए, यदि भिन्न प्रकार का प्रतिनिधित्व के लिए उपयोग किया जाता है तो सेल प्रकार लौटाते हैं)। इससे पहली समस्या का समाधान हो जाएगा।

 protocol CollectionViewSelectableItemDelegate: class, UICollectionViewDelegateFlowLayout { var didSelectItem: ((_ indexPath: IndexPath) -> Void)? { get set } }

दूसरी समस्या को हल करने के लिए - तर्क के दोहराव के साथ, हम सभी सामान्य तर्क के साथ एक आधार वर्ग बनाएंगे:

 class DefaultCollectionViewDelegate: NSObject, CollectionViewSelectableItemDelegate { var didSelectItem: ((_ indexPath: IndexPath) -> Void)? let sectionInsets = UIEdgeInsets(top: 16.0, left: 16.0, bottom: 20.0, right: 16.0) func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) { didSelectItem?(indexPath) } func collectionView(_ collectionView: UICollectionView, didHighlightItemAt indexPath: IndexPath) { let cell = collectionView.cellForItem(at: indexPath) cell?.backgroundColor = UIColor.clear } func collectionView(_ collectionView: UICollectionView, didUnhighlightItemAt indexPath: IndexPath) { let cell = collectionView.cellForItem(at: indexPath) cell?.backgroundColor = UIColor.white } }

हमारे मामले में, सामान्य तर्क एक सेल का चयन करते समय एक बंद को कॉल करना है, साथ ही हाइलाइटेड स्थिति पर स्विच करने पर सेल की पृष्ठभूमि को बदलना है।

अगला, हम प्रतिनिधित्व के 3 कार्यान्वयन का वर्णन करते हैं: सारणीबद्ध, प्रत्येक पंक्ति में 3 तत्व और पहले दो तरीकों का संयोजन।

सारणीबद्ध :

 class TabledContentCollectionViewDelegate: DefaultCollectionViewDelegate { // MARK: - UICollectionViewDelegateFlowLayout func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAt indexPath: IndexPath) -> CGSize { let paddingSpace = sectionInsets.left + sectionInsets.right let widthPerItem = collectionView.bounds.width - paddingSpace return CGSize(width: widthPerItem, height: 112) } func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, insetForSectionAt section: Int) -> UIEdgeInsets { return sectionInsets } func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, minimumLineSpacingForSectionAt section: Int) -> CGFloat { return 10 } }

प्रत्येक पंक्ति में 3 तत्व:

 class DefaultGriddedContentCollectionViewDelegate: DefaultCollectionViewDelegate { private let itemsPerRow: CGFloat = 3 private let minimumItemSpacing: CGFloat = 8 // MARK: - UICollectionViewDelegateFlowLayout func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAt indexPath: IndexPath) -> CGSize { let paddingSpace = sectionInsets.left + sectionInsets.right + minimumItemSpacing * (itemsPerRow - 1) let availableWidth = collectionView.bounds.width - paddingSpace let widthPerItem = availableWidth / itemsPerRow return CGSize(width: widthPerItem, height: widthPerItem) } func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, insetForSectionAt section: Int) -> UIEdgeInsets { return sectionInsets } func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, minimumLineSpacingForSectionAt section: Int) -> CGFloat { return 20 } func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, minimumInteritemSpacingForSectionAt section: Int) -> CGFloat { return minimumItemSpacing } }

एक पंक्ति में तालिका और 3x का संयोजन।

 class CustomGriddedContentCollectionViewDelegate: DefaultCollectionViewDelegate { private let itemsPerRow: CGFloat = 3 private let minimumItemSpacing: CGFloat = 8 // MARK: - UICollectionViewDelegateFlowLayout func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAt indexPath: IndexPath) -> CGSize { let itemSize: CGSize if indexPath.item % 4 == 0 { let itemWidth = collectionView.bounds.width - (sectionInsets.left + sectionInsets.right) itemSize = CGSize(width: itemWidth, height: 112) } else { let paddingSpace = sectionInsets.left + sectionInsets.right + minimumItemSpacing * (itemsPerRow - 1) let availableWidth = collectionView.bounds.width - paddingSpace let widthPerItem = availableWidth / itemsPerRow itemSize = CGSize(width: widthPerItem, height: widthPerItem) } return itemSize } func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, insetForSectionAt section: Int) -> UIEdgeInsets { return sectionInsets } func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, minimumLineSpacingForSectionAt section: Int) -> CGFloat { return 20 } func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, minimumInteritemSpacingForSectionAt section: Int) -> CGFloat { return minimumItemSpacing } }

अंतिम चरण नियंत्रक में दृश्य डेटा जोड़ना और संग्रह में वांछित प्रतिनिधि सेट करना है।

एक महत्वपूर्ण बिंदु: चूंकि संग्रह का प्रतिनिधि कमजोर है , इसलिए आपके पास नियंत्रक में दृश्य ऑब्जेक्ट के लिए एक मजबूत लिंक होना चाहिए।

नियंत्रक में, प्रकार के संबंध में सभी उपलब्ध विचारों का शब्दकोश बनाएं:

 private var styleDelegates: [PresentationStyle: CollectionViewSelectableItemDelegate] = { let result: [PresentationStyle: CollectionViewSelectableItemDelegate] = [ .table: TabledContentCollectionViewDelegate(), .defaultGrid: DefaultGriddedContentCollectionViewDelegate(), .customGrid: CustomGriddedContentCollectionViewDelegate(), ] result.values.forEach { $0.didSelectItem = { _ in print("Item selected") } } return result }()

और UpdatePresentationStyle () विधि में, संग्रह प्रतिनिधि के लिए एक एनिमेटेड परिवर्तन जोड़ें:

  collectionView.delegate = styleDelegates[selectedStyle] collectionView.performBatchUpdates({ collectionView.reloadData() }, completion: nil)

वह सब जो हमारे तत्वों के लिए एक दृश्य से दूसरे में एनिमेटेड रूप से स्थानांतरित करने के लिए आवश्यक है :)

इस प्रकार, हम अब किसी भी स्क्रीन पर तत्वों को किसी भी तरह से प्रदर्शित कर सकते हैं, जैसे कि, गतिशील रूप से डिस्प्ले के बीच स्विच करता है, और सबसे महत्वपूर्ण बात, कोड स्वतंत्र, पुन: प्रयोज्य और स्केलेबल है।

पूर्ण परियोजना कोड।

UICollectionView सिर के आसपास: मक्खी पर दृश्य बदलना

फल प्रदर्शित करने के लिए UIImageView और UILabel के साथ सेल

More articles: