Работа с tvOS вкладку панели контроллеров в XamarinWorking with tvOS Tab Bar Controllers in Xamarin

Для многих типов приложений tvOS первичная Навигация представляется в виде — панель вкладок под управлением в верхней части экрана.For many types of tvOS apps, primary navigation is presented as a Tab Bar running across the top of the screen. Пользователь предъявляет влево и вправо по списку возможно категорий и область содержимого ниже изменения в соответствии с выбранным пользователем.The user swipes left and right across the list of possible Categories and the content area below the changes to reflect the user's selection.

Панель вкладок прозрачным по умолчанию и всегда отображается в верхней части экрана.The Tab Bar is translucent by default and always appears at the top of the screen. В фокусе, — панель вкладок покрывают top 140 пикселей экрана, но быстро будет слайд сейчас, когда фокус переходит к области содержимого.When in focus, a Tab Bar will cover the top 140 pixels of the screen but will quickly slide away when focus shifts to the content area below.

Панели вкладки в tvOSTab Bars in tvOS

UITabViewController Работает так же, как и служат одинаковой цели в tvOS, как и в iOS, со следующими отличиями ключа:The UITabViewController works in a similar manner and serves a similar purpose on tvOS as it does in iOS, with the following key differences:

  • В отличие от панель вкладок в iOS, которое отображается в нижней части экрана панели вкладки в tvOS занимают top 140 пикселей экрана и прозрачные по умолчанию.Unlike the Tab Bar on iOS which appears at the bottom of the screen, Tab Bars in tvOS occupy the top 140 pixels of the screen and are translucent by default.
  • Когда фокус покидает панель вкладок для области содержимого, на вкладке панели будет быстро слайд из верхней части экрана и скрываться.When focus leaves the Tab Bar for the content area below, the Tab Bar will quickly slide off the top of the screen and be hidden. Пользователя можно один раз коснитесь кнопки меню или проведите пальцем вверх на Siri Remote Чтобы снова отобразить панель вкладок.The user can either tap the Menu button once or swipe up on the Siri Remote to show the Tab Bar again.
  • Проводя пальцем вниз на удаленном Siri будет переместить фокус на области содержимого под панель вкладок, чтобы первый , способному получать фокус элемент в содержанием.Swiping down on the Siri Remote will move focus to the content area below the Tab Bar to the first Focusable Item in the content being shown. Опять же при этом будут скрыты панели вкладки после фокуса.Again, this will hide the Tab Bar once focus shifts.
  • Щелкните для выбора категории отображаются в панели вкладок переключится, содержимое и фокус категории переключается к первому элементу, способному получать фокус, в этом представлении.Clicking to select a Category displayed in the Tab Bar will switch to that category's content and focus will be switched to the first Focusable Item in that view.
  • Число категорий, отображаемых на панели вкладок должна быть устранена и все категории должны быть доступны постоянно, данной категории никогда не должны быть отключены.The number of Categories displayed in the Tab Bar should be fixed and all Categories should be accessible at all times, a given Category should never be disabled.
  • Панели вкладки Настройка не поддерживается в tvOS.Tab Bars do not support customization on tvOS. Кроме того, они больше не показывать дополнительные категории (например iOS) при наличии нескольких категорий, чем может поместиться на панели вкладок.Additionally, they do not show the More Category (like iOS) if there are more Categories than can fit in the Tab Bar.

Apple имеет следующие рекомендации по работе с панели вкладки:Apple has the following suggestions for working with Tab Bars:

  • Используйте вкладку панели, чтобы логически организовать содержимое -позволяет логически организовать содержимое, которое работает приложение tvOS с панели вкладок.Use Tab Bars to Logically Organize Content - Use the Tab Bar to logically organize the content that your tvOS app works with. Например, основные верхней графики, приобретенные и поиска.For example, Featured, Top Charts, Purchased and Search.
  • Добавление эмблемы для информирования пользователей новое содержимое -при необходимости можно вывести эмблему (красный Овал с белым числа или восклицательным знаком) для информирования пользователей новое содержимое в категории.Add Badges to Inform Users of New Content - You can optionally display a Badge (a red oval with a white number or exclamation point) to inform the user of new content in a Category.
  • Значки как можно реже используйте — не загромождать панель вкладок с помощью эмблемы и вывести их где они предоставляют критически важные сведения для пользователя.Use Badges Sparingly - Don't clutter the Tab Bar with Badges and only display them where they provide critical information to the user.
  • Ограничить число категорий — для уменьшения сложности и держать вас в приложение управляемое, не перегружать вашей панель вкладок с категориями и убедитесь, что все категории доступны и не в матричном.Limit the Number of Categories - To reduce complexity and keep you app manageable, don't overload your Tab Bar with Categories and ensure that all of the Categories are visible and not crowded. Простой и короткий названия лучше всего работают.Simple, short titles work best.
  • Не отключайте категорию -все вкладки (категории) всегда должны быть видимы и включены постоянно.Don't Disable a Category - All Tabs (Categories) should always be visible and enabled at all times. Если ничего не содержит заданной вкладки, предоставляются пользователю почему.If a given Tab has no content, provide an explanation to the user why. Например вкладку покупки будет пустым, если пользователь внес не покупки.For example, the Purchases Tab will be empty if the user has made no purchases.

Вкладка панели элементовTab Bar Items

