Paski wyszukiwania na platformie Xamarin.iOS

Element UISearchBar służy do przeszukiwania listy wartości.

Zawiera trzy główne składniki:

• Pole używane do wprowadzania tekstu. Użytkownicy mogą z tego skorzystać, aby wprowadzić wyszukiwany termin.
• Przycisk wyczyść, aby usunąć dowolny tekst z pola wyszukiwania.
• Przycisk Anuluj, aby zamknąć funkcję wyszukiwania.

Implementowanie paska wyszukiwania

Aby zaimplementować pasek wyszukiwania, zacznij od utworzenia wystąpienia nowego:

searchBar = new UISearchBar();

A następnie umieść go. W poniższym przykładzie pokazano, jak umieścić go na pasku nawigacyjnym lub w widoku HeaderView tabeli:

NavigationItem.TitleView = searchBar;

// or

TableView.TableHeaderView = searchBar;

Ustawianie właściwości na pasku wyszukiwania:

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

Zgłoś zdarzenie po naciśnięciu SearchButtonClicked przycisku wyszukiwania. Spowoduje to wywołanie logiki wyszukiwania:

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

Aby uzyskać informacje na temat zarządzania prezentacją paska wyszukiwania i wyników wyszukiwania, zapoznaj się z przepisem kontrolera wyszukiwania.

Używanie paska wyszukiwania w Projektant

Projektant oferuje dwie opcje implementowania paska wyszukiwania w projektancie

• Pasek wyszukiwania
• Pasek wyszukiwania z kontrolerem wyświetlania wyszukiwania (przestarzały)

Użyj panelu właściwości, aby ustawić właściwości na pasku wyszukiwania

Te właściwości zostały wyjaśnione poniżej:

• Tekst, symbol zastępczy, monit — te właściwości są używane do sugerowania i poinstruowania, jak użytkownicy powinni używać paska wyszukiwania. Jeśli na przykład aplikacja wyświetli listę sklepów, możesz użyć właściwości monitu, aby poinformować użytkowników, że "Wprowadź miasto, nazwę scenariusza lub kod pocztowy"

• Styl wyszukiwania — możesz ustawić pasek wyszukiwania na widoczny lub minimalny. Użycie widocznych elementów spowoduje przyciemnienie wszystkiego innego na ekranie, z wyjątkiem paska wyszukiwania, co powoduje narysowanie fokusu na pasku wyszukiwania. Minimalny pasek wyszukiwania stylu będzie się łączyć ze swoim otoczeniem.

• Możliwości — włączenie tych właściwości powoduje wyświetlenie tylko elementu interfejsu użytkownika. Funkcjonalność musi być zaimplementowana dla tych funkcji przez podniesienie prawidłowego zdarzenia zgodnie z opisem w dokumentacji interfejsu API paska wyszukiwania

  • Pokazuje przycisk Wyniki wyszukiwania/Zakładki — pokazuje ikonę Wyników wyszukiwania lub Zakładek na pasku wyszukiwania
  • Pokazuje przycisk Anuluj — umożliwia użytkownikom wyjście z funkcji wyszukiwania. Zaleca się wybranie tej opcji.
  • Pokazuje pasek zakresu — umożliwia użytkownikom ograniczenie zakresu wyszukiwania. Na przykład podczas wyszukiwania w aplikacji muzycznej użytkownik może wybrać, czy chcesz wyszukać muzykę Apple Music, czy bibliotekę dla określonej piosenki lub artysty. Aby wyświetlić różne opcje, dodaj tablicę tytułów do właściwości ScopeBarTitles .

• Zachowanie tekstu — te opcje służą do określania sposobu formatowania danych wejściowych użytkownika podczas wpisywania. Wielkie litery ustawią początek każdego wyrazu lub zdania albo każdy znak jako wielkie litery. Korekta i sprawdzanie pisowni z monitem użytkownika z sugerowanymi pisowniami wyrazów podczas ich wpisywania.

• Klawiatura — steruje stylem klawiatury wyświetlanym dla danych wejściowych i w związku z tym, jakie klawisze są dostępne na klawiaturze. Obejmuje to konsolę numerów, Telefon Pad, Adres e-mail, adres URL oraz inne opcje.

• Wygląd — określa styl wyglądu klawiatury i będzie ciemny lub jasny.

• Return Key — zmień etykietę na klawisz Return, aby lepiej odzwierciedlić akcję, która zostanie podjęta. Obsługiwane wartości to Go, Join, Next, Route, Done i Search.

• Secure — określa, czy dane wejściowe są maskowane (na przykład dla danych wejściowych hasła).

Linki powiązane

• Kontroler wyszukiwania