La estructura de éstos métodos es la siguiente:
- $showurl(cURL[,cFrame,cWindowProperties,cWindowRef]) abre la URL en una nueva ventana o marco en el cliente; cURL es la URL de la página HTML; cFrame es el nombre del marco HTML; si cFrame está vacío, la página se muestra en una nueva ventana; de lo contrario, se muestra en el marco especificado para la ventana actual.
- $close(cWindowRef) cierra la ventana del navegador que fue abierta previamente mediante el método $showurl(), consta de un solo parámetro y deberá ser el indicado mediante el cuarto parámetro del método $showurl() anterior.
En este artículo hablare del método $showurl, sus alternativas de uso, su equivalente JavaScript y algunos ejemplos, empecemos por desgranar sus parámetros:
- cURL: Es la dirección de la página a presentar en una nueva ventana del cliente o bien sobre el marco especificado mediante el siguiente parámetro de la página HTML que figura actualmente en el cliente.
- cFrame: Es el nombre de marco HTML. Si cFrame está vacío, la página se mostrará en una nueva ventana, de lo contrario se mostrará en el marco especificado para la ventana actual.
- cWindowProperties: Será ignorado si cFrame no existe. De lo contrario, tiene el mismo formato que los argumento del método Javascript "window.open", por ejemplo, "toolbar = 0, menubar = 1" indicaría que la ventana del navegador tendrá una barra de menú, pero no una barra de herramientas.
A continuación les muestro las posibles palabras clave o argumentos que podemos aportar en este tercer parámetro:
toolbar - La ventana del navegador tendrá una barra de herramientas
status - La ventana del navegador tendrá una barra de estado
menubar - La ventana del navegador tendrá una barra de menú
scrollbars - La ventana del navegador tendrá barras de desplazamiento
resizable - La ventana del navegador es de tamaño variable
location - La ventana del navegador tendrá una barra para direcciones
directories - La ventana del navegador mostrará el directorio Web
width - Anchura de la ventana del navegador
height - Altura de la ventana del navegador
top - Coordenada superior de la ventana del navegador
left - Coordenada izquierda de la ventana del navegador
Todas éstas palabras clave son boleanas (0 o 1) a excepción de la width, height, top y left, que deberán ser valores expresados en píxel's.
Les mostraré ahora algunos ejemplos de uso:
$cinst.$showurl(lvURL,,"toolbar=yes,location=no,width=750,height=400,resizable=yes,scrollbars=yes")
$cinst.$showurl("http://www.myserver.com/cgi-bin/omniscgi?OmnisServer=192.168.1.1&OmnisLibrary=MyLib&OmnisClass=rtLookup&Ukey=132456778","_blank")
Decir que también podremos usar una alternativa JavaScript inmersa en el mismo método:
$cinst.$showurl('javascript:self.close()','_top')
$cinst.$showurl("javascript:document.write('Testing');","_blank")
$cinst.$showurl(“javascript:self.close();window.open('http://127..0.0.1/insite/html/ejemplo.htm','orderpad','width=400,height=300,top=50,left=300,status=no,toolbar=no,menubar=no,scrollbars=yes’);”)
$cinst.$showurl("javascript:window.top.location.href=‘https://framosmu.blogspot.com/’")
De modo que podemos decir que el método $showurl(cURL[,cFrame,cWindowProperties]) es equivalente al método javascript: window.open(URL,target,options)
En éste caso “target” sería el equivalente a cFrame y puede tener los valores siguientes:
"_self" - Nueva página en la misma ventana
"_blank" - Nueva página en otra ventana
"_parent"- Nueva página en la ventana padre
"_top"- Nueva página en la ventana superior
frame_name - Nueva página en la ventana o marco denominado “frame_name”
Un último ejemplo para abrir una ventana en otra pestaña del navegador sin hacer uso del método $showurl, sería:
JavaScript: window.open(lvURL,lvNewTabName,"titlebar=no,toolbar=no,location=no,status=no,menubar=no,resizable=yes,scrollbars=yes")
Bueno, hacía mucho que no publicaba algo nuevo en éste blog, espero que les resulte útil, déjenme sus comentarios y/o aportaciones si lo consideran oportuno, nos vemos...
