Adobe 38040334 - Dreamweaver CS3 User Manual page 277

DREAMWEAVER CS3 271
Extending Dreamweaver
<updatePatterns>
Description
This optional advanced feature lets you update the participant precisely. Without this tag, the participant is updated
automatically by replacing the entire participant text each time. If you specify an tag, it must
updatePatterns
contain specific patterns to find and replace each parameter within the participant.
This tag is beneficial if the user edits the participant text. It performs precise updates only to the parts of the text that
need changing.
Parent
implementation
Type
Block tag.
Required
No.
<updatePattern>
Description
This tag is a specific type of regular expression that lets you update participant text precisely. There should be at least
one update pattern definition for every unique parameter that is declared in the insertion text (of the form
).
@@paramName@@
Parent
updatePatterns
Type
Block tag.
Required
Yes (at least one, if you declare the tag).
updatePatterns
Values
The value is a regular expression that finds a parameter between two parenthetical subexpressions, in the form
. You need to define at least one update pattern for each
/(pre-pattern)parameter-pattern(post-pattern)/
unique in the insertion text. The following example shows how your insertion text might look:
@@paramName@@
<insertText location="afterSelection">
<![CDATA[<%= @@rs@@.Field.Items("@@col@@") %>]]>
</insertText>
A particular instance of the insertion text on a page might look like the following example:
<%= RS1.Field.Items("author_id") %>
There are two parameters, and . To update this text after you insert it on the page, you need two update pattern
rs col
definitions: