IWebPartData interface
Эта структура представляет собой сериализованное состояние веб-части.
Комментарии
При вызове serialize()
API в веб-части выходными данными должна быть эта структура. Структура поля properties относится к веб-части. Каждая веб-часть может выбрать набор свойств, которые она хочет сериализовать.
Свойства
data |
Версия данных веб-части |
description | Описание веб-части |
dynamic |
Пути для динамических данных. |
dynamic |
Статические значения для динамических данных. Он используется для восстановления динамических объектов данных при десериализации веб-части. |
id | Универсальный уникальный идентификатор типа веб-части. |
instance |
Универсальный уникальный идентификатор экземпляра веб-части. Веб-часть может содержать несколько экземпляров на странице. Ожидается, что этот идентификатор будет универсальным по времени и границам страниц. |
properties | Свойства веб-части. Определение этих свойств принадлежит отдельной веб-части. |
server |
Коллекции данных, которые могут обрабатываться службами на стороне сервера, такими как индекс поиска и исправление ссылок. |
title | Название веб-части |
Сведения о свойстве
dataVersion
Версия данных веб-части
dataVersion: string;
Значение свойства
string
Комментарии
Обратите внимание, что версия данных и поле версии в манифесте — это не одно и то же. Версия манифеста используется для управления версиями кода веб-части, а версия данных — для управления версиями сериализованных данных веб-части. Дополнительные сведения см. в поле dataVersion веб-части.
Поддерживаемые значения: MAJOR. НЕЗНАЧИТЕЛЬНЫЕ
Пример: "1.0"
description
Описание веб-части
description?: string;
Значение свойства
string
Комментарии
Используется для отображения описания веб-части.
Поддерживаемые значения: строка с описанием.
Пример: "Text"
dynamicDataPaths
Примечание
Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.
Пути для динамических данных.
dynamicDataPaths?: {
[path: string]: string;
};
Значение свойства
{ [path: string]: string; }
Комментарии
Он используется для восстановления динамических объектов данных при десериализации веб-части. Ключ — это путь в свойствах веб-части, а значение — внутренний идентификатор динамических данных.
Пример.
{
'pageContextUser':
'PageContext:user',
'anotherWebPartProperty':
'WebPart.c3be45f2-7cd9-4e92-9c6c-a01d24dc04cf.3d6307e4-c8e1-4b2d-bef9-f1689c6eb7ea:aProperty'
}
dynamicDataValues
Примечание
Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.
Статические значения для динамических данных. Он используется для восстановления динамических объектов данных при десериализации веб-части.
dynamicDataValues?: {
[path: string]: any;
};
Значение свойства
{ [path: string]: any; }
Комментарии
Ключ — это путь в свойствах веб-части, а значение — это статическое значение динамических данных.
Пример.
{
'aStringProperty': 'thisIsAString',
'aBooleanProperty': true
}
id
Универсальный уникальный идентификатор типа веб-части.
id: string;
Значение свойства
string
Комментарии
Пример: "dbef608d-3ad5-4f8f-b139-d916f2f0a294"
instanceId
Универсальный уникальный идентификатор экземпляра веб-части. Веб-часть может содержать несколько экземпляров на странице. Ожидается, что этот идентификатор будет универсальным по времени и границам страниц.
instanceId: string;
Значение свойства
string
Комментарии
поддерживаемые значения: уникальная строка. Может быть GUID или другими уникально идентифицируемыми форматами.
Примере: ["dbef608d-3ad5-4f8f-b139-d916f2f0a294"]
properties
Свойства веб-части. Определение этих свойств принадлежит отдельной веб-части.
properties?: any;
Значение свойства
any
Комментарии
Используется веб-частью для управления внутренними метаданными и данными конфигурации. Код платформы никогда не касается этих свойств.
Поддерживаемые значения: любая иерархия объектов, которую можно сериализовать с помощью JSON.stringify()
.
Пример: { 'value': 'text value' }
serverProcessedContent
Коллекции данных, которые могут обрабатываться службами на стороне сервера, такими как индекс поиска и исправление ссылок.
serverProcessedContent?: ISerializedServerProcessedData;
Значение свойства
title
Название веб-части
title: string;
Значение свойства
string
Комментарии
Используется для отображения имени веб-части на панели элементов, в коллекции веб-частей и на странице.
Поддерживаемые значения: строка менее 100 символов
Пример: "Text"