Les scripts de Maxthon v2.0

Last Modified: 2006-07-17 4:24 PM Version: 2.0.1

Vue d'ensemble

Le navigateur Maxthon a amélioré le support du DHTML de IE en ajoutant plusieurs nouvelles extensions qui peuvent être appelées par un langage de script comme Javascript et VBScript.

Ces APIs peuvent être appelées via l'objet window.external dans une page HTML ou par un Plugin de type script réalisé pour Maxthon.

Quelques fonctions nécessiteront security_id comme premier paramètre. Ces fonctions peuvent seulement être utilisées par des Plugins.
Afin d'avoir un security_id pour votre plugin, vous devez procéder ainsi :

Plugins de type Bouton

Insérez un %max_security_id dans votre script, comme ceci :

var security_id=%max_security_id;

Ainsi vous pourrez utiliser la variable security_id dans votre script.

Plugins de type Barre latérale

Un fichier nommé max.src sera créé dans le dossier de votre Plugin, inclure ce fichier dans votre fichier HTML :

<script type="text/javascript" src="max.src"></script>

Ainsi vous pourrez utiliser la variable max_security_id comme paramètre identificateur de sécurité dans votre script.

Index

Propriétés étendues

• max_version : Obtenir la version courante de Maxthon
• max_language_id : Obtenir l'id de la langue courante de l'interface utilisateur de Maxthon
• current_tab (cur_sel) : Obtenir l'index de l'onglet en cours
• tab_count : Obtenir le nombre d'onglets ouvert en cours

Méthodes générales

• addFavorite() : Appeler la boîte de dialogue Ajouter un Favori
• addProxy() : Appeler la boîte de dialogue Ajouter un Proxy
• addFilter() : Appeler la boîte de dialogue Ajouter un Filtre
• max_addProxyProvider() : Appeler la boîte de dialogue Ajouter un Fournisseur de Proxy
• m2_run_cmd() : Exécuter la fonction de Maxthon correspondant à la commande ID
• m2_search_text() : Obtenir la chaîne de recherche de la barre de recherche de Maxthon
• m2_plugin_folder() : Obtenir le dossier local des Plugins

Méthodes associées aux onglets

• get_tab() : Obtenir l'objet d'un onglet par index
• activate_tab() : Activer un onglet par index
• close_tab() : Fermer un onglet par index

Méthodes associées aux fichiers

• readFile() : Lire le contenu d'un fichier
• writeFile() : Ecrire des données dans un fichier
• m2_readIni() : Lire un fichier INI
• m2_writeIni() : Ecrire dans un fichier INI

Propriétées étendues

max_version

Remarques :

Cette propriété retournera une chaîne de caractères indiquant le numéro de version de Maxthon.
 La chaîne sera formatée de la façon suivante : "2.1.0.600".

Il est suggéré d'utiliser cette propriété pour déterminer si Maxthon est en cours d'exécution.

Exigences :

Maxthon version 2.0+

Exemple :

alert('Maxthon Version: '+external.max_version);

max_language_id

Remarques :

Cette propriété retournera l'ID de la langue en cours d'utilisation dans Maxthon.

L'ID de la langue a été modifié afin d'utiliser l'identificateur de langage défini dans Microsoft Windows depuis Maxthon v2.0. 
 la liste des ID utilisés par Maxthon se trouve ici :
http://msdn.microsoft.com/library/?url=/library/en-us/intl/nls_238z.asp

Exigences :

Maxthon version 1.0+

Exemple :

alert('Language ID='+external.max_language_id);

====current_tab==== (formerly cur_sel ) Non encore implémenté

Remarques :

Cette propriété retournera un nombre entier qui représente l'index de l'onglet qui est actif.
null sera retourné s'il n'y a auncun onglet d'ouvert.
current_tab a été introduit dans Maxthon v2.0 en remplacement de cur_sel 
parce que le nom de l'ancienne propriété était trop obscur à comprendre.

Exigences :

Maxthon version 2.0+ (utiliser cur_sel pour les versions 1.x)

Exemple :

alert('Current Tab Index: '+external.current_tab);

tab_count

Remarques :

Cette propriété retournera le nombre d'onglet en cours sous la forme d'un entier.

Exigences :

Maxthon version 1.0+

Exemple :

alert('Tabs Count: '+external.tab_count);

Méthodes générales

addFavorite(url [, title])

Paramètres :

url : chaîne
L'url à ajouter.

title : chaîne
Optionnel. Le titre de l'url.

Remarques :

Affiche la boîte de dialogue Ajouter un Favori pour demander à l'utilisateur d'ajouter un nouveau Favori.
 Cette fonction retournera faux si l'utilisateur a annulé cette opération.

Exigences :

Maxthon version 1.0+

Exemple :

external.addFavorite("http://www.maxthon.com");

external.addFavorite("http://www.maxthon.com", "Site officiel de Maxthon");

addProxy(name, address, type)

Paramètres :

name : chaîne
Le nom du Proxy.

address : chaîne
L'adresse IP ou le nom de domaine du Proxy.

type : entier
Un nombre indiquant la vitesse du Proxy.
= Proxy HTTP, 1 = Proxy SOCKS4A, 2 = Proxy SOCKS5

Remarques :

Ajoute un nouveau Proxy dans liste des Proxy de Maxthon. Une boîte de dialogue sera présentée à l'utilisateur.
 Cette fonction retournera faux si l'utilisateur a annulé cette opération.

Exigences :

Maxthon version 2.0+

Exemple :

external.addProxy("My proxy","192.168.1.0:8080", 1);

addFilter(url_mask, type)

Paramètres :

url_mask : chaîne
Masque d'adresse qui correspond aux adresses à bloquer. Supporte les expressions régulières.

type : entier
Un nombre indiquant la liste de filtres à ajouter.
= Filtre de Popup, 1 = Filtre de contenu

Remarques :

Ajoute une nouvelle politique de filtrage dans Maxthon. Une boîte de dialogue sera présentée à l'utilisateur.
 Cette fonction retournera faux si l'utilisateur a annulé cette opération.

Exigences :

Maxthon version 2.0+

Exemple :

external.addFilter("http://www.advertisement.com/img/*", );

max_addProxyProvider(URL)

Paramètres :

URL : chaîne
L'URL du fichier de la liste des Proxy. Pour le format du fichier, se reporter à [proxyprovider.htm ce document].

Remarques :

Ajoute un nouveau fournisseur de Proxy dans Maxthon. Une boîte de dialogue sera présentée à l'utilisateur.
 Cette fonction retournera faux si l'utilisateur a annulé cette opération.

Exigences :

Maxthon version 2.0+

Exemple :

external.max_addProxyProvider("http://www.freeproxy.cn/m2proxy/proxylist.xml");

m2_run_cmd(security_id, command_id)

Paramètres :

security_id : chaîne
ID de sécurité de Maxthon.

command_id : entier
L'ID de la commande interne de Maxthon.

Remarques :

Cette fonction appellera une commande de Maxthon avec le command_id spécifié.
 De nombreux ID de commande peuvent être trouvés dans le fichier langage dans le répertoire langage de Maxthon.
L'ID de la commande peut être différent suivant la version.
 N'utilisez pas cette fonction si ce n'est pas nécessaire.

Exigences :

Maxthon version 1.0+

Exemple :

external.m2_run_cmd(security_id, 32772); // Ouvre une page vierge

m2_search_text(security_id)

Paramètres :

security_id : chaîne
ID de sécurité de Maxthon.

Remarques :

Cette fonction retournera le texte de la barre de recherche de Maxthon sous la forme d'une chaîne.

Exigences :

Maxthon version 1.2+

Exemple :

var searchText=external.m2_search_text(security_id);

m2_plugin_folder(security_id, plugin_name)

Paramètres :

security_id : chaîne
ID de sécurité de Maxthon.

plugin_name : chaîne
Le nom du Plugin comme défini dans le fichier plugin.ini.

Remarques :

Cette fonction retournera le dossier local du Plugin spécifié sous la forme d'une chaîne.

Exigences :

Maxthon version 1.2+

Exemple :

var pluginPath=external.m2_plugin_folder(security_id, "ViewSource!");

m2_callerName(security_id, plugin_name)

Paramètres :

security_id : chaîne
ID de sécurité de Maxthon.

plugin_name : chaîne
Le nom du Plugin comme défini dans le fichier plugin.ini.

Remarques :

Cette fonction indiquera à Maxthon la fonction suivante appelée à partir du Plugin.
Cette fonction est habituellement utilisée avant l'ouverture de la méthode window.open() 
pour bypasser le bloqueur de Popup de Maxthon pour le Plugin.

Exigences :

Maxthon version 1.2+

Exemple :

external.m2_callerName(security_id, "ViewSource!");
window.open("about:blank");

max_actSideBarItem(plugin_name)

Paramètres :

plugin_name : chaîne
Le nom du Plugin comme défini dans le fichier plugin.ini.

Remarques :

Cette fonction activera le Plugin de la barre latérale avec le nom indiqué. 

Exigences :

Maxthon version 1.2+

Exemple :

external.max_actSideBarItem("Calculator++");

max_modelessDialog(security_id, url, arguments, features, parent_window)

Paramètres :

security_id : chaîne
ID de sécurité de Maxthon.

url : chaîne
L'url du contenu de la boîte de dialogue.

arguments : variante
Les arguments passés à l'objet window.dialogArguments de la boîte de dialogue .

features : chaîne
Une chaîne qui spécifie les caractéristiques de la fenêtre de la boîte de dialogue.

parent_window : objet
La racine de l'objet window de la boîte de dialogue.

Remarques :

Cette fonction est à peu près la même que window.showModelessDialog() mais avec 2 paramètres de plus.
 Avec le security_id votre Plugin peut bypasser le bloqueur de Popup de Maxthon.
 Avec le parent_window vous pouvez créer la boîte de dialogue qui est une fille d'une autre window de l'onglet.

Exigences :

Maxthon version 1.2+

Exemple :

