Paquete | flash.media |
Clase | public final class StageWebView |
Herencia | StageWebView EventDispatcher Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
La clase StageWebView proporciona un modo sencillo de mostrar el contenido HTML en dispositivos donde la clase HTMLLoader no se admite. La clase no proporciona ninguna interacción entre ActionScript y el contenido HTML excepto a través de los métodos y propiedades de la propia clase StageWebView. No existe, por ejemplo, ninguna manera para transferir valores o llamar a las funciones entre ActionScript y JavaScript.
Compatibilidad con perfil de AIR: esta característica se admite en todos los sistemas operativos de escritorio, pero no en dispositivos de AIR para TV. Puede probar la compatibilidad en tiempo de ejecución con la propiedad StageWebView.isSupported
. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.
En los dispositivos de los servicios móviles y perfiles de móvil ampliados, la clase StageWebView utiliza el sistema de control web proporcionado por el sistema operativo del dispositivo. Por consiguiente, las funciones disponibles y el aspecto del procesamiento podría variar según el dispositivo.
En Android, solo se admite el vídeo HTML5 alineado si <application android:hardwareAccelerated="true"/>
se incluye en el descriptor de la aplicación.
En equipos de escritorio (en perfiles de escritorio y escritorio ampliado), la clase StageWebView utiliza el control web del sistema proporcionado por el plug-in de Flash Player. Las funciones disponibles y el aspecto del procesamiento son los mismos que los de la clase HTMLLoader (sin la estrecha integración y script puente entre ActionScript y JavaScript proporcionado por una instancia de HTMLLoader). Dado que la clase HTMLLoader utiliza el motor interno AIR WebKit, no es aconsejable el uso simultáneo de StageWebView y HTMLLoader, ya que su comportamiento no está definido y podría provocar el cierre de la aplicación.
La clase StageWebView NO es un objeto de visualización y no se puede añadir a la lista de visualización de Flash. En su lugar, muestre un objeto StageWebView adjuntándolo directamente a un escenario con la propiedad stage
. La instancia de StageWebView unida a un escenario se muestra por encima de cualquier objeto de visualización de Flash. Puede controlar el tamaño y la posición del área representación con la propiedad viewPort
. No hay ninguna manera de controlar el orden de profundidad de diferentes objetos StageWebView. No se recomienda superponer dos instancias.
Cuando se está dentro del contenido del objeto StageWebView seleccionado, el objeto StageWebView tiene la primera oportunidad para gestionar entrada del teclado. El escenario al que se asocia el objeto StageWebView distribuye los datos de teclado que no se gestionan. El ciclo normal de captura/propagación de eventos no se aplica aquí, ya que la instancia de StageWebView no forma parte de la lista de visualización.
En Android 3.0+, una aplicación debe activar la aceleración de hardware en el elemento manifestAdditions de Android del descriptor de la aplicación de AIR para mostrar contenido de plug-in en un objeto StageWebView.
Más información
Elementos de API relacionados
Propiedad | Definido por | ||
---|---|---|---|
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
isHistoryBackEnabled : Boolean [solo lectura]
Informa si hay una página anterior en el historial de navegación. | StageWebView | ||
isHistoryForwardEnabled : Boolean [solo lectura]
Informa si hay una página siguiente en el historial de navegación. | StageWebView | ||
isSupported : Boolean [estática] [solo lectura]
Informa si la clase StageWebView se admite en el dispositivo actual. | StageWebView | ||
location : String [solo lectura]
La dirección URL de la ubicación actual. | StageWebView | ||
mediaPlaybackRequiresUserAction : Boolean
Establece si el usuario debe realizar un gesto para reproducir el contenido multimedia. | StageWebView | ||
stage : Stage
El escenario en el que se visualiza el objeto StageWebView. | StageWebView | ||
title : String [solo lectura]
El valor del título HTML. | StageWebView | ||
viewPort : Rectangle
El área del escenario en la que se visualiza el objeto StageWebView. | StageWebView |
Método | Definido por | ||
---|---|---|---|
Crea un objeto StageWebView. | StageWebView | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | EventDispatcher | ||
Asigna la selección al contenido dentro de este objeto StageWebView. | StageWebView | ||
Distribuye un evento en el flujo del evento. | EventDispatcher | ||
Se deshace de este objeto StageWebView. | StageWebView | ||
Dibuja el puerto de la vista de StageWebView en un mapa de bits. | StageWebView | ||
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Se desplaza a la página anterior del historial de navegación. | StageWebView | ||
Se desplaza hasta la página siguiente en el historial de navegación. | StageWebView | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Carga y visualiza la cadena HTML especificada. | StageWebView | ||
Carga la página en la dirección URL especificada. | StageWebView | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Vuelve a cargar la página actual. | StageWebView | ||
Elimina un detector del objeto EventDispatcher. | EventDispatcher | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Detiene la operación de carga en curso. | StageWebView | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
Devuelve la representación de cadena del objeto especificado. | Object | ||
Devuelve el valor simple del objeto especificado. | Object | ||
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher |
Evento | Resumen | Definido por | ||
---|---|---|---|---|
[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | |||
Indica que la última operación de carga solicitada por el método loadString() o loadURL() ha finalizado correctamente. | StageWebView | |||
[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | |||
Indica que se ha producido un error. | StageWebView | |||
Se distribuye cuando este objeto StageWebView recibe la selección. | StageWebView | |||
Se distribuye cuando StageWebView cede la selección. | StageWebView | |||
Indica que la propiedad location de un objeto StageWebView ha cambiado. | StageWebView | |||
Indica que la propiedad location del objeto StageWebView está a punto de cambiar. | StageWebView |
isHistoryBackEnabled | propiedad |
isHistoryForwardEnabled | propiedad |
isSupported | propiedad |
location | propiedad |
mediaPlaybackRequiresUserAction | propiedad |
mediaPlaybackRequiresUserAction:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 21.0 |
Establece si el usuario debe realizar un gesto para reproducir el contenido multimedia. En iOS, esta propiedad no se tendrá en cuenta, y la reproducción automática de los medios solo se activará a través del generador StageWebView ()
. El valor predeterminado es true.
Implementación
public function get mediaPlaybackRequiresUserAction():Boolean
public function set mediaPlaybackRequiresUserAction(value:Boolean):void
stage | propiedad |
stage:Stage
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
El escenario en el que se visualiza el objeto StageWebView.
Establezca stage
como null
para ocultar este objeto StageWebView.
Implementación
public function get stage():Stage
public function set stage(value:Stage):void
title | propiedad |
viewPort | propiedad |
viewPort:Rectangle
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
El área del escenario en la que se visualiza el objeto StageWebView.
Implementación
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
Emite
RangeError — El valor de Rectangle no es válido.
|
StageWebView | () | Información sobre |
public function StageWebView(useNative:Boolean = false, mediaPlaybackRequiresUserAction:Boolean = true)
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Crea un objeto StageWebView.
El objeto es invisible hasta que se asocia a un escenario y hasta que se establece viewPort
.
Nota: aunque no se prohíba, en ciertos contenidos, pueden producirse errores cuando el mismo proceso utiliza tanto el WebKit incrustado como el del sistema, por lo que se recomienda construir todas las StageWebViews en una aplicación concreta con el mismo valor para useNative. Además, como HTMLLoader depende del WebKit incrustado, las aplicaciones que utilizan HTMLLoader solo deben crear StageWebViews useNative definido en false.
ParámetrosuseNative:Boolean (default = false ) — Cuando useNative es false, se utiliza una versión de WebKit incrustada dentro de AIR como el origen de StageWebView que se ha creado. Cuando useNative es true, AIR utiliza el motor web predeterminado del sistema. Las plataformas móviles solo admiten el uso del motor web del sistema, e ignoran useNative.
| |
mediaPlaybackRequiresUserAction:Boolean (default = true ) — El valor predeterminado es “true”. Si el valor de mediaPlaybackRequiresUserAction es “true”, WebView requiere que el usuario active la reproducción. Si es “false”, el contenido de WebView se reproducirá automáticamente.
|
assignFocus | () | método |
public function assignFocus(direction:String = "none"):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Asigna la selección al contenido dentro de este objeto StageWebView.
Los valores de dirección se definen en clase FocusDirection e incluyen: "bottom", "none" y "top".
Parámetros
direction:String (default = "none ") — especifica si el primer o el último objeto seleccionable en el contenido visualizado debe recibir la selección.
|
Elementos de API relacionados
dispose | () | método |
public function dispose():void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Se deshace de este objeto StageWebView.
Llamar a dispose()
es opcional. Si no se conserva una referencia a esta instancia de StageWebView, será adecuado para la recolección de elementos no utilizados. Llamar a dispose()
puede hacer que la recolección de elementos no utilizados se produzca antes o en un momento más adecuado.
drawViewPortToBitmapData | () | método |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.6 |
Dibuja el puerto de la vista de StageWebView en un mapa de bits.
Capture el mapa de bits y ajuste el escenario en null
para mostrar el contenido por encima del objeto StageWebView.
Nota: el comportamiento de este método no se garantiza en páginas con contenido de plug-in (por ejemplo, archivos PDF y SWF incorporados).
Parámetros
bitmap:BitmapData — El objeto BitmapData en el que se dibuja la parte visible del puerto de la vista de StageWebView.
|
Emite
ArgumentError — La anchura y la altura del mapa de bits es diferente de la del puerto de la vista.
| |
Error — El mapa de bits tiene el valor null.
|
Ejemplo ( Cómo utilizar este ejemplo )
package { import flash.display.Bitmap; import flash.display.BitmapData; import flash.display.Sprite; import flash.events.*; import flash.geom.Rectangle; import flash.media.StageWebView; import flash.net.*; import flash.text.TextField; public class stagewebview1 extends Sprite { public var webView:StageWebView = new StageWebView(); public var textGoogle:TextField=new TextField(); public var textFacebook:TextField=new TextField(); public function stagewebview() { textGoogle.htmlText="<b>Google</b>"; textGoogle.x=300; textGoogle.y=-80; addChild(textGoogle); textFacebook.htmlText="<b>Facebook</b>"; textFacebook.x=0; textFacebook.y=-80; addChild(textFacebook); textGoogle.addEventListener(MouseEvent.CLICK,goGoogle); textFacebook.addEventListener(MouseEvent.CLICK,goFaceBook); webView.stage = this.stage; webView.viewPort = new Rectangle(0, 0, stage.stageWidth, stage.stageHeight); } public function goGoogle(e:Event):void { webView.loadURL("http://www.google.com"); webView.stage = null; webView.addEventListener(Event.COMPLETE,handleLoad); } public function goFaceBook(e:Event):void { webView.loadURL("http://www.facebook.com"); webView.stage = null; webView.addEventListener(Event.COMPLETE,handleLoad); } public function handleLoad(e:Event):void { var bitmapData:BitmapData = new BitmapData(webView.viewPort.width, webView.viewPort.height); webView.drawViewPortToBitmapData(bitmapData); var webViewBitmap:Bitmap=new Bitmap(bitmapData); addChild(webViewBitmap); } } }
historyBack | () | método |
public function historyBack():void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Se desplaza a la página anterior del historial de navegación.
historyForward | () | método |
public function historyForward():void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Se desplaza hasta la página siguiente en el historial de navegación.
loadString | () | método |
public function loadString(text:String, mimeType:String = "text/html"):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Carga y visualiza la cadena HTML especificada.
Cuando se utiliza el método loadString()
, la propiedad location
se informa como "about:blank". Sólo se pueden utilizar esquemas de URI estándar en direcciones URL dentro de la cadena HTML. Los esquemas de URI de AIR, "app:" y "app-storage:" no están permitidos.
El contenido HTML no puede cargar recursos locales, como archivos de imagen. XMLHttpRequests no están permitidos.
Sólo los tipos MIME "text/html" y "application/xhtml+xml" son compatibles.
Parámetros
text:String — la cadena de contenido HTML o XHTML para mostrar.
| |
mimeType:String (default = "text/html ") — El tipo MIME del contenido, ya sea de "text/html" o "application/xhtml+xml".
|
Ejemplo ( Cómo utilizar este ejemplo )
loadString()
.
var webView:StageWebView = new StageWebView(); webView.stage = this.stage; webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight ); var htmlString:String = "<!DOCTYPE HTML>" + "<html>" + "<body>" + "<h1>Example</h1>" + "<p>King Phillip cut open five green snakes.</p>" + "</body>" + "</html>"; webView.loadString( htmlString, "text/html" );
loadURL | () | método |
public function loadURL(url:String):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Carga la página en la dirección URL especificada.
La URL puede utilizar los siguientes esquemas de URI: http:, https:, file:, data:, y javascript:. El contenido cargado con el archivo: el esquema puede cargar otros recursos locales.
Parámetros
url:String |
Ejemplo ( Cómo utilizar este ejemplo )
loadURL()
.
Nota: en Android, debe especificar el permiso de Internet en el archivo descriptor de la aplicación de AIR para cargar direcciones URL remotas.
var webView:StageWebView = new StageWebView(); webView.stage = this.stage; webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight ); webView.loadURL( "http://www.example.com" );
reload | () | método |
public function reload():void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Vuelve a cargar la página actual.
stop | () | método |
public function stop():void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Detiene la operación de carga en curso.
complete | Evento |
flash.events.Event
propiedad Event.type =
flash.events.Event.COMPLETE
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Indica que la última operación de carga solicitada por el método loadString()
o loadURL()
ha finalizado correctamente.
Event.COMPLETE
define el valor de la propiedad type
de un objeto de evento complete
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | false |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto de red que ha terminado de cargarse. |
error | Evento |
flash.events.ErrorEvent
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Indica que se ha producido un error.
focusIn | Evento |
flash.events.FocusEvent
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Se distribuye cuando este objeto StageWebView recibe la selección.
focusOut | Evento |
flash.events.FocusEvent
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Se distribuye cuando StageWebView cede la selección.
locationChange | Evento |
flash.events.LocationChangeEvent
propiedad LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Indica que la propiedad location
de un objeto StageWebView ha cambiado.
El evento no se puede cancelar.
Se distribuye después de cada cambio de ubicación. locationChanging | Evento |
flash.events.LocationChangeEvent
propiedad LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5 |
Indica que la propiedad location
del objeto StageWebView está a punto de cambiar.
Un evento locationChanging sólo se distribuye cuando el cambio de ubicación se inicia a través el contenido HTML o código que se ejecuta en el interior del objeto StageWebView, como cuando un usuario hace clic en un vínculo. De forma predeterminada, la nueva ubicación se visualiza en este objeto StageWebView. Se puede llamar al método preventDefault()
del objeto de evento para cancelar el comportamiento predeterminado. Por ejemplo, podría utilizar la función flash.net.navigateToURL()
para abrir la página en el navegador del sistema basado en la propiedad location
del objeto de evento
No se distribuye un evento locationChanging al cambiar de ubicación con los métodos siguientes:
historyBack()
historyForward()
loadString()
loadURL()
reload()
LOCATION_CHANGING
define el valor del objeto LocationChangeEvent de la propiedad type
antes de un cambio en la ubicación de la página.
loadURL()
y se utilizan las teclas Atrás y Buscar del dispositivo para el historial de navegación.
package { import flash.display.MovieClip; import flash.media.StageWebView; import flash.geom.Rectangle; import flash.events.KeyboardEvent; import flash.ui.Keyboard; import flash.desktop.NativeApplication; public class StageWebViewExample extends MovieClip{ private var webView:StageWebView = new StageWebView(); public function StageWebViewExample() { webView.stage = this.stage; webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight ); webView.loadURL( "http://www.example.com" ); stage.addEventListener( KeyboardEvent.KEY_DOWN, onKey ); } private function onKey( event:KeyboardEvent ):void { if( event.keyCode == Keyboard.BACK && webView.isHistoryBackEnabled ) { trace("Back."); webView.historyBack(); event.preventDefault(); } if( event.keyCode == Keyboard.SEARCH && webView.isHistoryForwardEnabled ) { trace("Forward."); webView.historyForward(); } } } }
Tue Jun 12 2018, 02:12 PM Z