Macromedia dreamweaver 8-extending dreamweaver Benutzerhandbuch

The Data Translator API

453

7.

The 

 string specifies when this translator executes. The following list gives the 

possible string values: 

8.

The 

 string specifies the default priority for running this translator. The priority 

is a number between 

0

 and 

100

. If you do not specify a priority, the default priority is 

100

. 

The highest priority is 

0

, and 

100

 is the lowest. When multiple translators apply to a 

document, this setting controls the order in which the translators are applied. The highest 
priority is applied first. When multiple translators have the same priority, they are applied 
in alphabetical order by 

translatorClass

. 

Example

The following instance of the 

getTranslatorInfo()

 function gives information about a 

translator for server-side includes:

function getTranslatorInfo(){

var transArray = new Array(11);

  

transArray[0] = "SSI";
transArray[1] = "Server-Side Includes";
transArray[2] = "4";
transArray[3] = "htm";
transArray[4] = "stm";
transArray[5] = "html";
transArray[6] = "shtml";
transArray[7] = "2";
transArray[8] = "<!--#include file";
transArray[9] = "<!--#include virtual";
transArray[10] = "byExtension";

String

Definition

"allFiles"

Sets the translator to always execute.

"noFiles"

Sets the translator to never execute.

"byExtension"

Sets the translator to execute for files that have one of the file 
extensions that are specified in the extension.

"byExpression"

Sets the translator to execute if the document contains a match 
for one of the specified regular expressions.

"bystring"

Sets the translator to execute if the document contains a match 
for one of the specified strings.

NO

TE

If you set 

 to "byExtension" but do not specify any extensions (see step 

4.), the effect is the same as setting "allFiles". If you set 

 to 

"byExpression"

 but do not specify any expressions (see step 6.), the effect is the 

same as setting "noFiles".