Funciones de comportamiento
Las funciones de comportamiento permiten añadir comportamientos a un objeto y retirárselos, descubrir qué comportamientos están unidos a un objeto, obtener información sobre el objeto al que un comportamiento está asociado y así sucesivamente. Los métodos del objeto dreamweaver.behaviorInspector controlan o actúan solo sobre la selección en el panel Comportamientos, no sobre la selección en el documento actual.
dom.addBehavior()
Disponibilidad
Dreamweaver 3.
Descripción
Añade un nuevo par evento/acción al elemento seleccionado. Esta función solo es válida en el documento activo.
Argumentos
evento, acción, {eventBasedIndex}
El argumento del evento es el controlador de eventos de JavaScript que debe asociar el comportamiento al elemento (por ejemplo, onClick, onMouseOver, o onLoad).
El argumento de la acción es la llamada a función que devuelve applyBehavior() si la acción se añade mediante el panel Comportamientos (por ejemplo, "MM_popupMsg('Hola a todos')").
El argumento eventBasedIndex, que es opcional, es la posición en la que debe añadirse esta acción. El argumento eventBasedIndex es un índice basado en cero; si ya están asociadas dos acciones al evento especificado, y se especifica eventBasedIndex como 1, esta acción se ejecuta entre la otras dos. Si se omite este argumento, la acción se añade después de todas las acciones existentes añadidas para el evento especificado.
Valor devuelto
Ninguno.
dom.getBehavior()
Disponibilidad
Dreamweaver 3.
Descripción
Obtiene la acción de la posición especificada en el evento especificado. Esta función actúa sobre la selección actual y solo es válida para el documento activo.
Argumentos
evento, {eventBasedIndex}
El argumento del evento es el controlador de eventos de JavaScript mediante el cual la acción se asocia al elemento (por ejemplo, onClick, onMouseOver, o onLoad).
El argumento eventBasedIndex, que es opcional, es la posición de la acción a tomar. Por ejemplo, si dos acciones están asociadas al evento especificado, 0 es la primera y 1 es la segunda. Si se omite este argumento, la función devuelve todas las acciones para el evento especificado.
Valor devuelto
Una cadena que representa la llamada a la función (por ejemplo, "MM_swapImage('document.Image1','document.Image1','foo.gif','#933292969950')") o un conjunto de cadenas, si se omite eventBasedIndex.
dom.reapplyBehaviors()
Disponibilidad
Dreamweaver 3.
Descripción
Comprobaciones a efectuar para asegurarse de que las funciones que están asociadas a cualquier llamada de comportamiento en el nodo especificado se encuentren en la sección HEAD del documento, y las inserta en el caso de que falten.
Argumentos
elementNode
El argumento elementNode es un nodo de elemento en el documento actual. Si se omite el argumento, Dreamweaver comprueba todos los nodos del documento en búsqueda de llamadas huérfanas de comportamiento.
Valor devuelto
Ninguno.
dom.removeBehavior()
Disponibilidad
Dreamweaver 3.
Descripción
Quita la acción de la posición especificada en el evento especificado. Esta función actúa sobre la selección actual y solo es válida para el documento activo.
Argumentos
evento, {eventBasedIndex}
El argumento del evento es el controlador de eventos mediante el cual la acción se asocia al elemento (por ejemplo, onClick, onMouseOver u onLoad). Si se omite este argumento, se quitan todas las acciones del elemento.
El argumento eventBasedIndex, que es opcional, es la posición de la acción a quitar. Por ejemplo, si dos acciones están asociadas al evento especificado, 0 es la primera y 1 es la segunda. Si se omite este argumento, la función quita todas las acciones para el evento especificado.
Valor devuelto
Ninguno.
dreamweaver.getBehaviorElement()
Disponibilidad
Dreamweaver 2 y actualizada en CS4.
Descripción
Obtiene el objeto DOM que corresponde a la etiqueta a la que se aplica el comportamiento. Esta función solo es aplicable en los archivos de acciones de comportamiento.
Argumentos
Ninguno.
Valor devuelto
Un objeto DOM o un valor null. Esta función devuelve un valor null en las circunstancias siguientes:
Cuando el script actual no se está ejecutando en el contexto del panel Comportamientos
Cuando dreamweaver.popupAction()inicia el script que se está ejecutando actualmente
Cuando el panel Comportamientos está adjuntando un evento a una envolvente de vínculo, pero esta última aun no existe
Cuando esta función aparece fuera de un archivo de acciones
Ejemplo
La función dreamweaver.getBehaviorElement() se puede utilizar de la misma forma que dreamweaver.getBehaviorTag(), para determinar si la acción seleccionada es adecuada para la etiqueta HTML seleccionada. La diferencia es que permite acceder a más información sobre la etiqueta y sus atributos. Si escribe una acción que se puede aplicar únicamente a un vínculo de hipertexto (A HREF) que no apunte a otro marco o ventana, puede usar la función getBehaviorElement(). Puede utilizar la función getBehaviorElement() como parte de la función que inicializa la interfaz de usuario para el cuadro de diálogo Parámetros. Esto se muestra en el siguiente ejemplo:
function initializeUI(){
var theTag = dreamweaver.getBehaviorElement();
var CANBEAPPLIED = (theTag.tagName == "A" && ¬
theTag.getAttribute("HREF") != null && ¬
theTag.getAttribute("TARGET") == null);
if (CANBEAPPLIED) {
// display the action user interface
} else{
// display a helpful message that tells the user
// that this action can only be applied to a
// link without an explicit target]
}
}
dreamweaver.getBehaviorTag()
Disponibilidad
Dreamweaver 1.2.
Descripción
Obtiene el origen de la etiqueta a la que se aplica el comportamiento. Esta función solo es aplicable en los archivos de acciones.
Argumentos
Ninguno.
Valor devuelto
Una cadena que representa el origen de la etiqueta. Esta es la misma cadena que pasa como argumento (HTMLelement) a la función canAcceptBehavior(). Si esta función aparece fuera de un archivo de acciones, el valor devuelto es una cadena vacía.
Ejemplo
Si escribe una acción que se puede aplicar únicamente a un vínculo de hipertexto (A HREF), puede utilizar la función getBehaviorTag(), como se muestra en el siguiente ejemplo, en la función que inicializa la interfaz de usuario del cuadro de diálogo Parámetros:
function initializeUI(){
var theTag = dreamweaver.getBehaviorTag().toUpperCase();
var CANBEAPPLIED = (theTag.indexOf('HREF') != -1));
if (CANBEAPPLIED) {
// display the action UI
} else{
// display a helpful message that tells the user
// that this action can only be applied to a
// hyperlink
}
}
dreamweaver.popupAction()
Disponibilidad
Dreamweaver 2 y actualizada en CS4.
Descripción
Inicia un cuadro de diálogo de Parámetros para la acción de comportamiento especificada. Para el usuario, el efecto es el mismo que seleccionar la acción en el menú emergente Acciones, en el panel Comportamientos. Esta función permite que los archivos de extensión que no sean acciones adjunten comportamientos a objetos en el documento del usuario. Bloquea otras ediciones hasta que el usuario cierre el cuadro de diálogo.
Es posible llamar a esta función dentro de la función objectTag(), en cualquier script de un archivo de comandos o en el archivo del inspector de propiedades.
Argumentos
actionName, {funcCall}
El argumento de actionName es una cadena que contiene el nombre de un archivo de la carpeta Comportamientos/Acciones. El archivo contiene una acción de comportamiento de JavaScript (por ejemplo, “Swap Image.htm”).
El argumento de funcCall, que es opcional, es una cadena que contiene una llamada a función para la acción especificada en actionName; por ejemplo, “MM_SwapImage(...)”. La función applyBehavior() del archivo de acciones suministra este argumento, si se especifica.
Valor devuelto
La llamada a la función para la acción de comportamiento. Cuando el usuario hace clic en OK en el cuadro de diálogo parámetros, el comportamiento se añade al documento actual. Las funciones adecuadas se añaden a la sección HEAD del documento. El HTML se añade en la parte superior de la sección BODY y pueden realizarse otras ediciones del documento. La llamada a la función (por ejemplo, “MM_SwapImage(...)”) no se añade al documento, pero pasa a ser el valor devuelto por esta función.
dreamweaver.behaviorInspector.getBehaviorAt()
Disponibilidad
Dreamweaver 3.
Descripción
Obtiene los pares evento/acción en la posición especificada en el panel Comportamientos.
Argumentos
positionIndex
El argumento positionIndex corresponde a la posición de la acción en el panel Comportamientos. La primera acción de la lista está en la posición 0.
Valor devuelto
Una matriz de dos elementos:
Un controlador de evento
Una llamada a función o sentencia de JavaScript
Ejemplo
Dado que positionIndex es un índice basado en cero, si el panel Comportamientos visualiza la lista, una llamada a la función dreamweaver.behaviorInspector.getBehaviorAt(2) devuelve una matriz que contiene dos cadenas: "onMouseOver" y "MM_changeProp('document.moon','document.moon','src','sun.gif','MG')".
dreamweaver.behaviorInspector.getBehaviorCount()
Disponibilidad
Dreamweaver 3.
Descripción
Cuenta el número de acciones asociadas al elemento seleccionado actualmente mediante controladores de eventos.
Argumentos
Ninguno.
Valor devuelto
Un entero que representa el número de acciones asociadas al elemento. Este número es equivalente al número de acciones visibles en el panel Comportamientos e incluye acciones de comportamiento de Dreamweaver y JavaScript personalizado.
Ejemplo
Una llamada a dreamweaver.behaviorInspector.getBehaviorCount() para el vínculo seleccionado <A HREF="javascript:setCookie()" onClick="MM_popupMsg('Se ha colocado una cookie.');parent.rightframe.location.href='aftercookie.html'"> devuelve 2.
dreamweaver.behaviorInspector.getSelectedBehavior()
Disponibilidad
Dreamweaver 3.
Descripción
Obtiene la posición de la acción seleccionada en el panel Comportamientos.
Argumentos
Ninguno.
Valor devuelto
Un entero que representa la posición de la acción seleccionada en el panel Comportamientos, o -1 si no se ha seleccionado ninguna acción.
Ejemplo
Si se selecciona la primera acción del panel Comportamientos, las llamadas a la función dreamweaver.behaviorInspector.getSelectedBehavior() devuelven 0.
dreamweaver.behaviorInspector.moveBehaviorDown()
Disponibilidad
Dreamweaver 3.
Descripción
Mueve una acción de comportamiento a un punto posterior de la secuencia para cambiar su orden de ejecución en el ámbito de un evento.
Argumentos
positionIndex
El argumento positionIndex corresponde a la posición de la acción en el panel Comportamientos. La primera acción de la lista está en la posición 0.
Valor devuelto
Ninguno.
Ejemplo
La llamada a la función dreamweaver.behaviorInspector.moveBehaviorDown(2) permuta las posiciones de las acciones de Cargar imágenes previamente y Cambiar propiedad en el evento onMouseDown. La llamada a la función dreamweaver.behaviorInspector.moveBehaviorDown() para cualquier otra posición no tiene ningún efecto, ya que los eventos onclick y onFocus tienen cada uno de ellos solo un comportamiento asociado, y el comportamiento de la posición 3 ya se encuentra en la parte inferior del grupo del eventos onMouseDown.
dreamweaver.behaviorInspector.moveBehaviorUp()
Disponibilidad
Dreamweaver 3.
Descripción
Mueve una acción a un punto previo de la secuencia cambiando su orden de ejecución en el ámbito de un evento.
Argumentos
positionIndex
El argumento positionIndex corresponde a la posición de la acción en el panel Comportamientos. La primera acción de la lista está en la posición 0.
Valor devuelto
Ninguno.
Ejemplo
La llamada a la función dreamweaver.behaviorInspector.moveBehaviorUp(3) permuta las posiciones de las acciones de Cargar imágenes previamente y Cambiar propiedad en el evento onMouseOver. La llamada a la función dreamweaver.behaviorInspector.moveBehaviorUp() para cualquier otra posición no tiene ningún efecto, ya que los eventos onclick y onFocus tienen cada uno de ellos solo un comportamiento asociado, y el comportamiento de la posición 2 ya se encuentra en la parte superior del grupo del eventos onMouseDown.
dreamweaver.behaviorInspector.setSelectedBehavior()
Disponibilidad
Dreamweaver 3.
Descripción
Selecciona la acción en la posición especificada en el panel Comportamientos.
Argumentos
positionIndex
El argumento positionIndex corresponde a la posición de la acción en el panel Comportamientos. La primera acción de la lista está en la posición 0. Para anular la selección de todas las acciones, especifique positionIndex con valor -1. La especificación de una posición para la que no existe ninguna acción equivale a especificar- 1.
Valor devuelto
Ninguno.
Ejemplo
La llamada a la función dreamweaver.behaviorInspector.setSelection(2) selecciona la acción Cambiar propiedad asociada al evento onMouseDown:
