Script liens.js

Le script liens.js permet d'insèrer dans la page Web un lien sur un texte, un bouton, une image simple ou une image dynamique ("rollover").

Le script distingue les liens classiques (page Web) et les liens vers une adresse e-mail (préfixe mailto:). Pour ces deux types de liens, quatre fonctions permettent d'insérer un lien sur une portion de texte, une image, un bouton de formulaire ou une image dynamique. Les fonctions retournent le code HTML du lien à insérer ; il suffit d'écrire ce code dans la page Web à l'aide de la fonction document.write().

Pour un lien vers une page Web, l'utilisateur doit spécifier :

• le texte du lien, le texte du bouton ou l'emplacement de l'image ou des images du lien ;
• l'URL (absolue ou relative) de la page Web vers laquelle doit pointer le lien ;
• éventuellement, la cible du lien ;
• éventuellement, un commentaire à afficher dans la barre d'état.

La cible du lien est le nom de la fenêtre dans laquelle la page Web du lien va s'afficher. En plus des fenêtres définies par l'utilisateur, les valeurs spéciales ci-dessous sont possibles :

• _self : lien vers le cadre courant (par défaut) ;
• _blank : lien vers une nouvelle fenêtre ;
• _parent : lien vers le premier cadre parent ;
• _top : lien vers le cadre de base (permet de "sortir" des cadres).

Pour un lien vers une adresse e-mail, l'utilisateur doit spécifier :

• le texte du lien, le texte du bouton ou l'emplacement de l'image ou des images du lien ;
• le nom de l'adresse e-mail du destinataire (forme nom@domaine) ;
• le domaine de l'adresse e-mail du destinataire (forme nom@domaine) ;
• éventuellement, le sujet de l'e-mail ;
• éventuellement, un commentaire à afficher dans la barre d'état.

Les fonctions retournant un lien vers une adresse e-mail utilisent un mécanisme anti-spam, pour protéger cette adresse face aux robots de spam.

Depuis :

JsLib 1.0

formaterMailtoAntiSpam

chaîne formaterMailtoAntiSpam(chaîne nom_email, chaîne domaine_email)

Formate une adresse e-mail de manière à la protéger contre le spam. Retourne une chaîne de la forme nom%40domaine. Le caractère héxadécimal %40 correspond au caractère arrobe (@). Il est interprèté correctement par les navigateurs Web mais ignoré des robots de spam.

Paramètres :

nom_email - le nom de l'adresse e-mail à formater (adresse de la forme nom@domaine).

domaine_email - le domaine de l'adresse e-mail à formater (adresse de la forme nom@domaine).

Retourne :

une chaîne contenant l'adresse e-mail formatée.

lienBoutonEmail

chaîne lienBoutonEmail(chaîne texte, chaîne nom_email, chaîne domaine_email, chaîne sujet, chaîne commentaire)

Insère un lien vers l'adresse e-mail spécifiée, sur le bouton de texte spécifié. Si le paramètre sujet est omis, le message n'aura pas de sujet à priori. Si le paramètre commentaire est omis, le navigateur affiche l'URL du lien dans la barre d'état lorsque la souris pointe sur le lien.

Paramètres :

texte - le texte à afficher sur le bouton du lien.

nom_email - le nom de l'adresse e-mail du destinataire (adresse de la forme nom@domaine).

domaine_email - le domaine de l'adresse e-mail du destinataire (adresse de la forme nom@domaine).

sujet - le sujet de l'e-mail (facultatif).

commentaire - le texte à afficher dans la barre d'état lorsque la souris pointe sur le lien (facultatif).

Retourne :

une chaîne de code HTML correspondant à un lien vers l'adresse e-mail spécifiée.

lienBoutonWeb

chaîne lienBoutonWeb(chaîne texte, chaîne url, chaîne cible, chaîne commentaire)

Insère un lien vers la page Web d'URL spécifiée, sur le bouton de texte spécifié. Si le paramètre cible est omis, la page Web du lien remplace la page Web courante. Si le paramètre commentaire est omis, le navigateur affiche l'URL du lien dans la barre d'état lorsque la souris pointe sur le lien.

Paramètres :

texte - le texte à afficher sur le bouton du lien.

url - l'URL (absolue ou relative) de la page Web vers laquelle doit pointer le lien.

cible - le nom de la fenêtre dans laquelle la page Web du lien doit s'afficher (facultatif).

commentaire - le texte à afficher dans la barre d'état lorsque la souris pointe sur le lien (facultatif).

Retourne :

une chaîne de code HTML correspondant à un lien vers la page Web d'URL spécifiée.

lienDynaEmail

chaîne lienDynaEmail(chaîne imageOut, chaîne imageOver, chaîne nom_email, chaîne domaine_email, chaîne sujet, chaîne commentaire)

Insère un lien vers l'adresse e-mail spécifiée sur une image dynamique. Une image dynamique, ou "rollover", est une image qui change d'apparence lorsque la souris passe dessus. Elle se compose de deux images simples, dont les URL doivent être spécifiées ici. Si le paramètre sujet est omis, le message n'aura pas de sujet à priori. Si le paramètre commentaire est omis, le navigateur affiche l'URL du lien dans la barre d'état lorsque la souris pointe sur le lien.

Paramètres :

imageOut - l'URL de l'image à afficher par défaut.

imageOver - l'URL de l'image à afficher lorsque la souris passe sur le lien.

