new EmptyMelObject()
Constructeur de la classe
Extends
Members
-
package _listener :MelEventManager
-
- Overrides:
-
package rc_data :Object
-
- Overrides:
Methods
-
add_event_listener(key, callback, param2)
-
Ajoute un écouteur qui pourra être appelé plus tard.
Parameters:
Name Type Description key
string Clé qui permettra d'appeller l'écouteur callback
function Fonction qui sera appelée param2
Object Si on doit récupérer rcmail sur frame principale ou non Properties
Name Type Attributes Description callback_key
string <nullable>
Clé du callback condition
boolean Si on doit éxécuter ou non le listener - Overrides:
-
async change_frame(frame, param1) → {Promise:.<void:>}
-
Change de page
Parameters:
- Overrides:
- Deprecated:
- Utilisez plutôt switch_frame
-
cookie_get(key) → {module:Cookies.Cookie}
-
Récupère un cookie
Parameters:
Name Type Description key
string Indentifiant de la donnée Returns:
module:Cookies.Cookie- Overrides:
-
cookie_remove(key) → {module:Cookies.Cookie}
-
Supprime un cookie
Parameters:
Name Type Description key
string Indentifiant du cookie à supprimer Returns:
module:Cookies.Cookie - Cookie supprimer- Overrides:
-
cookie_set(key, name, expire) → {module:Cookies.Cookie}
-
Insert un cookie
Parameters:
Name Type Default Description key
string Clé qui permet d'identifier la données mise en cookie name
string Donnée à mettre en cookie expire
Date | false false Date d'expiration, false pour aucune Returns:
module:Cookies.Cookie - Cookie créer- Overrides:
-
copy_to_clipboard(elementToCopy, optionsopt) → {EmptyMelObject}
-
Copie un texte dans le press(papier)
Parameters:
Name Type Attributes Default Description elementToCopy
string Texte à mettre dans le presse papier options
Object <optional>
{} Properties
Name Type Attributes Default Description text
string <optional>
<nullable>
null Texte à afficher lorsque la copie a été effectuée Returns:
EmptyMelObject - Chaînage- Overrides:
-
async create_promise(callback, …args) → {Mel_Promise}
-
(async) Créer une promesse "Mel" qui contient des fonctionnalités en plus
Parameters:
Name Type Attributes Description callback
args
any <repeatable>
Arguments du callback Returns:
Mel_Promise- Overrides:
-
generate_loader(id, absoluteCenterednon-null) → {mel_html}
-
Génère un loader du bnum
Parameters:
Name Type Default Description id
string id du loader absoluteCentered
boolean true Centrer verticalement et horizontalement ? Returns:
mel_html- Overrides:
-
get_custom_rules() → {Mel_CSS_Style_Sheet}
-
Récupère un objet Mel_CSS_Style_Sheet pour ajouter du css custom
Returns:
Mel_CSS_Style_Sheet- Overrides:
-
get_env(key) → nullable {any}
-
Récupère une variable d'environnement de roundcube
Parameters:
Name Type Description key
string Nom de la variable Returns:
any- Overrides:
-
get_skin() → {Mel_Elastic}
-
Récupère l'objet UI de la skin elastic
Returns:
Mel_Elastic- Overrides:
-
gettext(key_text, pluginnon-null) → {string}
-
Récupère une clé sous forme de texte.
Parameters:
Name Type Description key_text
string Clé plugin
string Plugin d'où provient le texte traduit Returns:
string- Overrides:
-
have_frame(frame) → {boolean}
-
Vérifie si une frame est déjà chargée ou non
Parameters:
Name Type Description frame
string Nom de la frame Returns:
boolean- Overrides:
-
http_call(options) → {Mel_Ajax}
-
Effectue un appel ajax avec les options spécifiées.
Parameters:
Name Type Description options
Object Les options pour l'appel HTTP. Properties
Name Type Attributes Default Description url
string L'URL à appeler. on_success
function <optional>
() => {} La fonction à appeler en cas de succès. on_error
function <optional>
(...args) => {console.error('###[http_call]', ...args)} La fonction à appeler en cas d'erreur. params
Object <optional>
null Les paramètres à envoyer dans la requête. type
string <optional>
'POST' Le type de requête HTTP à effectuer. Returns:
Mel_Ajax- Overrides:
-
http_internal_call(options) → {Mel_Ajax}
-
Effectue un appel ajax vers les serveurs de l'application
Parameters:
Name Type Description options
Object Les options pour l'appel HTTP. Properties
Name Type Attributes Default Description task
string Tache action
string Action on_success
function <optional>
() => {} La fonction à appeler en cas de succès. on_error
function <optional>
(...args) => {console.error('###[http_call]', ...args)} La fonction à appeler en cas d'erreur. params
Object <optional>
null Les paramètres à envoyer dans la requête. type
string <optional>
'POST' Le type de requête HTTP à effectuer. Returns:
Mel_Ajax- Overrides:
-
http_internal_get(options) → {Mel_Ajax}
-
Effectue un appel ajax GET vers les serveurs de l'application
Parameters:
Name Type Description options
Object Les options pour l'appel HTTP. Properties
Name Type Attributes Default Description task
string Tache action
string Action on_success
function <optional>
() => {} La fonction à appeler en cas de succès. on_error
function <optional>
(...args) => {console.error('###[http_call]', ...args)} La fonction à appeler en cas d'erreur. params
Object <optional>
null Les paramètres à envoyer dans la requête. Returns:
Mel_Ajax- Overrides:
-
http_internal_post(options) → {Mel_Ajax}
-
Effectue un appel ajax POST vers les serveurs de l'application
Parameters:
Name Type Description options
Object Les options pour l'appel HTTP. Properties
Name Type Attributes Default Description task
string Tache action
string Action on_success
function <optional>
() => {} La fonction à appeler en cas de succès. on_error
function <optional>
(...args) => {console.error('###[http_call]', ...args)} La fonction à appeler en cas d'erreur. params
Object <optional>
null Les paramètres à envoyer dans la requête. Returns:
Mel_Ajax- Overrides:
-
isNullOrUndefined(itemnullable) → {boolean}
-
Renvoie vrai si la variable vaut `null` ou `undefined`.
Parameters:
Name Type Attributes Description item
any <nullable>
Variable à tester Returns:
boolean- Overrides:
-
load(key, default_valuenullable) → nullable {any}
-
Charge des données dans le stockage local
Parameters:
Name Type Attributes Default Description key
string Clé qui permet de retrouver les données default_value
any <nullable>
null Valeur par défaut si la donnée n'éxiste pas Returns:
any- Overrides:
-
abstract main(…args)
-
Parameters:
Name Type Attributes Description args
any <repeatable>
Arguments de la fonction - Overrides:
-
on_frame_loaded(callback, options)
-
Action à faire lorsqu'une frame est chargée
Parameters:
Name Type Description callback
function Function à éffectuer options
Object Options de la fonction Properties
Name Type Attributes Description frame
string <nullable>
any pour toute n'importe quelle frame, sinon mettre le nom de la frame condition
function <nullable>
Condition custom pour charger la frame - Overrides:
-
on_frame_refresh(callback, frame, param2)
-
Ajoute une action à faire lorsqu'une frame est mise à jours
Parameters:
Name Type Attributes Description callback
function Callback a=à appelé au refresh frame
string Nom de la frame param2
Object options.callback_key
string <nullable>
clé qui permet de supprimer/remettre la fonction au refresh d'une frame - Overrides:
-
on_refresh(callback, options)
-
Ajoute une action à faire lors du refresh du bnum
Parameters:
Name Type Description callback
function Fonction à appeller options
Object Options de la fonction Properties
Name Type Attributes Description callback_key
string <nullable>
clé qui permet de supprimer/remettre la fonction au refresh d'une frame - Overrides:
-
rcmail(top) → {rcube_webmail}
-
Récupère "rcmail" | les fonctions utiles à roundcube
Parameters:
Name Type Default Description top
boolean false Si on doit récupérer rcmail sur frame principale ou non Returns:
rcube_webmail- Overrides:
-
save(key, contents) → {MelObject}
-
Sauvegarde des données dans le stockage local
Parameters:
Name Type Description key
string Clé qui permettra de retrouver les données sauvegarder contents
* Données qui seront sauvegarder Returns:
MelObject - Chaînage- Overrides:
-
select(selector) → {external:jQuery}
-
Séléctionne un document dom au format jquery
Parameters:
Name Type Description selector
string Selecteur au format jquery Returns:
external:jQuery- Overrides:
-
select_frame(frame) → {external:jQuery}
-
Selectionne une frame
Parameters:
Name Type Description frame
string Nom de la frame Returns:
external:jQuery- Overrides:
-
generator select_frame_except(…frames) → {Generator:.<Node:>}
-
Selectionne toutes les frames qui ne sont pas parmis les frames définie en arguments
Parameters:
Name Type Attributes Description frames
string <repeatable>
Frames à écarter - Overrides:
-
send_notification(notification)
-
Envoie une notification BNUM
Parameters:
Name Type Description notification
* - Overrides:
-
async sleep(ms) → {Mel_Promise}
-
(async) Attend x millisecondes
Parameters:
Name Type Description ms
number Temps en millisecondes Returns:
Mel_Promise- Overrides:
-
async switch_frame(task, options) → {Promise}
-
Change de frame
Parameters:
Name Type Description task
string Nom de la tâche options
Object Properties
Name Type Attributes Default Description changepage
boolean <optional>
true Si l'on change de page ou si la frame reste caché pendant le chargement. args
Object:.<string:, *:> <optional>
<nullable>
null Options du changement de frame. Si la frame est déjà ouverte, force le changement d'url. Returns:
Promise- Overrides:
-
trigger_event(key, args) → {MelEventManager}
-
Trigger un écouteur
Parameters:
Name Type Description key
string Clé qui appelera tout les écouteurs lié à cette clé args
any Arguments qui sera donnée aux écouteurs Returns:
MelEventManager- Overrides:
-
unload(key)
-
Décharge une donnée dans le stockage local
Parameters:
Name Type Description key
string clé dans le stockage - Overrides:
-
url(task, param1, Autresnullable) → {string}
-
Récupère une url à partir d'une tâche et d'une action
Parameters:
Name Type Attributes Description task
string Nom de la tâche param1
Object action => Nom de l'action ('index' si non renseigné), params => Autres paramètres Properties
Name Type Description action
string => Nom de l'action (index si non renseigné) Autres
Object:.<string:, string:> <nullable>
paramètres Returns:
string- Overrides:
-
async wait_something(callback, optionsopt) → {WaitSomething|WaitSomethingAsync}
-
(async) Attend qu'une condtion soit valide
Parameters:
Name Type Attributes Default Description callback
options
Object <optional>
{} Properties
Name Type Attributes Default Description timeout
number <optional>
5 Au bout de combien de secondes la boucle s'arrête - Overrides: