|
Newsletters
|
|
|
|
|
Voice XML Reference
Voice XML Reference
Bookmark this page
The link Element - <link>
Description:
A <link> element has one or more grammars, which are scoped to the element containing the
<link>. Grammar elements contained in the <link> are not permitted to specify scope. When
one of these grammars is matched, the link activates, and either:
<ul>
<li>Transitions to a new document or dialog (like <goto>)</li>
<li>Throws an event (like <throw>)</li>
Example:
<link next="http://www.voicexml.org/books/main.vxml">
<grammar type="application/x-jsgf"> books | Voice XML books </grammar>
<dtmf> 2 </dtmf>
</link>
| Attributes |
| Name |
Value |
Description |
| next |
URI |
The URI to go to. This URI is a document (perhaps with an anchor to
specify the starting dialog), or a dialog in the current document (just
a bare anchor). |
| expr |
PCDATA |
Like next, except that the URI is dynamically determined by evaluating the given ECMAScript expression. |
| event |
PCDATA |
The event to throw when the user matches one of the link grammars. Not that only one of next, expr, or event may be specified. |
| caching |
'safe' or 'fast' |
Eithere safe to force a query to fetch the most recent copy of the content, or fast to use the cached copy of the content if it has not expired. If not specified, a value derived from the innermost caching property is used. |
| fetchaudio |
URI |
The URI of the audio clip to play while the fetch is being done. If not specified, the fetchaudio property is used, and if that property is not set, no audio is played during the fetch. |
| fetchint |
"prefetch", "safe", "stream" |
Defines when the interpreter context should retreive content from the server. prefetch indicates a file may be downloaded when the page is loaded, whereas safe indicates a file that should only be downloaded when actually needed. In the case of a very large file (implying long download times) or a streaming audio source, stream indicates to the interpreter context to begin processing the content as it arrives and should not wait for full retrieval of the content. If not specified, a value derived from the innermost relevant *fetchint property is used. |
| fetchtimeout |
integer |
The interval to wait for the content to be returned before throwing an error.badfetch event. If not specified, a value derived from the innermost fetchtimeout is used. |
Back to Tag Listing
|
|
