Рекомендации по проектированию компонентов цикла

Microsoft Loop компоненты являются динамическими, практическими единицами производительности, которые синхронизируются и свободно перемещаются между приложениями Microsoft 365. Она включает в себя возможность создания компонентов цикла путем изменения существующей адаптивной карточки в компонент цикла или создания нового компонента цикла на основе адаптивных карточек.

Функции ключевых компонентов цикла

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

Внедренные. Адаптивные карточки внедрены, поэтому от вас ничего конкретного не требуется.

Действовать: компоненты цикла позволяют пользователю выполнять действия по завершению потока внутри самого компонента; помимо простого просмотра информации или открытия браузера. Если адаптивная карточка является интерфейсом только для просмотра, найдите возможности, чтобы сделать ее практической, так как это основной карта элемент, чтобы порадовать пользователей. Убедитесь, что адаптивная карточка с интерфейсом только для просмотра не изменяется на компонент цикла. В этом случае она должна оставаться только адаптивной карточкой.

Примечание.

Некоторые разрешения пользователя или режимы компонента могут быть недоступны, но распространенные случаи должны быть практическими.

Вы можете сделать адаптивную карточку применимой, включив в нее любое из следующих действий:

• Утверждение отчета о расходах
• Добавить комментарий
• Обновление даты
• Обновление цены, например сумма в долларах
• Изменение назначения или значения состояния
• Добавление или обновление данных

Переносимая. Добавление атрибута URL-адреса в соответствии с требованиями в руководстве разработчика гарантирует, что компонент можно будет копировать в реальном времени в любом месте, где поддерживается компонент цикла на основе адаптивной карточки.

Property	Функция
Жить	Последние сведения заполняются в карта. При наличии нескольких экземпляров они остаются синхронизированными по мере внесения обновлений.
Embedded	Карточки можно помещать в документы и беседы, которые отделены от остального содержимого.
Действия	Задачи можно выполнять в встроенном коде.
Портативный	Компоненты могут работать в приложении Microsoft 365, которое поддерживает компоненты цикла.

Элементы компонента цикла

Компонент цикла на основе адаптивной карточки состоит из текста, заголовка и границы.

Элемент компонента цикла	Предоставляется разработчиком	Платформа предоставляет
Основной текст	Содержимое, полностью контролируемое вами	Отрисовка и стилизация элементов управления на основе кода.
Header	Значок и имя	Элементы и макет являются стандартными и предоставляются платформой
Border	Н/Д	Стандартная граница для всех компонентов цикла.

Текст компонента цикла

Текст компонента Цикла делает компонент уникальным. Вы можете предоставить пользователям положительный опыт и увеличить использование и хранение, создав компонент, который воплощает атрибуты компонента цикла и обеспечивает ценность для клиентов.

Сведения о тексте компонента определяются спецификой потребностей и сценариев пользователей.

Ниже приведены рекомендации по тексту компонента цикла.

• Перейдите на главную страницу адаптивных карточек и ознакомьтесь со статьей Обзор адаптивных карточек , чтобы понять основы и основные принципы проектирования адаптивных карточек.
• Следуйте рекомендациям по проектированию адаптивных карточек, которые включают инструменты, примеры, заметки о адаптивном дизайне и плотности пикселей.
• В следующем списке приведены рекомендации по компоненту Цикла.
  • Убедитесь, что компонент соответствует атрибутам компонентов цикла, таким как динамический, интерактивный, внедренный и переносимый.
  • Не добавляйте отдельную кнопку для открытия в браузере.
  • Не добавляйте повторяющийся заголовок или границу.

Не добавляйте отдельную кнопку для открытия в браузере

Заголовок компонента Цикла предоставляет стандартный способ открыть браузерное представление компонента на основе ВАШЕГО URL-адреса. Таким образом, нет необходимости добавлять отдельную кнопку в компонент для таких действий, как Просмотр сведений или Открыть в Интернете.

Вы можете добавить кнопки или ссылки для более конкретных представлений, например Для просмотра связанных элементов. По возможности предоставьте необходимые сведения и взаимодействие в карта.

Не добавляйте повторяющийся заголовок или границу

Все компоненты цикла имеют стандартный заголовок и границу. Убедитесь, что код адаптивной карточки не должен дублировать заголовок и границу. У вас может быть заголовок элемента для компонента, но убедитесь, что имя и значок приложения не совпадают.

Заголовок компонента цикла

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

Счетчик	Описание
1	Логотип приложения: полноцветный логотип вашего приложения.
2	Имя приложения: полное имя приложения.
3	Общие расположения (элемент управления циклом)
4	Компонент копирования

Имя приложения извлекается из контракта компонента. Рекомендуется использовать краткое имя приложения.

Логотип приложения рисуется из контракта компонента. Убедитесь, что предоставленный логотип работает как на светлом, так и на темном фоне, так как один и тот же ресурс используется для светлых, темных и высококонтрастных тем в Microsoft Teams.

Граница компонента цикла

Граница компонента отделяет компонент от содержимого вокруг него. Это помогает пользователям понять, что компонент Цикла является динамическим и отделен от содержимого, окружающего его, например электронной почты или чата.

Граница отображается автоматически.

Следующее действие

Компоненты цикла на основе адаптивных карточек