Full Screen Cover: یہ کیا ہے، فل سکرین پریزینٹیشن اور UIKit

iOS میں Full Screen Cover کیا ہے؟

Full Screen Cover iOS میں موڈل پریزینٹیشن کا ایک انداز ہے جس میں پیش کیا گیا کنٹرولر پورے آلے کی سکرین پر قابض ہو جاتا ہے۔ والد مواد مکمل طور پر چھپ جاتا ہے، ایک مغموس اثر پیدا کرتا ہے اور صارف کو موجودہ کام پر مرکوز کرتا ہے۔

iOS 13 سے پہلے، Full Screen Cover iPhone پر واحد موڈل پریزینٹیشن انداز تھا۔ present(_:animated:completion:) کی تمام کالیاں طے طور پر .fullScreen استعمال کرتی تھیں۔ iOS 13 سے شروع کرکے، Apple نے طے شدہ انداز کو .automatic میں بدل دیا، جو iPhone کے لیے .pageSheet کا انتخاب کرتا ہے۔ تاہم، Full Screen Cover اب بھی دستیاب ہے اور ان مناظر کے لیے استعمال ہوتا ہے جہاں مکمل توجہ اہم ہے۔

Page Sheet کے برعکس، Full Screen Cover والد مواد کے ساتھ بات چیت کی اجازت نہیں دیتا اور نہ ہی اسے موڈل وینڈو کے نیچے دیکھاتا ہے۔ صارف Full Screen Cover کو نیچے سوائپ کرکے بند نہیں کر سکتا — بند کرنے کے لیے dismiss(animated:completion:) کا پروگرامی کال یا سکرین پر ایک بند بٹن درکار ہے۔ UX ڈزائن کرتے وقت اس رویے پر غور کرنا اہم ہے۔

Full Screen Cover بنام Page Sheet: اندازوں کا موازنہ

Page Sheet دوسرا اہم موڈل پریزینٹیشن انداز ہے، جو iOS 13 میں متعارف کرایا گیا تھا۔ Page Sheet ایک کارڈ کے طور پر اوپر کے مارجن کے ساتھ ظاہر ہوتا ہے، جس کے نیچے والد سکرین نظر آتی ہے۔ صارف نیچے سوائپ کرکے Page Sheet کو بند کر سکتا ہے۔ Full Screen Cover، اس کے برعکس، والد مواد کو چھپاتا ہے اور سوائپ بند کی حمایت نہیں کرتا۔

Full Screen Cover اور Page Sheet کے درمیان انتخاب کا انحصار مواد اور سیاق پر ہے۔ سفارش کی جاتی ہے Full Screen Cover کو ان مواد کے لیے استعمال کیا جائے جنہیں مکمل توجہ کی ضرورت ہے: فل سکرین ویڈیو، فوٹو پری ویو، دستاویز اسکیننگ۔ Page Sheet ان کاموں کے لیے ہے جہاں والد سکرین کا سیاق اہم ہے: ترمیم فارم، اختیارات کا انتخاب، مفصل منظر۔

UIKit میں نفاذ: UIModalPresentationStyle

UIKit موڈل پریزینٹیشن انداز کو ترتیب دینے کے لیے UIModalPresentationStyle.fullScreen مساقر فراہم کرتا ہے۔ present کال کرنے سے پہلے UIViewController پر یہ خاصیت مقرر کرنے سے یقینی ہوتا ہے کہ کنٹرولر فل سکرین پر ظاہر ہوگا۔ کنٹرولر کیبورڈ ظاہر ہونے پر رویے کا بھی انتظام کرتا ہے اور سسٹم واقعات کو ہنڈل کرتا ہے۔

ترتیب اور نائب

.fullScreen انداز مقرر کرنے کے بعد، بند کرنے کے واقعات کو سنبھالنے کے لیے presentationController?.delegate ترتیب دینے کی سفارش کی جاتی ہے۔ UIAdaptivePresentationControllerDelegate نائب بند کرنے کی کوششوں کو روکنے اور ڈیٹا کے نقصان کو روکنے کی اجازت دیتا ہے۔ Page Sheet کے برعکس، Full Screen Cover کے لیے نائب صرف پروگرامی dismiss کالیاں پر چالو ہوتا ہے۔

