MACROMEDIA DREAMWEAVER 8-EXTENDING DREAMWEAVER, Manual

Page: 439 / 504

Creating Property inspectors for locked content 439
[<A TARGET="_top" HREF="/support/">support</A>]
[<A TARGET="_top" HREF="/company/">about us</A>]
[<A TARGET="_top" HREF="/help/">help</A>]
</CENTER>
<!-- end footer -->
<MM:EndLock>
Creating Property inspectors for locked
content
After you create a translator, you need to create a Property inspector for the content so the
user can change its properties (for example, the file to be included or one of the conditions in
a conditional statement). Inspecting translated content is a unique problem for several
reasons:
■
The user might want to change the properties of the translated content, and those changes
must be reflected in the untranslated content.
■
The Document Object Model (DOM) contains the translated content (that is, the lock
tags and the tags they surround are nodes in the DOM), but the
outerHTML
property of
the
documentElement
object and the
dreamweaver.getSelection()
and
dreamweaver.nodeToOffsets()
functions act on the untranslated source.
■
The tags you inspect are different before and after translation.
A Property inspector for the
HAPPY
tag might have a comment that looks similar to the
following example:
<!-- tag:HAPPY,priority:5,selection:exact,hline,vline, attrName: xxx,¬
attrValue: yyy -->
The Property inspector for the translated
HAPPY
tag, however, would have a comment that
looks similar to the following example:
<!-- tag:*LOCKED*,priority:5,selection:within,hline,vline -->
The
canInspectSelection()
function for the untranslated
HAPPY
Property inspector is
simple. Because the
selection
type is
exact
, it can return a value of
true
without further
analysis. For the translated
HAPPY
Property inspector, this function is more complicated; the
keyword
*LOCKED*
indicates that the Property inspector is appropriate when the selection is
within a locked region, but because a document can have several locked regions, further
checks must be performed to determine whether the Property inspector matches this
particular locked region.