Objet objet intégré

Object WebView

Objet de fenêtre du navigateur

WebView est un composant de fenêtre incorporé dans le navigateur, ne supporte actuellement que les fenêtres.

Étant donné que le programme JavaScript dans WebView et fibjs ne sont pas dans le même moteur, donc si vous devez communiquer avec le programme hôte, vous devez le faire via le message.

L'objet utilisé par WebView pour la communication est externe. External prend en charge une méthode postMessage et deux événements onmessage et onclose.

Un exemple de code de communication simple est le suivant:

1 2 3 4 5 6 7 8 9
// index.js var gui = require('gui'); var webview = gui.open('fs:index.html'); webview.onmessage = msg => console.log(msg); webview.onload = evt => webview.postMessage("hello from fibjs"); webview.wait();

Le contenu de index.html est le suivant:

1 2 3 4 5 6 7 8
<script> external.onclose = function() { } external.onmessage = function(msg){ external.postMessage("send back: " + msg); }; </script>

Avant la fermeture de la fenêtre utilisateur, l'événement external.onclose est déclenché et external.onclose peut décider de la fermer. Si external.onclose renvoie false, l'opération est annulée, sinon la fenêtre sera fermée.

L'exemple suivant attend 5 secondes après que l'utilisateur a cliqué pour fermer avant de fermer la fenêtre.

1 2 3 4 5 6 7 8 9 10 11 12
<script lang="JavaScript"> var bClose = false; external.onclose = function () { if (!bClose) { setTimeout(function () { bClose = true; window.close(); }, 5000); return false; } } </script>

Dans le code ci-dessus, car window.close lui-même déclenchera également l'événement onclose, vous devez ajouter une variable de commutateur pour identifier si vous devez gérer cet événement.

Héritage

Propriété statique

defaultMaxListeners

Entier, nombre maximum d'écouteurs global par défaut

1
static Integer WebView.defaultMaxListeners;

Attribut de membre

visible

Booléen, interroge et définit si la fenêtre est affichée

1
Boolean WebView.visible;

onload

Événement de réussite de la fonction, de la requête et de la liaison, équivalent à on ("load", func);

1
Function WebView.onload;

onmove

Fonctionner, interroger et lier des événements de mouvement de fenêtre, équivalent à on ("move", func);

1
Function WebView.onmove;

L'exemple suivant affiche les coordonnées du coin supérieur gauche de la fenêtre lorsqu'elle se déplace:

1 2 3 4
var gui = require('gui'); var webview = gui.open('fs:index.html'); webview.onmove = evt => console.log(evt.left, evt.top);

onresize

Fonction, requête et événement de changement de taille de fenêtre de liaison, équivalent à on ("size", func);

1
Function WebView.onresize;

L'exemple suivant affiche la taille de la fenêtre lorsque la fenêtre change de taille:

1 2 3 4
var gui = require('gui'); var webview = gui.open('fs:index.html'); webview.onresize = evt => console.log(evt.width, evt.height);

onclosed

Fonction, requête et événement de fermeture de fenêtre de liaison, cette fois sera déclenchée après la fermeture de WebView, équivalente à on ("fermée", func);

1
Function WebView.onclosed;

onmessage

Fonction, requête et liaison pour accepter les événements de message postMessage dans la vue Web, équivalent à on ("message", func);

1
Function WebView.onmessage;

Fonction membre

setHtml

Définir la page de visualisation Web HTML

1
WebView.setHtml(String html) async;

Paramètres d'appel:

  • html : chaîne, définir html

print

Imprimer le document de la fenêtre actuelle

1
WebView.print(Integer mode = 1) async;

Paramètres d'appel:

  • mode : Entier, paramètres d'impression, 0: impression rapide; 1: impression standard; 2: aperçu avant impression. La valeur par défaut est 1

close

Fermer la fenêtre courante

1
WebView.close() async;

postMessage

Envoyer un message à WebView

