अपने स्टोरीबोर्ड के बिना स्प्लिट कंट्रोलर

पहले, उन्होंने iPad का समर्थन करने के लिए एक अलग xib बनाया। 2014 में लेआउट को एकजुट करने के लिए, Apple ने ऑटो लेआउट और आकार कक्षाएं, और अनुकूली नेविगेशन UISplitViewController के लिए शुरू किया ।

स्प्लिट कंट्रोलर एक कंटेनर होता है जो दो कंट्रोलर्स को एक साथ रखता है। बाईं ओर नेविगेशन कंट्रोलर में नेविगेशन कंट्रोलर (नेविगेशन कंट्रोलर के बारे में नहीं) के विकल्प के अनुरूप होगा। संक्षेप में, जैसा कि सेटिंग्स में है।

आइए UISplitViewController कि स्क्रीन पर UISplitViewController और उसके व्यवहार को कैसे कॉन्फ़िगर किया UISplitViewController ।

नियंत्रक परिभाषित करना

बाएँ (नेविगेशन) और दाएँ नियंत्रकों को निरूपित करें। दोनों के लिए, हेडर सेट करें:

 class MasterController: UITableViewController { override func viewDidLoad() { super.viewDidLoad() self.navigationItem.title = "Master" self.navigationController?.navigationBar.prefersLargeTitles = true } } class DetailController: UIViewController { override func viewDidLoad() { super.viewDidLoad() self.navigationItem.title = "Detail" self.navigationController?.navigationBar.prefersLargeTitles = true } } 

एक विभाजन नियंत्रक दो नियंत्रक के लिए एक कंटेनर है। जैसा कि मैंने कैट के पहले लिखा था, बाईं ओर नेविगेशन-मुख्य नियंत्रक है, नेविगेशन में पसंद के अनुरूप दाईं ओर, या विस्तृत (डिटेल कंट्रोलर)। मास्टर और डिटेल याद रखें, शब्द प्रलेखन और प्रोटोकॉल में मिलेंगे।

स्प्लिट जोड़ें

आइए, AppDelegate पर जाएं, doFinishLaunchingWithOptions मेथड में एक नई विंडो बनाएं, स्प्लिट कंट्रोलर और दो अन्य को इनिशियलाइज़ करें, स्प्लिट पर सेट करें:

 let masterController = MasterController() let masterNavigationController = UINavigationController(rootViewController: masterController) let detailController = DetailController() let detailNavigationController = UINavigationController(rootViewController: detailController) let splitViewController = UISplitViewController() splitViewController.viewControllers = [masterNavigationController, detailNavigationController] self.window = UIWindow(frame: UIScreen.main.bounds) self.window!.rootViewController = splitViewController self.window!.makeKeyAndVisible() 

सिम्युलेटर चलाएं। पोर्ट्रेट और लैंडस्केप झुकाव क्रमशः:

पोर्ट ओरिएंटेशन में, मास्टर कंट्रोलर दिखाई नहीं देता है। इसे प्रदर्शित करने के लिए बाईं ओर स्वाइप करें। यह मोड का उपयोग करके कॉन्फ़िगर किया गया है, हम उन्हें आगे का विश्लेषण करेंगे।

नेविगेशन

मास्टर नियंत्रक में कोशिकाओं को जोड़ें। आपको याद दिला दूं कि एक मास्टर कंट्रोलर एक UINavigationController में लिपटे टेबल है।

 class MasterController: UITableViewController { override func viewDidLoad() { self.tableView = UITableView(frame: .zero, style: .insetGrouped) super.viewDidLoad() self.tableView.register(UITableViewCell.self, forCellReuseIdentifier: "id") self.navigationItem.title = "Master" self.navigationController?.navigationBar.prefersLargeTitles = true } override func numberOfSections(in tableView: UITableView) -> Int { return 2 } override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int { return 4 } override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell { let cell = tableView.dequeueReusableCell(withIdentifier: "id")! cell.textLabel?.text = "\(indexPath)" return cell } } 

और यदि आप नहीं जानते कि कैसे, तो यहाँ ।

IOS 13 में, एक नया .insetGrouped टेबल स्टाइल दिखाई दिया , मैंने इसे स्थापित किया। शैली Xcode 11 के साथ उपलब्ध है।

प्रोजेक्ट चलाएँ:

सेल पर क्लिक करके, हम एक विस्तृत नियंत्रक दिखाएंगे। "विस्तृत नियंत्रकों" ने अफवाह को कैसे काट दिया , मुझे आशा है कि टिप्पणियों में अनुवाद बेहतर होगा। कोड इस तरह दिखता है:

 override func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) { let controller = DetailController() controller.navigationTitle = "\(indexPath)" self.showDetailViewController(UINavigationController(rootViewController: controller), sender: nil) } 

नामकरण मास्टर / विस्तृत नियंत्रकों के बारे में याद रखें? यहाँ showDetailViewController विधि में विस्तार का उपयोग करने का एक उदाहरण है।

चौकस ध्यान देगा कि नियंत्रक के पास नेविगेशनटाइटल नहीं है। विस्तार नियंत्रक की कक्षा को अद्यतन करें:

 class DetailController: UIViewController { var navigationTitle: String = "Detail" override func viewDidLoad() { super.viewDidLoad() self.navigationItem.title = navigationTitle self.view.backgroundColor = .white } } 

प्रोजेक्ट चलाएँ और सेल पर क्लिक करें:

आईफ़ोन

