canRecognizeDocument()

Disponibilité

Dreamweaver MX.

Description

Lors de l'ouverture d'un document (et lorsque plusieurs modèles de serveur revendiquent une extension de fichier), Dreamweaver appelle cette fonction pour chacun des modèles de serveur associés à l'extension afin de voir si l'une des fonctions peut établir que le document lui appartient. Si plusieurs modèles de serveur revendiquent l'extension de fichier, Dreamweaver accorde la priorité à celui renvoyant le nombre entier le plus élevé.

Arguments

dom

• L'argument dom correspond à l'objet de document Macromedia, renvoyé par la fonction dreamweaver.getDocumentDOM().

Valeurs renvoyées

Dreamweaver attend un nombre entier indiquant la priorité que vous accordez au modèle de serveur pour l'extension de fichier. Cette fonction doit renvoyer la valeur -1 si le modèle de serveur ne revendique pas l'extension de fichier ; dans les autres cas de figure, elle doit renvoyer une valeur supérieure à zéro.

Exemple

Dans l'exemple suivant, si l'utilisateur ouvre un document JavaScript pour le modèle de serveur en cours, le code renvoie la valeur 2. Cette valeur permet au modèle de serveur courant d'être prioritaire sur le modèle de serveur par défaut de Dreamweaver.

var retVal = -1;
var langRE = /@\s*language\s*=\s*(\"|\')?javascript(\"|\')?/i;
// Search for the string language="javascript"
var oHTML = dom.documentElement.outerHTML;
if (oHTML.search(langRE) > -1)
   retVal = 2;
return retVal;