1
WebView.postMessage(String msg) async;

Paramètres d'appel:

  • msg: String, le message à envoyer

    postMessage doit envoyer un message après le chargement de la fenêtre, et le message envoyé avant cela sera perdu. Par conséquent, il est recommandé d'appeler cette méthode après le déclenchement de l'événement onload.


on

Lier un gestionnaire d'événements à l'objet

1 2
Object WebView.on(String ev, Function func);

Paramètres d'appel:

  • ev : String, spécifiez le nom de l'événement
  • func : Function, spécifiez la fonction de traitement des événements

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

Lier un gestionnaire d'événements à l'objet

1
Object WebView.on(Object map);

Paramètres d'appel:

  • map : Object, spécifie la relation de mappage d'événements, le nom d'attribut d'objet sera utilisé comme nom d'événement et la valeur d'attribut sera utilisée comme gestionnaire d'événements

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

addListener

Lier un gestionnaire d'événements à l'objet

1 2
Object WebView.addListener(String ev, Function func);

Paramètres d'appel:

  • ev : String, spécifiez le nom de l'événement
  • func : Function, spécifiez la fonction de traitement des événements

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

Lier un gestionnaire d'événements à l'objet

1
Object WebView.addListener(Object map);

Paramètres d'appel:

  • map : Object, spécifie la relation de mappage d'événements, le nom d'attribut d'objet sera utilisé comme nom d'événement et la valeur d'attribut sera utilisée comme gestionnaire d'événements

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

prependListener

Lier un gestionnaire d'événements au début de l'objet

1 2
Object WebView.prependListener(String ev, Function func);

Paramètres d'appel:

  • ev : String, spécifiez le nom de l'événement
  • func : Function, spécifiez la fonction de traitement des événements

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

Lier un gestionnaire d'événements au début de l'objet

1
Object WebView.prependListener(Object map);

Paramètres d'appel:

  • map : Object, spécifie la relation de mappage d'événements, le nom d'attribut d'objet sera utilisé comme nom d'événement et la valeur d'attribut sera utilisée comme gestionnaire d'événements

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

once

Lier un gestionnaire d'événements ponctuel à l'objet, le gestionnaire ponctuel ne se déclenchera qu'une seule fois

1 2
Object WebView.once(String ev, Function func);

Paramètres d'appel:

  • ev : String, spécifiez le nom de l'événement
  • func : Function, spécifiez la fonction de traitement des événements

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

Lier un gestionnaire d'événements ponctuel à l'objet, le gestionnaire ponctuel ne se déclenchera qu'une seule fois

1
Object WebView.once(Object map);

Paramètres d'appel:

  • map : Object, spécifie la relation de mappage d'événements, le nom d'attribut d'objet sera utilisé comme nom d'événement et la valeur d'attribut sera utilisée comme gestionnaire d'événements

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

prependOnceListener

Lier un gestionnaire d'événements au début de l'objet

1 2
Object WebView.prependOnceListener(String ev, Function func);

Paramètres d'appel:

  • ev : String, spécifiez le nom de l'événement
  • func : Function, spécifiez la fonction de traitement des événements

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

Lier un gestionnaire d'événements au début de l'objet

1
Object WebView.prependOnceListener(Object map);

Paramètres d'appel:

  • map : Object, spécifie la relation de mappage d'événements, le nom d'attribut d'objet sera utilisé comme nom d'événement et la valeur d'attribut sera utilisée comme gestionnaire d'événements

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

off

Annuler la fonction spécifiée de la file d'attente de traitement d'objet

1 2
Object WebView.off(String ev, Function func);

Paramètres d'appel:

  • ev : String, spécifiez le nom de l'événement
  • func : Function, spécifiez la fonction de traitement des événements

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

Annuler toutes les fonctions de la file d'attente de traitement d'objets

1
Object WebView.off(String ev);

Paramètres d'appel:

  • ev : String, spécifiez le nom de l'événement

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

