Enlaza una función del componente de secuencia de comandos a un mensaje de notificación enviado por el host.

Comportamiento.attachNotification (fpNotificar)

Argumentos

Comportamiento

El Id. del elemento <implements> que se utiliza para implementar la interfaz de comportamiento.

Nota   De forma predeterminada, las propiedades y métodos que expone el controlador de comportamiento se agregan automáticamente al espacio de nombres global de la secuencia de comandos y se puede tener acceso a ellos sin hacer referencia al Id. del controlador de comportamiento. En este caso, en vez de utilizar Comportamiento.attachNotification como se muestra en la sintaxis, en la secuencia de comandos se puede utilizar el método como attachNotification. Para obtener más información, consulte el elemento <implements>.

fpNotificar

El nombre de la función que se enlazará a la notificación.

Observaciones

Actualmente, el host puede llamar a la función especificada con las notificaciones siguientes:

• "contentReady"   Ha habido un cambio en el contenido del elemento al que se ha adjuntado el componente de secuencia de comandos de comportamiento. Éste se activa tan pronto como se analiza la etiqueta de cierre del elemento, así como cuando una secuencia de comandos establece la propiedad innerHTML de DHTML del elemento. Los componentes de secuencia de comandos de comportamiento pueden utilizar esta notificación para recuperar el contenido del elemento al que se ha aplicado.
• "documentReady"   El explorador ha terminado de analizar el documento. Las modificaciones o inicializaciones que sean necesarias realizar al contenido se pueden efectuar en este punto.

  Nota   El método attachNotification no notifica al componente de secuencia de comandos los eventos estándar que se produzcan en el documento, ventana o cualquier elemento de la página. La forma recomendada de recibir notificaciones de este tipo de evento es mediante el método achEvent de DHTML.

Al tratar los cambios de la propiedad style de DHTML de un elemento, como la configuración de su visibilidad, el cambio de colores o fuentes, se recomienda que los cambios se realicen dentro del elemento <script> del componente de secuencia de comandos, como se muestra en el fragmento siguiente. Si se realiza el cambio en la cláusula de notificación documentReady, puede aparecer un ligero parpadeo.

Nota   Es necesario incluir una sección CDATA para hacer opaca la secuencia de comandos del elemento <script>. Para obtener más información, consulte Archivos de componentes de secuencia de comandos y compatibilidad XML.

<implements type="Behavior"/>
<script language="JScript">
<![CDATA[
   style.color = "green";
   style.letterSpacing = 5;
]]>
</script>

Ejemplo

El ejemplo siguiente muestra cómo se puede configurar una función para interceptar notificaciones y procesarlas de forma adecuada.

Nota   Es necesario incluir una sección CDATA para hacer opaca la secuencia de comandos del elemento <script>. Para obtener más información, consulte Archivos de componentes de secuencia de comandos y compatibilidad XML.

<?XML version="1.0"?>
<component>
<implements type="Behavior">
   <event name="onResultChange"/>
</implements>

<script language="JScript">
<![CDATA[
   attachNotification (onNotification);
   function onNotification (sNotification){
      if (sNotification == "contentReady"){
         // Ha cambiado el contenido del elemento.
      }
      else if (sNotification == "documentReady"){
         // El host ha terminado de analizar el documento.
      }
      window.status = sNotification;
   }
]]>
</script>
</component>

Consulte también

Elemento <event>