Dreamweaver.livedatatranslate() – Adobe Dreamweaver API Reference CS5 User Manual
Page 357
352
DREAMWEAVER API REFERENCE
Dynamic documents
Last updated 8/27/2013
•
In the URL text field that appears at the top of the document when you click the Live Data View button on the
toolbar.
For the
ID
and
Name
parameters, you can enter the following pairs:
ID 22
Name Samuel
In the URL, these parameters would appear as shown in the following example:
http://someURL?ID=22&Name=Samuel
This function lets you obtain these live data settings through JavaScript.
Arguments
None.
Returns
An array that contains the URL parameters for the current document. The array contains an even number of
parameter strings. Each two elements form a URL parameter name-value pair. The even element is the parameter
name and the odd element is the value. For example,
getLiveDataParameters()
returns the following array for the
ID
and
Name
parameters in the preceding example:
['ID,'22','Name','Samuel']
.
Example
The following example returns the parameters that are specified as Live Data settings and stores them in the
paramsArray
:
var paramsArray = dreamweaver.getLiveDataParameters();
dreamweaver.liveDataTranslate()
Availability
Dreamweaver UltraDev 1.
Description
Sends an entire HTML document to an application server, asks the server to execute the scripts in the document, and
returns the resulting HTML document. This function can be called only from a translator’s
liveDataTranslateMarkup()
function; if you try to call it at another time, an error occurs. The
dreamweaver.liveDataTranslate()
function performs the following operations:
•
Makes the animated image (that appears near the right edge of the Live Data window) play.
•
Listens for user input. If the Stop icon is clicked, the function returns immediately.
•
Accepts a single string argument from the caller. (This string is typically the entire source code of the user’s
document. It is the same string that is used in the next operation.)
•
Saves the HTML string from the user’s document as a temporary file on the live data server.
•
Sends an HTTP request to the live-data server, using the parameters specified in the Live Data Settings dialog box.
•
Receives the HTML response from the live data server.
•
Removes the temporary file from the live data server.
•
Makes the animated image stop playing.