beautypg.com

Livedatatranslatemarkup() – Adobe Extending Dreamweaver CS4 User Manual

Page 352

background image

346

EXTENDING DREAMWEAVER CS4

Data translators

function translateMarkup(docName, siteRoot, docContent){

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

}

For an all-JavaScript example, see

A simple attribute translator example

” on page 336 or “

A simple block/tag

translator example

” on page 339.

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
docName, siteRoot, docContent

The docName argument is a string that contains the file:// URL for the document to be translated.

The siteRoot 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 docContent 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;

}

This manual is related to the following products: