Langage de programmation - ColdFusion (CFML) - Référence des balises

CFAJAXIMPORT	Importe l'AJAX
ColdFusion 8+ (CFML)

Syntaxe

<CFAJAXIMPORT paramètres>

Paramètres

Nom	Description
cssSrc=value	Ce paramètre de balise optionnel permet d'indiquer l'URL, par rapport à la racine Web, du répertoire contenant les fichiers CSS utilisés par les fonctionnalités AJAX de ColdFusion, à l'exception de l'éditeur de texte enrichi. Ce répertoire doit avoir la même structure de répertoires et contenir les mêmes fichiers CSS et fichiers image requis par les fichiers CSS que le répertoire web_root/CFIDE/scripts/ajax/resources. Ce paramètre vous permet de créer différents styles personnalisés pour les contrôles AJAX de ColdFusion dans différentes applications.
params=value	Ce paramètre de balise optionnel permet d'indiquer les paramètres pour la page CFM. Actuellement, le seul paramètre que vous pouvez spécifier est googlemapkey. Vous pouvez spécifier la clef googlemap comme suit : «<cfajaximport params=#{googlemapkey="Map API Key"}#>».
scriptSrc=value	Ce paramètre de balise optionnel permet d'indiquer l'URL, par rapport à la racine Web, du répertoire contenant les fichiers de script côté client utilisés par ColdFusion. Ce répertoire comprend les fichiers JavaScript et l'emplacement par défaut des fichiers CSS utilisés pour toutes les fonctionnalités AJAX. Si vous utilisez ce paramètre, la balise cfajaximport doit précéder toutes les autres balises AJAX de ColdFusion dans la page. C'est-à-dire toutes les balises reposant sur les scripts. Vous ne pouvez avoir qu'un seul paramètre scriptsrc sur une page, dans une balise cfajaximport ou une balise cfform. Vous pouvez utiliser un paramètre scriptsrc dans une balise cfajaximport pour appliquer sa valeur à tous les formulaires d'une page.
tags=value	Ce paramètre de balise optionnel permet d'indiquer la liste de balises ou combinaisons de paramètres de balises délimitées par des virgules pour lesquelles importer les fichiers JavaScript pris en charge sur cette page. Si vous utilisez ce paramètre, il doit spécifier toutes les balises AJAX de ColdFusion que vous utilisez sur la page et sur les pages spécifiées dans les paramètres de source de balise.

Description

Cette balise permet d'indiquer le contrôle des fichiers JavaScript étant importé pour être utilisé dans une balise AJAX de ColdFusion.

Remarques

Le paramètre scriptSrc est utile si les fichiers JavaScript ne sont pas à l'emplacement par défaut. Le paramètre est requis dans certains environnements et configurations d'hébergement bloquant l'accès au répertoire /CFIDE. La valeur par défaut de scriptSrc est déterminée par le paramètre Default CFFORM ScriptSrc Director de la page «Server Settings > Settings» de l'administrateur ColdFusion. Pour les balises cfform, le paramètre scriptSrc de la balise est prioritaire à ce paramètre.
Vous pouvez utiliser le paramètre scriptSrc uniquement si la balise cfajaximport est sur une page de niveau supérieur. C'est-à-dire une page que le client demande directement. Vous ne pouvez pas l'utiliser, par exemple, sur une page spécifiée dans un paramètre source de balise cfwindow.
Lorsque vous utilisez la balise cfajaximport avec un paramètre scriptSrc, le répertoire spécifié doit avoir la même structure que le répertoire «/CFIDE/scripts». Par exemple, si vous spécifiez «scriptsrc="/resources/myScripts"», les fichiers JavaScript utilisés par AJAX doivent figurer dans le répertoire «/resources/myScripts/ajax». Ce paramètre spécifie le dossier contenant les fichiers côté client ColdFusion pour toutes les balises suivantes de la page en cours, pas seulement pour les balises basées sur AJAX. Par conséquent, l'arborescence de répertoires doit inclure tous les fichiers côté client ColdFusion utilisés par ces balises. Par exemple, si une balise cfform sur la page est au format Flash ou au format applet, vous devriez inclure le fichier CF_RunActiveContent.js dans le répertoire spécifié par le paramètre scriptSrc.
Vous utilisez le paramètre cssSrc pour spécifier l'emplacement des fichiers CSS requis par les fonctionnalités AJAX de ColdFusion. Ce paramètre remplace le répertoire scriptsrc/ajax/resources pour la page en cours. Par conséquent, si toutes les pages utilisant un répertoire scriptSrc personnalisé utilisent également un répertoire cssSrc personnalisé, vous n'avez pas besoin d'inclure les fichiers CSS du AJAX de ColdFusion dans l'arborescence du répertoire scriptSrc.

Voir également

Dernière mise à jour : Vendredi, le 26 décembre 2014

Section courante

A propos

Section administrative du site

CFAJAXIMPORT

Syntaxe

Paramètres

Description

Remarques

Voir également