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) { }.