Uso dei controller della barra delle schede tvOS in Xamarin
Per molti tipi di app tvOS, lo spostamento principale viene presentato come barra di tabulazioni in esecuzione nella parte superiore dello schermo. L'utente scorre verso sinistra e verso destra nell'elenco delle possibili categorie e l'area di contenuto sotto le modifiche per riflettere la selezione dell'utente.
La barra tabulazioni è traslucente per impostazione predefinita e viene sempre visualizzata nella parte superiore dello schermo. Quando è attiva, una barra di tabulazione coprirà i primi 140 pixel dello schermo, ma sposterà rapidamente quando lo stato attivo passa all'area del contenuto sottostante.
Barre delle schede in tvOS
Il UITabViewController funziona in modo simile e serve uno scopo simile su tvOS come lo fa in iOS, con le differenze principali seguenti:
- A differenza della barra tabulazioni in iOS visualizzata nella parte inferiore dello schermo, le barre tabulazioni in tvOS occupano i primi 140 pixel dello schermo e sono traslucenti per impostazione predefinita.
- Quando lo stato attivo lascia la barra di tabulazione per l'area di contenuto sottostante, la barra di tabulazione scorrerà rapidamente dalla parte superiore dello schermo e verrà nascosta. L'utente può toccare il pulsante Menu una volta o scorrere verso l'alto su Siri Remote per visualizzare di nuovo la barra delle schede.
- Lo scorrimento verso il basso su Siri Remote sposta lo stato attivo sull'area del contenuto sotto la barra delle schede al primo elemento attivabile nel contenuto visualizzato. Anche in questo caso, la barra di tabulazione verrà nascosta quando lo stato attivo viene spostato.
- Facendo clic per selezionare una categoria visualizzata nella barra delle schede, il contenuto della categoria verrà spostato sul primo elemento attivabile in tale visualizzazione.
- Il numero di categorie visualizzate nella barra delle schede deve essere corretto e tutte le categorie devono essere sempre accessibili, una determinata categoria non deve mai essere disabilitata.
- Le barre delle schede non supportano la personalizzazione in tvOS. Inoltre, non visualizzano altre categorie (ad esempio iOS) se sono presenti più categorie di quelle che possono rientrare nella barra delle schede.
Apple offre i suggerimenti seguenti per l'uso delle barre delle schede:
- Usa barre di tabulazioni per organizzare logicamente il contenuto : usa la barra delle schede per organizzare logicamente il contenuto usato dall'app tvOS. Ad esempio, In primo piano, Grafici principali, Acquistati e Cerca.
- Aggiungi badge per informare gli utenti del nuovo contenuto : è possibile visualizzare facoltativamente un badge (un ovale rosso con un numero bianco o un punto esclamativo) per informare l'utente del nuovo contenuto in una categoria.
- Usa badge con moderazione: non ingombrare la barra delle schede con badge e visualizzarle solo dove forniscono informazioni critiche all'utente.
- Limitare il numero di categorie : per ridurre la complessità e mantenere gestibile l'app, non sovraccaricare la barra delle schede con categorie e assicurarsi che tutte le categorie siano visibili e non affollate. I titoli semplici e brevi funzionano meglio.
- Non disabilitare una categoria : tutte le schede (categorie) devono essere sempre visibili e abilitate sempre. Se una scheda specificata non contiene contenuto, fornire una spiegazione al motivo dell'utente. Ad esempio, la scheda Acquisti sarà vuota se l'utente non ha effettuato acquisti.
Elementi della barra delle schede
Ogni categoria (scheda) nella barra delle schede è rappresentata da un elemento della barra di tabulazioni (UITabBarItem). Apple offre i suggerimenti seguenti per l'uso degli elementi della barra delle schede:
- Usa schede basate su testo: mentre l'elemento della barra di tabulazione è in grado di essere rappresentato come icona, Apple suggerisce di usare testo solo perché un titolo conciso è più facile da interpretare rispetto a un'icona.
- Usare sostantivi brevi, significativi o verbi: un elemento della barra di tabulazioni deve indicare chiaramente il contenuto che contiene e funziona meglio quando si tratta di un sostantivo semplice (ad esempio Foto, film o Musica) o verbi (ad esempio Ricerca o Riproduzione).
Barre di tabulazioni e storyboard
Il modo più semplice per usare le barre delle schede in un'app Xamarin.tvOS consiste nell'aggiungerli all'interfaccia utente dell'app usando iOS Designer.
Avviare una nuova app Xamarin.tvOS e selezionare app a schede app tvOS>>:
Seguire tutte le istruzioni per creare una nuova soluzione Xamarin.tvOS.
Nel riquadro della soluzione fare doppio clic sul
Main.storyboardfile e aprirlo per la modifica.Per modificare l'icona o il titolo per una determinata categoria, selezionare l'elemento della barra di tabulazioni per il controller di visualizzazione nella struttura del documento:
Impostare quindi le proprietà necessarie nella scheda Widget di Esplora proprietà:
Per aggiungere una nuova categoria (scheda), rilasciare un controller di visualizzazione nell'area di progettazione:
Fare clic sul controllo e trascinare dal controller visualizzazione schede al nuovo controller di visualizzazione.
Nella finestra popup selezionare i controller di visualizzazione per aggiungere la nuova visualizzazione come scheda (categoria):
Progettare il layout dell'interfaccia utente per ogni area di contenuto Caterogies come di consueto, aggiungendo elementi dell'interfaccia utente in iOS Designer.
Esporre gli eventi necessari per lavorare con i controlli dell'interfaccia utente nel codice C#.
Assegnare un nome a tutti i controlli dell'interfaccia utente da esporre nel codice C#.
Salva le modifiche.
Importante
Anche se è possibile assegnare eventi come TouchUpInside a un elemento dell'interfaccia utente (ad esempio un UIButton) in iOS Designer, non verrà mai chiamato perché Apple TV non ha un touch screen o supporta gli eventi di tocco. È consigliabile usare sempre l'evento Primary Action quando si creano gestori eventi per gli elementi dell'interfaccia utente tvOS.
Per altre informazioni sull'uso degli storyboard, vedere la guida introduttiva hello, tvOS.
Utilizzo delle barre delle schede
Utilizzare la Items proprietà di UITabBar per accedere all'insieme di UITabBarItems contiene come matrice indicizzata zero (0). La SelectedItem proprietà restituirà la scheda attualmente selezionata (categoria) come .UITabBarItem
Utilizzo degli elementi della barra delle schede
Per visualizzare un badge in una determinata scheda (un ovale rosso con testo bianco), usare il codice seguente:
// Display a badge
TabBar.Items [2].BadgeValue = "10";
Che produrrebbe i risultati seguenti durante l'esecuzione:
Utilizzare la Title proprietà di UITabBarItem per modificare il titolo e la Image proprietà per modificare l'icona.
Riepilogo
Questo articolo ha illustrato la progettazione e l'uso del controller della barra di tabulazione all'interno di un'app Xamarin.tvOS.