espacio asignado previamente para marcadores de posición de extensión de SharePoint Framework

Los personalizadores de aplicaciones se pueden usar para agregar estructuras y contenido en las páginas modernas. Esto se puede lograr mediante el uso de marcadores de posición específicos en la página, a los que se cargará la extensibilidad personalizada. Como las extensiones se cargarán bastante tarde en el ciclo de vida de carga de la página, puede haber un movimiento de página adicional cuando se agreguen las extensiones.

Nota:

Esta característica solo se admite en SharePoint Online.

Para reducir el movimiento de página, puede asignar previamente el área de extensión ya en el lado servidor cuando se crea la estructura de página. Esta configuración se puede aplicar mediante la nueva HostProperties propiedad de la UserCustomAction colección para indicar en el lado servidor qué personalizadores de aplicaciones se cargan en la página.

Hay dos propiedades específicas diferentes, que se pueden usar con la HostProperties configuración:

• preAllocatedApplicationCustomizerTopHeight: alto asignado previamente para el marcador de posición superior
• preAllocatedApplicationCustomizerBottomHeight: alto asignado previamente para el marcador de posición inferior

El alto se define en píxeles.

Definición de la asignación de HostProperties en SharePoint Framework solución

Puede definir la asignación previa del lado servidor directamente en el código de solución SharePoint Framework, lo que garantiza que la asignación previa se aplica cuando se usa la solución. La asignación previa se puede definir en el elements.xml o en los archivos ClientSideInstance.xml , en función del diseño de la solución.

El valor de las propiedades de host debe codificarse correctamente en los archivos xml para asegurarse de que el empaquetado de la solución se realizará correctamente.

Definición de la asignación previa en la implementación con ámbito de sitio

Si la extensión está diseñada para instalarse en un ámbito de sitio, puede configurar la asignación previa mediante el archivo ./sharepoint/assets/elements.xml . La configuración incluida en este archivo se aplica de forma predeterminada al sitio, cuando se instala SharePoint Framework solución en un ámbito de sitio.

El siguiente fragmento xml se ha actualizado con la entrada adicional HostProperties y ha definido el alto predeterminado en 50 píxeles.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <CustomAction
      Title="HeaderDemo"
      Location="ClientSideExtension.ApplicationCustomizer"
      ClientSideComponentId="03dd08c7-2575-4336-899e-68cfce663c4d"
      ClientSideComponentProperties="{&quot;testMessage&quot;:&quot;Test message&quot;}"
      HostProperties="{&quot;preAllocatedApplicationCustomizerTopHeight&quot;:&quot;50&quot;,&quot;preAllocatedApplicationCustomizerBottomHeight&quot;:&quot;50&quot;}">
  </CustomAction>
</Elements>

Definición de la asignación previa mediante la opción de implementación en todo el inquilino

Las extensiones destinadas a activarse mediante las opciones de implementación de todo el inquilino se pueden configurar para usar el espacio asignado previamente agregando HostProperties la propiedad para el ClientSideComponentInstance elemento en el archivo ./sharepoint/assets/ClientSideInstance.xml .

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <ClientSideComponentInstance
      Title="HeaderDemo"
      Location="ClientSideExtension.ApplicationCustomizer"
      ComponentId="03dd08c7-2575-4336-899e-68cfce663c4d"
      Properties="{&quot;testMessage&quot;:&quot;Test message&quot;}"
      HostProperties="{&quot;preAllocatedApplicationCustomizerTopHeight&quot;:&quot;50&quot;,&quot;preAllocatedApplicationCustomizerBottomHeight&quot;:&quot;50&quot;}">
  </ClientSideComponentInstance>
</Elements>

HostProperties la entrada de esta configuración se agregará a la entrada de lista Extensiones de espacio empresarial en la colección de sitios del catálogo de aplicaciones, que tiene una columna Propiedades de host para cada elemento.

Consideraciones

Hay algunas consideraciones que debe tener en cuenta, en función de la implementación:

• Cuando la altura especificada es demasiado, el div tendrá espacio adicional en la posición designada. Si el alto es menor que los personalizadores de la aplicación, los personalizadores de la aplicación se comprimirán en el marcador de posición.
• Si ha definido una asignación previa, pero el personalizador de la aplicación no crea un marcador de posición en el código o no está asociado en la página, el espacio asignado del lado servidor permanecerá en la página.

Nota:

HostProperties también se puede definir para los personalizadores de aplicaciones existentes modificando el objeto CustomAction de nivel de sitio o mediante la columna Propiedades del host de la lista Extensiones de espacio empresarial en el sitio del catálogo de aplicaciones. Como se trata de una configuración del lado servidor, también se puede aplicar a las extensiones que se han creado con versiones anteriores SharePoint Framework.