Code view toolbar functions let you insert text, remove comments, show or hide special characters for white spaces in Code view, and get the path of the current document.
There are two different Coding toolbars: one for Code view and one for the Code inspector. Both are customized in the file Configuration/Toolbars/toolbars.xml.
dom.getOpenPathName()
Availability
Dreamweaver 8.
Description
This function gets the absolute file path of the open document.
Arguments
None.
Returns
A string that is the absolute file path of the open document.
Example
The following example assigns the string that contains the path of the currently open document to the variable fileName:
var fileName = dom.getOpenPathName();
dom.getShowHiddenCharacters()
Availability
Dreamweaver 8.
Description
This function determines whether the special characters for white spaces are shown in the Code view of the Document window.
Arguments
None.
Returns
A Boolean: true if the hidden characters are displayed; false otherwise.
Example
The following example turns off the display of the special characters for white space, if the display of special characters is turned on initially:
var currentDOM = dw.getDocumentDOM(); if (currentDOM.getShowHiddenCharacters()){ currentDOM.setShowHiddenCharacters(false); }
dom.setShowHiddenCharacters()
Availability
Dreamweaver 8.
Description
This function shows or hides the special characters for white spaces in the Code view of the Code inspector.
See dom.getShowHiddenCharacters() for an example.
Arguments
show
The show argument, which is required, is a Boolean value that indicates whether to display the hidden characters.
Returns
Nothing.
dom.source.applyComment()
Availability
Dreamweaver 8.
Description
This function inserts the text specified in the beforeText argument before the current selection and the text specified in the afterText argument after the current selection. The function then extends the current selection to include the added text. However, if there is no current selection, the function does not select anything. If the text specified in the afterText argument is null, the function inserts the text specified in the beforeText argument at the beginning of every line in the current selection.
Arguments
beforeText, afterText
The beforeText argument is required. It specifies the text to insert at the beginning of the selection, or, if the value of the afterText argument is null, it specifies the text to insert at the beginning of every line in the selection.
The afterText argument, which is optional, specifies the text to insert at the end of the selection.
Returns
Nothing.
Example
The following example makes the current selection an HTML comment:
dw.getDocumentDOM().source.applyComment('<!--', '-->')
dom.source.refreshVariableCodeHints()
Availability
Dreamweaver CS3.
Description
Rescans the page looking for variables and corresponding class associations. This function rebuilds the color state engine and the variable list.
Arguments
bSyncDoc
This is a Boolean value. The default is false. If set to true, the Design view is synchronized with the Code view.
Returns
Nothing.
Example
dom.source.refreshVariableCodeHints();
dom.source.removeComment()
Availability
Dreamweaver 8.
Description
This function removes comments. If you specify no arguments, it removes all types of comments from the current selection, except server-side includes and Dreamweaver-specific comments. If there are nested comments, it removes only the outer comment. If there is no current selection, it removes only the first line comment of the line on which the cursor is located. If you specify arguments, the function removes only comments that match the values specified in the beforeText and afterText arguments, even if the matching comments are nested inside other types of comments.
Arguments
beforeText, afterText
The beforeText argument is optional. It specifies the text to identify the beginning of the comment to remove from the selection, or, if the value of the afterText argument is null, it specifies the type of line comment to remove from the current selection.
The afterText argument, which is optional, specifies the text to identify the end of the comment to remove from the selection.
Returns
Nothing.
Example
The following example removes an HTML comment:
dw.getDocumentDOM().source.removeComment('<!--', '-->')
dreamweaver.htmlInspector.getShowHiddenCharacters()
Availability
Dreamweaver 8.
Description
This function determines whether the special characters for white spaces are displayed in the Code view of the Code inspector.
Arguments
None.
Returns
A Boolean value: true if the hidden characters are displayed; false otherwise.
Example
The following example turns off the display of the special characters for white space in the Code inspector, if the display of special characters is turned on initially:
if (dreamweaver.htmlinspector.getShowHiddenCharacters()){ dreamweaver.htmlinspector.setShowHiddenCharacters(false); }
dreamweaver.htmlInspector.setShowHiddenCharacters()
Availability
Dreamweaver 8.
Description
This function shows or hides the special characters for white spaces in the Code view of the Code inspector.
Arguments
show
The show argument, which is required, is a Boolean value that indicates whether to display hidden characters for white spaces.
Returns
A Boolean: true if the hidden characters are displayed; false otherwise.
Example