VBScript

• APÉNDICE A: Propiedades y métodos de los objetos
• Objeto window
• Objeto document
• Objeto form
• Objeto location
• Objeto navigator
• Objeto history
• Tipos de eventos

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.