Descripción general de la personalización de JavaScript
Si usted está acostumbrado a manipular el DOM (especialmente con jQuery) para realizar sus personalizaciones, las cosas funcionarán de manera diferente en el sitio web de CONTENTdm basado en React. Las personalizaciones de JavaScript que usted agregue deberán suscribirse a un evento específico del ciclo de vida, o escucharlo, y se activarán a medida que esos eventos ocurran durante el ciclo de vida de la aplicación. El código de personalización no interactuará directamente con la aplicación React de CONTENTdm ni la manipulará, sino que será activado por el ciclo de vida de eventos establecido y controlado por la aplicación React. Estos eventos permiten que su código interactúe con el DOM a medida que el usuario entra o sale de una página determinada de CONTENTdm.
La razón por la que elegimos usar React para construir el sitio web de CONTENTdm es que la velocidad de carga de la página es excelente, ya que los renderizados de la página están preconstruidos y las partes de la página se cargan o actualizan solo cuando son necesarias. El JavaScript personalizado añadido a un sitio de CONTENTdm no obtendrá todos estos beneficios, ya que el código no está estrechamente integrado en la aplicación React, pero usted puede optimizar la ejecución adhiriéndose al ciclo de vida del evento y al contexto de la página.
Si su código personalizado interactúa correctamente con el ciclo de vida de la página, sus personalizaciones pueden ejecutarse solo cuando sean necesarias durante el inicio, la representación, la actualización o la salida de la página. La clave para que esto funcione es que su código se suscriba al evento de aplicación adecuado.
Si sus personalizaciones tienen la intención de manipular el DOM creado por CONTENTdm, tenga en cuenta que ese enfoque puede entrar en conflicto con la manera en que la aplicación React necesita utilizar y modificar el DOM. Si la aplicación CONTENTdm no puede encontrar lo que espera en el DOM, la aplicación puede fallar y se perderá la sesión del usuario final. Sin embargo, si su código personalizado está creando sus propios elementos y los modifica o elimina, no debería haber problemas en el lado de React.
Si está acostumbrado a trabajar con jQuery, tenga en cuenta que se basa en una gran cantidad de manipulación directa del DOM y abstrae parte de esta manipulación, por lo que no siempre es evidente cuándo está ocurriendo. Es posible utilizar jQuery dentro de la aplicación React de CONTENTdm, pero tenga cuidado con el alcance de esos cambios en el DOM. En general, su código no debería usar jQuery para eliminar o cambiar elementos en el DOM si esos elementos fueron creados por la aplicación React de CONTENTdm. Por otro lado, si su código jQuery está creando sus propios elementos y los modifica o elimina, debería ser seguro.
El sitio web de CONTENTdm no utiliza jQuery, por lo que no está disponible en el HTML predeterminado. Si desea utilizar jQuery en sus personalizaciones, su código personalizado deberá vincularse a jQuery y cargarlo en el momento adecuado del ciclo de vida. Es probable que su sitio web y sus personalizaciones funcionen mejor si puede evitar usar jQuery.
Ver una grabación: Consulte a los expertos: Creación de una receta personalizada de JavaScript para CONTENTdm. Se requiere acceso al OCLC Community Center. Consulte Inicie sesión en el OCLC Community Center (en anglais) para obtener más información. Véase también la capacitación de CONTENTdm para ver videos de capacitación relacionados.