Macromedia dreamweaver 8-extending dreamweaver User Manual

The Data Translator API

455

liveDataTranslateMarkup()

Availability

Dreamweaver UltraDev 1.

Description

This function translates documents when users are using the Live Data window. When the 
user selects the View > Live Data command or clicks the Refresh button, Dreamweaver calls 
the 

liveDataTranslateMarkup()

 function instead of the 

translateMarkup()

 function. 

Arguments

, 

, 

■

The 

 argument is a string that contains the file:// URL for the document to 

be translated.

■

The 

 argument is a string that contains the file:// URL for the root of the site 

that contains the document to be translated. If the document is outside a site, this string 
might be empty.

■

The 

 argument is a string that contains the contents of the document.

Returns

A string that contains the translated document or an empty string if nothing is translated.

Example

The following instance of the 

liveDataTranslateMarkup()

 function calls the C function 

translateASP()

, which is contained in a DLL (Windows) or a code library (Macintosh) 

called ASPTrans:

function liveDataTranslateMarkup(docName, siteRoot, docContent){

var translatedString = "";
if (docContent.length > 0){
translatedString = ASPTrans.translateASP(docName, siteRoot, docContent);
}
return translatedString;

}