nom_email - le nom de l'adresse e-mail du destinataire (adresse de la forme nom@domaine).

domaine_email - le domaine de l'adresse e-mail du destinataire (adresse de la forme nom@domaine).

sujet - le sujet de l'e-mail (facultatif).

commentaire - le texte à afficher dans la barre d'état lorsque la souris pointe sur le lien (facultatif).

Retourne :

une chaîne de code HTML correspondant à un lien vers l'adresse e-mail spécifiée.

lienDynaWeb

chaîne lienDynaWeb(chaîne imageOut, chaîne imageOver, chaîne url, chaîne cible, chaîne commentaire)

Insère un lien vers la page Web d'URL spécifiée sur une image dynamique. Une image dynamique, ou "rollover", est une image qui change d'apparence lorsque la souris passe dessus. Elle se compose de deux images simples, dont les URL doivent être spécifiées ici. Si le paramètre cible est omis, la page Web du lien remplace la page Web courante. Si le paramètre commentaire est omis, le navigateur affiche l'URL du lien dans la barre d'état lorsque la souris pointe sur le lien.

Paramètres :

imageOut - l'URL de l'image à afficher par défaut.

imageOver - l'URL de l'image à afficher lorsque la souris passe sur le lien.

url - l'URL (absolue ou relative) de la page Web vers laquelle doit pointer le lien.

cible - le nom de la fenêtre dans laquelle la page Web du lien doit s'afficher (facultatif).

commentaire - le texte à afficher dans la barre d'état lorsque la souris pointe sur le lien (facultatif).

Retourne :

une chaîne de code HTML correspondant à un lien vers la page Web d'URL spécifiée.

lienImageEmail

chaîne lienImageEmail(chaîne image, chaîne nom_email, chaîne domaine_email, chaîne sujet, chaîne commentaire)

Insère un lien vers l'adresse e-mail spécifiée, sur l'image d'URL spécifiée. Si le paramètre sujet est omis, le message n'aura pas de sujet à priori. Si le paramètre commentaire est omis, le navigateur affiche l'URL du lien dans la barre d'état lorsque la souris pointe sur le lien.

Paramètres :

image - l'URL de l'image à transformer en lien.

nom_email - le nom de l'adresse e-mail du destinataire (adresse de la forme nom@domaine).

domaine_email - le domaine de l'adresse e-mail du destinataire (adresse de la forme nom@domaine).

sujet - le sujet de l'e-mail (facultatif).

commentaire - le texte à afficher dans la barre d'état lorsque la souris pointe sur le lien (facultatif).

Retourne :

une chaîne de code HTML correspondant à un lien vers l'adresse e-mail spécifiée.

lienImageWeb

chaîne lienImageWeb(chaîne image, chaîne url, chaîne cible, chaîne commentaire)

Insère un lien vers la page Web d'URL spécifiée, sur l'image d'URL spécifiée. Si le paramètre cible est omis, la page Web du lien remplace la page Web courante. Si le paramètre commentaire est omis, le navigateur affiche l'URL du lien dans la barre d'état lorsque la souris pointe sur le lien.

Paramètres :

image - l'URL de l'image à transformer en lien.

url - l'URL (absolue ou relative) de la page Web vers laquelle doit pointer le lien.

cible - le nom de la fenêtre dans laquelle la page Web du lien doit s'afficher (facultatif).

commentaire - le texte à afficher dans la barre d'état lorsque la souris pointe sur le lien (facultatif).

Retourne :

une chaîne de code HTML correspondant à un lien vers la page Web d'URL spécifiée.

lienTexteEmail

chaîne lienTexteEmail(chaîne texte, chaîne nom_email, chaîne domaine_email, chaîne sujet, chaîne commentaire)

Insère un lien vers l'adresse e-mail spécifiée, sur le texte spécifié. Si le paramètre sujet est omis, le message n'aura pas de sujet à priori. Si le paramètre commentaire est omis, le navigateur affiche l'URL du lien dans la barre d'état lorsque la souris pointe sur le lien.

Paramètres :

texte - la portion de texte à transformer en lien.

nom_email - le nom de l'adresse e-mail du destinataire (adresse de la forme nom@domaine).

domaine_email - le domaine de l'adresse e-mail du destinataire (adresse de la forme nom@domaine).

sujet - le sujet de l'e-mail (facultatif).

commentaire - le texte à afficher dans la barre d'état lorsque la souris pointe sur le lien (facultatif).

Retourne :

une chaîne de code HTML correspondant à un lien vers l'adresse e-mail spécifiée.

lienTexteWeb

chaîne lienTexteWeb(chaîne texte, chaîne url, chaîne cible, chaîne commentaire)

Insère un lien vers la page Web d'URL spécifiée, sur le texte spécifié. Si le paramètre cible est omis, la page Web du lien remplace la page Web courante. Si le paramètre commentaire est omis, le navigateur affiche l'URL du lien dans la barre d'état lorsque la souris pointe sur le lien.

Paramètres :

texte - la portion de texte à transformer en lien.

url - l'URL (absolue ou relative) de la page Web vers laquelle doit pointer le lien.

cible - le nom de la fenêtre dans laquelle la page Web du lien doit s'afficher (facultatif).

commentaire - le texte à afficher dans la barre d'état lorsque la souris pointe sur le lien (facultatif).

Retourne :

une chaîne de code HTML correspondant à un lien vers la page Web d'URL spécifiée.