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

Breadcrumb контроль

  • Стаття

Елемент керування, що використовується для надання можливості переходів.

Нотатка

Повна документація та вихідний код із репозиторію компонентів коду GitHub.

Контроль хлібних крихт.

Опис

Breadcrumb Елементи керування мають використовуватися як допоміжний засіб для навігації у вашому додатку або на сайті. Вони вказують на місцезнаходження поточної сторінки в ієрархії і допомагають користувачу зрозуміти, де вони знаходяться по відношенню до решти цієї ієрархії. Навігаційна ланка також забезпечує доступ одним клацанням до вищих рівнів цієї ієрархії

Цей компонент коду забезпечує обгортку елемента керування Fluent UI Breadcrumb для використання в компонованих програмах і на користувацьких сторінках.

Властивості

Ключові властивості

Властивість Опис
SelectedKey Це позначає вибраний ключ. Ця дія буде оновлено через подію OnChange під час взаємодії користувача з елементом керування.
Items Елементи дії для відображення

Items Властивості

Кожен елемент використовує наведену нижче схему, щоб візуалізувати дані в компоненті.

Ім'я Опис
ItemDisplayName Коротке ім’я елемента навігації
ItemKey Ключ, який використовується для позначення вибраного елемента і під час додавання вкладених елементів. Ключі мають бути унікальними.
ItemClickable Установіть значення false, якщо певний елемент посилання не має натискати клавішу.

Приклад формули Power Fx

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

Властивості стилю

Ім'я Опис
Theme Приймає рядок JSON, створений за допомогою конструктора тем Fluent UI (windows.net). Якщо залишити це значення пустим, використовуватиметься тема, визначена Power Apps. Див. використання тем, щоб отримати вказівки щодо налаштування.
AccessibilityLabel Підпис aria-label для невізуальних екранів
MaxDisplayedItems Максимальна кількість елементів навігації для відображення перед об'єднанням. Якщо значення пусте, буде відтворено всі елементи навігації.
OverflowIndex Необов’язковий покажчик, в якому буде згорнуто переповнені елементи. За замовчуванням установлено значення «нуль».

Властивості події

Ім'я Опис
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 можливо прив'язати до властивості «Вхідна подія».

Обмеження

Цей компонент коду можна використовувати лише в компонованих програмах і настроюваних сторінках.