Представленный элемент вкладки панели каждой категории (вкладка) в панели вкладок (UITabBarItem).Each Category (Tab) in the Tab Bar is represented by a Tab Bar Item (UITabBarItem). Apple имеет следующие рекомендации по работе с вкладки панели элементов:Apple has the following suggestions for working with Tab Bar Items:

  • Используйте вкладки на основе текста -Хотя элемент Панель вкладки могут быть представлены в виде значка, Apple предлагает использовать текст, только потому, что легче интерпретировать, чем значок краткий заголовок.Use Text Based Tabs - While the Tab Bar Item is able to be represented as an icon, Apple suggests using text only because a concise title is easier to interpret than an icon.
  • Использовать Short, значимые существительные или глаголы -элемент панели вкладки должны четко ретрансляции содержимое, которое его содержит и лучше всего работает при простой существительное (например, фотографии, видео или музыки) или команд (например, поиска или воспроизведение).Use Short, Meaningful Nouns or Verbs - A Tab Bar Item should clearly relay the content that it contains and works best when it is a simple noun (such as Photos, Movies or Music) or verbs (such as Search or Play).

Панели вкладки и раскадровкиTab Bars and Storyboards

Для работы с панели вкладки в приложении Xamarin.tvOS проще всего добавить их в пользовательском Интерфейсе приложения с помощью конструктора iOS.The easiest way to work with Tab Bars in a Xamarin.tvOS app is to add them to the app's UI using the iOS Designer.

  1. Запуск нового приложения Xamarin.tvOS и выберите tvOS > приложения > приложения с вкладками:Start a new Xamarin.tvOS app and select tvOS > App > Tabbed App:

  2. Ответьте на все экране, чтобы создать новое решение Xamarin.tvOS.Follow all of the prompts to create a new Xamarin.tvOS Solution.

  3. В панели решения, дважды щелкните Main.storyboard и откройте его для редактирования.In the Solution Pad, double-click the Main.storyboard file and open it for editing.

  4. Чтобы изменить значок или Title для данной категории, выберите элемент вкладки панели для контроллер представления в Структура документа:To change the Icon or Title for a given Category, select the Tab Bar Item for the View Controller in the Document Outline:

  5. Затем укажите необходимые свойства вкладку графического из обозревателе свойств:Then set the required properties in the Widget Tab of the Properties Explorer:

  6. Чтобы добавить новую категорию (вкладку), перетащите контроллер представления в область конструктора:To add a new Category (Tab), drop a View Controller onto your design surface:

  7. Щелкните и перетащите из вкладку View Controller к новому контроллер представления.Control-click and drag from the Tab View Controller to the new View Controller.

  8. В контекстном меню выберите Просмотр контроллеров Чтобы добавить новое представление в виде вкладки (категория):From the popup, select view controllers to add the new view as a Tab (Category):

  9. Разработка макета пользовательского интерфейса для каждой области Caterogies в обычном режиме, добавив элементы пользовательского интерфейса в конструкторе iOS.Design the layout of the UI for each Caterogies content area as normal, by adding UI elements in the iOS Designer.

  10. Выдает никаких событий, необходимые для работы с элементами управления пользовательского интерфейса в C# кода.Expose any required events to work with your UI controls in C# code.

  11. Назовите элементами управления интерфейса, которые вы хотите предоставить в C# кода.Name any UI controls that you want to expose in C# code.

  12. Сохраните изменения.Save your changes.

Важно!

Хотя можно назначить события, такие как TouchUpInside элемента пользовательского интерфейса (такие как UIButton) в конструкторе iOS, он никогда не вызывается так, как Apple TV нет на сенсорном экране или поддерживает события касания.While it is possible to assign events such as TouchUpInside to a UI element (such as a UIButton) in the iOS Designer, it will never be called because Apple TV doesn't have a touch screen or support touch events. Следует всегда использовать Primary Action событие при создании обработчиков событий для tvOS элементы пользовательского интерфейса.You should always use the Primary Action event when creating event handlers for tvOS user interface elements.

Дополнительные сведения о работе с раскадровками, см. в разделе наших по Tvos краткое руководство по.For more information on working with Storyboards, please see our Hello, tvOS Quick Start Guide.

Работа с панели вкладкиWorking with Tab Bars

Используйте Items свойство UITabBar для доступа к коллекции UITabBarItems он содержит как ноль (0) индексированного массива.Use the Items property of the UITabBar to access the collection of UITabBarItems it contains as a zero (0) indexed array. SelectedItem Свойство будет возвращать текущую выбранную вкладку (категория) как UITabBarItem.The SelectedItem property will return the currently selected Tab (Category) as a UITabBarItem.

Работа с элементами панели вкладкиWorking with Tab Bar Items

Чтобы отобразить значок на заданной вкладке (красный Овал с белым текстом), используйте следующий код:To display a Badge on a given tab (a red oval with white text), use the following code:

// Display a badge
TabBar.Items [2].BadgeValue = "10";

Который даст нам следующие результаты при запуске:Which would produce the following results when run:

Используйте Title свойство UITabBarItem изменение заголовка и Image свойство, чтобы изменить значок.Use the Title property of the UITabBarItem to change the title and the Image property to change the icon.

СводкаSummary

В этой статье подробно рассматривается проектирование и работать с контроллер панели вкладок внутри приложения Xamarin.tvOS.This article has covered designing and working with Tab Bar Controller inside of a Xamarin.tvOS app.