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).