Show Menu
TEMAS×

Descarga de componentes

Información general

La transferencia de componentes de comunidades resulta útil cuando una página web está diseñada como una aplicación de una sola página simple que modifica dinámicamente lo que se muestra en función de lo que seleccione el visitante del sitio.
Esto se logra cuando los componentes de Comunidades no existen en la plantilla de página, sino que se agregan dinámicamente siguiendo la selección de un visitante del sitio.
Dado que el marco de componentes sociales (SCF) tiene una presencia ligera, solo se registran los componentes de SCF que existen en el momento de la carga de página inicial. Para que un componente SCF agregado dinámicamente se registre después de cargar la página, se debe invocar SCF para "transferir" el componente.
Cuando una página está diseñada para transferir componentes de Communities, es posible almacenar en caché toda la página.
Los pasos para agregar componentes SCF dinámicamente son:
  1. Cargue el componente en un sitio mediante uno de los dos métodos siguientes:
No se admite la transferencia de recursos Añadir o incluir un componente de comunidades no existentes.

Añadir dinámicamente un componente a DOM

Tanto si el componente se incluye dinámicamente como si se carga dinámicamente, primero debe agregarse al DOM.
Al agregar el componente SCF, la etiqueta más común que se debe utilizar es la etiqueta DIV, pero también se pueden utilizar otras etiquetas. Dado que SCF solo examina el DOM cuando la página se carga inicialmente, esta adición al DOM pasará desapercibida hasta que se invoque SCF de forma explícita.
Cualquiera que sea la etiqueta que se utilice, como mínimo, el elemento debe cumplir con el patrón de elementos raíz SCF normal al contener estos dos atributos:
  • data-component-id
    Ruta efectiva al componente agregado.
  • data-scf-component
    ResourceType del componente.
A continuación se muestra un ejemplo de un componente de comentarios agregado:
<div
    class="scf-commentsystem scf translation-commentsystem"
    data-component-id="<%= currentPage.getPath()%>/jcr:content/content-left/comments"
    data-scf-component="social/commons/components/hbs/comments"
>
</div>

Carga en el sitio invocando SCF

Inclusión dinámica

La inclusión dinámica utiliza una solicitud de refuerzo que resulta en que SCF examine el DOM y ejecute todos los componentes de SCF que se encuentran en la página.
Para inicializar los componentes SCF en cualquier momento después de cargar la página, simplemente active un evento de JQuery como este:
$(document).trigger(SCF.events.BOOTSTRAP_REQUEST);

Carga dinámica

La carga dinámica proporciona control sobre la carga de componentes SCF.
En lugar de arrancar todos los componentes SCF que se encuentran en el DOM, es posible especificar un componente SCF específico para cargar con este método JavaScript:
SCF.addComponent(document.getElementById(*someId*));
Donde someId es el valor del data-component-id atributo.