external.max_modelessDialog(security_id, "about:blank", {"userid": 7, "key": "d3fe3asd"}, "status:no; help:no; resizable:yes; scroll:yes;", window);

get_tab(security_id, index)

Paramètres :

security_id : chaîne
ID de sécurité de Maxthon.

index : entier
L'index de l'onglet à obtenir.

Remarques :

Cette fonction obtiendra l'objet window de l'onglet spécifié dans Maxthon.
null sera retourné si l'onglet n'existe pas.

Exigences :

Maxthon version 1.0+

Exemple :

var objTab=external.get_tab(security_id, 5);

activate_tab(security_id, index)

Paramètres :

security_id : chaîne
ID de sécurité de Maxthon.

index : entier
L'index de l'onglet à activer.

Remarques :

Cette fonction activera l'onglet spécifié dans Maxthon.
 Il ne se passera rien si l'onglet n'existe pas.

Exigences :

Maxthon version 1.0+

Exemple :

external.activate_tab(security_id, 1);

close_tab(security_id, index)

Paramètres :

security_id : chaîne
ID de sécurité de Maxthon.

index : entier
Entier. L'index de l'onglet à fermer.

Remarques :

Cette fonction fermera l'onglet représentant l'index.
 Il ne se passera rien si l'onglet n'existe pas.

Exigences :

Maxthon version 1.0+

Exemple :

external.close_tab(security_id, );

readFile(security_id, plugin_name, file_name)

Paramètres :

security_id : chaîne
ID de sécurité de Maxthon.

plugin_name : chaîne
Le nom du Plugin appelé indiqué dans le fichier plugin.ini

file_name : chaîne
Le ficher à lire.

Remarques :

Cette fonction peut seulement être utilisée dans un Plugin.
 La fonction retournera le contenu du fichier dans une chaîne en cas de succès.
 Si le Plugin n'est pas actif ou que le plugin_name n'est pas trouvé, la fonction échouera et retournera null.

Exigences :

Maxthon version 1.0+

Exemple :

var strFile=external.readFile(security_id, "Test plugin", "plugin.ini");

writeFile(security_id, plugin_name, file_name, content)

Paramètres :

security_id : chaîne
ID de sécurité de Maxthon.

plugin_name : chaîne
Le nom du Plugin appelant comme indiqué dans le fichier plugin.ini

file_name : chaîne
Le fichier à écrire.

content : chaîne
Chaîne du contenu du fichier à écrire.

Remarques :

Cette fonction ne peut être utilisée que dans un Plugin.
 Cette fonction retournera vrai en cas de succès.
 Si le fichier n'est pas trouvé, le plugin n'est pas actif ou le plugin_name n'est pas trouvé, la fonction échouera et retournera faux.
Si un fichier avec le même nom existe, il sera écrasé.

Exigences :

Maxthon version 1.0+

Exemple :

external.writeFile(security_id, "Test plugin", "setting.ini", "username=abc\npass=qwrxcv");

m2_readIni(security_id, plugin_name, file_name, section_name, key, default_value)

Paramètres :

security_id : chaîne
ID de sécurité de Maxthon.

plugin_name : chaîne
Le nom du Plugin appelant comme indiqué dans le fichier plugin.ini.

file_name : chaîne
Le nom du fichier INI à lire.

section_name : chaîne
La section INI à lire, sans crochet [ ].

key : chaîne
La clé de l'entrée à lire.

default_value : chaîne
La valeur par défaut à retourner si la clé n'existe pas.

Remarques :

Cette fonction lira la valeur de la key sous la section section_name dans le fichier INI file_name.
 Le fichier INI doit se trouver dans le dossier du Plugin plugin_name.
 La valeur sera retournée sous la forme d'une string en cas de succès.
 Si le fichier n'existe pas, la section n'existe pas ou la clé n'existe pas, la default_value sera retournée.

Exigences :

Maxthon version 1.0+

Exemple :

var saveCount = external.m2_readIni(security_id, "TestPlugin", "settings.ini", "general", "saveCount", "0");

m2_writeIni(security_id, plugin_name, file_name, section_name, key, value)

Paramètres :

security_id : chaîne
ID de sécurité de Maxthon.

plugin_name : chaîne
Le nom du Plugin appelant comme indiqué dans le fichier plugin.ini.

file_name : chaîne
Le nom du fichier INI à écrire.

section_name : chaîne
La section INI à écrire, sans crochet [ ].

key : chaîne
La clé de l'entrée à écrire.

value : chaîne/entier
La valeur à écrire.

Remarques :

Cette fonction écrira une key et une paire de value sous la section section_name dans le fichier INI file_name.
 Le fichier INI ne peut être écrit que dans le dossier du Plugin plugin_name.
 Si le fichier n'existe pas, la section n'existe pas ou la clé n'existe pas, ils seront créés automatiquement.
 Cette fonction retournera vrai en cas de succès et faux en cas d'échec.

Exigences :

Maxthon version 1.0+

Exemple :

external.m2_writeIni(security_id, "TestPlugin", "settings.ini", "general", "saveCount", 25);

Base de connaissances de Maxthon 2.0