Hyperliens

Description

La création d’un hyperlien peut s’effectuer de plusieurs façons avec ARender mais a toujours besoin des mêmes éléments pour leur création. Tout d’abord le texte sélectionné qui sera le texte cliquable de l’hyperlien, puis il faudra une cible qui peut être un numéro de page du document courant ou bien un URL.

Utilisations

Menu contextuel

Tout d’abord, sélectionner le texte qui sera l’hyperlien. Puis faite clique-droit et cliquer sur l’option Créer un lien.

Ensuite une fenêtre apparait où vous devez choisir le type de lien, soit une URL soit un numéro de page du document courant.

Une fois le choix fait, appuyer sur Valider. L’hyperlien vient d’être créé.

Depuis la version 4.8.0

Bouton de création

Un bouton est disponible dans le toppanel pour la création d’hyperlien. Ce bouton est désactivé par défaut. Il est également possible de faire la création d’hyperlien répété.

topPanel.annotationMenu.hyperlink=true
topPanel.annotationMenu.hyperlink.repeat=true

Au clique du bouton, il vous sera demandé de sélectionner le texte où l’hyperlien se trouvera.

Après la sélection, le curseur de la souris se transforme en cible pour vous indiquer qu’une cible est nécessaire à l’hyperlien.

Cliquer sur la page du document courant que vous choisissez comme cible. L’hyperlien vient d’être créé.

Javascript API

Il est possible de fournir une cible depuis l’extérieur d’ARender avec du javascript. Pour ce faire, vous devez enregistrer une fonction qui sera exécutée au moment où ARender entre ou sort du mode sélection de cible.

    var waitingTarget = false;

    function arenderjs_init(arenderjs_)
    {
        arenderjs_.registerNotifyHyperlinkToggleTargetModeEvent(function(activated){
            if(activated)
            {
                waitingTarget = true;
            }
            else
            {
                waitingTarget = false;
            }
        });
    }

Ensuite, il faudra une fonction permettant d’envoyer la cible à ARender lorsque le mode sélection de cible est activé.

   function armt_notifyHyperlinkTarget(target)
    {
        if(waitingTarget)
        {
            getARenderJS().notifyHyperlinkTarget(target);
            waitingTarget = false;
        } 
    }