Поделиться через

Breadcrumb контроль

  • Статья

Элемент управления, используемый для обеспечения навигации.

Заметка

Полная документация и исходный код находятся в разделе Репозиторий компонентов кода на GitHub.

Элемент управления Breadcrumb.

Description

Breadcrumb Элементы управления следует использовать в качестве средства навигации в вашем приложении или на сайте. Они указывают положение текущей страницы в иерархии и помогают пользователю понять, где он находится по отношению к этой иерархии. Навигационная цепочка также обеспечивает доступ одним щелчком мыши к более высоким уровням этой иерархии.

Этот компонент кода обеспечивает оболочку вокруг элемента управления Fluent UI Breadcrumb для использования в приложениях на основе холста и на пользовательских страницах.

Свойства

Ключевые свойства

Свойство Description
SelectedKey Это обозначает выбранный ключ. Это будет обновляться через событие OnChange, когда пользователь взаимодействует с элементом управления.
Items Элементы действия для визуализации

Items характеристики

Каждый элемент использует приведенную далее схему для визуализации данных в компоненте.

Имя. Description
ItemDisplayName Отображаемое имя пункта навигационной цепочки
ItemKey Клавиша, которая используется для указания того, какой элемент выбран, и при добавлении подэлементов. Клавиши должны быть уникальными.
ItemClickable Установите значение false, если конкретный элемент навигационной цепочки не может быть выбран.

Пример формулы Power Fx:

Table(
    {
        ItemKey: "1",
        ItemDisplayName: "General",
        ItemClickable: true
    },
    {
        ItemKey: "2",
        ItemDisplayName: "Document",
        ItemClickable: true
    }
)

Свойства стиля

Имя. Description
Theme Принимает строку JSON, сгенерированную с помощью Конструктора тем Fluent UI (windows.net). Если оставить это поле пустым, будет использоваться тема по умолчанию, определенная Power Apps. Сведения о порядке настройки см. в разделе темы.
AccessibilityLabel Подпись Aria для программы чтения с экрана
MaxDisplayedItems Максимальное число навигационных цепочек для отображения перед объединением. Если ноль, то будут отображаться все навигационные цепочки.
OverflowIndex Необязательный индекс, в котором будут свернуты элементы переполнения. По умолчанию установлено нулевое значение.

Свойства событий

Имя. Description
InputEvent Событие, которое требуется отправить элементу управления. Например, SetFocus. См. ниже.

Поведение

Поддерживает SetFocus как InputEvent.

Настройка поведения «При выборе»

Используйте формулу Switch() в свойстве OnSelect компонента, чтобы настроить определенные действия для каждого элемента, ссылаясь на выбранный ключ ItemKey элемента управления в качестве значения переключателя.

Замените значения false на соответствующие выражения на языке Power Fx.

Поскольку этот элемент управления используется для навигации, логичным действием будет использование функций навигации (в идеале — перехода на соответствующий экран с загруженными соответствующими данными).

  Switch( Self.Selected.ItemKey,
    /* Action for ItemKey 1 */
    "1", false,
    
    /* Action for ItemKey 2 */
    "2", false,
  
    /* Default action */
        false
  )

Настройка фокуса на элементе управления

Когда отображается новое диалоговое окно, а фокус по умолчанию должен быть на элементе управления, потребуется явная установка фокуса.

Чтобы совершать вызовы входного события, вы можете установить переменную контекста, связанную со свойством входного события, в строку, начинающуюся с SetFocus, за которым следует случайный элемент, чтобы приложение распознало его как изменение.

Пример формулы Power Fx:

UpdateContext({ ctxResizableTextareaEvent:"SetFocus" & Text(Rand()) }));

Контекстная переменная ctxResizableTextareaEvent затем может быть привязана к свойству Input Event.

Ограничения

Этот компонент кода можно использовать только в приложениях на основе холста и настраиваемых страницах.