Панели поиска в Xamarin.iOSSearch Bars in Xamarin.iOS

UISearchBar используется для поиска по списку значений.The UISearchBar is used to search through a list of values.

Он содержит три основных компонента:It contains three main components:

  • Поле, используемое для ввода текста.A field used to enter text. Пользователи могут использовать ее, введите их условие поиска.Users can utilize this to enter their search term.
  • Очистить кнопка, удалите весь текст из поля поиска.A clear button, to remove any text from the search field.
  • Кнопка "Отмена", чтобы выйти из функции поиска.A Cancel button, to exit the search function.

Панель поиска

Для реализации начало поиска с панели путем создания нового:To implement the search bar start by instantiating a new one:

searchBar = new UISearchBar();

И поместить ее содержимое.And then place it. В приведенном ниже примере показано, как поместить на панели навигации или в HeaderView таблицы:The example below shows how to place it in the navigation bar or in the HeaderView of a Table:

NavigationItem.TitleView = searchBar;

\\or

TableView.TableHeaderView = searchBar;

Установка свойств на панели поиска:Setting properties on the Search bar:

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

Свойства панели поиска

Повышение SearchButtonClicked событие при нажатии кнопки «search».Raise the SearchButtonClicked event when the search button is pressed. Это вызовет логику поиска:This will call your search logic:

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

Сведения об управлении представлением панель поиска и результаты поиска, см. поиска контроллера рецепт.For information on managing the presentation of the search bar and search results, refer to the Search Controller recipe.

Используя панель поиска в конструктореUsing the Search Bar in the Designer

Конструктор предлагает два варианта реализации панель поиска в конструктореThe Designer offers two options for implementing a Search Bar in the designer

  • Панель поискаSearch Bar
  • Панель поиска с помощью поиска контроллера (устаревшая версия)Search Bar with Search Display Controller (Deprecated)

Элементы управления панели поиска в конструкторе

Использование панели «Свойства» для задания свойств на панели поискаUse the Property Panel to set properties on the search bar

Конструктор свойств панель поиска

Эти свойства будут объяснены ниже:These properties are explained below:

  • Текстовый заполнитель, запрос — эти свойства используются может предложить или указать, каким образом пользователи следует использовать панели поиска.Text, Placeholder, Prompt – These properties are used to suggest and instruct how users should use the search bar. Например если приложение отображается список хранилищ можно использовать свойство prompt информацией, что для «ввода города, название материала или почтовый индекс»For example, if your app displayed a list of stores you could use the prompt property to advise that users can "Enter a city, story name, or Zip Code"

  • Поиск стиля — можно задать строке поиска, чтобы быть Prominent или минимальным.Search Style – You can set the search bar to either be Prominent or Minimal. С помощью известных будет оттенка все остальное, на экране, за исключением поиска линейчатым диаграммам, вызывая фокуса рисуется на панели поиска.Using the prominent will tint everything else on screen, except for the search bar, causing the focus to be drawn to the search bar. На панели поиска минимальной стиля будет органично вписывающиеся в окружающей среды.The minimal style search bar will blend in with its surroundings.

  • Возможности — Включение эти свойства отображаются только элемент пользовательского интерфейса.Capabilities – Enabling these properties only displays the UI element. Функции должен быть реализован для них путем вызова правильного события, перечисленные в документация по API панель поискаThe functionality must be implemented for these by raising the correct event as detailed in the Search Bar API docs

    • Показаны результаты поиска / кнопки закладки – отображается значок результатов поиска или закладки на панели поискаShows Search Results / Bookmarks button – Shows a Search Results or Bookmarks icon on the search bar
    • Показывает кнопки "Отмена" — позволяет пользователям, чтобы выйти из функции поиска.Shows Cancel button – Allows users to exit out of the search function. Рекомендуется, что этот параметр выбран.It is recommended that this is selected.
    • Отображает область — это позволяет ограничить область поиска.Shows Scope Bar – This allows users to limit the scope of their search. Например при поиске в приложение music он может выбрать ли для поиска Apple Music или их библиотеки для определенного Song (песня) или исполнителя.For example, when searching in the music app the user can select whether they want to search Apple Music or their Library for a particular song or artist. Чтобы отобразить различные параметры, добавьте массив заголовков ScopeBarTitles свойство.To display various options, add an array of titles to the ScopeBarTitles property. Заголовки область панели поискаSearch bar scope titles
  • Поведение текста — эти параметры используются для решения, форматируется как входные данные пользователя при вводе.Text behavior – These options are used to address how the user input is formatted when they are typing. Регистр букв задаст начала каждого слова или предложения, или каждый символ в верхнем регистре.Capitalization will set the start of each word or sentence, or every character as upper case. Исправления и орфографии при помощи выводится предлагаемых вариантов слов в процессе их набора.Correction and Spell Checking with prompt the user with suggested spellings of words as they type.

  • Клавиатуры — элементы управления клавиатуры стиль отображения для входных данных, и поэтому какие ключи доступны на клавиатуре.Keyboard – Controls the keyboard style displayed for the input, and therefore what keys are available on the keyboard. Сюда входят дополнительная клавиатура, панели для телефона, адрес электронной почты, URL-адрес, а также другие параметры.This includes Number Pad, Phone Pad, Email, URL along with other options.

  • Внешний вид — определяет стиль оформления клавиатуры и будет либо Темная или Светлая темы.Appearance – Controls the appearance style of the keyboard and will be either dark or light themed.

  • Возвращает ключ — изменить метки на клавиша Return для лучшего отражения, какое действие будет выполнено.Return Key – Change the label on the Return key to better reflect what action will be taken. Поддерживаются следующие значения: Go, соединения, Next, маршрут, Готово и поиска.Supported values include Go, Join, Next, Route, Done, and Search.

  • Защита — идентифицирующее маскировки входные данные (например, для ввода пароля).Secure – Identifies whether the input is masked (such as for a Password input).