Annuler la fonction spécifiée de la file d'attente de traitement d'objet

1
Object WebView.off(Object map);

Paramètres d'appel:

  • map : Object, spécifie la relation de mappage d'événements, le nom d'attribut d'objet est utilisé comme nom d'événement et la valeur d'attribut est utilisée comme fonction de traitement d'événement

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

removeListener

Annuler la fonction spécifiée de la file d'attente de traitement d'objet

1 2
Object WebView.removeListener(String ev, Function func);

Paramètres d'appel:

  • ev : String, spécifiez le nom de l'événement
  • func : Function, spécifiez la fonction de traitement des événements

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

Annuler toutes les fonctions de la file d'attente de traitement d'objets

1
Object WebView.removeListener(String ev);

Paramètres d'appel:

  • ev : String, spécifiez le nom de l'événement

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

Annuler la fonction spécifiée de la file d'attente de traitement d'objet

1
Object WebView.removeListener(Object map);

Paramètres d'appel:

  • map : Object, spécifie la relation de mappage d'événements, le nom d'attribut d'objet est utilisé comme nom d'événement et la valeur d'attribut est utilisée comme fonction de traitement d'événement

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

removeAllListeners

Annulez tous les écouteurs de tous les événements de la file d'attente de traitement d'objets et, si des événements spécifiés, supprimez tous les écouteurs des événements spécifiés.

1
Object WebView.removeAllListeners(Array evs = []);

Paramètres d'appel:

  • evs : Array, spécifiez le nom de l'événement

Résultat de retour:

  • Object , renvoie l'objet événement lui-même, ce qui est pratique pour les appels chaînés

setMaxListeners

Le nombre limite d'auditeurs par défaut, uniquement pour des raisons de compatibilité

1
WebView.setMaxListeners(Integer n);

Paramètres d'appel:

  • n : Entier, spécifiez le nombre d'événements

getMaxListeners

Obtenez le nombre d'écouteurs par défaut, uniquement pour des raisons de compatibilité

1
Integer WebView.getMaxListeners();

Résultat de retour:

  • Integer , renvoie le nombre limite par défaut

listeners

Tableau d'écouteurs pour l'événement spécifié de l'objet de requête

1
Array WebView.listeners(String ev);

Paramètres d'appel:

  • ev : String, spécifiez le nom de l'événement

Résultat de retour:

  • Array , renvoie un tableau d'écouteurs pour l'événement spécifié

listenerCount

Le nombre d'écouteurs pour l'événement spécifié de l'objet de requête

1
Integer WebView.listenerCount(String ev);

Paramètres d'appel:

  • ev : String, spécifiez le nom de l'événement

Résultat de retour:

  • Integer , retourne le nombre d'écouteurs pour l'événement spécifié

eventNames

Nom de l'événement de l'écouteur de requête

1
Array WebView.eventNames();

Résultat de retour:

  • Array , renvoie un tableau de noms d'événements

emit

Déclencher activement un événement

1 2
Boolean WebView.emit(String ev, ...args);

Paramètres d'appel:

  • ev : chaîne, nom de l'événement
  • args : ..., les paramètres d'événement seront transmis à la fonction de gestionnaire d'événement

Résultat de retour:

  • Boolean , retourne l'état du déclencheur d'événement, retourne vrai s'il y a un événement de réponse, sinon retourne faux

toString

Renvoie une représentation sous forme de chaîne de l'objet, renvoie généralement "[Native Object]", l'objet peut être réimplémenté selon ses propres caractéristiques

1
String WebView.toString();

Résultat de retour:

  • String , renvoie une représentation sous forme de chaîne de l'objet

toJSON

Renvoie la représentation au format JSON de l'objet, renvoie généralement une collection d'attributs lisibles définis par l'objet

1
Value WebView.toJSON(String key = "");

Paramètres d'appel:

  • key : chaîne, inutilisée

Résultat de retour:

  • Value , retourne une valeur contenant JSON sérialisable