Configuration

Sommaire

  1. Variable de configuration
  2. Fonction setApijsLang
  3. Fonction setApijsConfig
  4. Fonction setApijsRewrites

Variable de configuration

La configuration suivante correspond à la configuration par défaut.

var apijs = {
   config: {
      # langue de l'application
      ## Allemand (DE), Anglais (EN), Espagnol (ES),
      ## Français (FR), Italien (IT), Portugais (PT), Russe (RU)
      ## auto: utilise si possible la langue de la page web, sinon l'anglais
      ## auto-fr: utilise si possible la langue de la page web, sinon le français
      ## fr: définit la langue en français
      lang: 'auto',
      # active le mode debug
      debug: false,
      # TheDialog
      dialog: {
         # active la fermeture du dialogue lors d'un clic en dehors
         closeOnClick: false,
         # active la restriction de la navigation dans la boîte de dialogue
         restrictNavigation: true
      },
      # TheSlideshow
      slideshow: {
         # préfixe des identifiants (id) des conteneurs des albums
         ids: 'slideshow',
         # active la mise à jour de l'ancre dans l'url
         anchor: true
      },
      # TheUpload
      upload: {
         tokenName: 'authenticity_token',
         tokenValue: null
      }
   }
};

En plus de contenir la configuration, cette variable contient également toute l'application JavaScript.

Fonction setApijsLang

Cette fonction est automatiquement appelée lorsqu'elle est définie, et permet d'ajouter une nouvelle langue. Lorsqu'un mot-clef n'existe pas dans le jeu de traduction de la langue courante, il sera recherché dans le jeu de traduction en anglais.

function setApijsLang() {
   apijs.i18n.data.xy = {};
   apijs.i18n.data.xy.buttonCancel = 'xyz';
   apijs.config.lang = 'xy';
}

Attention : l'appel à cette fonction n'est pas « catché » avec try {...} catch (e) { }.

Fonction setApijsConfig

Cette fonction est appelée automatiquement lorsqu'elle est définie, et permet de modifier la configuration.

function setApijsConfig() {
   apijs.config.debug = true;
   apijs.config.dialog.closeOnClick = true;
}

Attention : l'appel à cette fonction n'est pas « catché » avec try {...} catch (e) { }.

Fonction setApijsRewrites

Cette fonction est appelée automatiquement lorsqu'elle est définie, et permet de modifier le comportement par défaut.

En effet, si vous souhaitez modifier le comportement d'une fonctionnalité, il est possible de surcharger les méthodes du cœur, afin de les réécrire à votre guise. L'exemple suivant réécrit la méthode qui définit le titre des boîtes de dialogue afin d'afficher une alert.

function setApijsRewrites() {
   apijs.dialog.htmlTitle = function (title) {
       alert(title);
   };
}

Attention : l'appel à cette fonction n'est pas « catché » avec try {...} catch (e) { }.