Barre di ricerca in Xamarin.iOS

UISearchBar viene usato per eseguire ricerche in un elenco di valori.

Contiene tre componenti principali:

• Campo utilizzato per immettere testo. Gli utenti possono usarlo per immettere il termine di ricerca.
• Pulsante cancella per rimuovere qualsiasi testo dal campo di ricerca.
• Pulsante Annulla per uscire dalla funzione di ricerca.

Implementazione della barra di ricerca

Per implementare la barra di ricerca iniziare creando un'istanza di una nuova:

searchBar = new UISearchBar();

E poi metterlo. L'esempio seguente mostra come posizionarlo nella barra di spostamento o in HeaderView di una tabella:

NavigationItem.TitleView = searchBar;

// or

TableView.TableHeaderView = searchBar;

Impostazione delle proprietà sulla barra di ricerca:

 searchBar = new UISearchBar(){
                Placeholder = "Enter your search Item",
                Prompt = "Search Entered here",
                ShowsScopeBar = true,
                ScopeButtonTitles = new string[]{ "Boston", "London", "SF" },
            };

Generare l'evento SearchButtonClicked quando viene premuto il pulsante di ricerca. Questa operazione chiamerà la logica di ricerca:

searchBar.SearchButtonClicked += (sender, e) => {
                Search ();
            };

Per informazioni sulla gestione della presentazione della barra di ricerca e dei risultati della ricerca, vedere la ricetta del controller di ricerca.

Utilizzo della barra di ricerca nella finestra di progettazione

Progettazione offre due opzioni per l'implementazione di una barra di ricerca nella finestra di progettazione

• Barra di ricerca
• Barra di ricerca con il controller di visualizzazione della ricerca (deprecato)

Usare il pannello delle proprietà per impostare le proprietà sulla barra di ricerca

Queste proprietà sono illustrate di seguito:

• Testo, Segnaposto, Prompt : queste proprietà vengono usate per suggerire e indicare come gli utenti devono usare la barra di ricerca. Ad esempio, se l'app visualizza un elenco di negozi, è possibile usare la proprietà prompt per consigliare agli utenti di immettere una città, un nome di storia o un codice postale.

• Stile di ricerca: è possibile impostare la barra di ricerca su Prominent o Minimal. L'uso del carattere prominente tinterà tutto il resto sullo schermo, ad eccezione della barra di ricerca, causando il disegno dello stato attivo sulla barra di ricerca. La barra di ricerca di stile minima si fonderà con l'ambiente circostante.

• Funzionalità: l'abilitazione di queste proprietà visualizza solo l'elemento dell'interfaccia utente. La funzionalità deve essere implementata per questi generando l'evento corretto come descritto nella documentazione dell'API Della barra di ricerca

  • Mostra il pulsante Risultati ricerca/Segnalibri: mostra un'icona risultati o segnalibri nella barra di ricerca
  • Mostra il pulsante Annulla: consente agli utenti di uscire dalla funzione di ricerca. È consigliabile selezionare questa opzione.
  • Mostra barra dell'ambito: consente agli utenti di limitare l'ambito della ricerca. Ad esempio, durante la ricerca nell'app musicale l'utente può selezionare se desidera cercare apple Musica o la raccolta per una determinata canzone o artista. Per visualizzare varie opzioni, aggiungere una matrice di titoli alla proprietà ScopeBarTitles .

• Comportamento del testo: queste opzioni vengono usate per gestire la formattazione dell'input dell'utente durante la digitazione. La maiuscola imposta l'inizio di ogni parola o frase o ogni carattere come maiuscolo. Correzione e controllo ortografico con richiesta all'utente con ortografia suggerite di parole durante la digitazione.

• Tastiera : controlla lo stile della tastiera visualizzato per l'input e quindi quali tasti sono disponibili sulla tastiera. Sono inclusi il riquadro numerico, Telefono pad, l'indirizzo di posta elettronica, l'URL e altre opzioni.

• Aspetto : controlla lo stile di aspetto della tastiera e sarà scuro o chiaro.

• Chiave restituita: modificare l'etichetta nella chiave Restituita per riflettere meglio l'azione che verrà eseguita. I valori supportati includono Go, Join, Next, Route, Done e Search.

• Secure : identifica se l'input è mascherato, ad esempio per un input password.

Collegamenti correlati

• Controller di ricerca