Full Screen Cover: ce este, prezentare pe ecran complet și UIKit

Ce este Full Screen Cover în iOS?

Full Screen Cover — este un stil de prezentare modală în iOS, în care controlerul prezentat ocupă întregul ecran al dispozitivului. Conținutul părinte este complet ascuns, ceea ce creează un efect de imersiune și concentrează utilizatorul asupra sarcinii curente.

Până la iOS 13, Full Screen Cover era singurul stil de prezentare modală pe iPhone. Toate apelurile present(_:animated:completion:) utilizau implicit .fullScreen. Începând cu iOS 13, Apple a schimbat stilul implicit la .automatic, care pentru iPhone alege .pageSheet. Cu toate acestea, Full Screen Cover rămâne disponibil și este utilizat pentru scenarii unde concentrarea completă este importantă.

Spre deosebire de Page Sheet, Full Screen Cover nu permite interacțiunea cu conținutul părinte și nu îl afișează sub fereastra modală. Utilizatorul nu poate închide Full Screen Cover prin glisare în jos — pentru închidere este necesar un apel programatic dismiss(animated:completion:) sau un buton de închidere pe ecran. Acest comportament este important de luat în considerare la proiectarea UX.

Full Screen Cover vs Page Sheet: compararea stilurilor

Page Sheet — al doilea stil principal de prezentare modală, apărut în iOS 13. Page Sheet se afișează ca un card cu margine sus, sub care se vede ecranul părinte. Utilizatorul poate închide Page Sheet prin glisare în jos. Full Screen Cover, dimpotrivă, ascunde conținutul părinte și nu suportă închiderea prin glisare.

Alegerea între Full Screen Cover și Page Sheet depinde de conținut și context. Se recomandă utilizarea Full Screen Cover pentru conținut care necesită atenție deplină: video în modul ecran complet, previzualizare fotografii, scanare documente. Page Sheet — pentru sarcini unde contextul ecranului părinte este important: formulare de editare, selectare opțiuni, vizualizare detalii.

Implementare pe UIKit: UIModalPresentationStyle

UIKit oferă constanta UIModalPresentationStyle.fullScreen pentru configurarea stilului de prezentare modală. Setarea acestei proprietăți pe UIViewController înainte de apelul present garantează că controlerul se va afișa pe tot ecranul. Controlerul gestionează și comportamentul la apariția tastaturii și procesarea evenimentelor sistemice.

Configurare și delegat

După setarea stilului .fullScreen, se recomandă configurarea presentationController?.delegate pentru gestionarea evenimentelor de închidere. Delegatul UIAdaptivePresentationControllerDelegate permite interceptarea încercării de închidere și prevenirea pierderii datelor. Spre deosebire de Page Sheet, pentru Full Screen Cover delegatul se activează doar la apelul programatic dismiss.

Gestionarea rotației și a tastaturii

Full Screen Cover gestionează corect rotația ecranului și apariția tastaturii. La rotație, controlerul modal se adaptează automat la noua orientare. UIKeyboardWillShowNotification permite deplasarea conținutului în sus la apariția tastaturii, astfel încât câmpurile de text să rămână vizibile. Spre deosebire de Page Sheet, Full Screen Cover nu își schimbă dimensiunile la apariția tastaturii.

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

// Respinge
dismiss(animated: true) {
    print("Player respins")
}

SwiftUI: modificatorul .fullScreenCover

SwiftUI oferă modificatorul .fullScreenCover pentru crearea declarativă a ferestrelor modale pe ecran complet. Spre deosebire de .sheet (Page Sheet), .fullScreenCover creează stilul .fullScreen cu comportament analog: acoperire completă a conținutului și absența închiderii prin glisare.

Utilizare cu binding și date

Modificatorul acceptă un binding de tip Bool sau un obiect identificabil opțional. La setarea binding la true, SwiftUI animează apariția ferestrei pe ecran complet. Pentru transmiterea datelor se utilizează parametrul onDismiss și o închidere cu conținut. Valoarea de mediu \.dismiss permite închiderea ferestrei modale din interior.

Full Screen Cover vs Sheet

Alegerea între .fullScreenCover și .sheet în SwiftUI este similară cu UIKit: .fullScreenCover pentru conținut imersiv, .sheet pentru carduri. SwiftUI selectează automat comportamentul corect de închidere: .sheet poate fi închis prin glisare, .fullScreenCover — doar programatic. Modificatoarele pot fi combinate în aceeași ierarhie de View.

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

    var body: some View {
        Button("Deschide camera") {
            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("Captură") { dismiss() }
                    .foregroundColor(.white)
            }
        }
    }
}

Animații și tranziții personalizate

Full Screen Cover suportă animații personalizate prin UIModalTransitionStyle în UIKit și tranziții personalizate în SwiftUI. Stilurile standard: .coverVertical (de jos în sus), .crossDissolve (apariție treptată), .flipHorizontal (întoarcere) și .partialCurl (efect de pagină).

UIKit: UIViewControllerAnimatedTransitioning

Pentru o animație complet personalizată, implementați protocolul UIViewControllerAnimatedTransitioning. Acesta vă permite să definiți durata animației și tranziția în sine prin metoda animateTransition(using:). Controlerul de animație este atribuit prin delegatul UINavigationControllerDelegate sau UIViewControllerTransitioningDelegate.

SwiftUI: Matched Geometry Effect

În SwiftUI, tranzițiile personalizate pentru .fullScreenCover se creează prin matchedGeometryEffect. Acest modificator animează mutarea unui element din View-ul părinte în fereastra pe ecran complet. De exemplu, la apăsarea unei miniaturi foto, aceasta se extinde lin pe tot ecranul, creând un efect de continuitate. MatchedGeometryEffect funcționează cu id și namespace, care leagă elementul în poziția sursă și țintă.

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()
        }
    }
}

Când să utilizați Full Screen Cover?

Full Screen Cover este recomandat pentru scenarii în care conținutul trebuie să ocupe întregul ecran fără distragerea atenției de la interfața părinte. Apple HIG evidențiază trei categorii principale: conținut media, instrumente de creare a conținutului și interfețe temporare de sistem.

Media și divertisment

Playere video, vizualizare fotografii, citire PDF și benzi desenate — exemple tipice de utilizare a Full Screen Cover. AVPlayerViewController în iOS utilizează automat modul ecran complet la trecerea în landscape. Editorii foto precum Adobe Lightroom deschid editorul pe ecran complet deasupra bibliotecii de imagini.

Instrumente de creare a conținutului

Cameră, scaner de documente, înregistrare audio — sarcini care necesită atenția deplină a utilizatorului. UIImagePickerController până la iOS 14 utiliza Full Screen Cover pentru cameră. Începând cu iOS 14, selectorul de sistem utilizează Page Sheet, dar dezvoltatorul poate forța .fullScreen pentru o cameră personalizată.

Ce să evitați

Nu utilizați Full Screen Cover pentru: formulare de înregistrare (preferabil Page Sheet), ecrane cu introducere text unde contextul paginii părinte este important și navigare secvențială în interiorul ferestrei modale. Material Design recomandă, de asemenea, evitarea blocării butonului de înapoi al sistemului — în iOS acest lucru este permis, dar utilizatorul trebuie să aibă o modalitate clară de închidere printr-un element de interfață.