नेविगेशन अनुकूली है, जिसका अर्थ है कि सब कुछ तैयार है। खैर, लगभग। एक iPhone चुनें और चलाएं:

एक नियमित नेविगेशन नियंत्रक की तरह काम करता है। यह है चंचलता अनुकूलन क्षमता - मुक्त स्थान के आधार पर, स्प्लिट नियंत्रक मुख्य और विस्तृत नियंत्रक रखता है।

मास्टर नियंत्रक नहीं है, लेकिन iPhone पर सबसे पहले विस्तार किया गया था। दो नियंत्रकों को एक समान स्थिति में प्रदर्शित करने से संक्रमण को UISplitViewControllerDelegate प्रतिनिधि द्वारा कॉन्फ़िगर किया गया है। वापसी मान निर्धारित करता है कि क्या मास्टर नियंत्रक, या विवरण दिखाना है:

 extension AppDelegate: UISplitViewControllerDelegate { func splitViewController(_ splitViewController: UISplitViewController, collapseSecondary secondaryViewController: UIViewController, onto primaryViewController: UIViewController) -> Bool { return true } } 

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

IPhone के लिए लैंडस्केप

आईफ़ोन के लिए लैंडस्केप ओरिएंटेशन डिफ़ॉल्ट रूप से स्प्लिट के बिना काम करता है। यह स्प्लिट कंट्रोलर के लिए डिस्प्ले मोड द्वारा सही किया गया है:

 splitViewController.preferredDisplayMode = UISplitViewController.DisplayMode.allVisible 

जब भी संभव हो, हम मास्टर-डिटेल जोड़ी दिखाने के लिए पसंदीदा प्रदर्शन मोड सेट करते हैं। क्षमता एपीआई को निर्धारित करती है, इसे कॉन्फ़िगर करना असंभव है।

पोर्ट्रेट ओरिएंटेशन में भी यही रहेगा। लेकिन परिदृश्य में (केवल एक्स मैक्स और 8+ के लिए):

यदि स्प्लिट नियंत्रक के लिए शर्तें एसडीके में बदल जाती हैं, तो आपकी परियोजना उन्हें डिफ़ॉल्ट रूप से लागू करेगी।

आयाम

अनुकूलित किया जा सकता है। यह पहलू अनुपात द्वारा किया जाता है:

 splitViewController.preferredPrimaryColumnWidthFraction = 0.5 splitViewController.maximumPrimaryColumnWidth = 2000 

मास्टर और डिटेल एक ही साइज के होंगे। अधिकतमप्रमाण पत्र निर्धारित करना सुनिश्चित करें। वैकल्पिक रूप से, आप न्यूनतम चौड़ाई निर्धारित कर सकते हैं। मैंने स्क्रीनशॉट नहीं जोड़ा है, और ट्यूटोरियल के लिए बहुत सारे आईपैड हैं)

छिपने वाला मास्टर

एक बटन जोड़ें जो पूर्ण स्क्रीन में विवरण खोलता है। स्प्लिट कंट्रोलर .allV अदृश्य मोड में होना चाहिए। व्यू कंट्रोलर में डिटेल कंट्रोलर के लिए कोड पेस्ट करें:

 if let splitController = self.splitViewController{ if let navController = splitController.viewControllers.last as? UINavigationController { navController.topViewController?.navigationItem.leftBarButtonItem = splitController.displayModeButtonItem } } 

व्यवहार का वर्णन करना मुश्किल है, और जिफ एक मास्को बजट का आकार है। इसलिए एक स्क्रीनशॉट:

या मेरे पास ट्विटर पर एक वीडियो है ।

दिशानिर्देश

AutoLayout तत्वों को रखता है, स्प्लिट नियंत्रक नेविगेशन को निर्धारित करता है। एप्पल एक स्थिर मास्टर नियंत्रक का उपयोग करने की दृढ़ता से अनुशंसा करता है । प्रयोग के लिए, मैंने बाईं ओर एक नेविगेशन नियंत्रक बनाया, एक सेल पर क्लिक करके मैंने नियंत्रकों (विस्तार नियंत्रक को अद्यतन करने के बजाय) को धक्का दिया। यह अजीब लग रहा है।

सामान्य तौर पर, एक विभाजन दृश्य के एक तरफ नेविगेशन को प्रतिबंधित करें। विभाजन दृश्य के दोनों पैन में नेविगेशन रखने से लोगों को उन्मुख रहने और दो पैन के बीच संबंधों को समझने में मुश्किल होती है।

मास्टर नियंत्रक में सक्रिय चयन को हाइलाइट करें। हालाँकि डिटेल कंट्रोलर की सामग्री अलग-अलग हो सकती है, यह हमेशा मास्टर पर चयन से मेल खाना चाहिए। यह लोगों को नियंत्रकों के बीच संबंधों को नियंत्रित करने में मदद करेगा। नियंत्रकों को नियंत्रित करने के लिए - किसी प्रकार का एक दंड।

हर जगह स्प्लिट का उपयोग करने की आवश्यकता नहीं है। लेकिन अगर आपके एप्लिकेशन में मजबूत नेविगेशन है, और रूट कंट्रोलर टैब या नेविगेशन है, तो स्प्लिट सबसे अधिक उपयोगी है। यदि आपके पास एकल-स्क्रीन अनुवादक अनुप्रयोग है, तो आपको स्प्लिट की आवश्यकता नहीं है।

साधकों के लिए

प्रलेखन के लिए लिंक, दिशा निर्देशों के लिए लिंक।
यदि आप वीडियो देखना पसंद करते हैं, तो ट्यूटोरियल देखें: