MACROMEDIA DREAMWEAVER 8-EXTENDING DREAMWEAVER Скачать руководство пользователя страница 351

Страница: 351 / 504

Participant EDML files

351

■

The

beforeNode

value inserts the text before a node, which is a specific location in the

DOM. When a function such as

dwscripts.applySB()

is called to make the insertion,

the node pointer must pass in as a

paramObj

parameter. The user-definable name of this

parameter must be specified by the

nodeParamName

attribute (see

“nodeParamName”

on page 351

In summary, if your location includes the word

node

, make sure that you declare the

nodeParamName

tag.

■

The

replaceNode

value replaces a node with the text.

■

The

afterNode

value inserts the text after a node.

■

The

firstChildOfNode

value inserts the text as the first child of a block tag; for example,

if you want to insert something at the beginning of a

FORM

tag.

■

lastChildOfNode

inserts the text as the last child of a block tag; for example, if you want

to insert code at the end of a

FORM

tag (useful for adding hidden form fields).

■

nodeAttattribute]

sets an attribute of a tag node. If the attribute does not

already exist, this value creates it.

For example, use

<insert location="nodeAtACTION"

nodeParamName="form">

to set the

ACTION

attribute of a form. This variation changes

the user’s

FORM

tag from

<form>

If you do not specify an attribute, the

nodeAttribute

location causes the text to be added

directly to the open tag. For example, use

insert location="nodeAttribute"

to add

an optional attribute to a tag. This can be used to change a user’s

INPUT

tag from

<input type="checkbox"

<%if(foo)Reponse.Write("CHECKED")%>>

nodeParamName

Description

This attribute is used only for node-relative insert locations. It indicates the name of the
parameter that passes the node in at insertion time.

Parent

insertText

Type

Attribute.

For the

location="nodeAttribute"

attribute value, the last search pattern

determines where the attribute starts and ends. Make sure that the last pattern finds
the entire statement.

Содержание DREAMWEAVER 8-EXTENDING DREAMWEAVER

Страница 1: ...Extending Dreamweaver...

Страница 2: ...y responsibility for the content on those third party sites Opera browser Copyright 1995 2002 Opera Software ASA and its suppliers All rights reserved Copyright 2005 Macromedia Inc All rights reserved...

Страница 3: ...zing Dreamweaver in a multiuser environment 27 Working with browser profiles 30 Changing FTP mappings 34 Extensible document types in Dreamweaver 35 Chapter 2 Customizing Code View 55 Code hints 55 Co...

Страница 4: ...n file 141 Modifying the Insert bar 148 A simple insert object example 150 The Objects API 161 Chapter 7 Commands 167 How commands work 167 Adding commands to the Commands menu 168 A simple command ex...

Страница 5: ...y inspector API 285 Chapter 13 Floating Panels 289 How floating panel files work 290 A simple floating panel example 291 The Floating panel API 297 Chapter 14 Behaviors 305 How Behaviors work 306 A si...

Страница 6: ...erver Model API functions 424 Chapter 20 Data Translators 433 How data translators work 434 Determining what kind of translator to use 435 Adding a translated attribute to a tag 435 Inspecting transla...

Страница 7: ...Contents 7 PART 4 APPENDIX Appendix The Shared Folder 483 The Shared folder contents 483 Using the Shared folder 491 Index 493...

Страница 8: ...8 Contents...

Страница 9: ...se functions and also the values that Dreamweaver expects these functions to return For information on the utility and general purpose JavaScript APIs that you can use to perform various support opera...

Страница 10: ...Manage Extensions to start the Extension Manager The Extension Manager automatically installs the extension from the Downloaded Extension folder into Dreamweaver Some extensions need Dreamweaver to re...

Страница 11: ...nterfaces that are extensible Each of these features has new related functions which are listed in the Dreamweaver API Reference Improved site synchronization The comparison of local and remote files...

Страница 12: ...ted New and updated examples New examples have been added for Reports and Behaviors The example for Property inspectors has been improved The steps for creating each type of extension are presented as...

Страница 13: ...two or more lines Due to margin limits in this guide s format what is otherwise a continuous line of code must be split When copying the lines of code eliminate the continuation symbol and type the l...

Страница 14: ...14 Introduction...

Страница 15: ...changing settings in dialog boxes setting preferences in a variety of areas and changing keyboard shortcuts You can also customize code hints and code coloring in Code view the cascading style sheet C...

Страница 16: ......

Страница 17: ...shortcuts using the Keyboard Shortcut Editor Edit Keyboard Shortcuts The following list describes some of the ways you can customize Dreamweaver by editing configuration files Rearrange the objects i...

Страница 18: ...esets and page designs You can create pages based on these designs by selecting File New To customize the available designs edit the files in BuiltIn css BuiltIn framesets BuiltIn Templates and BuiltI...

Страница 19: ...the Configuration folder in place of the original It s a good idea to first make a backup of the original so you can restore it later if needed 9 Restart Dreamweaver to see the changes You should chan...

Страница 20: ...the file 5 Restart Dreamweaver To see the new default select File Open and look at the pop up menu of file types To add new file types to the menu in the File Open dialog box 1 Make a backup copy of t...

Страница 21: ...ntent model rendering scheme and icon for one or more custom tags You can create any number of tag database files but all of them must reside in the Configuration ThirdPartyTags folder to be read and...

Страница 22: ...For string delimited tags tag_name is used only to determine whether a given Property inspector can be used for the tag If the first line of the Property inspector contains this tag name with an aste...

Страница 23: ...cument so you can t place a marker_model tag that contains plain text in the head section To place a custom tag containing plain text in the head section specify the tag s content model as head_model...

Страница 24: ...quired for empty tags and for nonempty tags whose contents do not appear in the Document window s Design view icon_width specifies the width of the icon in pixels icon_height specifies the height of t...

Страница 25: ...f the code happy code tag happy Joe happy p Because render_contents is set to false in the tag specification the contents of the happy tag the word Joe are not rendered Instead the start and end tags...

Страница 26: ...he Dreamweaver encoding behavior when you re working with files that contain third party tags To allow Dreamweaver to rewrite HTML in more kinds of files 1 Select Edit Preferences and select the Code...

Страница 27: ...ead of modifying the Dreamweaver Configuration files To customize Dreamweaver by editing a configuration file in a multiuser environment edit the appropriate user Configuration file rather than editin...

Страница 28: ...r to the corresponding location inside your user Configuration folder Then edit the copy in your user Configuration folder Deleting configuration files in a multiuser environment When working in a mul...

Страница 29: ...tribute lists with curly braces all attributes not marked with curly braces are required deleteditems Description Container tag that holds a list of items that Dreamweaver should treat as deleted Attr...

Страница 30: ...rnings error messages and suggestions for tag substitutions Browser profiles are stored in the Configuration BrowserProfiles folder in the Dreamweaver application folder You can edit existing profiles...

Страница 31: ...ttribute of the htmlTag tag is not supported Try using supportedAttribute1 for a similar effect supportedAttribute1 supportedAttribute2 validValue1 validValue2 validValue3 unsupportedAttribute2 Error...

Страница 32: ...r a future version of Microsoft Internet Explorer you can open the profile for the most recent version of Internet Explorer that has a profile add any new tags or attributes introduced in the new vers...

Страница 33: ...r because browsers rarely drop support for tags 5 Add any custom error messages according to the syntax shown in About browser profile formatting on page 30 The profiles that come with Dreamweaver lis...

Страница 34: ...tension Dreamweaver uses the BINARY transfer mode The following example shows a line from the Macintosh file that indicates that files with the extension html should be transferred in ASCII mode HTML...

Страница 35: ...s information about at least one document type For each document type essential information such as server model color coding style descriptions and so forth is described Dreamweaver provides an initi...

Страница 36: ...VBScript Template DWTemplate aspvb dwt ColdFusion Template DWTemplate cfm dwt HTML Template DWTemplate dwt JSP Template DWTemplate jsp dwt PHP Template DWTemplate php dwt HTML HTML htm html ActionScri...

Страница 37: ...sp htm html macfileextension asp html previewfile default_aspjs_preview htm file default_aspjs htm priorversionservermodel UD4 ASP JS title loadString id mmdocumenttypes_0title title description loadS...

Страница 38: ...all document type definition files servermodel No Specifies the associated server model case sensitive by default the following values are valid ASP NET C ASP NET VB ASP VBScript ASP JavaScript ColdF...

Страница 39: ...types should map to Dynamic HTML should map to HTML Script files such as CSS JS VB and CS should map to Text If internaltype is DWTemplate you should also specify dynamicid If you omit dynamicid in t...

Страница 40: ...ons by using a comma separated list The first extension in the list is the extension that Dreamweaver uses when the user saves a documenttype document If two nonserver model associated document types...

Страница 41: ...the New Document dialog box You can place this string directly in the definition file or point to it indirectly for localization purposes For more information on localizing this string see Localized...

Страница 42: ...on this PHP_MySQL dynamic document type documenttype id DWTemplate_PHP internaltype DWTemplate dynamicid PHP_MySQL winfileextension php dwt macfileextension php dwt file Default php dwt title PHP Temp...

Страница 43: ...Dreamweaver 8 Configuration If Dreamweaver cannot find the Extensions txt file in the user s Configuration folder Dreamweaver looks for it in the Dreamweaver Configuration folder To create a new docum...

Страница 44: ...f file types Localized strings Within a document type definition file the title and description subtags specify the display title and description for the document type You can use the MMString loadstr...

Страница 45: ...server model share file extensions For example ASP JS and ASP VB can claim asp as their file extension For information on which server model gets preference see canRecognizeDocument on page 424 Dream...

Страница 46: ...e server model returns the highest integer is the document type that Dreamweaver assigns to the document being opened If however more than one server model returns the same integer Dreamweaver goes th...

Страница 47: ...ion Specifies the application window s initial position and size Attributes rect maximize rect specifies the position and size of the application window The string is in the form left top right bottom...

Страница 48: ...e Contents None Container This tag must be contained in a panelset tag Example panelset document rect 100 257 1043 1200 maximize false document panelset panelframe Description Describes an entire pane...

Страница 49: ...roup is used dock is a string value that specifies to which edge of the application frame to dock the panel group This attribute is ignored on the Macintosh because panel groups cannot be docked colla...

Страница 50: ...icates the position and size of the panel when it is maximized The string is in the form left top right bottom specified as integers tabsinheader is a Boolean value true indicates that tabs should be...

Страница 51: ...and the panel should be visible false otherwise Contents None Product ID Panel Flash 1 Properties 2 Actions 3 Align 4 Behaviors 5 Components 6 Component Inspector 7 Color Mixer 8 Color Swatches 9 Hist...

Страница 52: ...the toolbar through the Extension Manager To change the order of button 1 Open the file Configuration Toolbars toolbars xml 2 Locate the Code view toolbar section by searching for the following comme...

Страница 53: ...Focus true html command if dw getFocus true textView dw getFocus true html dw getDocumentDOM source expandAllCodeFragments update onViewChange 4 Save the file To make any buttons that are not visible...

Страница 54: ...54 Customizing Dreamweaver...

Страница 55: ...ow to customize these features Code hints Code hints are menus that Dreamweaver opens when you type certain character patterns in the Code view Code hints offer a typing shortcut by providing a list o...

Страница 56: ...s of Code Hints menus Tag Names Attribute Names Attribute Values Function Arguments Object Methods and Variables and HTML Entities The description for each menu group The description appears in the Pr...

Страница 57: ...e id CodeHints_Function_Arguments description description function pattern ArraySort array sort_type sort_order doctypes CFML function pattern Response addCookie Cookie cookie doctypes JSP menugroup c...

Страница 58: ...enu group that is enabled appears with a check mark next to it in the Code Hints category of the Preferences dialog box Assign a true value to enable the menu group or a false value to disable a menu...

Страница 59: ...f typed characters that cause Dreamweaver to open the Code Hints menu If the first character of the pattern is a letter number or underscore Dreamweaver displays the menu only if the character that pr...

Страница 60: ...menu pattern CGI doctypes ColdFusion menuitem Description This tag specifies the text for an item in a Code Hints pop up menu The menuitem tag also specifies the value to insert into the text when you...

Страница 61: ...ying function arguments and object methods for a Code Hints pop up menu When you type a function or method name in Code view Dreamweaver opens a menu of function prototypes displaying the current argu...

Страница 62: ...ypes attribute as a comma separated list of document type IDs For a list of Dreamweaver document types see the Dreamweaver Configuration Documenttypes MMDocumentTypes xml file The casesensitive attrib...

Страница 63: ...oloring files Dreamweaver defines code coloring styles and schemes in XML files that reside in the Configuration CodeColoring folder A code coloring style file defines styles for fields that are defin...

Страница 64: ...ity 1 ignoreTags Yes ignoreTags defaultText name Text id CodeColor_TextText sampleText doctypes Text CDATA Default file syntax highlighting The quick brown fox jumped over the lazy dog sampleText sche...

Страница 65: ...ority that lets you nest a block of text with one scheme inside a block of text with a different scheme Attributes name id priority doctypes name scheme_name A string that assigns a name to the scheme...

Страница 66: ...red and the combination must be unique Values are not evaluated as case sensitive The blockEnd value can be one character Multiple instances of this tag are allowed For more information on blockEnd st...

Страница 67: ...item name display_name A string that appears in the Edit Coloring Scheme dialog box when scheme customText scheme Required This defines how the blockStart and blockEnd strings are colored For informa...

Страница 68: ...e delimiter of the end of a character You must specify the charStart and charEnd tags in pairs Multiple charStart charEnd pairs are allowed Attributes None Example charEnd CDATA charEnd charEsc Descri...

Страница 69: ...TA commentEnd cssImport Description An empty tag that indicates the code coloring rule for the import function of the style element in a CSS Attributes name id name cssImport_name A string that assign...

Страница 70: ...Property_name A string that assigns a name to the CSS property id id_string Required An identifier string that maps color and style to this syntax item Code Color Preference CSS Property Example cssPr...

Страница 71: ...syntax that is where ignoreTags No If this tag is present then all tag attributes are colored according to the style assigned to this tag If this tag is omitted then attributes are colored the same a...

Страница 72: ...name to the CSS Selector id id_string Required An identifier string that maps color and style to this syntax item Example defaultText name Text id CodeColor_TextText endOfLineComment Description A tex...

Страница 73: ...eyword_name A string that assigns a name to the functionKeyword block id id_string Required An identifier string that maps color and style to this syntax item Example functionKeyword name Function Key...

Страница 74: ...mple idCharRest name Identifier id CodeColor_JavascriptIdentifier _ abcdefghijklmnopqrstuvwxyzABCDEFGH IJKLMNOPQRSTUVWXYZ0123456789 idCharRest ignoreCase Description Specifies whether case should be i...

Страница 75: ...s isLocked Description Specifies whether the text that is matched by this scheme is locked from being edited in the Code view Values are Yes and No Default is No Attributes None Example isLocked Yes i...

Страница 76: ...d Example keywords name Reserved Keywords id CodeColor_JavascriptReserved keyword break keyword keyword case keyword keywords numbers Description An empty tag that specifies numbers that should be rec...

Страница 77: ...tring Required An identifier string that maps color and style to this syntax item delimiter The character or string that starts and ends a regular expression escape The character or string that signal...

Страница 78: ...ello world displayWords tokens sampleText searchPattern Description A string of characters that define a regular search pattern using supported wildcard characters Multiple searchPattern tags are allo...

Страница 79: ...le stringStart name Attribute Value id CodeColor_HTMLString CDATA stringStart stringEnd Description Contains a text string that represents the delimiter of the end of a code string You must specify th...

Страница 80: ...agLibrary_html tags table tbody td tfoot th thead tr vspec colw hspec Scheme block delimiter coloring The blockStart scheme attribute controls the coloring of block opening and closing strings or bloc...

Страница 81: ...tomText value php if loginMsg echo loginMsg Example blockStart name Block Delimiter id CodeColor_JavaBlock doctypes JSP scheme customText CDATA blockStart outerTag The outerTag value specifies that bo...

Страница 82: ...embedded inside other tags such as the cfoutput tag Sample code input type text name zip cfif newRecord IS no cfoutput query employee Value zip cfoutput cfif Example blockStart doctypes ColdFusion CF...

Страница 83: ...indicates which fields are subject to code coloring in each mode To make the process of defining schemes more flexible Dreamweaver lets you specify wildcard and escape characters Field CSS Tags Scrip...

Страница 84: ...t regular expression that starts and ends with a forward slash and can contain forward slashes that are preceded by a backslash Because the backslash is the code coloring escape character you must pre...

Страница 85: ...s long plus a wildcard string for the name BeginEditable This leaves an editable region name that can be as man y as 74 characters which is the maximum of 100 characters minus 26 Escape character Esca...

Страница 86: ...scheme If the priority is equal the scheme can nest only in the body state of the outer scheme For example the script script block can nest only inside the html html block where tags are legal not ins...

Страница 87: ...ngStart specify color and style settings only on the first tag Data will be lost when you split color and style settings across tags and you later edit the colors or styles by using the Preferences di...

Страница 88: ...in the XML file The value of the scheme name attribute precedes each field listed in the Styles For pane Fields that do not have a name are not listed The style for a particular element includes bold...

Страница 89: ...t doctypes ASP JS ASP VB ASP NET_CSharp ASP NET_VB ColdFusion CFC HTML JSP LibraryItem DWTempl ate PHP_MySQL scheme outerTag CDATA style s blockStart blockEnd CDATA style blockEnd commentStart name Co...

Страница 90: ...L scheme outerTag CDATA script blockStart blockEnd CDATA script blockEnd blockStart doctypes ASP JS ASP VB ASP NET_CSharp ASP NET_VB ColdFusion CFC HTML JSP LibraryItem DWTempl ate PHP_MySQL scheme ou...

Страница 91: ...id CodeColor_JavascriptNative keyword abs keyword keywords keywords id CodeColor_JavascriptNumber keyword Infinity keyword keyword Nan keyword keywords keywords name Client Keywords id CodeColor_Javas...

Страница 92: ...e user selected Dreamweaver underlines errors with a wavy red line Dreamweaver stores browser profiles in the Browser Profile folder inside the Dreamweaver Configuration folder Each browser profile is...

Страница 93: ...or example the following names attribute is a shorthand method of defining the name attribute that follows it property names foo bar value type named name top value type named name bottom property pro...

Страница 94: ...h for this item The units value matches a numeric value followed by one of the units values specified in the names attribute name value_name A CSS value identifier No spaces or punctuation allowed oth...

Страница 95: ...the Preferences dialog box To change the format of specific tags and attributes use the Tag Library Editor Edit Tag Libraries For more information see Using Dreamweaver on the Dreamweaver Help menu Yo...

Страница 96: ...96 Customizing Code View...

Страница 97: ...to suit your web development needs These fundamental concepts include the Dreamweaver folders extension APIs Dreamweaver interface components the Dreamweaver Document Object Model DOM and Dreamweaver...

Страница 98: ......

Страница 99: ...tensive set of tools that you can use to add to or customize its functionality When you create a Dreamweaver extension you should follow the steps outlined in Creating an extension on page 10 The foll...

Страница 100: ...tten reports that come with Dreamweaver You can also use the Results Window API to create a stand alone report Tag Library and Editor extensions work with the associated tag library files Tag Library...

Страница 101: ...er supports the most common server models ASP JSP ColdFusion PHP and ASP NET Server model extensions are needed only for custom server solutions different languages or a customized server Server model...

Страница 102: ...Menu Commands on page 181 Configuration folders and extensions The folders and files that are stored in the Dreamweaver Configuration folder contain the extensions that come with Dreamweaver When you...

Страница 103: ...pt techniques and as utilities Look here first for the functions that perform specific tasks such as creating a valid Document Object Model DOM reference to an object testing whether the current selec...

Страница 104: ...e ThirdPartyTags folder and before any other commands objects behaviors inspectors floating panels or translators You can use startup commands to modify the menus xml file or other extension files You...

Страница 105: ...create dynamic link libraries DLLs The functionality that is provided in these APIs wraps your C DLLs in JavaScript so that your extension can work seamlessly in Dreamweaver The documentation of exte...

Страница 106: ...action from a menu for the Command and Behavior action extension types Dreamweaver executes code in the onLoad event handler on the BODY tag if the body of the document contains a form for object ext...

Страница 107: ...lays Help You can call the dreamweaver browseDocument function to open a file in a browser or devise a custom way to display Help such as displaying messages in another layer in alert boxes The follow...

Страница 108: ...xample shows the format of the file strings errors for feature X string id featureX subProblemY value There was a with X when you did Y Try not to do Y string id featureX subProblemZ value There was a...

Страница 109: ...following example shows how the string along with any variables to embed is passed to the alert function if fileMissing alert errMsg dw loadString featureX fileNotFoundInFolder fileName folderName Wo...

Страница 110: ...110 Extending Dreamweaver...

Страница 111: ...ions Some steps in the task can change or specific attributes of the code that the extension processes can change To receive user inputs for these variable values you build a UI For example you might...

Страница 112: ...mes to the fields In a typical scenario after you create the UI you test the extension code to see that it properly performs the following UI related tasks Getting the values from the text boxes Setti...

Страница 113: ...show the Base Property inspector without the DOCTYPE statement which improves form control rendering and then with the DOCTYPE statement The Base Property inspector as it appears in Design view witho...

Страница 114: ...e which indicates that the select list is not editable As with standard noneditable select lists editable select lists have a selectedIndex property see Objects properties and methods of the Dreamweav...

Страница 115: ...on getAlert var i document myForm mySelect selectedIndex if i 0 alert Selected index i n Selected text document myForm mySelect options i text else alert Nothing is selected n or you entered a value f...

Страница 116: ...ctTest When you select a value from the list an alert message displays the index of the value and the text If you enter a value an alert message indicates that nothing is selected Database controls Us...

Страница 117: ...able grid control Adding a database tree control The database tree control has the following attributes Attribute name Description name Name of the database tree control control style Width and height...

Страница 118: ...ollowing attributes The following example adds a simple variable grid control to a dialog box select name ParamList style width 515px type mmparameterlist columns Name SQL Data Type Direction Default...

Страница 119: ...is example creates two blank columns that are 182 pixels wide The specified columns total 136 The total width of the variable grid control is 500 The remaining space after the first three columns are...

Страница 120: ...ontrol on page 117 no association with a database is required The Dreamweaver Keyboard Shortcuts editor uses the tree control as shown in the following figure Creating a tree control The MM TREECONTRO...

Страница 121: ...s theControl Optional If the number of nodes in the theControl attribute exceeds the value of the size attribute scrollbars appear multiple Optional Allows multiple selections default is single select...

Страница 122: ...in the same way as any other document node For more information on DOM functions and methods see Chapter 5 The Dreamweaver Document Object Model on page 127 Adding nodes To add a node to an existing...

Страница 123: ...ted node from the document structure use the innerHTML or outerHTML properties The following example deletes the entire selected node and any children var tree document myTreeControl var selNode tree...

Страница 124: ...u build extensions that use Flash forms animations ActionScript or other Flash content Basically you leverage the ability for Dreamweaver objects and commands to display dialogs see Chapter 6 Insert B...

Страница 125: ...orm tag Then within the form tags use the Insert Media Flash menu option to add your Flash content to the Command definition file When prompted select the SWF file in the Commands folder and click OK...

Страница 126: ...example shows a simple implementation of Dreamweaver s Flash content support After you are familiar with building objects and commands as well as more sophisticated forms you can integrate Flash conte...

Страница 127: ...so on block level elements P DIV FORM and so on text level elements FONT BR IMG and so on and other element types Leaves on these offshoots include attributes such as WIDTH HEIGHT ALT and others In a...

Страница 128: ...object For example to refer to the first image in the active document you can write dw getDocumentDOM images 0 You can also store the document object in a variable and use that variable in future refe...

Страница 129: ...dth innerHeight screenX screenY alert confirm escape unescape close setTimeout clearTimeout setInterval clearInterval resizeTo onResize navigator platform None None document forms an array of form obj...

Страница 130: ...tton reset submit In addition to the properties that are available for all tags form In addition to the methods that are available for all tags blur focus onClick checkbox radio In addition to the pro...

Страница 131: ...or all tags name value None onChange array boolean date function math number object string regexp Matches Netscape Navigator 4 0 Matches Netscape Navigator 4 0 None text nodeType parentNode childNodes...

Страница 132: ...st body The JavaScript object that corresponds to the BODY tag This property is shorthand for calling document documentElement childNodes and extracting the BODY tag from the NodeList For frameset doc...

Страница 133: ...rHTML The source code for this tag including the tag For the previous example code p outerHTML returns p b Hello b World p If you write to this property the DOM tree immediately updates to reflect the...

Страница 134: ...he tag argument is INPUT the function returns all form elements If a name attribute is specified for one or more tagName objects it must begin with a letter which the HTML 4 01 specification requires...

Страница 135: ...bed in the following list The appName property has the value Dreamweaver The appVersion property has a value of the form versionNumber releaseNumber buildNumber languageCode platform As an example the...

Страница 136: ...rating system Use this property if you need to include special cases in your extension code for localized operating systems as shown in the following example if dreamweaver systemScript dreamweaver sy...

Страница 137: ...167 Chapter 8 Menus and Menu Commands 181 Chapter 9 Toolbars 215 Chapter 10 Reports 249 Chapter 11 Tag Libraries and Editors 261 Chapter 12 Property Inspectors 279 Chapter 13 Floating Panels 289 Chap...

Страница 138: ......

Страница 139: ...are grouped according to their location on the Insert bar and you can open these files to see the construction of current objects For example you can open the Configuration Objects Common Hyperlink ht...

Страница 140: ...e canInsertObject function to determine whether to show a dialog box 2 The Object file is scanned for a FORM tag If a form exists and you select the Show Dialog When Inserting Objects option in the Ge...

Страница 141: ...ertbar categorycommon folder Common button id DW_Hyperlink image Common Hyperlink png MMString name insertbar hyperlink file Common Hyperlink htm button id DW_Email image Common E Mail Link png MMStri...

Страница 142: ...fines a category on the Insert bar such as Common Forms or HTML The category closing tag specifies the end of the category content Attributes id folder showIf Example category id DW_Insertbar_Common f...

Страница 143: ...r Images button id DW_Image image Common Image gif enabled showIf file Common Image htm menubutton button Description This tag defines a button on the Insert bar that the user clicks to execute the co...

Страница 144: ...nabled command file tag name codeOnly Example checkbutton id DW_StandardView name Standard View image Tools Standard View gif checked _View_Standard command dw getDocumentDOM setShowLayoutView false s...

Страница 145: ...enabler Description This attribute specifies that this button should appear on the Insert bar only if the given Dreamweaver enabler is a true value If you do not specify showIf the button always appe...

Страница 146: ...le only in Code view specify the following enabled _VIEW_CODE This dims the button in other views checked enabler Description The checked attribute is required if you use the checkbutton tag The item...

Страница 147: ...eamweaver invokes the Tag editor In Design view if codeOnly TRUE and you do not specify the file attribute Dreamweaver MX invokes Split view places focus in the code and invokes the Tag editor Example...

Страница 148: ...category tag that represents the category in which you want to move or copy the object 6 Find the location within the category where you want the object to appear 7 Paste the copied button tag 8 Save...

Страница 149: ...a set of objects to appear in the category 4 For information on the syntax of the tags in insertbar xml see Insert bar definition tags on page 142 5 Save the insertbar xml file 6 Reload extensions Ad...

Страница 150: ...a document Because this example performs text manipulation you may want to explore some of the objects from the Text pop up menu in the HTML category on the Insert bar as models For example look at t...

Страница 151: ...he API functions in the HEAD section of the file The existing object files such as Configuration Objects Text Em htm follow a similar pattern of functions and comments The first function the object de...

Страница 152: ...oint cursor to the document without any messages or prompting The following procedure shows how the objectTag function now reads To add the objectTag function 1 In the HEAD section of the Strikethroug...

Страница 153: ...ethrough js in the Configuration Objects Text folder Creating the image To create the image for the Insert bar 1 Create a GIF image 18 x 18 pixels as shown in the following figure 2 Save the file as S...

Страница 154: ...rikethrough gif file Text Strikethrough htm 3 Save the insertbar xml file 4 Reload the extensions see Reloading extensions on page 104 The new object appears at the beginning of the Common category on...

Страница 155: ...e return 2 Save the file as Strikethrough js Next in the Strikethrough htm file you add the form The form for this example is a simple checkbox that calls the fontColorRed function when the user click...

Страница 156: ...Save the file as Strikethrough htm 3 Reload the extensions see Reloading extensions on page 104 To test the dialog box 1 Click the Red Text checkbox 2 Click OK to perform the objectTag function which...

Страница 157: ...objects in the Editorial category let users make editorial comments in a file and either strike through the content they want to remove or make new content blue To organize the files 1 Create a new Co...

Страница 158: ...ng else return script head body body html 3 Save the file as AddBlue htm in the Editorial folder Now you can create an image for the Blue Text Object To create the image 1 Create a GIF file that is 18...

Страница 159: ...name Editorial folder Editorial category 3 Reload extensions For information on reloading extensions see Reloading extensions on page 104 The Editorial category appears on the Insert bar 4 Within the...

Страница 160: ...er Editorial menubutton id DW_Insertbar_Markup name markup image Editorial Strikethrough gif folder Editorial button id DW_Editorial_Strikethrough image Editorial Strikethrough gif file Editorial Stri...

Страница 161: ...le The following code tells Dreamweaver to check to see that the document contains a particular string before allowing the user to insert the selected object function canInsertObject var docStr dw get...

Страница 162: ...This function determines whether the object requires a valid DOM to operate If this function returns a true value or if the function is not defined Dreamweaver assumes that the command requires a val...

Страница 163: ...nput before inserting code If none of these conditions apply use the objectTag function Arguments None Returns Dreamweaver expects a string that contains an error message or an empty string If it retu...

Страница 164: ...the objectTag function returns an empty string or returns nothing The objectTag function returns an empty string or a null value because edits to the document have already been made manually Otherwise...

Страница 165: ...nsions are smaller than the size of the entire dialog box because they do not include the area for the OK and Cancel buttons If the returned dimensions do not accommodate all options scroll bars appea...

Страница 166: ...166 Insert Bar Objects...

Страница 167: ...nds work When a user clicks a menu that contains a command the following events occur 1 Dreamweaver calls the canAcceptCommand function to determine whether the menu item should be disabled If the can...

Страница 168: ...ks one of the buttons that is defined by the commandButtons function 9 Dreamweaver executes the associated code The dialog box remains visible until one of the scripts in the command calls the window...

Страница 169: ...e a new blank file 2 Add the following code to the file to create the form DOCTYPE HTML SYSTEM Macromedia DWExtension layout engine 5 0 dialog HTML HEAD Copyright 2001 2002 Macromedia Inc All rights r...

Страница 170: ...h Dreamweaver calls and one user defined function changeCase which is called from the commandButtons function In this example you will write JavaScript to perform the following tasks Determining wheth...

Страница 171: ...of the canAcceptCommand function retrieve the selected text by retrieving the DOM for the user s document and calling the getSelection function on the document object Next the function retrieves the...

Страница 172: ...nues to see if the node has children theSelNode hasChildNodes and if the type of the first child node is text theChildren 0 nodeType Node TEXT_NODE If both conditions are true canAcceptCommand returns...

Страница 173: ...user clicks them The commandButtons function tells Dreamweaver to call changeCase when the user clicks OK and to call window close when the user clicks Cancel Letting the user specify uppercase or lo...

Страница 174: ...c substring 0 theSel 0 selText toUpperCase theWholeDoc substring theSel 1 else theDocEl outerHTML theWholeDoc substring 0 theSel 0 selText toLowerCase theWholeDoc substring theSel 1 Set the selection...

Страница 175: ...eCase calls getSelectedNode to retrieve the node that contains the selected text It also retrieves any child nodes theSelNode childNodes in case the selection is a tag that contains text such as b tex...

Страница 176: ...he Commands API The custom functions in the Commands API are not required canAcceptCommand Description This function determines whether the command is appropriate for the current selection Arguments N...

Страница 177: ...ey are clicked If this function is not defined no buttons appear and the BODY section of the Commands file expands to fill the entire dialog box Arguments None Returns Dreamweaver expects an array tha...

Страница 178: ...se otherwise receiveArguments Description This function processes any arguments that pass from a menu item or from the dw runCommand function Arguments arg1 arg2 argN If the arguments attribute is def...

Страница 179: ...ightInPixels The returned dimensions are smaller than the size of the entire dialog box because they do not include the area for the OK and Cancel buttons If the returned dimensions do not accommodate...

Страница 180: ...180 Commands...

Страница 181: ...in a multiuser operating system edit the copy of the file in your user Configuration folder or copy the master menus xml file to your user Configuration folder if Dreamweaver hasn t yet created a vers...

Страница 182: ...nd shortcuts that are available only in certain contexts For example Control Y Windows or Command Y Macintosh is the shortcut for Redo but Control Shift Z or Command Shift Z is an alternate shortcut f...

Страница 183: ...menubar menu Description Provides information about a menu or submenu to appear in the Dreamweaver menu structure Attributes name app id platform showIf name The name of the menu as it will appear on...

Страница 184: ...item tags and one or more separator tags It can also contain other menu tags to create submenus and standard HTML comment tags Container This tag must be contained in a menubar tag Example menu name _...

Страница 185: ...mac enabled Provides JavaScript code usually a JavaScript function call that determines whether the menu command is currently enabled If the function returns the value false the menu command is dimme...

Страница 186: ...pter 5 The Dreamweaver Document Object Model on page 127 showIf Specifies that the menuitem should appear only if the given Dreamweaver enabler has value true The possible enablers are _SERVERMODEL_AS...

Страница 187: ...ently used id The ID for the shortcut list It should be the same as the menu ID for the menu bar or context menu in Dreamweaver that the shortcuts are associated with Valid values are DWMainWindow DWM...

Страница 188: ...command attribute You must specify either file or command for each shortcut arguments Provides arguments for Dreamweaver to pass to the code in the JavaScript file that you specify in the file attrib...

Страница 189: ...g Example tool name Hand tool id com macromedia dreamweaver tools hand tool tags here tool action Description Contains the key combination and JavaScript to execute when the tool is active and the key...

Страница 190: ...to reference the action Contents None empty tag Container This tag must be contained in a tool tag Example activate name Switch to Hand tool key H id DWTools_Hand_Active1 override Description Contain...

Страница 191: ...backup copy of the menus xml file 3 Open menus xml in a text editor such as BBEdit HomeSite or Wordpad Don t open it in Dreamweaver 4 Cut an entire menuitem tag from the menuitem at the beginning to t...

Страница 192: ...such as HomeSite BBEdit or Wordpad Don t open it in Dreamweaver 4 If you re changing a menu command find the appropriate menuitem tag and change the value of its name attribute If you are changing a m...

Страница 193: ...use elsewhere and you didn t remove its other use the shortcut applies only to the first menu command that uses it in menus xml 9 Write your new shortcut in the appropriate location in the Keyboard Sh...

Страница 194: ...Jsp JavaBeans JavaBeanMenus xml Items for context menus associated with various server components are specified in XML files in subfolders of the Components folder Menu commands Menu commands make me...

Страница 195: ...an change Commands that are in the default Commands menu don t appear on this list and can t be edited using this approach 2 Select a command to rename 3 Enter a new name for it 4 Click Close Path Fil...

Страница 196: ...mands work When the user clicks a menu with a menu item that contains a menu command the following events occur 1 If any menuitem tag in the menu contains the dynamic attribute Dreamweaver calls the g...

Страница 197: ...g box appears If no dialog box appears the remaining steps do not occur 9 The user selects options in the dialog box Dreamweaver executes event handlers that are associated with the fields as the user...

Страница 198: ...ified by the file attribute of the menuitem tag Create the MyMenu htm command file in the Dreamweaver Configuration Menus folder and add the three menu command API functions canAcceptCommand receiveAr...

Страница 199: ...ndo and Redo menu items the receiveArguments function calls either the dw undo function or the dw redo function depending on whether the value of the argument arguments 0 is undo or redo The dw undo f...

Страница 200: ...1 setMenuText Dreamweaver calls the setMenuText function to determine what text appears for the menu item If you do not define the setMenuText function Dreamweaver uses the text that you specified in...

Страница 201: ...pecified in the menuitem tag To make it accessible to Dreamweaver either restart Dreamweaver or reload extensions For information on how to reload extensions see Reloading extensions on page 104 To ru...

Страница 202: ...t Explorer browser however the submenu would look like the following figure The name attribute for the first menu item specifies the command file PIB_Dynamic htm This file contains the following line...

Страница 203: ...shortcut keys that invoke them Next it appends the string id followed by the name of the browser in single quotes for example id iexplore If the itemID argument is DWPopup_PIB_Default the function pr...

Страница 204: ...IB length 0 If both tests are true the function returns the value true If either or both of the tests are false the function returns the value false havePreviewTarget The havePreviewTarget function is...

Страница 205: ...alse else if strTemp indexOf 1 bHavePreviewTarget false else if DWfile exists selFile bHavePreviewTarget false else if DWfile getAttributes selFile indexOf D 1 bHavePreviewTarget false else bHavePrevi...

Страница 206: ...the code performs a series of tests on the list item If the item is not in the form of a file URL if selFile indexOf urlPrefix 1 it sets the return value to false If the remainder of the string follo...

Страница 207: ...the menu browserList dw getBrowserList while i browserList length if browserList i 1 theBrowser theBrowser browserList i i 2 else theBrowser whichBrowser Only launch the browser if we have a valid br...

Страница 208: ...loop that examines the list of browsers returned by dw getBrowsersList If the path to a browser in the list matches the path to the primary or secondary browser the function sets the variable theBrow...

Страница 209: ...s the only argument Otherwise if the arguments attribute is defined for a menuitem tag the value of that attribute passes to the canAcceptCommand function and to the isCommandChecked receiveArguments...

Страница 210: ...p getDynamicContent Description Retrieves the content for the dynamic portion of the menu Arguments menuID The menuID argument is the value of the id attribute in the menuitem tag that is associated w...

Страница 211: ...mmand receiveArguments and setMenuText functions as one or more arguments The arguments attribute is useful for distinguishing between two menu items that call the same menu command Returns Dreamweave...

Страница 212: ...guments function and to the canAcceptCommand isCommandChecked and setMenuText functions as one or more arguments The arguments attribute is useful for distinguishing between two menu items that call t...

Страница 213: ...Text else if whatToDo redo return dw getRedoText else return windowDimensions Description Sets specific dimensions for the Parameters dialog box If this function is not defined the window dimensions a...

Страница 214: ...214 Menus and Menu Commands Example The following example of windowDimensions sets the dimensions of the Parameters dialog box to 648 x 520 pixels function windowDimensions return 648 520...

Страница 215: ...onfiguration folder The default Dreamweaver toolbars are stored in the toolbars xml file in the Configuration Toolbars folder When Dreamweaver starts it loads all the toolbar files in the Toolbars fol...

Страница 216: ...s Dreamweaver toolbars have the following characteristics You can drag and drop toolbars to dock them undock them and reposition them relative to other toolbars You can horizontally dock toolbars to t...

Страница 217: ...Dreamweaver toolbar for example the canAcceptCommand function checks to see if there is a current DOM and if the current document is an HTML file If both these conditions are true the function return...

Страница 218: ...ROL ID DW_SetTitle label Title tooltip Document Title width 150 file Toolbars MM EditTitle htm The tooltip attribute causes Dreamweaver to display Document Title in a tooltip box when the user places...

Страница 219: ...he control The function is as follows function receiveArguments newTitle var dom dw getDocumentDOM if dom dom setTitle newTitle Dreamweaver passes newTitle which is the value that the user enters to t...

Страница 220: ...nce to an item using the itemref tag a separator using the separator tag or a complete toolbar item definition for a checkbox or an edit box for example as described in Toolbar item tags on page 226 E...

Страница 221: ...rder laying out the items automatically The toolbar file does not specify control over the spacing between the items but you can specify the widths of certain kinds of items Attributes id label contai...

Страница 222: ...in the following list top This is the default position so the toolbar appears at the top of the document window If multiple toolbars specify top for a given window type the toolbars appear in the ord...

Страница 223: ...ag Example toolbar id MyDWedit_toolbar label Edit include Description Loads toolbar items from the specified file before continuing to load the current file Toolbar items that are defined in the inclu...

Страница 224: ...or toolbar items see Item tag attributes on page 232 Contents None Container The toolbar tag or the toolbarset tag Example button id strikeout_button itemref Description Refers to and includes in the...

Страница 225: ...he item from a toolbar If both the definition and the reference specify the showIf attribute Dreamweaver shows the item only if both conditions are true The showIf attribute is equivalent to the showI...

Страница 226: ...cts the same as the Reference button on the Dreamweaver toolbar Attributes id image tooltip command showIf disabledImage overImage label file domRequired enabled update arguments For a description of...

Страница 227: ...e see Item tag attributes on page 232 Contents None Container The toolbar tag or the toolbarset tag Example CHECKBUTTON ID DW_LiveDebug image Toolbars images MM debugview gif disabledImage Toolbars im...

Страница 228: ...OM null checked dw getDocumentDOM null dw getDocumentDOM getView code command dw getDocumentDOM setView code update onViewChange menubutton Description A menu button is a button that invokes the conte...

Страница 229: ...lect an entry and the menu updates itself based on an attached JavaScript function The dropdown menu looks and acts the same as the Format control in the Text Property inspector except it s a standard...

Страница 230: ...ired update arguments For a description of each attribute see Item tag attributes on page 232 Contents None Container The toolbar tag or the toolbarset tag Example COMBOBOX ID Address_URL width 300 to...

Страница 231: ...he Dreamweaver Property inspector You can specify a different icon to replace the default icon Attributes id tooltip value command showIf image disabledImage overImage label colorRect file domRequired...

Страница 232: ...e item s enabler runs that is according to the value of the update attribute You should use the showIf attribute sparingly You can specify the showIf attribute in the item definition and in a referenc...

Страница 233: ...that is specified in the image attribute when the button is disabled Example disabledImage Toolbars images MM codenav_dis gif overImage image_path Optional Dreamweaver ignores the overImage attribute...

Страница 234: ...s unless you specify the getMenuID function in an associated command file Dreamweaver ignores the menuID attribute for other types of items This attribute specifies the ID of the menu bar that contain...

Страница 235: ...he Design view should be synchronized with the Code view before Dreamweaver runs the associated command If you do not specify this attribute it defaults to a true value This attribute is equivalent to...

Страница 236: ...the returned value to the list and displays it In all other cases the script returns the current value to display For pop up menus or combo boxes this value should be one of the items in the menu lis...

Страница 237: ...when the application is idle This can be time consuming because the enabler checked showif value handlers are running often It should be used only for buttons that need to have their enable state cha...

Страница 238: ...ng example button id DW_Undo image Toolbars images MM undo gif disabledImage Toolbars images MM undo_dis gif tooltip Undo file Menus MM Edit_Clipboard htm arguments undo update onEveryIdle button id D...

Страница 239: ...menu has an ID attached Dreamweaver passes that ID to canAcceptCommand instead of the value For combo boxes if the current contents of the text box do not match an entry in the pop up menu Dreamweaver...

Страница 240: ...This function is equivalent to the value attribute Arguments None Returns Dreamweaver expects a string that contains the current value to display For the color picker the string contains the RGB form...

Страница 241: ...ommand files In the menu command file Dreamweaver ignores the getDynamicContent function because the menu item is not marked as dynamic Arguments None Returns Dreamweaver expects an array of strings w...

Страница 242: ...e Returns Dreamweaver expects a string that contains a menu ID which is defined in the menus xml file Example function getMenuID var dom dw getDocumentDOM var menuID if dom var view dom getView var fo...

Страница 243: ...ible unlike menus For this reason you should always select the lowest frequency possible and make sure your enabled checked and value handlers are as simple as possible This function is equivalent to...

Страница 244: ...ing whether the text box matches Dreamweaver compares against the menu without case sensitivity If you specified the arguments attribute those arguments are passed next If you do not specify the argum...

Страница 245: ...t the command requires a valid DOM and synchronizes the Code view and Design view for the document before executing the associated command This function is equivalent to the domRequired attribute in a...

Страница 246: ...If you specified the arguments attribute those arguments are passed next If you did not specify the arguments attribute Dreamweaver passes the ID of the item Returns Dreamweaver expects nothing Exampl...

Страница 247: ...247 Returns Dreamweaver expects a Boolean value true if the item appears false otherwise Example function showif var retval false var dom dw getDocumentDOM if dom var view dom getView if view design r...

Страница 248: ...248 Toolbars...

Страница 249: ...ver uses its contents as the category name If _foldername txt is not present Dreamweaver uses the folder name as the category name When the user selects multiple site reports from the Reports dialog b...

Страница 250: ...s from the Site Reports tab of the Results panel Dreamweaver calls the beginReporting function in each report before the reporting process begins If a report returns a false value from this function i...

Страница 251: ...g box if needed To create the report definition 1 Create the file Configuration Reports HTML Reports List images htm 2 Add the following to specify the name of the report that you want to appear in th...

Страница 252: ...unction processFile Description Report command API called during file processing function processFile fileURL if isHTMLType fileURL If the file isn t an HTML file return skip it var curDOM dw getDocum...

Страница 253: ...lizes the title and format of the Results window by calling the setTitle and SetColumnWidths functions as methods of the Results window object 3 The command can either start adding items to the Result...

Страница 254: ...in the Configuration Commands folder List images htm which defines the UI of the dialog box that appears when the user selects the custom command and Listimages js which contains the JavaScript code...

Страница 255: ...0 i tagList length i Get the name of the source file imgfilename tagList i getAttribute src Get the character offset from the start of the file to the start of the img tag iOffset curDOM nodeToOffsets...

Страница 256: ...OM when it finishes Arguments strFilePath The strFilePath argument is the full path and filename of the file to process Returns Dreamweaver expects nothing beginReporting Availability Dreamweaver 4 De...

Страница 257: ...at should appear on the right side of the Options dialog box and their behavior when they are clicked If this function is not defined no buttons appear and the BODY section of the report file expands...

Страница 258: ...rt is selected Arguments None Returns Dreamweaver expects a Boolean value true if the Report Settings button should be enabled false otherwise windowDimensions Availability Dreamweaver 4 Description S...

Страница 259: ...ze of the entire dialog box because they do not include the area for the OK and Cancel buttons If the returned dimensions do not accommodate all options scroll bars appear Example The following instan...

Страница 260: ...260 Reports...

Страница 261: ...stores information about each tag including all tag attributes in a set of subfolders that reside in the Configuration TagLibraries folder The tag editor and Tag Chooser functions use the information...

Страница 262: ...t use VTML files in the same way as HomeSite The most important difference is that Dreamweaver contains its own HTML renderer that displays extension user interfaces UIs so the Dreamweaver VTML files...

Страница 263: ...Used to refer to the tag library in the UI Mandatory taglibrary doctypes Indicates the document types for which this library is active When the library is active library tags appear in the Code Hints...

Страница 264: ...raries vtm file Optional taglibrary tagchooser A relative path to the TagChooser xml file that is associated with this tag library Optional Attribute Description Mandatory optional tagref name Used to...

Страница 265: ...vidual tag tag name input bind value casesensitive no endtag no tagformat indentcontents yes formatcontents yes nlbeforetag nlbeforecontents 0 nlaftercontents 0 nlaftertag 1 tagdialog file input HTM a...

Страница 266: ...sing tag there is no matching input tag If the closing tag is optional the ENDTAG attribute should be set to Yes tag Specify xml to enforce XML syntax for an empty tag For example tag name foo endtag...

Страница 267: ...font family STYLE CSS styles attribute CSSSTYLE CSS class name CSSID CSS class ID FILEPATH a full file path DIRECTORY a folder path FILENAME filename only RELATIVEPATH a relative representation of th...

Страница 268: ...ser xml files or create new ones the TAGLIBRARY TAGCHOOSER attribute must point to the correct location for the Tag Chooser to be fully functional If there is no TAGLIBRARY TAGCHOOSER attribute the Ta...

Страница 269: ...ally exclusive tclibrary reference Value describes the language topic and subtopic to display in the Tag Info section of the Tag Chooser dialog box Interchangeable with tclibrary desc Optional desc an...

Страница 270: ...e Value that is either placed directly into the code or a parameter that passes into visual dialog boxes Mandatory element desc Value is an HTML string and appears in the incorporated Reference panel...

Страница 271: ...nd the TagLibraries vtm file in the user s Configuration folder it searches for the file in the Dreamweaver Configuration folder The cfweather tag is a ColdFusion tag so an appropriate tag library gro...

Страница 272: ...ather vtm file in the Configuration Taglibraries CFML folder Using the tag definition file Dreamweaver can perform code hinting code completion and tag formatting functionality for the cfweather tag C...

Страница 273: ...deObj theUIObjects function initializeUI define two arrays for the values and display captions for the list control var theTempatureScaleCap new Array celsius fahrenheit var theTempatureScaleVal new A...

Страница 274: ...odify the TagChooser xml file in the Configuration Taglibraries CFML folder by adding a new category called Third Party Tags which features the cfweather tag as shown in the following example category...

Страница 275: ...an argument the tag that the user is editing which is expressed as a dom object The function extracts attribute values from the tag that is being edited and uses these values to initialize form elemen...

Страница 276: ...er is entered for the number of table rows The validateTag function detects the invalid input displays an alert message and returns a false value applyTag Availability Dreamweaver MX Description When...

Страница 277: ...cfweather example in the following code if the user changes the ZIP code from 94065 to 53402 in order to update the user s document to use the new ZIP code the dom object must be updated function appl...

Страница 278: ...278 Tag Libraries and Editors...

Страница 279: ...or create new ones to inspect custom tags Custom Property inspector files reside in the Configuration Inspectors folder inside the Dreamweaver application folder The following table lists the files y...

Страница 280: ...indicates the server model of the Property inspector If the server model of the Property inspector is not the same as the server model for the document Dreamweaver does not use the Property inspector...

Страница 281: ...has one or more inspectors Dreamweaver calls each inspector s canInspectSelection function If this function returns the value false Dreamweaver no longer considers the inspector a candidate for inspec...

Страница 282: ...perty inspector To create the user interface 1 Create a new blank file 2 As the first line of the file add the comment that identifies the property inspector as follows tag MARQUEE priority 9 selectio...

Страница 283: ...ght Right OPTION SELECT TR TABLE FORM SPAN 5 Save the file as marquee htm in the Configuration Inspectors folder Writing the JavaScript code You need to add JavaScript functions to make sure you can i...

Страница 284: ...ionIndex 1 document topLayer document topLayerForm marqDirection selectedIndex directionIndex 4 To get the current selection and make the text box in the Property inspector display the direction attri...

Страница 285: ...Restart Dreamweaver 2 Create a new HTML page or open an existing HTML page 3 Add the following in the BODY section of the page MARQUEE MARQUEE 4 Highlight the text you just added The Property inspecto...

Страница 286: ...theObj hasAttribute classid theObj getAttribute classid toLowerCase clsid D27CDB6E AE6D 11cf 96B8 444553540000 displayHelp Description If this function is defined a question mark icon appears in the u...

Страница 287: ...ng on whether the Property inspector is in its expanded or contracted state Returns Dreamweaver expects nothing Example The following example of the inspectSelection function gets the value of the CON...

Страница 288: ...288 Property Inspectors...

Страница 289: ...d to form elements can call JavaScript code that performs arbitrary edits to the current document Dreamweaver has several built in floating panels that are accessible from the Window menu These built...

Страница 290: ...ity dreamweaver setFloaterVisibility or dreamweaver toggleFloater For more information on these functions see the Dreamweaver API Reference When one of the files inside the Configuration folder calls...

Страница 291: ...visible at the last shutdown and displays the floating panels in their last position and tab grouping A simple floating panel example In this example you create a Script Editor extension that creates...

Страница 292: ...ese two floating panels or layers called blanklayer and scriptlayer To create the two floating panels 1 Add the following code after the header in the HTML file body div id blanklayer style position a...

Страница 293: ...the selected code has changed the updateScript function is called to write the changed text back to the document Writing the JavaScript code The JavaScript code for the Script Editor consists of one...

Страница 294: ...ected node for that document is first an element and second a SCRIPT tag If both these conditions are true the selectionChanged function makes the scripteditor floating panel visible and loads it with...

Страница 295: ...Configuration Floaters folder 2 Enter the following code in the header section of the file function selectionChanged get the selected node var theDOM dw getDocumentDOM var theNode theDOM getSelectedNo...

Страница 296: ...tion updateScript var theDOM dw getDocumentDOM var theNode theDOM getSelectedNode theNode innerHTML document layers scriptlayer document theForm scriptCode value script head 3 Save the file Creating a...

Страница 297: ...Tile _Vertically and position the cursor after the closing of the tag 3 On a new line insert the following menuitem name Script Editor enabled true command dw toggleFloater scriptEditor checked dw get...

Страница 298: ...be defined only if the floating panel must track edits to the document Arguments None Returns Dreamweaver expects nothing Example The following example of the documentEdited function scans the docume...

Страница 299: ...side of the Dreamweaver workspace or to each other Arguments None Returns Dreamweaver expects a string containing the words left right top and bottom or a combination of them that specifies where Dre...

Страница 300: ...ion Determines which other floating panels are tabbed together the first time that this floating panel appears If any listed floating panel has appeared previously it is not included in the tab group...

Страница 301: ...bine this panel with others Arguments None Returns Dreamweaver expects a Boolean value true if other floating panels can dock to this one false otherwise Example IsATarget return true isAvailableInCod...

Страница 302: ...anel false otherwise Example The following example prevents the user from resizing the floating panel function isResizable return false selectionChanged Description Called when the floating panel beco...

Страница 303: ...ctionChanged functions are called after every keystroke and mouse click when Dreamweaver is idle for more than one tenth of a second It s important to use different scenarios to test your floating pan...

Страница 304: ...processing the previous edit then the timer is already set if document running false setTimeout processLayer 500 set the processing flag to true document running true process one layer function proces...

Страница 305: ...t indicate which layers to display or hide The HEAD section of an Action file contains JavaScript functions that process form input from the BODY content and control the functions arguments and event...

Страница 306: ...m the Event file 2 The user selects an action from the Actions pop up menu 3 Dreamweaver calls the windowDimensions function to determine the size of the Parameters dialog box If the windowDimensions...

Страница 307: ...This is a link return true But if Dreamweaver inserts the return behaviorName args action into the event handler behaviors later in the list are skipped To get around this limitation set the document...

Страница 308: ...rand title meta http equiv Content Type content text html script language JavaScript The function that will be inserted into the HEAD of the user s document function checkBrowserBrand netscapeURL expl...

Страница 309: ...the contents if any function initializeUI document theForm nsURL focus document theForm nsURL select Let the user browse to the Navigator and IE URLs function browseForURLs whichButton var theURL dre...

Страница 310: ...es to browse 1 Create a new file with the following content DOCTYPE HTML PUBLIC W3C DTD HTML 4 01 Transitional EN http www w3 org TR html4 loose dtd html head meta http equiv Content Type content text...

Страница 311: ...to the URL if the browser is Netscape Navigator text box and select the netscapecontent htm file 10 Click the Browse button next to the Go to the URL if the browser is Internet Explorer text box and...

Страница 312: ...nserts into the user s document an event handler that calls the function that the behaviorFunction function inserts The applyBehavior function can also perform other edits on the user s document but i...

Страница 313: ...user specified parameters the height and width of the window whether the window should have scroll bars a toolbar a location bar and other features and the URL that should open in the window function...

Страница 314: ...erted only once regardless of how many times the action is applied to elements in the document Example The following instance of the behaviorFunction function returns the MM_popupMsg function function...

Страница 315: ...nding order of preference for this action Specifying preferred events overrides the default event as denoted with an asterisk in the Event file for the selected object See step 1 in How Behaviors work...

Страница 316: ...nsHelp superDuperHelp htm dw browseDocument myHelpFile deleteBehavior Description This function undoes any edits that the applyBehavior function performed Arguments applyBehaviorString This argument i...

Страница 317: ...ifies that the argument is a navigational URL and therefore it should appear in the site map The dep argument type specifies that the argument is a dependent file URL and therefore it should be includ...

Страница 318: ...n with a minimum number of arguments of 4 may have 4 8 or 12 arguments but it cannot have 10 arguments function identifyBehaviorArguments fnCallStr var listOfArgTypes var itemArray dreamweaver getToke...

Страница 319: ...at the user selected when the behavior was originally applied function inspectBehavior msgStr var startStr msgStr indexOf 1 var endStr msgStr lastIndexOf if startStr 0 endStr startStr document theForm...

Страница 320: ...e smaller than the size of the entire dialog box because they do not include the area for the OK and Cancel buttons If the returned dimensions do not accommodate all options scroll bars appear Example...

Страница 321: ...pports server behavior extensions that add runtime code for the following server models ASP Net C ASP Net VisualBasic ASP JavaScript ASP VBScript ColdFusion JSP and PHP MySQL The following terms are u...

Страница 322: ...additional functionality The architecture simplifies your implementation of the API and also separates your runtime code from how Dreamweaver deploys it This chapter discusses ways of modifying these...

Страница 323: ...e_attr partType identifier groupParticipants group In the groupParticipants block tag each groupParticipant tag indicates the EDML participant file that contains the code block to use The value of the...

Страница 324: ...untime code and extracts specific parameters For more details see Server behavior techniques on page 369 The script file Each server behavior also has an HTML file that contains functions and links to...

Страница 325: ...2 In the New Server Behavior dialog box select Document Type ASP JavaScript and Name Hello World Leave the Copy existing server behavior checkbox unchecked 3 Click OK Defining the code to insert Final...

Страница 326: ...object If it is implemented Dreamweaver calls the analyzeServerBehavior function for each behavior instance that is found in the user s document after all the findServerBehaviors functions are called...

Страница 327: ...button in the Server Behaviors panel the pop up menu appears To determine the content of the menu Dreamweaver first looks for a ServerBehaviors xml file in the same folder as the behaviors ServerBehav...

Страница 328: ...the copyServerBehavior function returns Dreamweaver converts the server behavior object to a form that can be put on the Clipboard When Dreamweaver converts the object it deletes all the properties t...

Страница 329: ...nction is to notice when two or more behaviors refer to the same tag in the user s document In this case the deleted property removes all but one behavior from the array Suppose the Recordset1 Dynamic...

Страница 330: ...the user s document Dreamweaver calls this function when the user clicks OK in the Server Behaviors dialog box If this function returns successfully the Server Behaviors dialog box closes If this fun...

Страница 331: ...Behavior function is optional Users can copy instances of the specified server behavior In the following example this function is implemented for recordsets If a user selects a recordset in the Server...

Страница 332: ...ocument It is called when the user clicks the Minus button on the Server Behaviors panel It can edit a user s document For more information see dwscripts deleteSB on page 337 Arguments serverBehavior...

Страница 333: ...finds the findServerBehaviors function creates a JavaScript object and it attaches state information as JavaScript properties of the object The four required properties are incomplete participants ti...

Страница 334: ...ehavior Dreamweaver organizes the contents of the Clipboard and generates a new behavior object The new object is identical to the original except that it lacks pointer properties Dreamweaver passes t...

Страница 335: ...y weights array types array selectedNode value and incomplete flag This function also creates a parameter object that holds an array of user definable properties such as recordset name and column name...

Страница 336: ...rtion text Arguments paramObj sbObj The paramObj argument is the object that contains the user parameters The sbObj argument is the prior server behavior object if you are updating an existing server...

Страница 337: ...that you want to remove from the user s document Returns Dreamweaver expects nothing Example The following example deletes all the participants of the sbObj server behavior except the participants th...

Страница 338: ...or parameter values need to be extracted from the instances of the runtime code You use regular expressions for the extraction process You should understand a few metacharacters and metasequences spec...

Страница 339: ...e code The CDATA tag represents character data and is any text that is not EDML markup When you use the CDATA tag the EDML parser won t try to interpret it as markup but instead considers it as a bloc...

Страница 340: ...in the EDML group files group Description This tag contains all the specifications for a group of participants Parent None Type Block tag Required Yes group attributes The following items are valid at...

Страница 341: ...weaver call the findServerBehaviors function In some cases if multiple groups are associated with a single server behavior the server behavior must resolve which particular group to use Parent group T...

Страница 342: ...vior Repeat Region htm dataSource myCOMdataSource htm This group defines a new implementation of the Repeat Region server behavior to use if you use the COM data source In the applyServerBehaviors fun...

Страница 343: ...rtVersion attribute In the applyServerBehaviors function you can indicate which group should be applied by setting the MM_subType property on the parameter object as shown in the following example fun...

Страница 344: ...tag Required Yes groupParticipants attributes The following items are valid attributes of the groupParticipants tag selectParticipant Description Indicates which participant should be selected and hig...

Страница 345: ...on This tag represents the inclusion of a single participant in the group Parent groupParticipants Type Tag Required Yes at least one groupParticipant attributes The following items are valid attribut...

Страница 346: ...default value if the partType attribute is not specified The member value is a normal member of a group If it is found by itself it does not identify a group If it is not found in a group the group i...

Страница 347: ...this release of Dreamweaver all groups and participants that the Server Behavior Builder creates have the version attribute set to 7 0 For participant files this attribute determines if code block mer...

Страница 348: ...ue is a literal string that exists on the page if the participant exists The string should be as unique as possible to maximize performance but the string does not have to be definitively unique It is...

Страница 349: ...igns Because this text can interfere with the EDML structure it should use the CDATA construct as shown in the following example insertText location aboveHTML CDATA recordset cursorType insertText Whe...

Страница 350: ...provided it is internally assigned a weight of 100 and is added below all specifically weighted participants as shown in the following example insert location aboveHTML The belowHTML weight value is...

Страница 351: ...g useful for adding hidden form fields nodeAttribute attribute sets an attribute of a tag node If the attribute does not already exist this value creates it For example use insert location nodeAttribu...

Страница 352: ...dwscripts applySB paramObj sbObj You can indicate the form__tag node parameter in your EDML file as shown in the following example insertText location lastChildOfNode nodeParamName form__tag CDATA in...

Страница 353: ...erver specific tags For ASP and JSP this means search all script blocks The tag tagName value searches the contents of a specified tag as shown in the following example searchPatterns whereToSearch ta...

Страница 354: ...nd extracts parameter values from it Each parameter subexpression must be enclosed in parentheses You can have patterns with no parameters which are used to identify participant text patterns with one...

Страница 355: ...rn searchPattern paramNames optionLabel limitSearch innerOnly searchPattern searchPatterns This example sets the optionLabel parameter to the entire innerHTML contents of an OPTION tag searchPattern a...

Страница 356: ...ct multiple parameters using a single pattern use a comma separated list of parameter names in the order that the subexpressions appear in the pattern Suppose the following example shows your search p...

Страница 357: ...rched If that attribute is not defined the tag is ignored The tagOnly value searches only the outer tag and ignores the innerHTML tag This value is valid only if whereToSearch is a tag The innerOnly v...

Страница 358: ...wing example searchPattern paramNames rs var w Server CreateObject searchPattern searchPattern paramNames src ActiveConnection r n searchPattern searchPattern paramNames conn Source r n searchPattern...

Страница 359: ...ter between two parenthetical subexpressions in the form pre pattern parameter pattern post pattern You need to define at least one update pattern for each unique paramName in the insertion text The f...

Страница 360: ...wing example Recordset1 CursorType 0 Recordset1 CursorLocation 2 Recordset1 LockType 3 To update the recordset name in all three positions you need three update patterns for a single parameter as show...

Страница 361: ...participant Without this tag the participant is deleted by removing it completely but only if no server behaviors refer to it By specifying a delete tag you can specify that it should never be deleted...

Страница 362: ...nnerHTML tag For attributes it removes only the value It is meaningless for directives The attribute attribName value when applied to tags removes only the specified attribute It is meaningless for di...

Страница 363: ...thin the text being searched the search patterns have a logical AND relationship unless they are marked as optional using the isOptional flag Parent translator Type Block tag Required Yes translations...

Страница 364: ...e Block tag Required No translation attributes The following items are valid attributes of the translation tag whereToSearch Description This attribute specifies where to search for the text which is...

Страница 365: ...a dynamic image dynamic source tabbed region start tabbed region end custom The dynamic data value indicates that the translated directives look and behave the same as Dreamweaver dynamic data as show...

Страница 366: ...l Dreamweaver functionality is added to the translation It is often used when specifying a tag to insert for a custom Property inspector as shown in the following example translation whereToSearch dir...

Страница 367: ...Required No attribute Description This tag specifies a single attribute or translated attribute to add to the translated tag Parent attributes Type Block tag Required Yes at least one Values The attr...

Страница 368: ...rs col display causes the translation to render as myRecordset myCol closeTag Description This optional tag should be inserted at the end of the translated section This tag enables certain other exte...

Страница 369: ...process of finding server behavior instances If this string is found in the document and the participant identifies a server behavior in the group file partType identifier for this participant the re...

Страница 370: ...h as a telephone number For such an example you could use the following ASP code address block LNAME joe FNAME smith PHONE 123 4567 You could use the following search patterns quickSearch address quic...

Страница 371: ...ically matched as shown in the following example of a server behavior with group file group serverBehavior test htm title Test title groupParticipants groupParticipant name test_p1 partType identifier...

Страница 372: ...lection here end mySBName More HTML here if expression mySBName Another HTML selection here end mySBName Now there are two identical instances of each participant which is allowed within the HTML They...

Страница 373: ...as those for include files When Dreamweaver creates server models it builds lists of patterns by scanning all the participants for special paramNames attributes To find URLs to check file dependency...

Страница 374: ...ayer Dreamweaver internally splits the document into directives straight text and tags parsed into an efficient tree structure Updating server behaviors Replacement update By default participant EDML...

Страница 375: ...F searchPattern searchPattern paramNames new__url if s r n s Response Redirect r n i searchPattern searchPatterns These shortened search patterns are flexible so the user can add to the code However i...

Страница 376: ...o limit participant deletion There might be cases where you want to limit the way that participants are deleted This can be achieved by adding a delete tag to the EDML file The following example shows...

Страница 377: ...the code is implicitly included in all HTML files thereafter NO TE Because JavaScript files that are loaded into this central location share memory the files cannot duplicate any declarations If a sha...

Страница 378: ...378 Server Behaviors...

Страница 379: ...JSP and PHP MySQL Within each server model subfolder are HTML and EDML files that are associated with the data sources for that server model The following table lists the files you use to create a da...

Страница 380: ...he filename is used in the menu After Dreamweaver finishes reading the DataSources xml file or if the file does not exist Dreamweaver searches the rest of the folder to find other items that should ap...

Страница 381: ...namic Text dialog box or clicks Insert or Bind in the Bindings panel Dreamweaver calls the generateDynamicDataRef function The return value is inserted in the document at the current insertion point 7...

Страница 382: ...el for Macromedia ColdFusion documents Users can specify the variable they want from the new data source This example creates a data source called MyDatasource which includes a MyDatasource js JavaScr...

Страница 383: ...of the findDynamicSources function To create the data source definition file 1 Create a new blank file 2 Enter the following HTML HEAD TITLE MyDatasource TITLE SCRIPT SRC Shared Common Scripts dwscri...

Страница 384: ...he name of the supporting script files and the code for the working Dreamweaver document you need to specify the JavaScript functions for Dreamweaver to provide the user with the ability to add insert...

Страница 385: ...e function findDynamicSources var retList new Array var siteURL dw getSiteRoot if siteURL length var bindingsArray dwscripts getListValuesFromNote siteURL MyDatasource if bindingsArray length 0 Here y...

Страница 386: ...taRef sourceName bindingName dropObject var paramObj new Object paramObj bindingName bindingName var retStr extPart getInsertString MyDatasource_DataRef paramObj We need to strip the cfoutput tags if...

Страница 387: ...DynamicSource function contains the command dw popupCommand MyDatasrouce_Variable which opens a dialog box for the user to enter a specific variable name However you still need to create the dialog bo...

Страница 388: ...head body form div ALIGN center table border 0 cellpadding 2 cellspacing 4 tr td align right valign baseline nowrap Name td td valign baseline nowrap input name theName type text class medTField td t...

Страница 389: ...mName else alert MM MSG_NoName 3 Save the file as MyDatasource_Variable js in the Configuration Commands folder Testing the new data source You can now open Dreamweaver or restart it if you already ha...

Страница 390: ...g box you created appears 3 Enter a value in the dialog box and click OK The Bindings panel displays the data source in a tree with the variable from the dialog box under the data source name 4 Drag t...

Страница 391: ...eamweaver calls the dw serverBehaviorInspector popupServerBehavior function which inserts a new server behavior into the document For request session and application variables Dreamweaver displays an...

Страница 392: ...f all the data sources for the user s document Arguments sourceName bindingName The sourceName argument is the name of the top level node to which the child node is associated The bindingName argument...

Страница 393: ...ame The sourceName argument is the name of the top level node to which the child node is associated The bindingName argument is the name of the child node Returns Dreamweaver expects a Boolean value t...

Страница 394: ...rce property is the simple name of the file in which the findDynamicSources function is defined For example the findDynamicSources function in the Session htm file which is located in the Configuratio...

Страница 395: ...children of a top level node Arguments sourceName The sourceName argument is the name of the top level node whose children you want to return Returns Dreamweaver expects an array of JavaScript object...

Страница 396: ...es the corresponding node in the data source tree from a dynamic data object The inspectDynamicDataRef function takes the string that Dreamweaver passes in and compares it to the string that generateD...

Страница 397: ...I 397 Arguments string The string argument is the dynamic data object Returns Dreamweaver expects an array of two elements parent name and child name for the matched node it returns a null value if no...

Страница 398: ...398 Data Sources...

Страница 399: ...e user s document Before inserting the string into the user s document Dreamweaver passes that string to the formatDynamicDataRef function which is described in this chapter The string that the format...

Страница 400: ...eName attribute is the HTML file for this format type such as Currency The title string attribute is the string that appears in the Format menu such as Currency default The expression regexp attribute...

Страница 401: ...format The Edit Format List Plus menu If you do not want a file in the ServerFormats folder to appear in the Edit Format List Plus menu add the following statement as the first line of the HTML file M...

Страница 402: ...e deleteFormat function removes the support scripts from the document When the user clicks the Plus button in the Edit Format List dialog box Dreamweaver displays a menu that contains all the format t...

Страница 403: ...propriate format function Dreamweaver adds the function declaration by calling the applyFormat JavaScript function in the data format file It changes the dynamic data object by calling the formatDynam...

Страница 404: ...ction completes successfully If an error occurs the function returns an error string If it returns an empty string the form is closed but the new format is not created which is the same as a Cancel op...

Страница 405: ...data object by calling the formatDynamicDataRef function The formatDynamicDataRef function is called when the user selects a format from the Format text box in the Dynamic Data or the Dynamic Text dia...

Страница 406: ...n the Edit Format List dialog box Arguments format The format argument is a JavaScript object that describes the format to apply The JavaScript object is the node that corresponds to the format tag in...

Страница 407: ...erent technologies offer programmers different ways to accomplish this encapsulation and different names describe these strategies functions modules and others Macromedia Dreamweaver 8 uses the term c...

Страница 408: ...ture of the component and making its fields methods and properties available through Dreamweaver Finally server models such as ASP NET JSP J2EE or ColdFusion tend to support some but not all component...

Страница 409: ...Component files are stored in the Configuration Components server model ComponentType folder You can add other server models and supporting server extensions for more information see Chapter 19 Server...

Страница 410: ...ename Description Required Optional htm The extension file that identifies other supporting JavaScript and GIF files Required js The extension file that implements the Component API callback Required...

Страница 411: ...e in a tree control must have the following properties TI P When adding a new service you might want to use the Components panel to browse meta information so that the information is readily available...

Страница 412: ...the API functions for populating the Components panel getComponentChildren Availability Dreamweaver MX Description This function returns a list of child ComponentRec objects for the active parent Comp...

Страница 413: ...return DWWebServicesContext Where DWWebServicesContext is defined in the file in the Configuration Components ASP NET_CSharp WebServices WebServicesMenus xml as follows shortcutlist id DWWebServicesCo...

Страница 414: ...ent Example The following example identifies the code for a common web service function getCodeViewDropCode componentRec var codeToDrop if componentRec if componentRec objectType Class codeToDrop dw g...

Страница 415: ...he text instructions which can include any HTML markup that is legal inside a li tag You can include hypertext links a tags in the list of steps by using the following form a href onMouseDown handler...

Страница 416: ...me else var aServerModelName site getServerDisplayNameForSite if aServerModelName length if aServerModelName ColdFusion if needsSDKInstalled null doSDK needsSDKInstalled var someSteps new Array someSt...

Страница 417: ...anel or a component from the Components panel to the Design view Arguments componentRec The componentRec argument is an object that contains the following properties The name property is the name of t...

Страница 418: ...e if componentRec if componentRec objectType Table componentRec objectType View alert popup Recordset Server Behavior bHandled true return bHandled handleDoubleClick Availability Dreamweaver MX Descri...

Страница 419: ...a Boolean value that indicates whether the tree node item can be dragged and dropped into Code view The isDesignViewDraggable property is a Boolean value that indicates whether the tree node item can...

Страница 420: ...ext Tooltip for the toolbar button toolStyle Left right enabled JavaScript code that returns a Boolean value true or false The enablers are called when the following conditions exist When the dreamwea...

Страница 421: ...utton disabledImage PLUS_BUTTON_UP plusButton toolStyle left plusButton toolTipText MM MSG_WebServicesAddToolTipText plusButton enabled dwscripts IS_WIN plusButton command invokeWebService else plusBu...

Страница 422: ...ONDOWN deployWServiceButton disabledImage DEPLOYSUPPORTBUTTONUP deployWServiceButton toolStyle right deployWServiceButton toolTipText MM MSG_WebServicesDeployToolTipText deployWServiceButton command s...

Страница 423: ...weaver For cases when the user does not identify a server model you can create a dynamic dialog box that prompts the user to complete the necessary steps This dialog box appears when the user attempts...

Страница 424: ...weaver getDocumentDOM function Returns Dreamweaver expects an integer that indicates the priority that you give to the server model for the file extension This function should return a value of 1 if t...

Страница 425: ...lity Dreamweaver MX Description This function returns an object that describes the method and array signatures that the scripting language uses The getLanguageSignatures function helps map generic sig...

Страница 426: ...es are located in the Configuration ServerModels folder Arguments None Returns Dreamweaver expects an object that defines the scripting language signatures This object should map the generic signature...

Страница 427: ...0 return obj getServerLanguages Availability Dreamweaver UltraDev 1 deprecated in Dreamweaver MX Description This function returns the supported scripting languages of a server model with an array of...

Страница 428: ...he supported scripting languages getServerModelExtDataNameUD4 Availability Dreamweaver MX Description This function returns the server model implementation name that Dreamweaver should use when access...

Страница 429: ...rticipateInMerge property is a Boolean value that specifies whether the content enclosed in the listed delimiters should true or should not false participate in block merging getServerModelDisplayName...

Страница 430: ...r supports the specified character set From JavaScript you can determine whether the server model supports a specific character set by calling the dom serverModel getServerSupportsCharset function Arg...

Страница 431: ...r Model API functions 431 Arguments None Returns Dreamweaver expects an array of version objects each with a version name and version value as listed in the following examples ASP version 2 0 ADODB ve...

Страница 432: ...432 Server Models...

Страница 433: ...do not require locks which makes it simple to inspect the tags that contain them Data translation especially for entire tags or blocks of code might involve complex operations that either cannot be d...

Страница 434: ...n view after making changes in the HTML panel or in Code view Changes the properties of an object in the current document Inserts an object using either the Objects panel or the Insert menu Refreshes...

Страница 435: ...aver You must write a custom Property inspector for the translated content if you want users to be able to change the properties of the original code see Locking translated tags or blocks of code on p...

Страница 436: ...nslatedValue attribute can contain more than one valid attribute value pair Consider the following untranslated code img if dayType weekday then src open jpg width 320 height 100 else src closed jpg w...

Страница 437: ...attributes If both a translated value and a regular value are set for a particular attribute Dreamweaver displays the translated value in the Document window You must decide whether your translator s...

Страница 438: ...spectors For example specifying type IMG does not make the Image panel appear The dependentFilesList value is a string that contains a comma separated list of files on which the locked markup depends...

Страница 439: ...eaver 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 h...

Страница 440: ...tches this Property inspector as shown in the following example if theSelection nodeType node ELEMENT_NODE theSelection getAttribute type happy return true else return false To populate the text boxes...

Страница 441: ...omment into the document replacing the old one by rewriting the contents of the document which generates a new orig attribute The following code summarizes this technique Assemble the new include comm...

Страница 442: ...add the following function function commandButtons return new Array OK translateMarkup dreamweaver getDocumentPath document dreamweaver getSiteRoot dreamweaver getDocumentDOM documentElement outerHTM...

Страница 443: ...etter understand attribute translation it s helpful to look at an example The following translator is Pound Conditional Poco markup a syntax that s somewhat similar to ASP or PHP You create the attrib...

Страница 444: ...pe content text html charset script language JavaScript This translator handles the following statement syntaxes if condition then foo else bar if condition then att foo else att bar if condition then...

Страница 445: ...tokens An array of all the attributes set in the true case var end The end of the current conditional statement As long as there s still a conditional that hasn t been translated while start 1 back3F...

Страница 446: ...okens j if j 0 spacer transAtt spacer tokens j transAtt outStr outStr substring 0 end 3 transAtt outStr substring end 3 If attAndValue is true and tokens is not greater than 1 then trueValue is a sing...

Страница 447: ...any functionality The following translator example would be more efficient if it were written in C but the JavaScript version is simpler which makes it perfect for demonstrating how translators work A...

Страница 448: ...y 5 byExpression run if the file contains kent return returnArray The translateMarkup function performs the actual translation In this translator the translateMarkup function is written entirely in Ja...

Страница 449: ...6 Use the string you just created for the next trip through the document This is the most inefficient part of all inStr outStr start inStr indexOf kent When there are no more KENT tags in the document...

Страница 450: ...r day today getUTCDay Day of the week in the GMT time zone 0 Sunday 1 Monday and so on var hour today getUTCHours The current hour in GMT based on the 24 hour clock var SFhour hour 8 The time in San F...

Страница 451: ...e if SFhour 16 SFhour 17 If user is on Mac show Kent working on Mac if platform MacPPC imageRef images kent_gettingStartedOnMac jpg If user is on Win show Kent working on Win else imageRef images kent...

Страница 452: ...pecifies the number of file extensions to follow If nExtensions is zero the translator can run on any file If nExtensions is zero nRegExps is the next element in the array 4 The extension string speci...

Страница 453: ...nfo var transArray new Array 11 transArray 0 SSI transArray 1 Server Side Includes transArray 2 4 transArray 3 htm transArray 4 stm transArray 5 html transArray 6 shtml transArray 7 2 transArray 8 inc...

Страница 454: ...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 translateMa...

Страница 455: ...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 co...

Страница 456: ...456 Data Translators...

Страница 457: ...efine a Dreamweaver object that inserts the contents of a user specified file into the current document Because client side JavaScript does not provide support file input output I O you must write a f...

Страница 458: ...Convert the argument to a string fileName JS_ValueToString cx argv 0 length if fileName NULL JS_ReportError cx The argument must be a string 0 return JS_FALSE Use the string the file name to open and...

Страница 459: ...ons When the function is called to parse the arguments that JavaScript is passing to C Before the function returns to package the return value To accomplish these tasks the interpreter defines several...

Страница 460: ...pe passes to the C level function This data type represents an object which might be an array object or some other object type typedef struct jsval jsval An opaque data structure that can contain an i...

Страница 461: ...arguments being passed to the function The argv pointer is a pointer to an array of jsval structures The array is argc elements in length The rval pointer is a pointer to a single jsval structure The...

Страница 462: ...x jsval v unsigned int pLength The cx argument is the opaque JSContext pointer that passes to the JavaScript function The v argument is the jsval structure from which the string is to be extracted The...

Страница 463: ...rguments JSContext cx jsval v double dp The cx argument is the opaque JSContext pointer that passed to the JavaScript function The v argument is the jsval structure from which the double is to be extr...

Страница 464: ...he object is to be extracted The op argument is a pointer to a JSObject pointer This function stores the converted value in op Returns A Boolean value JS_TRUE indicates success JS_FALSE indicates fail...

Страница 465: ...text pointer that passes to the JavaScript function The dv argument is an 8 byte floating point number The vp argument is a pointer to the jsval structure into which the contents of the double should...

Страница 466: ...ine its contents Arguments JSObject obj The obj argument is a pointer to the JSObject object that you want to convert to a JSVal structure Returns A JSVal structure that contains the object that you p...

Страница 467: ...hold The v argument is an optional pointer to the jsvals to be stored in the array If the return value is not null v is an array that contains length elements If the return value is null the initial...

Страница 468: ...ructure in the array should be copied Returns A Boolean value JS_TRUE indicates success JS_FALSE indicates failure JSBool JS_SetElement Description This function writes a single element of an array ob...

Страница 469: ...the null terminated string is computed automatically The rval argument is a pointer to a single jsval structure The function s return value is stored in rval Returns A Boolean value JS_TRUE indicates...

Страница 470: ...ting systems to create and maintain individual configurations Dreamweaver creates a separate Configuration folder for each user Whenever Dreamweaver or a JavaScript extension writes to the Dreamweaver...

Страница 471: ...Dreamweaver Configuration Objects Common Table htm Dreamweaver searches for a Table htm file in the C Documents and Settings username Macromedia Dreamweaver Configuration Objects Common folder and if...

Страница 472: ...ries to call dw getDocumentDom file c Program Files Macromedia Dreamweaver Configuration Snippets javascript onepixelborder csn it returns a null value You can modify the mm_deleted_files xml file to...

Страница 473: ...mweaver MX Description This function checks whether the specified file exists If it is a file in a configuration folder the function searches for the file in the user Configuration folder or the Dream...

Страница 474: ...Configuration folder the MM_OpenConfigFile function resolves the path before opening the file The char mode argument points to a string that specifies how you want to open the file You can specify nu...

Страница 475: ...r the MM_GetConfigFileAttributes function resolves the path before opening the file The unsigned long attrs argument is the address of an integer that contains the returned attribute bits see JSBool M...

Страница 476: ...the specified file URL is in the Dreamweaver Configuration folder this function first copies the file to the user Configuration folder before it sets the attributes If the attributes are the same as t...

Страница 477: ...folder within the Dreamweaver Configuration folder the function creates the folder in the user Configuration folder If fileURL does not specify a folder in the Dreamweaver Configuration folder the fun...

Страница 478: ...FALSE indicates failure Example char dwConfig file c Program Files Macromedia Dreamweaver Configuration Objects MM_RemoveConfigFolder dwConfig JSBool MM_DeleteConfigFile Availability Dreamweaver MX De...

Страница 479: ...nfo h file provides access to the Design Notes API The Sample c example file defines the computeSum function The Sample mak makefile lets you build the Sample c source file into a DLL with Microsoft V...

Страница 480: ...tion folder within the Dreamweaver application folder 2 Copy Sample dll Windows or Sample bundle Macintosh to the JSExtensions folder 3 In a text editor open the HR htm file in the Configuration Objec...

Страница 481: ...481 4 PART 4 Appendix Find information about supporting files and reference resources that can aid in developing Macromedia Dreamweaver 8 extensions Appendix The Shared Folder 483...

Страница 482: ......

Страница 483: ...d folder contents The Shared folder has subfolders that contain files shared by multiple extensions including functions for browsing a user s folder system inserting a tree control creating editable g...

Страница 484: ...findDynamicSources DBTreeControlClass js Contains functions that build a database tree control This class is used to create and interact with a database tree control To create a database tree control...

Страница 485: ...xample calling a stored procedure using SQL to return a recordset and so on This is an abstract base class which means that it cannot be created and used on its own To use it you must subclass SBDatab...

Страница 486: ...tributes from within the opening tag of a given node parse a CFC tree get the current URL DOM get the CFC DOM and more event js Contains functions to register events notify parties of events from the...

Страница 487: ...tween the UIs sbUtils js Contains shared functions for use within Macromedia server behaviors The dwscripts class in the Configuration Shared Common Scripts folder contains more general purpose utilit...

Страница 488: ...PreferencesClass js Contains an object and methods that contain all the preference information for a command RadioGroupClass js Older version of the RadioGroupClass in the Common folder See the Radio...

Страница 489: ...rmine if a specified file is currently open form js Contains functions that add a form around a given text string if a form does not already exist in the current document or layer Includes functions t...

Страница 490: ...location each time string js Contains a generic set of functions for manipulating and parsing text strings Functions include extractArgs escQuotes unescQuotes quoteMeta errMsg badChars getParam quote...

Страница 491: ...nk htm in the application folder Configuration Objects Common Notice that the head tag of the file contains the following lines script language javascript src Shared Common Scripts ListControlClass js...

Страница 492: ...492 The Shared Folder...

Страница 493: ...312 applyFormat 403 applyFormatDefinition 403 applySB 336 applyServerBehavior 330 applyTag 276 appName property 135 appVersion property 135 arguments passed from menuitem 196 receiveArguments 212 arg...

Страница 494: ...tensibility API JS_BooleanToValue 465 JS_DoubleToValue 465 JS_ExecuteScript 469 JS_GetArrayLength 467 JS_GetElement 468 JS_IntegerToValue 466 JS_NewArrayObject 467 JS_ObjectToValue 466 JS_ObjectType 4...

Страница 495: ...description tag 58 function tag 61 menu tag 59 menugroup tag 58 menuitem tag 60 code snippet extensions definition 101 code validation 92 CodeHints xml file contains 56 description of 55 color button...

Страница 496: ...data translator extensions definition 101 data translators debugging 442 for attributes 435 for tags or blocks of code 437 kinds of 435 user experience 434 database controls 116 database tree control...

Страница 497: ...te 351 openTag 366 paramName attribute 360 paramNames attribute 355 participant 347 partType attribute 346 quickSearch 348 searchPatterns 352 353 363 selectParticipant attribute 344 subType attribute...

Страница 498: ...code coloring 73 G generateDynamicDataRef 394 generateDynamicSourceBindings 395 getAttribute 132 getCodeViewDropCode 414 getComponentChildren 412 getContextMenuId 413 getCurrentValue 240 getDockingSid...

Страница 499: ...ew 301 isCommandChecked 211 243 isDOMRequired 245 isDomRequired 162 178 isLocked tag code coloring 75 isOptional attribute 357 isResizable 302 item tag 29 item tags in toolbars 226 item 128 itemref ta...

Страница 500: ...ENODE 120 MM_ConfigFileExists 473 mm_deleted_files xml file about 28 deleteditems tag 29 item tag 29 tag syntax 29 MM_GetConfigFileAttributes 475 MM_GetConfigFolderList 472 mm_jsapi h file including 4...

Страница 501: ...ant files 323 participant tag 347 participants 322 partType attribute 346 password field object 128 pasteServerBehavior 334 processFile 256 Property inspector API canInspectSelection 285 displayHelp 2...

Страница 502: ...ior 334 server behavior extensions definition 101 server format extensions definition 101 Server Formats API applyFormat 403 applyFormatDefinition 403 deleteFormat 404 formatDynamicDataRef 405 inspect...

Страница 503: ...nsions definition 100 toolbar tag 221 toolbarControls 420 toolbars button tag 226 checkbutton tag 227 colorpicker tag 231 combobox tag 230 command API 238 controls 216 creating 215 docking 217 dropdow...

Страница 504: ...ine 279 W W3C 128 whereToSearch attribute 364 width attribute 234 window object 128 window close 128 windowDimensions in behavior actions 320 in Commands API 178 in menu commands 213 in Objects API 16...

Результаты поиска

Содержание DREAMWEAVER 8-EXTENDING DREAMWEAVER

Отзывы:

Похожие инструкции для DREAMWEAVER 8-EXTENDING DREAMWEAVER

Бренды по названию

Популярные бренды

MACROMEDIA DREAMWEAVER 8-EXTENDING DREAMWEAVER, Руководство пользователя

Результаты поиска

Содержание DREAMWEAVER 8-EXTENDING DREAMWEAVER

Отзывы:

Похожие инструкции для DREAMWEAVER 8-EXTENDING DREAMWEAVER

Бренды по названию

Популярные бренды