|
VBScript |
APÉNDICE A: Propiedades y métodos de los objetos
Como ya hemos mencionado en este temario, los objetos siguen una jerarquía. El de mas alto nivel es el objeto WINDOW, que representa a la ventana activa. Todos los demás, son objetos derivados de éste. Veamos cuales son las propiedades y métodos que acepta cada uno, así como los eventos que les afectan.
Objeto window
Representa la ventana activa del navegador y es el mas alto de la jerarquía.
Propiedades:
| defaultStatus | se refiere al mensaje que aparecerá por defecto en la barra de estado. |
| document | representa al documento HTML en ejecución en ese momento. |
| frames [] | es una matriz que contiene los frames de la ventana. |
| history | representa un registro histórico de las páginas visitadas en la actual sesión de uso de Internet. |
| length | contiene el número total de frames de la ventana. |
| location | representa a la dirección (URL) actual de Internet. |
| name | contiene el nombre de la ventana activa. |
| navigator | representa al navegador que estamos utilizando. |
| self | se refiere a la propia ventana. Es el mismo objeto window. |
| status | es el mensaje que aparece en la barra de estado en un momento determinado. |
| window | representa a la ventana activa o a otra ventana o sub-ventana de navegación. |
Métodos:
| close () | permite cerrar la ventana activa. Su sintaxis es self.close() |
| open () | permite abrir una nueva ventana, como sub ventana de la actual. Su sintaxis es: nueva_ventana = window.open ("URL", "Target", "Opciones") |
En la sintaxis expresada, nueva_ventana es el nombre que queremos darle a la sub-ventana. URL es la dirección de la página que queremos que se cargue en la sub-ventana. Target es la dirección del frame donde queremos que se abra la nueva ventana (caso de existir frames) como hacemos en HTML con los hiperenlaces. Opciones son las propiedades de la nueva ventana, de acuerdo a la siguiente tabla.
| propiedad | Tipo de dato | Explicación |
| toolbar | booleano | Ventana con barra de herramientas. |
| location | booleano | Ventana con barra de direcciones. |
| directories | booleano | Ventana con directorios. |
| Status | booleano | Ventana con barra de estado |
| menubar | booleano | Ventana con barra de menús. |
| scrollbars | booleano | Ventana con barras de desplazamiento. |
| resizable | booleano | Ventana de tamaño redefinible por el usuario. |
| width | píxeles | Anchura de la ventana |
| height | píxeles | Altura de la ventana. |
| top | píxeles | Posición Y de la ventana |
| left | píxeles | Posición x de la ventana |
Eventos:
| onLoad | Se ejecuta cuando se carga la página. |
| onUnload | Se ejecuta cuando se descarga (se cierra) la página. |
Objeto document
Representa el documento activo.
Propiedades:
| alinkColor | Representa el color de los enlaces activos. |
| bgColor | Representa el color de fondo del documento. |
| fgColor | Representa el color del texto |
| lastModified | Representa la fecha de la última modificación. |
| linkColor | Representa el color de los enlaces. |
| location | Representa la URL del documento. |
| title | Representa el título del documento. |
| vlinkColor | Representa el color de los enlaces visitados. |
Métodos:
| Write () | Escribe un texto. |
| Writeln() | Escribe una línea de texto. |
Eventos:
| Ninguno |
Objeto form
Este objeto se refiere a un formulario empleado en el documento. Se accede a cada formulario mediante un índice: document.form [índice]
El número de índice se corresponde con el orden de creación de formulario en el documento.
Propiedades:
| action | Representa la URL donde está el programa encargado de procesar un formulario (al que se llama al activar el botón Submit). |
| length | Es el número de elementos del formulario. |
| method | Es el método de envío (GET o POST). |
Métodos:
| submit | Se usa para forzar el envío. |
Eventos:
| onSubmit | Se produce cuando se pulsa el botón Submit del formulario. |
Objeto location
Contiene la URL de la página actual
Propiedades:
| href | Representa la propia URL. |
| pathname | Representa la ruta del disco del servidor donde se aloja la página. |
Métodos:
| Ninguno. |
Eventos:
| Ninguno. |
Objeto navigator
Representa al navegador actual.
Propiedades:
| appName | Es el nombre del navegador. |
| appVersion | Se refiere a la versión del navegador. |
Métodos:
| Ninguno. |
Eventos:
| Ninguno. |
Objeto history
Representa el historial de las páginas visitadas en la sesión actual de uso de Internet
Propiedades:
| length | Representa la cantidad total de páginas visitadas. |
Métodos:
| back () | navega a la página anterior. |
| forward() | navega a la página siguiente. |
| go (n) | navega n páginas hacia delante (o hacia atrás, si n es negativo). |
Eventos:
| Ninguno. |
Tipos de eventos
Aquí se listan los principales eventos que se pueden asociar a una imagen, hipervínculo, cadena de texto, etc. A continuación aparecen agrupados según donde se originen (ratón teclado, etc). Estos eventos son los mas usados. Existen otros, pero no siempre funcionan bien con los dos navegadores, y además son bastantes exóticos, académicos y de uso poco práctico. No los veremos aquí.
Eventos de ratón
| ONCLICK | Se activa con un botón del ratón. |
| ONDBLCLICK | Se activa si se hace un doble click. |
| ONMOUSEDOWN | Se activa si se pulsa el botón izquierdo del mouse. |
| ONMOUSEMOVE | Se activa si se mueve el mouse. |
| ONMOUSEOVER | Se activa cuando el puntero se sitúa sobre el objeto que incluye al evento. |
| ONMOUSEOUT | Se activa cuando el puntero sale del objeto que incluye al evento. |
| ONMOUSEUP | Se activa si se suelta un botón pulsado en el mouse (es contrario a ONCLICK). |
| ONDRAGSTART | Se activa cuando se inicia un arrastre. |
| ONSELECTSTART | Se activa cuando se inicia una selección con el ratón. |
| ONSELECT | Se activa cuando se ha realizado una selección con el ratón. |
Eventos de teclado
| ONKEYDOWN | Se activa si se pulsa una tecla cualquiera. |
| ONKEYPRESS | Se activa si se pulsa y suelta una tecla. |
| ONKEYUP | Se activa cuando se suelta una tecla pulsada. |
| ONHELP | Se activa si se pulsa la tecla de ayuda (normalmente F1). |
Eventos de enfoque
| ONFOCUS | Se activa cuando se entra en el ámbito de un elemento al que está asociado el evento. |
| ONBLUR | Se activa al abandonar el ámbito del elemento al que está asociado. |
Eventos de formulario
| ONRESET | Se activa al pulsar un botón de reset de un formulario. |
| ONSUBMIT | Se activa al enviar un formulario. |
Eventos de carga de página
| ONABORT | Se activa cuando se aborta la carga de la página. |
| ONERROR | Se activa cuando se produce un error inesperado durante la carga de la página. |
| ONLOAD | Se activa cuando se carga la página. |
| ONUNLOAD | Se activa cuando el usuario descarga la página (es decir, carga otra o pretende salir del navegador). |
| ONAFTERUPDATE | Se activa si se actualiza o recarga la página. |
 |
 |
 |
Publicado por: Ronaldo Martinez |
|
|