گھومنے اور کیبورڈ کا انتظام

Full Screen Cover سکرین کے گھومنے اور کیبورڈ کے ظاہر ہونے کو صحیح طور پر سنبھالتا ہے۔ گھومنے پر، موڈل کنٹرولر خود بخود نئی سمت کے مطابق ڢھ جاتا ہے۔ UIKeyboardWillShowNotification کیبورڈ ظاہر ہونے پر مواد کو اوپر لے جانے کی اجازت دیتا ہے، تاکہ متن کے میدان نظر آتے رہیں۔ Page Sheet کے برعکس، Full Screen Cover کیبورڈ ظاہر ہونے پر اپنا حجم نہیں بدلتا۔

let playerVC = VideoPlayerViewController()
playerVC.modalPresentationStyle = .fullScreen
playerVC.modalTransitionStyle = .crossDissolve
present(playerVC, animated: true) {
    playerVC.startPlayback()
}

// بند کریں
dismiss(animated: true) {
    print("پلیئر بند کر دیا گیا")
}

SwiftUI: .fullScreenCover ترمیم کنندہ

SwiftUI فل سکرین موڈل وینڈو کی اعلانی تخلیق کے لیے ترمیم کنندہ .fullScreenCover فراہم کرتا ہے۔ .sheet (Page Sheet) کے برعکس، .fullScreenCover ایکجہی رویے کے ساتھ .fullScreen انداز تخلیق کرتا ہے: مکمل مواد احاطہ اور سوائپ سے بند نہیں ہوتا۔

Binding اور ڈیٹا کے ساتھ استعمال

ترمیم کنندہ Bool یا ایک اختیاری قابل شناخت آئٹم میں binding قبول کرتا ہے۔ جب binding true پر مقرر کی جاتی ہے، SwiftUI فل سکرین وینڈو کے ظاہر ہونے کو اینیمیٹ کرتا ہے۔ ڈیٹا منتقل کرنے کے لیے onDismiss پیرامیٹر اور مواد کے ساتھ ایک کلوزر استعمال ہوتا ہے۔ \.dismiss ماحول کی قیمت موڈل وینڈو کو اندر سے بند کرنے کی اجازت دیتی ہے۔

Full Screen Cover بنام Sheet

SwiftUI میں .fullScreenCover اور .sheet کے درمیان انتخاب UIKit کے مشابہ ہے: .fullScreenCover مغموس مواد کے لیے، .sheet کارڈ کے لیے۔ SwiftUI خود بخود صحیح بند کے رویے کا انتخاب کرتا ہے: .sheet سوائپ سے بند کیا جا سکتا ہے، .fullScreenCover صرف پروگرامی۔ ترمیمات کو ایک View کے درجہ بندی میں مضمون کیا جا سکتا ہے۔

struct CameraView: View {
    @State private var showCamera = false

    var body: some View {
        Button("کیمرا کھولیں") {
            showCamera = true
        }
        .fullScreenCover(isPresented: $showCamera) {
            CameraPreviewView()
                .ignoresSafeArea()
        }
    }
}

struct CameraPreviewView: View {
    @Environment(\.dismiss) private var dismiss

    var body: some View {
        ZStack {
            Color.black.ignoresSafeArea()
            VStack {
                Spacer()
                Button("کیپچر") { dismiss() }
                    .foregroundColor(.white)
            }
        }
    }
}

کسٹم اینیمیشنز اور ٹرانزیشنز

Full Screen Cover UIKit میں UIModalTransitionStyle اور SwiftUI میں کسٹم ٹرانزیشنز کے ذریعہ کسٹم اینیمیشنز کی حمایت کرتا ہے۔ معیاری اندازوں میں شامل ہیں: .coverVertical (نیچے سے اوپر), .crossDissolve (آہستہ ظاہر ہونا), .flipHorizontal (پلٹنا) اور .partialCurl (ورق کا اثر)۔

UIKit: UIViewControllerAnimatedTransitioning

مکمل طور پر کسٹم اینیمیشن کے لیے، UIViewControllerAnimatedTransitioning پروٹوکل نفاذ کریں۔ یہ animateTransition(using:) طریقے کے ذریعہ اینیمیشن کی میاد اور ٹرانزیشن کو متعین کرنے کی اجازت دیتا ہے۔ اینیمیشن کنٹرولر UINavigationControllerDelegate یا UIViewControllerTransitioningDelegate کے ذریعہ مقرر کیا جاتا ہے۔

SwiftUI: Matched Geometry Effect

SwiftUI میں، .fullScreenCover کے لیے کسٹم ٹرانزیشنز matchedGeometryEffect کا استعمال کرکے تخلیق کیئے جاتے ہیں۔ یہ ترمیم کنندہ ایک عنصر کو والد View سے فل سکرین وینڈو میں لے جانے کی اینیمیشن کرتا ہے۔ مثال کے طور پر، فوٹو کے تھمب نےل پر ٹاپ کرنے پر یہ آہستہ فل سکرین پر پھیل جاتا ہے، ایک تسلسل کا اثر پیدا کرتا ہے۔ matchedGeometryEffect ایڡ اور namespace کے ساتھ کام کرتا ہے جو عنصر کو مبدئی اور منزل کی پوزیشنوں میں منسلک کرتا ہے۔

struct PhotoViewer: View {
    @State private var selectedPhoto: String?
    @Namespace private var animation

    var body: some View {
        HStack {
            ForEach(["photo1", "photo2"], id: \.self) { photo in
                Image(photo)
                    .matchedGeometryEffect(id: photo, in: animation)
                    .onTapGesture { selectedPhoto = photo }
            }
        }
        .fullScreenCover(item: $selectedPhoto) { photo in
            Image(photo)
                .matchedGeometryEffect(id: photo, in: animation)
                .ignoresSafeArea()
        }
    }
}

Full Screen Cover کب استعمال کریں؟

Full Screen Cover ان مناظر کے لیے سفارش کی جاتی ہے جہاں مواد والد انٹرفیس سے خلل کے بغیر پوری سکرین پر ہونے چاہیئے۔ Apple HIG تین اہم زمرے کی شناخت کرتا ہے: میڈیا مواد، مواد تخلیق کے اوزار اور عارضی سسٹم انٹرفیسز۔

میڈیا اور تفریح

ویڈیو پلیئر، فوٹو دیکھنا، PDF اور کامکس پڑھنا Full Screen Cover کے معمولی استعمال کی مثالیں ہیں۔ iOS میں AVPlayerViewController لینڈ سکیپ پر جانے پر خود بخود فل سکرین موڈ استعمال کرتا ہے۔ Adobe Lightroom جیسے فوٹو ایڈیٹر فوٹو لائبریری کے اوپر فل سکرین ایڈیٹر کھولتے ہیں۔

مواد تخلیق کے اوزار

کیمرا، دستاویز اسکینر، آواز ریکارڈنگ — ایسے کام جنہیں صارف کی مکمل توجہ کی ضرورت ہے۔ UIImagePickerController iOS 14 سے پہلے کیمرا کے لیے Full Screen Cover استعمال کرتا تھا۔ iOS 14 سے شروع کرکے، سسٹم پاکر Page Sheet استعمال کرتا ہے، لیکن ڈیولپر کسٹم کیمرا کے لیے .fullScreen مجبور کر سکتا ہے۔

کین چیزوں سے بچیں

Full Screen Cover کو ان کے لیے استعمال نکریں: اندراج کے فارم (Page Sheet بہتر ہے)، متن درج کے ساتھ والی سکرینیں جہاں والد صفحہ کا سیاق اہم ہے، اور موڈل وینڈو کے اندر مسلسل نیویگیشن۔ Material Design بھی سسٹم کے پیچے بٹن کو بلاک کرنے سے بچنے کی سفارش کرتا ہے — iOS میں یہ قابل قبول ہے، لیکن صارف کے پاس UI عنصر کے ذریعہ بند کرنے کا ایک واضح طریقہ ہونا چاہیئے۔