Adobe Dreamweaver CS3 User Guide En
User Manual: adobe Dreamweaver - CS3 - User Guide Free User Guide for Adobe Dreamweaver Software, Manual
Open the PDF directly: View PDF .
Page Count: 738 [warning: Documents this large are best viewed by clicking the View PDF Link!]
- Contents
- Chapter 1: Getting started
- Chapter 2: Workspace
- Dreamweaver workflow and workspace
- Dreamweaver workflow overview
- Workspace layout overview
- Workspace elements overview
- Document window overview
- Document toolbar overview
- Standard toolbar overview
- Status bar overview
- Insert bar overview
- Coding toolbar overview
- Style Rendering toolbar overview
- Property inspector overview
- Files panel overview
- CSS Styles panel overview
- Visual guides overview
- GoLive users
- Working in the Document window
- Using toolbars, inspectors, context menus, and panels
- Customizing the Dreamweaver CS3 workspace
- Choose the workspace layout (Windows)
- Choose the workspace layout (Macintosh)
- Display tabbed documents (Macintosh)
- Save custom workspace layouts
- Hide and display the Welcome screen
- About customizing Dreamweaver in multiuser systems
- Set General preferences for Dreamweaver
- Set Fonts preferences for documents in Dreamweaver
- Customize Highlighting colors
- Dreamweaver workflow and workspace
- Chapter 3: Working with Dreamweaver sites
- Setting up a Dreamweaver site
- About Dreamweaver sites
- Understanding local and remote folder structure
- Using the Manage Sites dialog box
- Set up and edit a local root folder
- Set up a remote folder
- Troubleshoot the remote folder setup
- Set up a testing server
- About the URL prefix for the testing server
- Edit an existing remote website in Dreamweaver
- Remove a Dreamweaver site from your list of sites
- Import and export site settings
- Working with a visual map of your site
- Managing Contribute sites with Dreamweaver
- Managing Contribute sites
- Site structure and page design for a Contribute site
- File transfer to and from a Contribute site
- Contribute file and folder permissions on the server
- Contribute special files
- Prepare a site for use with Contribute
- Administer a Contribute site using Dreamweaver
- Delete, move, or rename a remote file in a Contribute site
- Enable Contribute users to access templates without root folder access
- Troubleshoot a Contribute site
- Working on files without defining a site
- Basic tab options
- Set Basic tab Editing Files options
- Set Basic tab Editing Files Part 2 options
- Set Basic tab Editing Files Part 3 options
- Set Basic tab Testing Files options (URL prefix)
- Set Basic tab Testing Files options (remote access)
- Set Basic tab remote folder setup options
- Set Basic tab Sharing Files options (remote access)
- Set Basic tab Sharing Files options (check in/check out)
- Basic tab Summary options
- Setting up a Dreamweaver site
- Chapter 4: Creating and managing files
- Creating and opening documents
- About creating Dreamweaver documents
- Dreamweaver file types
- Create a blank page
- Create a blank template
- Create a page based on an existing template
- Create a page based on a Dreamweaver sample file
- Create other kinds of pages
- Set default document type and encoding
- Set the default file extension of new HTML documents
- Open and edit existing documents
- Clean up Microsoft Word HTML files
- Managing files and folders
- About managing files and folders
- Using the Files panel
- View files and folders
- Work with files in the Files panel
- Find files in your Dreamweaver site
- Identify and delete unused files
- Access sites, a server, and local drives
- Set site preferences for transferring files
- Customize the file and folder details displayed in the expanded Files panel
- Getting and putting files to and from your server
- Checking in and checking out files
- Synchronizing files
- Comparing files for differences
- Rolling back files (Contribute users)
- Cloaking folders and files in your site
- Storing file information in Design Notes
- Testing your site
- Creating and opening documents
- Chapter 5: Managing assets and libraries
- Chapter 6: Creating pages with CSS
- Understanding Cascading Style Sheets
- Creating and managing CSS
- About the CSS Styles panel
- The CSS Styles panel in Current mode
- The CSS Styles panel in All mode
- CSS Styles panel buttons and views
- Open the CSS Styles panel
- Set CSS Styles preferences
- Create a new CSS rule
- Set CSS properties
- Edit a CSS rule
- Add a property to a rule
- Apply, remove, or rename class styles
- Move CSS rules
- Convert inline CSS to a CSS rule
- Link to an external CSS style sheet
- Edit a CSS style sheet
- Format CSS code
- Check for cross-browser CSS rendering issues
- Use Design-Time style sheets
- Use Dreamweaver sample style sheets
- Update CSS style sheets in a Contribute site
- Laying out pages with CSS
- About CSS page layout
- About CSS page layout structure
- Create a page with a CSS layout
- About AP elements in Dreamweaver
- HTML code for AP Div elements
- Insert an AP Div
- Work with nested AP Divs
- View or set AP element preferences
- View or set properties for a single AP element
- View or set properties for multiple AP elements
- AP Elements panel overview
- Select AP elements
- Change the stacking order of AP elements
- Show and hide AP elements
- Resize AP elements
- Move AP elements
- Align AP elements
- Converting AP elements to tables
- Convert between AP elements and tables
- Prevent AP element overlaps
- Working with div tags
- Animating AP elements
- About animating AP elements
- Timelines panel overview
- Playback options
- Animate an AP element using the timeline
- Create a timeline by dragging a path
- Modify a timeline
- Change image and AP element properties with timelines
- Use multiple timelines
- Copy and paste animations
- Apply an animation sequence to a different object
- Rename the timeline
- Animation tips for timelines
- Chapter 7: Laying out pages with HTML
- Using visual aids for layout
- Presenting content with tables
- About tables
- Table formatting precedence in HTML
- About splitting and merging table cells
- Insert a table and add content
- Import and export tabular data
- Select table elements
- Set table properties
- Set cell, row, or column properties
- Use Expanded Tables mode for easier table editing
- Format tables and cells
- Resizing tables, columns, and rows
- Resize tables, columns, and rows
- Add and remove rows and columns
- Split and merge cells
- Copy, paste, and delete cells
- Nest tables
- Sort tables
- Laying out pages in Layout mode
- About Layout mode
- Viewing table and cell widths in Layout mode
- Layout table and cells grid lines
- Fixed column width and autostretch columns
- Spacer images
- Switch from Standard to Layout mode
- Draw in Layout mode
- Add content to a layout cell
- Clear cell heights
- Resize and move layout cells and tables
- Format layout cells and tables
- Set column width
- Set preferences for Layout mode
- Using Frames
- How frames and framesets work
- Deciding whether to use frames
- Nested framesets
- Work with framesets in the Document window
- Create frames and framesets
- Select frames and framesets
- Open a document in a frame
- Save frame and frameset files
- View and set frame properties and attributes
- View and set frameset properties
- Control frame content with links
- Provide content for browsers without frame support
- Using JavaScript behaviors with frames
- Chapter 8: Adding content to pages
- Working with pages
- About working with pages
- About setting page properties
- Converting active content
- Understanding document encoding
- Set page properties
- Select and view elements in the Document window
- Specify HTML instead of CSS
- Set the HTML Appearance page properties
- Web-safe colors
- Use the color picker
- Zoom in and out
- Using JavaScript behaviors to detect browsers and plug-ins
- Set download time and size preferences
- Set browser preview preferences
- Save and revert web pages
- Adding and formatting text
- About inserting text
- Add text to a document
- Insert special characters
- Add space between characters
- Create bulleted and numbered lists
- Search for and replace text
- Define abbreviations and acronyms
- Set copy and paste preferences
- Check and correct spelling
- Import tabular data
- Import Microsoft Office documents (Windows only)
- Create a link to a Word or Excel document
- About formatting text (CSS versus HTML)
- Using the Property inspector to format text
- Set text properties in the Property inspector
- Format paragraphs
- Change the color of text
- Align text
- Indent text
- Add paragraph spacing
- Use horizontal rules
- Apply font styles
- Rename a style
- Modify font combinations
- Insert dates
- Adding and modifying images
- About images
- Insert an image
- Edit images in Dreamweaver
- Insert an image placeholder
- Set image placeholder properties
- Replace an image placeholder
- Align an image
- Visually resize an image
- Crop an image
- Optimize an image
- Adjust the brightness and contrast of an image
- Sharpen an image
- Create a rollover image
- Use an external image editor
- Applying behaviors to images
- Inserting Flash content
- About Flash file types
- Insert and preview Flash content
- Create and insert a Flash button
- Modify a Flash button object
- Preview a Flash button object in the document
- Insert a Flash text object
- Downloading and installing Flash elements
- Insert Flash elements
- Edit Flash elements
- Use the Image Viewer Flash element
- Insert FlashPaper documents
- Adding Flash Video content
- Adding Sound
- Adding other media objects
- Insert and edit media objects
- Start an external editor for media files
- Specify the editor to start from Dreamweaver
- Use Design Notes with media objects
- Insert Shockwave movies
- Add video (non-Flash)
- Insert Netscape Navigator plug-in content
- Troubleshooting Netscape Navigator plug-ins
- Insert an ActiveX control
- Insert a Java applet
- Using behaviors to control media
- Use parameters to control media objects
- Working with pages
- Chapter 9: Linking and navigation
- About linking and navigation
- Linking
- Linking files and documents
- Attaching JavaScript behaviors to links
- Link to documents using the Property inspector
- Link to documents using the Point-To-File icon
- Link documents using the site map
- Add a link using the Hyperlink command
- Set the relative path of new links
- Link to a specific place in a document
- Create an e-mail link
- Create null and script links
- Update links automatically
- Manage links in the site map
- Change a link sitewide
- Test links in Dreamweaver
- Jump menus
- Navigation bars
- Image maps
- Troubleshooting links
- Chapter 10: Previewing pages
- Chapter 11: Working with page code
- About coding in Dreamweaver
- Setting up your coding environment
- Customizing the coding environment
- Writing and editing code
- Use code hints
- Edit a server-language tag with the Property inspector
- Work with code snippets
- Insert code with the Coding toolbar
- Insert code with the Insert bar
- Insert tags with the Tag Chooser
- Edit tags with Tag editors
- Indent code blocks
- Copy and paste code
- Insert HTML comments
- Go to a JavaScript or VBScript function
- Search for tags, attributes, or text in code
- Save and recall search patterns
- Change code selections
- Use language-reference material
- Print code
- Collapsing code
- Optimizing and debugging code
- Editing code in Design view
- About editing code in Design view
- Selecting child tags in Design view
- Edit code with the Property inspector
- Edit CFML with the Property inspector
- Change attributes with the Tag inspector
- Quick Tag Editor overview
- Edit code with the Quick Tag Editor
- Use the hints menu in the Quick Tag Editor
- Edit code with the tag selector
- Write and edit scripts in Design view
- Edit scripts on the page by using the Property inspector
- Using JavaScript behaviors
- Working with head content for pages
- Working with server-side includes
- Managing tag libraries
- Importing custom tags into Dreamweaver
- Chapter 12: Adding JavaScript behaviors
- Using JavaScript behaviors
- Applying built-in Dreamweaver behaviors
- Using built-in behaviors
- Apply the Call JavaScript behavior
- Apply the Change Property behavior
- Apply the Check Browser behavior
- Apply the Check Plugin behavior
- Apply the Control Shockwave Or Flash behavior
- Apply the Drag AP Element behavior
- Gathering information about the draggable AP element
- Apply the Go To URL behavior
- Apply the Jump Menu behavior
- Apply the Jump Menu Go behavior
- Apply the Open Browser Window behavior
- Apply the Play Sound behavior
- Apply the Popup Message behavior
- Apply the Preload Images behavior
- Apply the Set Nav Bar Image behavior
- Apply the Set Text Of Frame behavior
- Apply the Set Text Of Container behavior
- Apply the Set Text Of Status Bar behavior
- Apply the Set Text Of Text Field behavior
- Apply the Show-Hide Elements behavior
- Apply the Show Pop-Up Menu behavior
- Add, remove, and rearrange pop-up menu items
- Format a pop-up menu
- Position a pop-up menu in a document
- Modify a pop-up menu
- Apply the Swap Image behavior
- Apply the Validate Form behavior
- Chapter 13: Working with other applications
- Cross-application integration
- Working with Fireworks
- Insert a Fireworks image
- Edit a Fireworks image or table from Dreamweaver
- Optimize a Fireworks image from Dreamweaver
- Use Fireworks to modify Dreamweaver image placeholders
- About Fireworks pop-up menus
- Edit Fireworks pop-up menus in Dreamweaver
- Edit a pop-up menu created in Fireworks MX 2004 or earlier
- Specify launch-and-edit preferences for Fireworks source files
- Insert Fireworks HTML code in a Dreamweaver document
- Paste Fireworks HTML code into Dreamweaver
- Update Fireworks HTML code placed in Dreamweaver
- Create a web photo album
- Working with Photoshop
- About Photoshop integration
- Working with Photoshop and Dreamweaver
- Insert a Photoshop image into your page
- Copy a Photoshop selection into your page
- Use Photoshop to edit images in Dreamweaver pages
- Reinsert a Photoshop image from Dreamweaver
- Recopy a Photoshop image selection
- Choose image optimization settings
- Optimization settings
- Working with Flash
- Working with Bridge
- Working with Device Central
- Chapter 14: Creating and managing templates
- About Dreamweaver templates
- Recognizing templates and template-based documents
- Creating a Dreamweaver template
- Creating editable regions
- Creating repeating regions
- Using optional regions
- Defining editable tag attributes
- Creating a nested template
- Editing, updating, and deleting templates
- Exporting and importing template content
- Applying or removing a template from an existing document
- Editing content in a template-based document
- Template syntax
- Setting authoring preferences for templates
- Chapter 15: Displaying XML data
- About XML and XSLT
- Performing XSL transformations on the server
- Workflow for performing server-side XSL transformations
- Create an XSLT page
- Convert HTML pages to XSLT pages
- Attach XML data sources
- Display XML data in XSLT pages
- Display repeating XML elements
- Insert XSLT fragments in dynamic pages
- Delete XSLT fragments from dynamic pages
- Edit XSL Transformation server behaviors
- Create a dynamic link
- Applying styles to XSLT fragments
- Use parameters with XSL transformations
- Create and edit conditional XSLT regions
- Insert XSL comments
- Use the XPath Expression Builder to add expressions for XML data
- Troubleshooting XSL transformations
- Performing XSL transformations on the client
- Missing character entities
- Chapter 16: Building Spry pages visually
- About the Spry framework
- Adding Spry widgets
- Working with the Accordion widget
- Working with the Menu Bar widget
- About the Menu Bar widget
- Insert the Menu Bar widget
- Add or delete menus and submenus
- Change the order of menu items
- Change the text of a menu item
- Link a menu item
- Create a tool tip for a menu item
- Assign a target attribute for a menu item
- Turn off styles
- Change the orientation of a Menu Bar widget
- Customize the Menu Bar widget
- Working with the Collapsible Panel widget
- Working with the Tabbed Panels widget
- Working with the Validation Text Field widget
- About the Validation Text Field widget
- Insert the Validation Text Field widget
- Specify a validation type and format
- Specify when validation occurs
- Specify a minimum and maximum number characters
- Specify minimum and maximum values
- Display widget states in Design view
- Change required status of a text field
- Create a hint for a text field
- Block invalid characters
- Customize the Validation Text Field widget
- Working with the Validation Text Area widget
- About the Validation Text Area widget
- Insert the Validation Text Area widget
- Specify when validation occurs
- Specify a minimum and maximum number of characters
- Add a character counter
- Display widget states in Design view
- Change required status of a text area
- Create a hint for a text area
- Block extra characters
- Customize the Validation Text Area widget
- Working with the Validation Select widget
- Working with the Validation Checkbox widget
- Displaying data with Spry
- Adding Spry effects
- Chapter 17: Preparing to build dynamic sites
- Understanding web applications
- Installing a local web server
- Setting up a web application
- What you need to build web applications
- Choosing your application server
- Installing a ColdFusion application server
- Install a PHP application server
- Installing an ASP application server
- Install an ASP.NET application server
- Installing a JSP application server
- Creating a root folder for the application
- About defining a Dreamweaver site
- Database connections for ColdFusion developers
- Database connections for ASP developers
- Database connections for PHP developers
- Database connections for ASP.NET developers
- Database connections for JSP developers
- Troubleshooting database connections
- Removing connection scripts
- Chapter 18: Data sources for web applications
- Chapter 19: Making pages dynamic
- Optimizing the workspace for visual development
- Displaying web-application development panels
- View your database within Dreamweaver
- Previewing dynamic pages in a browser
- Restrict database information displayed in Dreamweaver
- Set the Property inspector for ColdFusion stored procedures, ASP commands, and JSP callables
- Set the Property inspector for JSP prepared statements
- Input Name options
- Designing dynamic pages
- Dynamic content sources overview
- Dynamic content panels
- Defining sources of dynamic content
- Define a recordset without writing SQL
- Define an advanced recordset by writing SQL
- Create SQL queries using the Database Items tree
- Define URL parameters
- Define form parameters
- Define session variables
- Define application variables for ASP and ColdFusion
- Use a variable as a data source for a ColdFusion recordset
- Define server variables
- Cache content sources
- Change or delete content sources
- Copy a recordset from one page to another page
- Adding dynamic content to pages
- Changing dynamic content
- Displaying database records
- About database records
- Server behaviors and formatting elements
- Applying typographic and page layout elements to dynamic data
- Navigating database recordset results
- Create a recordset navigation bar
- Custom recordset navigation bars
- Navigation bar design tasks
- Display and hide regions based on recordset results
- Display multiple recordset results
- Create a dynamic table
- Create record counters
- Use predefined data formats
- Viewing live data
- Using web services
- About web services
- The Dreamweaver web service workflow
- Finding web service publishers
- Web service software components
- Web service references
- About proxy generators
- Obtaining additional proxy generators
- Configure a proxy generator to work with Dreamweaver
- Add a web service proxy using the WSDL description
- Add a web service to a page
- Add a web service using a proxy class
- Adding custom server behaviors
- Creating forms
- About forms
- Client-side role of forms
- Form objects
- Create an HTML form
- About dynamic form objects
- Insert or change a dynamic HTML form menu
- Make existing HTML form menus dynamic
- Display dynamic content in HTML text fields
- Set the Dynamic Text Field dialog box options
- Dynamically preselect an HTML check box
- Dynamically preselect an HTML radio button
- Validate HTML form data
- Attach JavaScript behaviors to HTML form objects
- Attach custom scripts to HTML form buttons
- Create accessible HTML forms
- Optimizing the workspace for visual development
- Chapter 20: Building applications visually
- Building master and detail pages (all servers)
- About master and detail pages
- Build a master page
- Create links to the detail page
- Find and display the requested record on the detail page
- Create a link to open a related page (ASP, JSP)
- Find a specific record and display it on a page (ASP, JSP)
- Build master and detail pages in one operation (ColdFusion, ASP, JSP, PHP)
- Building search and results pages (ColdFusion, ASP, JSP, PHP)
- About search and results pages
- Build the search page (ColdFusion, ASP, JSP, PHP)
- Build a basic results page (ColdFusion, ASP, JSP, PHP)
- Build an advanced results page (ColdFusion, ASP, JSP, PHP)
- Display the search results (ColdFusion, ASP, JSP, PHP)
- Create a detail page for a results page (ColdFusion, ASP, JSP, PHP)
- Building a database search page (ASP.NET)
- Building a record insert page (all servers)
- Building pages to update a record (all servers)
- Building pages to delete a record (all servers)
- Building pages with advanced data manipulation objects (ColdFusion, ASP, ASP.NET, JSP)
- Building a registration page (ColdFusion, ASP, JSP, PHP)
- About registration pages
- Storing login information about users (ColdFusion, ASP, JSP, PHP)
- Add an HTML form for selecting a user name and password (ColdFusion, ASP, JSP, PHP)
- Update the database table of users (ColdFusion, ASP, JSP, PHP)
- Add a server behavior to ensure a unique user name (ColdFusion, ASP, JSP, PHP)
- Building a login page (ColdFusion, ASP, JSP, PHP)
- Building a page only authorized users can access (ColdFusion, ASP, JSP, PHP)
- Securing a folder in your application (ColdFusion)
- Using ColdFusion components (ColdFusion)
- Using JavaBeans (JSP)
- Building master and detail pages (all servers)
- Chapter 21: Building ASP.NET and ColdFusion forms
- Building ColdFusion MX 7 forms
- About the ColdFusion enhancements
- Enable the ColdFusion enhancements
- Create ColdFusion forms
- Insert ColdFusion form controls
- Insert ColdFusion text fields
- Insert ColdFusion hidden fields
- Insert ColdFusion text areas
- Insert ColdFusion buttons
- Insert ColdFusion check boxes
- Insert ColdFusion radio buttons
- Insert ColdFusion select boxes
- Insert ColdFusion image fields
- Insert ColdFusion file fields
- Insert ColdFusion date fields
- Modify ColdFusion form controls
- Validate ColdFusion form data
- Building ASP.NET forms
- Add ASP.NET form controls to a page
- Modify the properties or events of ASP.NET form controls
- Create a dynamic ASP.NET menu
- Make an existing ASP.NET menu dynamic
- Display dynamic content in an ASP.NET TextBox control
- Dynamically preselect ASP.NET CheckBox controls
- Insert an ASP.NET CheckBoxList control
- Insert an ASP.NET RadioButtonList control
- Preselect an item in an ASP.NET RadioButtonList control
- Preselect an ASP.NET RadioButton control
- Creating ASP.NET DataGrid and DataList web controls
- Comparing the ASP.NET DataGrid and DataList controls
- About the ASP.NET DataGrid web control
- Add an ASP.NET DataGrid control to a page
- Add an ASP.NET DataList control to a page
- Modify an ASP.NET DataGrid or DataList control
- Specify and format a data source field in a DataGrid
- Design a custom layout for a free-form DataGrid column
- Display data as a hyperlink in a DataGrid
- Allow users to edit in DataGrid rows
- Allow users to delete a row in a DataGrid
- Building ColdFusion MX 7 forms
- Chapter 22: Automating tasks
- Chapter 23: Accessibility
- Chapter 24: Shortcuts and extensions
- Index
USER GUIDE
ADOBE® DREAMWEAVER® CS3
September 4, 2007
Copyright
© 2007 Adobe Systems Incorporated. All rights reserved.
Adobe® Dreamweaver® CS3 User Guide for Windows® and Mac OS
If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished under license and may be used or
copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this guide may be reproduced, stored in a retrieval system, or trans-
mitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated.Pleasenotethatthe
content in this guide is protected under copyright law even if it is not distributed with software that includes an end user license agreement.
Thecontentofthisguideisfurnishedforinformationaluseonly,issubjecttochangewithoutnotice,andshouldnotbeconstruedasacommitmentbyAdobe Systems Incorpo-
rated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational content contained in this guide.
Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law. The unauthorized incorporation of such
material into your new work could be a violation of the rights of the copyright owner. Please be sure to obtain any permission required from the copyright owner.
Any references to company names in sample templates are for demonstration purposes only and are not intended to refer to any actual organization.
Adobe, the Adobe logo, ActionScript, ColdFusion, Creative Suite, Director, Dreamweaver, Fireworks, Flash, FlashPaper, HomeSite, JRun, Photoshop, Shockwave, and Version
Cue are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries.
ActiveX, Microsoft, and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Apple and Mac OS are
trademarks of Apple Inc., registered in the United States and other countries. Java and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the United
States and other countries. Linux is the registered trademark of Linus Torvalds in the U.S. and other countries. UNIX is a trademark in the United States and other countries,
licensed exclusively through X/Open Company, Ltd. All other trademarks are the property of their respective owners.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/). The Graphics Interchange Format © is the Copyright property of
CompuServe Incorporated. GIF(sm) is a Service Mark property of CompuServe Incorporated. MPEG Layer-3 audio compression technology licensed by Fraunhofer IIS and
Thomson Multimedia (http://www.mp3licensing.com). You cannot use the MP3 compressed audio within the Software for real time or live broadcasts. If you require an MP3
decoder for real time or live broadcasts, you are responsible for obtaining this MP3 technology license. Speech compression and decompression technology licensed from Nelly-
moser, Inc. (www.nellymoser.com) Flash CS3 video is powered by On2 TrueMotion video technology. © 1992-2005 On2 Technologies, Inc. All Rights Reserved.
http://www.on2.com. This product includes software developed by the OpenSymphony Group (http://www.opensymphony.com/) Sorenson SparkTM video compression and
decompression technology licensed from Sorenson Media, Inc.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
Notice to U.S. Government End Users. The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101, consisting of “Commercial
Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with
48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are
being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions
herein. Unpublishedrights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S.
Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended,
Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended,andtheregulations
at 41 CFR Parts 60-1 through 60-60, 60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.
September 4, 2007
iii
Contents
Chapter 1: Getting started
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Adobe Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
What’s new . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Chapter 2: Workspace
Dreamweaver workflow and workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Working in the Document window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Using toolbars, inspectors, context menus, and panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Customizing the Dreamweaver CS3 workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Chapter 3: Working with Dreamweaver sites
Setting up a Dreamweaver site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Working with a visual map of your site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Managing Contribute sites with Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
Working on files without defining a site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Basic tab options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Chapter 4: Creating and managing files
Creating and opening documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Managing files and folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Getting and putting files to and from your server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Checking in and checking out files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Synchronizing files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Comparing files for differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Rolling back files (Contribute users) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Cloaking folders and files in your site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Storing file information in Design Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Testing your site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Chapter 5: Managing assets and libraries
About assets and libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Working with assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Creating and managing a list of favorite assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Working with library items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Chapter 6: Creating pages with CSS
Understanding Cascading Style Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Creating and managing CSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Laying out pages with CSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Working with div tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Animating AP elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
September 4, 2007
iv
Chapter 7: Laying out pages with HTML
Using visual aids for layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Presenting content with tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Laying out pages in Layout mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Using Frames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Chapter 8: Adding content to pages
Working with pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Adding and formatting text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Adding and modifying images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Inserting Flash content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Adding Flash Video content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Adding Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Adding other media objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Chapter 9: Linking and navigation
About linking and navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Linking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Jump menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Navigation bars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Image maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Troubleshooting links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Chapter 10: Previewing pages
Previewing pages in browsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Previewing pages in mobile devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Chapter 11: Working with page code
About coding in Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Setting up your coding environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Customizing the coding environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Writing and editing code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
Collapsing code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Optimizing and debugging code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
Editing code in Design view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Working with head content for pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Working with server-side includes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
Managing tag libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
Importing custom tags into Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
Chapter 12: Adding JavaScript behaviors
Using JavaScript behaviors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Applying built-in Dreamweaver behaviors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
Chapter 13: Working with other applications
Cross-application integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Working with Fireworks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Working with Photoshop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
September 4, 2007
v
Working with Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
Working with Bridge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
Working with Device Central . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Chapter 14: Creating and managing templates
About Dreamweaver templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
Recognizing templates and template-based documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Creating a Dreamweaver template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
Creating editable regions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
Creating repeating regions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Using optional regions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Defining editable tag attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Creating a nested template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
Editing, updating, and deleting templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
Exporting and importing template content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
Applying or removing a template from an existing document . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Editing content in a template-based document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
Template syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
Setting authoring preferences for templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
Chapter 15: Displaying XML data
About XML and XSLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
Performing XSL transformations on the server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
Performing XSL transformations on the client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
Missing character entities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
Chapter 16: Building Spry pages visually
About the Spry framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
Adding Spry widgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
Working with the Accordion widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
Working with the Menu Bar widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
Working with the Collapsible Panel widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
Working with the Tabbed Panels widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
Working with the Validation Text Field widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
Working with the Validation Text Area widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
Working with the Validation Select widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
Working with the Validation Checkbox widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
Displaying data with Spry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478
Adding Spry effects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
Chapter 17: Preparing to build dynamic sites
Understanding web applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
Installing a local web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498
Setting up a web application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
Database connections for ColdFusion developers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
Database connections for ASP developers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510
Database connections for PHP developers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
September 4, 2007
vi
Database connections for ASP.NET developers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
Database connections for JSP developers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521
Troubleshooting database connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
Removing connection scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
Chapter 18: Data sources for web applications
Using a database to store content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
Collecting data submitted by users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
Accessing data stored in session variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
Chapter 19: Making pages dynamic
Optimizing the workspace for visual development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
Designing dynamic pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
Dynamic content sources overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543
Dynamic content panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
Defining sources of dynamic content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
Adding dynamic content to pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564
Changing dynamic content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567
Displaying database records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
Viewing live data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
Using web services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
Adding custom server behaviors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589
Creating forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
Chapter 20: Building applications visually
Building master and detail pages (all servers) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614
Building search and results pages (ColdFusion, ASP, JSP, PHP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624
Building a database search page (ASP.NET) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629
Building a record insert page (all servers) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633
Building pages to update a record (all servers) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637
Building pages to delete a record (all servers) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643
Building pages with advanced data manipulation objects (ColdFusion, ASP, ASP.NET, JSP) . 651
Building a registration page (ColdFusion, ASP, JSP, PHP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658
Building a login page (ColdFusion, ASP, JSP, PHP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 660
Building a page only authorized users can access (ColdFusion, ASP, JSP, PHP) . . . . . . . . . . . . . . 662
Securing a folder in your application (ColdFusion) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665
Using ColdFusion components (ColdFusion) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665
Using JavaBeans (JSP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672
Chapter 21: Building ASP.NET and ColdFusion forms
Building ColdFusion MX 7 forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 674
Building ASP.NET forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686
Creating ASP.NET DataGrid and DataList web controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691
Chapter 22: Automating tasks
Automating tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698
September 4, 2007
vii
Chapter 23: Accessibility
Dreamweaver and accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704
Dreamweaver accessibility features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 705
Designing pages for accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707
Chapter 24: Shortcuts and extensions
Keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708
Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711
September 4, 2007
1
Chapter 1: Getting started
If you haven’t installed your new software, begin by reading some information on installation and other prelimi-
naries. Before you begin working with your software, take a few moments to read an overview of Adobe Help and of
the many resources available to users. You have access to instructional videos, plug-ins, templates, user communities,
seminars, tutorials, RSS feeds, and much more.
Installation
Requirements
❖To review complete system requirements and recommendations for your Adobe® software, see the Read Me file
on the installation disc.
Install the software
1Close any other Adobe applications open on your computer.
2Insert the installation disc into the disc drive, and follow the on-screen instructions.
Note: For more information, see the Read Me file on the installation disc.
Activate the software
Ifyouhaveasingle-userretaillicenseforyourAdobesoftware,youwillbeaskedtoactivateyoursoftware;thisisa
simple, anonymous process that you must complete within 30 days of starting the software.
For more information on product activation, see the Read Me file on your installation disc, or visit the Adobe website
at www.adobe.com/go/activation.
1If the Activation dialog box isn’t already open, choose Help > Activate.
2Follow the on-screen instructions.
Note: If you want to install the software on a different computer, you must first deactivate it on your computer. Choose
Help > Deactivate.
Register
Register your product to receive complimentary installation support, notifications of updates, and other services.
❖To register, follow the on-screen instructions in the Registration dialog box, which appears after you install and
activate the software.
If you postpone registration, you can register at any time by choosing Help > Registration.
September 4, 2007
DREAMWEAVER CS3
User Guide
2
Adobe Help
Adobe Help resources
Documentation for your Adobe software is available in a variety of formats.
In-product and LiveDocs Help
In-product Help provides access to all documentation and instructional content available at the time the software
ships. It is available through the Help menu in your Adobe software.
LiveDocs Help includes all the content from in-product Help, plus updates and links to additional instructional
content available on the web. For some products, you can also add comments to the topics in LiveDocs Help. Find
LiveDocs Help for your product in the Adobe Help Resource Center, at www.adobe.com/go/documentation.
Most versions of in-product and LiveDocs Help let you search across the Help systems of multiple products. Topics
may also contain links to relevant content on the web or to topics in the Help of another product.
Think of Help, both in the product and on the web, as a hub for accessing additional content and communities of
users. The most complete and up-to-date version of Help is always on the web.
Adobe PDF documentation
The in-product Help is also available as a PDF that is optimized for printing. Other documents, such as installation
guides and white papers, may also be provided as PDFs.
All PDF documentation is available through the Adobe Help Resource Center, at www.adobe.com/go/documen-
tation. To see the PDF documentation included with your software, look in the Documents folder on the installation
or content DVD.
Printed documentation
Printed editions of the in-product Help are available for purchase in the Adobe Store, at www.adobe.com/go/store.
You can also find books published by Adobe publishing partners in the Adobe Store.
September 4, 2007
DREAMWEAVER CS3
User Guide
3
A printed workflow guide is included with all Adobe Creative Suite® 3 products, and stand-alone Adobe products
may include a printed getting started guide.
Using Help in the product
In-productHelpisavailablethroughtheHelpmenu.AfteryoustarttheAdobeHelpViewer,clickBrowsetoseeHelp
for additional Adobe products installed on your computer.
These Help features facilitate cross-product learning:
•Topics may contain links to the Help systems of other Adobe products or to additional content on the web.
•Some topics are shared across two or more products. For instance, if you see a Help topic with an Adobe
Photoshop® CS3 icon and an Adobe After Effects® CS3 icon, you know that the topic either describes functionality
that is similar in the two products or describes cross-product workflows.
•You can search across the Help systems of multiple products.
If you search for a phrase, such as “shape tool,” enclose it in quotation marks to see only those topics that include all
the words in the phrase.
Adobe Help
A. Back/Forward buttons (previously visited links) B. Expandable subtopics C. Icons indicating shared topic D. Previous/Next buttons (topics
in sequential order)
Accessibility features
Adobe Help content is accessible to people with disabilities—such as mobility impairments, blindness, and low
vision. In-product Help supports these standard accessibility features:
•The user can change text size with standard context menu commands.
•Links are underlined for easy recognition.
•If link text doesn’t match the title of the destination, the title is referenced in the Title attribute of the Anchor tag.
For example, the Previous and Next links include the titles of the previous and next topics.
C
D
B
A
September 4, 2007
DREAMWEAVER CS3
User Guide
4
•Content supports high-contrast mode.
•Graphics without captions include alternate text.
•Each frame has a title to indicate its purpose.
•Standard HTML tags define content structure for screen reading or text-to-speech tools.
•Style sheets control formatting, so there are no embedded fonts.
Keyboard shortcuts for Help toolbar controls (Windows)
Back button Alt+Left Arrow
Forward button Alt+Right Arrow
Print Ctrl+P
About button Ctrl+I
Browse menu Alt+Down Arrow or Alt+Up Arrow to view Help for another application
Search box Ctrl+S to place the insertion point in the Search box
Keyboard shortcuts for Help navigation (Windows)
•To move between panes, press Ctrl+Tab (forward) and Shift+Ctrl+Tab (backward).
•To move through and outline links in a pane, press Tab (forward) or Shift+Tab (backward).
•To activate an outlined link, press Enter.
•To make text bigger, press Ctrl+equal sign.
•To make text smaller, press Ctrl+hyphen.
Choosing the right Help documents
The following list summarizes the documentation available from the Help menu. Use this list to find the Help system
that will answer your question.
•Dreamweaver Help (called Using Dreamweaver), intended for all users, gives comprehensive information about all
Adobe® Dreamweaver® CS3 features.
•Extending Dreamweaver, which describes the Dreamweaver framework and the application programming
interface (API), is intended for advanced users who want to build extensions or customize the Dreamweaver
interface.
•Dreamweaver API Reference documents the utility API and JavaScript API, used by advanced users who want to
build extensions and customize the interface.
•Spry Framework Help documents the creation of Ajax data sets, widgets, and effects with the Spry framework and
includes codes samples and quick starts. These documents are not Dreamweaver-specific. For Dreamweaver-
specific Spry topics, see Using Dreamweaver.
•ColdFusion Help is a selection of books in the Macromedia® ColdFusion® from Adobe documentation set (the full
set is available on LiveDocs). These Help documents are intended for both beginners and advanced developers
interested in ColdFusion.
•Reference gives access to HTML, server model, and other reference manuals. They are intended for anyone
needing more information about coding syntax, coding concepts, and so on.
September 4, 2007
DREAMWEAVER CS3
User Guide
5
Resources
Adobe Video Workshop
The Adobe Creative Suite 3 Video Workshop offers over 200 training videos covering a wide range of subjects for
print, web, and video professionals.
YoucanusetheAdobeVideoWorkshoptolearnaboutanyCreativeSuite3product.Manyvideosshowyouhowto
use Adobe applications together.
September 4, 2007
DREAMWEAVER CS3
User Guide
6
When you start the Adobe Video Workshop, you choose the products you want to learn and the subjects you want
to view. You can see details about each video to focus and direct your learning.
Community of presenters
With this release, Adobe Systems invited the community of its users to share their expertise and insights. Adobe and
lynda.com present tutorials, tips, and tricks from leading designers and developers such as Joseph Lowery, Katrin
Eismann, and Chris Georgenes. You can see and hear Adobe experts such as Lynn Grillo, Greg Rewis, and Russell
Brown. In all, over 30 product experts share their knowledge.
Tutorials and source files
The Adobe Video Workshop includes training for novices and experienced users. You’ll also find videos on new
features and key techniques. Each video covers a single subject and typically runs about 3-5 minutes. Most videos
come with an illustrated tutorial and source files, so you can print detailed steps and try the tutorial on your own.
Using Adobe Video Workshop
YoucanaccessAdobeVideoWorkshopusingtheDVDincludedwithyourCreativeSuite3product.It’salsoavailable
online at www.adobe.com/go/learn_videotutorials. Adobe will regularly add new videos to the online Video
Workshop, so check in to see what’s new.
Dreamweaver CS3 videos
Adobe Video Workshop covers a wide range of subjects for Adobe Dreamweaver® CS3, including these:
•Using and customizing CSS-based layouts
•Using Spry widgets
•Styling forms with CSS
•Troubleshooting publishing problems
September 4, 2007
DREAMWEAVER CS3
User Guide
7
•Creating rollovers
Videos also show you how to use Dreamweaver CS3 with other Adobe software:
•Designing websites with Dreamweaver and Photoshop
•Using Dreamweaver templates with Contribute®
•Importing, copying and pasting between web applications
To access Adobe Creative Suite 3 video tutorials, visit Adobe Video Workshop at
www.adobe.com/go/learn_videotutorials.
Extras
You have access to a wide variety of resources that will help you make the most of your Adobe software. Some of
these resources are installed on your computer during the setup process; additional helpful samples and documents
are included on the installation or content disc. Unique extras are also offered online by the Adobe Exchange
community, at www.adobe.com/go/exchange.
Installed resources
During software installation, a number of resources are placed in your application folder. To view those files, navigate
to the application folder on your computer.
•Windows®: [startup drive]\Program Files\Adobe\[Adobe application]
•Mac OS®: [startup drive]/Applications/[Adobe application]
The application folder may contain the following resources:
Plug-ins Plug-in modules are small software programs that extend or add features to your software. Once installed,
plug-in modules appear as options in the Import or Export menu; as file formats in the Open, Save As, and Export
Original dialog boxes; or as filters in the Filter submenus. For example, a number of special effects plug-ins are
automatically installed in the Plug-ins folder inside the Photoshop CS3 folder.
Presets Presets include a wide variety of useful tools, preferences, effects, and images. Product presets include
brushes, swatches, color groups, symbols, custom shapes, graphic and layer styles, patterns, textures, actions,
workspaces, and more. Preset content can be found throughout the user interface. Some presets (for example,
Photoshop Brush libraries) become available only when you select the corresponding tool. If you don’t want to create
an effect or image from scratch, go to the preset libraries for inspiration.
Templates Template files can be opened and viewed from Adobe Bridge CS3, opened from the Welcome Screen, or
opened directly from the File menu. Depending on the product, template files range from letterheads, newsletters,
September 4, 2007
DREAMWEAVER CS3
User Guide
8
and websites to DVD menus and video buttons. Each template file is professionally constructed and represents a
best-use example of product features. Templates can be a valuable resource when you need to jump-start a project.
Samples Sample files include more complicated designs and are a great way to see new features in action. These files
demonstrate the range of creative possibilities available to you.
Fonts Several OpenType® fonts and font families are included with your Creative Suite product. Fonts are copied to
your computer during installation:
•Windows: [startup drive]\Windows\Fonts
•Mac OS X: [startup drive]/Library/Fonts
For information about installing fonts, see the Read Me file on the installation DVD.
DVD content
The installation or content DVD included with your product contains additional resources for use with your
software. The Goodies folder contains product-specific files such as templates, images, presets, actions, plug-ins, and
effects, along with subfolders for Fonts and Stock Photography. The Documentation folder contains a PDF version
of the Help, technical information, and other documents such as specimen sheets, reference guides, and specialized
feature information.
Adobe Exchange
For more free content, visit www.adobe.com/go/exchange, an online community where users download and share
thousands of free actions, extensions, plug-ins, and other content for use with Adobe products.
Bridge Home
Bridge Home, a new destination in Adobe Bridge CS3, provides up-to-date information on all your Adobe Creative
Suite 3 software in one convenient location. Start Adobe Bridge, then click the Bridge Home icon at the top of the
Favorites panel to access the latest tips, news, and resources for your Creative Suite tools.
ET VERO EOS ET ACCUSAM ET JUSTO
DUO DOLORES ET EA REBUM. STET CLITA KASD.
ET
COSETETUR SADIPSCING
01
PelletirInc.
CORE INVESTMENT SPECTRUM
Vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan
et iusto odio dignissim qui.
RETIREMENT SAVING PLAN
Vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan
et iusto odio dignissim qui.
Your Investment Guide
Are you leaving money on the table?
01
Typi non habent claritatem insitam; est usus legentis in iis qui facit eorum
claritatem. Investigationes demonstraverunt lectores legere me lius quod ii
legunt saepius. Claritas est etiam processus.
Typi non habent claritatem insitam; est usus legentis in iis qui facit eorum
claritatem. Investigationes demonstraverunt lectores legere me lius quod ii
legunt saepius. Claritas est etiam processus.
Travel Earth
Best 100 places to see on the planet
in your lifetime
volute
ipsummy
, commy
re eugia-
rud tem
eraes-
exer
n ullutet
Vel: Ad : Vulputate:
SURVICE MENU
NULCHE
vero dio eum
nulche
agiamet ad lorperit
sum a
$45
agiamet ad atin utet
vero dio eum
nulche suma
agaimet ad eum
nullam
$25
lorperit sum a
agiamet ad lorperit
vero dio
eum nullam
$35
SUCCIVEROS
sucicvero dio
vero dio eum
nulche suma
$15
eum nullam
vero dio eum
nulche suma
agaimet ad eum
nullam
$35
N
eum nullam
$35
SUCCIVEROS
sucicvero dio
vero dio eum
nulche suma
$15
eum nullam
vero dio eum
nulche suma
agaimet ad eum
nullam
$35
CC
a
si
o
p
i
a
S
p
A
September 4, 2007
DREAMWEAVER CS3
User Guide
9
Note: Bridge Home may not be available in all languages.
Adobe Design Center
Adobe Design Center offers articles, inspiration, and instruction from industry experts, top designers, and Adobe
publishing partners. New content is added monthly.
You can find hundreds of tutorials for design products and learn tips and techniques through videos, HTML
tutorials, and sample book chapters.
September 4, 2007
DREAMWEAVER CS3
User Guide
10
New ideas are the heart of Think Tank, Dialog Box, and Gallery:
•ThinkTankarticlesconsiderhowtoday’sdesignersengagewithtechnologyandwhattheirexperiencesmeanfor
design, design tools, and society.
•In Dialog Box, experts share new ideas in motion graphics and digital design.
•The Gallery showcases how artists communicate design in motion.
Visit Adobe Design Center at www.adobe.com/designcenter.
Adobe Developer Center
Adobe Developer Center provides samples, tutorials, articles, and community resources for developers who build
rich Internet applications, websites, mobile content, and other projects using Adobe products. The Developer Center
also contains resources for developers who develop plug-ins for Adobe products.
In addition to sample code and tutorials, you'll find RSS feeds, online seminars, SDKs, scripting guides, and other
technical resources.
Visit Adobe Developer Center at www.adobe.com/go/developer.
Customer support
VisittheAdobeSupportwebsite,atwww.adobe.com/support, to find troubleshooting information for your product
and to learn about free and paid technical support options. Click the Training link for access to Adobe Press books,
a variety of training resources, Adobe software certification programs, and more.
Downloads
Visit www.adobe.com/go/downloads to find free updates, tryouts, and other useful software. In addition, the Adobe
Store (at www.adobe.com/go/store) provides access to thousands of plug-ins from third-party developers, helping
you to automate tasks, customize workflows, create specialized professional effects, and more.
September 4, 2007
DREAMWEAVER CS3
User Guide
11
Adobe Labs
Adobe Labs gives you the opportunity to experience and evaluate new and emerging technologies and products from
Adobe.
At Adobe Labs, you have access to resources such as these:
•Prerelease software and technologies
•Code samples and best practices to accelerate your learning
•Early versions of product and technical documentation
•Forums, wiki-based content, and other collaborative resources to help you interact with like-minded developers
Adobe Labs fosters a collaborative software development process. In this environment, customers quickly become
productive with new products and technologies. Adobe Labs is also a forum for early feedback, which the Adobe
development teams use to create software that meets the needs and expectations of the community.
Visit Adobe Labs at www.adobe.com/go/labs.
User communities
User communities feature forums, blogs, and other avenues for users to share technologies, tools, and information.
Users can ask questions and find out how others are getting the most out of their software. User-to-user forums are
available in English, French, German, and Japanese; blogs are posted in a wide range of languages.
To participate in forums or blogs, visit www.adobe.com/communities.
What’s new
Top new features of Adobe Dreamweaver CS3
Spry framework for Ajax
With Adobe® Dreamweaver® CS3, you can visually design, develop, and deploy dynamic user interfaces using the
Spry framework for Ajax. The Spry framework for Ajax is a JavaScript library for web designers that allows designers
to build pages that provide a richer experience for their users. Unlike other Ajax frameworks, Spry is accessible to
both designers and developers alike, as 99% of it is actually HTML. See “Building Spry pages visually” on page 449.
Spry widgets
Spry widgets are prebuilt, common user interface components that you can customize using CSS, and then add to
your web pages. With Dreamweaver, you can add a number of Spry widgets to your pages, including XML-driven
lists and tables, accordions, tabbed interfaces, and form elements with validation. See “Adding Spry widgets” on
page 449.
Spry effects
Spry effects are a simple, elegant way of enhancing the look and feel of your website. You can apply them to almost
any element on an HTML page. You can add Spry effects to enlarge, shrink, fade, and highlight elements; visually
alter a page element for a certain period of time; and more. See “Adding Spry effects” on page 486.
September 4, 2007
DREAMWEAVER CS3
User Guide
12
Advanced Photoshop CS3 integration
Dreamweaver includes enhanced integration with Photoshop CS3. Now, designers can simply select any portion of
a design in Photoshop—even across multiple layers—and paste it directly into a Dreamweaver page. Dreamweaver
presents a dialog box where you can specify optimization options for the image. Should you ever need to edit the
image, simply double-click the image to open the original layered PSD file in Photoshop for editing. See “Working
with Photoshop” on page 374.
Browser Compatibility Check
The new Browser Compatibility Check feature in Dreamweaver generates reports that identify CSS-related
rendering issues in a variety of browsers. In code view, issues are flagged with green underlining, so you know exactly
where the problem is. After you identify the problem, you can quickly fix it if you know the solution, or, if you need
more information, you can visit Adobe CSS Advisor. See “Check for cross-browser CSS rendering issues” on
page 141.
Adobe CSS Advisor
The Adobe CSS Advisor website contains information on the latest CSS issues, and is accessible directly from the
Dreamweaver user interface during the Browser Compatibility Check process. More than a forum, a wiki page, or a
discussion group, CSS Advisor makes it easy for you to comment with suggestions and improvements to existing
content, or to add new issues for the benefit of the entire community. See “Check for cross-browser CSS rendering
issues” on page 141.
CSS Layouts
Dreamweaver offers a set of predesigned CSS layouts that get your page up and running quickly and help you learn
about CSS page layout by providing extensive inline comments in the code. Most site designs on the web can be
categorized as one-, two-, or three-column layouts, each with a number of additional elements (such as headers and
footers). Dreamweaver now offers a comprehensive list of essential layout designs that you can customize to fit your
needs. See “Create a page with a CSS layout” on page 149.
Manage CSS
The Manage CSS feature makes it easier for you to move CSS rules from document to document, from the head of a
document to an external sheet, between external CSS files, and more. You can also convert inline CSS to CSS rules,
and place them where you need them—just by dragging and dropping. See “Move CSS rules” on page 137 and
“Convert inline CSS to a CSS rule” on page 138.
Adobe Device Central
Integrated with Dreamweaver as well as throughout the family of Creative Suite 3 software, Adobe Device Central
simplifies the creation of mobile content by giving you the ability to quickly access essential technical specifications
for each device, and shrink the text and images of your HTML page to show accurate rendering as it would appear
on the device. See “Previewing pages in mobile devices” on page 300.
Adobe Bridge CS3
Use Dreamweaver with Adobe Bridge CS3 for easy and consistent management of images and assets. Adobe Bridge
provides centralized access to your project files, applications, and settings, along with XMP metadata tagging and
searching capabilities. With its file-organization and file-sharing features, plus access to Adobe Stock Photos, Adobe
Bridge provides a more efficient creative workflow and keeps you on top of your print, web, video, and mobile
projects. See “Working with Bridge” on page 383.
September 4, 2007
13
Chapter 2: Workspace
The Adobe® Dreamweaver® CS3 workspace contains the toolbars, inspectors, and panels that you use to build web
pages. You can customize the general appearance and behavior of the workspace.
Dreamweaver workflow and workspace
Dreamweaver workflow overview
You can use several approaches to create a website; this is one approach:
Plan and set up your site
Determine where the files will go and examine site requirements, audience profiles, and site goals. Additionally,
consider technical requirements such as user access, as well as browser, plug-in, and download restrictions. After
you’veorganizedyourinformationanddeterminedastructure,youcanbegincreatingyoursite.(See“Workingwith
Dreamweaver sites” on page 40.)
Organize and manage your site files
In the Files panel you can easily add, delete, and rename files and folders to change the organization as needed. The
Files panel also has many tools for managing your site, transferring files to and from a remote server, setting up a
Check In/Check Out process to prevent files from being overwritten, and synchronizing the files on your local and
remote sites. From the Assets panel, you can easily organize the assets in a site; you can then drag most assets directly
from the Assets panel into a Dreamweaver document. You can also use Dreamweaver to manage aspects of your
Adobe®Contribute® sites. (See “Managing files and folders” on page 77 and “Managing assets and libraries” on
page 108.)
Lay out your web pages
Choose the layout technique that works for you, or use the Dreamweaver layout options in conjunction with one
another to create your site’s look. You can use Dreamweaver AP elements, CSS positioning styles, or predesigned CSS
layouts to create your layout. The table tools let you design pages quickly by drawing and then rearranging the page
structure. If you want to display multiple elements at once in a browser, you can use frames to lay out your
documents. Finally, you can create new pages based on a Dreamweaver template, then update the layout of those
pages automatically when the template changes. (See “Creating pages with CSS” on page 120 and “Laying out pages
with HTML” on page 173.)
Add content to pages
Add assets and design elements such as text, images, rollover images, image maps, colors, movies, sound, HTML
links, jump menus, and more. You can use built-in page-creation features for such elements as titles and
backgrounds, type directly in the page, or import content from other documents. Dreamweaver also provides
behaviors for performing tasks in response to specific events, such as validating a form when the visitor clicks the
Submit button or opening a second browser window when the main page is finished loading. Finally, Dreamweaver
provides tools for maximizing website performance and for testing pages to ensure compatibility with different web
browsers. (See “Adding content to pages” on page 214.)
September 4, 2007
DREAMWEAVER CS3
User Guide
14
Create pages by hand coding
Coding web pages by hand is another approach to creating pages. Dreamweaver provides easy-to-use visual editing
tools, but it also provides a sophisticated coding environment; you can use either approach, or both, to create and
edit your pages. (See “Working with page code” on page 301.)
Set up a web application for dynamic content
Many websites contain dynamic pages that allow visitors to view information stored in databases, and usually allow
some visitors to add new information and edit information in the databases. To create such pages, you must first set
up a web server and application server, create or modify a Dreamweaver site, and connect to a database. (See
“Preparing to build dynamic sites” on page 491.)
Create dynamic pages
In Dreamweaver, you can define a variety of sources of dynamic content, including recordsets extracted from
databases, form parameters, and JavaBeans components. To add the dynamic content to a page, simply drag it onto
the page.
You can set your page to display one record or many records at a time, display more than one page of records, add
special links to move from one page of records to the next (and back), and create record counters to help users keep
track of the records. You can encapsulate application or business logic using technologies such as Macromedia®
ColdFusion® from Adobe® and web services. If you need more flexibility, you can create custom server behaviors and
interactive forms. (See “Making pages dynamic” on page 538.)
Test and publish
Testing your pages is an ongoing process that happens throughout the development cycle. At the end of the cycle,
you publish the site on a server. Many developers also schedule periodic maintenance to ensure that the site remains
current and functional. (See “Getting and putting files to and from your server” on page 87.)
Workspace layout overview
The Dreamweaver workspace lets you view documents and object properties. The workspace also places many of the
most common operations in toolbars so that you can quickly make changes to your documents.
In Windows®, Dreamweaver provides an all-in-one-window integrated layout. In the integrated workspace, all
windows and panels are integrated into a single larger application window.
September 4, 2007
DREAMWEAVER CS3
User Guide
15
A. Insert bar B. Document toolbar C. Document window D. Panel groups E. Tag selector F. Property inspector G. Files panel
On Mac OS®, Dreamweaver can display multiple documents in a single window with tabs that identify each
document. Dreamweaver can also display a floating workspace in which each document appears in its own
individual window. Panel groups are initially docked together, but can be undocked into their own windows.
Windows “snap” automatically to each other, to the sides of the screen, and to the Document window as you drag or
resize them.
A. Insert bar B. Document toolbar C. Document window D. Panel groups E. Tag selector F. Property inspector G. Files panel
For a tutorial on setting up the Dreamweaver workspace, see www.adobe.com/go/vid0143.
A B C D
E F G
A B C D
E F G
September 4, 2007
DREAMWEAVER CS3
User Guide
16
See also
“Using toolbars, inspectors, context menus, and panels” on page 27
“Choose the workspace layout (Windows)” on page 34
“Choose the workspace layout (Macintosh)” on page 34
“Display tabbed documents (Macintosh)” on page 34
Workspace elements overview
The workspace includes the following elements.
Note: Dreamweaver provides many other panels, inspectors, and windows. To open the panels, inspectors, and windows,
use the Window menu.
The Welcome screen Lets you open a recent document or create a new document. From the Welcome screen, you
can also learn more about Dreamweaver by taking a product tour or a tutorial.
The Insert bar Contains buttons for inserting various types of objects, such as images, tables, and AP elements, into
a document. Each object is a piece of HTML code that lets you set various attributes as you insert it. For example,
you can insert a table by clicking the Table button in the Insert bar. If you prefer, you can insert objects using the
Insert menu instead of the Insert bar.
The Document toolbar Contains buttons that provide options for different views of the Document window (such as
Design view and Code view), various viewing options, and some common operations such as previewing in a
browser.
The Standard toolbar (Not displayed in the default workspace layout.) Contains buttons for common operations
fromtheFileandEditmenus:New,Open,Save,SaveAll,Cut,Copy,Paste,Undo,andRedo.TodisplaytheStandard
toolbar, select View > Toolbars > Standard.
The Coding toolbar (Displayed in Code view only.) Contains buttons that let you perform many standard coding
operations.
The Style Rendering toolbar (Hidden by default.) Contains buttons that let you see how your design would look in
different media types if you used media-dependent style sheets. It also contains a button that lets you enable or
disable Cascading Style Sheets (CSS) styles.
The Document window Displays the current document as you create and edit it.
The Property inspector Lets you view and change a variety of properties for the selected object or text. Each kind of
object has different properties. The Property inspector is not expanded by default in the Coder workspace layout.
The tag selector Located in the status bar at the bottom of the Document window. Shows the hierarchy of tags
surrounding the current selection. Click any tag in the hierarchy to select that tag and all its contents.
Panel groups Sets of related panels grouped together under one heading. To expand a panel group, click the
expanderarrowattheleftofthegroup’sname;toundockapanelgroup,dragthegripperattheleftedgeofthegroup’s
title bar.
The Files panel Lets you manage your files and folders, whether they are part of a Dreamweaver site or on a remote
server. The Files panel also lets you access all the files on your local disk, much like Windows Explorer (Windows)
or the Finder (Macintosh).
September 4, 2007
DREAMWEAVER CS3
User Guide
17
See also
“Working in the Document window” on page 24
“Using toolbars, inspectors, context menus, and panels” on page 27
“About panel groups” on page 31
Document window overview
The Document window shows the current document. You can select any of the following views:
Design view A design environment for visual page layout, visual editing, and rapid application development. In this
view, Dreamweaver displays a fully editable, visual representation of the document, similar to what you would see
when viewing the page in a browser. You can configure the Design view to display dynamic content while you’re
working on the document.
Code view A hand-coding environment for writing and editing HTML, JavaScript, server-language code—such
PHP or ColdFusion Markup Language (CFML)—and any other kind of code.
Code and Design view Lets you see both Code view and Design view for the same document in a single window.
WhentheDocumentwindowhasatitlebar,thetitlebardisplaysthepagetitleand,inparentheses,thefile’spathand
filename. After the filename, Dreamweaver displays an asterisk if you’ve made changes that you haven’t saved yet.
When the Document window is maximized in the integrated workspace layout (Windows only), it has no title bar;
in that case the page title and the file’s path and filename appear in the title bar of the main workspace window.
When a Document window is maximized, tabs appear at the top of the Document window showing the filenames of
all open documents. To switch to a document, click its tab.
See also
“Working in the Document window” on page 24
“About coding in Dreamweaver” on page 301
“View live data in Design view” on page 579
Document toolbar overview
The Document toolbar contains buttons that let you toggle between different views of your document quickly: Code,
Design, and a split view that shows both Code and Design views.
Thetoolbaralsocontainssomecommoncommandsandoptionsrelatedtoviewingthedocumentandtransferring
it between the local and remote sites.
A. Show Code View B. Show Code and Design Views C. Show Design View D. Document Title E. File Management F. Preview/Debug in
Browser G. Refresh Design View H. View Options I. Visual Aids J. Validate Markup K. Check Browser Compatibility
The following options appear in the Document toolbar:
Show Code View Displays only the Code view in the Document window.
Show Code and Design Views Splits the Document window between the Code and the Design views. When you
select this combined view, the option Design View on Top becomes available in the View Options menu.
A B C D E F G H I J K
September 4, 2007
DREAMWEAVER CS3
User Guide
18
Show Design View Displays only the Design view in the Document window.
Note: If you are working with XML, JavaScript, CSS, or other code-based file types, you cannot view the files in Design
view and the Design and Split buttons are dimmed out.
Document Title Allows you to enter a title for your document, to be displayed in the browser’s title bar. If your
document already has a title, it appears in this field.
File Management Displays the File Management pop-up menu.
Preview/Debug in Browser Allows you to preview or debug your document in a browser. Select a browser from the
pop-up menu.
Refresh Design View Refreshes the document’s Design view after you make changes in Code view. Changes you
make in Code view don’t automatically appear in Design view until you perform certain actions, such as saving the
file or clicking this button.
Note: Refreshing also updates code features that are DOM (Document Object Model) dependent, such as the ability to
select a code block’s opening or closing tags.
View Options Allows you to set options for Code view and Design view, including which view should appear above
the other. Options in the menu are for the current view: Design view, Code view, or both.
Visual Aids Lets you use different visual aids to design your pages.
Validate Markup Lets you validate the current document or a selected tag.
Check Browser Compatibility Lets you check if your CSS is compatible across different browsers.
See also
“Display toolbars” on page 27
“Customizing the coding environment” on page 308
“View and edit head content” on page 337
“Using visual aids for layout” on page 173
Standard toolbar overview
The Standard toolbar contains buttons for common operations from the File and Edit menus: New, Open, Save, Save
All, Cut, Copy, Paste, Undo, and Redo. Use these buttons just as you would use the equivalent menu commands.
See also
“Display toolbars” on page 27
“Creating and opening documents” on page 68
Status bar overview
The status bar at the bottom of the Document window provides additional information about the document you are
creating.
September 4, 2007
DREAMWEAVER CS3
User Guide
19
A. Tag selec tor B. Select tool C. Hand tool D. Zoom tool E. Set magnification F. Window Size pop-up menu G. Document size and estimated
download time
Tag selector Shows the hierarchy of tags surrounding the current selection. Click any tag in the hierarchy to select
that tag and all its contents. Click <body> to select the entire body of the document. To set the class or id attributes
for a tag in the tag selector, right-click (Windows) or Control-click (Macintosh) the tag and select a class or ID from
the context menu.
Select tool Enables and disables the Hand tool.
Hand tool Lets you click the document and drag it in the Document window.
Zoom tool and Set Magnification pop-up menu Let you set a magnification level for your document.
Window Size pop-up menu (Visible in Design view only.) Lets you resize the Document window to predetermined
or custom dimensions.
Document size and download time Shows the estimated document size and estimated download time for the page,
including all dependent files such as images and other media files.
See also
“Set window size and connection speed” on page 26
“Zoom in and out” on page 223
“Resize the Document window” on page 25
“Set download time and size preferences” on page 225
Insert bar overview
The Insert bar contains buttons for creating and inserting objects such as tables, AP elements, and images. When you
roll the pointer over a button, a tooltip appears with the name of the button.
The buttons are organized into several categories, which you can switch by clicking the tabs along the top of the
Insert bar. Additional categories appear when the current document contains server code, such as ASP or CFML
documents. When you start Dreamweaver, the category you were last working in opens.
Some categories have buttons with pop-up menus. When you select an option from a pop-up menu, it becomes the
default action for the button. For example, if you select Image Placeholder from the Image button’s pop-up menu, the
next time you click the Image button, Dreamweaver inserts an image placeholder. Anytime you select a new option
from the pop-up menu, the default action for the button changes.
The Insert bar is organized in the following categories:
The Common category Lets you create and insert the most commonly used objects, such as images and tables.
A B C D E F G
September 4, 2007
DREAMWEAVER CS3
User Guide
20
The Layout category Lets you insert tables, div tags, frames, and Spry widgets. You can also choose two views for
tables: Standard (default) and Expanded Tables.
The Forms category Contains buttons for creating forms and inserting form elements, including Spry validation
widgets.
The Data category Lets you insert Spry data objects as well as other dynamic elements like recordsets, repeated
regions, and record insertion and update forms.
The Spry category Contains buttons for building Spry pages, including Spry data objects and widgets.
The Text category Lets you insert a variety of text- and list-formatting tags, such as b,em,p,h1, and ul.
The Favorites category LetsyougroupandorganizetheInsertbarbuttonsyouusethemostinonecommonplace.
Server-code categories Available only for pages that use a particular server language, including ASP, ASP.NET,
CFML Basic, CFML Flow, CFML Advanced, JSP, and PHP. Each of these categories provides server-code objects that
you can insert in Code view.
See also
“Use the Insert bar” on page 28
“Building Spry pages visually” on page 449
Coding toolbar overview
The Coding toolbar contains buttons that let you perform many standard coding operations, such as collapsing and
expanding code selections, highlighting invalid code, applying and removing comments, indenting code, and
inserting recently used code snippets. The Coding toolbar is visible only in Code view and appears vertically on the
left side of the Document window.
You cannot undock or move the Coding toolbar, but you can hide it.
September 4, 2007
DREAMWEAVER CS3
User Guide
21
You can also edit the Coding toolbar to display more buttons (such as Word Wrap, Show Hidden Characters, and
Auto Indent), or hide buttons that you don’t want to use. To do so, however, you must edit the XML file that generates
the toolbar. For more information, see Extending Dreamweaver.
See also
“Display toolbars” on page 27
“Insert code with the Coding toolbar” on page 316
Style Rendering toolbar overview
The Style Rendering toolbar (hidden by default) contains buttons that let you see how your design would look in
different media types if you use media-dependent style sheets. It also contains a button that lets you enable or disable
CSS styles. To display the toolbar, select View > Toolbars > Style Rendering.
This toolbar only works if your documents use media-dependent style sheets. For example, your style sheet might
specify a body rule for print media and a different body rule for handheld devices. For more information on creating
media-dependent style sheets, see the World Wide Web Consortium website at www.w3.org/TR/CSS21/media.html.
By default, Dreamweaver displays your design for the screen media type (which shows you how a page is rendered
on a computer screen). You can view the following media type renderings by clicking the respective buttons in the
Style Rendering toolbar.
Render Screen Media Type Shows you how the page appears on a computer screen.
Render Print Media Type Shows you how the page appears on a printed piece of paper.
Render Handheld Media Type Shows you how the page appears on a handheld device, such as a mobile phone or a
BlackBerry device.
Render Projection Media Type Shows you how the page appears on a projection device.
Render TTY Media Type Shows you how the page appears on a teletype machine.
Render TV Media Type Shows you how the page appears on a television screen.
Toggle Displaying Of CSS Styles Lets you enable or disable CSS styles. This button works independently of the other
media buttons.
For a tutorial on designing style sheets for print and handheld devices, see www.adobe.com/go/vid0156.
See also
“Display toolbars” on page 27
September 4, 2007
DREAMWEAVER CS3
User Guide
22
Property inspector overview
The Property inspector lets you examine and edit the most common properties for the currently selected page
element, such as text or an inserted object. The contents of the Property inspector vary depending on the element
selected.Forexample,ifyouselectanimageonyourpage,thePropertyinspectorchangestoshowpropertiesforthe
image (such as the file path to the image, the width and height of the image, the border around the image, if any, and
so on).
ThePropertyinspectorisattheloweredgeoftheworkspacebydefault,butyoucandockitattheupperedgeofthe
workspace, or make it a floating panel in the workspace.
See also
“Dock and undock panels and panel groups” on page 32
“Use the Property inspector” on page 30
Files panel overview
Use the Files panel to view and manage the files in your Dreamweaver site.
When you view sites, files, or folders in the Files panel, you can change the size of the viewing area, and expand or
collapsetheFilespanel.WhentheFilespaneliscollapsed,itdisplaysthecontentsofthelocalsite,theremotesite,or
the testing server as a list of files. When expanded, it displays the local site and either the remote site or testing server.
The Files panel can also display a visual site map of the local site.
September 4, 2007
DREAMWEAVER CS3
User Guide
23
For Dreamweaver sites, you can also customize the Files panel by changing the view—either your local or remote
site—that appears by default in the collapsed panel.
See also
“Work with files in the Files panel” on page 80
CSS Styles panel overview
The CSS Styles panel lets you track the CSS rules and properties affecting a currently selected page element (Current
mode), or the rules and properties affecting an entire document (All mode). A toggle button at the top of the CSS
Styles panel lets you switch between the two modes. The CSS Styles panel also lets you modify CSS properties in both
All and Current mode.
You can resize any of the panes by dragging the borders between the panes.
In Current mode, the CSS Styles panel displays three panes: a Summary for Selection pane that displays the CSS
properties for the current selection in the document, a Rules pane that displays the location of selected properties
(or a cascade of rules for the selected tag, depending on your selection), and a Properties pane that lets you edit CSS
properties for the rule defining the selection.
In All mode, the CSS Styles panel displays two panes: an All Rules pane (on top), and a Properties pane (on bottom).
The All Rules pane displays a list of rules defined in the current document as well as all rules defined in style sheets
attached to the current document. The Properties pane lets you edit CSS properties for any selected rule in the All
Rules pane.
Any changes you make in the Properties pane are applied immediately, letting you preview your work as you go.
See also
“Creating and managing CSS” on page 124
September 4, 2007
DREAMWEAVER CS3
User Guide
24
Visual guides overview
Dreamweaver provides several kinds of visual guides to help you design documents and predict approximately how
they appear in browsers. You can do any of the following:
•Instantly snap the Document window to a desired window size to see how the elements fit on the page.
•Use a tracing image as the page background to help you duplicate a design created in an illustration or image-
editing application such as Adobe® Photoshop® or Adobe® Fireworks®.
•Use rulers and guides to provide a visual cue for precise positioning and resizing of page elements.
•Use the grid for precise positioning and resizing of absolutely positioned elements (AP elements).
Grid marks on the page help you align AP elements, and when snapping is enabled, AP elements automatically snap
to the closest grid point when moved or resized. (Other objects, such as images and paragraphs, do not snap to the
grid.) Snapping works regardless of whether the grid is visible.
See also
“Using visual aids for layout” on page 173
GoLive users
IfyouhavebeenusingGoLiveandwanttoswitchtoworkingwithDreamweaver,youcanfindanonlineintroduction
to the Dreamweaver workspace and workflow, as well as a discussion of ways to migrate your sites to Dreamweaver.
For more information, see www.adobe.com/go/learn_dw_golive.
Working in the Document window
Switch between views in the Document window
You can view a document in the Document window in Code view, Design view, or Code and Design views.
See also
“Document window overview” on page 17
Switch to Code view
❖Do one of the following:
•Select View > Code.
•In the Document toolbar, click the Show Code View button
Switch to Design view
❖Do one of the following:
•Select View > Design.
•In the Document toolbar, click the Show Design View button
September 4, 2007
DREAMWEAVER CS3
User Guide
25
Show both Code and Design views
❖Do one of the following:
•Select View > Code and Design.
•In the Document toolbar, click the Show Code and Design Views button
Toggle between Code view and Design view
❖Press Control+backquote (`).
IfbothviewsareshowingintheDocumentwindow,thiskeyboardshortcutchangeskeyboardfocusfromoneview
to the other.
Cascade or tile Document windows
If you have many documents open at once, you can cascade or tile them.
See also
“Choose the workspace layout (Windows)” on page 34
“Display tabbed documents (Macintosh)” on page 34
“Save custom workspace layouts” on page 35
Cascade Document windows
❖Select Window > Cascade.
Tile Document windows
•(Windows) Select Window > Tile Horizontally or Window > Tile Vertically.
•(Macintosh) Select Window > Tile.
Resize the Document window
The status bar displays the Document window’s current dimensions (in pixels). To design a page that looks its best
at a specific size, you can adjust the Document window to any of the predetermined sizes, edit those predetermined
sizes, or create sizes.
Resize the Document window to a predetermined size
❖Select one of the sizes from the Window Size pop-up menu at the bottom of the Document window.
Note: (Windowsonly)YoucanmaximizeaDocumentwindowsothatitfillstheentiredocumentareaoftheintegrated
window. You can’t resize a Document window when it is maximized.
September 4, 2007
DREAMWEAVER CS3
User Guide
26
The window size shown reflects the inside dimensions of the browser window, without borders; the monitor size is
listed in parentheses. For example, you would use the size “536 x 196 (640 x 480, Default)” if your visitors are likely
to be using Microsoft Internet Explorer or Netscape Navigator in their default configurations on a 640 x 480 monitor.
For less precise resizing, use your operating system’s standard methods of resizing windows, such as dragging the
lower-right corner of a window.
Change the values listed in the Window Size pop-up menu
1Select Edit Sizes from the Window Size pop-up menu.
2Click any of the width or height values in the Window Sizes list, and type a new value.
To make the Document window adjust only to a specific width (leaving the height unchanged), select a height value
and delete it.
3Click the Description box to enter descriptive text about a specific size.
Add a new size to the Window Size pop-up menu
1Select Edit Sizes from the Window Size pop-up menu.
2Click the blank space below the last value in the Width column.
3Enter values for Width and Height.
To set the Width or Height only, simply leave one field empty.
4Click the Description field to enter descriptive text about the size you added.
For example, you might type SVGA or average PC next to the entry for an 800 x 600 pixel monitor, and 17-in. Mac
next to the entry for an 832 x 624 pixel monitor. Most monitors can be adjusted to a variety of pixel dimensions.
Set window size and connection speed
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select Status Bar from the Category list on the left.
3Set any of the following options:
Window Sizes lets you customize the window sizes that appear in the status bar’s pop-up menu.
Connection Speed determines the connection speed (in kilobits per second) used to calculate the download size.
The download size for the page is displayed in the status bar. When an image is selected in the Document window,
the image’s download size is displayed in the Property inspector.
See also
“Status bar overview” on page 18
“Resize the Document window” on page 25
Reports in Dreamweaver
You can run reports in Dreamweaver to find content, troubleshoot, or test content. You can generate the following
types of reports:
Search Lets you search for tags, attributes, and specific text within tags.
Validation Lets you check for code or syntax errors.
September 4, 2007
DREAMWEAVER CS3
User Guide
27
Target Browser Check Lets you test the HTML in your documents to see if any tags or attributes are unsupported by
your target browsers.
Link Checker Lets you find and fix broken, external, and orphaned links.
Site Reports Enable you to improve workflow and test HTML attributes in your site. Workflow reports include
checked out by, recently modified, and design notes; HTML reports include combinable nested font tags, accessi-
bility, missing Alt text, redundant nested tags, removable empty tags, and untitled documents.
FTP Log Enables you to view all FTP file transfer activity.
Server Debug Lets you view information to debug a Macromedia® ColdFusion® from Adobe® application.
See also
“Search for tags, attributes, or text in code” on page 320
“Testing your site” on page 104
“Validate tags” on page 328
“Check for browser compatibility” on page 328
“Find broken, external, and orphaned links” on page 295
“Put files on a remote server” on page 89
“Get files from a remote server” on page 88
“Use the ColdFusion debugger (Windows only)” on page 329
Using toolbars, inspectors, context menus, and panels
Display toolbars
UsetheDocumentandStandardtoolbarstoperformdocument-relatedandstandardeditingoperations;theCoding
toolbar to insert code quickly; and the Style Rendering toolbar to display your page as it would appear in different
media types. You can choose to display or hide the toolbars as necessary.
•Select View > Toolbars, and then select the toolbar.
•
Right-click (Windows) or Control-click (Macintosh) any of the toolbars and select the toolbar from the context menu.
Note: To display or hide the Coding toolbar in the Code inspector (Window > Code Inspector), select Coding Toolbar
from the View Options pop-up menu at the top of the inspector.
See also
“Document toolbar overview” on page 17
“Standard toolbar overview” on page 18
“Coding toolbar overview” on page 20
“Style Rendering toolbar overview” on page 21
September 4, 2007
DREAMWEAVER CS3
User Guide
28
Use the Insert bar
The Insert bar contains buttons for creating and inserting objects such as tables and images. The buttons are
organized into categories.
See also
“Insert bar overview” on page 19
“Edit tags with Tag editors” on page 319
“Select and view elements in the Document window” on page 219
Hide or show the Insert bar
•Select Window > Insert.
•Right-click (Windows) or Control-click (Macintosh) in the Insert bar or the Document, Standard, or Coding
toolbar, and then select Insert Bar.
Note: If you are working with certain types of files, such as XML, JavaScript, Java, and CSS, the Insert bar and the Design
view option are dimmed because you cannot insert items into these code files.
Show the buttons in a particular category
❖Click the category names at the top of the Insert bar.
Display the pop-up menu for a button
❖Click the down arrow beside the button’s icon.
Show Insert bar categories as a menu:
❖Right-click (Windows) or Control-click (Macintosh) a category tab in the Insert bar, and then select Show
as Menus.
Show Insert bar categories as tabs
❖Click the arrow beside the category name on the left end of the Insert bar, and then select Show as Tabs.
Insert an object
1Select the appropriate category from the left side of the Insert bar.
2Do one of the following:
•Click an object button or drag the button’s icon into the Document window.
•Click the arrow on a button, then select an option from the menu.
September 4, 2007
DREAMWEAVER CS3
User Guide
29
Depending on the object, a corresponding object-insertion dialog box may appear, prompting you to browse to a file
or specify parameters for an object. Or, Dreamweaver may insert code into the document, or open a tag editor or a
panel for you to specify information before the code is inserted.
For some objects, no dialog box appears if you insert the object in Design view, but a tag editor appears if you insert
the object in Code view. For a few objects, inserting the object in Design view causes Dreamweaver to switch to Code
view before inserting the object.
Note: Some objects, such as named anchors, are not visible when the page is viewed in a browser window. You can
display icons in Design view that mark the locations of such invisible objects.
Bypass the object-insertion dialog box and insert an empty placeholder object
❖Control-click (Windows) or Option-click (Macintosh) the button for the object.
For example, to insert a placeholder for an image without specifying an image file, Control-click or Option-click the
Image button.
Note: This procedure does not bypass all object-insertion dialog boxes. Many objects, including navigation bars, AP
elements, Flash buttons, and framesets, do not insert placeholders or default-valued objects.
Modify preferences for the Insert bar
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2In the General category of the Preferences dialog box, deselect Show Dialog When Inserting Objects to suppress
dialog boxes when you insert objects such as images, tables, scripts, and head elements or by holding down the
Control key (Windows) or the Option key (Macintosh) while creating the object.
Whenyouinsertanobjectwiththisoptionoff,theobjectisgivendefaultattributevalues.UsethePropertyinspector
to change object properties after inserting the object.
Add, delete, or manage items in the Favorites category of the Insert bar
1Select any category in the Insert bar.
2Right-click (Windows) or Control-click (Macintosh) in the area where the buttons appear (do not right-click in
the category name), and then select Customize Objects.
3Make changes as necessary, and click OK. If you’re not in the Favorites category, select that category to see your
changes.
•To add an object, select an object in the Available Objects pane on the left, and then click the arrow between the
two panes or double-click the object in the Available Objects pane.
Note: Youcanaddoneobjectatatime.Youcannotselectacategoryname,suchasCommon,toaddanentirecategory
to your favorites list.
•To delete an object or separator, select an object in the Favorite Objects pane on the right, and then click the
Remove Selected Object in Favorite Objects List button above the pane.
•Tomoveanobject,selectanobjectintheFavoriteObjectspaneontheright,andthenclicktheUporDownarrow
button above the pane.
•To add a separator below an object, select an object in the Favorite Objects pane on the right, and then click the
Add Separator button below the pane.
September 4, 2007
DREAMWEAVER CS3
User Guide
30
Insert objects using buttons in the Favorites category
❖Select the Favorites category from the left side of the Insert bar, and then click the button for any Favorites object
that you added.
Use the Property inspector
The Property inspector lets you examine and edit the most common properties for the currently selected page
element, such as text or an inserted object. The contents of the Property inspector vary depending on the element
selected.
Note: Use the Tag inspector to view and edit every attribute associated with a given tag properties.
See also
“Property inspector overview” on page 22
“Dock and undock panels and panel groups” on page 32
“Change attributes with the Tag inspector” on page 331
Show or hide the Property inspector
❖Select Window > Properties.
Expand or collapse the Property inspector
❖Click the expander arrow in the lower-right corner of the Property inspector.
View and change properties for a page element
1Select the page element in the Document window.
You might have to expand the Property inspector to view all the properties for the selected element.
2Change any of the properties in the Property inspector.
Note: For information on specific properties, select an element in the Document window, and then click the Help icon in
the upper-right corner of the Property inspector.
3If your changes are not immediately applied in the Document window, apply the changes in one of these ways:
•Click outside the property-editing text fields.
•Press Enter (Windows) or Return (Macintosh).
•Press Tab to switch to another property.
Use context menus
Context menus provide convenient access to the most useful commands and properties related to the object or
window you’re working with. Context menus list only those commands that pertain to the current selection.
1Right-click (Windows) or Control-click (Macintosh) the object or window.
September 4, 2007
DREAMWEAVER CS3
User Guide
31
2Select a command from the context menu.
About panel groups
Panels in Dreamweaver are grouped together into panel groups. The selected panel within a panel group appears as
a tab. Each panel group can be expanded or collapsed, and can be docked or undocked with other panel groups.
Panel groups can also be docked to the integrated application window (Windows only). This makes it easy to access
the panels you need without cluttering your workspace.
Note: When a panel group is floating (undocked), a narrow blank bar appears at the top of the panel group. In this
documentation, the term “panel group’s title bar” refers to the area where the panel group’s name appears, rather than to
this narrow blank bar.
View panels and panel groups
You can display or hide panel groups and panels in the workspace as necessary.
Expand or collapse a panel group
•Click the expander arrow on the left side of the panel group’s title bar .
•Click the panel group’s title to collapse the panel group.
Close a panel group so that it isn’t visible on your screen
❖Select Close Panel Group from the Options menu in the panel group’s title bar.
September 4, 2007
DREAMWEAVER CS3
User Guide
32
Open a panel group or panel that isn’t visible on your screen
❖From the Window menu, select a panel name.
A check mark next to an item in the Window menu indicates that the named item is currently open (though it may
be hidden behind other windows).
If you can’t find a panel, inspector, or window that’s marked as open, select Window > Arrange Panels to neatly lay
out all open panels.
Hide all panel groups
❖Select Window > Hide Panels.
Select a panel within an expanded panel group
❖Click the panel’s name.
See a panel group’s Options menu if it isn’t showing
❖Expand the panel group by clicking its name or its expander arrow.
The Options menu is visible only when the panel group is expanded.
Some options are available in the panel group’s context menu even when the group is collapsed;
right-click (Windows) or Control-click (Macintosh) the panel group’s title bar to view the context menu.
Dock and undock panels and panel groups
You can move panels and panel groups as necessary, and arrange them so that they are floating or docked in the
workspace.
Most panels can be docked only to the left or the right of the Document window area in the integrated workspace,
while others (such as the Property inspector and the Insert bar) can be docked only to the upper or lower edge of the
integrated window.
Note: You cannot undock the Files panel if you are in Expanded mode. To collapse the Files panel before undocking, click
the Expand/Collapse button-—the right-most button at the top of the panel. If you close the Files panel while it’s
undocked, it disappears from the interface. To retrieve it, press F8 or select Window > Files.
Undock a panel group
❖Dragthepanelgroupbyitsgripper (ontheleftsideofthepanelgroup’stitlebar)untilitsoutlineindicatesthat
it’s no longer docked.
Note: If you undock the Property inspector, its format changes so that it no longer has a gripper bar or title bar, but you
can click anywhere on the panel to drag it or redock it.
Minimize or restore a panel or panel group
❖Click the underlined panel title to minimize a panel. Click again to restore it to full size.
Redock a panel or panel group
❖Drag the panel group by its title bar to the left or right sides of the workspace until you see a dark black outline
appear, and then let go. You may have to drag it upward to get the black outline so you can add it to the set of panels
already displayed.
Note: Some panels, such as the Property inspector and Results, must dock above or below the Document window, not to
the left or right.
September 4, 2007
DREAMWEAVER CS3
User Guide
33
Dock a panel group to other panel groups (floating workspace) or to the integrated window (Windows only)
❖Drag the panel group by its gripper until its outline indicates that it’s docked.
Undock a panel from a panel group
❖Select Group With > New Panel Group from the Options menu in the panel group’s title bar.
You can also undock a panel by dragging it out of the panel group.
Dock a panel in another panel group
1Select the panel you want to move by clicking its tab.
2Select the destination panel group from the Group With submenu of the panel group’s Options menu.
The Group With command’s name changes depending on the name of the active panel.
Drag a floating (undocked) panel group without docking it
❖Drag the panel group by the bar above its title bar.
The panel group doesn’t dock as long as you don’t drag it by its gripper.
Resize and rename panel groups
You can change the size and name of panel groups depending on your needs.
Change the size of the panel groups
•For floating panels, drag to resize the set of panel groups just as you would drag to resize any window in your
operating system.
For example, you can drag the resize area at the lower-right corner of the set of panel groups.
•For docked panels, drag the splitter bar between the panels and the Document window.
Maximize a panel group
•Select Maximize Panel Group from the Options menu in the panel group’s title bar.
•Double-click anywhere in the panel group’s title bar.
Rename a panel group
1Select Rename Panel Group from the Options menu in the panel group’s title bar.
2Enter a new name and click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
34
Saving panel groups
Dreamweaver lets you save and restore different panel groups so that you can customize your workspace for different
activities. When you save a workspace layout, Dreamweaver remembers the panels in the specified layout, as well as
otherattributessuchasthepositionsandsizesofthepanels,theircollapsedorexpandedstates,thepositionandsize
of the application window, and the position and size of the Document window.
See also
“Save custom workspace layouts” on page 35
Customizing the Dreamweaver CS3 workspace
Choose the workspace layout (Windows)
You can switch to a different workspace at any time.
❖Select Window > Workspace Layout, and select any of the following workspace layouts:
Designer An integrated workspace using MDI (Multiple Document Interface), in which all Document windows and
panels are integrated into one larger application window, with the panel groups docked on the right.
Coder The same integrated workspace as Designer, but with the panel groups docked on the left, in a layout similar
to that used by Adobe® HomeSite® and ColdFusion, and with the Document window showing Code view by default.
Note: You can dock panel groups on either side of the workspace in either layout.
Dual Screen Letsyouorganizealayoutifyouhaveasecondarymonitor.Thislayoutputsallpanelsonthesecondary
monitor, and keeps the Document window and Property inspector on the primary monitor.
Choose the workspace layout (Macintosh)
You can switch to a different workspace at any time.
❖Select Window > Workspace Layout, and select either of the following workspace layouts:
Default An integrated workspace.
Dual Screen Letsyouorganizealayoutifyouhaveasecondarymonitor.Thislayoutputsallpanelsonthesecondary
monitor, and keeps the Document window and Property inspector on the primary monitor.
Display tabbed documents (Macintosh)
You can view multiple documents in a single Document window by using tabs to identify each document. You can
also display them as part of a floating workspace, in which each document appears in its own window.
Open a tabbed document in a separate window
❖
Right-click (Windows) or Control-click (Macintosh) the tab and select Move To New Window from the context menu.
Combine separate documents into tabbed windows
❖Select Window > Combine As Tabs.
September 4, 2007
DREAMWEAVER CS3
User Guide
35
Change the default tabbed document setting
1Select Dreamweaver > Preferences, and then select the General category.
2Select or deselect Open Documents in Tabs, and click OK.
Dreamweaver does not alter the display of documents that are currently open when you change preferences.
Documents opened after you select a new preference, however, display according to the preference you selected.
Save custom workspace layouts
Dreamweaver lets you save and restore different panel sets so that you can customize your workspace for different
activities. When you save a workspace layout, Dreamweaver remembers the panels in the specified layout, as well as
other attributes such as the positions and sizes of the panels, their collapsed or expanded states, and the position and
size of the application window.
See also
“About panel groups” on page 31
“Choose the workspace layout (Windows)” on page 34
Save a custom workspace layout
1Arrange the panels as desired.
2Select Window > Workspace Layout > Save Current.
3Enter a name for the layout and click OK.
Switch to another custom workspace layout
❖Select Window > Workspace Layout, and select your custom layout.
Rename or delete a custom workspace layout
1Select Window > Workspace Layout > Manage.
2Select a layout and do one of the following:
•To rename a layout, click the Rename button, enter a new layout name, and click OK.
•To delete a layout, click the Delete button.
Hide and display the Welcome screen
The Welcome screen appears when you start Dreamweaver and anytime that you do not have any documents open.
You can choose to hide the Welcome screen, and then later display it again. When the Welcome screen is hidden and
there are no documents open, the Document window is blank.
Hide the Welcome screen
❖Select the Don’t Show Again option on the Welcome screen.
Display the Welcome screen
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select the Show Welcome Screen option.
September 4, 2007
DREAMWEAVER CS3
User Guide
36
About customizing Dreamweaver in multiuser systems
You can customize Dreamweaver to suit your needs even in a multiuser operating system such as Windows XP or
Mac OS X.
Dreamweaver prevents any user’s customized configuration from affecting any other user’s customized configu-
ration. To accomplish this goal, the first time you run Dreamweaver in one of the multiuser operating systems that
it recognizes, the application creates copies of a variety of configuration files. These user configuration files are stored
in a folder that belongs to you.
For example, in Windows XP, they’re stored in C:\Documents and Settings\username\Application
Data\Adobe\Dreamweaver 9\Configuration (which may be inside a hidden folder).
In Windows Vista, they’re stored in C:\Users\username\Application Data\Adobe\Dreamweaver 9\Configuration
(which may be inside a hidden folder).
In Mac OS X, they’re stored inside your Home folder; specifically, in Users/username/Library/Application
Support/Adobe/Dreamweaver 9/Configuration.
If you reinstall or upgrade Dreamweaver, Dreamweaver automatically makes backup copies of existing user config-
uration files, so if you customized those files by hand, you still have access to the changes you made.
Set General preferences for Dreamweaver
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Set any of the following options:
Open Documents In Tabs Opens all documents in a single window with tabs that let you switch between documents
(Macintosh only).
Show Welcome Screen DisplaystheDreamweaverWelcomescreenwhenyoustartDreamweaverorwhenyoudon’t
have any documents open.
Reopen Documents on Startup Opens any documents that were open when you closed Dreamweaver. If this option
is not selected, Dreamweaver displays the Welcome screen or a blank screen when you start (depending on your
Show Welcome Screen setting).
Warn When Opening Read-Only Files Alerts you when you open a read-only (locked) file. Choose to unlock/check
out the file, view the file, or cancel.
Update Links When Moving Files Determines what happens when you move, rename, or delete a document within
your site. Set this preference to always update links automatically, never update links, or prompt you to perform an
update. (See “Update links automatically” on page 287.)
Show Dialog When Inserting Objects Determines whether Dreamweaver prompts you to enter additional infor-
mation when inserting images, tables, Shockwave movies, and certain other objects by using the Insert bar or the
Insertmenu.Ifthisoptionisoff,thedialogboxdoesnotappearandyoumustusethePropertyinspectortospecify
the source file for images, the number of rows in a table, and so on. For rollover images and Fireworks HTML, a
dialogboxalwaysappearswhenyouinserttheobject,regardlessofthisoptionsetting.(Totemporarilyoverridethis
setting, Control-click (Windows) or Command-click (Macintosh) when creating and inserting objects.)
Enable Double-Byte Inline Input Lets you enter double-byte text directly into the Document window if you are using
a development environment or language kit that facilitates double-byte text (such as Japanese characters). When this
option is deselected, a text input window appears for entering and converting double-byte text; the text appears in
the Document window after it is accepted.
September 4, 2007
DREAMWEAVER CS3
User Guide
37
Switch To Plain Paragraph After Heading Specifies that pressing Enter (Windows) or Return (Macintosh) at the end
of a heading paragraph in Design view creates a new paragraph tagged with a p tag. (A heading paragraph is one
that’s tagged with a heading tag such as h1 or h2.) When the option is disabled, pressing Enter or Return at the end
of a heading paragraph creates a new paragraph tagged with the same heading tag (allowing you to type multiple
headings in a row and then go back and fill in details).
Allow Multiple Consecutive Spaces Specifies that typing two or more spaces in Design view creates nonbreaking
spaces that appear in a browser as multiple spaces. (For example, you can type two spaces between sentences, as you
would on a typewriter.) This option is designed mostly for people who are used to typing in word processors. When
theoptionisdisabled,multiplespacesaretreatedasasinglespace(becausebrowserstreatmultiplespacesassingle
spaces).
Use <strong> and <em> in Place of <b> and <i> Specifies that Dreamweaver applies the strong tag whenever you
performanactionthatwouldnormallyapplythebtag, and applies the em tagwheneveryouperformanactionthat
would normally apply the itag. Such actions include clicking the Bold or Italic buttons in the text Property inspector
in HTML mode and choosing Text > Style > Bold or Text > Style > Italic. To use the band itags in your documents,
deselect this option.
Note: The World Wide Web Consortium discourages use of the b and i tags; the strong and em tags provide more
semantic information than the b and i tags do.
Use CSS Instead of HTML Tags Specifies that Dreamweaver uses CSS styles instead of HTML tags when you format
text with the Property inspector. By default, Dreamweaver formats text by using CSS. Each time a font, size, or color
is defined for a text selection, a new document-specific style is created, which is then available from the Property
inspector’s Style pop-up menu. The only exceptions are for bold and italic fonts, for which Dreamweaver uses HTML
tags instead of CSS.
Even if the document links to an external style sheet, new style declarations are written to the head of the document,
not in the CSS file.
This general behavior may differ in the following situations:
•If the document already formats everything using font tags, Dreamweaver uses font tags and modifies the body
tag to use HTML code.
•If the document’s body tagusesHTMLtosetthepage’sappearance,butthepagedoesn’texclusivelyusefont tags,
Dreamweaver still uses CSS to format text.
If you deselect this option, Dreamweaver uses HTML tags such as font tags to format text, and HTML code in the
body tag to set the page’s appearance.
Warn when placing editable regions within <p> or <h1><h6> tags Specifies whether a warning message is
displayed whenever you save a Dreamweaver template that has an editable region within a paragraph or heading tag.
The message tells you that users will not be able to create more paragraphs in the region. It is enabled by default.
Centering Specifies whether elements should be centered using divalign="center" or the center tag when you
click the Align Center button in the Property inspector.
Note: Both of these approaches to centering have been officially deprecated as of the HTML 4.01 specification; you should
use CSS styles to center text. Both of these approaches are still technically valid as of the XHTML 1.0 Transitional speci-
fication, but they’re no longer valid in the XHTML 1.0 Strict specification.
Maximum Number of History Steps Determines the number of steps that the History panel retains and shows. (The
default value should be sufficient for most users.) If you exceed the given number of steps in the History panel, the
oldest steps are discarded. (For more information, see “Task automation” on page 698.)
September 4, 2007
DREAMWEAVER CS3
User Guide
38
Spelling Dictionary lists the available spelling dictionaries. If a dictionary contains multiple dialects or spelling
conventions (such as American English and British English), the dialects are listed separately in the Dictionary
pop-up menu.
See also
“Workspace layout overview” on page 14
“Update links automatically” on page 287
Set Fonts preferences for documents in Dreamweaver
A document’s encoding determines how the document appears in a browser. Dreamweaver font preferences let you
view a given encoding in the font and size you prefer. The fonts you select in the Fonts Preferences dialog, however,
only affect the way fonts appear in Dreamweaver; they do not affect the way the document appears in a visitor’s
browser. To change the way fonts appear in a browser, you need to change the text by using the Property inspector
or by applying a CSS rule.
For information on setting a default encoding for new documents, see “Creating and opening documents” on
page 68.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select Fonts from the Category list on the left.
3Select an encoding type (such as Western European or Japanese) from the Font Settings list.
Note: To display an Asian language, you must be using an operating system that supports double-byte fonts.
4Select a font and size to use for each category of the selected encoding.
Note: To appear in the font pop-up menus, a font must be installed on your computer. For example, to see Japanese text
you must have a Japanese font installed.
Proportional Font The font that Dreamweaver uses to display normal text (for example, text in paragraphs,
headings, and tables). The default depends on your system’s installed fonts. For most U.S. systems, the default is
Times New Roman 12 pt. (Medium) on Windows and Times 12 pt. on Mac OS.
Fixed Font The font Dreamweaver uses to display text within pre,code, and tt tags. The default depends on your
system’s installed fonts. For most U.S. systems, the default is Courier New 10 pt. (Small) on Windows and Monaco
12 pt. on Mac OS.
Code View ThefontusedforalltextthatappearsintheCodeviewandCodeinspector.Thedefaultdependsonyour
system’s installed fonts.
See also
“Understanding document encoding” on page 216
Customize Highlighting colors
Use the Highlighting preferences to customize the colors that identify template regions, library items, third-party
tags, layout elements, and code in Dreamweaver.
September 4, 2007
DREAMWEAVER CS3
User Guide
39
See also
“Use the color picker” on page 223
“Change the highlight color of div tags” on page 164
Change a highlighting color
1Select Edit > Preferences and select the Highlighting category.
2Beside the object you want to change the highlighting color for, click the color box, and then use the color picker
to select a new color, or enter a hexadecimal value.
Activate or deactivate highlighting for an object
1Select Edit > Preferences and select the Highlighting category.
2Beside the object you want to activate or deactivate highlighting color for, select or deselect the Show option.
September 4, 2007
40
Chapter 3: Working with Dreamweaver
sites
An Adobe® Dreamweaver® CS3 site is a collection of all of the files and assets in your website. You can create web
pages on your computer, upload them to a web server, and maintain the site by transferring updated files whenever
you save them. You can also edit and maintain websites that were created without Dreamweaver.
Setting up a Dreamweaver site
About Dreamweaver sites
A website is a set of linked documents and assets with shared attributes, such as related topics, a similar design, or a
shared purpose. Dreamweaver is a site creation and management tool, so you can use it to create individual
documents and complete websites.
In Dreamweaver the term “site” refers to a local or remote storage location for the documents that belong to a website.
A Dreamweaver site provides a way to organize and manage all of your web documents, upload your site to a web
server, track and maintain your links, and manage and share files. You should define a site to take full advantage of
Dreamweaver features.
Note: To define a Dreamweaver site, you only need to set up a local folder. To transfer files to a web server or to develop
web applications, you must also add information for a remote site and testing server.
A Dreamweaver site consists of as many as three parts, or folders, depending on your development environment and
the type of website you are developing:
Local root folder Storesthefilesyou’reworkingon.Dreamweaverreferstothisfolderasyour“localsite.”Thisfolder
can be on your local computer or it can be on a network server. If you work directly on the server, Dreamweaver
uploads files to the server every time you save.
Remote folder Stores your files for testing, production, collaboration, and so on. Dreamweaver refers to this folder
as your “remote site” in the Files panel. Typically, your remote folder is on the computer where your web server is
running.
Together, the local and remote folders enable you to transfer files between your local hard disk and web server,
making it easy to manage files in your Dreamweaver sites.
Testing server folder The folder where Dreamweaver processes dynamic pages.
For a tutorial on defining a Dreamweaver site, see www.adobe.com/go/vid0145.
September 4, 2007
DREAMWEAVER CS3
User Guide
41
Understanding local and remote folder structure
WhenyouwanttouseDreamweavertoconnecttoaremotefolder,youspecifytheremotefolderintheRemoteInfo
category of the Site Definition dialog box. The remote folder that you specify (also referred to as the “host directory”)
should correspond to the local root folder of your Dreamweaver site. (The local root folder is the top-level folder of
your Dreamweaver site.) Remote folders, like local folders, can have any title, but commonly, Internet Service
Providers name the top-level remote folders for individual user accounts public_html, pub_html, or something
similar. If you are in charge of your own remote server, and can name the remote folder anything you want, it is a
good idea for your local root folder and remote folder to have the same name.
Thefollowingexampleshowsasamplelocalrootfolderontheleftandasampleremotefolderontheright.Thelocal
rootfolderonthelocalmachinemapsdirectlytotheremotefolderonthewebserver,ratherthantoanyoftheremote
folder’s sub folders, or folders that exist above the remote folder in the directory structure.
Note: The above example illustrates one local root folder on the local machine, and one top-level remote folder on the
remote web server. If, however, you are maintaining a number of Dreamweaver sites on your local machine, you would
need an equal number of remote folders on the remote server. In such a case the above example would not apply, and
you would instead create different remote folders within the public_html folder, and then map them to their corre-
sponding local root folders on your local machine.
When you first establish a remote connection, the remote folder on the web server is usually empty. Then, when you
use Dreamweaver to upload all of the files in your local root folder, the remote folder populates with all of your web
files. The directory structure of the remote folder and the local root folder should always be the same. (That is, there
should always be a one-to-one correspondence between the files and folders in your local root folder, and the files
and folders in your remote folder.) If the structure of the remote folder doesn’t match the structure of the local root
folder, Dreamweaver uploads files to the wrong place, where they might not be visible to site visitors. Additionally,
image and link paths can easily break when folder and file structures are not in synch.
TheremotefoldermustexistbeforeDreamweavercanconnecttoit.Ifyoudon’thaveadesignatedfolderthatactsas
your remote folder on the web server, create one or ask the server’s administrator to create one for you.
Using the Manage Sites dialog box
Use the Manage Sites dialog box to create a new site, edit a site, duplicate a site, remove a site, or import or export a
site’s settings.
1Select Site > Manage Sites and select a site from the list on the left.
2Click a button to select one of the options and click Done.
New Enables you to create a new site.
Edit Enables you to edit an existing site.
Duplicate Creates a copy of the site you selected. The copy appears in the site list window.
September 4, 2007
DREAMWEAVER CS3
User Guide
42
Remove Deletes the selected site; you cannot undo this action.
Export Enables you to export a site’s settings as an XML file (*.ste).
Import Enables you to select a site’s settings file (*.ste) to import.
See also
“Import and export site settings” on page 51
Set up and edit a local root folder
After you plan your site structure, you set up (define) a site in Dreamweaver. You should also define a site in order
to edit a website that wasn’t created in Dreamweaver. Setting up a Dreamweaver site is a way to organize all of the
documents associated with a website.
The local root folder is your working directory for your DW site. This folder can be on your local computer or on a
network server.
If you want to start editing files on your computer (without publishing them), set up only a local folder, and then add
remote and testing information later.
You can use Dreamweaver to edit an existing website on your local disk or to edit a remote site (or a branch of a
remote site), even if you didn’t use Dreamweaver to create the original site.
Note: You don’t need to specify a remote folder if your local root folder is on the system running your web server. This
implies the web server is running on your local computer.
1Select one of the following:
•To set up a new site, Select Site > New Site.
•To edit the setup of an existing site on your local disk or a remote site (or a branch of a remote site), whether it was
created in Dreamweaver or not, select Site > Manage Sites and click Edit.
Note: If you haven’t defined any Dreamweaver sites, the Site Definition dialog box appears and you don’t need to click New.
2Enter the setup information:
•To set up a site using the site setup wizard, click the Basic tab and follow the prompts.
•To set up local, remote, and testing folders (for processing dynamic pages) directly, click the Advanced tab, select
the Local Info category and set the options.
3Click OK and Done to create the site (displayed in the Files panel).
See also
“Access sites, a server, and local drives” on page 83
“Import and export site settings” on page 51
“Setting up a web application” on page 501
“Set the relative path of new links” on page 284
“Managing files and folders” on page 77
September 4, 2007
DREAMWEAVER CS3
User Guide
43
Local root folder setup options
If you choose to set the local root folder options directly instead of by using the Basic tab of the Site Definition dialog
box, click the Advanced tab and enter the information.
Note: Only the first two options are required to set up a working site on your computer.
Site Name The name that appears in the Files panel and in the Manage Sites dialog box; it does not appear in the
browser.
Local Root Folder The name of the folder on your local disk where you store site files, templates, and library items.
Create a folder on your hard disk or click the folder icon to browse to the folder. When Dreamweaver resolves root-
relative links, it does so relative to this folder.
Refresh Local File List Automatically Indicates whether Dreamweaver should automatically refresh the local file list
every time you copy files into your local site. Deselecting this option improves the speed of Dreamweaver when
copying such files; however, then the Local view of the Files panel does not automatically refresh and you must click
the Refresh button in the Files panel toolbar to manually refresh the panel.
Default Images Folder The path to the folder where the images you use in your site are kept. Enter the path or click
the folder icon to browse to the folder.
Links Relative To Changes the relative path of the links you create to other pages in the site. By default, Dreamweaver
creates links using document-relative paths. Select the Site Root option to change the path setting and make sure that
you specify the HTTP address in the HTTP Address option.
Changing this setting does not convert the path of existing links; the setting will only apply to new links you create
visually with Dreamweaver.
Content linked with a site root-relative path does not appear when you preview documents in a local browser unless
you specify a testing server, or select the Preview Using Temporary File option in Edit > Preferences > Preview In
Browser. This is because browsers don’t recognize site roots—servers do.
HTTP Address The URL that your website will use. This enables Dreamweaver to verify links within the site that use
absolute URLs or site root-relative paths. Dreamweaver also uses this address to make sure site root-relative links
work on the remote server, which may have a different site root. For example, if you are linking to an image file
located on your hard disk in the C:\Sales\images\ folder (where Sales is your local root folder), and the URL of your
completed site is http://www.mysite.com/SalesApp/ (where SalesApp is your remote root folder), you should enter
the URL in the HTTP Address text box to ensure that the path to the linked file on the remote server is
/SalesApp/images/.
Use Case-sensitive Link Checking Checks that the case of the links matches the case of the filenames when
Dreamweaver checks links. This option is useful on UNIX systems where filenames are case-sensitive.
Enable Cache Indicates whether to create a local cache to improve the speed of link and site management tasks. If
you do not select this option, Dreamweaver asks you if you want to create a cache again before it creates the site. It is
a good idea to select this option because the Assets panel (in the Files panel group) only works if a cache is created.
Set up a remote folder
This folder is where you store files for production, collaboration, deployment, or a number of other scenarios.
Typically, the remote folder is on the computer where your web server is running. You can set options for this folder
by answering the wizard questions in the Basic tab or by clicking the Advanced tab and entering the information
directly.
In the Dreamweaver Files panel, the remote folder is referred to as your remote site.Whenyousetuparemotefolder,
you must select an access method for Dreamweaver to upload and download files to your web server.
September 4, 2007
DREAMWEAVER CS3
User Guide
44
For a tutorial on setting up a remote folder, see www.adobe.com/go/vid0162.
Note: Dreamweaver supports connections to IPv6-enabled servers. Supported connection types include FTP, SFTP,
WebDav, and RDS. For more information, see www.ipv6.org/
1Select Site > Manage Sites.
2Click New and select Site to set up a new site, or select an existing Dreamweaver site and click Edit.
3Click the Advanced tab, select the Remote Info category and select the access method you want to use to transfer
files between local and remote folders:
None Keep this default setting if you do not plan to upload your site to a server.
FTP Use this setting if you connect to your web server using FTP.
Local/Network Use this setting to access a network folder, or if you are storing files or running your testing server
on your local computer.
RDS (Remote Development Services) Use this setting if you connect to your web server using RDS. For this access
method, your remote folder must be on a computer running Macromedia® ColdFusion® from Adobe®.
Microsoft Visual SourceSafe Use this setting if you connect to your web server using Microsoft Visual SourceSafe.
Support for this method is only available for Windows; to use it, you must have Microsoft Visual SourceSafe Client
version 6 installed.
WebDAV (Web-based Distributed Authoring and Versioning) Use this setting if you connect to your web server
using the WebDAV protocol.
For this access method, you must have a server that supports this protocol, such as Microsoft Internet Information
Server (IIS) 5.0 or an appropriately configured installation of Apache web server.
Note: If you select WebDAV as your access method, and you are using Dreamweaver in a multiuser environment, you
should also make sure that all of your users select WebDAV as the access method. If some users select WebDAV, and other
users select other access methods (FTP, for example), Dreamweaver’s check-in/check-out feature will not work as
expected, since WebDAV uses its own locking system.
See also
“Working on files without defining a site” on page 62
“Get files from a remote server” on page 88
“Use WebDAV to check in and check out files” on page 92
“Access sites, a server, and local drives” on page 83
“Managing files and folders” on page 77
Set options for FTP access
1Select Site > Manage Sites.
2Click New and select Site to set up a new site, or select an existing Dreamweaver site and click Edit.
3Select the Advanced tab and click the Remote Info category.
4Select FTP and enter the host name of the FTP host to which you upload files for your website.
Your FTP host is the full Internet name of a computer system, such as ftp.mindspring.com. Enter the full host name
without any additional text. In particular, don’t add a protocol name in front of the host name.
September 4, 2007
DREAMWEAVER CS3
User Guide
45
Note: If you do not know your FTP host, contact your web hosting company.
5Enter the host directory (folder) at the remote site where you store documents that are visible to the public.
If you’re uncertain about what to enter as the host directory, contact the server’s administrator or leave the text box
blank. On some servers, your root directory is the same as the directory you first connect to with FTP. To find out,
connect to the server. If a folder with a name like public_html, or www, or your login name, appears in the Remote
File view in your Files panel, that’s probably the directory you should enter in the Host Directory text box.
6Enter the login name and password that you use to connect to the FTP server.
7Click Test to test your login name and password.
8Dreamweaver saves your password by default. Deselect the Save option if you prefer that Dreamweaver prompt
you for a password each time you connect to the remote server.
9Select Use Passive FTP if your firewall configuration requires use of passive FTP.
Passive FTP enables your local software to set up the FTP connection rather than requesting the remote server to set
it up. If you’re not sure whether you use passive FTP, check with your system administrator.
For more information, see TechNote 15220 on the Adobe website at www.adobe.com/go/15220.
10 Select Use Extended Data Connection Type (IPv6) if you are using an IPv6-enabled FTP server.
With the deployment of version 6 of the Internet Protocol (IPv6), EPRT and EPSV have replaced the FTP commands
PORT and PASV, respectively. Thus, if you are trying to connect to an IPv6-enabled FTP server, you must use the
extended passive (EPSV) and the extended active (EPRT) commands for your data connection.
For more information, see www.ipv6.org/.
11 Select Use Firewall if you connect to the remote server from behind a firewall.
12 Click Firewall Settings to edit your firewall host or port.
13 Select Maintain Synchronization Information if you want to automatically synchronize your local and remote
files. (This option is selected by default.)
14 Select Automatically Upload Files to Server on Save if you want Dreamweaver to upload your file to your remote
site when you save the file.
15 Select Enable File Check In and Check Out if you want to activate the Check In/Out system.
16 Click OK.
Connect to or disconnect from a remote folder with FTP access
❖In the Files panel:
•To connect, click Connects to Remote Host in the toolbar.
•To disconnect, click Disconnect in the toolbar.
Set options for local or network access
1Select Site > Manage Sites.
2Click New and select Site to set up a new site, or select an existing Dreamweaver site and click Edit.
3Select the Advanced tab, click the Remote Info category, and select Local/Network.
4Click the folder icon beside the Remote Folder text box to browse to and select the folder where you store your
site files.
September 4, 2007
DREAMWEAVER CS3
User Guide
46
5Select Maintain Synchronization Information if you want to automatically synchronize your local and remote
files. (This option is selected by default.)
6Select Automatically Upload Files To Server On Save if you want Dreamweaver to upload your file to your remote
site when you save the file.
7Select Enable File Check In And Check Out if you want to activate the Check In/Out system.
8Click OK.
Set options for WebDAV access
1Select Site > Manage Sites.
2Click New and select Site to set up a new site, or select an existing Dreamweaver site and click Edit.
3Select the Advanced tab, click the Remote Info category, and select WebDAV.
4For the URL, enter the complete URL to the directory on the WebDAV server you want to connect to.
This URL includes the protocol, port, and directory (if not the root directory). For example,
http://webdav.mydomain.net/mysite.
5Enter your user name and password.
ThisinformationisforserverauthenticationandisnotrelatedtoDreamweaver.Ifyouarenotsureofyourusername
and password, check with your system administrator or webmaster.
6Click Test to test your connection settings.
7Click Save if you want Dreamweaver to remember your password each time you start a new session.
8Select Maintain Synchronization Information if you want Dreamweaver to automatically synchronize your local
and remote files. (This option is selected by default.)
9Select Automatically Upload Files To Server On Save if you want Dreamweaver to upload your file to your remote
site when you save the file.
10 Select Enable File Check In And Check Out if you want to activate the Check In/Out system.
Connect to or disconnect from a remote folder with network access
❖You don’t need to connect to the remote folder; you’re always connected. Click the Refresh button to see your
remote files.
Set options for RDS access
1Select Site > Manage Sites.
2Click New and select Site to set up a new site, or select an existing Dreamweaver site and click Edit.
3Select the Advanced tab, click the Remote Info category, and select RDS.
4Click the Settings button and provide the following information in the Configure RDS Server dialog box:
•Enter the name of the host computer where your web server is installed.
The host name is probably an IP address or a URL. If you are unsure, ask your administrator.
•Enter the port number that you connect to.
•Enter your root remote folder as the host directory.
For example, c:\inetpub\wwwroot\myHostDir\.
September 4, 2007
DREAMWEAVER CS3
User Guide
47
•Enter your RDS user name and password.
Note: These options might not appear if you set your user name and password in the ColdFusion Administrator security
settings.
•Select Save if you want Dreamweaver to remember your settings.
5Click OK to close the Configure RDS Server dialog box.
6Select the Automatically Upload Files To Server On Save if you want Dreamweaver to upload your file to your
remote site when you save the file.
7Select Enable File Check In And Check Out if you want to activate the Check In/Out system and click OK.
Set up Microsoft Visual SourceSafe access
1Select Site > Manage Sites.
2Click New and select Site to set up a new site, or select an existing Dreamweaver site and click Edit.
3Select the Advanced tab, click the Remote Info category, and select Microsoft Visual SourceSafe.
4Click the Settings button and provide the following information in the Open Microsoft Visual SourceSafe
Database dialog box:
•For the Database Path, click Browse to browse for the Visual SourceSafe database you want, or enter the full file path.
The file you select becomes the srcsafe.ini file used to initialize Visual SourceSafe.
•For Project, enter the project within the Visual SourceSafe database you want to use as the remote site’s root
directory.
•For Username and Password, enter your login user name and password for the selected database.
If you don’t know your user name and password, check with your system administrator.
•Select the Save option if you want Dreamweaver to remember your settings.
5Click OK to return to the Site Definition dialog box.
6Select Automatically Upload Files To Server On Save if you want Dreamweaver to upload your file to your remote
site when you save the file.
7Deselect Check Out Files When Opening if you do not want Dreamweaver to download your files from the server
automatically when you open the local file.
Troubleshoot the remote folder setup
The following list provides information on common problems you may encounter in setting up a remote folder, and
how to resolve them:
•The Dreamweaver FTP implementation might not work properly with certain proxy servers, multilevel firewalls,
and other forms of indirect server access. If you encounter problems with FTP access, ask your local system
administrator for help.
•For a Dreamweaver FTP implementation, you must connect to the remote system’s root folder. Be sure to indicate
the remote system’s root folder as the host directory. If you’ve specified the host directory using a single slash (/),
you might need to specify a relative path from the directory you are connecting to and the remote root folder. For
example, if the remote root folder is a higher level directory, you may need to specify a ../../ for the host directory.
•
Use underscores in place of spaces, and avoid special characters in file and folder names wherever possible. Colons,
slashes, periods, and apostrophes in file or folder names can prevent Dreamweaver from creating a site map.
September 4, 2007
DREAMWEAVER CS3
User Guide
48
•If you encounter problems with long filenames, rename them with shorter names. On the Mac OS, filenames
cannot be more than 31 characters long.
•Many servers use symbolic links (UNIX), shortcuts (Windows), or aliases (Macintosh) to connect a folder on one
part of the server’s disk with another folder elsewhere. Such aliases usually have no effect on your ability to connect
totheappropriatefolderordirectory;however,ifyoucanconnecttoonepartoftheserverbutnotanother,there
might be an alias discrepancy.
•If you encounter an error message such as “cannot put file,” your remote folder may be out of space. For more
detailed information, look at the FTP log.
Note: In general, when you encounter a problem with an FTP transfer, examine the FTP log by selecting Window >
Results (Windows) or Site > FTP Log (Macintosh), then clicking the FTP Log tag.
Set up a testing server
If you plan to develop dynamic pages, Dreamweaver needs the services of a testing server to generate and display
dynamic content while you work. The testing server can be your local computer, a development server, a staging
server, or a production server.
Before you set up a testing server folder, you must define a local and remote folder. You can often use the settings of
your remote folder for your testing server because dynamic pages placed in the remote folder can normally be
processed by an application server.
1Select one of the following:
•To set up a new site, Select Site > New Site.
•To edit the setup of an existing site on your local disk or a remote site (or a branch of a remote site), whether it was
created in Dreamweaver or not, select Site > Manage Sites, select your site from the list, and click Edit.
Note: If you haven’t defined any Dreamweaver sites, the Site Definition dialog box appears and you don’t need to click New.
2Select Testing Server in the Advanced tab of the Site Definition dialog box.
3Select the server technology you want to use for your web application.
4Accept the default Testing Server settings or enter different settings.
By default, Dreamweaver assumes an application server is running on the same system as your web server. If you
defined a remote folder in the Remote Info category in the Site Definition dialog box, and if an application server
runs on the same system as the remote folder (including your local computer), accept the default settings in the
Testing Server category.
If you did not define a remote folder in the Remote Info category, the Testing Server category defaults to the local
folder you defined in the Local Info category. You can leave this setting alone only if you meet the following
two conditions:
Your web server and application server both run on your local computer. For example, if you’re a ColdFusion
developer running both IIS and ColdFusion on your local Windows XP system.
Your local root folder is a subfolder of your website’s home directory. For example, if you’re using IIS, your local root
folder is a subfolder of the c:\Inetpub\wwwroot\ folder, or the folder itself.
If your local root folder is not a subfolder of your home directory, you must define the local root folder as a virtual
directory in your web server.
September 4, 2007
DREAMWEAVER CS3
User Guide
49
Note: The application server can run on a different system than your remote site. For example, if the Access option you
selected in the Remote Info category is Microsoft Visual SourceSafe, then you must specify a different server in the Testing
Server category.
5In the URL Prefix text box, enter the URL that users type in their browsers to open your web application, but do
not include any filename.
The URL prefix comprises the domain name and any of your website’s home directory’s subdirectories or virtual
directories, but not a filename. For example, if your application’s URL is www.adobe.com/mycoolapp/start.jsp, you
would enter the following URL prefix: www.adobe.com/mycoolapp/.
If Dreamweaver runs on the same system as your web server, you can use one of the localhost options as a placeholder
for your domain name. For example, if you run IIS and your application’s URL is
http://buttercup_pc/mycoolapp/start.jsp, enter the following URL prefix:
http://localhost/mycoolapp/
For a list of localhost options that pertain to different web servers, see the next section.
6Click OK, and then click Done to add the new site to your list of sites.
See also
“Choosing your application server” on page 502
“Preparing to build dynamic sites” on page 491
About the URL prefix for the testing server
You must specify a URL prefix so Dreamweaver can use the services of a testing server to display data and to connect
to databases while you work. Dreamweaver uses the design-time connection to provide you with useful information
about the database, such as the names of the tables in your database and the names of the columns in your tables.
A URL prefix comprises the domain name and any of your website’s home directory’s subdirectories or virtual direc-
tories.
Note: The terminology used in Microsoft IIS may vary from server to server, but the same concepts apply to most web
servers.
The home directory The folder on the server mapped to your site’s domain name. Suppose the folder you want to
use to process dynamic pages is c:\sites\company\, and this folder is your home directory (that is, this folder is
mapped to your site’s domain name—for example, www.mystartup.com). In that case, the URL prefix is
http://www.mystartup.com/.
If the folder you want to use to process dynamic pages is a subfolder of your home directory, simply add the subfolder
to the URL. If your home directory is c:\sites\company\, your site’s domain name is www.mystartup.com, and the
folder you want to use to process dynamic pages is c:\sites\company\inventory. Enter the following URL prefix:
http://www.mystartup.com/inventory/
If the folder you want to use to process dynamic pages is not your home directory or any of its subdirectories, you
must create a virtual directory.
A virtual directory A folder that is not physically contained in the home directory of the server even though it
appears to be in the URL. To create a virtual directory, specify an alias for the folder’s path in the URL. Suppose your
home directory is c:\sites\company, your processing folder is d:\apps\inventory, and you define an alias for this folder
called warehouse. Enter the following URL prefix:
September 4, 2007
DREAMWEAVER CS3
User Guide
50
http://www.mystartup.com/warehouse/
Localhost Refers to the home directory in your URLs when the client (usually a browser, but in this case
Dreamweaver) runs on the same system as your web server. Suppose Dreamweaver is running on the same Windows
system as the web server, your home directory is c:\sites\company, and you defined a virtual directory called
warehouse to refer to the folder you want to use to process dynamic pages. The following are the URL prefixes you
would enter for selected web servers:
Note: By default the ColdFusion MX 7 web server runs on port 8500, the Apache web server runs on port 80, and the
Jakarta Tomcat web server runs on port 8080.
For Macintosh users running the Apache web server, your personal home directory is Users:MyUserName:Sites,
where MyUserName is your Macintosh user name. An alias called ~MyUserName is automatically defined for this
folder when you install Mac OS 10.1 or higher. Therefore, your default URL prefix in Dreamweaver is as follows:
http://localhost/~MyUserName/
If the folder you want to use to process dynamic pages is Users:MyUserName:Sites:inventory, then the URL prefix is
as follows:
http://localhost/~MyUserName/inventory/
Edit an existing remote website in Dreamweaver
You can use Dreamweaver to copy an existing remote site (or any branch of a remote site) to your local disk and edit
it there, even if you didn’t use Dreamweaver to create the original site.
1Create a local folder to contain the existing site and set up the folder as the local folder for the site.
Note: You must locally duplicate the entire structure of the relevant branch of the existing remote site.
2Setuparemotefolder,usingtheremoteaccessinformationabouttheexistingsite.Youmustconnecttotheremote
site to download the files to your computer before you can edit them.
Make sure to choose the correct root folder for the remote site.
3In the Files panel (Window > Files), click the Connects To Remote Host button (for FTP access) or the Refresh
button (for network access) in the toolbar to view the remote site.
4Edit the site:
•Ifyouwanttoworkwiththeentiresite,selecttherootfolderoftheremotesiteintheFilespanel,andclickGetin
the toolbar to download the entire site to your local disk.
•If you want to work with just one of the files or folders of the site, locate the file or folder in the Remote view of
the Files panel, and click Get in the toolbar to download that file to your local disk.
Dreamweaver automatically duplicates as much of the remote site’s structure as is necessary to place the downloaded
file in the correct part of the site hierarchy. When editing only one part of a site, you should generally include
dependent files, such as image files.
Web server URL prefix
ColdFusion MX 7 http://localhost:8500/warehouse/
IIS http://localhost/warehouse/
Apache (Windows) http://localhost:80/warehouse/
Jakarta Tomcat (Windows) http://localhost:8080/warehouse/
September 4, 2007
DREAMWEAVER CS3
User Guide
51
Remove a Dreamweaver site from your list of sites
Removing a Dreamweaver site and all of its setup information from your list of sites does not remove the site files
from your computer.
1Select Site > Manage Sites.
2Select a site name.
3Click Remove, click Yes to remove the site from the list or No to leave the site name, and then click Done.
Import and export site settings
You can export your site settings as an XML file that you can import into Dreamweaver later. This enables you to
move sites between machines and product versions or to share settings with other users.
Export your site settings regularly so that you have a backup copy if anything happens to the site.
Export your sites
1Select Site > Manage sites.
2Select one or more sites whose settings you want to export and click Export:
•To select more than one site, Control-click (Windows) or Command-click (Macintosh) each site.
•To select a range of sites, Shift-click the first and last site in the range.
3For each site whose settings you want to export, browse to a location where you want to save the site and click
Save. (Dreamweaver saves each site’s settings as an XML file, with an .ste file extension.)
4If you want to back up your site settings, select the first option and click OK. Dreamweaver saves remote server
login information, such as the user name and password, as well as local path information.
5If you want to share your settings with other users, select the second option and click OK. (Dreamweaver does not
save information that would not work for other users, such as your remote server login information and local paths.)
6Click Done.
Note: Save the *.ste file to your site root folder or to your desktop to make it easy to find. If you cannot remember where
you put it, do a file search on your computer for files with the *.ste extension to locate it.
Import sites
1Select Site > Manage sites.
2Click Import.
3Browse to and select one or more sites—defined in files with an .ste file extension—whose settings you want to
import.
To select more than one site, Control-click (Windows) or Command-click (Macintosh) each .ste file. To select a
range of sites, Shift-click the first and last file in the range.
4Click Open and then click Done.
After Dreamweaver imports the site settings, the site names appear in the Manage Sites dialog box.
September 4, 2007
DREAMWEAVER CS3
User Guide
52
Working with a visual map of your site
Using site maps
YoucanviewalocalfolderforaDreamweaversiteasavisualmapoflinkedicons,calledasite map.Usethesitemap
to add new files to a Dreamweaver site, or to add, modify, or remove links.
The site map shows the site structure two levels deep, starting from the home page. It shows pages as icons and
displays links in the order in which they are encountered in the source code.
Before you can display the site map, you must define a home page for your site. The site’s home page is the starting
point of the map and can be any page in your site. You can change the home page, the number of columns displayed,
whether the icon labels display the filename or the page title, and whether to show hidden and dependent files. (A
dependent file is an image or other non-HTML content that the browser loads and when it loads the main page.)
When working in the site map, you can select pages, open a page for editing, add new pages to the site, create links
between files, and change page titles.
The site map is ideal for laying out a site structure. You can set up the entire structure of the site, and then create a
graphic image of the site map.
Note: The site map applies to local sites only. To create a map of a remote site, copy the contents of the remote site into a
folder on your local disk, then use the Manage Sites command to define the site as a local site).
See also
“Link documents using the site map” on page 283
“Set up and edit a local root folder” on page 42
Define or change a home page for a site
1In the Files panel (Window > Files), select a site from the pop-up menu where the current site, server, or drive
appears.
2Right-click (Windows) or Control-click (Macintosh) the file you want to be the home page, and then select Set As
Home Page.
Note: You can also set the home page in the Site Map Layout options in the Site Definition dialog box.
3To change the home page, repeat step 2.
View a site map
1In the Files panel (Window > Files), do one of the following:
•In the collapsed Files panel, select Map View from the Site View menu.
September 4, 2007
DREAMWEAVER CS3
User Guide
53
•In the expanded Files panel, click the Site Map button in the toolbar, and then select Map Only (the site map
without the local file structure) or Map And Files (includes the local file structure).
Note: If you have not defined a home page, or if Dreamweaver can’t find an index.html or index.htm page in the current
site to use as the home page, Dreamweaver prompts you to select a home page.
2Click the plus (+) and minus (–) signs next to a filename to show or hide pages linked below the second level:
•Text displayed in red indicates a broken link.
•Text displayed in blue and marked with a globe icon indicates a file on another site or a special link (such as an
e-mail or script link).
•A green check mark indicates a file checked out by you.
•A red check mark indicates a file checked out by someone else.
•A lock icon indicates a file that is read-only (Windows) or locked (Macintosh).
Modify the site map layout
Use the Site Map Layout options to customize the appearance of your site map.
1Open the Site Definition dialog box by doing one of the following:
•Select Site > Manage Sites, choose the site, and click Edit.
•In the Files panel, select Manage Sites from the menu where the current site, server, or drive appears and click Edit.
2In the Site Definitions dialog box, select Site Map Layout from the Category list on the left and set the options:
Number Of Columns Sets the number of pages to display per row in the site map window.
Column Width Sets the width, in pixels, of the site map columns.
Icon Labels Select whether the name displayed with the document icons in the site map is represented as a filename
or as a page title.
Display Files Marked As Hidden Displays HTML files you’ve marked as hidden in the site map.
Display Dependent Files Shows all dependent files in the site hierarchy.
3Click OK and then click Done.
View different branches in the site map
You can view the details of a specific section of a site by making a branch the focus of the site map.
1Select the page you want to view.
2Do one of the following:
•Right-click (Windows) or Control-click (Macintosh) in the site map and select View as Root.
•In the default Files panel (Window > Files), click the options menu in the upper-right corner, then select View >
View Map Options > View As Root.
September 4, 2007
DREAMWEAVER CS3
User Guide
54
The site map is redrawn in the window as if the specified page were at the root of the site. The Site Navigation text
box above the site map displays the path from the home page to the specified page. Select any item in the path to view
the site map from that level by clicking once.
3To expand and contract branches in the site map, click a branch’s plus (+) or minus (–) button.
Select several pages in the site map
•Do one of the following:
•Starting from a blank part of the view, drag around a group of files to select them.
•Control-click (Windows) or Command-click (Macintosh) to select nonadjacent pages.
•Shift-click to select a range of adjacent pages.
Open a page in the site map for editing
❖Double-click the file, or right-click (Windows) or Control-click (Macintosh) the file, and then select Open.
Add an existing file to the site
❖Drag the file from the Windows Explorer or the Macintosh Finder to a file in the site map, or right-click
(Windows) or Control-click (Macintosh) the file in the site map, and then select Link To Existing File and browse to
the file.
Create a new file and add a link in the site map
1
Select a file in the site map, or Right-click (Windows) or Control-click (Macintosh), and then select Link To New File.
2Enter a name, title, and text for the link, and click OK.
Dreamweaver saves the file in the same folder as the selected file. If you add a new file to a hidden branch, the new
file is also hidden.
Modify the title of a page in the site map
1Show page titles by clicking the options menu in the upper-right corner of the collapsed Files panel and selecting
File > Rename View > Show Page Titles.
2Select a file in the site map and do one of the following:
•Click the title and enter a new title.
•Click the options menu in the upper-right corner, then select File > Rename.
3Type the new name and press Enter (Windows) or Return (Macintosh).
Note: When you work in the Files panel, Dreamweaver updates all links to files whose names have changed.
Update the site map display after making changes
❖Click anywhere in the site map to deselect any files and click Refresh in the Files panel toolbar.
Show or hide site map files
You can modify the layout of the site map to show or hide hidden and dependent files. This is useful when you want
to emphasize key topics or content, and de-emphasize less important material.
September 4, 2007
DREAMWEAVER CS3
User Guide
55
To hide a file using the site map, you must mark the file as hidden. When you hide a file, its links are also hidden.
When you display a file marked as hidden, the icon and its links are visible in the site map, but the names appear in
italics.
Note: By default, dependent files are already hidden.
Mark files as hidden in the site map
1In the site map, select one or more files.
2Right-click (Windows) or Control-click (Macintosh), then select Show/Hide Link.
Unmark files marked as hidden in the site map
❖In the site map, select one or more files and do one of the following:
•Right-click (Windows) or Control-click (Macintosh) in the site map, then select Show/Hide Link.
•In the collapsed Files panel (Window > Files), click the options menu in the upper-right corner, then select View >
Site Map Options > Show Files Marked As Hidden.
•In the collapsed Files panel (Window > Files), click the options menu in the upper-right corner, then select View >
Site Map Options > Show/Hide Link.
Show or hide hidden files in the site map
❖In the collapsed (default)Filespanel(Window>Files),clicktheoptionsmenuintheupper-rightcornerandselect
View > Site Map Options > Show Files Marked As Hidden.
Show dependent files in the site map
1In the collapsed (default) Files panel (Window > Files), click the options menu in the upper-right corner.
2Select View > Site Map Options > Show Dependent Files.
Save the site map as an image
You can save the site map as an image and view the image in (or print it from) an image editor.
1In the collapsed (default) Files panel (Window > Files), click the options menu in the upper-right corner, then
select File > Save Site Map.
2Enter a name in the File Name text box.
3In the File Type menu, select .bmp or .png.
4Select a location to save the file, enter a name for the image, and click Save.
Set site map layout preferences
You can customize the appearance of your site map.
1Choose Site > Manage Sites, and click Edit.
September 4, 2007
DREAMWEAVER CS3
User Guide
56
2In the Advanced tab, select the Site Map Layout category.
3IntheHomePagebox,enterafilepathtothehomepageforthesiteorclickthefoldericontobrowsetothefile.
Thehomepagemustbeonthelocalsite.Ifyoudon’tspecifyahomepage,orifDreamweavercannotfindafilecalled
index.html or index.htm at the root, Dreamweaver prompts you to select a home page when you open the site map.
4Select from the Column options:
•In the Number of Columns box, type a number to set the number of pages to display per row in the site map
window.
•In the Column Width box, type a number to set the width, in pixels, of the site map columns.
5Under Icon Labels, select whether the name displayed with the document icons in the site map is represented as
a filename or as a page title.
6Under Options, select which files to display in the site map:
•Select Display Files Marked as Hidden to display HTML files you’ve marked as hidden in the site map.
If a page is hidden, its name and links appear in italics.
•Select Display Dependent Files to show all dependent files in the site’s hierarchy.
A dependent file is an image or other non-HTML content that the browser loads when it loads the main page.
See also
“Working with a visual map of your site” on page 52
Managing Contribute sites with Dreamweaver
Managing Contribute sites
Adobe® Contribute® CS3 combines a web browser with a web-page editor. It enables your colleagues or clients to
browsetoapageinasitethatyoucreated,andtoeditorupdatethepageiftheyhavepermissiontodoso.Contribute
users can add and update basic web content, including formatted text, images, tables, and links. Contribute site
administrators can limit what ordinary (non-administrator) users can do in a site.
Note: This topic assumes that you are a Contribute administrator.
As the site administrator, you give non-administrators the ability to edit pages by creating a connection key and
sending it to them (for information on how to do this, see Contribute Help. You can also set up a connection to a
ContributesiteusingDreamweaver,whichletsyouoryoursitedesignerconnecttotheContributesiteanduseallof
the editing capabilities available in Dreamweaver.
Contribute adds functionality to your website with Contribute Publishing Server (CPS), a suite of publishing appli-
cations and user management tools that lets you integrate Contribute with your organization’s user directory
service—for example, Lightweight Directory Access Protocol (LDAP) or Active Directory. When you enable your
Dreamweaver site as a Contribute site, Dreamweaver reads Contribute’s administration settings whenever you
connect to the remote site. If Dreamweaver detects that CPS is enabled, it inherits some of the functionality of CPS,
such as file rollback and event logging.
September 4, 2007
DREAMWEAVER CS3
User Guide
57
YoucanuseDreamweavertoconnecttoandmodifyafileinaContributesite.MostDreamweavercapabilitieswork
the same way with a Contribute site as they do with any other site. However, when you use Dreamweaver with a
Contribute site, Dreamweaver automatically performs certain file-management operations, such as saving multiple
revisions of a document, and logging certain events in the CPS Console.
For more information, see Contribute Help.
Site structure and page design for a Contribute site
To enable Contribute users to edit your website, keep the following points in mind when you structure it:
•Keep your site structure simple. Don’t nest folders too deeply. Group related items together in a folder.
•Set up appropriate read and write permissions for folders on the server.
•Add index pages to folders as you create them, to encourage Contribute users to place new pages in the correct
folders. For example, if Contribute users provide pages containing meeting minutes, create a folder in the site root
folder named meeting_minutes, and create an index page in that folder. Then provide a link from your site’s main
page to the index page for meeting minutes. A Contribute user can then navigate to that index page and create a
new page of minutes for a specific meeting, linked from that page.
•On each folder’s index page, provide a list of links to the individual content pages and documents in that folder.
•Keep page designs as simple as possible, minimizing fancy formatting.
•Use CSS rather than HTML tags and name your CSS styles clearly. If the Contribute users use a standard set of
stylesinMicrosoftWord,usethesamenamesfortheCSSstyles,sothatContributecanmapthestyleswhenauser
copies information from a Word document and pastes it into a Contribute page.
•To prevent a CSS style from being available to Contribute users, change the name of the style so that the name
starts with mmhide_. For example, if you use a style named RightJustified in a page but you don’t want Contribute
users to be able to use that style, rename the style to mmhide_RightJustified.
Note: You have to add mmhide_ to the style name in Code view; you cannot add it in the CSS panel.
•Use as few CSS styles as possible, to keep things simple and clean.
•If you use server-side includes for HTML page elements, such as headers or footers, create an unlinked HTML
page that contains links to the include files. Contribute users can then bookmark that page and use it to navigate
to the include files and edit them.
See also
“Creating a Dreamweaver template” on page 395
“Creating and managing CSS” on page 124
“Working with server-side includes” on page 340
File transfer to and from a Contribute site
ContributeusesasystemmuchliketheDreamweaverCheckIn/CheckOutsystemtoensurethatonlyoneuserata
time can edit a given web page. When you enable Contribute compatibility in Dreamweaver, the Dreamweaver
Check In/Check Out system is automatically enabled.
To transfer files to and from a Contribute site using Dreamweaver, always use the Check In and Check Out
commands. If you instead use the PUT and GET commands to transfer files, you might overwrite the modifications
that a Contribute user has recently made to a file.
September 4, 2007
DREAMWEAVER CS3
User Guide
58
When you check a file in to a Contribute site, Dreamweaver makes a backup copy of the previous checked-in version
of the file in the _baks folder and adds your user name and a date stamp to a Design Notes file.
See also
“Checking in and checking out files” on page 91
Contribute file and folder permissions on the server
Contribute provides a way to manage file and folder permissions for each user role you define; however, Contribute
doesn’tprovideawaytomanagetheunderlyingreadandwritepermissionsassignedtofilesandfoldersbytheserver.
In Dreamweaver, you can manage those permissions directly on the server.
If a Contribute user doesn’t have read access on the server to a dependent file, such as an image displayed in a page,
the contents of the dependent file don’t appear in the Contribute window. For example, if a user doesn’t have read
access to an images folder, the images in that folder appear as broken image icons in Contribute. Similarly,
Dreamweaver templates are stored in a subfolder of the site’s root folder, so if a Contribute user doesn’t have read
access to the root folder, they can’t use templates in that site unless you copy the templates to an appropriate folder.
When you set up a Dreamweaver site, you must give users read access on the server to the /_mm folder (the _mm
subfolder of the root folder), the /Templates folder, and all of the folders containing assets that they will need to use.
If, for security reasons, you can’t give users read access to the /Templates folder, you can still enable Contribute users
to access templates inign a sroot folder access.
For more information about Contribute permissions, see Administering Contribute in Contribute Help.
Contribute special files
Contribute uses a variety of special files that aren’t intended to be viewed by visitors to your site:
•Thesharedsettingsfile,whichhasanobfuscatedfilenamewithaCSIextension,appearsinafoldernamed_mm
in the root folder of the site, and contains information that Contribute uses to manage the site
•Older versions of files, in folders named _baks
•Temporary versions of pages, so that users can preview changes
•Temporary lock files, indicating that a given page is being edited or previewed
•Design Notes files containing metadata about the site’s pages
In general, you shouldn’t edit any of these Contribute special files using Dreamweaver; Dreamweaver manages them
automatically.
If you don’t want these Contribute special files to appear on your publicly accessible server, you can set up a staging
server where Contribute users work on pages. Then periodically copy those web pages from the staging server to a
production server that’s on the web. If you take this staging-server approach, copy only web pages to the production
server, not any of the above-listed Contribute special files. In particular, don’t copy the _mm and _baks folders to the
production server.
Note: For information about setting up a server to prevent visitors from seeing files in folders that begin with an under-
score, see “Website security” in Contribute Help.
Occasionally you might need to manually delete Contribute special files. For example, there might be circumstances
in which Contribute fails to delete temporary preview pages when the user is finished previewing; in that case, you
wouldhavetomanuallydeletethosetemporarypages.TemporarypreviewpageshavefilenamesthatbeginwithTMP.
September 4, 2007
DREAMWEAVER CS3
User Guide
59
Similarly,undersomecircumstancesanoutdatedlockfilemaybeaccidentallyleftontheserver.Ifthathappens,you
must manually delete the lock file to allow others to edit the page.
Prepare a site for use with Contribute
If you’re preparing an existing Dreamweaver site for Contribute users, you need to explicitly enable Contribute
compatibility to use Contribute-related features; Dreamweaver does not prompt you to do this; however, when you
connect to a site that’s been set up as a Contribute site (that has an administrator), Dreamweaver prompts you to
enable Contribute compatibility.
Note: You must have Contribute installed on the same computer as Dreamweaver and you must be connected to the
remote site before you enable Contribute compatibility. Otherwise, Dreamweaver cannot read Contribute’s adminis-
trative settings to determine whether CPS and Rollback are enabled.
Not all connection types support Contribute compatibility. The following restrictions apply to connection types:
•If your remote site connection uses WebDAV or Microsoft Visual SourceSafe, you can’t enable Contribute compat-
ibility, because those source-control systems aren’t compatible with the Design Notes and Check In/Check Out
systems that Dreamweaver uses for Contribute sites.
•If you use RDS to connect to your remote site, you can enable Contribute compatibility, but you must customize
your connection before you can share it with Contribute users.
•If you’re using your local computer as a web server, you must set up the site using an FTP or network connection
to your computer (rather than just a local folder path) to be able to share your connection with Contribute users.
When you enable Contribute compatibility, Dreamweaver automatically enables Design Notes (including the Upload
Design Notes For Sharing option) and the Check In/Check Out system.
If Contribute Publishing Server (CPS) is enabled on the remote site you are connecting to, Dreamweaver notifies the
CPS every time you trigger a network operation such as checking in, rolling back, or publishing a file. The CPS will
log these events, and you can view the log in the CPS Administration Console. (If you disable CPS, these events are
not logged.)
Note: CPS is enabled using Contribute. For more information, see Administering Contribute in Contribute Help.
1Select Site > Manage Sites.
2Select a site, click Edit, and click the Advanced tab.
3Select the Contribute category from the Category list on the left, select Enable Contribute Compatibility.
4If a dialog box appears saying that you must enable Design Notes and Check In/Check Out, click OK.
5If you haven’t already provided your Check In/Check Out contact information, type your name and e-mail
address in the dialog box, and then click OK. Rollback status, CPS status, the Site Root URL text box, and the Admin-
ister Website button appear in the Site Definition dialog box.
If Rollback is enabled in Contribute, you’ll have the ability to roll back to previous versions of files that you’ve
changed in Dreamweaver.
6Check the URL in the Site Root URL text box and correct it if necessary. Dreamweaver constructs a site root URL
based on other site-definition information you’ve provided, but sometimes the constructed URL isn’t quite right.
7Click the Test button to verify that you’ve entered the correct URL.
Note: If you are ready to send a connection key or perform Contribute site administration tasks now, skip the remaining
steps.
8Click Administer Site in Contribute.
September 4, 2007
DREAMWEAVER CS3
User Guide
60
9Click OK and then click Done.
See also
“Rolling back files (Contribute users)” on page 99
Administer a Contribute site using Dreamweaver
After you enable Contribute compatibility, you can use Dreamweaver to start Contribute to perform site adminis-
tration tasks.
Note: Contribute must be installed on the same computer as Dreamweaver.
As an administrator of a Contribute site, you can:
•Change the administrative settings for the site.
Contribute administrative settings are a collection of settings that apply to all users of your website. These settings
enable you to fine-tune Contribute to provide a better user experience.
•Change the permissions granted to user roles in Contribute.
•Set up Contribute users.
Contributeusersneedcertaininformationaboutthesitetobeabletoconnecttoit.Youcanpackageallofthisinfor-
mation in a file called a connection key to send to Contribute users.
Note: A connection key is not the same as a Dreamweaver exported site file.
Before you give Contribute users the connection information they need to edit pages, use Dreamweaver to create the
basic folder hierarchy for your site, and to create any templates and CSS style sheets needed for the site.
1Select Site > Manage Sites.
2Select a site, click Edit, and click the Advanced tab.
3Select the Contribute category from the category list on the left.
4Click the Administer Site in Contribute button.
Note: This button does not appear if you have not enabled Contribute compatibility.
5If prompted, enter the administrator password, and then click OK.
The Administer Website dialog box appears.
•To change administrative settings, select a category from the list on the left, and then change settings as necessary.
•To change role settings, in the Users and Roles category, click Edit Role Settings, and then make changes as
necessary.
•To send a connection key to set up users, in the Users and Roles category, click Send Connection Key, and then
complete the Connection Wizard.
6Click Close, click OK, and then click Done.
For more information about administrative settings, managing user roles, or creating a connection key, see
Contribute Help.
See also
“Import and export site settings” on page 51
September 4, 2007
DREAMWEAVER CS3
User Guide
61
Delete, move, or rename a remote file in a Contribute site
Deleting a file from the remote server that hosts a Contribute site works much like deleting a file from the server for
any Dreamweaver site. However, when you delete a file from a Contribute site, Dreamweaver asks whether to delete
all older versions of the file. If you choose to keep the older versions, Dreamweaver saves a copy of the current version
in the _baks folder so you can restore it later.
Renaming a remote file or moving it from one folder to another in a Contribute site works the same way it works in
any Dreamweaver site. In a Contribute site, Dreamweaver also renames or moves the associated previous versions of
the file that are saved in the _baks folder.
1Select the file in the Remote pane of the Files panel (Window > Files), and then press Backspace (Windows) or
Delete (Macintosh).
A dialog box appears asking you to confirm that you want to delete the file.
2In the confirmation dialog box:
•To delete all previous versions of the file as well as the current version, select the Delete Rollback Versions option.
•To leave previous versions on the server, deselect the Delete Rollback Versions option.
3Click Yes to delete the file.
Enable Contribute users to access templates without root folder access
In a Contribute site, you manage underlying file and folder permissions directly on the server. If, for security reasons,
you can’t give users read access to the /Templates folder, you can still make the templates available to users.
1Set up the Contribute site so that its root folder is the folder you want users to see as the root.
2Manuallycopythetemplatefolderfromthemainsite’srootfolderintotheContributesite’srootfolder,usingthe
Files panel.
3After you update templates for the main site, recopy the changed templates into appropriate subfolders as needed.
If you take this approach, don’t use site root-relative links in the subfolders. Site root-relative links are relative to the
main root folder on the server, not to the root folder you define in Dreamweaver. Contribute users can’t create site
root-relative links.
If links in a Contribute page appear to be broken, it’s possible that there’s a problem with folder permissions, partic-
ularly if the links link to pages outside of the Contribute user’s root folder. Check read and write permissions for
folders on the server.
See also
“Document locations and paths” on page 279
Troubleshoot a Contribute site
If a remote file in a Contribute site appears to be checked out, but the file isn’t actually locked on the user’s computer,
you can unlock the file to enable users to edit it.
When you click any button related to Contribute site administration, Dreamweaver verifies that it can connect to
your remote site and that the Site Root URL you’ve given for the site is valid. If Dreamweaver can’t connect, or if the
URL isn’t valid, an error message appears.
If the administration tools aren’t working properly, there might be something wrong with the _mm folder.
September 4, 2007
DREAMWEAVER CS3
User Guide
62
Unlock a file in a Contribute site
Note: Before following this procedure, make sure that the file really isn’t checked out. If you unlock a file while a
Contribute user is editing it, multiple users might edit the file simultaneously.
1Do one of the following:
•Open the file in the Document window, and then select Site > Undo Check Out.
•In the Files panel (Window > Files), right-click (Windows) or Control-click (Macintosh), and then select Undo
Check Out.
A dialog box might appear, indicating who has the file checked out and asking you to confirm that you want to
unlock the file.
2If the dialog box appears, click Yes to confirm.
The file is unlocked on the server.
Troubleshoot connection problems for a Contribute site
1Check the Site Root URL in the Contribute category of the Site Definition dialog box by opening that URL in a
browser, to make sure that the correct page opens.
2Use the Test button in the Remote Info category of the Site Definition dialog box to make sure that you can
connect to the site.
3If the URL is correct but the Test button results in an error message, ask your system administrator for help.
Troubleshoot Contribute administration tools
1On the server, make sure that you have read and write permissions, and executable permissions if necessary, for
the _mm folder.
2Make sure that the _mm folder contains a shared settings file with a CSI extension.
3If it doesn’t, use the Connection Wizard (Windows) or Connection Assistant (Macintosh) to create a connection
to the site and to become an administrator for the site. The shared settings file is created automatically when you
become an administrator. For more information about becoming an administrator for an existing Contribute
website, see Administering Contribute in Contribute Help.
Working on files without defining a site
Connect to an FTP server without defining a site
You can connect to an FTP server to work on your documents without creating a Dreamweaver site. If you work on
files without creating a Dreamweaver site, you will not be able to perform sitewide operations, such as link checking.
1Select Site > Manage Sites.
2Click New and select FTP & RDS Servers.
3Enter a name for the server connection in the Name box. This is the name that will appear in the pop-up menu at
the top of the Files panel.
4Select FTP from the Access Type menu.
5Enter the host name of the FTP host to which you upload files for your website.
September 4, 2007
DREAMWEAVER CS3
User Guide
63
Your FTP host is the full Internet name of a computer system, such as ftp.mindspring.com. Enter the full host name
without any additional text. In particular, don’t add a protocol name in front of the host name.
Note: If you do not know your FTP host, contact your ISP.
6Enter the host directory of the remote site where you store documents that are visible to the public.
7Enter the login name and password that you use to connect to the FTP server, then click Test to test your login
name and password.
8Select Save if you want Dreamweaver to save your password. (If you do not select this option, Dreamweaver
prompts you for a password each time you connect to the remote server.)
9Select Use Passive FTP if your firewall configuration requires use of passive FTP.
Passive FTP enables your local software to set up the FTP connection rather than requesting the remote server to set
it up. If you’re not sure whether you use passive FTP, check with your system administrator.
10 Select Use Firewall if you connect to the remote server from behind a firewall, then click Firewall Settings to edit
your firewall host or port.
11 Select Use Secure FTP (SFTP) for secure FTP authentication and click OK.
SFTP uses encryption and public keys to secure a connection to your testing server.
Note: Your server must be running an SFTP server.
12 ClickOK.TheFilespaneldisplaysthecontentsoftheremoteserverfolderyouconnectedto,andtheservername
appears in the pop-up menu at the top of the panel.
See also
“Set up a remote folder” on page 43
Connect to an RDS server without defining a site
You can connect to an RDS server to work on your documents without creating a Dreamweaver site. If you work on
files without creating a Dreamweaver site, you will not be able to perform sitewide operations, such as link checking.
1Select Site > Manage Sites.
2Click New and select FTP & RDS Servers.
3EnteranamefortheserverintheDescriptiontextfield.Thisisthenamethatwillappearinthemenuatthetop
of the Files panel.
4Select RDS from the Access Type menu.
5Enter the URL that users type in their browsers to open your web application, but do not include any filename.
Suppose your application’s URL is www.macromedia.com/mycoolapp/start.jsp. In this case, you would enter the
following URL prefix: www.adobe.com/mycoolapp/.
6Click the Settings button to complete the access information.
7Complete the Configure RDS Server dialog box and click OK.
See also
“Set up a remote folder” on page 43
September 4, 2007
DREAMWEAVER CS3
User Guide
64
Basic tab options
Set Basic tab Editing Files options
The Site Definition wizard has three sections to help you set up a Dreamweaver site: Editing Files, Testing Files, and
Sharing Files. Each section might have multiple screens depending on the settings you select. At the top of the dialog
box, the bold section name indicates where you are in the setup process. You might not need to set up folders in all
three sections; the questions that appear in the tab help you determine your needs.
The purpose of this dialog box is to name your Dreamweaver site and specify its URL.
See also
“About Dreamweaver sites” on page 40
Name your Dreamweaver site
❖Enter a name for your Dreamweaver site.
Specify the URL of your site
❖Enter the URL (HTTP address) of your Dreamweaver site.
Dreamweaver uses this address to make sure site root-relative links work on the remote server, which may have a
different folder as the site root. For example, if you are linking to an image file on your hard disk in the
C:\Sales\images\ folder (where Sales is your local root folder), and the URL of your completed site is
http://www.mysite.com/SalesApp/ (where SalesApp is your remote root folder), you should enter the URL in the
HTTP Address text box to ensure that the path to the linked image on the remote server is /SalesApp/images/.
Set Basic tab Editing Files Part 2 options
The purpose of this dialog box is to indicate whether you are building a web application. A web application is a
collection of web pages that interact with the user, with each other, and with various resources on a web server,
including databases.
If you are building a web application, you need to select the server technology running on your web server.
1Select No if you do not plan to use a server technology to create a web application, or select Yes if you plan to use
a server technology to create a web application.
2If you select Yes, select a server technology.
You can use Dreamweaver to build web applications using five server technologies: ColdFusion, ASP.NET, ASP, JSP,
or PHP. Each of these technologies corresponds to a document type in Dreamweaver. Choosing one for your web
application depends on several factors, including your level of comfort with various scripting languages and the
application server you plan to use.
See also
“Choosing your application server” on page 502
Set Basic tab Editing Files Part 3 options
The purpose of this dialog box is to select your development environment.
1Select the method you will use to work on files during development.
September 4, 2007
DREAMWEAVER CS3
User Guide
65
2Enter a location to store your files or click the folder icon to browse to the folder.
This is your working directory for your Dreamweaver site—it is the place where you store your “in progress” files for
a Dreamweaver site. In the Dreamweaver Files panel, this folder is referred to as your local site.
See also
“Understanding local and remote folder structure” on page 41
Set Basic tab Testing Files options (URL prefix)
This dialog box appears if you selected a server technology earlier in the process. Its purpose is to specify a URL
prefix so Dreamweaver can use your testing server to display data and connect to databases while you work. A URL
prefix comprises the domain name and any of your website’s home directory’s subdirectories or virtual directories.
1Enter the URL that users type in their browsers to open your web application, but do not include any filename.
Suppose your application’s URL is www.adobe.com/mycoolapp/start.jsp. In this case, you would enter the following
URL prefix: www.adobe.com/mycoolapp/.
If Dreamweaver runs on the same computer as your web server, you can use the term localhost as a stand-in for your
domain name. For example, suppose your application’s URL is buttercup_pc/mycoolapp/start.jsp. Then, you can
enter the following URL prefix: http://localhost/mycoolapp/.
2Click Test URL to ensure that your URL works.
See also
“Set up a testing server” on page 48
“About the URL prefix for the testing server” on page 49
Set Basic tab Testing Files options (remote access)
The purpose of this dialog box is to select an access method for Dreamweaver to access your testing server.
Dreamweaver works with a testing server to generate and display dynamic content while you work. The testing server
can be your local computer, a development server, a staging server, or a production server. As long as the server can
process the kind of dynamic pages you plan to develop, the choice doesn’t matter.
❖Select an access method from the pop-up menu and fill out the appropriate text boxes.
None Keep this default setting if you do not plan to upload your site to a server.
FTP Use this setting if you connect to your web server using FTP.
Local/Network Use this setting to access a network folder, or if you are storing files or running your testing server
on your local computer.
RDS (Remote Development Services) Use this setting if you connect to your web server using RDS. For this access
method, your remote folder must be on a computer running ColdFusion.
Microsoft Visual SourceSafe Use if you connect to your web server using Microsoft Visual SourceSafe. Support for
this method is only available for Windows; to use it, you must have Microsoft Visual SourceSafe Client version 6
installed.
WebDAV (Web-based Distributed Authoring and Versioning) Use if you connect to your web server using the
WebDAV proto col.
September 4, 2007
DREAMWEAVER CS3
User Guide
66
For this access method, you must have a server that supports this protocol, such as Microsoft Internet Information
Server (IIS) 5.0 or an appropriately configured installation of Apache web server.
See also
“Set up a remote folder” on page 43
Set Basic tab remote folder setup options
The purpose of this dialog box is to decide whether to set up a remote server folder.
Depending on your environment, this folder is where you store files for testing, collaboration, production,
deployment, or a number of other scenarios. Typically, your remote folder is on the machine where your web server
is running.
In the Dreamweaver Files panel, this folder is referred to as your remote site. The remote folder enables you to
transfer files between your local disk and web server; this makes it easy for you to share and manage files in your
Dreamweaver sites.
❖To choose whether to set up a remote folder, select Yes to set up a remote folder, or No to skip the remote folder
setup.
See also
“Understanding local and remote folder structure” on page 41
Set Basic tab Sharing Files options (remote access)
The purpose of this dialog box is to select an access method for Dreamweaver to access your testing server.
Dreamweaver works with a testing server to generate and display dynamic content while you work. The testing server
can be your local computer, a development server, a staging server, or a production server. As long as the server can
process the kind of dynamic pages you plan to develop, the choice doesn’t matter.
❖Select an access method from the pop-up menu and fill out the appropriate text boxes.
None Keep this default setting if you do not plan to upload your site to a server.
FTP Use this setting if you connect to your web server using FTP.
Local/Network Use this setting to access a network folder, or if you are storing files or running your testing server
on your local computer.
RDS (Remote Development Services) Use if you connect to your web server using RDS. For this access method, your
remote folder must be on a computer running ColdFusion.
Microsoft Visual SourceSafe Use if you connect to your web server using Microsoft Visual SourceSafe. Support for
this method is only available for Windows; to use it, you must have Microsoft Visual SourceSafe Client version 6
installed.
WebDAV (Web-based Distributed Authoring and Versioning) Use if you connect to your web server using the
WebDAV proto col.
For this access method, you must have a server that supports this protocol, such as Microsoft Internet Information
Server (IIS) 5.0 or an appropriately configured installation of Apache web server.
September 4, 2007
DREAMWEAVER CS3
User Guide
67
See also
“Set up a remote folder” on page 43
Set Basic tab Sharing Files options (check in/check out)
The purpose of this dialog box is to set up the file Check In/Check Out system, if you’re working in a collaborative
environment (or working alone, but on multiple machines).
Checking out a file makes the file unavailable on the server so that other team members cannot edit the file using
Dreamweaver. Checking in a file makes the file available to others to check out and edit.
1Select Yes to enable file check in/check out if you are working in a team environment (or working alone but from
several different machines), or select No to disable file check in/check out.
This option is useful to let others know that you checked out a file for editing, or to alert yourself that you may have
left a more recent version of a file on another machine.
2
Select Dreamweaver Should Check It Out if you want to automatically check out files when you open them from
the Files panel, or select the alternative option if you do not want to automatically check out files when you open them.
Note: Using File > Open to open a file doesn’t check the file out even when this option is selected.
3Enter your name.
YournameappearsintheFilespanelalongsideanyfilesthatyoucheckedout;thisenablesteammemberstocommu-
nicate when they are sharing files.
If you work alone from several different machines, use a different check-out name on each machine (for example,
AmyR-HomeMac and AmyR-OfficePC) so you’ll know where the latest version of the file is if you forget to check it in.
4Enter your e-mail address.
If you enter an e-mail address, then when you check out a file, your name appears in the Files panel next to that file
as a link (blue and underlined). If a team member clicks the link, their default e-mail program opens a new message
with your e-mail address and a subject that corresponds to the file and site name.
See also
“Checking in and checking out files” on page 91
Basic tab Summary options
This page displays the settings you selected for your site.
To finish setting up your site, do one of the following:
•Click the Back button to return to a previous page to change a setting.
•Click the Done button if you are satisfied with the settings and want Dreamweaver to create the site.
When you click Done, Dreamweaver creates the site and displays it in the Files panel.
•Click the Cancel button if you do not want Dreamweaver to create the site.
September 4, 2007
68
Chapter 4: Creating and managing files
In addition to creating web pages, you can easily organize all of the files and assets that belong to your website. You
can create, manage, and synchronize files, check files in and out, and test how your site will work in different
browsers.
Creating and opening documents
About creating Dreamweaver documents
Dreamweaver offers a flexible environment for working with a variety of web documents. In addition to HTML
documents, you can create and open a variety of text-based documents, including ColdFusion Markup Language
(CFML), ASP, JavaScript, and Cascading Style Sheets (CSS). Source code files, such as Visual Basic, .NET, C#, and
Java, are also supported.
Dreamweaver provides several options for creating a new document. You can create any of the following:
•A new blank document or template
•A document based on one of the predesigned page layouts that comes with Dreamweaver, including over 30 CSS-
based page layouts
•A document based on one of your existing templates
You can also set document preferences. For example, if you typically work with one type of document, you can set it
as the default document type for new pages you create.
You can easily define document properties, such as meta tags, document title, and background colors, and several
other page properties in either Design view or Code view.
Dreamweaver file types
YoucanworkwithavarietyoffiletypesinDreamweaver.TheprimarykindoffileyouwillworkwithistheHTML
file. HTML files—or Hypertext Markup Language files—contain the tag-based language responsible for displaying
a web page in a browser. You can save HTML files with either the .html or .htm extension. Dreamweaver saves files
using the .html extension by default.
Following are some of the other common file types you might use when working in Dreamweaver:
CSS Cascading Style Sheet files have a .css extension. They are used to format HTML content and control the
positioning of various page elements.
GIF Graphics Interchange Format files have a .gif extension. GIF format is a popular web graphic format for
cartoons, logos, graphics with transparent areas, and animations. GIFs contain a maximum of 256 colors.
JPEG Joint Photographic Experts Group files (named after the organization that created the format) have a .jpg
extension, and are usually photographs or high-color images. The JPEG format is best for digital or scanned photo-
graphs, images using textures, images with gradient color transitions, and any images that require more than 256
colors.
XML Extensible Markup Language files have a .xml extension. They contain data in a raw form that can be formatted
using XSL (Extensible Stylesheet Language).
September 4, 2007
DREAMWEAVER CS3
User Guide
69
XSL Extensible Stylesheet Language files have a .xsl or .xslt extension. They are used to style XML data that you want
to display on a web page.
CFML ColdFusion Markup Language files have a .cfm extension. They are used to process dynamic pages.
ASPX ASP.NET files have a .aspx extension and are used to process dynamic pages.
PHP Hypertext Preprocessor files have a .php extension and are used to process dynamic pages.
See also
“Displaying XML data” on page 420
“Building applications visually” on page 614
“Understanding Cascading Style Sheets” on page 120
Create a blank page
You can create a page that contains a predesigned CSS layout, or create a completely blank page and then create a
layout of your own.
1Select File > New.
2In the Blank Page category of the New Document dialog box, select the kind of page you want to create from the
Page Type column. For example, select HTML to create a plain HTML page, select ColdFusion to create a
ColdFusion page, and so on.
3If you want your new page to contain a CSS layout, select a predesigned CSS layout from the Layout column;
otherwise, select None. Based on your selection, a preview and description of the selected layout appears on the right
side of the dialog box.
The predesigned CSS layouts provide the following types of columns:
Fixed Column width is specified in pixels. The column does not resize based on the size of the browser or the site
visitor’s text settings.
Elastic Column width is specified in a unit of measurement (ems) relative to the size of the text. The design adapts
if the site visitor changes the text settings, but does not change based on the size of the browser window.
Liquid Column width is specified as a percentage of the site visitor’s browser width. The design adapts if the site
visitor makes the browser wider or narrower, but does not change based on the site visitor’s text settings.
Hybrid Columns are a combination of any of the previous three options. For example, in the two-column hybrid,
therightsidebarlayouthasaliquidmaincolumnthatscalestothesizeofthebrowser,andanelasticcolumnonthe
right that scales to the size of the site visitor’s text settings.
4Select a document type from the DocType pop-up menu. In most cases, you can use the default selection, XHTML
1.0 Transitional.
Selecting one of the XHTML document type definitions from the DocType (DTD) menu makes your page XHTML-
compliant. For example, you can make an HTML document XHTML-compliant by selecting XHTML 1.0 Transi-
tional or XHTML 1.0 Strict from the menu. XHTML (Extensible Hypertext Markup Language) is a reformulation of
HTML as an XML application. Generally, using XHTML gives you the benefits of XML, while ensuring the backward
and future compatibility of your web documents.
September 4, 2007
DREAMWEAVER CS3
User Guide
70
Note: For more information about XHTML, see the World Wide Web Consortium (W3C) website, which contains the
specification for XHTML 1.1 - Module-Based XHTML (www.w3.org/TR/xhtml11/) and XHTML 1.0
(www.w3c.org/TR/xhtml1/), as well as XHTML validator sites for web-based files (http://validator.w3.org/) and local
files (http://validator.w3.org/file-upload.html).
5If you selected a CSS layout in the Layout column, select a location for the layout’s CSS from the Layout CSS pop-
up menu.
Add To Head Adds CSS for the layout to the head of the page you’re creating.
Create New File Adds CSS for the layout to a new external CSS file and attaches the new style sheet to the page you’re
creating.
Link To Existing File Lets you specify an existing CSS file that already contains the CSS rules needed for the layout.
To do this, click the Attach Style Sheet icon above the Attach CSS file pane and select an existing CSS style sheet. This
option is particularly useful when you want to use the same CSS layout (the CSS rules for which are contained in a
single file) across multiple documents.
6(Optional) You can also attach CSS style sheets to your new page (unrelated to the CSS layout) when you create
the page. To do this, click the Attach Style Sheet icon above the Attach CSS file pane and select a CSS style sheet.
7Click Preferences if you want to set default document preferences, such as a document type, encoding, and a file
extension.
8Click Get More Content if you want to open Dreamweaver Exchange where you can download more page design
content.
9Click the Create button.
10 Save the new document (File > Save).
11 In the dialog box that appears, navigate to the folder where you want to save the file.
It’s a good idea to save your file in a Dreamweaver site.
12 In the File Name box, type a name for the file.
Avoid using spaces and special characters in file and folder names, and do not begin a filename with a numeral. In
particular, do not use special characters (such as é, ç, or ¥) or punctuation marks (such as colons, slashes, or periods)
in the names of files you intend to put on a remote server; many servers change these characters during upload,
which will cause any links to the files to break.
See also
“About the XHTML code generated by Dreamweaver” on page 302
“Laying out pages with CSS” on page 145
“Set default document type and encoding” on page 74
Create a blank template
You can use the New Document dialog box to create Dreamweaver templates. By default, templates are saved in the
Templates folder of your site.
1Select File > New.
2In the New Document dialog box, select the Blank Template category.
September 4, 2007
DREAMWEAVER CS3
User Guide
71
3Select the kind of page you want to create from the Page Type column. For example, select HTML template to
create a plain HTML template, select ColdFusion to create a ColdFusion template, and so on.
4If you want your new page to contain a CSS layout, select a predesigned CSS layout from the Layout column;
otherwise, select None. Based on your selection, a preview and description of the selected layout appears on the right
side of the dialog box.
The predesigned CSS layouts provide the following types of columns:
Fixed Column width is specified in pixels. The column does not resize based on the size of the browser or the site
visitor’s text settings.
Elastic Column width is specified in a unit of measurement (ems) relative to the size of the text. The design adapts
if the site visitor changes the text settings, but does not change based on the size of the browser window.
Liquid Column width is specified as a percentage of the site visitor’s browser width. The design adapts if the site
visitor makes the browser wider or narrower, but does not change based on the site visitor’s text settings.
Hybrid Columns are a combination of any of the previous three options. For example, in the two-column hybrid,
therightsidebarlayouthasamaincolumnthatscalestothesizeofthebrowser,andanelasticcolumnontheright
that scales to the size of the site visitor’s text settings.
5Select a document type from the DocType pop-up menu. In most cases, you will want to leave this selected to the
default selection, XHTML 1.0 Transitional.
Selecting one of the XHTML document type definitions from the DocType (DTD) menu makes your page XHTML-
compliant. For example, you can make an HTML document XHTML-compliant by selecting XHTML 1.0 Transi-
tional or XHTML 1.0 Strict from the menu. XHTML (Extensible Hypertext Markup Language) is a reformulation of
HTML as an XML application. Generally, using XHTML gives you the benefits of XML, while ensuring the backward
and future compatibility of your web documents.
Note: For more information about XHTML, see the World Wide Web Consortium (W3C) website, which contains the
specification for XHTML 1.1 - Module-Based XHTML (www.w3.org/TR/xhtml11/) and XHTML 1.0
(www.w3c.org/TR/xhtml1/), as well as XHTML validator sites for web-based files (http://validator.w3.org/) and local
files (http://validator.w3.org/file-upload.html).
6If you selected a CSS layout in the Layout column, select a location for the layout’s CSS from the Layout CSS pop-
up menu.
Add to Head Adds CSS for the layout to the head of the page you’re creating.
Create New File Adds CSS for the layout to a new external CSS styles sheet and attaches the new style sheet to the
page you’re creating.
Link To Existing File Lets you specify an existing CSS file that already contains the CSS rules needed for the layout.
To do this, click the Attach Style Sheet icon above the Attach CSS file pane and select an existing CSS style sheet. This
option is particularly useful when you want to use the same CSS layout (the CSS rules for which are contained in a
single file) across multiple documents.
7(Optional) You can also attach CSS style sheets to your new page (unrelated to the CSS layout) when you create
the page. To do this, click the Attach Style Sheet icon above the Attach CSS file pane and select a CSS style sheet.
8Click Preferences if you want to set default document preferences, such as a document type, encoding, and a file
extension.
9Click Get More Content if you want to open Dreamweaver Exchange where you can download more page design
content.
10 Click the Create button.
September 4, 2007
DREAMWEAVER CS3
User Guide
72
11 Save the new document (File > Save). If you haven’t added editable regions to the template yet, a dialog box
appears telling you that there are no editable regions in the document. Click OK to close the dialog box.
12 In the Save As Template dialog box, select a site in which to save the template, and add a description for the
template in the Description box.
13 IntheFileNamebox,typeanameforthenewtemplate.Youdonotneedtoappendafileextensiontothename
of the template. When you click Save, the .dwt extension is appended to the new template, which is saved in the
Templates folder of your site.
Avoid using spaces and special characters in file and folder names and do not begin a filename with a numeral. In
particular, do not use special characters (such as é, ç, or ¥) or punctuation (such as colons, slashes, or periods) in the
names of files you intend to put on a remote server; many servers change these characters during upload, which will
cause any links to the files to break.
See also
“About the XHTML code generated by Dreamweaver” on page 302
“Laying out pages with CSS” on page 145
“Creating and managing templates” on page 387
“Setting up a Dreamweaver site” on page 40
“Set default document type and encoding” on page 74
Create a page based on an existing template
You can select, preview, and create a new document from an existing template. You can either use the New Document
dialog box to select a template from any of your Dreamweaver-defined sites or use the Assets panel to create a new
document from an existing template.
See also
“Creating and managing templates” on page 387
“Setting up a Dreamweaver site” on page 40
“Set default document type and encoding” on page 74
Create a document based on a template
1Select File > New.
2In the New Document dialog box, select the Page From Template category.
3In the Site column, select the Dreamweaver site that contains the template you want use, and then select a template
from the list on the right.
4DeselectUpdatePageWhenTemplateChangesifyoudon’twanttoupdatethispageeachtimeyoumakechanges
to the template on which this page is based.
5Click Preferences if you want to set default document preferences, such as a document type, encoding, and a file
extension.
6Click Get More Content if you want to open Dreamweaver Exchange where you can download more page design
content.
September 4, 2007
DREAMWEAVER CS3
User Guide
73
7Click Create and save the document (File > Save).
Create a document from a template in the Assets panel
1Open the Assets panel (Window > Assets), if it is not already open.
2In the Assets panel, click the Templates icon on the left to view the list of templates in your current site.
If you just created the template you want to apply, you might need to click the Refresh button to see it.
3Right-click (Windows) or Control-click (Macintosh) the template you want to apply, then select New From
Template.
The document opens in the Document window.
4Save the document.
Create a page based on a Dreamweaver sample file
Dreamweaver comes with several professionally developed page layout and design element files. You can use these
sample files as starting points for designing pages in your sites. When you create a document based on a sample file,
Dreamweaver creates a copy of the file.
You can preview a sample file and read a brief description of a document’s design elements in the New Document
dialog box. In the case of CSS style sheets, you can copy a predesigned style sheet and apply it to your documents.
Note: If you create a document based on a predefined frameset, only the frameset structure is copied, not the frame
contents; additionally, you must save each frame file separately.
1Select File > New.
2In the New Document dialog box, select the Page From Sample category.
3In the Sample Folder column, select CSS Style Sheet, Frameset, Starter Page (Theme) or Starter Page (Basic); then
select a sample file from the list on the right.
4Click the Create button.
The new document opens in the Document window (Design view). If you selected CSS Style Sheet, the CSS style
sheet opens in Code view.
5Save the document (File > Save).
6If the Copy Dependent Files dialog box appears, set the options, and then click Copy to copy the assets to the
selected folder.
You can choose your own location for the dependent files or use the default folder location Dreamweaver generates
(based on the sample file’s source name).
See also
“Understanding Cascading Style Sheets” on page 120
“Save frame and frameset files” on page 208
September 4, 2007
DREAMWEAVER CS3
User Guide
74
Create other kinds of pages
The Other category of the New Document dialog box lets you create various types of pages that you might want to
use in Dreamweaver, including C#, VBScript, and text-only pages.
1Select File > New.
2In the New Document dialog box, select the Other category.
3Select the kind of document you want to create from the Page Type column and click the Create button.
4Save the document (File > Save).
Set default document type and encoding
You can define which document type is used as a default document for a site.
For example, if most pages in your site are of a specific file type (such as Cold Fusion, HTML, or ASP documents),
you can set document preferences that automatically create new documents of the specified file type.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
You can also click the Preferences button in the New Document dialog box to set new document preferences when
you create a new document.
2Click New Document from the category list on the left.
3Set or change preferences as necessary, and click OK to save them.
Default Document Select a document type that will be used for pages that you create.
Default Extension Specify the file extension you prefer (.htm or .html) for new HTML pages you create.
Note: This option is disabled for other file types.
Default Document Type (DDT) Select one of the XHTML document type definitions (DTD) to make new pages
XHTML-compliant. For example, you can make an HTML document XHTML-compliant by selecting XHTML 1.0
Transitional or XHTML 1.0 Strict from the menu.
Default Encoding Specifytheencodingtobeusedwhenanewpageiscreated,aswellaswhenadocumentisopened
that does not specify any encoding.
If you select Unicode (UTF-8) as the document encoding, entity encoding is not necessary because UTF-8 can safely
represent all characters. If you select another document encoding, entity encoding may be necessary to represent
certain characters. For more information on character entities, see www.w3.org/TR/REC-
html40/sgml/entities.html.
If you select Unicode (UTF-8) as a default encoding, you can include a Byte Order Mark (BOM) in the document by
selecting the Include Unicode Signature (BOM) option.
A BOM is 2-4 bytes at the beginning of a text file that identifies a file as Unicode, as well as the byte order of the
following bytes. Because UTF-8 has no byte order, adding a UTF-8 BOM is optional. For UTF-16 and UTF-32, it is
required.
Unicode Normalization Form Select one of these options if you select Unicode (UTF-8) as a default encoding.
There are four Unicode Normalization Forms. The most important is Normalization Form C because it's the most
common one used in the Character Model for the World Wide Web. Adobe provides the other three Unicode
Normalization Forms for completeness.
September 4, 2007
DREAMWEAVER CS3
User Guide
75
Show New Document Dialog Box on Control+N Deselect this option (“on Command+N” for Macintosh) to automat-
ically create a document of the default document type when you use the key command.
In Unicode, there are characters that are visually similar but can be stored within the document in different ways.
For example, “ë” (e-umlaut) can be represented as a single character, “e-umlaut,” or as two characters, “regular Latin
e” + “combining umlaut.” A Unicode combining character is one that gets used with the previous character, so the
umlaut would appear above the “Latin e.” Both forms result in the same visual typography, but what is saved in the
file is different for each form.
Normalization is the process of making sure all characters that can be saved in different forms are all saved using the
same form. That is, all “ë” characters in a document are saved as single “e-umlaut” or as “e” + “combining umlaut,”
and not as both forms in one document.
For more information on Unicode Normalization and the specific forms that can be used, see the Unicode website
at www.unicode.org/reports/tr15.
See also
“About the XHTML code generated by Dreamweaver” on page 302
“Understanding document encoding” on page 216
Set the default file extension of new HTML documents
You can define the default file extension of HTML documents created in Dreamweaver. For example, you can use an
.htm or .html extension for all new HTML documents.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
You can also click the Preferences button in the New Document dialog box to set new document preferences when
you create a new document.
2Click New Document from the category list on the left.
3In the Default Document Type, make sure that HTML is selected.
4In the Default Extension box, specify the file extension you want for new HTML documents created in
Dreamweaver.
For Windows, you can specify the following extensions: .html, .htm, .shtml, .shtm, .stm, .tpl, .lasso, .xhtml.
For Macintosh, you can specify the following extensions: .html, .htm, .shtml, .shtm, .tpl, .lasso, .xhtml, .ssi.
Open and edit existing documents
You can open an existing web page or text-based document, whether or not it was created in Dreamweaver, and edit
it in either Design view or Code view.
If the document you open is a Microsoft Word file that was saved as an HTML document, you can use the Cleanup
Word HTML command to remove the extraneous markup tags that Word inserts into HTML files.
To clean up HTML or XHTML that was not generated by Microsoft Word, use the Cleanup HTML command.
You can also open non-HTML text files, such as JavaScript files, XML files, CSS style sheets, or text files saved by
word processors or text editors.
1Select File > Open.
September 4, 2007
DREAMWEAVER CS3
User Guide
76
You can also use the Files panel to open files.
2Navigate to and select the file you want to open.
Note: Ifyouhaven’talreadydoneso,it’sagoodideatoorganizefilesyouplantoopenandeditinaDreamweaversite,
instead of opening them from another location.
3Click Open.
The document opens in the Document window. JavaScript, text, and CSS Style Sheets open in Code view by default.
You can update the document while working in Dreamweaver, and save the changes in the file.
See also
“Clean up code” on page 326
“Start an external editor for media files” on page 271
“Work with files in the Files panel” on page 80
“Set up and edit a local root folder” on page 42
Clean up Microsoft Word HTML files
You can open documents saved by Microsoft Word as HTML files, and then use the Clean Up Word HTML
command to remove the extraneous HTML code generated by Word. The Clean Up Word HTML command is
available for documents saved as HTML files by Word 97 or later.
ThecodethatDreamweaverremovesisprimarilyusedbyWordtoformatanddisplaydocumentsinWordandisnot
needed to display the HTML file. Retain a copy of your original Word (.doc) file as a backup, because you may not
be able to reopen the HTML document in Word once you’ve applied the Clean Up Word HTML feature.
To clean up HTML or XHTML that was not generated by Microsoft Word, use the Cleanup HTML command.
1Save your Microsoft Word document as an HTML file.
Note: In Windows, close the file in Word to avoid a sharing violation.
2Open the HTML file in Dreamweaver.
To view the HTML code generated by Word, switch to Code view (View > Code).
3Select Commands > Clean Up Word HTML.
Note: If Dreamweaver is unable to determine which version of Word was used to save the file, select the correct version
from the pop-up menu.
4Select (or deselect) options for the cleanup. The preferences you enter are saved as default cleanup settings.
Dreamweaver applies the cleanup settings to the HTML document and a log of the changes appears (unless you
deselected that option in the dialog box).
Remove All Word Specific Markup Removes all Microsoft Word-specific HTML, including XML from HTMLtags,
Word custom meta data and link tags in the head of the document, Word XML markup, conditional tags and their
contents,andemptyparagraphsandmarginsfromstyles.Youcanselecteachoftheseoptionsindividuallyusingthe
Detailed tab.
September 4, 2007
DREAMWEAVER CS3
User Guide
77
Clean Up CSS
Removes all Word-specific CSS, including inline CSS styles when possible (where the parent style has
the same style properties), style attributes beginning with “mso,” non-CSS style declarations, CSS style attributes from
tables, and all unused style definitions from the head. You can further customize this option using the Detailed tab.
Clean Up <font> Tags Removes HTML tags, converting the default body text to size 2 HTML text.
Fix Invalidly Nested Tags Removes the font markup tags inserted by Word outside the paragraph and heading
(block-level) tags.
Set Background Color Allows you to enter a hexadecimal value to set the background color of your document. If you
do not set a background color, your Word HTML page will have a gray background. The default hexadecimal value
is white.
Apply Source Formatting Applies the source formatting options you specify in HTML Format preferences and
SourceFormat.txt to the document.
Show Log On Completion Displaysanalertboxwithdetailsaboutthechangesmadetothedocumentassoonasthe
cleanup is finished.
5Click OK, or click the Detailed tab if you want to further customize the Remove All Word Specific Markup and
Clean Up CSS options, and then click OK.
See also
“Clean up code” on page 326
“Import Microsoft Office documents (Windows only)” on page 234
Managing files and folders
About managing files and folders
DreamweaverincludesaFilespanelthathelpsyoumanageandtransferfilestoandfromaremoteserver.Whenyou
transfer files between local and remote sites, parallel file and folder structures between the sites are maintained.
When transferring files between sites, Dreamweaver creates corresponding folders if they do not yet exist in a site.
You can also synchronize the files between your local and remote sites; Dreamweaver copies files in both directions
as necessary and removes unwanted files when appropriate.
Using the Files panel
The Files panel enables you to view files and folders, whether they are associated with a Dreamweaver site or not,
and perform standard file maintenance operations, such as opening and moving files.
Note: In previous versions of Dreamweaver the Files panel was called the Site panel.
You can move the Files panel as necessary and set preferences for the panel.
Use this panel to perform the following tasks:
•Access sites, a server, and local drives
•View files and folders
•Manage files and folders in the Files panel
•Work with a visual map of your site
September 4, 2007
DREAMWEAVER CS3
User Guide
78
For Dreamweaver sites, use the following options to display or transfer files:
A. Site Files view B. Testing Server view C. Site Map view D. Site pop-up menu E. Connect/Disconnect F. Refresh G. Put File(s) H. Get
File(s) I. Check Out File(s) J. Check In File(s) K. Synchronize L. Expand/Collapse
Note: The Site Files view, Testing Server view, Site Map view, and Synchronize buttons appear only in the expanded Files
panel.
The Site pop-up menu LetsyouselectaDreamweaversiteanddisplaythatsite’sfiles.YoucanalsousetheSitemenu
to access all the files on your local disk, much like Windows Explorer (Windows) or the Finder (Macintosh).
Site Files view Displays the file structure of the remote and local sites in the panes of the Files panel. (A preference
setting determines which site appears in the left pane and which appears in the right pane.) Site Files view is the
default view for the Files panel.
Testing Server view Displays the directory structure of the testing server and the local site.
Site Map view Displays a graphical map of your site based on how the documents are linked to one another. Hold
this button down to select Map Only or Map and Files from the pop-up menu.
The current pop-up menu Lists your Dreamweaver sites, servers you’ve connected to, and provides access to your
local drives and desktop.
Connect/Disconnect (FTP, RDS, WebDAV protocol, and Microsoft Visual SourceSafe) Connects to or disconnects
fromtheremotesite.Bydefault,Dreamweaverdisconnectsfromtheremotesiteifithasbeenidleformorethan30
minutes (FTP only). To change the time limit, select Edit > Preferences (Windows) or Dreamweaver > Preferences
(Macintosh), then select Site from the category list on the left.
Refresh Refreshes the local and remote directory lists. Use this button to manually refresh the directory lists if you
deselected either Refresh Local File List Automatically or Refresh Remote File List Automatically in the Site
Definition dialog box.
Get File(s) Copies the selected files from the remote site to your local site (overwriting the existing local copy of the
file, if any). If Enable File Check In And Check Out is enabled, the local copies are read-only; the files remain
available on the remote site for other team members to check out. If Enable File Check In and Check Out is disabled,
the file copies will have both read and write privileges.
Note: The files Dreamweaver copies are the files you select in the active pane of the Files panel. If the Remote pane is
active, the selected remote or testing server files are copied to the local site; if the Local pane is active, Dreamweaver copies
the remote or testing server version of the selected local files to the local site.
Put File(s) Copies the selected files from the local site to the remote site.
Note: The files Dreamweaver copies are the files you select in the active pane of the Files panel. If the Local pane is active,
the selected local files are copied to the remote site or testing server; if the Remote pane is active, Dreamweaver copies the
local versions of the selected remote server files to the remote site.
Ifyouareputtingafilethatdoesn’talreadyexistontheremotesite,andEnableFileCheckInandOutisenabled,the
file is added to the remote site as “checked out.” Click the Check In Files button if you want to add a file without the
checked out status.
Check Out File(s) Transfers a copy of the file from the remote server to your local site (overwriting the existing local
copy of the file, if any) and marks the file as checked out on the server. This option is not available if Enable File
Check In and Check Out in the Site Definitions dialog box is disabled for the current site.
A B C D E F G H I J K L
September 4, 2007
DREAMWEAVER CS3
User Guide
79
Check In File(s) Transfers a copy of the local file to the remote server and makes the file available for editing by
others. The local file becomes read-only. This option is not available if the Enable File Check In and Check Out
option in the Site Definitions dialog box is disabled for the current site.
Synchronize Synchronizes the files between the local and remote folders.
The Expand/Collapse button Expands or collapses the Files panel to display one or two panes.
See also
“Files panel overview” on page 22
“Set up a remote folder” on page 43
“Check files into and out of a remote folder” on page 93
“Put files on a remote server” on page 89
“Get files from a remote server” on page 88
“Synchronizing files” on page 94
View files and folders
You can view files and folders in the Files panel, whether they are associated with a Dreamweaver site or not. When
you view sites, files, or folders in the Files panel, you can change the size of the viewing area, and, for Dreamweaver
sites, you can expand or collapse the Files panel.
For Dreamweaver sites, you can also customize the Files panel by changing the view—either your local or remote
site—that appears by default in the collapsed panel. Or, you can switch the content views in the expanded Files panel
using the Always Show option.
See also
“Set up a remote folder” on page 43
“Set up a testing server” on page 48
“Working with a visual map of your site” on page 52
Open or close the Files panel
❖Select Window > Files.
Expand or collapse the Files panel (Dreamweaver sites only)
❖In the Files panel (Window > Files), click the Expand/Collapse button in the toolbar.
Note: If you click the Expand/Collapse button to expand the panel while it is docked, the panel maximizes so that you
cannot work in the Document window. To return to the Document window, click the Expand/Collapse button again to
collapse the panel. If you click the Expand/Collapse button to expand the panel while it is not docked, you can still work
in the Document window. Before you can dock the panel again, you must first collapse it.
When the Files panel is collapsed it displays the contents of the local site, the remote site, or the testing server as a
list of files. When expanded, it displays the local site and either the remote site or testing server. The Files panel can
also display a visual site map of the local site.
September 4, 2007
DREAMWEAVER CS3
User Guide
80
Change the size of the view area in the expanded Files panel
❖In the Files panel (Window > Files), with the panel expanded, do one of the following:
•Drag the bar that separates the two views to increase or decrease the view area of the right or left pane.
•Use the scroll bars at the bottom of the Files panel to scroll through the views’ contents.
•In the site map, drag the arrow above a file to change the space between files.
Change the site view in Files panel (Dreamweaver sites only)
❖Do one of the following:
•In the collapsed Files panel (Window > Files), select Local View, Remote View, Testing Server, or Map View from
the Site View pop-up menu.
Note: Local View appears in the Site View menu by default.
•In the expanded Files panel (Window > Files), click the Site Files button (for the remote site), Testing Server
button, or Site Map button in the toolbar.
A. Site Files B. Testing Ser v e r C. Site Map
•If you click the Site Map button, you can choose to view the site map with site files or to view the site map only.
Note: Before you can view a remote site or a testing server, you must set up a remote site or testing server. Before you can
view a site map, you must set up a home page.
View files outside of a Dreamweaver site
❖Navigate your computer using the Site pop-up menu, much as you would if you were using Windows Explorer
(Windows) or the Finder (Macintosh).
Work with files in the Files panel
You can open or rename files; add, move, or delete files; or refresh the Files panel after you make changes.
For Dreamweaver sites, you can also determine which files (on either the local or remote site) have been updated
since the last time they were transferred.
See also
“Synchronizing files” on page 94
“Access sites, a server, and local drives” on page 83
A B C
September 4, 2007
DREAMWEAVER CS3
User Guide
81
Open a file
1In the Files panel (Window > Files), select a site, server, or drive from the pop-up menu (where the current site,
server, or drive appears).
2Navigate to the file you want to open.
3Do one of the following:
•Double-click the file’s icon.
•Right-click (Windows) or Control-click (Macintosh) the file’s icon, then select Open.
Dreamweaver opens the file in the Document window.
Create a file or folder
1In the Files panel (Window > Files), select a file or folder.
Dreamweaver will create the new file or folder inside the currently selected folder, or in the same folder as the
currently selected file.
2Right-click (Windows) or Control-click (Macintosh), then select New File or New Folder.
3Enter a name for the new file or folder.
4Press Enter (Windows) or Return (Macintosh).
Delete a file or folder
1In the Files panel (Window > Files), select the file or folder you want to delete.
2Right-click (Windows) or Control-click (Macintosh), then select Delete.
Rename a file or folder
1In the Files panel (Window > Files), select the file or folder you want to rename.
2Do one of the following to activate the name of the file or folder:
•Click in the filename, pause, then click again.
•Right-click (Windows) or Control-click (Macintosh) the file’s icon, then select Rename.
3Type the new name over the existing name.
4Press Enter (Windows) or Return (Macintosh).
Move a file or folder
1In the Files panel (Window > Files), select the file or folder you want to move.
2Do one of the following:
•Copy the file or folder, then paste it in a new location.
•Drag the file or folder to a new location.
3Refresh the Files panel to see the file or folder in its new location.
Refresh the Files panel
❖Do one of the following:
•Right-click (Windows) or Control-click (Macintosh) any file or folder, then select Refresh.
•(Dreamweaver sites only) Click the Refresh button in the Files panel toolbar (this option refreshes both panes).
September 4, 2007
DREAMWEAVER CS3
User Guide
82
Note: Dreamweaver refreshes the Files panel when you make changes in another application, then return to
Dreamweaver.
Find files in your Dreamweaver site
Dreamweaver makes it easy to find selected, open, checked out, or recently modified files in your site. You can also
find files that are newer in your local or remote site.
See also
“Use reports to test your site” on page 106
Find an open file in your site
1Open the file in the Document window.
2Select Site > Locate in Site.
Dreamweaver selects the file in the Files panel.
Note: If the open file in the Document window is not part of the current site in the Files panel, Dreamweaver attempts
to determine which of your Dreamweaver sites the file belongs to; if the current file belongs to only one local site,
Dreamweaver opens that site in the Files panel, then highlights the file.
Locate and select checked out files in a Dreamweaver site
❖In the collapsed Files panel (Window > Files), click the Options menu in the upper-right corner of the Files panel,
then select Edit > Select Checked Out Files.
Dreamweaver selects the files in the Files panel.
Find a selected file in your local or remote site
1Select the file in the Local or Remote view of the Files panel (Window > Files).
2Right-click (Windows) or Control-click (Macintosh), then select Locate in Local Site or Locate in Local Site
(depending on where you selected the file).
Dreamweaver selects the file in the Files panel.
Locate and select files that are newer in the local site than in the remote site
❖In the collapsed Files panel (Window > Files), click the Options menu in the upper-right corner of the Files panel,
then select Edit > Select Newer Local.
Dreamweaver selects the files in the Files panel.
Locate and select files that are newer in the remote site than in the local site
❖In the collapsed Files panel (Window > Files), click the Options menu in the upper-right corner of the Files panel,
then select Edit > Select Newer Remote.
Dreamweaver selects the files in the Files panel.
September 4, 2007
DREAMWEAVER CS3
User Guide
83
Find recently modified files in your site
1In the collapsed Files panel (Window > Files), click the Options menu in the upper-right corner of the Files panel,
and then select Edit > Select Recently Modified.
2Do one of the following to indicate search dates for the report:
•To report on all files modified in the last several days, select Files Created or Modified in the Last and enter a
number in the box.
•To report on all files modified within a specific time frame, click the Files Created or Modified in the Between
radio button, then specify a date range.
3(Optional) Enter a user name in the Modified By box to limit your search to files modified by a specific user
between the dates you indicated.
Note: This option is only available for reports on Contribute sites.
4Select a radio button to indicate where you want to view files listed in the report, if necessary:
Local Machine if the site contains static pages.
Testing Server if the site contains dynamic pages.
Note: This option assumes you defined a Testing Server in the Site Definition dialog box (XREF). If you have not defined
a Testing Server and entered a URL prefix for that server, or if you are running the report for more than one site, this
option is not available.
Other Location if you want to enter a path in the text box.
5Click OK to save your settings.
Dreamweaver highlights the files that were modified within the selected time frame in the Files panel.
Identify and delete unused files
You can identify and delete files that are no longer used by other files in your site.
1Select Site > Check Links Sitewide.
Dreamweaver checks all the links in your site and displays the broken ones in the Results panel.
2Select Orphaned Files from the menu on the Link Checker panel.
Dreamweaver displays all the files with no incoming links. This means that no files in your site link to these files.
3Select the files you want to delete and press Delete (Windows) or Command+Delete (Macintosh).
Important: Although no other file in the site links to these files, some of the listed files may link to other files. Use caution
when deleting the files.
See also
“Enable and disable site cloaking” on page 100
Access sites, a server, and local drives
You can access, modify, and save files and folders in your Dreamweaver sites, as well as files and folders that are not
part of a Dreamweaver site. In addition to Dreamweaver sites, you can access a server, a local drive, or your desktop.
Before you can access a remote server, you must set up Dreamweaver to work with that server.
September 4, 2007
DREAMWEAVER CS3
User Guide
84
Note: The best way to manage your files is to create a Dreamweaver site.
See also
“Set up and edit a local root folder” on page 42
Open an existing Dreamweaver site
❖In the Files panel (Window > Files), select a site from the menu (where the current site, server, or drive appears).
Open a folder on a remote FTP or RDS server
1In the Files panel (Window > Files), select a server name from the menu (where the current site, server, or drive
appears).
Note: Server names appear for servers you’ve configured Dreamweaver to work with.
2Navigate to and edit files as you normally do.
Access a local drive or your desktop
1In the Files panel (Window > Files), select Desktop, Local Disk, or CD Drive from the menu (where the current
site, server, or drive appears).
2Navigate to a file, then do any of the following:
•Open files in Dreamweaver or another application
•Rename files
•Copy files
•Delete files
•Drag files
When you drag a file from one Dreamweaver site to another or to a folder that is not part of a Dreamweaver site,
Dreamweavercopies the file to the location where you drop it. If you drag a file within the same Dreamweaver site,
Dreamweavermoves thefiletothelocationwhereyoudropit.IfyoudragafilethatisnotpartofaDreamweaversite
to a folder that is not part of a Dreamweaver site, Dreamweaver moves the file to the location where you drop it.
September 4, 2007
DREAMWEAVER CS3
User Guide
85
Note: To move a file that Dreamweaver copies by default, hold down the Shift key (Windows) or the Command key
(Macintosh)whileyoudrag.TocopyafilethatDreamweavermovesbydefault,holdtheControlkey(Windows)orthe
Option key (Macintosh) while you drag.
Set site preferences for transferring files
You select preferences to control file-transfer features that appear in the Files panel.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2In the Preferences dialog box, select Site from the category list on the left.
3Set the options and click OK.
Always Show Specifies which site (remote or local) is always shown, and in which Files panel pane (left or right) the
local and remote files appear.
By default, the local site always appears on the right. Whichever pane is not chosen (the left one by default) is the
changeable pane: this pane can display either the site map or the files in the other site (the remote site by default).
Dependent Files Displays a prompt for transferring dependent files (such as images, external style sheets, and other
files referenced in the HTML file) that the browser loads when it loads the HTML file. By default, both Prompt on
Get/Check Out and Prompt on Put/Check In are selected.
It’s usually a good idea to download dependent files when checking out a new file, but if the latest versions of the
dependent files are already on the local disk, there’s no need to download them again. This is also true for uploading
and checking in files: no need if up-to-date copies are already at the destination.
If you deselect these options, your dependent files are not transferred. Therefore, to force the Dependent Files dialog
box to appear even when these options are deselected, hold down Alt (Windows) or Option (Macintosh) while
choosing the Get, Put, Check In, or Check Out commands.
FTP Connection Determines whether the connection to the remote site is terminated after the specified number of
minutes have passed with no activity.
FTP Time Out Specifies the number of seconds in which Dreamweaver attempts to make a connection with the
remote server.
If there is no response after the specified amount of time, Dreamweaver displays a warning dialog box alerting you
to this fact.
FTP Transfer options Determines whether Dreamweaver selects the default option, after a specified number of
seconds, when a dialog box appears during a file transfer and there is no user response.
Firewall Host Specifies the address of the proxy server through which you connect to outside servers if you are
behind a firewall.
If you are not behind a firewall, leave this space blank. If you are behind a firewall, select the Use Firewall option in
the Site Definition dialog box.
Firewall Port Specifies the port in your firewall through which you pass to connect to the remote server. If you
connect through a port other than 21 (the default for FTP), enter the number here.
Put Options: Save Files Before Putting Indicatesthatunsavedfilesaresavedautomaticallybeforebeingputontothe
remote site.
Manage Sites Opens the Manage Sites dialog box, where you can edit an existing site or create a new one.
September 4, 2007
DREAMWEAVER CS3
User Guide
86
You can define whether the types of files that you transfer are transferred as ASCII (text) or binary, by customizing
the FTPExtensionMap.txt file in the Dreamweaver/Configuration folder (on the Macintosh, FTPExtension-
MapMac.txt). For more information see, Extending Dreamweaver.
See also
“Set up a remote folder” on page 43
Customize the file and folder details displayed in the expanded Files panel
WhenyouviewaDreamweaversiteintheexpandedFilespanel,informationaboutthefilesandfoldersisdisplayed
in columns. For example, you can see the file type or the date a file was modified.
You can customize the columns by doing any of the following (some operations are only available for columns you
add, not default columns):
•Reorder or realign columns
•Add new columns (for a maximum of 10 columns)
•Hide columns (except the filename column)
•Designate columns to be shared with all users connected to a site
•Delete columns (custom columns only)
•Rename columns (custom columns only)
•Associate columns with a Design Note (custom columns only)
Change the order of the columns
❖Selectacolumnname,andthenclicktheupordownarrowbuttontochangethepositionoftheselectedcolumn.
Note: You can change the order of any column except Name, which is always the first column.
Add, delete, or change detail columns
1Select Site > Manage Sites.
2Select a site, then click Edit.
3Select File View Columns from the Category list on the left.
4Select a column and click the Plus (+) button to add a column, or the Minus (–) button to delete a column.
Note: The column is deleted immediately and without confirmation, so make certain that you want to delete the column
before clicking the Minus (–) button.
5In the Column Name box, enter a name for your column.
6Select a value from the Associate with Design Note menu, or type in your own.
Note: You must associate a new column with a Design Note, so that there is data to display in the Files panel.
7Select an alignment to determine how text is aligned within the column.
8Select or deselect Show to reveal or hide the column.
9Select Share with All Users of This Site to share the column with all users connected to the remote site.
Sort by any detail column in the Files panel
❖Click the heading for the column you want to sort.
September 4, 2007
DREAMWEAVER CS3
User Guide
87
Click the heading again to reverse the order (ascending or descending) by which Dreamweaver sorts the column.
Getting and putting files to and from your server
File transfer and dependent files
If you’re working in a collaborative environment, use the Check In/Check Out system to transfer files between local
and remote sites. If you’re the only person working on the remote site, however, you can use the Get and Put
commands to transfer files without checking them in or out.
WhenyoutransferadocumentbetweenalocalandremotefolderusingtheFilespanel,youhavetheoptionoftrans-
ferring the document’s dependent files. Dependent files are images, external style sheets, and other files referenced
in your document that a browser loads when it loads the document.
Note: It’s usually a good idea to download dependent files when checking out a new file, but if the latest versions of the
dependent files are already on the local disk, there’s no need to download them again. This is also true for uploading and
checking in files: no need if up-to-date copies are already at the remote site.
Library items are treated as dependent files.
Someserversreporterrorswhenputtinglibraryitems.However,youcancloakthesefilestopreventthemfrombeing
transferred.
See also
“Checking in and checking out files” on page 91
“Enable and disable site cloaking” on page 100
About background file transfers
You can perform other, non-server-related, activities while you’re getting or putting files. Background file transfer
works for all of the transfer protocols supported by Dreamweaver: FTP, SFTP, LAN, WebDAV, Microsoft Visual
SourceSafe, and RDS.
Non-server-related activities include common operations like typing, editing external style sheets, generating site-
wide reports, and creating new sites.
Server-related activities that Dreamweaver cannot perform during file transfers include the following:
•Put/Get/Check in/Check out files
•Undo check-out
•Create a database connection
•Bind dynamic data
•Preview live data
•Insert a web service
•Delete remote files or folders
•Preview in a browser on a testing server
September 4, 2007
DREAMWEAVER CS3
User Guide
88
•Save a file to a remote server
•Insert an image from a remote server
•Open a file from a remote server
•Auto put files upon saving
•Drag files to the remote site
•Cut, copy, or paste files on the remote site
•Refresh Remote view
Get files from a remote server
Use the Get command to copy files from the remote site to your local site. You can use the Files panel or the
Document window to get files.
Dreamweaver creates a log of file activity during the transfer that you can view and save.
Note: Youcannotturnbackgroundfiletransferoff.Ifyouhavethedetaillogopeninthebackgroundfiletransferwindow,
you can close that to improve performance.
Dreamweaver also records all FTP file transfer activity. If an error occurs when you are transferring a file using FTP,
the Site FTP log can help you determine the problem.
See also
“Checking in and checking out files” on page 91
“Synchronizing files” on page 94
Get files from a remote server using the Files panel
1In the Files panel (Window > Files), select the desired files to download.
UsuallyyouselectthesefilesintheRemoteview,butyoucanselectthecorrespondingfilesintheLocalviewifyou
prefer. If the Remote view is active, then Dreamweaver copies the selected files to the local site; if the Local view is
active, then Dreamweaver copies the remote versions of the selected local files to the local site.
Note: To get only those files for which the remote version is more recent than the local version, use the Synchronize
command.
2Do one of the following to get the file:
•Click the Get button in the Files panel toolbar.
•
Right-click (Windows) or Control-click (Macintosh) the file in the Files panel, then select Get from the context menu.
3Click Yes in the Dependent Files dialog box to download dependent files; if you already have local copies of the
dependent files, click No. The default is to not download dependent files. You can set this option at Edit > Preferences
> Site.
Dreamweaver downloads the selected files, as follows:
•If you’re using the Check In/Check Out system, getting a file results in a read-only local copy of the file; the file
remains available on the remote site or testing server for other team members to check out.
•If you’re not using the Check In/Check Out system, getting a a copy that has both read and write privileges.
September 4, 2007
DREAMWEAVER CS3
User Guide
89
Note: If you’re working in a collaborative environment—that is, if others are working on the same files—you should not
disable Enable File Check In and Check Out. If other people are using the Check In/Check Out system with the site, you
should use that system as well.
To stop the file transfer at any time, click Cancel in the status dialog box.
Get files from a remote server using the Document window
1Make sure the document is active in the Document window.
2Do one of the following to get the file:
•Select Site > Get.
•Click the File Management icon in the Document window toolbar, then select Get from the menu.
Note: If the current file is not part of the current site in the Files panel, Dreamweaver attempts to determine which locally
defined site the current file belongs to. If the current file belongs to only one local site, Dreamweaver opens that site, then
performs the Get operation.
Display the FTP log
❖Click the Options menu in the upper-right corner of the Files panel, then select View > Site FTP Log.
Put files on a remote server
You can put files from the local site to the remote site, generally without changing the file’s checked out status.
There are two common situations in which you might use the Put command instead of Check In:
•You’re not in a collaborative environment and you aren’t using the Check In/Check Out system.
•You want to put the current version of the file on the server but you’re going to keep editing it.
Note: If you put a file that didn’t previously exist on the remote site and you’re using the Check In/Check Out system, the
file is copied to the remote site and is then checked out to you so that you can continue editing.
You can use the Files panel or the Document window to put files. Dreamweaver creates a log of file activity during
the transfer that you can view and save.
Dreamweaver also records all FTP file transfer activity. If an error occurs when you are transferring a file using FTP,
the Site FTP log can help you determine the problem.
For a tutorial on putting files on a remote server, see www.adobe.com/go/vid0163.
For a tutorial on troubleshooting publishing problems, see www.adobe.com/go/vid0164.
See also
“Synchronizing files” on page 94
“About the Check In/Check Out system” on page 91
Put files on a remote or testing server using the Files panel
1In the Files panel (Window > Files), select the files to upload.
Usually you select these in the Local view, but you may select the corresponding files in the Remote view if you prefer.
September 4, 2007
DREAMWEAVER CS3
User Guide
90
Note: You can put only those files for which the local version is more recent than the remote version.
2Do one of the following to put the file on the remote server:
•Click the Put button in the Files panel toolbar.
•
Right-click (Windows) or Control-click (Macintosh) the file in the Files panel, then select Put from the context menu.
3If the file hasn’t been saved, a dialog box appears (if you set this preference in the Site category of the Preferences
dialog box) allowing you to save the file before putting it on the remote server. Click Yes to save the file or No to put
the previously saved version on the remote server.
Note: If you do not save the file, any changes you’ve made since the last time you saved will not be put onto the remote
server. However, the file remains open, so you can still save the changes after putting the file on the server if you want.
4Click Yes to upload dependent files along with the selected files, or click No to refrain from uploading dependent
files. The default is to not upload dependent files. You can set this option at Edit > Preferences > Site.
Note: It’s usually a good idea to upload dependent files when checking in a new file, but if the latest versions of the
dependent files are already on the remote server, there’s no need to upload them again.
To stop the file transfer, click Cancel in the status dialog box. The transfer may not stop immediately.
A lock symbol appears beside the local file’s icon indicating that the file is now read-only.
Important: If you check in the currently active file, the file may be automatically saved before it’s checked in, depending
on the preference options you’ve set.
Put files on a remote server using the Document window
1Make sure the document is active in the Document window.
2Do one of the following to put the file:
•Select Site > Put.
•Click the File Management icon in the Document window toolbar, then select Put from the menu.
Note: If the current file is not part of the current site in the Files panel, Dreamweaver attempts to determine which locally
defined site the current file belongs to. If the current file belongs to only one local site, Dreamweaver opens that site, then
performs the Put operation.
Display the FTP log
❖Click the Options menu in the upper-right corner of the Files panel, then select View > Site FTP Log.
Manage file transfers
You can view the status of file transfer operations, as well as a list of transferred files and their outcomes (transfer
successful, skipped, or failed). You can also save a log of the file activity.
Note: Dreamweaver lets you perform other non-server-related activities while you’re transferring files to or from a server.
Cancel a file transfer
❖Click the Cancel button or close the Background File Activity dialog box.
September 4, 2007
DREAMWEAVER CS3
User Guide
91
Hide the Background File Activity dialog box during transfers
❖Click the Hide button on the Background File Activity dialog box to minimize it so that all you see is the small
Log button at the bottom of the Files panel.
Note: You cannot hide or remove the Log button. It’s a permanent part of the panel.
View details of the last file transfer
1Click the Log button at the bottom of the Files panel to open the Background File Activity dialog box.
2Click the Details expander arrow.
Save a log of the last file transfer
1Click the Log button at the bottom of the Files panel to open the Background File Activity dialog box.
2Click the Save Log button and save the information as a text file.
You can review the file activity by opening the log file in Dreamweaver or in any text editor.
Checking in and checking out files
About the Check In/Check Out system
If you’re working in a collaborative environment, you can check files in and out from local and remote servers. If
you’retheonlypersonworkingontheremoteserver,youcanusethePutandGetcommandswithoutcheckingfiles
in or out.
Note: You can use Get and Put functionality with a testing server, but you cannot use the Check In/ Check Out system
with a testing server.
Checking out a file is the equivalent of declaring “I’m working on this file now—don’t touch it!” When a file is
checkedout,thenameofthepersonwhocheckedoutthefileisdisplayedintheFilespanel,alongwitharedcheck
mark (if a team member checked out the file) or green check mark (if you checked out the file) next to the file’s icon.
Checking in a file makes the file available for other team members to check out and edit. When you check in a file
after editing it, your local version becomes read-only and a lock symbol appears beside the file in the Files panel to
prevent you from making changes to the file.
Dreamweaver does not make checked-out files read-only on the remote server. If you transfer files with an appli-
cation other than Dreamweaver, you can overwrite checked-out files. However, in applications other than
Dreamweaver, the LCK file is visible next to the checked-out file in the file hierarchy to help prevent such accidents.
For more information on LCK files and how the Check In/Check Out system works, see TechNote 15447 on the
Adobe website at www.adobe.com/go/15447.
See also
“Getting and putting files to and from your server” on page 87
Set up the Check In/Check Out system
Before you can use the Check In/Check Out system, you must associate your local site with a remote server.
1Select Site > Manage Sites.
September 4, 2007
DREAMWEAVER CS3
User Guide
92
2Select a site and click Edit.
3In the Advanced tab, select Remote Info from the category list on the left.
4Select Enable File Check In and Check Out if you are working in a team environment (or working alone but from
several different machines). Deselect this option if you want to disable file check in and check out for your website.
This option is useful to let others know that you checked out a file for editing, or to alert yourself that you may have
left a more recent version of a file on another machine.
If your remote access option is Microsoft Visual SourceSafe, this is your only Check In/Check Out option. The
remaining options in this section apply to FTP, Local/Network, WebDAV, and RDS access methods only.
If you do not see Check In/Out options, it means that you have not set up a remote server.
5Select the Check Out Files when Opening option if you want to automatically check out files when you double-
click to open them from the Files panel.
Using File > Open to open a file doesn’t check the file out even when this option is selected.
6Set the remaining options:
Check Out Name Thecheck-outnameappearsintheFilespanelalongsideanyfilesthatarecheckedout;thisenables
team members to communicate with the right person if a file they need is checked out.
Note: If you work alone from several different machines, use a different check-out name on each machine (for example,
AmyR-HomeMac and AmyR-OfficePC) so you’ll know where the latest version of the file is if you forget to check it in.
Email Address If you enter an e-mail address, when you check out a file, your name appears in the Files panel as a
link (blue and underlined) next to that file. If a team member clicks on the link, their default e-mail program opens
a new message with the user’s e-mail address and a subject that corresponds to the file and site name.
See also
“Set up a remote folder” on page 43
Use WebDAV to check in and check out files
Dreamweaver can connect to a server that uses WebDAV (Web-based Distributed Authoring and Versioning), which
is a set of extensions to the HTTP protocol that allow users to collaboratively edit and manage files on remote web
servers. For more information, see www.webdav.org.
1If you have not already done so, define a Dreamweaver site that specifies the local folder you use to store your
project files.
2Select Site > Manage Sites, and then double-click your site in the list.
3In the Site Definition dialog box, click the Advanced tab.
4Click the Remote Info category, and then select WebDAV from the Access menu.
5Specify how Dreamweaver should connect to your WebDAV server.
6Select the Enable File Check in and Check Out option and enter the following information:
•In the Check Out Name box, enter a name identifying you to other team members.
•In the Email Address box, enter your e-mail address.
The name and e-mail addresses are used to identify ownership on the WebDAV server and appear in the Files panel
for contact purposes.
September 4, 2007
DREAMWEAVER CS3
User Guide
93
7Click OK.
Dreamweaver configures the site for WebDAV access. When you use the Check In or Check Out command on any
site file, the file is transferred using WebDAV.
Note: WebDAV may be unable to properly check out any files with dynamic content like PHP tags or SSIs because the
HTTP GET rendered these as they are checked out.
Check files into and out of a remote folder
After you set up the Check In/Check Out system, you can check in and check out files on a remote server using the
Files panel or from the Document window.
See also
“Set site preferences for transferring files” on page 85
Check out files using the Files panel
1In the Files panel (Window > Files), select files to check out from the remote server.
Note: You can select files in the Local or Remote view, not the Testing Server view.
A red check mark indicates that another team member has the file checked out and a lock symbol indicates that the
file is read-only (Windows) or locked (Macintosh).
2Do one of the following to check out the file(s):
•Click the Check Out button in the Files panel toolbar.
•Right-click (Windows) or Control-click (Macintosh), then select Check Out from the context menu.
3IntheDependentFilesdialogbox,clickYestodownloaddependentfilesalongwiththeselectedfiles,orclickNo
to refrain from downloading dependent files. The default is to not download dependent files. You can set this option
at Edit > Preferences > Site.
Note: It’s usually a good idea to download dependent files when checking out a new file, but if the latest versions of the
dependent files are already on the local disk, there’s no need to download them again.
A green check mark appears beside the local file’s icon indicating that you have checked it out.
Important: If you check out the currently active file, the currently open version of the file is overwritten by the new
checked-out version.
Check in files using the Files panel
1In the Files panel (Window > Files), select checked-out or new file(s).
Note: You can select files in the Local or Remote view, but not the Testing Server view.
2Do one of the following to check in the file(s):
•Click the Check In button in the Files panel toolbar.
•Right-click (Windows) or Control-click (Macintosh), then select Check In from the context menu.
3Click Yes to upload dependent files along with the selected files, or click No to refrain from uploading dependent
files. The default is to not upload dependent files. You can set this option at Edit > Preferences > Site.
Note: It’s usually a good idea to upload dependent files when checking in a new file, but if the latest versions of the
dependent files are already on the remote server, there’s no need to upload them again.
September 4, 2007
DREAMWEAVER CS3
User Guide
94
A lock symbol appears beside the local file’s icon indicating that the file is now read-only.
Important: If you check in the currently active file, the file may be automatically saved before it’s checked in, depending
on the preference options you’ve set.
Check in an open file from the Document window
1Make sure the file you want to check in is open in the Document window.
Note: You can check in only one open file at a time.
2Do one of the following:
•Select Site > Check In.
•Click the File Management icon in the Document window toolbar, then select Check In from the menu.
If the current file is not part of the active site in the Files panel, Dreamweaver attempts to determine which locally
definedsitethecurrentfilebelongsto.Ifthecurrentfilebelongstoasiteotherthantheonethat’sactiveintheFiles
panel, Dreamweaver opens that site, then performs the check in operation.
Important: If you check in the currently active file, the file may be automatically saved before it’s checked in, depending
on the preference options you’ve set.
Undo a file check-out
Ifyoucheckoutafile,thendecidenottoeditit(ordecidetodiscardthechangesyoumade),youcanundothecheck-
out operation and the file returns to its original state.
To undo a file check-out, do one of the following:
•Open the file in the Document window, then select Site > Undo Check Out.
•In the Files panel (Window > Files), right-click (Windows) or Control-click (Macintosh), then select Undo Check Out.
The local copy of the file becomes read-only, and any changes you’ve made to it are lost.
Synchronizing files
Synchronize the files on your local and remote sites
After you’ve created files in your local and remote sites, you can synchronize the files between the two sites.
Note: If your remote site is an FTP server (rather than a networked server), then synchronizing your files uses FTP.
Before you synchronize your sites, you can verify which files you want to put, get, delete, or ignore. Dreamweaver
also confirms which files have been updated after you complete the synchronization.
See also
“Manage file transfers” on page 90
“Check files into and out of a remote folder” on page 93
“Get files from a remote server” on page 88
“Put files on a remote server” on page 89
“Comparing files for differences” on page 96
September 4, 2007
DREAMWEAVER CS3
User Guide
95
Check which files are newer on the local or remote site, without synchronizing
❖ In the Files panel, do one of the following:
•Click the Options menu in the upper-right corner, and then select Edit > Select Newer Local or Edit > Select
Newer Remote.
•In the Files panel, right-click (Windows) or Control-click (Macintosh), and then select Select > Newer Local or
Select > Newer Remote.
Display detailed synchronization information for a particular file
❖In the Files panel, right-click (Windows) or Control-click (Macintosh) the file you want information about, and
then select Display Synchronize information.
Note: You must have the Maintain Synchronization Information option selected in the Remote category of the Site
Definition dialog box for this feature to be available.
Synchronize your files
1In the Files panel (Window > Files), select a site from the menu where the current site, server, or drive appears.
2(Optional) Select specific files or folders or go to the next step to synchronize the entire site.
3Click the Options menu in the upper-right corner of the Files panel and select Site > Synchronize.
You can also click the Synchronize button at the top of the Files panel to synchronize files.
4In the Synchronize menu, do one of the following:
•To synchronize the entire site, select Entire Site Name Site.
•To synchronize selected files only, select Selected Local Files Only (or Selected Remote Files Only if the Remote
view of the Files panel was where you made the most recent selection).
5Select the direction in which you want to copy the files:
Put Newer Files To Remote Uploadsallthelocalfilesthatdon’texistontheremoteserverorhavechangedsincethe
last upload.
Get Newer Files From Remote Downloads all the remote files that don’t exist locally or have changed since the last
download.
Get And Put Newer Files Places the most recent versions of all the files on both the local and the remote sites.
6Select whether to delete the files on the destination site that don’t have counterparts on the origin site. (This is not
available if you select Get and Put from the Direction menu.)
If you select Put Newer Files to Remote and you select the Delete option, then any files in your remote site for which
there are no corresponding local files are deleted. If you select Get Newer Files from Remote, then any files in your
local site for which there are no corresponding remote files are deleted.
7Click Preview.
Note: Before you can synchronize the files, you must preview the actions Dreamweaver performs to accomplish this task.
Ifthenewestversionofeachchosenfileisalreadyinbothlocationsandnothingneedstobedeleted,analertappears
informing you that no synchronization is necessary. Otherwise, the Synchronize dialog box appears to let you change
the actions (put, get, delete, and ignore) for those files before executing the synchronization.
September 4, 2007
DREAMWEAVER CS3
User Guide
96
8Verify the action that will be performed for each file.
9To change the action for a particular file, select the file, and then click one of the action icons at the bottom of the
preview window.
Compare The Compare action works only if you installed and specified a file comparison tool in Dreamweaver. If
the action icon is grayed out, the action cannot be performed.
Mark Selected Files As Already Synced This option lets you specify that the selected file or files are already synchro-
nized.
10 Click OK to synchronize the files. You can view or save the details of the synchronization to a local file.
Comparing files for differences
Compare local and remote files for differences
Dreamweaver can work with file comparison tools (also known as “diff tools”) to compare the code of local and
remote versions of the same file, two different remote files, or two different local files. Comparing local and remote
versions is useful if you’re working on a file locally and you suspect the copy of the file on the server has been
modified by someone else. Without leaving Dreamweaver, you can view and merge the remote changes into your
local version before putting the file to the server.
Comparing two local files or two remote files is also useful if you keep previous, renamed versions of your files. If
you’ve forgotten the changes made to a file from a previous version, a quick comparison will remind you.
Before you start, you must install a third-party file comparison tool on your system. For more information on file
comparison tools, use a web search engine such as Google Search to search for “file comparison” or “diff ” tools.
Dreamweaver works with most third-party tools.
See also
“Set up and edit a local root folder” on page 42
Specify a comparison tool in Dreamweaver
1Install the file comparison tool on the same system as Dreamweaver.
2In Dreamweaver, open the Preferences dialog box by selecting Edit > Preferences (Windows) or Dreamweaver >
Preferences (Macintosh), and then select the File Compare category.
3Do one of the following:
•In Windows, click the Browse button and select the application that compares files.
•OntheMacintosh,clicktheBrowsebuttonandselectthetoolorscriptthatlaunchesthefilecomparisontoolfrom
the command line, not the actual comparison tool itself.
Launch tools or scripts are typically located in the usr/bin folder on your Macintosh. For example, if you want to use
FileMerge, browse to usr/bin and select opendiff, which is the tool that launches FileMerge.
The following table lists common file comparison tools for the Macintosh and the location of their launch tools or
scripts on your hard disk:
September 4, 2007
DREAMWEAVER CS3
User Guide
97
Note: TheusrfolderisnormallyhiddeninFinder.However,youcanaccessitwiththeBrowsebuttoninDreamweaver.
Note: Theactualresultsdisplayeddependsonthedifftoolyouareusing.Checktheusermanualforyourtooltounder-
stand how to interpret the results.
Compare two local files
You can compare two files located anywhere on your computer.
1In the Files panel, Control-click (Windows) or Command-click (Macintosh) the two files to select them.
To select files outside your defined site, select your local disk from the left pop-up menu in the Files panel and then
select the files.
2Right-click one of the selected files and select Compare Local Files from the context menu.
Note: If you have a one-button mouse, Control-click one of the selected files instead.
The file comparison tool starts and compares the two files.
Compare two remote files
You can compare two files located on your remote server. You must define a Dreamweaver site with remote settings
before you can accomplish this task.
1In the Files panel, display the files on the remote server by selecting Remote View from the right pop-up menu.
2Control-click (Windows) or Command-click (Macintosh) the two files to select them
3Right-click one of the selected files and select Compare Remote Files from the context menu.
Note: If you have a one-button mouse, Control-click one of the selected files instead.
The file comparison tool starts and compares the two files.
Compare a local file to a remote file
You can compare a local file to a file located on your remote server. To do this, you must first define a Dreamweaver
site with remote settings.
❖In the Files panel, right-click a local file and select Compare With Remote from the context menu.
Note: If you have a one-button mouse, Control-click the local file instead.
The file comparison tool starts and compares the two files.
Compare a remote file to a local file
You can compare a remote file to a local file. You must define a Dreamweaver site with remote settings before accom-
plishing this task.
1In the Files panel, display the files on the remote server by selecting Remote View from the right pop-up menu.
2Right-click a file in the panel and select Compare with Local from the context menu.
If you use Select the following file
FileMerge usr/bin/opendiff
BBEdit usr/bin/bbdiff
TextWrangler usr/bin/twdiff
September 4, 2007
DREAMWEAVER CS3
User Guide
98
Note: If you have a one-button mouse, Control-click the file instead.
Compare an open file to a remote file
You can compare a file open in Dreamweaver to its counterpart on the remote server.
❖In the Document window, select File > Compare with Remote.
The file comparison tool starts and compares the two files.
You can also right-click the document tab along the top of the Document window and select Compare with Remote
from the context menu.
Compare before putting files
If you edit a file locally and then try to upload it to your remote server, Dreamweaver will notify you if the remote
version of the file has changed. You have the option of comparing the two files before you upload the file and
overwrite the remote version.
Before you start, you must install a file comparison tool on your system and specify it in Dreamweaver.
1After editing a file in a Dreamweaver site, put the file (Site > Put) to your remote site.
If the remote version of the file has been modified, you’ll receive a notification with the option of seeing the differ-
ences.
2To view the differences, click the Compare button.
The file comparison tool starts and compares the two files.
If you haven’t specified a file comparison tool, you are prompted to specify one.
3After you’ve reviewed or merged the changes in the tool, you can proceed with the Put operation or cancel it.
Compare files when synchronizing
You can compare the local versions of your files with the remote versions when you synchronize your site files with
Dreamweaver.
Before you start, you must install a file comparison tool on your system and specify it in Dreamweaver.
1Right-click anywhere in the Files panel and select Synchronize from the context menu.
2Complete the Synchronize Files dialog box and click Preview.
After you click Preview, the selected files and the actions that will be taken during synchronization are listed.
3In the list, select each file you want to compare and click the Compare button (the icon with two small pages).
Note: The file must be text-based, such as HTML or ColdFusion files.
Dreamweaver starts the comparison tool, which compares the local and remote versions of each file you selected.
See also
“Synchronizing files” on page 94
September 4, 2007
DREAMWEAVER CS3
User Guide
99
Rolling back files (Contribute users)
Roll back files (Contribute users)
Dreamweaver automatically saves multiple versions of a document when you have Adobe Contribute compatibility
enabled.
Note: You must have Contribute installed on the same machine as Dreamweaver.
File rollback must also be enabled in Contribute’s administrative settings. For more information, see Administering
Contribute.
1Right-click (Windows) or Control-click (Macintosh) a file in the Files panel.
2Select Roll Back Page.
If there is any previous version of the page to roll back, the Rollback dialog box appears.
3Select the version of the page you want to roll back to and click Roll Back.
See also
“Prepare a site for use with Contribute” on page 59
“Delete, move, or rename a remote file in a Contribute site” on page 61
Cloaking folders and files in your site
About site cloaking
Site cloaking enables you to exclude folders and file types from operations such as Get or Put. You can cloak
individual folders, but not individual files. To cloak files, you must select a file type and Dreamweaver cloaks all files
of that type. Dreamweaver remembers your settings for each site so that you don’t have to make selections each time
you work on that site.
For example, if you’re working on a large site and don’t want to upload your multimedia files each day, you can use
site cloaking to cloak your multimedia folder, and the system excludes files in that folder from site operations you
perform.
Youcancloakfoldersandfiletypesontheremoteorlocalsite.Cloakingexcludescloakedfoldersandfilesfromthe
following operations:
•Performing Put, Get, Check In, and Check Out operations
•Generating reports
•Finding newer local and newer remote files
•Performing sitewide operations, such as checking and changing links
•Synchronizing
•Working with Asset panel contents
•Updating templates and libraries
September 4, 2007
DREAMWEAVER CS3
User Guide
100
Note: DreamweaverexcludescloakedtemplatesandlibraryitemsfromGetandPutoperationsonly.Dreamweaverdoes
not exclude these items from batch operations, because it might cause them to become out of sync with their instances.
Enable and disable site cloaking
Site cloaking enables you to exclude folders and file types in a site from sitewide operations such as Get or Put, and
is enabled by default. You can disable cloaking permanently or just temporarily to perform an operation on all files,
including cloaked files. When you disable site cloaking, all cloaked files are uncloaked. When you enable site
cloaking again, any previously cloaked files become cloaked again.
Note: You can also use the Uncloak All option to uncloak all files, but this does not disable cloaking; also there is no way
to re-cloak all folders and files that were previously cloaked, except to set cloaking again for each folder and file type.
1In the Files panel (Window > Files), select a select a site from the pop-up menu where the current site, server, or
drive appears.
2Select a file or folder.
3Right-click (Windows) or Control-click (Macintosh), and do one of the following:
•Select Cloaking > Enable Cloaking (deselect to disable).
•Select Cloaking > Settings, and select Cloaking from the category list on the left in the Advanced Site Definition
dialog box. Select or deselect Enable Cloaking, and select or deselect Cloak Files Ending With to enable or disable
cloaking for specific file types. You can enter or delete file suffixes in the text box that you want to cloak or uncloak.
4Click OK.
Cloak and uncloak site folders
You can cloak specific folders, but you cannot cloak all folders or an entire site. When you cloak specific folders, you
can cloak multiple folders at the same time.
1In the Files panel (Window > Files), select a select a site that has site cloaking enabled from the pop-up menu
where the current site, server, or drive appears.
2Select the folder(s) you want to cloak or uncloak.
3Right-click (Windows) or Control-click (Macintosh), then select Cloaking > Cloak or Cloaking > Uncloak from
the context menu.
A red line through the folder icon appears or disappears, indicating that the folder is cloaked or uncloaked.
Note: You can perform an operation on a specific cloaked folder by selecting the item in the Files panel and performing
an operation on it. Performing an operation directly on a file or folder overrides cloaking.
Cloak and uncloak specific file types
You can indicate specific file types to cloak, so that Dreamweaver cloaks all files ending with a specified pattern. For
example, you can cloak all files ending with the .txt extension. The file types that you enter do not have to be file
extensions; they can be any pattern at the end of a filename.
Note: You cannot cloak an individual file, only a folder or all files of a given file type.
Cloak specific file types within a site
1In the Files panel (Window > Files), select a site that has site cloaking enabled from the pop-up menu where the
current site, server, or drive appears.
September 4, 2007
DREAMWEAVER CS3
User Guide
101
2Right-click (Windows) or Control-click (Macintosh), then select Cloaking > Settings.
3Select the Cloak Files Ending With option and enter the file types to cloak in the box.
For example, you might enter .jpg to cloak all files with names ending in .jpg in your site.
Separate multiple file types with one space; do not use a comma or semicolon.
4Click OK.
A red line appears through the affected files, indicating that they are cloaked.
Some software creates backup files ending in a particular suffix, such as .bak. You can cloak such files.
Note: You can perform an operation on a specific cloaked folder by selecting the item in the Files panel and performing
an operation on it. Performing an operation directly on a file or folder overrides cloaking.
Uncloak specific file types within a site
1In the Files panel (Window > Files), select a site that has site cloaking enabled from the pop-up menu where the
current site, server, or drive appears.
2Right-click (Windows) or Control-click (Macintosh), then select Cloaking > Settings.
3In the Advanced Site Definition dialog box, do one of the following:
•Deselect the Cloak Files Ending With option to uncloak all the file types listed in the box.
•Delete specific file types from the box to uncloak those file types.
4Click OK.
The red lines disappear from the affected files, indicating that they are uncloaked.
Uncloak all folders and files
You can uncloak all folders and files in a site at the same time. This action cannot be undone; there is no way to
re-cloak all items that were previously cloaked. You have to re-cloak items individually.
If you want to temporarily uncloak all folders and files, then re-cloak those items, disable site cloaking.
1In the Files panel (Window > Files), select a select a site that has site cloaking enabled from the menu where the
current site, server, or drive appears.
2Select any file or folder in that site.
3Right-click (Windows) or Control-click (Macintosh), then select Cloaking > Uncloak All.
Note: This step also deselects the Cloak Files Ending With option in the Site > Cloaking > Settings.
The red lines through folder and file icons disappear, indicating that all files and folders in the site are uncloaked.
September 4, 2007
DREAMWEAVER CS3
User Guide
102
Storing file information in Design Notes
About Design Notes
Design Notes are notes that you create for a file. Design Notes are associated with the file they describe, but stored
in a separate file. You can see which files have Design Notes attached in the expanded Files panel: A Design Notes
icon appears in the Notes column.
You can use Design Notes to keep track of extra file information associated with your documents, such as image
source-filenames and comments on file status. For example, if you copy a document from one site to another, you
can add Design Notes for that document, with the comment that the original document is in the other site folder.
You can also use Design Notes to keep track of sensitive information that you can’t put inside a document for security
reasons, such as notes on how a particular price or configuration was chosen, or what marketing factors influenced
a design decision.
If you open a file in Adobe® Fireworks® or Flash, and export it to another format, Fireworks and Flash automatically
save the name of the original source file in a Design Notes file. For example, if you open myhouse.png in Fireworks
and export it to myhouse.gif, Fireworks creates a Design Notes file called myhouse.gif.mno. This Design Notes file
containsthenameoftheoriginalfile,asanabsolutefile: URL. So, the Design Notes for myhouse.gif might contain
the following line:
fw_source="file:///Mydisk/sites/assets/orig/myhouse.png"
A similar Flash Design Note might contain the following line:
fl_source="file:///Mydisk/sites/assets/orig/myhouse.fla"
Note: To share Design Notes, users should define the same site-root path (for example, sites/assets/orig).
When you import the graphic into Dreamweaver, the Design Notes file is automatically copied into your site along
with the graphic. When you select the image in Dreamweaver and choose to edit it using Fireworks, Fireworks opens
the original file for editing.
See also
“Start an external editor for media files” on page 271
Enable and disable Design Notes for a site
Design Notes are notes associated with a file, but stored in a separate file. Use Design Notes to keep track of extra file
information associated with your documents, such as image source-filenames and comments on file status.
You enable and disable Design Notes for a site in the Design Notes category of the Site Definition dialog box. When
you enable Design Notes, you can also choose to share them with others, if you want.
1Select Site > Manage Sites.
2In the Manage Sites dialog box, select a site, then click Edit.
3In the Advanced tab of the Site Definition dialog box, select Design Notes from the Category list on the left.
4Select Maintain Design Notes to enable Design Notes (deselect to disable them).
5If you want to delete all local Design Notes files for your site, click Clean Up, and then click Yes. (If you want to
delete remote Design Notes files, you’ll need to delete them manually).
September 4, 2007
DREAMWEAVER CS3
User Guide
103
Note: The Clean Up Design Notes command only deletes MNO (Design Notes) files. It does not delete the _notes folder
or the dwsync.xml file inside the _notes folder. Dreamweaver uses the dwsync.xml file to maintain information about
site synchronization.
6Select Upload Design Notes For Sharing to upload Design Notes associated with your site with the rest of your
documents and click OK.
•If you select this option, you can share Design Notes with the rest of your team. When you put or get a file,
Dreamweaver automatically puts or gets the associated Design Notes file.
•If you do not select this option, Dreamweaver maintains Design Notes locally but does not upload them with your
files. If you work alone on your site, deselecting this option improves performance. Design Notes will not be trans-
ferred to the remote site when you check in or put your files and you can still add and modify the Design Notes
for your site locally.
Associate Design Notes with files
You can create a Design Notes file for each document or template in your site. You can also create Design Notes for
applets, ActiveX controls, images, Flash content, Shockwave objects, and image fields in your documents.
Note: If you add Design Notes to a template file, documents you create with the template do not inherit the Design Notes.
1Do one of the following:
•Open the file in the Document window and select File > Design Notes.
•In the Files panel, right-click (Windows) or Control-click (Macintosh) the file, and select Design Notes.
Note: If the file resides in a remote site, you must first check out or get the file, and then select it in the local folder.
2In the Basic Info tab, select a status for the document from the Status menu.
3Click the date icon (above the Notes box) to insert the current local date in your notes.
4Type comments in the Notes box.
5Select Show When File Is Opened to make the Design Notes file appear every time the file is opened.
6In the All Info tab, click the Plus (+) button to add a new key-value pair; select a pair and click the Minus (–)
button to remove it.
For example, you might name a key Author (in the Name box) and define the value as Heidi (in the Value box).
7Click OK to save the notes.
Dreamweaver saves your notes to a folder called _notes, in the same location as the current file. The filename is the
document’s filename, plus the extension .mno. For example, if the filename is index.html, the associated Design
Notes file is named index.html.mno.
See also
“Getting and putting files to and from your server” on page 87
“Check files into and out of a remote folder” on page 93
Work with Design Notes
After you associate a Design Note with a file, you can open the Design Note, change its status, or delete it.
September 4, 2007
DREAMWEAVER CS3
User Guide
104
Open Design Notes associated with a file
❖Do one of the following to open the Design Notes:
•Open the file in the Document window, then select File > Design Notes.
•In the Files panel, right-click (Windows) or Control-click (Macintosh) the file, then select Design Notes.
•In the Notes column of the Files panel, double-click the yellow Design Notes icon.
Note: ToshowtheyellowDesignNotesicons,selectSite>ManageSites>[yoursitename]>Edit>FileViewColumns
on the Advanced tab. Select Notes in the list panel and choose the Show option. When you click the Expand button on
the Files toolbar to show both the local and remote site, you have a Notes column in your local site that shows a yellow
note icon for any file with a Design Note.
Assign a custom Design Notes status
1Open Design Notes for a file or object (see the previous procedure).
2Click the All Info tab.
3Click the Plus (+) button.
4In the Name field, enter the word status.
5In the Value field, enter the status.
If a status value already existed, it’s replaced with the new one.
6Click the Basic Info tab and note that the new status value appears in the Status pop-up menu.
Note: You can have only one custom value in the status menu at a time. If you follow this procedure again, Dreamweaver
replaces the status value you entered the first time with the new status value you enter.
Delete unassociated Design Notes from your site
1Select Site > Manage Sites.
2Select the site and click Edit.
3In the Site Definition dialog box, select Design Notes from the category list on the left.
4Click the Clean Up button.
Dreamweaver prompts you to verify that it should delete any Design Notes that are no longer associated with a file
in your site.
If you use Dreamweaver to delete a file that has an associated Design Notes file, Dreamweaver deletes the Design
Notes file too; so usually orphan Design Notes files occur only if you delete or rename a file outside of Dreamweaver.
Note: If you deselect the Maintain Design Notes option before you click Clean Up, Dreamweaver deletes all Design Notes
files for your site.
Testing your site
Site testing guidelines
Before uploading your site to a server and declaring it ready for viewing, it’s a good idea to test it locally. (In fact, it’s
a good idea to test and troubleshoot your site frequently throughout its construction—you can catch problems early
and avoid repeating them.)
September 4, 2007
DREAMWEAVER CS3
User Guide
105
You should make sure that your pages look and work as expected in the browsers you’re targeting, that there are no
broken links, and that the pages don’t take too long to download. You can also test and troubleshoot your entire site
by running a site report.
The following guidelines will help you create a good experience for visitors to your site:
1. Make sure your pages function in the browsers you’re targeting.
Your pages should be legible and functional in browsers that do not support styles, layers, plug-ins, or JavaScript. For
pages that fail badly in older browsers, consider using the Check Browser behavior to automatically redirect visitors
to another page.
2. Preview your pages in different browsers and platforms.
This gives you an opportunity to see differences in layout, color, font sizes, and default browser window size that
cannot be predicted in a target browser check.
3. Check your site for broken links and fix them.
Other sites undergo redesign and reorganization too, and the page you’re linking to may have been moved or deleted.
You can run a link check report to test your links.
4. Monitor the file size of your pages and the time they take to download.
Keep in mind that if a page consists of one large table, in some browsers, visitors will see nothing until the entire table
finishes loading. Consider breaking up large tables; if this is not possible, consider putting a small amount of
content—suchasawelcomemessageoranadvertisingbanner—outsidethetableatthetopofthepagesouserscan
view this material while the table downloads.
5. Run a few site reports to test and troubleshoot the entire site.
You can check your entire site for problems, such as untitled documents, empty tags, and redundant nested tags.
6. Validate your code to locate tag or syntax errors.
7. Update and maintain the site after its published.
Publishing your site—that is, making it live—can be accomplished in several ways and is an ongoing process. An
important part of the process is defining and implementing a version-control system, either with the tools
Dreamweaver includes or through an external version-control application.
8. Use the discussion forums.
The Dreamweaver discussion forums can be found on the Adobe website at
www.adobe.com/go/dreamweaver_newsgroup.
The forums are a great resource for getting information on different browsers, platforms, and so on. You can also
discuss technical issues and share helpful hints with other Dreamweaver users.
For a tutorial on troubleshooting publishing problems, see www.adobe.com/go/vid0164.
See also
“Fix broken links” on page 296
“Test links in Dreamweaver” on page 289
September 4, 2007
DREAMWEAVER CS3
User Guide
106
“Apply the Check Browser behavior” on page 351
“Validate tags” on page 328
“Check for browser compatibility” on page 328
Use reports to test your site
You can run site reports on workflow or HTML attributes, including accessibility, for the current document, selected
files, or the entire site. You can also use the Reports command to check links in your site.
Workflow reports can improve collaboration among members of a web team. You can run workflow reports that
display who has checked out a file, which files have Design Notes associated with them, and which files have been
modified recently. You can further refine Design Note reports by specifying name/value parameters.
Note: You must have a remote site connection defined to run the workflow reports.
HTML reports enable you to compile and generate reports for several HTML attributes. You can check combinable
nested font tags, accessibility, missing Alt text, redundant nested tags, removable empty tags, and untitled
documents.
Afteryourunareport,youcansaveitasanXMLfile,thenimportitintoatemplateinstanceoradatabaseorspread-
sheet and print it, or display it on a website.
Note: You can also add different report types to Dreamweaver through the Adobe Dreamweaver Exchange website.
See also
“Reports in Dreamweaver” on page 26
“Test links in Dreamweaver” on page 289
“Add and manage extensions in Dreamweaver” on page 710
Run reports to test a site
1Select Site > Reports.
If you want to run only an accessibility report for your site, you can select File > Check Page > Check Accessibility
and the report appears in the Site Reports panel of the Results panel group.
2Select what to report on from the Report On pop-up menu and set any of the report types to run (workflow or
HTML).
You cannot run a Selected Files In Site report unless you have already selected files in the Files panel.
3If you selected a workflow report, click Report Settings. Otherwise, skip this step.
Note: If you selected more than one workflow report, you need to click the Report Settings button for each report. Select
a report, click Report Settings, and enter settings; then, repeat the process for any other workflow reports.
Checked Out By Creates a report listing all documents checked out by a specific team member. Enter the name of a
team member, and then click OK to return to the Reports dialog box.
Design Notes Creates a report listing all Design Notes for selected documents or for the site. Enter one or more name
and value pairs, then select comparison values from the corresponding pop-up menus. Click OK to return to the
Reports dialog box.
Recently Modified Creates a report listing files that have changed during a specified time frame. Enter date ranges
and location for the files you want to view.
September 4, 2007
DREAMWEAVER CS3
User Guide
107
4If you selected an HTML report, select from the following reports:
Combinable Nested Font Tags Creates a report that lists all nested font tags that can be combined to clean up the
code.
For example, <font color="#FF0000"><font size="4">STOP!</font></font> is reported.
Missing Alt Text Creates a report listing all the img tags that don’t have alternate text.
Alternate text appears in place of images for text-only browsers or for browsers that have been set to download
imagesmanually.Screenreadersreadalternatetext,andsomebrowsersdisplayalternatetextwhentheusermouses
over the image.
Checked Out By Creates a report listing all documents checked out by a specific team member.
Accessibility Creates a report detailing conflicts between your content and the Section 508 accessibility guidelines
of the 1998 Rehabilitation Act.
Redundant Nested Tags Creates a report detailing nested tags that should be cleaned up.
For example, <i> The rain <i> in</i> Spain stays mainly in the plain</i> is reported.
Removable Empty Tags Creates a report detailing all empty tags that can be removed to clean up the HTML code.
Forexample,youmayhavedeletedanitemorimageinCodeview,butleftbehindthetagsthatappliedtothatitem.
Untitled Documents Creates a report listing all the untitled documents found within the selected parameters.
Dreamweaver reports all documents with default titles, duplicate titles, or missing title tags.
5Click Run to create the report.
Depending on the type of report you run, you might be prompted to save your file, define your site, or select a folder
(if you haven’t already done so).
A list of results appears in the Site Reports panel (in the Results panel group).
Use and save a report
1Run a report (see the previous procedure).
2In the Site Reports panel, do any of the following to view the report:
•Click the column heading you want to sort results by.
You can sort by filename, line number, or description. You can also run several different reports and keep the
different reports open.
•Select any line in the report, then click the More Info button on the left side of the Site Reports panel for an
description of the problem.
The information appears in the Reference panel.
•Double-click any line in the report to view the corresponding code in the Document window.
Note: If you are in Design view, Dreamweaver changes the display to split view to show the reported problem in code.
3Click Save Report to save the report.
Whenyousaveareport,youcanimportitintoanexistingtemplatefile.Youcanthenimportthefileintoadatabase
or spreadsheet and print it, or use the file to display the report on a website.
After running HTML reports, use the Clean Up HTML command to correct any HTML errors the reports listed.
September 4, 2007
108
Chapter 5: Managing assets and libraries
The Assets panel (in the same panel group as the Files panel), is the primary tool you use to organize your site assets,
including reusable pieces of content called library items.
About assets and libraries
About assets
You can use Adobe® Dreamweaver® CS3 to keep track of and preview assets stored in your site, such as images,
movies, colors, scripts, and links. You can also drag an asset directly to insert it in a page of the current document.
You obtain assets from various sources. For example, you might create assets in an application such as Adobe®
Fireworks® or Adobe® Flash®, receive them from a co-worker, or copy them from a clip-art CD or graphics website.
Dreamweaver also provides access to two special types of assets—libraries and templates. Both are linked assets:
when you edit a library item or template, Dreamweaver updates all documents that use those assets. Library items
generally represent small design assets, such as a site logo or copyright. To control a larger design area, use a template
instead.
See also
“About Dreamweaver templates” on page 387
About library items
Alibrary is a special Dreamweaver file containing a collection of individual assets or copies of assets that you can
place in your web pages. The assets in a library are called library items. Items that you can store in a library include
images, tables, sounds, and Flash files. You can automatically update all the pages that use a library item whenever
you edit the item.
For example, suppose you’re building a large site for a company that wants a slogan to appear on every page. You can
create a library item to contain the slogan and use that library item on every page. If the slogan changes, you can
change the library item and automatically update every page that uses it.
Dreamweaver stores library items in a Library folder within the local root folder for each site. Each site has its own
library.
You can create a library item from any element in the body sectionofadocument,includingtext,tables,forms,Java
applets, plug-ins, ActiveX elements, navigation bars, and images.
For linked items such as images, the library stores only a reference to the item. The original file must remain at the
specified location for the library item to work correctly.
It can still be useful to store an image in a library item, though. For example, you could store a complete img tag in
a library item, which would allow you to easily change the image’s alt text,orevenitssrc attribute, throughout the
site. (Don’t use this technique to change an image’s width and height attributes, though, unless you also use an
image editor to change the actual size of the image.)
September 4, 2007
DREAMWEAVER CS3
User Guide
109
Note: If the library item contains links, the links may not work in the new site. Also, images in a library item aren’t copied
to the new site.
When you use a library item, Dreamweaver inserts a link to it, rather than the item itself, in the web page. That is,
Dreamweaver inserts a copy of the HTML source code for that item into the document and adds an HTML comment
containing a reference to the original, external item. It is this external reference that makes automatic updating
possible.
When you create a library item that includes an element with a Dreamweaver behavior attached to it, Dreamweaver
copies the element and its event handler (the attribute that specifies which event triggers the action, such as onClick,
onLoad,oronMouseOver,andwhichactiontocallwhentheeventoccurs)tothelibraryitemfile.Dreamweaverdoes
not copy the associated JavaScript functions into the library item. Instead, when you insert the library item into a
document, Dreamweaver automatically inserts the appropriate JavaScript functions into the head section of that
document (if they aren’t already there).
Note: If you hand-code JavaScript (that is, if you create it without using Dreamweaver behaviors), you can make it part
of a library item if you use the Call JavaScript behavior to execute the code. If you don’t use a Dreamweaver behavior to
execute the code, the code isn’t retained as part of the library item.
There are special requirements for editing the behaviors in library items. Library items cannot contain style sheets,
because the code for those elements is part of the head section.
See also
“Edit a behavior in a library item” on page 119
Working with assets
Assets panel overview
Use the Assets panel (Window > Assets) to manage assets in the current site. The Assets panel displays assets for the
site associated with the active document in the Document window.
Note: You must define a local site before you can view assets in the Assets panel.
Asset panel with Site list displayed. Category icons are at left, and preview area is above list.
September 4, 2007
DREAMWEAVER CS3
User Guide
110
The Assets panel provides two ways to view assets:
Site list Shows all of the assets in your site, including colors and URLs that are used in any document in your site.
Favorites list Shows only the assets you’ve explicitly chosen.
To switch between these two views, select either the Site or Favorites radio button above the preview area. (These two
views are not available for the Templates and Library categories.)
Note: Most of the Assets panel operations work the same in both lists. There are a few tasks, however, that you can
perform only in the Favorites list.
In both lists, assets fall into one of the following categories:
Images Image files in GIF, JPEG, or PNG formats.
Colors Colors used in documents and style sheets, including colors of text, backgrounds, and links.
URLs External links in your current site documents, including FTP, gopher, HTTP, HTTPS, JavaScript, e-mail
(mailto), and local file (file://) links.
Flash Files in any version of Adobe Flash. The Assets panel displays only SWF files (compressed Flash files), but
not FLA (Flash source) files.
Shockwave Files in any version of Adobe Shockwave.
Movies QuickTime or MPEG files.
Scripts JavaScript or VBScript files. Scripts in HTML files (rather than in independent JavaScript or VBScript
files) do not appear in the Assets panel.
Templates Master page layouts used on multiple pages. Modifying a template automatically modifies all pages
attached to it.
Library items Design elements that you use in multiple pages; when you modify a library item, all pages
containing that item are updated.
Note: ToappearintheAssetspanel,afilemustfallintooneofthesecategories.Someothertypesoffilesaresometimes
called assets, but they aren’t shown in the panel.
By default, assets in a category are listed alphabetically by name, but you can sort them by type and several other
criteria. You can also preview assets and resize the columns and the preview area.
See also
“Creating and managing a list of favorite assets” on page 114
“Working with library items” on page 116
“Set up and edit a local root folder” on page 42
View an asset in the preview area
❖Select the asset in the Assets panel.
For example, when you select a movie asset, the preview area shows an icon. To view the movie, click the Play button
(the green triangle) in the upper-right corner of the preview area.
Display assets in a category
❖Click a category icon on the left side of the Assets panel.
September 4, 2007
DREAMWEAVER CS3
User Guide
111
Sort assets
❖Click a column heading.
For example, to sort the list of images by type (so that all the GIF images are together, all the JPEG images are
together, and so on), click the Type column heading.
Resize a column
❖Drag the line separating two column headings.
Resize the preview area
❖Drag the splitter bar (between the preview area and the list of assets) up or down.
Refresh the Assets panel
It can take a few seconds to create the Site list because Dreamweaver must first read the site cache.
Certain changes don’t appear immediately in the Assets panel. For instance, when you add or remove an asset from
your site, the changes don’t appear in the Assets panel until you refresh the Site list by clicking the Refresh Site List
button. If you add or remove an asset outside Dreamweaver—using Windows Explorer or the Finder, for example—
you must rebuild the site cache to update the Assets panel.
When you remove the only instance of a particular color or URL in your site, or when you save a new file that
contains a color or URL that isn’t already used in the site, the changes don’t appear in the Assets panel until you
refresh the Site list.
•To refresh the Site list manually, click the Refresh Site List button . Dreamweaver creates the site cache or
updates it as necessary.
•To refresh the Site list and manually rebuild the site cache, right-click (Windows) or Command-click (Macintosh)
in the Assets list, then select Refresh Site List.
Add an asset to a document
You can insert most assets into a document by dragging them into the Code view or Design view in the Document
window, or by using the Insert button in the panel. You can either insert colors and URLs or apply them to selected
text in the Design view. (URLs can also be applied to other elements in the Design view, such as images.)
1In Design view, place the insertion point where you want the asset to appear.
2In the Assets panel, select from the asset category buttons at the left.
Note: Select any category except Templates. A template is applied to an entire document; it can’t be inserted into a
document.
3Select either Site or Favorites at the top of the panel, then select the asset.
There are no Site or Favorites lists for library items; skip this step if you’re inserting a library item.
4Do one of the following:
•Drag the asset from the panel to the document.
You can drag scripts into the head content area of the Document window; if that area isn’t visible, select View > Head
Content.
•Select the asset in the panel and click Insert.
If the inserted asset is a color, it applies to text appearing after the insertion point.
September 4, 2007
DREAMWEAVER CS3
User Guide
112
Apply a color to text using the Assets panel
The Assets panel shows the colors you’ve already applied to various elements, such as text, table borders,
backgrounds, and so on.
1Select the text in the document.
2In the Assets panel, select the Colors category .
3Select the desired color and click Apply.
See also
“Add or remove favorite assets” on page 114
Apply a URL to an image or text using the Assets panel
1Select the text or image.
2In the Assets panel, select the URLs category in either the Sites or Favorites view, depending on where the
URL is stored.
Note: URLs for your site’s files are stored in the Sites view by default. The Favorites view holds URLs that you have added
yourself.
3Select the URL.
4Do one of the following:
•Drag the URL from the panel to the selection in the Design view.
•Select the URL, then click Apply.
Select and edit assets
The Assets panel allows you to select multiple assets at once. It also provides a quick way to begin editing assets.
See also
“Start an external editor for media files” on page 271
Select multiple assets
1In the Assets panel, select an asset.
2Select the other assets in one of the following ways:
•Shift-click to select a consecutive series of assets.
•Control-click (Windows) or Command-click (Macintosh) to add an individual asset to the selection (whether or
not it’s adjacent to the existing selection). Control-click or Command-click a selected asset to deselect it.
September 4, 2007
DREAMWEAVER CS3
User Guide
113
Edit an asset
When you edit an asset in the Assets panel, the behavior varies according to the asset type. For some assets, such as
images, you use an external editor, which opens automatically if you have defined an editor for that asset type. You
can edit colors and URLs in the Favorites list only. When you edit templates and library items, you make the changes
within Dreamweaver.
1In the Assets panel, do one of the following:
•Double-click the asset.
•Select the asset, then click the Edit button .
Note: If the asset must be edited in an external editor and one doesn’t open automatically, select Edit > Preferences
(Windows) or Dreamweaver > Preferences (Macintosh), select the File Types/Editors category, and make sure you have
defined an external editor for that asset type.
2Make your changes.
3When you finish, do one of the following:
•If the asset is file-based (anything other than a color or URL), save it (in the editor you used), and close it.
•If the asset is a URL, click OK in the Edit URL dialog box.
Note: If the asset is a color, the color picker closes automatically after you pick a color. To dismiss the color picker without
picking a color, press Esc.
Reuse assets in another site
The Assets panel shows all the assets (of recognized types) in your current site. To use an asset from the current site
in another site, you must copy it to the other site. You can copy an individual asset, a set of individual assets, or an
entire Favorites folder at once.
You may need to locate the file in the Files panel that corresponds to an asset in the Assets panel before you transfer
the asset to or from your remote site.
Note: The Files panel might show a different site from the one that the Assets panel shows. This is because the Assets
panel is associated with the active document.
Locate an asset file in the Files panel
1In the Assets panel, select the category of the asset you want to find.
2Right-click (Windows) or Control-click (Macintosh) the asset’s name or icon in the Assets panel, then select
Locate In Site from the context menu.
Note: Locate In Site is unavailable for colors and URLs, which do not correspond to files in the site.
TheFilespanelopens,withtheassetfileselected.TheLocateInSitecommandlocatesthefilecorrespondingtothe
asset itself; it does not locate files that use that asset.
Copy assets from the Asset panel to another site
1In the Assets panel, select the category of the asset you want to copy.
2Right-click (Windows) or Control-click (Macintosh) one or more assets in either the Site list or Favorites list,
select Copy To Site, and select the target site name from the submenu listing all the sites you’ve defined.
Note: In the Favorites list, you can copy a Favorites folder as well as individual assets.
September 4, 2007
DREAMWEAVER CS3
User Guide
114
The assets are copied to their corresponding locations in the target site. Dreamweaver creates new folders in the
target site’s hierarchy as needed. The assets are also added to the target site’s Favorites list.
Note: If the asset you copied is a color or a URL, it appears only in the target site’s Favorites list. Because colors and URLs
don’t correspond to files, there’s no file to copy into the other site.
Creating and managing a list of favorite assets
Managing favorite assets
The complete list of all recognized assets list can become cumbersome for some large sites. You can add frequently
used assets to a Favorites list, group related assets together, give them nicknames to remind yourself what they’re for,
and find them easily in the Assets panel.
Note: Favorite assets are not stored as separate files on your disk; they’re references to the assets in the Site list.
Dreamweaver keeps track of which assets from the Site list to display in the Favorites list.
Most of the operations of the Assets panel are the same in the Favorites list as in the Site list. However, there are
several tasks that you can perform only in the Favorites list.
Add or remove favorite assets
There are several ways to add assets to your site’s Favorites list in the Assets panel.
Adding a color or URL to the Favorites list requires an extra step. You can’t add new colors or URLs to the Site list;
the Site list contains only assets that are already in use in your site.
Note: There are no Favorites lists for templates and library items.
See also
“Assets panel overview” on page 109
“Use the color picker” on page 223
Add assets to the Favorites list
Do one of the following:
•Select one or more assets in the Site list of the Assets panel, then click the Add To Favorites button .
•Select one or more assets in the Site list of the Assets panel, right-click (Windows) or Control-click (Macintosh),
then select Add To Favorites.
•Select one or more files in the Files panel, right-click (Windows) or Control-click (Macintosh), then select Add To
Favorites. Dreamweaver ignores files that don’t correspond to a category in the Assets panel.
•Right-click (Windows) or Control-click (Macintosh) an element in the Document window’s Design view, then
select the context menu command to add the element to a Favorites category.
The context menu for text contains either Add To Color Favorites or Add To URL Favorites, depending on whether
the text has a link attached. You can add only those elements that match one of the categories in the Assets panel.
Add a new color or URL to the Favorites list
1In the Assets panel, select the Colors or URLs category.
September 4, 2007
DREAMWEAVER CS3
User Guide
115
2Select the Favorites option at the top of the panel.
3Click the New Color or New URL button .
4Do one of the following:
•Select a color using the color picker, then give the color a nickname if desired.
To close the color picker without selecting a color, press Esc or click the gray bar at the top of the color picker.
•Enter a URL and a nickname in the Add New URL dialog box, then click OK.
Remove assets from the Favorites list
1In the Assets panel, select the Favorites option at the top of the panel.
2Select one or more assets (or a folder) in the Favorites list.
3Click the Remove From Favorites button .
TheassetsareremovedfromtheFavoriteslist,butnotfromtheSitelist.IfyouremoveaFavoritesfolder,thefolder
and all its contents are removed.
Create a nickname for a favorite asset
You can give nicknames (for instance, PageBackgroundColor rather than #999900) to assets only in the Favorites list.
The Site list retains their real filenames (or values, in the case of colors and URLs).
1In the Assets panel (Window > Assets), select the category that contains your asset.
2Select the Favorites option at the top of the panel.
3Do one of the following:
•Right-click (Windows) or Control-click (Macintosh) the asset’s name or icon in the Assets panel, then select Edit
Nickname.
•Click the asset’s name once, pause, then click it again. (Do not double-click; double-clicking opens the item for
editing.)
4Type a nickname for the asset, then press Enter (Windows) or Return (Macintosh).
See also
“Assets panel overview” on page 109
Group assets in a Favorites folder
Placing an asset in Favorites folder does not change the location of the asset’s file on your disk.
1In the Assets panel, select the Favorites option at the top of the panel.
2Click the New Favorites Folder button .
3Type a name for the folder, then press Enter (Windows) or Return (Macintosh).
4Drag assets into the folder.
September 4, 2007
DREAMWEAVER CS3
User Guide
116
Working with library items
Create a library item
Library items are elements that you want to reuse or update frequently throughout your website.
See also
“About library items” on page 108
Create a library item based on a selection
1In the Document window, select a portion of a document to save as a library item.
2Do one of the following:
•Drag the selection into the Library category .
•Click the New Library Item button at the bottom of the Library category.
•Select Modify > Library > Add Object To Library.
3Type a name for the new library item, then press Enter (Windows) or Return (Macintosh).
Dreamweaver saves each library item as a separate file (with the file extension .lbi) in the Library folder of the site’s
local root folder.
Create an empty library item
1Make sure nothing is selected in the Document window.
If something is selected, it will be placed in the new library item.
2In the Assets panel, select the Library category .
3Click the New Library Item button at the bottom of the panel.
4While the item is still selected, enter a name for it, then press Enter (Windows) or Return (Macintosh).
Insert a library item into a document
When you add a library item to a page, the actual content is inserted in the document along with a reference to the
library item.
1Place the insertion point in the Document window.
2In the Assets panel, select the Library category .
3Do one of the following:
•Drag a library item from the Assets panel to the Document window.
To insert the contents of a library item without including a reference to the item in the document, press Control
(Windows) or Option (Macintosh) while dragging an item out of the Assets panel. If you insert an item this way, you
can edit the item in the document, but the document won’t be updated when you update pages that use that library item.
•Select a library item, and click Insert.
September 4, 2007
DREAMWEAVER CS3
User Guide
117
Edit library items and update documents
When you edit a library item, you can update all documents that use that item. If you choose not to update, the
documents remain associated with the library item; you can update them later.
You can rename items to break their connection with documents or templates, delete items from the site’s library,
and recreate a missing library item.
Note: The CSS Styles panel is unavailable as you edit a library item, because library items can contain only body
elements and Cascading Style Sheets (CSS) code is inserted in the head section of a document. The Page Properties
dialog box is also unavailable, because a library item can’t include a body tag or its attributes.
Edit a library item
1In the Assets panel, select the Library category .
2Select a library item.
3Either Click the Edit button or double-click the library item.
Dreamweaver opens a new window, similar to the Document window, for editing the library item. The gray
background indicates that you’re editing a library item instead of a document.
4Make and then save your changes.
5Specify whether to update the documents on the local site that use the library item. Select Update to update
immediately. If you select Don’t Update, documents won’t be updated until you choose Modify > Library > Update
Current Page or Update Pages.
Update the current document to use the current version of all library items
❖Select Modify > Library > Update Current Page.
Update the entire site or all documents that use a particular library item
1Select Modify > Library > Update Pages.
2In the Look In pop-up menu, specify what to update:
•To update all pages in the selected site to use the current version of all library items, Select Entire Site, then select
the site name from the adjacent pop-up menu.
•To update all pages in the current site that use the library item, Select Files That Use, then select a library item
name from the adjacent pop-up menu.
3Make sure that Library Items is selected in the Update option.
To update templates at the same time, select Templates as well.
4Click Start.
Dreamweaver updates the files as indicated. If you selected the Show Log option, Dreamweaver generates a report
showing whether files were updated successfully, along with other information.
Rename a library item
1In the Assets panel, select the Library category .
2Select the library item, pause, and then click again. (Do not double-click; double-clicking opens the item for
editing.)
3Enter a new name.
September 4, 2007
DREAMWEAVER CS3
User Guide
118
4Click elsewhere, or press Enter (Windows) or Return (Macintosh).
5Specify whether to update documents that use the item by choosing either Update or Don’t Update.
Delete a library item from a library
When you delete a library item, Dreamweaver removes it from the library but doesn’t change the contents of any
documents that use the item.
1In the Assets panel, select the Library category .
2Select the library item.
3Either click the Delete button or press the Delete key, then confirm that you want to delete the item.
Important: If you delete a library item, you can’t use Undo to retrieve it. You may be able to recreate it, however.
Recreate a missing or deleted library item
1Select an instance of the item in one of your documents.
2Click the Recreate button in the Property inspector (Window > Properties).
Customize highlighting of library items
You can customize the highlight color of library items and show or hide highlighting by setting Highlighting prefer-
ences.
See also
“Use the color picker” on page 223
Change the highlight color of library items
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select the Highlighting category from the list on the left of the Preferences dialog box.
3Click the Library Items color box, then select a highlight color using the color picker (or enter the hexadecimal
color value in the text box).
4Select Show to display the highlight color in the Document window.
5Click OK.
To show or hide highlighting in the Document window
❖To show highlighting, select View > Visual Aids > Invisible Elements. To hide highlighting, deselect Invisible
Elements.
Edit the properties of a library item
You can use the Property inspector to open a library item for editing, detach a selected library item from its source
file, or overwrite an item with the currently selected library item.
1Select a library item in a document.
2Select one of these options in the Property inspector (Window > Properties):
Src Displays the filename and location of the source file for the library item. You can’t edit this information.
September 4, 2007
DREAMWEAVER CS3
User Guide
119
Open Opens the library item’s source file for editing. This is equivalent to selecting the item in the Assets panel and
clicking the Edit button.
Detach From Original Breaks the link between the selected library item and its source file. You can edit the detached
item in the document, but it’s no longer a library item and isn’t updated when you change the original.
Recreate Overwrites the original library item with the current selection. Use this option to re-create library items if
the original library item is missing or has been accidentally deleted.
Make library items editable in a document
If you’ve added a library item to your document and you want to edit the item specifically for that page, you must
break the link between the item in the document and the library. Once you’ve made an instance of a library item
editable, that instance isn’t updated when the library item changes.
1Select a library item in the current document.
2Click Detach From Original in the Property inspector (Window > Properties).
Edit a behavior in a library item
To edit a behavior in a library item, you must first insert the item in a document, then make the item editable in that
document. After you’ve made the changes, you can re-create the library item, replacing the item in the library with
the edited item from your document.
1Open a document that contains the library item.
Note the name of the library item, as well as the exact tags it contains. You’ll need this information later.
2Select the library item, and then click Detach From Original in the Property inspector (Window > Properties).
3Select the element that has the behavior attached to it.
4In the Behaviors panel (Window > Behaviors), double-click the action you want to change.
5In the dialog box that appears, make your changes, then click OK.
6In the Assets panel, select the Library category .
7Record the exact name and capitalization of the original library item; select it, then click the Delete button.
8In the Document window, select all the elements that make up the library item.
Be careful to select exactly the same elements that were in the original library item.
9IntheAssetspanel,clicktheNewLibraryItembutton ,thengivethenewitemthesamenameastheitemyou
deleted, using the same spelling and capitalization.
10 To update the library item in your site’s other documents, select Modify > Library > Update Pages.
11 In the Look In pop-up menu, select Files That Use.
12 In the adjacent pop-up menu, select the name of the library item you just created.
13 In the Update option, make sure Library Items is selected, then click Start.
14 When the updates are complete, click Close.
See also
“Using JavaScript behaviors” on page 336
September 4, 2007
120
Chapter 6: Creating pages with CSS
Adobe® Dreamweaver® CS3 includes many features that help you use Cascading Style Sheets (CSS) to create styles
and layouts for your web pages.
Understanding Cascading Style Sheets
About Cascading Style Sheets
Cascading Style Sheets (CSS) is a collection of formatting rules that control the appearance of content in a web page.
Using CSS styles to format a page separates content from presentation. The content of your page—the HTML code—
resides in the HTML file, and the CSS rules defining the presentation of the code reside in another file (an external
style sheet) or in another part of the HTML document (usually the head section). Separating content from presen-
tation makes it much easier to maintain the appearance of your site from a central location because you don’t need
to update every property on every page whenever you want to make a change. Separating content from presentation
also results in simpler and cleaner HTML code, which provides shorter browser loading times, and simplifies
navigation for people with accessibility issues (for example, those using screen readers).
CSS gives you great flexibility and control over the exact appearance of your page. With CSS you can control many
text properties including specific fonts and font sizes; bold, italics, underlining, and text shadows; text color and
background color; link color and link underlining; and much more. By using CSS to control your fonts, you can also
ensure a more consistent treatment of your page layout and appearance in multiple browsers.
In addition to text formatting, you can use CSS to control the format and positioning of block-level elements in a
web page. A block-level element is a standalone piece of content, usually separated by a new line in the HTML, and
visually formatted as a block. For example, h1 tags, p tags, and div tags all produce block-level elements on a web
page. You can set margins and borders for block-level elements, position them in a specific location, add background
color to them, float text around them, and so on. Manipulating block-level elements is in essence the way you lay out
pages with CSS.
For a tutorial on understanding Cascading Style Sheets, see www.adobe.com/go/vid0152.
See also
“Working with div tags” on page 162
“Laying out pages with CSS” on page 145
About CSS rules
A CSS formatting rule consists of two parts—the selector and the declaration (or in most cases, a block of declara-
tions). The selector is a term (such as p,h1,a class name, or an id) that identifies the formatted element, and the decla-
ration block defines what the style properties are. In the following example, h1 is the selector, and everything that
falls between the braces ({}) is the declaration block:
September 4, 2007
DREAMWEAVER CS3
User Guide
121
h1 {
font-size: 16 pixels;
font-family: Helvetica;
font-weight:bold;
}
An individual declaration consists of two parts, the property (such as font-family)andvalue(suchasHelvetica).
In the previous CSS rule, a particular style has been created for h1 tags: the text for all h1 tags linked to this style will
be 16 pixels in size, Helvetica font, and bold.
The style (which comes from a rule, or a collection of rules) resides in a place separate from the actual text it’s
formatting—usually in an external style sheet, or in the head portion of an HTML document. Thus, one rule for h1
tags can apply to many tags at once (and in the case of external style sheets, the rule can apply to many tags at once
on many different pages). In this way, CSS provides extremely easy update capability. When you update a CSS rule
in one place, the formatting of all the elements that use the defined style are automatically updated to the new style.
You can define the following types of styles in Dreamweaver:
•Class styles let you apply style properties to any element or elements on the page.
•HTML tag styles redefine the formatting for a particular tag, such as h1. When you create or change a CSS style
for the h1 tag, all text formatted with the h1 tag is immediately updated.
•Advanced styles redefine the formatting for a particular combination of elements, or for other selector forms as
allowed by CSS (for example, the selector td h2 applies whenever an h2 header appears inside a table cell.)
Advanced styles can also redefine the formatting for tags that contain a specific id attribute (for example, the styles
defined by #myStyle apply to all tags that contain the attribute-value pair id="myStyle").
CSS rules can reside in the following locations:
External CSS style sheets Collections of CSS rules stored in a separate, external CSS (.css) file (not an HTML file).
This file is linked to one or more pages in a website using a link or an @import rule in the head section of a document.
Internal (or embedded) CSS style sheets Collections of CSS rules included in a style tag in the head portion of an
HTML document.
Inline styles Defined within specific instances of tags throughout an HTML document. (Using Inline styles is not
recommended.)
Dreamweaver recognizes styles defined in existing documents as long as they conform to CSS style guidelines.
Dreamweaver also renders most applied styles directly in Design view. (Previewing the document in a browser
window, however, gives you the most accurate “live” rendering of the page.) Some CSS styles are rendered differently
in Microsoft Internet Explorer, Netscape, Opera, Apple Safari, or other browsers, and some are not currently
supported by any browser.
September 4, 2007
DREAMWEAVER CS3
User Guide
122
To display the O’Reilly CSS reference guide included with Dreamweaver, select Help > Reference and select O’Reilly
CSS Reference from the pop-up menu in the Reference panel.
See also
“Apply, remove, or rename class styles” on page 136
About cascading styles
The term cascading refers to the way a browser ultimately displays styles for specific elements on a web page. Three
differentsourcesareresponsibleforthestylesyouseeonawebpage:thestylesheetcreatedbytheauthorofthepage,
the user’s customized style selections (if any), and the default styles of the browser itself. The previous topics describe
creating styles for a web page as the author of both the web page and the style sheet attached to that page. But
browsers also have their own default style sheets that dictate the rendering of web pages, and in addition to that, users
can customize their browsers by making selections that adjust the display of web pages. The final appearance of a
web page is the result of the rules of all three of these sources coming together (or “cascading”) to render the web
page in an optimal way.
A common tag—the paragraph tag, or <p> tag—illustrates the concept. By default, browsers come with style sheets
that define the font and font size for paragraph text (that is, text that falls between <p> tags in the HTML code). In
Internet Explorer, for example, all body text, including paragraph text, displays in Times New Roman, Medium font
by default.
As the author of a web page, however, you can create a style sheet that overrides the browser’s default style for
paragraph font and font size. For example, you can create the following rule in your style sheet:
p {
font-family: Arial;
font-size: small;
}
When a user loads the page, the paragraph font and font size settings set by you as the author override the default
paragraph text settings of the browser.
Users can make selections to customize the browser display in an optimal way for their own use. In Internet Explorer,
for example, the user can select View > Text Size > Largest to expand the page font to a more readable size if they
think the font is too small. Ultimately (at least in this case), the user’s selection overrides both the default browser
styles for paragraph font size and the paragraph styles created by the author of the web page.
Inheritance is another important part of the cascade. Properties for most elements on a web page are inherited—for
example, paragraph tags inherit certain properties from body tags, bullet list tags inherit certain properties from
paragraph tags, and so on. Thus, if you create the following rule in your style sheet:
body {
font-family: Arial;
font-style: italic;
}
All paragraph text on your web page (as well as text that inherits properties from the paragraph tag) will be Arial and
italic because the paragraph tag inherits these properties from the body tag. You can, however, become more specific
with your rules, and create styles that override the standard formula for inheritence. For example, if you create the
following rules in your style sheet:
September 4, 2007
DREAMWEAVER CS3
User Guide
123
body {
font-family: Arial;
font-style: italic;
}
p {
font-family: Courier;
font-style: normal;
}
AllbodytextwillbeArialanditalicexcept paragraph (and its inherited) text, which will display as Courier normal
(non-italic). Technically, the paragraph tag first inherits the properties that are set for the body tag, but then ignores
those properties because it has properties of its own defined. In other words, while page elements generally inherit
properties from above, the direct application of a property to a tag always causes an override of the standard formula
for inheritance.
The combination of all of the factors discussed above, plus other factors like CSS specificity (a system that gives
different weight to particular kinds of CSS rules), and the order of CSS rules, ultimately create a complex cascade
where items with higher priorities override properties that have lower priorities. For more information on the rules
governing the cascade, inheritance, and specificity, visit www.w3.org/TR/CSS2/cascade.html.
About text formatting and CSS
By default, Dreamweaver uses Cascading Style Sheets (CSS) to format text. The styles that you apply to text using the
Property inspector or menu commands create CSS rules that are embedded in the head of the current document.
You can also use the CSS Styles panel to create and edit CSS rules and properties. The CSS Styles panel is a much
more robust editor than the Property inspector, and displays all CSS rules defined for the current document, whether
thoserulesareembeddedintheheadofthedocumentorinanexternalstylesheet.Adoberecommendsthatyouuse
the CSS Styles panel (rather than the Property inspector) as the primary tool for creating and editing your CSS. As
a result, your code will be cleaner and easier to maintain.
In addition to styles and style sheets you create, you can use style sheets that come with Dreamweaver to apply styles
to your documents.
For a tutorial about formatting text with CSS, see www.adobe.com/go/vid0153.
See also
“Adding and formatting text” on page 226
“About the CSS Styles panel” on page 124
“Create a new CSS rule” on page 129
About Shorthand CSS properties
The CSS specification allows for the creation of styles using an abbreviated syntax known as shorthand CSS.
Shorthand CSS lets you specify the values of several properties using a single declaration. For example, the font
property lets you set font-style,font-variant,font-weight,font-size,line-height, and font-family
properties on a single line.
A key issue to note when using shorthand CSS, is that values omitted from a shorthand CSS property are assigned
their default value. This may cause pages to be incorrectly displayed when two or more CSS rules are assigned to the
same tag.
September 4, 2007
DREAMWEAVER CS3
User Guide
124
For example, the h1 rule shown below uses longhand CSS syntax. Note that the font-variant,font-stretch,
font-size-adjust, and font-style properties have been assigned their default values.
h1 {
font-weight: bold;
font-size: 16pt;
line-height: 18pt;
font-family: Arial;
font-variant: normal;
font-style: normal;
font-stretch: normal;
font-size-adjust: none
}
Rewritten as a single, shorthand property, the same rule might appear as follows:
h1 { font: bold 16pt/18pt Arial }
When written using shorthand notation, omitted values are automatically assigned their default values. Thus, the
previous shorthand example omits the font-variant,font-style,font-stretch,andfont-size-adjust tags.
Ifyouhavestylesdefinedinmorethanonelocation(forexample,bothembeddedinanHTMLpageandimported
from an external style sheet) using both the short and long forms of CSS syntax, be aware that omitted properties in
a shorthand rule may override (or cascade) properties that are explicitly set in another rule.
For this reason, Dreamweaver uses the long form of CSS notation by default. This prevents possible problems caused
by a shorthand rule overriding a longhand rule. If you open a web page that was coded with shorthand CSS notation
in Dreamweaver, be aware that Dreamweaver will create any new CSS rules using the longhand form. You can specify
how Dreamweaver creates and edits CSS rules by changing the CSS editing preferences in the CSS Styles category of
the Preferences dialog box (Edit > Preferences in Windows; Dreamweaver > Preferences on the Macintosh).
Note: The CSS Styles panel creates rules using only longhand notation. If you create a page or CSS style sheet using the
CSS Styles panel, be aware that hand coding shorthand CSS rules may result in the shorthand properties overriding those
created in longhand form. For this reason, use longhand CSS notation to create your styles.
Creating and managing CSS
About the CSS Styles panel
The CSS Styles panel lets you track the CSS rules and properties affecting a currently selected page element (Current
mode), or all of the rules and properties that are available to the document (All mode). A toggle button at the top of
panel lets you switch between the two modes. The CSS Styles panel also lets you modify CSS properties in both All
and Current mode.
See the next two sections for information about the CSS Styles panel in Current and All modes.
September 4, 2007
DREAMWEAVER CS3
User Guide
125
The CSS Styles panel in Current mode
In Current mode, the CSS Styles panel displays three panes: a Summary for Selection pane that displays the CSS
properties for the current selection in the document, a Rules pane that displays the location of selected properties
(or a cascade of rules for the selected tag, depending on your selection), and a Properties pane that lets you edit CSS
properties for the rule applied to the selection.
You can resize any of the panes by dragging the borders between the panes, and can resize columns by dragging
dividers.
The Summary for Selection pane displays a summary of CSS properties and their values for the item currently
selected in the active document. The summary shows the properties for all rules that directly apply to the selection.
Only set properties are shown.
For example, the following rules create a class style and a tag (in this case paragraph) style:
.foo{
color: green;
font-family: ‘Arial’;
}
p{
font-family: ‘serif’;
font-size: 12px;
}
When you select paragraph text with a class style of .foo in the Document window, the Summary for Selection pane
displays the relevant properties for both rules, because both rules apply to the selection. In this case, the Summary
for Selection pane would list the following properties:
font-size: 12px
font-family: ‘Arial’
color: green
September 4, 2007
DREAMWEAVER CS3
User Guide
126
The Summary for Selection pane arranges properties in increasing order of specificity. In the above example, the tag
style defines the font size and the class style defines the font family and the color. (The font family defined by the
class style overrides the font family defined by the tag style because class selectors have higher specificity than tag
selectors. For more information on CSS specificity, see www.w3.org/TR/CSS2/cascade.html.)
The Rules pane displays two different views—About view or Rules view—depending on your selection. In About
view (the default view), the pane displays the name of the rule that defines the selected CSS property, and the name
of the file containing the rule. In Rules view, the pane displays a cascade, or hierarchy, of all rules that apply directly
or indirectly to the current selection. (The tag to which the rule directly applies appears in the right column.) You
can toggle between the two views by clicking the Show Information and Show Cascade buttons in the upper-right
corner of the Rules pane.
When you select a property in the Summary for Selection pane, all of the properties for the defining rule appear in
the Properties pane. (The defining rule is also selected in the Rules pane, if Rules view is selected.) For example, if
you have a rule called .maintext thatdefinesafontfamily,fontsize,andcolor,thenselectinganyofthoseproperties
in the Summary for Selection pane will display all of the properties defined by the .maintext rule in the Properties
pane, as well as the selected .maintext rule in the Rules pane. (Additionally, selecting any rule in the Rules pane
displays that rule’s properties in the Properties pane.) You can then use the Properties pane to quickly modify your
CSS, whether it is embedded in the current document or linked by means of an attached style sheet. By default, the
Properties pane shows only those properties that have already been set, and arranges them in alphabetical order.
You can choose to display the Properties pane in two other views. Category view displays properties grouped into
categories, such as Font, Background, Block, Border, and so on, with set properties at the top of each category,
displayed in blue text. List view displays an alphabetical list of all available properties, and likewise sorts set
propertiestothetop,displayingtheminbluetext.Toswitchbetweenviews,clicktheShowCategoryView,ShowList
View, or Show Only Set Properties button, located at the lower-left corner of the Properties pane.
In all views, set properties are displayed in blue; properties irrelevant to a selection are displayed with a red strike-
through line. Holding the mouse over a rule that is irrelevant displays a message explaining why the property is irrel-
evant. Typically a property is irrelevant because it’s overridden or not an inherited property.
Any changes you make in the Properties pane are applied immediately, letting you preview your work as you go.
See also
“Open the CSS Styles panel” on page 128
September 4, 2007
DREAMWEAVER CS3
User Guide
127
The CSS Styles panel in All mode
In All mode, the CSS Styles panel displays two panes: an All Rules pane (on top), and a Properties pane (on bottom).
The All Rules pane displays a list of rules defined in the current document as well as all rules defined in style sheets
attached to the current document. The Properties pane lets you edit CSS properties for any selected rule in the All
Rules pane.
You can resize either pane by dragging the border between the panes, and can resize the Properties columns by
dragging their divider.
When you select a rule in the All Rules pane, all of the properties that are defined in that rule appear in the Properties
pane. You can then use the Properties pane to quickly modify your CSS, whether it is embedded in the current
document or linked in an attached style sheet. By default, the Properties pane shows only those properties that have
been previously set, and arranges them in alphabetical order.
You can choose to display properties in two other views. Category view displays properties grouped into categories,
such as Font, Background, Block, Border, and so on, with set properties at the top of each category. List view displays
an alphabetical list of all available properties, and likewise sorts set properties to the top. To switch between views,
click the Show Category View, Show List View, or Show Only Set Properties button, located at the lower-left corner
of the Properties pane. In all views, set properties are displayed in blue.
Any changes you make in the Properties pane are applied immediately, letting you preview your work as you go.
See also
“Open the CSS Styles panel” on page 128
CSS Styles panel buttons and views
In both All and Current modes, the CSS Styles panel contains three buttons that let you alter the view in the
Properties pane (the bottom pane):
September 4, 2007
DREAMWEAVER CS3
User Guide
128
A. Category View B. List View C. Set Properties View
Category View Divides the Dreamweaver-supported CSS properties into eight categories: font, background, block,
border, box, list, positioning, and extensions. Each category’s properties are contained in a list that you expand or
collapse by clicking the Plus (+) button next to the category name. Set properties appear (in blue) at the top of the list.
List View Displays all of the Dreamweaver-supported CSS properties in alphabetical order. Set properties appear (in
blue) at the top of the list.
Set Properties View Displays only those properties that have been set. Set Properties view is the default view.
In both All and Current modes, the CSS Styles panel also contains the following buttons:
A. Attach Style Sheet B. New CSS Rule C. Edit Style D. Delete CSS rule
Attach Style Sheet Opens the Link External Style Sheet dialog box. Select an external style sheet to link to or import
into your current document.
New CSS Rule Opens a dialog box in which you can select the type of style you’re creating—for example, to create a
class style, redefine an HTML tag, or to define a CSS selector.
Edit Style Opens a dialog box in which you can edit the styles in the current document or in an external style sheet.
Delete CSS Rule Removes the selected rule or property from the CSS Styles panel, and removes the formatting from
any element to which it was applied. (It does not, however, remove class or ID properties referenced by that style).
The Delete CSS Rule button can also detach (or “unlink”) an attached CSS style sheet.
Right-click (Windows) or Control-click (Macintosh) the CSS Styles panel to open a context menu of options for
working with CSS style sheet commands.
Open the CSS Styles panel
You use the CSS Styles panel to view, create, edit, and remove CSS styles, as well as to attach external style sheets to
documents.
❖Do one of the following:
•Select Window > CSS Styles.
•Press Shift+F11.
•Click the CSS button in the Property inspector.
Set CSS Styles preferences
CSS style preferences control how Dreamweaver writes the code that defines CSS styles. CSS styles can be written in
a shorthand form that some people find easier to work with. Some older versions of browsers, however, do not
correctly interpret the shorthand.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh) and from the Category list select
CSS Styles.
A B C
BA C D
September 4, 2007
DREAMWEAVER CS3
User Guide
129
2Set the CSS style options you want to apply:
When Creating CSS Rules Use Shorthand For Lets you select which CSS style properties Dreamweaver writes
in shorthand.
When Editing CSS Rules Use Shorthand Controls whether Dreamweaver rewrites existing styles in shorthand.
Select If Original Used Shorthand to leave all styles as they are.
Select According to Settings Above to rewrite styles in shorthand for the properties selected in Use Shorthand For.
When Double-Clicking In CSS Panel Lets you select a tool for editing CSS rules.
3Click OK.
Create a new CSS rule
You can create a CSS rule to automate the formatting of HTML tags or a range of text identified by a class attribute.
1Place the insertion point in the document, and then do one of the following to open the New CSS Rule dialog box:
•Select Text > CSS Styles > New.
•In the CSS Styles panel (Window > CSS Styles), click the New CSS Rule (+) button located in the lower-right side
of the panel.
2Define the type of CSS style you want to create:
•To create a custom style that can be applied as a class attributetoarangeorblockoftext,selecttheClassoption
and then enter a name for the style in the Name text box.
Note: Class names must begin with a period and can contain any combination of letters and numbers (for example,
.myhead1). If you don’t enter a beginning period, Dreamweaver automatically enters it for you.
•To redefine the default formatting of a specific HTML tag, select the Tag option and then enter an HTML tag in
the Tag text box or select one from the pop-up menu.
•To define the formatting for a particular combination of tags or for all tags that contain a specific Id attribute,
select the Advanced option and then enter one or more HTML tags in the Selector text box or select one from the
pop-up menu. The selectors (known as pseudo-class selectors) available from the pop-up menu are a:active,
a:hover,a:link, and a:visited.
3Select the location in which the style will be defined, and then click OK:
•To place the style in a style sheet that is already attached to the document, select the style sheet.
•To create an external style sheet, select New Style Sheet File.
•To embed the style in the current document, select This Document Only.
4In the CSS Rule Definition dialog box, select the style options you want to set for the new CSS rule. For more infor-
mation, see the next section.
5When you are finished setting style properties, click OK.
Note: Clicking OK without setting style options results in a new, empty rule.
Set CSS properties
You can define properties for CSS rules such as text font, background image and color, spacing and layout properties,
and the appearance of list elements. First create a new rule, then set any of the following properties.
September 4, 2007
DREAMWEAVER CS3
User Guide
130
Define CSS type properties
You use the Type category in the CSS Rule Definition dialog box to define basic font and type settings for a CSS style.
1Open the CSS Styles panel (Shift + F11), if it isn’t already open.
2Double-click an existing rule or property in the top pane of the CSS Styles panel.
3In the CSS Rule Definition dialog box, select Type, and then set the style properties.
Leave any of the following properties empty if they are not important to the style:
Font Sets the font family (or series of families) for the style. Browsers display text in the first font in the series that
is installed on the user’s system. For compatibility with Internet Explorer 3.0, list a Windows font first. The font
attribute is supported by both browsers.
Size Defines the size of the text. You can choose a specific size by selecting the number and the unit of measurement,
or you can choose a relative size. Pixels work well to prevent browsers from distorting your text. The size attribute is
supported by both browsers.
Style Specifies Normal, Italic, or Oblique as the font style. The default setting is Normal. The style attribute is
supported by both browsers.
Line Height Sets the height of the line on which the text is placed. This setting is traditionally called leading. Select
Normaltohavethelineheightforthefontsizecalculatedautomatically,orenteranexactvalueandselectaunitof
measurement.The line height attribute is supported by both browsers.
Decoration Adds an underline, overline, or line-through to the text, or makes the text blink. The default setting for
regular text is None. The default setting for links is Underline. When you set the link setting to none, you can remove
the underline from links by defining a special class.The decoration attribute is supported by both browsers.
Weight Applies a specific or relative amount of boldface to the font. Normal is equivalent to 400; Bold is equivalent
to 700. The weight attribute is supported by both browsers.
Variant Sets the small caps variant on text. Dreamweaver does not display this attribute in the Document window.
The variant attribute is supported by Internet Explorer but not Navigator.
Case Capitalizes the first letter of each word in the selection or sets the text to all uppercase or lowercase. The case
attribute is supported by both browsers.
Color Sets the text color. The color attribute is supported by both browsers.
4When you are finished setting these options, select another CSS category on the left side of the panel to set
additional style properties, or click OK.
Define CSS style background properties
Use the Background category of the CSS Rule Definition dialog box to define background settings for a CSS style.
You can apply background properties to any element in a web page. For example, create a style which adds a
background color or background image to any page element, for example behind text, a table, the page, and so on.
You can also set the positioning of a background image.
1Open the CSS Styles panel (Shift+F11), if it isn’t already open.
2Double-click an existing rule or property in the top pane of the CSS Styles panel.
3In the CSS Rule Definition dialog box, select Background, then set the style properties.
Leave any of the following properties empty if they are not important to the style:
Background Color Sets the background color for the element. The background color attribute is supported by both
browsers.
September 4, 2007
DREAMWEAVER CS3
User Guide
131
Background Image Sets the background image for the element.The background image attribute is supported by both
browsers.
Repeat Determines whether and how the background image is repeated. The Repeat attribute is supported by both
browsers.
•No Repeat displays the image once at the beginning of the element.
•Repeat tiles the image horizontally and vertically behind the element.
•Repeat-x and Repeat-y display a horizontal and vertical band of images, respectively. Images are clipped to fit
within the boundaries of the element.
Note: Use the Repeat property to redefine the body tag and set a background image that does not tile or repeat.
Attachment Determines whether the background image is fixed at its original position or scrolls along with the
content. Note that some browsers may treat the Fixed option as Scroll. This is supported by Internet Explorer but not
Netscape Navigator.
Horizontal Position and Vertical Position Specify the initial position of the background image in relation to the
element. This can be used to align a background image to the center of the page, both vertically and horizontally. If
theattachmentpropertyisFixed,thepositionisrelativetotheDocumentwindow,nottotheelement.Thisattribute
is supported by Internet Explorer but not Netscape Navigator.
4When you are finished setting these options, select another CSS category on the left side of the panel to set
additional style properties, or click OK.
Define CSS style block properties
You use the Block category of the CSS Rule Definition dialog box to define spacing and alignment settings for tags
and properties.
1Open the CSS Styles panel (Shift+F11), if it isn’t already open.
2Double-click an existing rule or property in the top pane of the CSS Styles panel.
3In the CSS Rule Definition dialog box, select Block, then set any of the following style properties. (Leave the
property blank if it is not important to the style.)
Word Spacing Sets the spacing between words. To set a specific value, in the pop-up menu, select Value, then enter
a numeric value. In the second pop-up menu, select a measurement unit (for example, pixel, points, and so on).
Note: You can specify negative values, but the display depends on the browser. Dreamweaver does not display this
attribute in the Document window.
Letter Spacing Increases or decreases space between letters or characters. To decrease the space between characters
specify a negative value, for example (-4). Letter spacing settings override justified text settings. The Letter Spacing
attribute is supported by Internet Explorer 4 and later and Netscape Navigator 6.
Vertical Alignment Specifies the vertical alignment of the element to which it is applied. Dreamweaver displays this
attribute in the Document window only when it is applied to the <img> tag.
Text Align Sets how text is aligned within the element. The Text Align attribute is supported by both browsers.
Text Indent Specifies how far the first line of text indents. A negative value may be used to create an outdent, but the
display depends on the browser. Dreamweaver displays this attribute in the Document window only when the tag is
applied to block-level elements. The Text Indent attribute is supported by both browsers.
Whitespace Determines how white space within the element is handled. Select from three options: Normal collapses
whitespace;Prehandlesitasifthetextwereenclosedinpre tags (that is, all white space, including spaces, tabs, and
September 4, 2007
DREAMWEAVER CS3
User Guide
132
returns, is respected); Nowrap specifies that the text only wraps when a br tag is encountered. Dreamweaver does
not display this attribute in the Document window. The Whitespace attribute is supported by Netscape Navigator
and Internet Explorer 5.5.
Display Specifies whether an element is displayed and if so how it is displayed. None disables the display of an
element to which it is assigned.
4When you are finished setting these options, select another CSS category on the left side of the panel to set
additional style properties, or click OK.
Define CSS style box properties
Use the Box category of the CSS Rule Definition dialog box to define settings for tags and properties that control the
placement of elements on the page.
You can apply settings to individual sides of an element when applying padding and margin settings, or use the Same
For All setting to apply the same setting to all sides of an element.
1Open the CSS Styles panel (Shift + F11), if it isn’t already open.
2Double-click an existing rule or property in the top pane of the CSS Styles panel.
3In the CSS Rule Definition dialog box, select Box, and set any of the following style properties. (Leave the property
blank if it is not important to the style.)
Width and Height Sets the width and height of the element.
Float Sets which side other elements, such as text, AP Divs, tables and so on, will float around an element. Other
elements wrap around the floating element as usual. The Float attribute is supported by both browsers.
Clear DefinesthesidesthatdonotallowAPelements.IfanAPelementappearsontheclearside,theelementwith
the clear setting moves below it. The Clear attribute is supported by both browsers.
Padding Specifies the amount of space between the content of an element and its border (or margin if there is no
border). Deselect the Same For All option to set the padding for individual sides of the element.
Same For All Sets the same padding properties to the Top, Right, Bottom, and Left of the element to which it is
applied.
Margin Specifies the amount of space between the border of an element (or the padding if there is no border) and
another element. Dreamweaver displays this attribute in the Document window only when it is applied to block-level
elements (paragraphs, headings, lists, and so on). Deselect Same For All to set the margin for individual sides of the
element.
Same For All Sets the same margin properties to the Top, Right, Bottom, and Left of the element to which it is
applied.
4When you are finished setting these options, select another CSS category on the left side of the panel to set
additional style properties, or click OK.
Define CSS style border properties
Use the Border category of the CSS Rule Definition dialog box to define settings, such as width, color, and style, for
the borders around elements.
1Open the CSS Styles panel (Shift+F11), if it isn’t already open.
2Double-click an existing rule or property in the top pane of the CSS Styles panel.
September 4, 2007
DREAMWEAVER CS3
User Guide
133
3In the CSS Rule Definition dialog box, select Border, and set any of the following style properties. (Leave the
property blank if it is not important to the style.)
Style Setsthestyleappearanceoftheborder.Thewaythestyleappearsdependsonthebrowser.DeselectSameFor
All to set the border style for individual sides of the element.
Same For All Sets the same border style properties to the Top, Right, Bottom, and Left of the element to which it is
applied.
Width Sets the thickness of the element’s border. The Width attribute is supported by both browsers. Deselect Same
For All to set the border width for individual sides of the element.
Same For All Sets the same border width to the Top, Right, Bottom, and Left of the element to which it is applied.
Color Sets the color of the border. You can set each side’s color independently, but the display depends on the
browser. Deselect Same For All to set the border color for individual sides of the element.
Same For All Sets the same border color to the Top, Right, Bottom, and Left of the element to which it is applied.
4When you are finished setting these options, select another CSS category on the left side of the panel to set
additional style properties, or click OK.
Define CSS style list properties
The List category of the CSS Rule Definition dialog box defines list settings, such as bullet size and type, for list tags.
1Open the CSS Styles panel (Shift+F11), if it isn’t already open.
2Double-click an existing rule or property in the top pane of the CSS Styles panel.
3In the CSS Rule Definition dialog box, select List, and set any of the following style properties. (Leave the property
blank if it is not important to the style.)
Type Sets the appearance of bullets or numbers. Type is supported by both browsers.
Bullet Image Lets you specify a custom image for bullets. Click Browse (Windows) or Choose (Macintosh) to
browse to an image, or type the image’s path.
Position Sets whether list item text wraps and indents (outside) or whether the text wraps to the left margin (inside).
4When you are finished setting these options, select another CSS category on the left side of the panel to set
additional style properties, or click OK.
Define CSS style positioning properties
ThePositioningstylepropertiesdeterminehowthecontentrelatedtotheselectedCSSstyleispositionedonthepage.
1Open the CSS Styles panel (Shift+F11), if it isn’t already open.
2Double-click an existing rule or property in the top pane of the CSS Styles panel.
3In the CSS Rule Definition dialog box, select Positioning, and then set the style properties you want.
Leave any of the following properties empty if they are not important to the style:
Type Determines how the browser should position the selected element as follows:
•Absolute places the content using the coordinates entered in the Placement boxes relative to the nearest absolutely-
or relatively-positioned ancestor, or, if no absolutely- or relatively-positioned ancestor exists, to the upper-left
corner of the page.
September 4, 2007
DREAMWEAVER CS3
User Guide
134
•Relative places the content block using the coordinates entered in the Placement boxes relative to block’s position
in the text flow of the document. For example, giving an element a relative position and top and left coordinates
of 20px each will shift the element 20px to the right and 20px down from its normal position in the flow. Elements
can also be positioned relatively, with or without top, left, right, or bottom coordinates, to establish a context for
absolutely-positioned children.
•Fixed places the content using the coordinates entered in the Placement boxes, relative to the top left corner of the
browser. The content will remain fixed in this position as the user scrolls the page.
•Static places the content at its location in the text flow. This is the default position of all positionable HTML
elements.
Visibility Determines the initial display condition of the content. If you do not specify a visibility property, by default
thecontentinheritstheparenttag’svalue.Thedefaultvisibilityofthebodytagisvisible.Selectoneofthefollowing
visibility options:
•Inherit (default) inherits the visibility property of the content’s parent.
•Visible displays the content, regardless of the parent’s value.
•Hidden hides the content, regardless of the parent’s value.
Z-Index Determines the stacking order of the content. Elements with a higher z-index appear above elements with
a lower z-index (or none at all). Values can be positive or negative. (If your content is absolutely positioned, it’s easier
to change the stacking order using the AP Elements panel.
Overflow Determines what happens if the contents of a container (for example, a DIV or a P) exceed its size. These
properties control the expansion as follows:
•Visible increases the container’s size so that all of its contents are visible. The container expands down and to the
right.
•Hidden maintains the container’s size and clips any content that doesn’t fit. No scroll bars are provided.
•Scroll adds scroll bars to the container regardless of whether the contents exceed the container’s size. Specifically
providing scroll bars avoids confusion caused by the appearance and disappearance of scroll bars in a dynamic
environment. This option is not displayed in the Document window.
•Auto makes scroll bars appear only when the container’s contents exceed its boundaries. This option is not
displayed in the Document window.
Placement Specifies the location and size of the content block. How the browser interprets the location depends on
the setting for Type. Size values are overridden if the content of the content block exceeds the specified size.
The default units for location and size are pixels. You can also specify the following units: pc (picas), pt (points), in
(inches), mm (millimeters), cm (centimeters), (ems), (exs), or % (percentage of the parent’s value). The abbreviations
must follow the value without a space: for example, 3mm.
Clip Defines the part of the content that is visible. If you specify a clipping region, you can access it with a scripting
language such as JavaScript and manipulate the properties to create special effects such as wipes. These wipes can be
set up by using the Change Property behavior.
4When you are finished setting these options, select another CSS category on the left side of the panel to set
additional style properties, or click OK.
Define CSS style extension properties
Extensions style properties include filters, page break, and pointer options.
September 4, 2007
DREAMWEAVER CS3
User Guide
135
Note: There are a number of other extension properties available in Dreamweaver, but to access them, you need to go
through the CSS Styles panel. You can easily see a list of extension properties available by opening the CSS Styles panel
(Windows > CSS Styles), clicking the Show Category View button at the bottom of the panel, and expanding the Exten-
sions category.
1Open the CSS Styles panel (Shift + F11), if it isn’t already open.
2Double-click an existing rule or property in the top pane of the CSS Styles panel.
3In the CSS Rule Definition dialog box, select Extensions, and set any of the following style properties. (Leave the
property blank if it is not important to the style.)
Pagebreak Forces a page break during printing either before or after the object controlled by the style. Select the
option you want to set in the pop-up menu. This option is not supported by any 4.0 browser, but support may be
provided by future browsers.
Cursor Changes the pointer image when the pointer is over the object controlled by the style. Select the option you
want to set in the pop-up menu. Internet Explorer 4.0 and later, and Netscape Navigator 6 support this attribute.
Filter Applies special effects to the object controlled by the style, including blur and inversion. Select an effect from
the pop-up menu.
4When you are finished setting these options, select another CSS category on the left side of the panel to set
additional style properties, or click OK.
Edit a CSS rule
You can easily edit both internal and external rules that you have applied to a document.
When you edit a CSS style sheet that controls the text in your document, you instantly reformat all of the text
controlled by that CSS style sheet. Edits to an external style sheet affect all the documents linked to it.
You can set an external editor to use for editing style sheets.
Edit a rule in the CSS Styles panel (Current mode)
1Open the CSS Styles panel by selecting Window > CSS Styles.
2Click the Current button at the top of the CSS Styles panel.
3Select a text element in the current page to display its properties.
4Do one of the following:
•Double-click a property in the Summary for Selection pane to display the CSS Rule Definition dialog box, and
then make your changes.
•Select a property in the Summary for Selection pane, and then edit the property in the Properties pane below.
•Select a rule in the Rules pane, and then edit the rule’s properties in the Properties pane below.
Note: You can change the double-clicking behavior for editing CSS, as well as other behaviors, by changing Dreamweaver
preferences.
Edit a rule in the CSS Styles panel (All mode)
1Open the CSS Styles panel by selecting Window > CSS Styles.
2Click the All button at the top of the CSS Styles panel.
September 4, 2007
DREAMWEAVER CS3
User Guide
136
3Do one of the following:
•Double-click a rule in the All Rules pane to display the CSS Rule Definition dialog box, and then make your
changes.
•Select a rule in the All Rules pane, and then edit the rule’s properties in the Properties pane below.
•Select a rule in the All Rules pane, and then click the Edit Style button in the lower-right corner of the CSS Styles
panel.
Note: You can change the double-clicking behavior for editing CSS, as well as other behaviors, by changing Dreamweaver
preferences.
Change the name of a CSS selector
1In the CSS Styles panel (All mode) select the selector you want to change.
2Click the selector again to make the name editable.
3Make your changes and press Enter (Windows) or Return (Macintosh).
Add a property to a rule
You can use the CSS Styles panel to add properties to rules.
1In the CSS Styles panel (Window > CSS), select a rule in the All Rules pane (All mode), or select a property in the
Summary for Selection pane (Current mode).
2Do one of the following:
•If Show Only Set Properties view is selected in the Properties pane, click the Add Properties link and add a
property.
•If Category view or List view is selected in the Properties pane, fill in a value for the property you want to add.
Apply, remove, or rename class styles
Class styles are the only type of CSS style that can be applied to any text in a document, regardless of which tags
control the text. All class styles associated with the current document are displayed in the CSS Styles panel (with a
period [.] preceding their name) and in the Style pop-up menu of the text Property inspector.
You’ll see most styles updated immediately, however, you should preview your page in a browser to verify a style was
applied as expected. When you apply two or more styles to the same text, the styles may conflict and produce
unexpected results.
When previewing styles defined in an external CSS style sheet, be sure to save the style sheet to ensure that your
changes are reflected when you preview the page in a browser.
See also
“About Cascading Style Sheets” on page 120
“About cascading styles” on page 122
“About the CSS Styles panel” on page 124
Apply a CSS class style
1In the document, select the text to which you want to apply a CSS style.
September 4, 2007
DREAMWEAVER CS3
User Guide
137
Place the insertion point in a paragraph to apply the style to the entire paragraph.
If you select a range of text within a single paragraph, the CSS style affects only the selected range.
To specify the exact tag to which the CSS style should be applied, select the tag in the tag selector located at the lower
left of the Document window.
2To apply a class style, do one of the following:
•In the CSS Styles panel (Window > CSS Styles), select All mode, right-click the name of the style you want to apply,
and select Apply from the context menu.
•In the text Property inspector, select the class style you want to apply from the Style pop-up menu.
•In the Document window, right-click (Windows) or Control-click (Macintosh) the selected text, and in the
context menu, select CSS Styles and then select the style you want to apply.
•Select Text > CSS Styles, and in the submenu select the style you want to apply.
Remove a class style from a selection
1Select the object or text you want to remove the style from.
2In the text Property inspector (Window > Properties), select None from the Style pop-up menu.
Rename a class style
1In the CSS styles panel, right-click the CSS class style you want to rename and select Rename Class.
You can also rename a class by selecting Rename Class from the CSS Styles panel options menu.
2In the Rename Class dialog box, make sure that the class you want to rename is selected in the Rename Class
pop-up menu.
3In the New Name text box, enter the new name for the new class and click OK.
Iftheclassyou’rerenamingisinternaltotheheadofthecurrentdocument,Dreamweaverchangestheclassnameas
well as all instances of the class name in the current document. If the class you’re renaming is in an external CSS file,
Dreamweaveropensandchangestheclassnameinthefile.Dreamweaveralsolaunchesasite-wideFindandReplace
dialog box so that you can search for all instances of the old class name in your site.
Move CSS rules
The CSS management features in Dreamweaver make it easy for you to move CSS rules to different locations. You
can move rules from document to document, from the head of a document to an external style sheet, between
external CSS files, and more.
Note: Iftheruleyou’retryingtomoveconflictswitharuleinthedestinationstylesheet,DreamweaverdisplaystheRule
With Same Name Exists dialog box. If you elect to move the conflicting rule, Dreamweaver places the moved rule
immediately adjacent to the conflicting rule in the destination style sheet.
See also
“Insert code with the Coding toolbar” on page 316
September 4, 2007
DREAMWEAVER CS3
User Guide
138
Move CSS rules to a new style sheet
1Do one of the following:
•In the CSS Styles panel, select the rule or rules you want to move. Then right-click the selection and select Move
CSS Rules from the context menu. To select multiple rules, Control-click (Windows) or Command-click
(Macintosh) the rules you want to select.
•In Code view, select the rule or rules you want to move. Then right-click the selection and select CSS Styles > Move
CSS Rules from the context menu.
Note: Partial selection of a rule will result in the relocation of the entire rule.
2In the Move To External Style Sheet dialog box, select the new style sheet option and click OK.
3In the Save Style Sheet File As dialog box, enter a name for the new style sheet and click Save.
When you click Save, Dreamweaver saves a new style sheet with the rules you selected and attaches it to the current
document.
You can also move rules by using the Coding toolbar. The Coding toolbar is available in Code view only.
Move CSS rules to an existing style sheet
1Do one of the following:
•In the CSS Styles panel, select the rule or rules you want to move. Then right-click the selection and select Move
CSS Rules from the context menu. To select multiple rules, Control-click (Windows) or Command-click
(Macintosh) the rules you want to select.
•In Code view, select the rule or rules you want to move. Then right-click the selection and select CSS Styles > Move
CSS Rules from the context menu.
Note: Partial selection of a rule will result in the relocation of the entire rule.
2In the Move To External Style Sheet dialog box, select an existing style sheet from the pop-up menu or browse to
an existing style sheet and click OK.
Note: The pop-up menu displays all style sheets that are linked to the current document.
You can also move rules by using the Coding toolbar. The Coding toolbar is available in Code view only.
Rearrange or move CSS rules by dragging
❖In the CSS Styles panel (All mode), select a rule and drag it rule to the desired location. You can select and drag
to re-order rules within a style sheet, or move a rule to another style sheet or the document head.
You can move more than one rule at a time by Control-clicking (Windows) or Command-clicking (Macintosh)
multiple rules to select them.
Select multiple rules before moving them
❖In the CSS Styles panel, Control-click (Windows) or Command-click (Macintosh) the rules you want to select.
Convert inline CSS to a CSS rule
In-line styles are not recommended best practices. To make your CSS cleaner and more organized, you can convert
inline styles to CSS rules that reside in the head of the document or in an external style sheet.
1In Code view (View > Code), select the entire <style> tag that contains the inline CSS you want to convert
September 4, 2007
DREAMWEAVER CS3
User Guide
139
2Right-click and select CSS Styles > Convert Inline CSS to Rule.
3In the Convert Inline CSS dialog box, enter a class name for the new rule, and then do one of the following:
•Specify a style sheet where you want the new CSS rule to appear and click OK.
•Select the head of the document as the location where you want the new CSS rule to appear and click OK.
You can also convert rules by using the Coding toolbar. The Coding toolbar is available in Code view only.
See also
“Insert code with the Coding toolbar” on page 316
Link to an external CSS style sheet
When you edit an external CSS style sheet, all documents linked to that CSS style sheet are updated to reflect those
edits. You can export the CSS styles found in a document to create a new CSS style sheet, and attach or link to an
external style sheet to apply the styles found there.
You can attach to your pages any style sheet that you create or copy into your site. In addition, Dreamweaver is
shipped with prebuilt style sheets that can be automatically moved into your site and attached to your pages.
1Open the CSS Styles panel by doing one of the following:
•Select Window > CSS Styles.
•Press Shift + F11.
2In the CSS Styles panel, click the Attach Style Sheet button. (It’s in the lower-right corner of the panel.)
3Do one of the following:
•Click Browse to browse to an external CSS style sheet.
•Type the path to the style sheet in the File/URL box.
4For Add As, select one of the options:
•To create a link between the current document and an external style sheet, select Link. This creates a link href tag
intheHTMLcode,andreferencestheURLwherethepublishedstylesheetislocated.Thismethodissupported
by both Microsoft Internet Explorer and Netscape Navigator.
•You cannot use a link tag to add a reference from one external style sheet to another. If you want to nest style
sheets, you must use an import directive. Most browsers also recognize the import directive within a page (rather
than just within style sheets). There are subtle differences in how conflicting properties are resolved when
overlapping rules exist within external style sheets that are linked versus imported to a page. If you want to import,
rather than link to, an external style sheet, select Import.
5In the Media pop-up menu, specify the target medium for the style sheet.
For more information on media-dependent style sheets, see the World Wide Web Consortium website at
www.w3.org/TR/CSS21/media.html.
6Click the Preview button to verify that the style sheet applies the styles you want to the current page.
Ifthestylesappliedarenotwhatyouexpectthemtobe,clickCanceltoremovethestylesheet.Thepagewillrevert
to its previous appearance.
7Click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
140
See also
“Create a page based on a Dreamweaver sample file” on page 73
Edit a CSS style sheet
A CSS style sheet typically includes one or more rules. You can edit an individual rule in a CSS style sheet using the
CSS Styles panel, or if you prefer, you can work directly in the CSS style sheet.
1In the CSS Styles panel (Window > CSS Styles), select All mode.
2In the All rules pane, double-click the name of the style sheet you want to edit.
3In the Document window, modify the style sheet as desired, and then save the style sheet.
Format CSS code
You can set preferences that control the format of your CSS code whenever you create or edit a CSS rule using the
Dreamweaver interface. For example, you can set preferences that will place all CSS properties on separate lines,
place a blank line between CSS rules, and so on.
When you set CSS code formatting preferences, the preferences you select are automatically applied to all new CSS
rules that you create. You can, however, also apply these preferences manually to individual documents. This might
be useful if you have an older HTML or CSS document that needs formatting.
Note: CSS code formatting preferences apply to CSS rules in external or embedded style sheets only (not to in-line styles)
See also
“Change the code format” on page 309
Set CSS code formatting preferences
1Select Edit > Preferences.
2In the Preferences dialog box, select the Code Format category.
3Next to Advanced Formatting, click the CSS button.
4In the CSS Source Format Options dialog box, select the options that you want to apply to your CSS source code.
ApreviewoftheCSSasitwouldlookaccordingtotheoptionsyou’veselectedappearsinthePreviewwindowbelow.
Indent Properties With Sets the indentation value for properties within a rule. You can specify tabs or spaces.
Each Property On A Separate Line Places each property within a rule on a separate line.
Opening Brace On Separate Line Places the opening brace for a rule on a separate line from the selector.
Only If More Than One Property Places single-property rules on the same line as the selector.
All Selectors For A Rule On Same Line Places all selectors for the rule on the same line.
Blank Line Between Rules Inserts a blank line between each rule.
5Click OK.
Note: CSS code formatting also inherits the Line Break Type preference that you set in the Code Format category of the
Preferences dialog box.
Format CSS code in a CSS style sheet manually
1Open a CSS style sheet.
September 4, 2007
DREAMWEAVER CS3
User Guide
141
2Select Commands > Apply Source Formatting.
The formatting options you set in CSS code formatting preferences are applied to the entire document. You cannot
format individual selections.
Format embedded CSS code manually
1Open an HTML page that contains CSS embedded in the head of the document.
2Select any part of the CSS code.
3Select Commands > Apply Source Formatting To Selection.
The formatting options you set in CSS code formatting preferences are applied to all CSS rules in the head of the
document only.
Note: You can select Commands > Apply Source Formatting to format the entire document according to your specified
code formatting preferences.
Check for cross-browser CSS rendering issues
The Browser Compatibility Check (BCC) feature helps you locate combinations of HTML and CSS that have
problems in certain browsers. When you run a BCC on an open file, Dreamweaver scans the file and reports any
potential CSS rendering issues in the Results panel. A confidence rating, indicated by a quarter, half, three-quarter,
or completely filled circle, indicates the likelihood of the bug’s occurrence (a quarter-filled circle indicating a possible
occurrence, and a completely-filled circle indicating a very likely occurrence). For each potential bug that it finds,
Dreamweaver also provides a direct link to documentation about the bug on Adobe CSS Advisor, a website that
details commonly known browser rendering bugs, and offers solutions for fixing them.
By default, the BCC feature checks against the following browsers: Firefox 1.5; Internet Explorer (Windows) 6.0 and
7.0; Internet Explorer (Macintosh) 5.2; Netscape Navigator 8.0; Opera 8.0 and 9.0; Safari 2.0.
This feature replaces the former Target Browser Check feature, but retains the CSS functionality of that feature. That
is, the new BCC feature still tests the code in your documents to see if any of the CSS properties or values are unsup-
ported by your target browsers.
Three levels of potential browser-support problems can arise:
•An error indicates CSS code that might cause a serious visible problem in a particular browser, such as causing
parts of a page to disappear. (Error is the default designation for browser support problems, so in some cases, code
with an unknown effect is also marked as an error.)
•A warning indicates a piece of CSS code that isn’t supported in a particular browser, but that won’t cause any
serious display problems.
•Aninformationalmessageindicatescodethatisn’tsupportedinaparticularbrowser,butthathasnovisibleeffect.
Browser compatibility checks do not alter your document in any way.
See also
“Validate tags” on page 328
Run a browser compatibility check
❖Select File > Check Page > Browser Compatibility.
September 4, 2007
DREAMWEAVER CS3
User Guide
142
Select the element affected by a found issue
❖Double-click the issue in the Results panel.
Jump to the next or previous found issue in the code
❖Select Next Issue or Previous Issue from the Browser Compatibility Check menu in the Document toolbar.
Select browsers for Dreamweaver to check against
1In the Results panel (Window > Results), select the Browser Compatibility Check tab.
2Click the green arrow in the upper-left corner of the Results panel and select Settings.
3Select the checkbox next to each browser you want to check against.
4For each selected browser, select a minimum version to check against from the corresponding pop-up menu.
For example, to see if CSS rendering bugs might appear in Internet Explorer 5.0 and later and Netscape Navigator
7.0 and later, select the checkboxes next to those browser names, and select 5.0 from the Internet Explorer pop-up
menu and 7.0 from the Netscape pop-up menu.
Exclude an issue from the browser compatibility check
1Run a browser compatibility check.
2In the Results panel, Right-click (Windows) or Control-click (Macintosh) the issue that you want to exclude from
future checking.
3Select Ignore Issue from the context menu.
Edit the Ignored Issues list
1In the Results panel (Window > Results), select the Browser Compatibility Check tab.
2Click the green arrow in the upper-left corner of the Results panel and select Edit Ignored Issues List.
3In the Exceptions.xml file, find the issue that you want deleted from the Ignored Issues list and delete it.
4Save and close the Exceptions.xml file.
Save a browser compatibility check report
1Run a browser compatibility check.
2Click the Save Report button on the left side of the Results panel.
Hover over buttons in the Results panel to see button tool tips.
September 4, 2007
DREAMWEAVER CS3
User Guide
143
Note: Reportsarenotsavedautomatically;ifyouwanttokeepacopyofareport,youmustfollowtheaboveprocedure
to save it.
View a browser compatibility check report in a browser
1Run a browser compatibility check.
2Click the Browse Report button on the left side of the Results panel.
Hover over buttons in the Results panel to see button tool tips.
Open the Adobe CSS Advisor website
1In the Results panel (Window > Results), select the Browser Compatibility Check tab.
2Click the link text at the bottom right of the panel.
Use Design-Time style sheets
Design-Time style sheets allow you to show or hide design applied by a CSS style sheet as you work in a Dreamweaver
document. For example, you can use this option to include or exclude the effect of a Macintosh-only or a Windows-
only style sheet as you design a page.
Design-Time style sheets only apply while you are working in the document; when the page is displayed in a browser
window, only the styles that are actually attached to or embedded in the document appear in a browser.
Note: You can also enable or disable styles for an entire page using the Style Rendering toolbar. To display the toolbar,
select View > Toolbars > Style Rendering. The Toggle Displaying of CSS Styles button (the right-most button) works
independently of the other media buttons on the toolbar.
To use a Design-time style sheet, follow these steps.
1Open the Design-Time Style Sheets dialog box by doing one of the following:
•Right-click in the CSS Styles panel, and in the context menu select Design-time.
•Select Text > CSS Styles > Design-time.
2In the dialog box, set options to show or hide a selected style sheet:
•To display a CSS style sheet at design-time, click the Plus (+) button above Show Only At Design Time, then in
the Select a Style Sheet dialog box, browse to the CSS style sheet you want to show.
•To hide a CSS style sheet, click the Plus (+) button above Hide At Design-Time, then in the Select a Style Sheet
dialog box, browse to the CSS style sheet you want to show.
•To remove a style sheet from either list, click the style sheet you want to remove, then click the appropriate Minus
(–) button.
3Click OK to close the dialog box.
The CSS Styles panel updates with the selected style sheet’s name along with an indicator, “hidden” or “design,” to
reflect the style sheet’s status.
See also
“Style Rendering toolbar overview” on page 21
September 4, 2007
DREAMWEAVER CS3
User Guide
144
Use Dreamweaver sample style sheets
Dreamweaver provides sample style sheets that you can apply to your pages or that you can use as starting points to
develop your own styles.
1Open the CSS Styles panel by doing one of the following:
•Select Window > CSS Styles.
•Press Shift+F11.
2In the CSS Styles panel, click the Attach External Style Sheet button. (It’s in the lower-right corner of the panel.)
3In the Attach External Style Sheet dialog box, click Sample Style Sheets.
4In the Sample Style Sheets dialog box, select a style sheet from the list box.
As you select style sheets within the list box, the Preview pane displays the text and color formatting of the selected
style sheet.
5Click the Preview button to apply the style sheet and verify that it applies the styles you want to the current page.
If the styles applied are not what you expect them to be, select another style sheet from the list, and click Preview to
see those styles.
6By default, Dreamweaver saves the style sheet in a folder named CSS just below the root of the site you defined for
your page. If that folder does not exist, Dreamweaver creates it. You can save the file to another location by clicking
Browse and browsing to another folder.
7When you find a style sheet whose formatting rules meet your design criteria, click OK.
Update CSS style sheets in a Contribute site
Adobe Contribute users can’t make changes to a CSS style sheet. To change a style sheet for a Contribute site, use
Dreamweaver.
1Edit the style sheet using the Dreamweaver style-sheet-editing tools.
2TellalloftheContributeuserswhoareworkingonthesitetopublishpagesthatusethatstylesheet,thenre-edit
those pages to view the new style sheet.
The following are important factors to keep in mind when updating style sheets for a Contribute site:
•If you make changes to a style sheet while a Contribute user is editing a page that uses that style sheet, the user
won’t see the changes to the style sheet until they publish the page.
•Ifyoudeleteastylefromastylesheet,thestylenameisnotdeletedfrompagesthatusethatstylesheet,butsince
the style no longer exists, it isn’t displayed the way the Contribute user may expect. Thus, if a user tells you that
nothinghappenswhentheyapplyaparticularstyle,theproblemmaybethatthestylehasbeendeletedfromthe
style sheet.
September 4, 2007
DREAMWEAVER CS3
User Guide
145
Laying out pages with CSS
About CSS page layout
A CSS page layout uses the Cascading Style Sheets format, rather than traditional HTML tables or frames, to
organize the content on a web page. The basic building block of the CSS layout is the div tag—an HTML tag that in
most cases acts as a container for text, images, and other page elements. When you create a CSS layout, you place div
tags on the page, add content to them, and position them in various places. Unlike table cells, which are restricted to
existing somewhere within the rows and columns of a table, div tags can appear anywhere on a web page. You can
position div tags absolutely (by specifying x and y coordinates), or relatively (by specifying their distance from other
page elements).
Creating CSS layouts from scratch can be difficult because there are so many ways to do it. You can create a simple
two-column CSS layout by setting floats, margins, paddings, and other CSS properties in a nearly infinite number of
combinations. Additionally, the problem of cross-browser rendering causes certain CSS layouts to display properly
in some browsers, and display improperly in others. Dreamweaver makes it easy for you to build pages with CSS
layouts by providing over 30 pre-designed layouts that work across different browsers.
Using the pre-designed CSS layouts that come with Dreamweaver is the easiest way to create a page with a CSS layout,
but you can also create CSS layouts using Dreamweaver absolutely-positioned elements (AP elements). An AP
element in Dreamweaver is an HTML page element—specifically, a div tag, or any other tag—that has an absolute
position assigned to it. The limitation of Dreamweaver AP elements, however, is that since they are absolutely
positioned, their positions never adjust on the page according to the size of the browser window.
If you are an advanced user, you can also insert div tags manually and apply CSS positioning styles to them to create
page layouts.
For a tutorial on creating CSS page layouts, see www.adobe.com/go/vid0155.
See also
“Working with div tags” on page 162
About CSS page layout structure
Before proceeding with this section, you should be familiar with basic CSS concepts.
The basic building block of the CSS layout is the div tag—an HTML tag that in most cases acts as a container for text,
images, and other page elements. The following example shows an HTML page that contains three separate div tags:
one large “container” tag, and two other tags—a sidebar tag, and a main content tag—within the container tag.
September 4, 2007
DREAMWEAVER CS3
User Guide
146
A. Container div B. Sidebar div C. Main Content div
Following is the code for all three div tags in the HTML:
<!--container div tag-->
<div id="container">
<!--sidebar div tag-->
<div id="sidebar">
<h3>Sidebar Content</h3>
<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit.</p>
<p>Maecenas urna purus, fermentum id, molestie in, commodo porttitor, felis.</p>
</div>
<!--mainContent div tag-->
<div id="mainContent">
<h1> Main Content </h1>
<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent aliquam, justo
convallis luctus rutrum.</p>
<p>Phasellus tristique purus a augue condimentum adipiscing. Aenean sagittis. Etiam leo
pede, rhoncus venenatis, tristique in, vulputate at, odio.</p>
<h2>H2 level heading </h2>
<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent aliquam, justo
convallis luctus rutrum, erat nulla fermentum diam, at nonummy quam ante ac quam.</p>
</div>
</div>
In the above example, there is no “styling” attached to any of the div tags. Without CSS rules defined, each div tag
and its contents fall into a default location on the page. However, if each div tag has a unique id (as in the above
example), you can use the ids to create CSS rules that, when applied, change the style and positioning of the div tags.
The following CSS rule, which can reside in the head of the document or in an external CSS file, creates styling rules
for the first, or “container” div tag on the page:
#container {
width: 780px;
background: #FFFFFF;
margin: 0 auto;
border: 1px solid #000000;
text-align: left;
}
The #container rule styles the container div tag to have a width of 780 pixels, a white background, no margin (from
the left side of the page), a solid, black, 1-pixel border, and text that is aligned left. The results of applying the rule to
the container div tag are as follows:
A
B
C
September 4, 2007
DREAMWEAVER CS3
User Guide
147
Container div tag, 780 pixels, no margin
A. Text aligned left B. White background C. 1-pixel solid black border
The next CSS rule creates styling rules for the sidebar div tag:
#sidebar {
float: left;
width: 200px;
background: #EBEBEB;
padding: 15px 10px 15px 20px;
}
The #sidebar rule styles the sidebar div tag to have a width of 200 pixels, a gray background, a top and bottom
padding of 15 pixels, a right padding of 10 pixels, and a left padding of 20 pixels. Additionally, the rule positions the
sidebar div tag with float: left—a property that pushes the sidebar div tag to the left side of the container div tag. The
results of applying the rule to the sidebar div tag are as follows:
Sidebar div, float left
A. Width 200 pixels B. Top and bottom padding, 15 pixels
Last, the CSS rule for the main container div tag finishes the layout:
#mainContent {
margin: 0 0 0 250px;
padding: 0 20px 20px 20px;
}
B
C
A
B
B
A
September 4, 2007
DREAMWEAVER CS3
User Guide
148
The #mainContent rule styles the main content div with a left margin of 250 pixels, which means that it places 250
pixels of space between the left side of the container div, and the left side of the main content div. Additionally, the
rule provides for 20 pixels of spacing on the right, bottom, and left sides of the main content div. The results of
applying the rule to the mainContent div are as follows:
Main Content div, left margin of 250 pixels
A. 20 pixels left padding B. 20 pixels right padding C. 20 pixels bottom padding
The complete code looks as follows:
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>Untitled Document</title>
<style type="text/css">
#container {
width: 780px;
background: #FFFFFF;
margin: 0 auto;
border: 1px solid #000000;
text-align: left;
}
#sidebar {
float: left;
width: 200px;
background: #EBEBEB;
padding: 15px 10px 15px 20px;
}
#mainContent {
margin: 0 0 0 250px;
padding: 0 20px 20px 20px;
}
</style>
</head>
<body>
<!--container div tag-->
A
C
B
September 4, 2007
DREAMWEAVER CS3
User Guide
149
<div id="container">
<!--sidebar div tag-->
<div id="sidebar">
<h3>Sidebar Content</h3>
<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit.</p>
<p>Maecenas urna purus, fermentum id, molestie in, commodo porttitor, felis.</p>
</div>
<!--mainContent div tag-->
<div id="mainContent">
<h1> Main Content </h1>
<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent aliquam, justo
convallis luctus rutrum.</p>
<p>Phasellus tristique purus a augue condimentum adipiscing. Aenean sagittis. Etiam leo
pede, rhoncus venenatis, tristique in, vulputate at, odio.</p>
<h2>H2 level heading </h2>
<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent aliquam, justo
convallis luctus rutrum, erat nulla fermentum diam, at nonummy quam ante ac quam.</p>
</div>
</div>
</body>
Note: The above example code is a simplified version of the code that creates the two-column fixed left sidebar layout
when you create a new document using the predesigned layouts that come with Dreamweaver.
See also
“Understanding Cascading Style Sheets” on page 120
Create a page with a CSS layout
When creating a new page in Dreamweaver, you can create one that already contains a CSS layout. Dreamweaver
comes with over 30 different CSS layouts that you can choose from. Additionally, you can create your own CSS layouts
and add them to the configuration folder so that they appear as layout choices in the New Document dialog box.
Dreamweaver CSS layouts render correctly in the following browsers: Firefox (Windows and Macintosh) 1.0, 1.5, and
2.0; Internet Explorer (Windows) 5.5, 6.0, 7.0; Opera (Windows and Macintosh) 8.0, 9.0; and Safari 2.0.
See also
“Create a blank page” on page 69
“Set default document type and encoding” on page 74
“Link to an external CSS style sheet” on page 139
Create a page with a CSS layout
1Select File > New.
2In the New Document dialog box, select the Blank Page category. (It’s the default selection.)
3For Page Type, select the kind of page you want to create.
Note: You must select an HTML page type for the layout. For example, you can select HTML, ColdFusion®, JSP, and so
on. You cannot create an ActionScript™, CSS, Library Item, JavaScript, XML, XSLT, or ColdFusion Component page
with a CSS layout. Page types in the Other category of the New Document dialog box are also restricted from including
CSS page layouts.
September 4, 2007
DREAMWEAVER CS3
User Guide
150
4For Layout, select the CSS layout you want to use. You can choose from over 30 different layouts. The Preview
window shows the layout and gives a brief description of the selected layout.
The predesigned CSS layouts provide the following types of columns:
Fixed Column width is specified in pixels. The column does not resize based on the size of the browser or the site
visitor’s text settings.
Elastic Column width is specified in a unit of measurement (ems) relative to the size of the text. The design adapts
if the site visitor changes the text settings, but does not change based on the size of the browser window.
Liquid Column width is specified as a percentage of the site visitor’s browser width. The design adapts if the site
visitor makes the browser wider or narrower, but does not change based on the site visitor’s text settings.
Hybrid Columns are a combination of any of the previous three options. For example, the two-column hybrid, right
sidebarlayouthasamaincolumnthatscalestothesizeofthebrowser,andanelasticcolumnontherightthatscales
to the size of the site visitor’s text settings.
5Select a document type from the DocType pop-up menu.
6Select a location for the layout’s CSS from the Layout CSS in pop-up menu.
Add To Head Adds CSS for the layout to the head of the page you’re creating.
Create New File Adds CSS for the layout to a new external CSS stylesheet and attaches the new stylesheet to the page
you’re creating.
Link To Existing File Lets you specify an existing CSS file that already contains the CSS rules needed for the layout.
This option is particularly useful when you want to use the same CSS layout (the CSS rules for which are contained
in a single file) across multiple documents.
7Do one of the following:
•If you selected Add to Head from the Layout CSS in pop-up menu (the default option), click Create.
•If you selected Create New File from the Layout CSS pop-up menu, click Create, and then specify a name for the
new external file in the Save Style Sheet File As dialog box.
•If you selected Link to Existing File from the Layout CSS in pop-up menu, add the external file to the Attach CSS
file text box by clicking the Add Style Sheet icon, completing the Attach External Style Sheet dialog box, and
clicking OK. When you’re finished, click Create in the New Document dialog box.
Note: When you select the Link to Existing File option, the file you specify must already have the rules for the CSS file
contained within it.
When you put the layout CSS in a new file or link to an existing file, Dreamweaver automatically links the file to the
HTML page you’re creating.
Note: Internet Explorer conditional comments (CCs), which help work around IE rendering issues, remain embedded in
the head of the new CSS layout document, even if you select New External File or Existing External File as the location
for your layout CSS.
8(Optional) You can also attach CSS style sheets to your new page (unrelated to the CSS layout) when you create
the page. To do this, click the Attach Style Sheet icon above the Attach CSS file pane and select a CSS style sheet.
Add custom CSS layouts to the list of choices
1Create an HTML page that contains the CSS layout you’d like to add to the list of choices in the New Document
dialog box. The CSS for the layout must reside in the head of the HTML page.
September 4, 2007
DREAMWEAVER CS3
User Guide
151
To make your custom CSS layout consistent with the other layouts that come with Dreamweaver, you should save
your HTML file with the .htm extension.
2Add the HTML page to the Adobe Dreamweaver CS3\Configuration\BuiltIn\Layouts folder.
3(Optional) Add a preview image of your layout (for example a .gif or .png file) to the Adobe Dreamweaver
CS3\Configuration\BuiltIn\Layouts folder. The default images that come with Dreamweaver are 227 pixels wide x
193 pixels high PNG files.
GiveyourpreviewimagethesamefilenameasyourHTMLfilesothatyoucaneasilykeeptrackofit.Forexample,
if your HTML file is called myCustomLayout.htm, call your preview image myCustomLayout.png.
4(Optional) Create a notes file for your custom layout by opening the Adobe Dreamweaver CS3\Configu-
ration\BuiltIn\Layouts\_notes folder, copying and pasting any of the existing notes files in the same folder, and
renaming the copy for your custom layout. For example, you could copy the oneColElsCtr.htm.mno file, and rename
it myCustomLayout.htm.mno.
5(Optional) After you’ve created a notes file for your custom layout, you can open the file and specify the layout
name, description, and preview image.
About AP elements in Dreamweaver
An AP element (absolutely positioned element) is an HTML page element—specifically, a div tag, or any other tag—
that has an absolute position assigned to it. AP elements can contain text, images, or any other content that you can
place in the body of an HTML document.
WithDreamweaver,youcanuseAPelementstolayoutyourpage.YoucanplaceAPelementsinfrontofandbehind
each other, hide some AP elements while showing others, and move AP elements across the screen. You can place a
background image in one AP element, then place a second AP element, containing text with a transparent
background, in front of that.
AP elements will usually be absolutely positioned div tags. (These are the kinds of AP elements Dreamweaver inserts
by default. But remember, you can classify any HTML element (for example, an image) as an AP element by assigning
an absolute position to it. All AP elements (not just absolutely positioned div tags) appear in the AP elements panel.
HTML code for AP Div elements
Dreamweaver creates AP elements using the div tag. When you draw an AP element using the Draw AP Div tool,
Dreamweaver inserts a div tag in the document and assigns the div an id value (by default apDiv1 for the first div
you draw, apDiv2 for the second div you draw, and so on). Later, you can rename the AP Div to anything you want
using the AP elements panel or the Property inspector. Dreamweaver also uses embedded CSS in the head of the
document to position the AP Div, and to assign the AP Div its exact dimensions.
The following is sample HTML code for an AP Div:
September 4, 2007
DREAMWEAVER CS3
User Guide
152
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>Sample AP Div Page</title>
<style type="text/css">
<!--
#apDiv1 {
position:absolute;
left:62px;
top:67px;
width:421px;
height:188px;
z-index:1;
}
-->
</style>
</head>
<body>
<div id="apDiv1">
</div>
</body>
</html>
You can change properties for AP Divs (or any AP element) on your page, including x and y coordinates, z-index
(also called the stacking order), and visibility.
Insert an AP Div
Dreamweaver lets you easily create and position AP Divs on your page. You can also create nested AP Divs.
When you insert an AP Div, Dreamweaver displays an outline of the AP Div in Design view by default, and highlights
theblockwhenyoumovethepointeroverit.YoucandisablethevisualaidthatshowsAPDiv(oranyAPelement)
outlines by disabling both AP Element Outlines and CSS Layout Outlines in the View > Visual Aids menu. You can
also enable backgrounds and the box model for AP elements as a visual aid while you design.
After you create an AP Div, you can add content to it by simply placing your insertion point in the AP Div, and then
adding content just as you would add content to a page.
See also
“Select AP elements” on page 157
“Change the highlight color of div tags” on page 164
“Visualizing CSS layout blocks” on page 164
Draw a single AP Div or multiple AP Divs consecutively
1In the Layout category of the Insert bar, click the Draw AP Div button .
2In the Document window’s Design view, do one of the following:
•Drag to draw a single AP Div.
•Control-drag (Windows) or Command-drag (Macintosh) to draw multiple AP Divs consecutively.
You can continue to draw new AP Divs as long as you do not release the Control or Command key.
September 4, 2007
DREAMWEAVER CS3
User Guide
153
Insert an AP Div at a particular place in the document
❖Place the insertion point in the Document window, and then select Insert > Layout Objects > AP Div.
Note: ThisprocedureplacesthetagfortheAPDivwhereveryouclickedintheDocumentwindow.Thevisualrendering
of the AP Div may thus affect other page elements (like text) that surround it.
Place the insertion point in an AP Div
❖Click anywhere inside the AP Div’s borders.
The AP Div’s borders are highlighted, and the selection handle appears, but the AP Div itself is not selected.
Show AP Div borders
❖Select View > Visual Aids and select either AP Div Outlines or CSS Layout Outlines.
Note: Selecting both options simultaneously has the same effect.
Hide AP Div borders
❖Select View > Visual Aids and deselect both AP Div Outlines and CSS Layout Outlines.
Work with nested AP Divs
AnestedAPDivisanAPDivthathascodecontainedwithinthetagsofanotherAPDiv.Forexample,thefollowing
code shows two AP Divs that are not nested, and two AP Divs that are nested:
<div id="apDiv1"></div>
<div id="apDiv2"></div>
<div id="apDiv3">
<div id="apDiv4"></div>
</div>
The graphical depiction for either set of AP Divs might look as follows:
Inthefirstsetofdivtags,onedivissittingontopoftheotheronthepage.Inthesecondset,theapDiv4divisactually
inside of the apDiv3 div. (You can change AP Div stacking order in the AP Elements panel.)
Nesting is often used to group AP Divs together. A nested AP Div moves with its parent AP Div and can be set to
inherit visibility from its parent.
You can enable the Nesting option to automatically nest when you draw an AP Div starting inside another AP Div.
To draw inside or over another AP Div, you must also have the Prevent overlaps option deselected.
Draw a nested AP Div
1Make sure Prevent overlaps is deselected in the AP Elements panel (Window > AP Elements).
September 4, 2007
DREAMWEAVER CS3
User Guide
154
2In the Layout category of the Insert bar, click the Draw AP Div button .
3In the Document window’s Design view, drag to draw an AP Div inside an existing AP Div.
If Nesting is disabled in AP Elements preferences, Alt-drag (Windows) or Option-drag (Macintosh) to nest an AP
Div inside an existing AP Div.
Nested AP Divs may appear differently in different browsers. When you create nested AP Divs, check their
appearance in various browsers frequently during the design process.
Insert a nested AP Div
1Make sure Prevent overlaps is deselected.
2Place the insertion point inside an existing AP Div in the Document window’s Design view, then select Insert >
Layout Objects > AP Div.
Nest an existing AP element inside another using the AP Elements panel
1Select Window > AP Elements to open the AP Elements panel.
2Select an AP element in the AP Elements panel, then Control-drag (Windows) or Command-drag (Macintosh)
the AP element to the target AP element in the AP Elements panel.
3Release the mouse button when the name of the target AP element is highlighted.
Nest AP Divs automatically when you draw an AP Div inside another AP Div
❖Select the Nesting option in the AP Elements preferences.
View or set AP element preferences
Use the AP Elements category in the Preferences dialog box to specify the default settings for new AP elements you
create.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select AP elements from the Category list on the left and specify any of the following preferences, and then click OK.
Visibility Determines whether AP elements are visible by default. The options are default, inherit, visible, and
hidden.
Width and Height Specify a default width and height (in pixels) for AP elements you create using Insert > Layout
Objects > AP Div.
Background Color Specifies a default background color. Select a color from the color picker.
Background Image Specifies a default background image. Click Browse to locate the image file on your computer.
Nesting: Nest When Created Within An AP Div Specifies whether an AP Div that you draw starting from a point
within the boundaries of an existing AP Div should be a nested AP Div. Hold down Alt (Windows) or Option
(Macintosh) to temporarily change this setting while you’re drawing an AP Div.
Netscape 4 Compatibility: Add Resize Fix When Inserting AP Element InsertsJavaScriptcodeintheheadcontentof
the document to fix a known problem in Netscape 4 browsers that causes AP elements to lose their positioning
coordinates when a visitor resizes a browser window.
The JavaScript forces the page to reload each time the browser window is resized, re-assigning the AP elements to
the correct position. You can also add or remove the JavaScript code manually, by selecting Commands >
Add/Remove Netscape Resize Fix.
September 4, 2007
DREAMWEAVER CS3
User Guide
155
View or set properties for a single AP element
When you select an AP element, the Property inspector displays AP element properties.
1Select an AP element.
2In the Property inspector (Window > Properties), click the expander arrow in the lower-right corner, if it isn’t
already expanded, to see all properties.
3Set any of the following options:
CSS-P Element Specifies an ID for the selected AP element. The ID identifies the AP element in the AP Elements
panel and in JavaScript code.
Use only standard alphanumeric characters; do not use special characters such as spaces, hyphens, slashes, or
periods. Every AP element must have its own unique ID.
Note: The CSS-P Property inspector presents the same options for relatively-positioned elements.
L and T (left and top) Specify the position of the AP element’s upper-left corner relative to the upper-left corner of
the page, or of the parent AP element if nested.
W and H Specify the width and height of the AP element.
Note: If the content of the AP element exceeds the specified size, the bottom edge of the AP element (as it appears in the
Design view in Dreamweaver) stretches to accommodate the content. (The bottom edge doesn’t stretch when the AP
element appears in a browser, unless the Overflow property is set to Visible.)
The default unit for position and size is pixels (px). You can instead specify the following units: pc (picas), pt (points),
in (inches), mm (millimeters), cm (centimeters), or % (percentage of the parent AP element’s corresponding value).
The abbreviations must follow the value without a space: for example, 3mm indicates 3 millimeters.
Z-Index Determines the z-index, or stacking order, of the AP element.
In a browser, higher-numbered AP elements appear in front of lower-numbered AP elements. Values can be positive
or negative. It’s easier to change the stacking order of AP elements using the AP Elements panel than to enter specific
z-index values.
Vis Specifies whether the AP element is initially visible or not. Select from the following options:
•Default does not specify a visibility property. When no visibility is specified, most browsers default to Inherit.
•Inherit uses the visibility property of the AP element’s parent.
•Visible displays the AP element contents, regardless of the parent’s value.
•Hidden hides the AP element contents, regardless of the parent’s value.
Use a scripting language, such as JavaScript, to control the visibility property and dynamically display AP element
contents.
Bg Image Specifies a background image for the AP element.
Click the folder icon to browse to and select an image file.
September 4, 2007
DREAMWEAVER CS3
User Guide
156
Bg Color Specifies a background color for the AP element.
Leave this option blank to specify a transparent background.
Class Specifies the CSS class used to style the AP element.
Overflow Controls how AP elements appear in a browser when the content exceeds the AP element’s specified size.
Visible indicates that the extra content appears in the AP element; effectively, the AP element stretches to accom-
modate it. Hidden specifies that extra content is not displayed in the browser. Scroll specifies that the browser should
add scroll bars to the AP element whether they’re needed or not. Auto causes the browser to display scroll bars for
the AP element only when needed (that is, when the AP element’s contents exceed its boundaries.)
Note: The overflow option has uneven support across browsers.
Clip Defines the visible area of an AP element.
Specify left, top, right, and bottom coordinates to define a rectangle in the coordinate space of the AP element
(counting from the upper-left corner of the AP element). The AP element is “clipped” so that only the specified
rectangle is visible. For example, to make an AP element’s contents invisible except for a 50-pixel-wide, 75-pixel-high
visible rectangle at the upper-left corner of the AP element, set L to 0, T to 0, R to 50, and B to 75.
Note: Although CSS specifies different semantics for clip, Dreamweaver interprets clip the way that most browsers do.
4If you entered a value in a text box, press Tab or Enter (Windows) or Return (Macintosh) to apply the value.
View or set properties for multiple AP elements
When you select two or more AP elements, the Property inspector displays text properties and a subset of the full
AP element properties, allowing you to modify several AP elements at once.
Select multiple AP elements
❖Hold down Shift while selecting AP elements.
View and set properties for multiple AP elements
1Select multiple AP elements.
2In the Property inspector (Window > Properties), click the expander arrow in the lower-right corner, if it isn’t
already expanded, to see all properties.
3Set any of the following properties for multiple AP elements:
L and T (left and top) Specify the position of the AP elements’ upper-left corners relative to the upper-left corner of
the page, or of the parent AP element if nested.
W and H Specify the width and height of the AP elements.
Note: If the content of any AP element exceeds the specified size, the bottom edge of the AP element (as it appears in the
Design view in Dreamweaver) stretches to accommodate the content. (The bottom edge doesn’t stretch when the AP
element appears in a browser, unless the Overflow property is set to Visible.)
September 4, 2007
DREAMWEAVER CS3
User Guide
157
The default unit for position and size is pixels (px). You can instead specify the following units: pc (picas), pt (points),
in (inches), mm (millimeters), cm (centimeters), or % (percentage of the parent AP element’s corresponding value).
The abbreviations must follow the value without a space: for example, 3mm indicates 3 millimeters.
Vis Specifies whether the AP elements are initially visible or not. Select from the following options:
•Default does not specify a visibility property. When no visibility is specified, most browsers default to Inherit.
•Inherit uses the visibility property of the AP elements’ parent.
•Visible displays the AP elements’ contents, regardless of the parent’s value.
•Hidden hides the AP element contents, regardless of the parent’s value.
Use a scripting language, such as JavaScript, to control the visibility property and dynamically display AP element
contents.
Tag Specifies the HTML tag used to define the AP elements.
Bg Image Specifies a background image for the AP elements.
Click the folder icon to browse to and select an image file.
Bg Color Specifies a background color for the AP elements. Leave this option blank to specify a transparent
background.
4If you entered a value in a text box, press Tab or Enter (Windows) or Return (Macintosh) to apply the value.
AP Elements panel overview
You use the AP Elements panel (Window > AP Elements) to manage the AP elements in your document. Use the AP
Elements panel to prevent overlaps, to change the visibility of AP elements, to nest or stack AP elements, and to select
one or more AP elements.
Note: An AP element in Dreamweaver is an HTML page element—specifically, a div tag, or any other tag—that has an
absolute position assigned to it. The AP Elements panel does not display relatively-positioned elements.
AP elements are displayed as a list of names, in order of z-index; by default, the first created AP element (with a
z-indexof1)appearsatthebottomofthelist,andthemostrecentlycreatedAPelementappearsatthetop.Youcan,
however, change the z-index of an AP element by changing its place in the stacking order. For example, if you created
eight AP elements and wanted to move the fourth AP element to the top, you could assign it a higher z-index than
the others.
Select AP elements
You can select one or more AP elements to manipulate them or change their properties.
Select an AP element in the AP elements panel
❖In the AP elements panel (Window > AP elements), click the name of the AP element.
Select an AP element in the Document window
❖Do one of the following:
•Click an AP element’s selection handle.
If the selection handle isn’t visible, click anywhere inside the AP element to make the handle visible.
•Click an AP element’s border.
September 4, 2007
DREAMWEAVER CS3
User Guide
158
•Control-Shift-click (Windows) or Command-Shift-click (Macintosh) inside an AP element.
•Click inside an AP element and press Control+A (Windows) or Command+A (Macintosh) to select the contents
of the AP element. Press Control+A or Command+A again to select the AP element.
•Click inside an AP element and select its tag in the tag selector.
Select multiple AP elements
❖Do one of the following:
•In the AP Elements panel (Window > AP Elements), Shift-click two or more AP element names.
•In the Document window, Shift-click inside or on the border of two or more AP elements.
Change the stacking order of AP elements
Use the Property inspector or the AP Elements panel to change the stacking order of AP elements. The AP element
at the top of the AP Elements panel list is at the top of the stacking order, and appears in front of the other AP
elements.
In HTML code, the stacking order, or z-index, of the AP elements determines the order in which they are drawn in
a browser. The higher the z-index of an AP element, the higher that AP element is in the stacking order. You can
change the z-index for each AP element using the AP Elements panel or Property inspector.
Change the stacking order of AP elements using the AP Elements panel
1Select Window > AP Elements to open the AP Elements panel.
2Drag an AP element up or down to the desired stacking order.
A line appears as you move the AP element, indicating where the AP element will appear. Release the mouse button
when the placement line appears in the desired place in the stacking order.
Change the stacking order of AP elements using the Property inspector
1Select Window > AP Elements to open the AP Elements panel to see the current stacking order.
2Select an AP element in the AP Elements panel or in the Document window.
3In the Property inspector (Window > Properties), type a number in the Z-Index text box.
•Type a higher number to move the AP element up in the stacking order.
•Type a lower number to move the AP element down in the stacking order.
Show and hide AP elements
While working on your document, you can show and hide AP elements manually, using the AP Elements panel, to
see how the page will appear under different conditions.
Note: The currently selected AP element always becomes visible and appears in front of other AP elements while it’s
selected.
Change AP element visibility
1Select Window > AP Elements to open the AP Elements panel.
2Click in the eye icon column for an AP element to change its visibility.
•An open eye means the AP element is visible.
September 4, 2007
DREAMWEAVER CS3
User Guide
159
•A closed eye means the AP element is invisible.
•If there is no eye icon, usually the AP element inherits visibility from its parent. (When AP elements are not nested,
the parent is the document body, which is always visible.)
Also, no eye icon appears when no visibility is specified (which appears in the Property inspector as Default
visibility).
Change the visibility of all AP elements at once
❖In the AP Elements panel (Window > AP Elements), click the header eye icon at the top of the column.
Note: This procedure can set all AP elements to visible or hidden, but not to inherit.
Resize AP elements
You can resize an individual AP element, or simultaneously resize multiple AP elements to make them the same
width and height.
IfthePreventOverlapsoptionison,youwillnotbeabletoresizeanAPelementsothatitoverlapswithanotherAP
element.
See also
“Use the layout grid” on page 175
Resize an AP element
1In Design view, select an AP element.
2Do one of the following to resize the AP element:
•To resize by dragging, drag any of the AP element’s resize handles.
•To resize one pixel at a time, hold down Control (Windows) or Option (Macintosh) while pressing an arrow key.
ThearrowkeysmovetherightandbottombordersoftheAPelement;youcan’tresizeusingthetopandleftborders
with this technique.
•To resize by the grid snapping increment, hold down Shift-Control (Windows) or Shift-Option (Macintosh) while
pressing an arrow key.
•In the Property inspector (Window > Properties), type values for width (W) and height (H).
Resizing an AP element changes the width and height of the AP element. It does not define how much of the AP
element’s content is visible. You can define the visible region within an AP element in preferences.
Resize multiple AP elements at once
1In the Design view, select two or more AP elements.
2Do one of the following:
•Select Modify > Arrange > Make Same Width Or Modify > Arrange > Make Same Height.
The first selected AP elements conform to the width or height of the last selected AP element.
•In the Property inspector (Window > Properties), under Multiple CSS-P Element, enter width and height values.
The values are applied to all selected AP elements.
September 4, 2007
DREAMWEAVER CS3
User Guide
160
Move AP elements
You can move AP elements in the Design view in much the same way that you move objects in most basic graphics
applications.
If the Prevent Overlaps option is on, you will not be able to move a AP element so that it overlaps another AP
element.
1In the Design view, select an AP element or multiple AP elements.
2Do one of the following:
•To move by dragging, drag the selection handle of the last selected AP element (highlighted in black).
•To move one pixel at a time, use the arrow keys.
Hold down the Shift key while pressing an arrow key to move the AP element by the current grid-snapping
increment.
See also
“Use the layout grid” on page 175
Align AP elements
Use the AP element alignment commands to align one or more AP elements with a border of the last AP element
selected.
When you align AP elements, child AP elements that aren’t selected may move because their parent AP element is
selected and moved. To prevent this, don’t use nested AP elements.
1In the Design view, select the AP element.
2Select Modify > Arrange, and then select an alignment option.
For example, if you select Top, all of the AP elements move so that their top borders are in the same vertical position
as the top border of the last selected AP element (highlighted in black).
Converting AP elements to tables
Instead of using tables or Layout mode to create your layout, some web designers prefer to work with AP elements.
Dreamweaver enables you to create your layout using AP elements, then (if you want) convert them into tables. For
example, you might need to convert your AP elements to tables if you need to support browsers before version 4.0.
Converting AP elements to tables, however, is highly discouraged because it can result in tables with a large number
of empty cells, not to mention bloated code. If you need a page layout that uses tables, it is best to create that page
layout using the standard table layout tools available in Dreamweaver.
You can convert back and forth between AP elements and tables to adjust the layout and optimize page design.
(When you convert a table back to AP elements, however, Dreamweaver converts the table back to AP Divs,
regardless of the type of AP element you might have had on the page before the conversion to tables.) You cannot
convert a specific table or AP element on a page; you must convert AP elements to tables and tables to AP Divs for
an entire page.
Note: You can’t convert AP elements to tables or tables to AP Divs in a template document or in a document to which a
template has been applied. Instead, create your layout in a non-template document and convert it before saving it as a
template.
September 4, 2007
DREAMWEAVER CS3
User Guide
161
Convert between AP elements and tables
You can create your layout using AP elements, then convert the AP elements to tables so that your layout can be
viewed in older browsers.
Beforeyouconverttotables,makesureAPelementsdonotoverlap.Also,makesureyou’reinStandardMode(View
> Table Mode > Standard Mode).
Convert AP elements to a table
1Select Modify > Convert > AP Divs To Table.
2Specify any of the following options and click OK:
Most Accurate Creates a cell for every AP element, plus any additional cells that are necessary to preserve the space
between AP elements.
Smallest: Collapse Empty Cells Specifies that the AP elements’ edges should be aligned if they are positioned within
the specified number of pixels.
Ifyouselectthisoption,theresultingtablewillhavefeweremptyrowsandcolumns,butmaynotmatchyourlayout
precisely.
Use Transparent GIFs Fills the table’s last row with transparent GIFs. This ensures that the table is displayed with the
same column widths in all browsers.
When this option is enabled, you cannot edit the resulting table by dragging its columns. When this option is
disabled, the resulting table will not contain transparent GIFs, but the widths of the columns may vary from browser
to browser.
Center On Page Centers the resulting table on the page. If this option is disabled, the table starts at the left edge of
the page.
Convert tables to AP Divs
1Select Modify > Convert > Tables to AP Divs.
2Specify any of the following options and click OK:
Prevent AP Element Overlaps Constrains the positions of AP elements when they are created, moved, and resized so
that they don’t overlap.
Show AP Elements Panel Displays the AP elements panel.
Show Grid and Snap To Grid Let you use a grid to help position AP elements.
The tables are converted to AP Divs. Empty cells are not converted to AP elements unless they have background
colors.
Note: Page elements that were outside of tables are also placed in AP Divs.
Prevent AP element overlaps
Because table cells cannot overlap, Dreamweaver cannot create a table from overlapping AP elements. If you plan to
convert the AP elements in a document to tables, use the Prevent Overlap option to constrain AP element movement
and positioning so that AP elements don’t overlap.
September 4, 2007
DREAMWEAVER CS3
User Guide
162
When this option is on, an AP element can’t be created in front of, moved or resized over, or nested within an existing
AP element. If you activate this option after creating overlapping AP elements, drag each overlapping AP element to
move it away from other AP elements. Dreamweaver does not automatically fix existing overlapping AP elements in
the page when you enable Prevent AP element Overlaps.
When this option and snapping are enabled, an AP element won’t snap to the grid if it would cause two AP elements
to overlap. Instead, it will snap to the edge of the closest AP element.
Note: CertainactionsallowyoutooverlapAPelementsevenwhenthePreventOverlapsoptionisenabled.Ifyouinsert
an AP element using the Insert menu, enter numbers in the Property inspector, or reposition AP elements by editing the
HTML source code, you can cause AP elements to overlap or nest while this option is enabled. If overlaps happen, drag
overlapping AP elements in the Design view to separate them.
•In the AP Elements panel (Window > AP Elements), select the Prevent Overlaps option.
•In the Document window, select Modify > Arrange > Prevent AP Element Overlaps.
Working with div tags
About working with div tags
You can create page layouts by manually inserting div tags and applying CSS positioning styles to them. A div tag
is a tag that defines logical divisions within the content of a web page. You can use div tags to center blocks of
content, create column effects, create different areas of color, and much more.
If you’re unfamiliar using div tags and Cascading Style Sheets (CSS) to create web pages, you can create a CSS layout
based on one of the pre-designed layouts that come with Dreamweaver. If you’re uncomfortable working with CSS,
but are familiar with using tables, you can also try using tables.
Note: Dreamweaver treats all div tags with an absolute position as AP elements (absolutely positioned elements), even
if you didn’t create those div tags using the AP Div drawing tool.
See also
“About AP elements in Dreamweaver” on page 151
“Create a page with a CSS layout” on page 149
“Presenting content with tables” on page 176
Insert div tags
Yo u c a n u s e div tags to create CSS layout blocks and position them in your document. This is useful if you have an
existing CSS style sheet with positioning styles attached to your document. Dreamweaver enables you to quickly
insert a div tag and apply existing styles to it.
1In the Document window, place the insertion point where you want the div tag to appear.
2Do one of the following:
•Select Insert > Layout Objects > Div Tag.
•In the Layout category of the Insert bar, click the Insert Div Tag button .
September 4, 2007
DREAMWEAVER CS3
User Guide
163
3Set any of the following options:
Insert Lets you select the location of the div tag (either at the insertion point, before or after the tag, or before or
after the start of the tag) and the tag name if it is not a new tag.
Class Displays the class style currently applied to the tag. If you attached a style sheet, classes defined in that style
sheet appear in the list. Use this pop-up menu to do any of the following:
•Select the style you want to apply to the tag.
•Select None to remove the currently selected style.
•Select Attach Style Sheet to open a dialog box that lets you attach an external style sheet.
Div ID Lets you change the name used to identify the div tag.Ifyouattachedastylesheet,IDsdefinedinthatstyle
sheet appear in the list. IDs for blocks that are already in your document are not listed.
Note: Dreamweaver alerts you if you enter the same ID as another tag in your document.
Edit CSS Opens the CSS Styles panel.
4Click OK.
The div tagappearsasaboxinyourdocumentwithplaceholdertext.Whenyoumovethepointerovertheedgeof
the box, Dreamweaver highlights it.
If the div tag is absolutely positioned, it becomes an AP element. (You can edit div tags that aren’t absolutely
positioned.)
See also
“About AP elements in Dreamweaver” on page 151
“Create a page with a CSS layout” on page 149
Edit div tags
After you insert a div tag, you can manipulate it or add content to it.
Note: Div tags that are absolutely positioned become AP elements.
When you assign borders to div tags, or when you have CSS Layout Outlines selected, they have visible borders. (CSS
Layout Outlines is selected by default in the View > Visual Aids menu.) When you move the pointer over a div tag,
Dreamweaver highlights the tag. You can change the highlight color or disable highlighting.
When you select a div tag,youcanviewandeditrulesforitintheCSSStylespanel.Youcanalsoaddcontenttothe
div tag by simply placing your insertion point inside the div tag, and then adding content just as you would add
content to a page.
See also
“About AP elements in Dreamweaver” on page 151
“Open the CSS Styles panel” on page 128
View and edit rules applied to a div tag
1Do one of the following to select the div tag:
•Click the border of the div tag.
September 4, 2007
DREAMWEAVER CS3
User Guide
164
Look for the highlighting to see the border.
•Click inside the div tag, and press Control+A (Windows) or Command+A (Macintosh) twice.
•Click inside the div tag, then select the div tag from the tag selector at the bottom of the Document window.
2Select Window > CSS Styles to open the CSS Styles panel if it is not already open.
Rules applied to the div tag appear in the panel.
3Make edits as necessary.
Place the insertion point in a div tag to add content
❖Click anywhere inside the tag’s borders.
Change the placeholder text in a div tag
❖Select the text, and then type over it or press Delete.
Note: You can add content to the div tag just as you would add content to a page.
Change the highlight color of div tags
When you move the pointer over the edge of a div tag in Design view, Dreamweaver highlights the borders of the
tag. You can enable or disable highlighting as necessary, or change the highlight color in the Preferences dialog box.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select Highlighting from the category list on the left.
3Make either of the following changes and click OK:
•To change the highlighting color for div tags, click the Mouse-Over color box, and then select a highlight color
using the color picker (or enter the hexadecimal value for the highlight color in the text box).
•To enable or disable highlighting for div tags, select or deselect the Show checkbox for Mouse-Over.
Note: These options affect all objects, such as tables, that Dreamweaver highlights when you move the pointer over them.
Visualizing CSS layout blocks
You can visualize CSS layout blocks while you work in Design view. A CSS layout block is an HTML page element
that you can position anywhere on your page. More specifically, a CSS layout block is either a div tag without
display:inline, or any other page element that includes the display:block,position:absolute, or
position:relative CSS declarations. Following are a few examples of elements that are considered CSS layout
blocks in Dreamweaver:
•Adiv tag
•An image with an absolute or relative position assigned to it
•An a tag with the display:block style assigned to it
•A paragraph with an absolute or relative position assigned to it
Note: For purposes of visual rendering, CSS layout blocks do not include inline elements (that is, elements whose code
falls within a line of text), or simple block elements like paragraphs.
September 4, 2007
DREAMWEAVER CS3
User Guide
165
Dreamweaver provides a number of visual aids for viewing CSS layout blocks. For example, you can enable outlines,
backgrounds, and the box model for CSS layout blocks while you design. You can also view tooltips that display
properties for a selected CSS layout block when you float the mouse pointer over the layout block.
The following list of CSS layout block visual aids describes what Dreamweaver renders as visible for each:
CSS Layout Outlines Displays the outlines of all CSS layout blocks on the page.
CSS Layout Backgrounds Displays temporarily assigned background colors for individual CSS layout blocks, and
hides any other background colors or images that normally appear on the page.
Whenever you enable the visual aid to view CSS layout block backgrounds, Dreamweaver automatically assigns each
CSS layout block a distinct background color. (Dreamweaver selects the colors using an algorithmic process—there
is no way for you to assign the colors yourself.) The assigned colors are visually distinctive, and are designed to help
you differentiate between CSS layout blocks.
CSS Layout Box Model Displays the box model (that is, padding and margins) of the selected CSS layout block.
View CSS layout blocks
You can enable or disable CSS layout block visual aids as necessary.
View CSS layout block outlines
❖Select View > Visual Aids > CSS Layout Outlines.
View CSS layout block backgrounds
❖Select View > Visual Aids > CSS Layout Backgrounds.
View CSS layout block box models
❖Select View > Visual Aids > CSS Layout Box Model.
You can also access CSS layout block visual aid options by clicking the Visual Aids button on the Document toolbar.
Use visual aids with non-CSS layout block elements
You can use a Design-time style sheet to display the backgrounds, borders, or box model for elements that aren’t
normally considered CSS layout blocks. To do so, you must first create a Design-time style sheet that assigns the
display:block attribute to the appropriate page element.
1Create an external CSS style sheet by selecting File > New, selecting Basic page in the Category column, selecting
CSS in the Basic page column, and clicking Create.
2In the new style sheet, create rules that assign the display:block attribute to the page elements you want to
display as CSS layout blocks.
For example, if you wanted to display a background color for paragraphs and list items, you could create a style sheet
with the following rules:
p{
display:block;
}
li{
display:block;
}
3Save the file.
September 4, 2007
DREAMWEAVER CS3
User Guide
166
4In Design view, open the page to which you want to attach the new styles.
5Select Text > CSS Styles > Design-time.
6In the Design-time Style Sheets dialog box, click the plus (+) button above the Show Only at Design Time text box,
select the style sheet you just created, and click OK.
7Click OK to close the Design-time Style Sheets dialog box.
The style sheet is attached to your document. If you had created a style sheet using the previous example, all
paragraphsandlistitemswouldbeformattedwiththedisplay:block attribute, thereby allowing you to enable or
disable CSS layout block visual aids for paragraphs and list items.
See also
“Use Design-Time style sheets” on page 143
Animating AP elements
About animating AP elements
Dynamic HTML, or DHTML, refers to the combination of HTML with a scripting language that allows you to
change the style or positioning properties of HTML elements. Timelines in Dreamweaver use dynamic HTML to
change the properties of AP elements and images over time. Use timelines to create animations that do not require
any ActiveX controls, plug-ins, or Java applets (but do require JavaScript).
Note: The word “dynamic” can mean different things in different web-related contexts. Don’t confuse Dynamic HTML
with the idea of a dynamic web page, which means a web page generated dynamically by server-side code before being
served to a visitor.
Timelines allow you to change the position, size, visibility, and stacking order of an AP element. (The AP element
functions of timelines work only in 4.0 or later browsers.) Timelines are also useful for other actions that you want
to occur after a page loads. For example, timelines can change the source file of an image tag so different images
appear in the page over time.
To see the JavaScript code generated by a timeline, open the Document window’s Code view. The timeline code is in
the MM_initTimelines() function, inside a script tag in the head section of the document.
When editing the HTML of a document containing timelines, make sure you do not move, rename, or delete
anything that a timeline refers to.
See also
“About AP elements in Dreamweaver” on page 151
Timelines panel overview
The Timelines panel shows how the properties of AP elements and images change over time. Select Window >
Timelines to open the Timelines panel.
September 4, 2007
DREAMWEAVER CS3
User Guide
167
A. Keyframes B. Timelines pop-up menu C. Frame numbers D. Behaviors channel E. Animation channel F. Animation bars G. Playback
head
Keyframes Define frames in a bar where you have specified properties (such as position) for the object.
Dreamweaver calculates intermediate values for frames in between keyframes. Small circles mark keyframes.
Behaviors channel Shows the behaviors that should be executed at a particular frame in the timeline.
Timelines pop-up menu Specifies which of the document’s timelines is currently displayed in the Timelines panel.
Animation channel Displays bars for animating AP elements and images.
Animation bars Show the duration of each object’s animation. A single row can include multiple bars representing
different objects. Different bars cannot control the same object in the same frame.
Playback head Shows which frame of the timeline is currently displayed in the Document window.
Frame numbers Indicate the sequential numbering of frames. The number between the Back and Play buttons is the
current frame number. You control the duration of animation by setting the total number of frames and the number
of frames per second (fps). The default setting of 15 frames per second is a good average rate to use for most browsers
running on common Windows and Macintosh systems.
Note: Faster rates may not improve performance. Browsers always play every frame of the animation, even if they cannot
attain the specified frame rate. The frame rate is ignored if it is higher than the browser can manage.
Context menu Contains various timeline-related commands.
Playback options
The following are the playback options for viewing the animation.
Rewind Moves the playback head to the first frame in the timeline.
Back Moves the playback head one frame to the left. Click Back and hold down the mouse button to play the timeline
backward.
Play Moves the playback head one frame to the right. Click Play and hold down the mouse button to play the
timeline forward.
Autoplay Makes a timeline begin playing automatically when the current page loads in a browser. Autoplay attaches
a behavior to the page’s body tag that executes the Play Timeline action when the page loads.
Loop Makes the current timeline loop indefinitely while the page is open in a browser. Loop inserts the Go to
Timeline Frame behavior in the Behaviors channel after the last frame of the animation. Double-click the behavior’s
marker in the Behaviors channel to edit the parameters for this behavior and change the number of loops.
A
D
B
GF
C
E
September 4, 2007
DREAMWEAVER CS3
User Guide
168
Animate an AP element using the timeline
The most common kind of timeline animation involves moving an AP element along a path. Timelines can move
only AP elements. To make images or text move, create an AP element using the Draw AP Div button on the Insert
bar and then insert images, text, or any other type of content in the AP Div.
Timelines can also change other properties of AP elements and images.
1Move the AP element to where it should be when the animation begins.
2Select Window > Timelines.
3Select the AP element you want to animate.
Make sure you have selected the desired element. Click the AP element marker or the AP element selection handle,
orusetheAPElementspaneltoselectanAPelement.WhenanAPelementisselected,handlesappeararounditas
shown in the following illustration.
A. Click the AP element selection handle to select the AP element B. Selected AP element with image inside
Clicking inside the AP element places a blinking insertion point inside the AP element, but it does not select the AP
element.
4Select Modify > Timeline > Add Object To Timeline or simply drag the selected AP element into the Timelines
panel.
A bar appears in the first channel of the timeline. The name of the AP element appears in the bar.
5Click the keyframe marker at the end of the bar.
6Move the AP element on the page to where it should be at the end of the animation.
A line appears showing the path of the animation in the Document window.
7If you want the AP element to move in a curve, select its animation bar and Control-click (Windows) or
Command-click (Macintosh) a frame in the middle of the bar to add a keyframe at the frame you clicked, or click a
frame in the middle of the animation bar and select Add Keyframe from the context menu.
Repeat this step to define additional keyframes.
8Hold down the Play button to preview the animation on the page.
Repeat the procedure to add additional AP elements and images to the timeline and to create a more complex
animation.
See also
“Insert an AP Div” on page 152
“Resize AP elements” on page 159
Create a timeline by dragging a path
If you want to create an animation with a complex path, it may be more efficient to record the path as you drag the
AP element rather than creating individual keyframes.
1Select an AP element.
A
B
September 4, 2007
DREAMWEAVER CS3
User Guide
169
2Move the AP element to where it should be when animation begins.
Make sure you have selected the AP element; if the insertion point is in the AP element, the AP element is not
selected. To select an AP element, click the AP element marker or the AP element selection handle, or use the AP
Elements panel.
3Select Modify > Timeline > Record Path Of AP element.
4Drag the AP element around the page to create a path.
5Release the AP element at the point where the animation should stop.
Dreamweaver adds an animation bar to the timeline, containing the appropriate number of keyframes.
6In the Timelines panel, click the Rewind button; then hold down the Play button to preview your animation.
See also
“Resize AP elements” on page 159
Modify a timeline
After defining a timeline’s basic components, you can make changes such as adding and removing frames, changing
the start time of the animation, and so on.
•To make the animation play longer, drag the end frame marker to the right. All the keyframes in the animation
shift so that their relative positions remain constant. To prevent the other keyframes from moving, Control-drag
the end frame marker.
•
To make the AP element reach a keyframe position earlier or later, move the keyframe marker left or right in the bar.
•To change the start time of an animation, select one or more of the bars associated with the animation (press Shift
to select more than one bar at a time) and drag left or right.
•To shift the location of an entire animation path, select the entire bar and then drag the object on the page.
Dreamweaver adjusts the position of all keyframes. Making any type of change with an entire bar selected changes
all the keyframes.
•To add or remove frames in the timeline, select Modify > Timeline > Add Frame, or Modify > Timeline > Remove
Frame.
•To make the timeline play automatically when the page opens in a browser, click Autoplay. Autoplay attaches a
behavior to the page that executes the Play Timeline action when the page loads.
•To make the timeline loop continuously, click Loop. Loop inserts the Go To Timeline Frame action in the
Behaviors channel after the last frame of the animation. You can edit the parameters for this behavior to define the
number of loops.
Change image and AP element properties with timelines
In addition to moving AP elements with timelines, you can change the visibility, size, and stacking order of an AP
element; you can also change the source file of an image.
1In the Timelines panel, do one of the following:
•Select an existing keyframe in the bar controlling the object you want to change. (The start and end frames are
always keyframes.)
September 4, 2007
DREAMWEAVER CS3
User Guide
170
•Create a new keyframe by clicking a frame in the middle of the animation bar and choosing Modify > Timeline >
Add Keyframe. You can instead create a new keyframe by Control-clicking (Windows) or Command-clicking
(Macintosh) a frame in the animation bar.
2Define new properties for the object by doing one of the following:
•Tochangethesourcefileofanimage,clickthefoldericonnexttotheSrctextboxinthePropertyinspector,then
browse to and select a new image.
•To change the visibility of an AP element, select inherit, visible, or hidden from the pop-up menu in the Vis text
box of the Property inspector. Alternatively, use the eye icons in the AP Elements panel.
•To change the size of an AP element, drag the AP element’s resize handles or enter new values in the Width and
Height text boxes in the Property inspector. Not all browsers can dynamically change the size of an AP element.
•To change the stacking order of an AP element, enter a new value in the Z-Index text box or use the AP Elements
panel to change the stacking order of the current AP element.
3Hold down the Play button to see the animation.
See also
“Show and hide AP elements” on page 158
“Change the stacking order of AP elements” on page 158
Use multiple timelines
Instead of trying to control all the action on a page with one timeline, it’s easier to work with separate timelines that
control discrete parts of the page. For example, a page might include interactive elements that each trigger a different
timeline.
•To create a new timeline, select Modify > Timeline > Add Timeline.
•To remove the selected timeline, select Modify > Timeline > Remove Timeline. This permanently removes all
animations from the selected timeline.
•To rename the selected timeline, select Modify > Timeline > Rename Timeline or enter a new name in the
Timeline pop-up menu in the Timelines panel.
•To view a different timeline in the Timelines panel, select a new timeline from the Timeline pop-up menu in the
Timelines panel.
Copy and paste animations
Once you have an animation sequence that you like, you can copy it and paste it into another area of the current
timeline, into another timeline in the same document, or into a timeline in another document. You can also copy
and paste multiple sequences at once.
1Click an animation bar to select a sequence. To select multiple sequences, Shift-click multiple animation bars; to
select all sequences, press Control+A (Windows) or Command+A (Macintosh).
2Copy or cut the selection.
3Do one of the following:
•Move the playback head to another spot in the current timeline.
•Select another timeline from the Timeline pop-up menu.
September 4, 2007
DREAMWEAVER CS3
User Guide
171
•Open another document, or create a new one, and then click in the Timelines panel.
4Paste the selection into the timeline.
Animationbarsforthesameobjectcannotoverlap,becauseanAPelementcannotbeintwoplacesatonetime(nor
can an image have two different sources at a time). If the animation bar you are pasting would overlap another
animation bar for the same object, Dreamweaver automatically shifts the selection to the first frame that doesn’t
overlap.
There are two principles to keep in mind when pasting animation sequences into another document:
•If you copy an animation sequence for an AP element and the new document contains an AP element with
the same name, Dreamweaver applies the animation properties to the existing AP element in the new document.
•IfyoucopyananimationsequenceforanAPelementandthenewdocumentdoesnotcontainanAPelementwith
thesamename,DreamweaverpastestheAPelementanditscontentsfromtheoriginaldocumentalongwiththe
animation sequence. To apply the pasted animation sequence to another AP element in the new document, select
Change Object from the context menu and select the name of the second AP element from the pop-up menu.
Delete the pasted AP element if desired.
Apply an animation sequence to a different object
To save time, you can create an animation sequence once and apply it to each of the remaining AP elements in your
document.
1In the Timelines panel, click the animation sequence to select it.
2Select Edit > Copy to copy the sequence.
3Click any frame of the Timelines panel and paste the sequence (Edit > Paste) at that frame.
4Right-click (Windows) or Control-click (Macintosh) the pasted animation sequence and select Change Object
from the context menu.
5In the dialog box that appears, select another object from the pop-up menu and click OK.
6Repeat steps 2 through 4 for any remaining objects that you want to follow the same animation sequence.
You can also change which AP element should be animated after creating an animation sequence; simply follow steps
3 and 4 above (no copying or pasting is necessary).
Rename the timeline
1Select Modify > Timeline > Rename Timeline.
2Enter a new name.
If your document contains the Play Timeline behavior action (for example, if it contains a button that the visitor must
click to start the timeline), you must edit the behavior to reflect the new timeline name.
Animation tips for timelines
The following suggestions can improve the performance of your animations and make creating animations easier:
•Show and hide AP elements instead of changing the source file for multiple-image animations. Switching the
sourcefileofanimagecanslowdowntheanimation,becausethenewimagemustbedownloaded.Therewillbe
no noticeable pauses or missing images if all images are downloaded at once in hidden AP elements before the
animation runs.
September 4, 2007
DREAMWEAVER CS3
User Guide
172
•Extend animation bars to create smoother motion. If animation looks choppy and images jump between
positions, drag the end frame of the AP element’s animation bar to extend the motion over more frames. Making
the animation bar longer creates more data points between the start and end point of the movement and also
makes the object move more slowly. Try increasing the number of frames per second (fps) to improve speed, but
be aware that most browsers running on average systems cannot animate much faster than 15 fps. Test the
animation on different systems with different browsers to find the best settings.
•Don’t animate large bitmaps. Animating large images results in slow animations. Instead, create composites and
move small parts of the image. For example, show a car moving by animating only the wheels.
•Create simple animations. Do not create animations that demand more than current browsers can provide.
Browsers always play every frame in a timeline animation, even when system or Internet performance decreases.
September 4, 2007
173
Chapter 7: Laying out pages with HTML
Adobe® Dreamweaver® CS3 provides layout tools that let you create web pages using HTML tables or frames. The
application also includes rulers, guides, and a grid that let you lay out pages and position elements precisely.
Using visual aids for layout
Set rulers
Rulers help you measure, organize, and plan your layout. They can appear on the left and top borders of the page,
marked in pixels, inches, or centimeters.
•To toggle rulers on and off, select View > Rulers > Show.
•To change the origin, drag the ruler-origin icon (at the upper-left corner of the Design view of the Document
window) anywhere on the page.
•To reset the origin to its default position, select View > Rulers > Reset Origin.
•To change the unit of measure, select View > Rulers, and then select Pixels, Inches, or Centimeters.
Set layout guides
Guides are lines that you drag onto the document from the rulers. They help you place and align objects more
precisely. You can also use guides to measure the size of page elements, or emulate the folds (visible areas) of web
browsers.
To help you align elements, you can snap elements to guides, and snap guides to elements. (Elements must be
absolutely positioned in order for the snap feature to work.) You can also lock guides to prevent them from being
accidentally moved by another user.
Create a horizontal or vertical guide
1Drag from the corresponding ruler.
2Position the guide in the Document window and release the mouse button (reposition the guide by dragging it
again).
Note: By default, guides are recorded as absolute pixel measurements from the top or left side of the document, and are
shownrelativetotheoriginoftheruler.Torecordtheguideasapercentage,presstheShiftkeywhileyoucreateormove
the guide.
Show or hide guides
❖Select View > Guides > Show Guides.
Snap elements to guides
•To snap elements to guides, select View > Guides > Snap to Guides.
•To snap guides to elements, select View > Guides > Guides Snap to Elements.
September 4, 2007
DREAMWEAVER CS3
User Guide
174
Note: When you resize elements, such as absolutely-positioned elements (AP elements), tables, and images, the resized
elements snap to guides.
Lock or unlock all guides
❖Select View > Guides > Lock Guides.
View and move a guide to a specific position
1Hold the mouse pointer over the guide to view its position.
2Double-click the guide.
3Enter the new position in the Move Guide dialog box and click OK.
View the distance between guides
❖Press Control (Windows) or Command (Macintosh) and hold the mouse pointer anywhere between the two
guides.
Note: The unit of measure is the same as the unit of measure used for the rulers.
Emulate the fold (visible area) of a web browser
❖Select View > Guides, and then select a preset browser size from the menu.
Remove a guide
❖Drag the guide off the document.
Change guide settings
❖Select View > Guides > Edit Guides, set the following options, and click OK.
Guide color Specifies the color of the guide lines. Click the color swatch and select a color from the color picker, or
type a hexadecimal number in the text box.
Distance Color Specifies the color of the lines that appear as distance indicators when you hold the mouse pointer
between guides. Click the color swatch and select a color from the color picker, or type a hexadecimal number in the
text box.
Show Guides Makes guides visible in Design view.
Snap to Guides Makes page elements snap to guides as you move elements around the page.
Lock Guides Locks guides in place.
Guides Snap to Elements Snaps guides to elements on the page as you drag guides.
Clear All Clears all guides from the page.
Using guides with templates
When guides are added to a Dreamweaver template, all instances of the template inherit the guides. Guides in
template instances, however, are treated as editable regions, so users can modify them. Modified guides in template
instances are restored to their original location whenever the instance is updated with the master template.
You can also add your own guides to instances of a template. Guides added in this manner are not overwritten when
the template instance is updated with the master template.
September 4, 2007
DREAMWEAVER CS3
User Guide
175
See also
“Align AP elements” on page 160
“Move AP elements” on page 160
Use the layout grid
The grid displays a system of horizontal and vertical lines in the Document window. It is useful for placing objects
precisely. You can make absolutely-positioned page elements automatically snap to the grid as you move them, and
change the grid or control the snapping behavior by specifying grid settings. Snapping works whether or not the grid
is visible.
See also
“Align AP elements” on page 160
“Move AP elements” on page 160
Show or hide the grid
❖Select View > Grid > Show Grid.
Enable or disable snapping
❖Select View > Grid > Snap to Grid.
Change grid settings
1Select View > Grid > Grid Settings.
2Set the options and click OK to apply the changes.
Color Specifies the color of the grid lines. Click the color swatch and select a color from the color picker, or type a
hexadecimal number in the text box.
Show Grid Makes the grid visible in Design view.
Snap to Grid Makes page elements snap to the lines of the grid.
Spacing
Controls how far apart the grid lines are. Enter a number and select Pixels, Inches, or Centimeters from the menu.
Display Specifies whether the grid lines appear as lines or dots.
Note: If Show Grid is not selected, the grid does not appear in the document and no changes are visible.
Use a tracing image
You can use a tracing image as a guide to re-create a page design that was created in a graphics application such as
Adobe Freehand or Fireworks.
A tracing image is a JPEG, GIF, or PNG image that is placed in the background of the Document window. You can
hide the image, set its opacity, and change its position.
The tracing image is visible only in Dreamweaver; it is not visible when you view the page in a browser. When the
tracing image is visible, the page’s real background image and color are not visible in the Document window;
however, the background image and color will be visible when the page is viewed in a browser.
September 4, 2007
DREAMWEAVER CS3
User Guide
176
Place a tracing image in the Document window
1Do one of the following:
•Select View > Tracing Image > Load.
•Select Modify > Page Properties, then click Browse (next to the Tracing Image text box).
2Select an image file, then click Select (Windows) or Choose (Macintosh).
3Specify the transparency for the image by dragging the Image Transparency slider, then click OK.
To switch to another tracing image or change the transparency of the current tracing image at any time, select
Modify > Page Properties.
Show or hide the tracing image
❖Select View > Tracing Image > Show.
Change the position of a tracing image
❖Select View > Tracing Image > Adjust Position.
•To precisely specify the position of the tracing image, enter coordinate values in the X and Y text boxes.
•To move the image 1 pixel at a time, use the arrow keys.
•To move the image 5 pixels at a time, press Shift and an arrow key.
Reset the position of the tracing image
❖Select View > Tracing Image > Reset Position.
The tracing image returns to the upper-left corner of the Document window (0,0).
Align the tracing image to a selected element
1Select an element in the Document window.
2Select View > Tracing Image > Align with Selection.
The upper-left corner of the tracing image is aligned with the upper-left corner of the selected element.
Presenting content with tables
About tables
Tables are a powerful tool for presenting tabular data and for laying out text and graphics on an HTML page. A table
consists of one or more rows; each row consists of one or more cells. Although columns aren’t usually explicitly
specified in HTML code, Dreamweaver enables you to manipulate columns as well as rows and cells.
Dreamweaver provides two ways to view and manipulate tables: Standard mode, in which tables are presented as a
grid of rows and columns, and Layout mode, which allows you to draw, resize, and move boxes on the page while
still using tables for the underlying structure.
Dreamweaver displays the table width and the column width for each table column when the table is selected or
when the insertion point is in the table. Next to the widths are arrows for the table header menu and the column
header menus. Use the menus for quick access to common table-related commands. You can enable or disable the
widths and menus.
September 4, 2007
DREAMWEAVER CS3
User Guide
177
Ifyoudonotseeawidthforthetableorforacolumn,thenthattableorcolumndoesnothaveaspecifiedwidthin
theHTMLcode.Iftwonumbersappear,thenthevisualwidthasitappearsinDesignviewdoesn’tmatchthewidth
specified in the HTML code. This can happen when you resize a table by dragging its lower-right corner or when
you add content to a cell that’s larger than its set width.
For example, if you set a column’s width to 200 pixels and then add content that stretches the width to 250 pixels, two
numbers appear for that column: 200 (the width specified in the code) and (250) in parentheses (the visual width of
the column as it’s rendered on your screen).
Note: You can also lay out your pages using CSS positioning.
See also
“Laying out pages with CSS” on page 145
“Laying out pages in Layout mode” on page 191
Table formatting precedence in HTML
When formatting tables in Design view, you can set properties for the entire table or for selected rows, columns, or
cells in the table. When a property, such as background color or alignment, is set to one value for the whole table and
another value for individual cells, cell formatting takes precedence over row formatting, which in turn takes prece-
dence over table formatting.
The order of precedence for table formatting is as follows:
1Cells
2Rows
3Table
Forexample,ifyousetthebackgroundcolorforasinglecelltoblue,thensetthebackgroundcoloroftheentiretable
to yellow, the blue cell does not change to yellow, since cell formatting takes precedence over table formatting.
Note: When you set properties on a column, Dreamweaver changes the attributes of the td tag corresponding to each
cell in the column.
About splitting and merging table cells
You can merge any number of adjacent cells—as long as the entire selection is a line or a rectangle of cells—to
produce a single cell that spans several columns or rows. You can split a cell into any number of rows or columns,
regardless of whether it was previously merged. Dreamweaver automatically restructures the table (adding any
necessary colspan or rowspan attributes) to create the specified arrangement.
Inthefollowingexample,thecellsinthemiddleofthefirsttworowshavebeenmergedintoasinglecellthatspans
two rows.
September 4, 2007
DREAMWEAVER CS3
User Guide
178
Insert a table and add content
Use the Insert bar or the Insert menu to create a new table. Then, add text and images to table cells the same way that
you add text and images outside of a table.
1In the Design view of the Document window, place the insertion point where you want the table to appear.
Note: If your document is blank, you can place the insertion point only at the beginning of the document.
•Select Insert > Table.
•In the Common category of the Insert bar, click Table.
2Set the attributes of the Table dialog box and click OK to create the table.
Rows Determines the number of table rows.
Columns Determines the number of table columns.
Table Width Specifies the width of the table in pixels, or as a percentage of the browser window’s width.
Border Thickness Specifies the width, in pixels, of the table’s borders.
Cell Spacing Determines the number of pixels between adjacent table cells.
When you don’t explicitly assign values for border thickness or cell spacing and cell padding, most browsers display
the table border thickness and cell padding set to 1 and cell spacing were set to 2. To ensure that browsers display the
table with no border, padding or spacing, set Cell Padding and Cell Spacing to 0.
Cell Padding Determines the number of pixels between a cell’s border and its contents.
None Does not enable column or row headings for the table.
Left Makes the first column of the table a column for headings, so that you can enter a heading for each row of the
table.
Top Makesthefirstrowofthetablearowforheadings,sothatyoucanenteraheadingforeachcolumn of the table.
Both Enables you to enter column and row headings in the table.
It’s a good idea to use headers in case any of your website visitors use screen readers. Screen readers read table
headings and help screen-reader users keep track of table information.
Caption Provides a table title which displays outside of the table.
Align Caption Specifies where the table caption appears in relation to the table.
Summary Provides a table description. Screen readers read the summary text, but the text does not appear in the
user’s browser.
See also
“Adding and formatting text” on page 226
“Adding and modifying images” on page 243
Import and export tabular data
You can import tabular data that has been created in another application (such as Microsoft Excel) and saved in a
delimited text format (with items separated by tabs, commas, colons, or semicolons) into Dreamweaver and format
it as a table.
September 4, 2007
DREAMWEAVER CS3
User Guide
179
You can also export table data from Dreamweaver into a text file, with the contents of adjacent cells separated by a
delimiter. You can use commas, colons, semicolons, or spaces as delimiters. When you export a table, the entire table
is exported; you cannot select portions of a table to export.
If you want only some of the data from a table—for example, the first six rows or the first six columns—then copy
the cells containing that data, paste those cells outside of the table (to create a new table), and export the new table.
Import table data
1Do one of the following:
•Select File > Import > Tabular Data.
•In the Data category of the Insert bar, click the Import Tabular Data icon.
•Select Insert > Table Objects > Import Tabular Data.
2Specify the options for the tabular data and click OK.
Data File The name of the file to import. Click the Browse button to select a file.
Delimiter The delimiter used in the file you’re importing.
If you select Other, a text box appears to the right of the pop-up menu. Enter the delimiter used in your file.
Note: Specify the delimiter that was used when the data file was saved. If you don’t do this, the file will not be imported
properly, and your data will not be correctly formatted in a table.
Table Width The width of the table.
•Select Fit to Data to make each column wide enough to fit the longest text string in the column.
•Select Set to specify a fixed table width in pixels or as a percentage of the browser window’s width.
Border Specifies the width, in pixels, of the tables borders.
Cell Padding The number of pixels between a cell’s content and the cell boundaries.
Cell Spacing The number of pixels between adjacent table cells.
If you don’t explicitly assign values for borders, cell spacing, and cell padding, most browsers display the table with
borders and cell padding set to 1, and cell spacing set to 2. To ensure that browsers display the table with no padding
or spacing, set Cell Padding and Cell Spacing to 0. To view cell and table boundaries when the border is set to 0, select
View > Visual Aids > Table Borders.
Format Top Row Determines what formatting, if any, is applied to the top row of the table. Select from four
formatting options: no formatting, bold, italic, or bold italic.
Export a table
1Place the insertion point in any cell of the table.
2Select File > Export > Table.
3Specify the following options:
Delimiter Specifies which delimiter character should be used to separate items in the exported file.
Line Breaks Specifies which operating system you’ll be opening the exported file in: Windows, Macintosh, or UNIX.
(Different operating systems have different ways of indicating the end of a line of text.)
4Click Export.
5Enter a name for the file and click Save.
September 4, 2007
DREAMWEAVER CS3
User Guide
180
Select table elements
You can select an entire table, row, or column at once. You can also select one or more individual cells.
When you move your pointer over a table, row, column, or cell, Dreamweaver highlights all the cells in that selection
so that you know which cells will be selected. This is useful when you have tables without borders, cells that span
multiple columns or rows, or nested tables. You can change the highlight color in preferences.
If you position the pointer over a table’s border, then hold the Control key (Windows) or Command key (Macintosh),
the entire structure of the table—that is, all cells in the table—is highlighted. This is useful when you have nested
tables and want to see the structure of one of the tables.
Select an entire table
❖Do one of the following:
•Click the upper-left corner of the table, anywhere on the top or bottom edge of the table, or on a row or column’s
border.
Note: Thepointerchangestothetablegridiconwhenyoucanselectthetable(unlessyouclickaroworcolumnborder).
•Click in a table cell, then select the <table> tag in the tag selector at the lower-left corner of the Document
window.
•Click in a table cell, then select Modify > Table > Select Table.
•Click in a table cell, click the table header menu, then select Select Table. Selection handles appear on the selected
table’s lower and right edges .
Select individual or multiple rows or columns
1Position the pointer to point to the left edge of a row or the top edge of a column.
2Whenthepointerchangestoaselectionarrow,clicktoselectaroworcolumn,ordragtoselectmultiplerowsor
columns.
Select a single column
1Click in the column.
2Click the column header menu and choose Select Column.
Select a single cell
❖Do one of the following:
•Click in the cell, then select the <td> tag in the tag selector at the lower-left corner of the Document window.
•Control-click (Windows) or Command-click (Macintosh) in the cell.
September 4, 2007
DREAMWEAVER CS3
User Guide
181
•Click in the cell and select Edit > Select All.
Select Edit > Select All again when a cell is selected to select the entire table.
Select a line or a rectangular block of cells
❖Do one of the following:
•Drag from a cell to another cell.
•Click in one cell, Control-click (Windows) or Command-click (Macintosh) in the same cell to select it, then Shift-
click another cell.
All of the cells within the linear or rectangular region defined by the two cells are selected.
Select nonadjacent cells
❖Control-click (Windows) or Command-click (Macintosh) the cells, rows, or columns you want to select.
If each cell, row, or column you Control-click or Command-click isn’t already selected, it’s added to the selection. If
it is already selected, it’s removed from the selection.
Change the highlight color for table elements
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select Highlighting from the category list on the left, make either of the following changes, and click OK.
•To change the highlighting color for table elements, click the Mouse-Over color box, then select a highlight color
using the color picker (or enter the hexadecimal value for the highlight color in the text box).
•To enable or disable highlighting for table elements, select or deselect the Show option for Mouse-Over.
Note: These options affect all objects, such as absolutely-positioned elements (AP elements) and Layout mode view tables
and cells, that Dreamweaver highlights when you move the pointer over them.
Set table properties
You can use the Property inspector to edit tables.
1Select a table.
2In the Property inspector (Window > Properties), click the expander arrow in the lower-right corner and change
properties as necessary.
Table Id An ID for the table.
Rows and Cols The number of rows and columns in the table.
W and H The width and height of the table in pixels, or as a percentage of the browser window’s width.
Note: You usually don’t need to set the height of a table.
Border Specifies the width, in pixels, of the table’s borders.
September 4, 2007
DREAMWEAVER CS3
User Guide
182
If you don’t explicitly assign values for the border, cell spacing, and cell padding, most browsers display the table with
the border and cell padding set to 1 and cell spacing set to 2. To ensure that browsers display the table with no padding
or spacing, set Border to 0, Cell Padding and Cell Spacing to 0. To view cell and table boundaries when the border is set
to 0, select View > Visual Aids > Table Borders.
CellPad The number of pixels between a cell’s content and the cell boundaries.
CellSpace The number of pixels between adjacent table cells.
Align Determines where the table appears, relative to other elements in the same paragraph, such as text or images.
Left aligns the table to the left of other elements (so that text in the same paragraph wraps around the table to the
right); Right aligns the table to the right of other elements (with text wrapping around it to the left); and Center
centers the table (with text appearing above and/or below the table). Default indicates that the browser should use
its default alignment.
When alignment is set to Default, other content is not displayed next to the table. To display a table next to other
content, use Left or Right alignment.
Clear Column Widths and Clear Row Heights delete all explicitly specified row height or column width values from
the table.
Convert Table Widths To Pixels and Convert Table Heights To Pixels set the width or height of each column in the
table to its current width in pixels (also sets the width of the whole table to its current width in pixels).
Convert Table Widths To Percent and Convert Table Heights To Percent set the width or height of each column in
the table to its current width expressed as a percentage of the Document window’s width (also sets the width of the
whole table to its current width as a percentage of the Document window’s width).
Bg Color The table’s background color.
Brdr Color The color for the table’s borders.
Bg Image The table’s background image.
If you entered a value in a text box, press Tab or Enter (Windows) or Return (Macintosh) to apply the value.
Set cell, row, or column properties
You can use the Property inspector to edit cells and rows in a table.
1Select the column or row.
2In the Property inspector (Window > Properties), set the following options:
Horz Specifies the horizontal alignment of the contents of a cell, row, or column. You can align the contents to the
left, right, or center of the cells, or you can indicate that the browser should use its default alignment (usually left for
regular cells and center for header cells).
Vert Specifies the vertical alignment of the contents of a cell, row, or column. You can align the contents to the top,
middle, bottom, or baseline of the cells, or indicate that the browser should use its default alignment (usually
middle).
W and H The width and height of selected cells in pixels, or as a percentage of the entire table’s width or height. To
specify a percentage, follow the value with a percent symbol (%). To let the browser determine the proper width or
height based on the contents of the cell and the widths and heights of the other columns and rows, leave the field
blank (the default).
September 4, 2007
DREAMWEAVER CS3
User Guide
183
Bydefault,abrowserchoosesarowheightandcolumnwidthtoaccommodateandthewidestimageorthelongest
line in a column. This is why a column sometimes becomes much wider than the other columns in the table when
you add content to it.
Note: You can specify a height as a percentage of the total table height, but the row may not display at the specified
percentage height in browsers.
Bg (upper text field) The filename for the background image for a cell, column, or row. Click the folder icon to
browse to an image, or use the Point-to-File icon to select an image file.
Bg (lower color swatch and text field) The background color for a cell, column, or row, chosen with the color picker.
Brdr The border color for the cells.
Merge Cells Combines selected cells, rows, or columns into one cell. You can merge cells only if they form a rectan-
gular or linear block.
Split Cell Divides a cell, creating two or more cells. You can split only one cell at a time; this button is disabled if more
than one cell is selected.
No Wrap Prevents line wrapping, keeping all the text in a given cell on a single line. If No Wrap is enabled, cells widen
to accommodate all data as you type it or paste it into a cell. (Normally, cells expand horizontally to accommodate
the longest word or widest image in the cell, then expand vertically as necessary to accommodate other contents.)
Header Formats the selected cells as table header cells. The contents of table header cells are bold and centered by
default.
You can specify widths and heights as either pixels or percentages, and you can convert from pixels to percentages
and back.
Note: When you set properties on a column, Dreamweaver changes the attributes of the td tag corresponding to each
cell in the column. When you set certain properties for a row, however, Dreamweaver changes the attributes of the tr
tag rather than changing the attributes of each td tag in the row, When you’re applying the same format to all the cells
in a row, applying the format to the tr tag produces cleaner, more concise HTML code.
3Press Tab or Enter (Windows) or Return (Macintosh) to apply the value.
Use Expanded Tables mode for easier table editing
Expanded Tables mode temporarily adds cell padding and spacing to all tables in a document and increases the
tables’ borders to make editing easier. This mode enables you to select items in tables or precisely place the insertion
point.
Forexample,youmightexpandatabletoplacetheinsertionpointtotheleftorrightofanimage,withoutinadvert-
ently selecting the image or table cell.
Note: After you make your selection or place the insertion point, you should return to the Standard mode of Design view
to make your edits. Some visual operations, such as resizing, will not give expected results in Expanded Tables mode.
Switch to Expanded Tables mode
1If you are working in Code view, select View > Design or View > Code And Design (you cannot switch to
Expanded Tables mode in Code view).
2Do one of the following:
•Select View > Table Mode > Expanded Tables Mode.
•In the Layout category of the Insert bar, click Expanded Tables Mode.
September 4, 2007
DREAMWEAVER CS3
User Guide
184
A bar labeled Expanded Tables Mode appears across the top of the Document window. Dreamweaver adds cell
padding and spacing to all tables on the page and increases the tables’ borders.
Switch out of Expanded Tables mode
❖Do one of the following:
•Click Exit in the bar labeled Expanded Tables Mode at the top of the Document window.
•Select View > Table Mode > Standard Mode.
•In the Layout category of the Insert bar, click Standard Mode.
Format tables and cells
You can change the appearance of tables by setting properties for the table and its cells or by applying a preset design
to the table. Before you set table and cell properties, be aware that the order of precedence for formatting is cells,
rows, and tables.
To format the text inside a table cell, use the same procedures you would use to format text outside of a table.
See also
“Adding and formatting text” on page 226
Change the format of a table, row, cell, or column
1Select a table, cell, row, or column.
2In the Property inspector (Window > Properties), click the expander arrow in the lower-right corner and change
properties as necessary.
3Change the properties as necessary.
For more information on the options, click the Help icon on the Property inspector.
Note: When you set properties on a column, Dreamweaver changes the attributes of the td tag corresponding to each
cell in the column. When you set certain properties for a row, however, Dreamweaver changes the attributes of the tr
tag rather than changing the attributes of each td tag in the row, When you’re applying the same format to all the cells
in a row, applying the format to the tr tag produces cleaner, more concise HTML code.
Add or edit accessibility values for a table in Code view
❖Edit the appropriate attributes in the code.
To quickly locate the tags in the code, click in the table, then select the <table> taginthetagselectoratthebottom
of the Document window.
Add or edit accessibility values for a table in Design view
•To edit the table caption, highlight the caption and type a new caption.
•To edit the caption alignment, place the insertion point in the table caption, right-click (Windows) or
Control-click (Macintosh), then select Edit Tag Code.
•To edit the table summary, select the table, right-click (Windows) or Control-click (Macintosh), then select Edit
Tag Code.
September 4, 2007
DREAMWEAVER CS3
User Guide
185
Resizing tables, columns, and rows
Resizing tables
You can resize an entire table or individual rows and columns. When you resize an entire table, all of the cells in the
table change size proportionately. If a table’s cells have explicit widths or heights specified, resizing the table changes
the visual size of the cells in the Document window but does not change the specified widths and heights of the cells.
You can resize a table by dragging one of its selection handles. Dreamweaver displays the table width, along with a
table header menu, at the top or bottom of the table when the table is selected or the insertion point is in the table.
Sometimes the column widths set in the HTML code do not match their apparent widths on the screen. When this
happens, you can make the widths consistent. Table and column widths and header menus appear in Dreamweaver
to help you lay out your tables; you can enable or disable the widths and menus as necessary.
Resizing columns and rows
You can change the width of a column or the height of a row in the Property inspector or by dragging the borders of
the column or row. If you have trouble resizing, you can clear the column widths or row heights and start over.
Note: You can also change cell widths and heights directly in the HTML code using Code view.
Dreamweaver displays column widths, along with column header menus, at the tops or bottoms of columns when
the table is selected or the insertion point is in the table; you can enable or disable the column header menus as
necessary.
See also
“Working with page code” on page 301
Resize tables, columns, and rows
Resize a table
❖Select the table.
•To resize the table horizontally, drag the selection handle on the right.
•To resize the table vertically, drag the selection handle on the bottom.
•To resize the table in both dimensions, drag the selection handle at the lower-right corner.
Change a column’s width and keep the overall table width
❖Drag the right border of the column you want to change.
The width of the adjacent column also changes, so you actually resize two columns. Visual feedback shows you how
the columns will adjust; the overall table width does not change.
Note: In tables with percentage-based widths (not pixels), if you drag the right border of the rightmost column, the entire
table’s width changes, and all of the columns grow wider or narrow proportionately.
September 4, 2007
DREAMWEAVER CS3
User Guide
186
Change a column’s width and maintain the size of the other columns
❖Hold the Shift key and drag the column’s border.
The width of one column changes. Visual feedback shows you how the columns will adjust; the overall table width
changes to accommodate the column you are resizing.
Change a row’s height visually
❖Drag the lower border of the row.
Make column widths in code consistent with visual widths
1Click in a cell.
2Click the table header menu, then select Make All Widths Consistent.
Dreamweaver resets the width specified in the code to match the visual width.
Clear all set widths or heights in a table
1Select the table.
2Do one of the following:
•Select Modify > Table > Clear Cell Widths, or Modify > Table > Clear Cell Heights.
•In the Property inspector, (Window > Properties), click the Clear Row Heights button or the Clear Column
Widths button .
•Click the table header menu, then select Clear All Heights or Clear All Widths.
Clear a column’s set width
❖Click in the column, click the column header menu, and select Clear Column Width.
Enable or disable table and column widths and menus
1Select View > Visual Aids > Table Widths.
2Right-click (Windows) or Control-click (Macintosh) in the table, then select Table > Table Widths.
September 4, 2007
DREAMWEAVER CS3
User Guide
187
Add and remove rows and columns
To add and remove rows and columns, use the Modify > Table or column header menu.
Pressing Tab in the last cell of a table automatically adds another row to the table.
Add a single row or column
❖Click in a cell and do one of the following:
•Select Modify > Table > Insert Row or Modify > Table > Insert Column.
A row appears above the insertion point or a column appears to the left of the insertion point.
•Click the column header menu, and then select Insert Column Left or Insert Column Right.
Add multiple rows or columns
1Click in a cell.
2Select Modify > Table > Insert Rows Or Columns, complete the dialog box, and click OK.
Insert Indicates whether to insert rows or columns.
Number of Rows or Number Of Columns The number of rows or columns to insert.
Where
Specifieswhetherthenewrowsorcolumnsshouldappearbeforeoraftertheroworcolumnoftheselectedcell.
Delete a row or column
❖Do one of the following:
•Click in a cell within the row or column you want to delete, then select Modify > Table > Delete Row, or Modify >
Table > Delete Column.
•Select a complete row or column, then select Edit > Clear or press Delete.
Add or delete rows or columns using the Property inspector
1Select the table.
2In the Property inspector (Windows > Properties), do one of the following:
•To add or delete rows, increase or decrease the Rows value.
•To add or delete columns, increase or decrease the Cols value.
Note: Dreamweaver does not warn you if you are deleting rows and columns that contain data.
Split and merge cells
Use the Property inspector or the commands in the Modify > Table submenu to split or merge cells.
As an alternative approach to merging and splitting cells, Dreamweaver also provides tools for increasing and
decreasing the number of rows or columns spanned by a cell.
September 4, 2007
DREAMWEAVER CS3
User Guide
188
Merge two or more cells in a table
1Select the cells in a contiguous line and in the shape of a rectangle.
In the following illustration, the selection is a rectangle of cells, so the cells can be merged.
In the following illustration, the selection is not a rectangle, so the cells can’t be merged.
2Do one of the following:
•Select Modify > Table > Merge Cells.
•In the expanded Property inspector (Window > Properties), click Merge Cells .
Note: If you don’t see the button, click the arrow in the lower-right corner of the Property inspector so that you see all
the options.
The contents of the individual cells are placed in the resulting merged cell. The properties of the first cell selected are
applied to the merged cell.
Split a cell
1Click in the cell and do one of the following:
•Select Modify > Table > Split Cell.
•In the expanded Property inspector (Window > Properties), click Split Cell .
Note: If you don’t see the button, click the arrow in the lower-right corner of the Property inspector so that you see all
the options.
2In the Split Cell dialog box, specify how to split the cell:
Split Cell Into Specifies whether to split the cell into rows or columns.
Number Of Rows/Number Of Columns Specifies how many rows or columns to split the cell into.
Increase or decrease the number of rows or columns spanned by a cell
❖Do one of the following:
•Select Modify > Table > Increase Row Span, or Modify > Table > Increase Column Span.
•Select Modify > Table > Decrease Row Span, or Modify > Table > Decrease Column Span.
September 4, 2007
DREAMWEAVER CS3
User Guide
189
Copy, paste, and delete cells
You can copy, paste, or delete a single table cell or multiple cells at once, preserving the cells’ formatting.
You can paste cells at the insertion point or in place of a selection in an existing table. To paste multiple table cells,
thecontentsoftheClipboardmustbecompatiblewiththestructureofthetableortheselectioninthetableinwhich
the cells will be pasted.
Cut or copy table cells
1Select one or more cells in a contiguous line and in the shape of a rectangle.
In the following illustration, the selection is a rectangle of cells, so the cells can be cut or copied.
In the following illustration, the selection is not a rectangle, so the cells can’t be cut or copied.
2Select Edit > Cut or Edit > Copy.
Note: If you selected an entire row or column and you select Edit > Cut, the entire row or column is removed from the
table (not just the contents of the cells).
Paste table cells
1Select where you want to paste the cells:
•To replace existing cells with the cells you are pasting, select a set of existing cells with the same layout as the cells
ontheclipboard.(Forexample,ifyou’vecopiedorcuta3x2blockofcells,youcanselectanother3x2blockof
cells to replace by pasting.)
•To paste a full row of cells above a particular cell, click in that cell.
•To paste a full column of cells to the left of a particular cell, click in that cell.
Note: If you have less than a full row or column of cells in the clipboard, and you click in a cell and paste the cells from
the clipboard, the cell you clicked in and its neighbors may (depending on its location in the table) be replaced with the
cells you are pasting.
•To create a new table with the pasted cells, place the insertion point outside of the table.
2Select Edit > Paste.
September 4, 2007
DREAMWEAVER CS3
User Guide
190
If you are pasting entire rows or columns into an existing table, the rows or columns are added to the table. If you are
pasting an individual cell, the contents of the selected cell are replaced. If you are pasting outside a table, the rows,
columns, or cells are used to define a new table.
Remove cell content but leave the cells intact
1Select one or more cells.
Note: Make sure the selection does not consist entirely of complete rows or columns.
2Select Edit > Clear or press Delete.
Note: If only complete rows or columns are selected when you select Edit > Clear or press Delete, the entire rows or
columns—not just their contents—are removed from the table.
Delete rows or columns that contain merged cells
1Select the row or column.
2Select Modify > Table > Delete Row, or Modify > Table > Delete Column.
Nest tables
A nested table is a table inside a cell of another table. You can format a nested table as you would any other table;
however, its width is limited by the width of the cell in which it appears.
1Click in a cell of the existing table.
2Select Insert > Table, set the Insert Table options, and click OK.
Sort tables
Youcansorttherowsofatablebasedonthecontentsofasinglecolumn.Youcanalsoperformamorecomplicated
table sort based on the contents of two columns.
You cannot sort tables that contain colspan or rowspan attributes—that is, tables that contain merged cells.
1Select the table or click in any cell.
2Select Commands > Sort Table, set the options in the dialog box, and click OK.
Sort By Determines which column’s values will be used to sort the table’s rows.
Order Determines whether to sort the column alphabetically or numerically, and whether to sort it in ascending
order (A to Z, lower numbers to higher numbers) or descending order.
When the contents of a column are numbers, select Numerically. An alphabetic sort applied to a list of one- and two-
digit numbers results in the numbers being sorted as if they were words (resulting in ordering such as 1, 10, 2, 20, 3,
30) rather than being sorted as numbers (resulting in ordering such as 1, 2, 3, 10, 20, 30).
Then By/Order Determines the sorting order for a secondary sort on a different column. Specify the secondary-sort
column in the Then By pop-up menu, and the secondary sort order in the Order pop-up menus.
Sort Includes The First Row Specifies that the first row of the table should be included in the sort. If the first row is a
heading that should not be moved, do not select this option.
Sort Header Rows Specifies to sort all the rows in the table’s thead section (if any) using the same criteria as the body
rows. (Note that thead rows remain in the thead section and still appear at the top of the table even after sorting.)
For information about the thead tag, see the Reference panel (select Help > Reference).
September 4, 2007
DREAMWEAVER CS3
User Guide
191
Sort Footer Rows Specifies to sort all the rows in the table’s tfoot section (if any) using the same criteria as the body
rows. (Note that tfoot rows remain in the tfoot section and still appear at the bottom of the table even after
sorting.) For information about the tfoot tag, see the Reference panel (select Help > Reference).
Keep All Row Colors The Same After The Sort Has Been Completed Specifies that table row attributes (such as color)
should remain associated with the same content after the sort. If your table rows are formatted with two alternating
colors, do not select this option to ensure that the sorted table still has alternating-colored rows. If the row attributes
are specific to the content of each row, then select this option to ensure that those attributes remain associated with
the correct rows in the sorted table.
Laying out pages in Layout mode
About Layout mode
One common method for creating a page layout is to use HTML tables to position elements. Tables were originally
created for displaying tabular data, not for laying out web pages; Dreamweaver provides Layout mode to streamline
the process of using tables for page layout.
In Layout mode, you use layout cells and tables to lay out your page before adding content. For example, you could
draw a cell along the top of your page to hold a header graphic, another cell on the left side of the page to hold a
navigation bar, and a third cell on the right to hold content. As you add content, you can move cells around as
necessary to adjust your layout.
For maximum flexibility, you can draw each cell only when you’re ready to put content into it. This enables you to
leave more blank space in the layout table for a longer time, so that you can move or resize cells more easily.
Layout tables appear outlined in green on your page; layout cells appear outlined in blue on your page. When you
move the pointer over a table cell, Dreamweaver highlights the cell. (You can change default outline and highlight
colors in preferences).
September 4, 2007
DREAMWEAVER CS3
User Guide
192
You can lay out your page using several layout cells within one layout table, which is the most common approach to
web-page layout, or you can use multiple, separate layout tables for more complex layouts. Using multiple layout
tables isolates sections of your layout, so that they aren’t affected by changes in other sections.
You can also nest layout tables, by placing a new layout table inside an existing layout table. This structure enables
you to simplify the table structure when the rows or column in one part of the layout don’t line up with the rows or
columnsinanotherpartofthelayout.Forexample,usingnestedlayouttablesyoucouldeasilycreateatwo-column
layout with four rows in the left column and three rows in the right column.
Note: As an alternative to using tables in Standard or Layout mode, you can use CSS positioning to lay out pages.
See also
“Presenting content with tables” on page 176
“Laying out pages with CSS” on page 145
Viewing table and cell widths in Layout mode
The widths of layout tables and cells (in pixels, or as a percentage of the page width) appear at the top or bottom of
the table when the table is selected or when the insertion point is in the table. Beside the widths are arrows for the
table header menu and the column header menus. Use the menus for quick access to some common commands.
Note: To disable column widths, along with table tabs and header menus, you must disable all visual aids (View > Visual
Aids > Hide All).
Sometimes, the width might not appear for a column; you might see any of the following:
•No width. If you do not see a width for the table or for a column, then that table or column does not have a
specified width in the HTML code.
•Twonumbers.Iftwonumbersappear,thenthevisualwidthasitappearsinDesignviewdoesn’tmatchthewidth
specified in the HTML code. This can happen when you resize a table by dragging its lower-right corner or when
you add content to a cell that’s larger than its set width.
For example, if you set a column’s width to 200 pixels, then add content that stretches the width to 250 pixels, two
numbers appear at the top of that column: 200 (the width specified in the code) and in parentheses (250) (the visual
width of the column as it’s rendered on your screen).
•Wavy line. A wavy line appears for columns that are set to autostretch.
•Double bars. Columns that contain spacer images have double bars around the column width.
Layout table and cells grid lines
When you draw a layout cell in a layout table, a light grid of lines appears, extending from the edges of any new layout
cell out to the edges of the layout table that contains it. These lines help you align new cells with old cells, and help
you visualize the underlying HTML table’s structure. The Dreamweaver grid is set and doesn’t change based on the
placement of cells, so you can use it to lay out your page.
Dreamweaver automatically snaps the edges of new cells into alignment with nearby edges of existing cells. (Layout
cells cannot overlap.) Cell edges also automatically snap to the edges of the containing layout table if you draw a cell
close to the edge of a table.
September 4, 2007
DREAMWEAVER CS3
User Guide
193
See also
“Using visual aids for layout” on page 173
Fixed column width and autostretch columns
A table column in Layout mode can have either a fixed width or a width that automatically expands to fill as much
of the browser window as possible (autostretch).
Fixed-width columns Have a specific numeric width, such as 300 pixels. Dreamweaver displays the column width for
each fixed-width column at the top or bottom of the column.
Autostretch columns Change automatically depending on the browser window’s width. If your layout includes an
autostretch column, the layout always fills the entire width of the visitor’s browser window. You can make only one
column in a given layout table autostretch. An autostretch column displays a wavy line in the column width area.
A common layout is to make the column containing the main content of the page autostretch, which automatically
sets all the other columns to fixed width. For example, suppose your layout has a wide image on the left side of the
page and a column of text on the right. You might set the left column to a fixed width and make the sidebar area
autostretch.
When you make a column autostretch, Dreamweaver inserts spacer images in the fixed width columns to ensure that
those columns stay as wide as they should be, unless you specify that no spacer image should be used. A spacer image
is a transparent image, used to control spacing, that is not visible in the browser window.
Spacer images
A spacer image (also known as a spacer GIF) is a transparent image that’s used to control spacing in autostretch
tables. A spacer image consists of a single-pixel transparent GIF image, stretched out to be a specified number of
pixels wide. A browser can’t draw a table column narrower than the widest image contained in a cell in that column,
so placing a spacer image in a table column requires browsers to keep the column at least as wide as the image.
Dreamweaver automatically adds spacer images when you set a column to autostretch, unless you specify that no
spacer image should be used. You can manually insert and remove spacer images in each column if you prefer.
Columns that contain spacer images have a double bar where the column width appears.
You can manually insert and remove spacer images in specific columns or remove all spacer images in the page.
Switch from Standard to Layout mode
Before you can draw layout tables or layout cells, you must switch from Standard mode into Layout mode. When you
createtablesforlayoutinLayoutmode,butit’sagoodideatoswitchbacktoStandardmodebeforeyouaddcontent
to or edit your tables.
Note: If you create a table in Standard mode, then switch into Layout mode, the resulting layout table might contain
empty layout cells. You might need to delete these empty layout cells before you can create new layout cells or move layout
cells around.
Switch to Layout mode:
1If you are working in Code view, change to Design view by selecting View > Design, or View > Code And Design.
Note: You cannot switch to Layout mode in Code view.
2Select View > Table Mode > Layout Mode.
September 4, 2007
DREAMWEAVER CS3
User Guide
194
A bar labeled Layout Mode appears across the top of the Document window. If there are tables on your page, they
appear as layout tables.
Switch out of Layout mode:
❖Do one of the following:
•Click Exit in the bar labeled Layout Mode at the top of the Document window
•Select View > Table Mode > Standard Mode.
•In the Layout category of the Insert bar, click the Standard Mode button.
Dreamweaver returns to Standard mode.
Draw in Layout mode
Layout mode allows you to draw cells and tables, including tables nested in other tables. The snapping grid helps you
to align cells.
When you draw a layout cell that isn’t inside a layout table, Dreamweaver automatically creates a layout table as a
container for the cell. A layout cell cannot exist outside of a layout table.
Note: In Layout mode, you can’t use the Insert Table and Draw AP Div tools that you can use in Standard mode. To use
those tools, you must first switch to Standard mode.
When Dreamweaver automatically creates a layout table, the table initially appears to fill the entire Design view, even
if you change the size of your Document window. This full-window default layout table allows you to draw layout
cells anywhere in Design view. You can set the table to a specific size by clicking the table border, then dragging the
table’s resize handles.
When you move the pointer over a layout cell, Dreamweaver highlights it. You can enable or disable highlighting or
change the highlight color in preferences.
You can also create a nested table by drawing a layout table inside another layout table. The cells inside a nested table
areisolatedfromchangesmadetotheoutertable;forexample, when you change the size of a row or column in the
outer table, the cells in the inner table don’t change size.
You can insert multiple levels of nested tables. A nested layout table cannot be larger than the table that contains it.
Note: If you draw a layout table in the middle of your page before drawing a layout cell, the table you draw is automat-
ically nested inside a larger table.
See also
“Using visual aids for layout” on page 173
Create a layout cell
1Make sure you are in Design View (View > Design).
2Make sure you are in Layout mode, not Standard mode (View > Table Mode > Layout Mode).
3Select Insert > Layout Objects > Layout Cell.
4Position the cross hair (+) pointer where you want to start the cell on the page, and then drag to create the layout
cell.
September 4, 2007
DREAMWEAVER CS3
User Guide
195
To draw more than one layout cell without having to repeatedly select the menu item, Control-drag (Windows) or
Command-drag (Macintosh) when you draw the layout cell. As long as you continue to hold Control or Command,
you can draw layout cells one after the other.
If you draw the cell close to the edge of the layout table, cell edges automatically snap to the edges of the containing
layouttable.Totemporarilydisablesnapping,holddownAlt(Windows)orOption(Macintosh)whiledrawingthecell.
The cell appears outlined in blue on your page (you can change the outline color in preferences).
Draw a layout table
1Make sure you are in Design View (View > Design).
2Make sure you are in Layout mode, not Standard mode (View > Table Mode > Layout Mode).
3Select Insert > Layout Objects > Layout Table.
4Position the cross hair (+) pointer on the page, then drag to create the layout table.
To draw more than one layout table without having to repeatedly select the menu item, Control-drag (Windows) or
Command-drag (Macintosh) when you draw the layout table. As long as you continue to hold Control or Command,
you can draw layout tables one after the other.
Youcancreatealayouttableinanemptyareaofyourpagelayout,aroundexistinglayoutcellsandtables,ornested
inside an existing layout table. If your page contains content, and you want to add a layout table in an empty area of
your page layout, you can draw a new layout table only below the bottom of the existing content.
If you try to draw a layout table below existing content and the no-draw pointer appears, try resizing the Document
window to create more blank space between the bottom of the existing content and the bottom of the window.
Note: Tables cannot overlap each other, but a table can be completely contained inside another table.
The Layout table appears outlined in green on your page (you can change the outline color in preferences).
Change highlighting preferences for layout cells
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select Highlighting from the category list.
3Make either of the following changes and click OK.
•To change the highlighting color, click the Mouse-Over color box, then select a highlight color using the color
picker (or enter the hexadecimal value for the highlight color in the text box).
•To enable or disable highlighting, select or deselect the Show option for Mouse-Over.
Note: These options affect all objects, such as tables and absolutely-positioned elements (AP elements), that are
highlighted when you move the pointer over them.
Draw a nested layout table
1Make sure you are in Design View (View > Design).
2Make sure you are in Layout mode, not Standard mode (View > Table Mode > Layout Mode).
3Select Insert > Layout Objects > Layout Table.
4Position the cross hair (+) in an empty (gray) area in an existing layout table, and then drag to create the nested
layout table.
Note: You can’t create a layout table inside a layout cell. You can create a nested layout table only in an empty area of
an existing layout table, or around existing cells.
September 4, 2007
DREAMWEAVER CS3
User Guide
196
Draw a layout table around existing layout cells or tables
1Make sure you are in Design View (View > Design).
2Make sure you are in Layout mode, not Standard mode (View > Table Mode > Layout Mode).
3Select Insert > Layout Objects > Layout Table.
4Drag the cross hair (+) to draw a rectangle around a set of existing layout cells or tables. A new nested layout table
appears, enclosing the existing cells or tables.
To make an existing layout cell fit snugly into one corner of the new nested table, start dragging near the corner of
thecell;thenewtable’scornersnapstothecell’scorner.Youcan’tstartdragginginthemiddleofalayoutcell,because
you can’t create a layout table entirely inside a layout cell.
Add content to a layout cell
You can add text, images, and other content to layout cells in Layout mode just as you would add content to table
cells in Standard mode. Click in the cell where you want to add content, then type text or insert other content.
You cannot insert content into an empty (gray) area of a layout table, so before you can add content to a table, you
must first create layout cells.
Alayoutcellexpandsautomaticallywhenyouaddcontentthatiswiderthanthecell.Asthecellexpands,thecolumn
that the cell is in also expands, which might change the sizes of surrounding cells. The column width for that column
changes to show the width that appears in the code, followed by the visual width of the column (the width as it
appears on your screen) in parentheses.
See also
“Adding and formatting text” on page 226
Add text to a layout cell
1Place the insertion point in the layout cell where you want to add text.
2Do one of the following:
•Type text into the cell (the cell automatically expands as you type).
•Paste text copied from another document.
Add an image to a layout cell
1Place the insertion point in the layout cell where you want to add the image.
2Select Insert > Image.
3Select an image file and click OK.
Clear cell heights
When you create a layout cell, Dreamweaver automatically specifies a height for the cell, to make the cell display at
the height you drew even though the cell is empty. After you insert content into the cell, you might no longer need
the height to be specified, so you can remove the explicit cell heights from the table.
❖Select a layout table by clicking the tab at the top of the table, and then click Clear Row Heights in the Property
inspector (Window > Properties) .
Dreamweaver clears all the heights specified in the table. Some of the table cells might shrink vertically.
September 4, 2007
DREAMWEAVER CS3
User Guide
197
Resize and move layout cells and tables
To adjust your page layout, you can move and resize layout cells and nested layout tables. (The outermost layout table
can only be resized.)
Whenyoumoveorresizelayoutcells,theycannotoverlap.Furthermore,youcannotmoveorresizeacelltomakeit
cross the boundaries of the layout table that contains it. A layout cell cannot be made smaller than its contents.
See also
“Using visual aids for layout” on page 173
Resize a layout cell
1Select a cell by clicking an edge of the cell or by Control-clicking (Windows) or Command-clicking (Macintosh)
anywhere in the cell.
2Drag a selection handle to resize the cell.
The cell edges automatically snap to align with other cells’ edges.
Move a layout cell
1Select a cell by clicking an edge of the cell or by Control-clicking (Windows) or Command-clicking (Macintosh)
anywhere in the cell.
2Do one of the following:
•Drag the cell to another location within its layout table.
•Press the arrow keys to move the cell 1 pixel at a time.
Hold down Shift while pressing an arrow key to move the cell 10 pixels at a time.
Resize a layout table
1Select a table by clicking the tab at the top of the table.
2Drag the selection handles to resize the table.
The table edges automatically snap to align with the edges of other cells and tables.
Move a layout table
1Select a table by clicking the tab at the top of the table.
Note: You can move a layout table only if it’s nested inside another layout table.
2Do one of the following:
•Drag the table to another location on the page.
•Press the arrow keys to move the table 1 pixel at a time.
September 4, 2007
DREAMWEAVER CS3
User Guide
198
Hold down Shift while pressing an arrow key to move the table 10 pixels at a time.
Format layout cells and tables
You can set various attributes of a layout cell in the Property inspector, including width and height, background color,
and alignment of the cell’s contents.
Format a layout cell in the Property inspector
1Select a cell by clicking an edge of the cell or by Control-clicking (Windows) or Command-clicking (Macintosh)
anywhere in the cell.
2Open the Property inspector (Window > Properties) and set the cell’s formatting properties.
Fixed Sets the cell to a fixed width. Enter a width (in pixels) in the adjacent text box.
Autostretch Makes the cell autostretch.
Height Sets the cell’s height (in pixels).
Bg The background color for the layout cell. Click the color box and select a color in the Color Picker, or enter a
hexadecimal number corresponding to a color in the adjacent text box.
Horz Sets the horizontal alignment of the cell’s contents. You can set the alignment to Left, Center, Right, or Default.
Vert Sets the vertical alignment of the cell’s contents. You can set the alignment to Top, Middle, Bottom, Baseline, or
Default.
No Wrap Preventswordwrapping.Whenthisoptionisselected,thelayoutcellwidensasnecessarytoaccommodate
text, rather than continuing the text on a new line.
3If you entered a value in a text box, press Tab or Enter (Windows) or Return (Macintosh) to apply the value.
Set layout table properties
1Select a table by clicking the tab at the top of the table.
2Open the Property inspector (Window > Properties), set the table’s formatting properties, and press Tab or Enter
(Windows), or Return (Macintosh) to apply the value.
Fixed Sets the table to a fixed width, in pixels.
Autostretch Makes the rightmost column of the table autostretch.
Height The table’s height (in pixels).
CellPad Sets the amount of space between the content of a layout cell and the cell boundary (in pixels). If you change
cell padding and a column width appears in parentheses for your layout table, use the Make Widths Consistent
option.
CellSpace Sets the amount of space between adjacent layout cells (in pixels). If you change cell spacing and a column
width appears in parentheses for your layout table, use the Make Widths Consistent option.
Clear Row Heights Removes explicit height settings for all the cells in the layout table. Dreamweaver specifies
explicit cell heights to show your layout as you drew it, even if some cells are empty. Therefore, you should select this
option only after placing content in layout cells; otherwise, empty cells might collapse vertically.
Note: Clearing row heights might have unexpected effects on empty (gray) areas in the layout table (that is, areas that
don’t contain any cells). In particular, some empty rows might be removed from the table entirely, and the table might
appear to collapse vertically.
September 4, 2007
DREAMWEAVER CS3
User Guide
199
Make Widths Consistent Resets the width specified in the HTML for each cell in the table to match the width of the
content within that cell, if you have fixed-width cells in your layout.
Remove All Spacers Removes spacer images (transparent images that are used to control the spacing in your layout)
from your layout table.
Note: Removing spacer images might cause some columns of your table to become very narrow. You should generally
leave spacer images in place unless each column contains other content that will keep the column at the desired width.
Remove Nesting Removes a layout table that’s nested inside another layout table, without losing any of its contents.
The inner layout table disappears; the layout cells that it contained become part of the outer table.
Set column width
You can set a column to a specific width or make it stretch to fill as much of a browser window as possible
(autostretch). You can also specify a minimum width for a column using a spacer image.
The first time you insert a spacer image, you set up a spacer image for the site. You can set preferences for spacer
images.
Making a column autostretch before your layout is complete might have unexpected effects on table layout. To
preventcolumnsfromgrowingwiderornarrower,createyourcompletelayoutbeforemakingacolumnautostretch,
and use spacer images when making a column autostretch. (However, if each column contains other content that will
keep the column at the desired width, you don’t need spacer images.)
If you see two numbers for a column’s width, then the column width set in the HTML code does not match the
column’s apparent width on the screen. You can make the width specified in the code match the visual width.
Note: YouneedtobeinLayoutmodetousetheseoptions.Alsonotethatsometimesthecolumnmenuisatthebottom
edge of the columns.
Make a column autostretch
1Do one of the following:
•Click the column header menu and select Make Column Autostretch.
•Select a cell in the column by clicking an edge of the cell, and select Autostretch in the Property inspector.
Note: You can make only one column in a given table autostretch.
2(Optional) If you have not set a spacer image for this site, the Choose Spacer Image dialog box appears and you
can set which image to use, and click OK.
A wavy line appears at the top or bottom of the autostretch column. Double bars appear at the tops or bottoms of
columns that contain spacer images.
September 4, 2007
DREAMWEAVER CS3
User Guide
200
Set a column to a fixed width
❖Do one of the following:
•Click the column header menu, and then select Make Column Fixed Width. Make Column Fixed Width specifies
a width for the column (in the code) that matches the current visual width of the column.
•Select a cell in the column by clicking an edge of the cell, then select Fixed and type a numeric value in the Property
inspector. If you enter a numeric value that is less than the width of the column’s content, Dreamweaver sets the
width to match the width of the content.
The width of the column appears at the top or bottom of the column.
Insert a spacer image into a column
If you’re making a column autostretch, you can choose whether to use a spacer image, and which spacer image to
use.Theimageisnotvisible,butthecolumnmightshiftslightlyandadoublebarappearsatthetoporbottomofthe
column to indicate that it contains a spacer image.
1Click the column header menu, then select Add Spacer Image.
2Ifyouhavenotsetaspacerimageforthissite,intheChooseSpacerImagedialogbox,selecttheimagetouseand
click OK.
Create A Spacer Image File Creates a GIF image to use as a spacer image, and allows you to select a folder in which
to store the spacer image file, such as your site’s images folder. This is the recommended option, unless you’ve already
created a spacer image file for your site.
Use An Existing Spacer Image File Allows you to specify an existing spacer image file to use in autostretch tables. The
spacer image should be a single-pixel transparent GIF.
Don’t Use Spacer Images For Autostretch Tables Specifies that Dreamweaver should refrain from automatically
adding spacer images to tables. (This option does not appear if you’re inserting a spacer image without making a
column autostretch.) If you select this option, fixed-width columns in your layout might collapse to a small width,
or even to zero width; spacer images help maintain the structure of your layout as you originally drew it. Use this
option only if you’ve already placed enough content in your fixed-width columns to prevent them from collapsing,
or if you have already added spacer images manually.
Remove a spacer image from a single column
❖Click the column header menu and select Remove Spacer Image.
Note: The column might shift when the spacer image is removed.
Remove all spacer images from a table
❖Do one of the following:
•Click the table header menu and select Remove All Spacer Images.
•Select the table and click Remove All Spacers in the Property inspector (Window > Properties) .
September 4, 2007
DREAMWEAVER CS3
User Guide
201
Note: The layout of your table might shift. If there is no content in some columns, the columns might disappear
completely from the Design view.
Make widths consistent
❖Do one of the following:
•Click the table header menu and select Make All Widths Consistent.
•Select the table and click Remove All Spacers in the Property inspector (Window > Properties) .
Dreamweaver resets the width specified in the code to match the visual width.
Set preferences for Layout mode
YoucanspecifypreferencesforspacerimagefilesandforthecolorsthatDreamweaverusestodrawlayouttablesand
layout cells.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select Layout Mode from the category list, set Layout mode preferences, and click OK.
Autoinsert Spacers specifies whether Dreamweaver automatically inserts spacer images when you set a column to
autostretch.
Note: If you choose not to use spacer images in autostretch tables, fixed-width columns might change size or even
disappear completely from Design view when they do not contain content. (The columns still exist in the code, even if
they don’t appear in Design view.)
Spacer Image Sets the spacer image file for your sites.
Select a site from the For Site menu, then click the Create button to create a new spacer image file, or click the Browse
button to locate an existing spacer image file in that site.
Cell Outline Sets the color of the outlines of layout cells.
Cell Highlight Sets the color that layout cell outlines change to when you move the pointer to point to a cell.
Table Outline Sets the color of the outlines of layout tables.
Table Background Sets the color used for areas of layout tables where there are no layout cells.
Using Frames
How frames and framesets work
Aframe is a region in a browser window that can display an HTML document independent of what’s being displayed
in the rest of the browser window. Frames provide a way to divide a browser window into multiple regions, each of
which can display a different HTML document. In the most common use of frames, one frame displays a document
containing navigation controls, while another frame displays a document with content
September 4, 2007
DREAMWEAVER CS3
User Guide
202
Aframeset is an HTML file that defines the layout and properties of a set of frames, including the number of frames,
thesizeandplacementoftheframes,andtheURLofthepagethatinitiallyappearsineachframe.Theframesetfile
itself doesn’t contain HTML content that displays in a browser, except in the noframes section; the frameset file
simply provides information to the browser about how a set of frames should look and what documents should
appear in them.
To view a set of frames in a browser, enter the URL of the frameset file; the browser then opens the relevant
documents to display in the frames. The frameset file for a site is often named index.html, so that it displays by
default if a visitor doesn’t specify a filename.
The following example shows a frame layout consisting of three frames: one narrow frame on the side that contains
anavigationbar,oneframethatrunsalongthetop,containingthelogoandtitleofthewebsite,andonelargeframe
that takes up the rest of the page and contains the main content. Each of these frames displays a separate HTML
document.
In this example, the document displayed in the top frame never changes as the visitor navigates the site. The side
frame navigation bar contains links; clicking one of these links changes the content of the main content frame, but
the contents of the side frame itself remain static. The main content frame on the right displays the appropriate
document for the link the visitor clicks on the left.
A frame is not a file; it’s easy to think of the document that currently appears in a frame as an integral part of the
frame, but the document isn’t actually part of the frame. The frame is a container that holds the document.
Note: A “page” refers either to a single HTML document or to the entire contents of a browser window at a given
moment, even if several HTML documents appear at once. The phrase “a page that uses frames,” for example, usually
refers to a set of frames and the documents that initially appear in those frames.
A site that appears in a browser as a single page comprising three frames actually consists of at least four HTML
documents: the frameset file, plus the three documents containing the content that initially appears in the frames.
When you design a page using framesets in Dreamweaver, you must save each of these four files in order for the page
to work properly in the browser.
September 4, 2007
DREAMWEAVER CS3
User Guide
203
Deciding whether to use frames
The most common use of frames is for navigation. A set of frames often includes one frame containing a navigation
bar and another frame to display the main content pages.
In many cases, you can create a web page without frames that accomplishes the same goals as a set of frames. For
example, if you want a navigation bar to appear on the left side of your page, you can either replace your page with
a set of frames, or just include the navigation bar on every page in your site. (Dreamweaver helps you create multiple
pages that use the same layout.) The following example shows a page design with a framelike layout that doesn’t use
frames.
Poorly designed sites use frames unnecessarily, such as a frameset that reloads the contents of the navigation frames
every time the visitor clicks a navigation button. When frames are used well (for example, to keep navigation controls
static in one frame while allowing the contents of another frame to change), they can be very useful for a site.
Not all browsers provide good frame support, and frames may be difficult for visitors with disabilities to navigate, so
if you do use frames, always provide a noframes section in your frameset, for visitors who can’t view them. You
might also provide an explicit link to a frameless version of the site.
Advantages to using frames:
•A visitor’s browser doesn’t need to reload the navigation-related graphics for every page.
•Each frame has its own scroll bar (if the content is too large to fit in a window), so a visitor can scroll the frames
independently. For example, a visitor who scrolls to the bottom of a long page of content in a frame doesn’t need
to scroll back up to the top to use the navigation bar if the navigation bar is in a different frame.
Disadvantages to using frames:
•Precise graphical alignment of elements in different frames can be difficult.
•Testing the navigation can be time-consuming.
•The URLs of the individual framed pages don’t appear in browsers, so it can be difficult for a visitor to bookmark
a specific page (unless you provide server code that enables them to load a framed version of a particular page).
September 4, 2007
DREAMWEAVER CS3
User Guide
204
Nested framesets
A frameset inside another frameset is called a nested frameset. A single frameset file can contain multiple nested
framesets. Most web pages that use frames are actually using nested frames, and most of the predefined framesets in
Dreamweaver also use nesting. Any set of frames in which there are different numbers of frames in different rows or
columns requires a nested frameset.
Forexample,themostcommonframelayouthasoneframeinthetoprow(wherethecompany’slogoappears)and
two frames in the bottom row (a navigation frame and a content frame). This layout requires a nested frameset: a
two-row frameset, with a two-column frameset nested in the second row.
A. Main frameset B. Menu frame and content frame are nested within the main frameset.
Dreamweaver takes care of nesting framesets as needed; if you use the frame-splitting tools in Dreamweaver, you
don’t need to worry about the details of which frames are nested and which are not.
There are two ways to nest framesets in HTML: the inner frameset can be defined either in the same file as the outer
frameset, or in a separate file of its own. Each predefined frameset in Dreamweaver defines all of its framesets in the
same file.
Both kinds of nesting produce the same visual results; it’s not easy to tell, without looking at the code, which kind of
nesting is being used. The most likely situation in which an external frameset file would be used in Dreamweaver is
when you use the Open in Frame command to open a frameset file inside a frame; doing this may result in problems
with setting targets for links. It’s generally simplest to keep all framesets defined in a single file.
Work with framesets in the Document window
Dreamweaver enables you to view and edit all of the documents associated with a set of frames in one Document
window. This approach enables you to see approximately how the framed pages will appear in a browser as you edit
them.However,someaspectsofthisapproachcanbeconfusinguntilyougetusedtothem.Inparticular,eachframe
displays a separate HTML document. Even if the documents are empty, you must save them all before you can
preview them (because the frameset can be accurately previewed only if it contains the URL of a document to display
in each frame).
To ensure that your frameset appears correctly in browsers, follow these general steps:
1Create your frameset and specify a document to appear in each frame.
A
B
September 4, 2007
DREAMWEAVER CS3
User Guide
205
2Save every file that’s going to appear in a frame. Remember that each frame displays a separate HTML document,
and you must save each document, along with the frameset file.
3Set the properties for each frame and for the frameset (including naming each frame, setting scrolling and non-
scrolling options).
4Set the Target property in the Property inspector for all your links so that the linked content appears in the correct area.
Create frames and framesets
There are two ways to create a frameset in Dreamweaver: You can select from several predefined framesets or you
can design it yourself.
Choosing a predefined frameset sets up all the framesets and frames needed to create the layout and is the easiest
way to create a frames-based layout quickly. You can insert a predefined frameset only in the Document window’s
Design view.
You can also design your own frameset in Dreamweaver by adding “splitters” to the Document window.
Before creating a frameset or working with frames, make the frame borders visible in the Document window’s Design
view by selecting View >Visual Aids > Frame Borders.
See also
“Designing pages for accessibility” on page 707
Create a predefined frameset and display an existing document in a frame
1Place the insertion point in a document and do one of the following:
• Choose Insert > HTML > Frames and select a predefined frameset.
•In the Layout category of the Insert bar, click the drop-down arrow on the Frames button and select a predefined
frameset.
The frameset icons provide a visual representation of each frameset as applied to the current document. The blue
area of a frameset icon represents the current document, and the white areas represent frames that will display other
documents.
September 4, 2007
DREAMWEAVER CS3
User Guide
206
2If you have set up Dreamweaver to prompt you for frame accessibility attributes, select a frame from the pop-up
menu, enter a name for the frame, and click OK. (For visitors who use screen readers, the screen reader will read this
name when it encounters the frame in a page.)
Note: If you click OK without entering a new name, Dreamweaver gives the frame a name that corresponds to its position
(left frame, right frame, and so on) in the frameset.
Note: If you press Cancel, the frameset appears in the document, but Dreamweaver does not associate accessibility tags
or attributes with it.
Select Window > Frames to view a diagram of the frames you are naming.
Create an empty predefined frameset
1Select File > New.
2In the New Document dialog box, select the Page from Sample category.
3Select the Frameset folder in the Sample Folder column.
4Select a frameset from the Sample Page column and click Create.
5IfyouhaveactivatedtheframeaccessibilityattributesinPreferences,theFrameTagAccessibilityAttributesdialog
box appears; complete the dialog box for each frame and click OK.
Note: If you press Cancel, the frameset appears in the document, but Dreamweaver does not associate accessibility tags
or attributes with it.
Create a frameset
❖Select Modify > Frameset, then select a splitting item (such as Split Frame Left or Split Frame Right) from the
submenu.
Dreamweaver splits the window into frames. If you had an existing document open, it appears in one of the frames.
Split a frame into smaller frames
•To split the frame where the insertion point is, select a splitting item from the Modify > Frameset submenu.
•To split a frame or set of frames vertically or horizontally, drag a frame border from the edge into the middle of
the Design view.
•To split a frame using a frame border that isn’t at the edge of the Design view, Alt-drag (Windows) or Option-drag
(Macintosh) a frame border.
•To divide a frame into four frames, drag a frame border from one of the corners of the Design view into the middle
of a frame.
To create three frames, start with two frames, then split one of them. It’s not easy to merge two adjacent frames
without editing the frameset code, so changing four frames into three frames is harder than changing two frames into
three frames.
Delete a frame
❖Drag a frame border off the page or to a border of the parent frame.
If there’s unsaved content in a document in a frame that’s being removed, Dreamweaver prompts you to save the
document.
September 4, 2007
DREAMWEAVER CS3
User Guide
207
Note: You can’t remove a frameset entirely by dragging borders. To remove a frameset, close the Document window that
displays it. If the frameset file has been saved, delete the file.
Resize a frame
•To set approximate sizes for frames, drag frame borders in the Document window’s Design view.
•To specify exact sizes, and to specify how much space the browser allocates to a row or column of frames when
the browser window size doesn’t allow the frames to display at full size, use the Property inspector.
Select frames and framesets
To make changes to the properties of a frame or frameset, begin by selecting the frame or frameset you want to
change. You can select a frame or frameset either in the Document window or by using the Frames panel.
The Frames panel provides a visual representation of the frames within a frameset. It shows the hierarchy of the
frameset structure in a way that may not be apparent in the Document window. In the Frames panel, a very thick
border surrounds each frameset; each frame is surrounded by a thin gray line and is identified by a frame name.
In the Document window’s Design view, when a frame is selected, its borders are outlined with a dotted line; when
a frameset is selected, all the borders of the frames within the frameset are outlined with a light dotted line.
Note: Placing the insertion point in a document that’s displayed in a frame is not the same as selecting a frame. There
are various operations (such as setting frame properties) for which you must select a frame.
Select a frame or frameset in the Frames panel
1Select Window > Frames.
2In the Frames panel:
•To select a frame, click the frame. (A selection outline appears around the frame in both the Frames panel and the
Document window’s Design view.)
•To select a frameset, click the border that surrounds the frameset.
Select a frame or frameset in the Document window
•To select a frame, Alt-click (Windows) or Option-Shift-click (Macintosh) inside a frame in Design view.
•To select a frameset, click one of the frameset’s internal frame borders in Design view. (Frame borders must be
visible to do this; select View >Visual Aids > Frame Borders to make frame borders visible if they aren’t.)
September 4, 2007
DREAMWEAVER CS3
User Guide
208
Note: It’sgenerallyeasiertoselectframesetsintheFramespanelthanintheDocumentwindow.Formoreinformation,
see the above topics.
Select a different frame or frameset
•To select the next or previous frame or frameset at the same hierarchical level as the current selection, press
Alt+Left Arrow or Alt+Right Arrow (Windows), or Command+Left Arrow or Command+Right Arrow
(Macintosh). Using these keys, you can cycle through frames and framesets in the order in which they’re defined
in the frameset file.
•To select the parent frameset (the frameset that contains the current selection), press Alt+Up Arrow (Windows)
or Command+Up Arrow (Macintosh).
•To select the first child frame or frameset of the currently selected frameset (that is, first in the order in which
they’re defined in the frameset file), press Alt+Down Arrow (Windows) or Command+Down Arrow (Macintosh).
Open a document in a frame
You can specify the initial content of a frame by either inserting new content into an empty document in a frame, or
opening an existing document in a frame.
1Place the insertion point in a frame.
2Select File > Open in Frame.
3Select a document to open in the frame, and click OK (Windows) or Choose (Macintosh).
4(Optional) To make this document the default document to display in the frame when the frameset is opened in
a browser, save the frameset.
Save frame and frameset files
Before you can preview a frameset in a browser, you must save the frameset file and all of the documents that will
display in the frames. You can save each frameset file and framed document individually, or you can save the
frameset file and all documents appearing in frames at once.
Note: When you use visual tools in Dreamweaver to create a set of frames, each new document that appears in a frame
isgivenadefaultfilename.Forexample,thefirstframesetfileisnamedUntitledFrameset-1,whilethefirstdocumentin
a frame is named UntitledFrame-1.
Save a frameset file
❖Select the frameset in the Frames panel or the Document window.
•To save the frameset file, select File > Save Frameset.
•To save the frameset file as a new file, select File > Save Frameset As.
Note: If the frameset file has not previously been saved, these two commands are equivalent.
Save a document that appears in a frame
❖Click in the frame, then select File > Save Frame or File > Save Frame As.
Save all files associated with a set of frames
❖Select File > Save All Frames.
September 4, 2007
DREAMWEAVER CS3
User Guide
209
This saves all open documents in the frameset, including the frameset file and all framed documents. If the frameset
file has not yet been saved, a heavy border appears around the frameset (or the unsaved frame) in the Design view,
and you can select a filename.
Note: If you used File > Open in Frame to open a document in a frame, then when you save the frameset, the document
youopenedintheframebecomesthedefaultdocumenttobedisplayedinthatframe.Ifyoudon’twantthatdocument
to be the default, don’t save the frameset file.
View and set frame properties and attributes
Use the Property inspector to view and set most frame properties, including borders, margins, and whether scroll
bars appear in frames. Setting a frame property overrides the setting for that property in a frameset.
You may also want to set some frame attributes, such as the title attribute (which is not the same as the name
attribute), to improve accessibility. You can enable the accessibility authoring option for frames to set attributes when
you create frames, or you can set attributes after inserting a frame. To edit accessibility attributes for a frame, use the
Tag inspector to edit the HTML code directly.
See also
“Designing pages for accessibility” on page 707
View or set frame properties
1Select a frame by doing one of the following:
•Alt-click (Windows) or Shift-Option-click (Macintosh) a frame in the Document window’s Design view.
•Click a frame in the Frames panel (Window > Frames).
2In the Property inspector (Window > Properties), click the expander arrow in the lower-right corner to see all of
the frame properties.
3Set the frame Property inspector options.
Frame Name Thenameusedbyalink’starget attributeorbyascripttorefertotheframe.Aframenamemustbe
a single word; underscores (_) are allowed, but hyphens (-), periods (.), and spaces are not. A frame name must start
with a letter (as opposed to a numeral). Frame names are case-sensitive. Don’t use terms that are reserved words in
JavaScript (such as top or navigator) as frame names.
To make a link change the contents of another frame, you must name the target frame. To make it easier to create
cross-frame links later, name each of your frames when you create it.
Src Specifies the source document to display in the frame. Click the folder icon to browse to and select a file.
Scroll Specifies whether scroll bars appear in the frame. Setting this option to Default doesn’t set a value for the
corresponding attribute, allowing each browser to use its default value. Most browsers default to Auto, meaning that
scroll bars appear only when there is not enough room in a browser window to display the full contents of the current
frame.
No Resize Prevents visitors from dragging the frame borders to resize the frame in a browser.
Note: You can always resize frames in Dreamweaver; this option applies only to visitors viewing the frames in a browser.
Borders Shows or hides the borders of the current frame when it’s viewed in a browser. Selecting a Borders option
for a frame overrides the frameset’s border settings.
September 4, 2007
DREAMWEAVER CS3
User Guide
210
Border options are Yes (show borders), No (hide borders), and Default; most browsers default to showing borders,
unless the parent frameset has Borders set to No. A border is hidden only when all frames that share the border have
BorderssettoNo,orwhentheparentframeset’sBorderspropertyissettoNoandtheframessharingtheborderhave
Borders set to Default.
Border Color Sets a border color for all of the frame’s borders. This color applies to all borders that touch the frame,
and overrides the specified border color of the frameset.
Margin Width Sets the width in pixels of the left and right margins (the space between the frame borders and the
content).
Margin Height Sets the height in pixels of the top and bottom margins (the space between the frame borders and the
content).
Note: SettingthemarginwidthandheightforaframeisnotthesameassettingmarginsintheModify>PageProperties
dialog box.
Tochangethebackgroundcolorofaframe,setthebackgroundcolorofthedocumentintheframeinpageproperties.
Set accessibility values for a frame
1In the Frames panel (Window > Frames), select a frame by placing the insertion point in one of the frames.
2Select Modify > Edit Tag.
3Select Style Sheet/Accessibility from the category list on the left, enter values, and click OK.
Edit accessibility values for a frame
1Display Code view or Code and Design views for your document, if you’re currently in Design view.
2In the Frames panel (Window > Frames), select a frame by placing the insertion point in one of the frames.
Dreamweaver highlights the frame tag in the code.
3Right-click (Windows) or Control-click (Macintosh) in the code, and then select Edit Tag.
4In the tag editor, make your changes and click OK.
Change the background color of a document in a frame
1Place the insertion point in the frame.
2Select Modify > Page Properties.
3In the Page Properties dialog box, click the Background color menu, and select a color.
View and set frameset properties
Use the Property inspector to view and set most frameset properties, including the frameset title, borders, and frame
sizes.
Set a title for a frameset document
1Select a frameset by doing one of the following:
•Click a border between two frames in the frameset in the Document window’s Design view.
•Click the border that surrounds a frameset in the Frames panel (Window > Frames).
September 4, 2007
DREAMWEAVER CS3
User Guide
211
2In the Title box of the Document toolbar, type a name for the frameset document.
When a visitor views the frameset in a browser, the title appears in the browser’s title bar.
View or set frameset properties
1Select a frameset by doing one of the following:
•Click a border between two frames in the frameset in the Document window’s Design view.
•Click the border that surrounds a frameset in the Frames panel (Window > Frames).
2In the Property inspector (Window > Properties), click the expander arrow in the lower-right corner and set the
frameset options.
Borders Determines whether borders should appear around frames when the document is viewed in a browser. To
display borders, select Yes; to prevent the browser from displaying borders, select No. To allow the browser to
determine how borders are displayed, select Default.
Border Width Specifies a width for all the borders in the frameset.
Border Color Sets a color for the borders. Use the color picker to select a color, or type the hexadecimal value for a
color.
RowCol Selection Sets frame sizes for rows and columns of the selected frameset, click a tab on the left side or top
of the RowCol Selection area; then enter a height or width in the Value text box.
3Tospecifyhowmuchspacethebrowserallocatestoeachframe,selectfromthefollowingchoicesintheUnitsmenu:
Pixels Sets the size of the selected column or row to an absolute value. Choose this option for a frame that should
always be the same size, such as a navigation bar. Frames with sizes specified in pixels are allocated space before
frames with sizes specified as percent or relative. The most common approach to frame sizes is to set a left-side frame
to a fixed pixel width and to set a right-size frame to relative, which enables the right frame to stretch to take up all
the remaining space after the pixel width is allocated.
Note: If all of your widths are specified in pixels, and a visitor views the frameset in a browser that’s too wide or too
narrow for the width you specified, then the frames stretch or shrink proportionately to fill the available space. The same
applies to heights specified in pixels. Thus, it’s generally a good idea to specify at least one width and height as relative.
Percent Specifies that the selected column or row should be a percentage of the total width or height of its frameset.
Frames with units set to Percent are allocated space after frames with units set to Pixels, but before frames with units
set to Relative.
Relative SpecifiesthattheselectedcolumnorrowbeallocatedtherestoftheavailablespaceafterPixelsandPercent
frames have had space allocated; that remaining space is divided proportionally among the frames with sizes set to
Relative.
September 4, 2007
DREAMWEAVER CS3
User Guide
212
Note: When you select Relative from the Units menu, any number you’ve entered in the Value field disappears; if you
want to specify a number, you must re-enter it. If there’s only one row or column set to Relative, though, there’s no need
to enter a number, since that row or column receives all the remaining space after the other rows and columns have space
allocated. To be certain of full cross-browser compatibility, you can enter 1 in the Value field; that’s equivalent to entering
no value.
Control frame content with links
To use a link in one frame to open a document in another frame, you must set a target for the link. The target
attribute of a link specifies the frame or window in which the linked content opens.
For example, if your navigation bar is in the left frame, and you want the linked material to appear in the main
content frame on the right, you must specify the name of the main content frame as the target for each of the
navigation bar links. When a visitor clicks a navigation link, the specified content opens in the main frame.
1In Design view, select text or an object.
2In the Link box in the Property inspector (Window > Properties), do one of the following:
•Click the folder icon and select the file to link to.
•Drag the Point to File icon to the Files panel and select the file to link to.
3In the Target menu in the Property inspector, select the frame or window in which the linked document should
appear:
•_blank opens the linked document in a new browser window, leaving the current window untouched.
•_parent opens the linked document in the parent frameset of the frame the link appears in, replacing the entire
frameset.
•_self opens the link in the current frame, replacing the content in that frame.
•_top opens the linked document in the current browser window, replacing all frames.
Frame names also appear in this menu. Select a named frame to open the linked document in that frame.
Note: Frame names appear only when you’re editing a document within a frameset. When you edit a document in its
ownDocumentwindow,framenamesdonotappearintheTargetpop-upmenu.Ifyou’reeditingadocumentoutsideof
the frameset, you can type the target frame’s name in the Target text box.
If you’re linking to a page outside of your site, always use target="_top" or target="_blank" to ensure that the
page doesn’t appear to be part of your site.
Provide content for browsers without frame support
Dreamweaver lets you specify content to display in text-based browsers and in older graphical browsers that do not
support frames. This content is stored in the frameset file, wrapped in a noframes tag. When a browser that doesn’t
support frames loads the frameset file, the browser displays only the content enclosed by the noframes tag.
Note: Content in the noframes area should be more than just a note saying “You should upgrade to a browser that can
handle frames.” Some site visitors use systems that don’t allow them to view frames.
1Select Modify > Frameset > Edit NoFrames Content.
Dreamweaver clears the Design view, and the words “NoFrames Content” appear at the top of the Design view.
2Do one of the following:
•In the Document window, type or insert the content just as you would for an ordinary document.
September 4, 2007
DREAMWEAVER CS3
User Guide
213
•Select Window > Code Inspector, place the insertion point between the body tags that appear inside the noframes
tags, then type the HTML code for the content.
3Select Modify > Frameset > Edit NoFrames Content again to return to the normal view of the frameset document.
Using JavaScript behaviors with frames
There are several JavaScript behaviors and navigation-related commands that are particularly appropriate for use
with frames:
Set Text Of Frame Replaces the content and formatting of a given frame with the content you specify. The content
can include any valid HTML. Use this action to dynamically display information in a frame.
Go To URL Opensanewpageinthecurrentwindoworinthespecifiedframe.Thisactionisparticularlyusefulfor
changing the contents of two or more frames with one click.
Insert Navigation Bar Adds a navigation bar to a page; after inserting a navigation bar, you can attach behaviors to
its images and set which image displays based on a visitor’s actions. For example, you may want to show a button
image in its Up or Down state to let a visitor know which page of a site is being viewed.
Insert Jump Menu Sets up a menu list of links that open files in a browser window when clicked. You can also target
a particular window or frame in which the document opens.
See also
“Apply the Set Text Of Frame behavior” on page 358
“Apply the Go To URL behavior” on page 355
“Apply the Set Nav Bar Image behavior” on page 357
“Apply the Jump Menu behavior” on page 355
September 4, 2007
214
Chapter 8: Adding content to pages
You can visually add content to your web pages without needing to know HTML. You can add text, images, Flash
Video, sound, and other media objects to your web pages, as well as set page properties.
Working with pages
About working with pages
Adobe® Dreamweaver® CS3 provides many features to help you easily create new web pages and specify web page
properties, such as page titles, background images and colors, and text and link colors. In addition, tools are provided
to help you maximize website performance, and to create and test pages to ensure compatibility with different web
browsers.
When creating a web page, you must consider what browsers and operating system users will use when viewing your
web page, and what languages you may need to support. With Dreamweaver, you can select colors that are displayed
correctly in different web browsers, set the encoding of different characters (letter forms) for different languages, and
check that a web browser is compatible with your website.
About setting page properties
For each page you create in Dreamweaver, you can specify layout and formatting properties using the Page Properties
dialog box (Modify > Page Properties). The Page Properties dialog box lets you specify the default font family and
font size, background color, margins, link styles, and many other aspects of page design. You can assign new page
properties for each new page you create, and modify those for existing pages
By default, Dreamweaver formats text using CSS (Cascading Style Sheets). You can change the page-formatting
preferences to HTML formatting using the Preferences dialog box (Edit > Preferences). When using CSS page
properties, CSS tags are used for all properties defined in the Appearance, Links, and Headings categories of the Page
Properties dialog box. The CSS tags defining these attributes are embedded in the head section of the page.
Note: The page properties you choose apply only to the active document. If a page uses an external CSS style sheet,
Dreamweaver does not overwrite the tags set in the style sheet, as this affects all other pages using that style sheet.
CSS versus HTML page properties
By default, CSS tags are used to assign page properties. If you want to use HTML tags instead, you must specify this
in the Preferences dialog box.
If you choose to use HTML instead of CSS, the Property inspector displays the Style pop-up menu. However, the
font, size, color, and alignment controls will only show properties set using HTML tags. The values of CSS properties
applied to the current selection will no longer be visible, and the Size pop-up menu will be disabled.
See also
“Specify HTML instead of CSS” on page 221
“Set page properties” on page 216
September 4, 2007
DREAMWEAVER CS3
User Guide
215
Converting active content
Dreamweaver repairs web pages that contain active content—content that requires users to click on it in order to
interact with it in the latest versions of Internet Explorer. Active content can include:
•Adobe® Flash®, Adobe® Flash® Video, or Adobe® FlashPaper™ content
•Shockwave® or Authorware® content
•Java applets
•Real Media content
•QuickTime content
•Custom ActiveX controls
•Other ActiveX controls or plug-ins
Whenever you open a page in Dreamweaver, the page is scanned for active content. You are then presented with one
of three options, depending on the type of active content in your page.
•If your page includes active content embedded with object tags, and those object tags contain only param tags
and/or embed tags, then Dreamweaver offers to convert all of the active content on the page for you.
•If your page is the same as the above, but also includes active content embedded with object tags that contain other
kinds of tags, then Dreamweaver offers to convert only the object tags that contain param tags and/or embed tags.
•If your page includes only active content embedded with object tags that contain more than just param tags or
embed tags, then Dreamweaver gives you a warning message and tells you that it cannot convert these tags.
Clicking Yes in either of the first two Convert Active Content dialog boxes locates existing object tags that contain
param tags and/or embed tags, wraps those object tags in noscript tags, and adds script tags that enable the expected
functioning of active content by calling JavaScript functions in an external file. Dreamweaver creates this external
file (AC_RunActiveContent.js) and places it in a new folder (called Scripts, at the root of your site) when you save
the updated file. You must upload the AC_RunActiveContent.js file when you upload the updated page, either
manually or by clicking Yes in the Dependent Files dialog box.
Note: When inserting an Active X object in a document, Dreamweaver creates two external files:
AC_RunActiveContent.js and AC_ ActiveX.js. You must upload both files when you upload the updated page, either
manually or by clicking Yes in the Dependent Files dialog box.
Dreamweaver only adjusts object tags, and does not adjust independent embed or applet tags that might have been
used to insert active content in older pages (however, embed tags wrapped inside object tags are adjusted by
wrapping the object tag). If your web pages contain embed or applet tags, you should convert those tags to object
tags, and then open those pages so that Dreamweaver can perform the conversion for you. You can easily locate
embed and applet tags in your web pages by conducting a search.
The feature is extensible and allows you to use third-party extensions to convert web pages that might use specific
kinds of plug-ins (for example, RealPlayer or Windows Media Player content).
You can also access the Convert Active Content feature by selecting File > Convert > Active Content.
Note: Active content must be updated on a page-by-page basis; you cannot update all of the pages in a site at once. It’s
best to do a site-wide search for object tags, open the pages containing those tags, and let Dreamweaver repair the pages.
For more information on active content, visit www.adobe.com/devnet/activecontent/.
September 4, 2007
DREAMWEAVER CS3
User Guide
216
Converting custom content
Dreamweaver only converts param and embed tags that are contained within the identified object tags. If you've
customized your code (for example, if you've added an img tag, or any other kind of tag inside your object tag), the
JavaScriptfunctionsdonotwriteouttheappropriatestringsforthatcontentatruntimebecausetheDreamweaver
JavaScript function only generates attribute-value pairs for param and embed tags. If you want your custom code to
renderproperlyatruntimeandstillworkasexpectedinInternetExplorer,youwillneedtodooneofthefollowing:
•Write your own JavaScript function that works with custom code. (If you want, you can also turn off the
Dreamweaver Convert Active Content feature by selecting Edit > Preferences > Code Rewriting.)
•Develop an extension that lets the generateScript() function look for other kinds of information within the
object tag, and that passes that information along to a JavaScript function for the processing of different kinds of
arguments.
For more information on active content, visit www.adobe.com/devnet/activecontent/.
See also
“Search for and replace text” on page 229
Understanding document encoding
Document encoding specifies the encoding used for characters in the document. Document encoding is specified
in a meta tag in the head of the document; it tells the browser and Dreamweaver how the document should be
decoded and what fonts should be used to display the decoded text.
For example, if you specify Western European (Latin1), this meta tag is inserted: <meta http-equiv="Content-
Type" content="text/html; charset=iso-8859-1">. Dreamweaver displays the document using the fonts you
specify in Fonts Preferences for the Western European (Latin1) encoding; a browser displays the document using the
fonts the browser user specifies for the Western European (Latin1) encoding.
If you specify Japanese (Shift JIS), this meta tag is inserted: <meta http-equiv="Content-Type"
content="text/html; charset=Shift_JIS">. Dreamweaver displays the document using the fonts you specify
for the Japanese encoding; a browser displays the document using the fonts the browser user specifies for the
Japanese encodings.
You can change document encoding for a page and change the default encoding that Dreamweaver uses to create
new documents, including the fonts used to display each encoding.
See also
“Set default document type and encoding” on page 74
Set page properties
Page titles, background images and colors, text and link colors, and margins are basic properties of every web
document. You can set or change these properties, and specify the document encoding type that is specific to the
language used to author the web page. You can also specify which Unicode Normalization Form to use with that
encoding type using the Page Properties dialog box.
September 4, 2007
DREAMWEAVER CS3
User Guide
217
If you use both a background image and a background color, the color appears while the image downloads, and then
the image covers up the color. If the background image contains any transparent pixels, the background color shows
through.
1Select Modify > Page Properties, or click the Page Properties button in the text Property inspector.
2Edit the page properties and click OK.
Document Type (DTD) Specifies a document type definition. For example, you can make an HTML document
XHTML-compliant by selecting XHTML 1.0 Transitional or XHTML 1.0 Strict from the pop-up menu.
Document Encoding Specifies the encoding used for characters in the document.
Unicode Normalization Form Enabled only if you select UTF-8 as a document encoding. There are four Unicode
Normalization Forms. The most important is Normalization Form C because it’s the most common form used in the
Character Model for the World Wide Web. Adobe provides the other three Unicode Normalization Forms for
completeness.
In Unicode, some characters are visually similar but can be stored within the document in different ways. For
example, “ë” (e-umlaut) can be represented as a single character, “e-umlaut,” or as two characters, “regular Latin e” +
“combining umlaut.” A Unicode combining character is one that gets used with the previous character, so the umlaut
would appear above the “Latin e.” Both forms result in the same visual typography, but what is saved in the file is
different for each form.
Normalization is the process of making sure all characters that can be saved in different forms are all saved using the
same from. That is, all “ë” characters in a document are saved as single “e-umlaut” or as “e” + “combining umlaut,”
and not as both forms in one document.
For more information on Unicode Normalization and the specific forms that can be used, see the Unicode website
at www.unicode.org/reports/tr15.
See also
“Specify HTML instead of CSS” on page 221
“About the XHTML code generated by Dreamweaver” on page 302
“Set CSS properties” on page 129
Set page font, background color, and background image
Use the Page Properties dialog box to specify several basic page layout options for your web pages, including the font,
background color, and background image.
1Select Modify > Page Properties, or click the Page Properties button in the text Property inspector.
2Select the Appearance category and set the options.
Page Font Specifies the default font family to use in your web pages. Dreamweaver uses the font family you specify
unless another font is specifically set for a text element.
Size Specifies the default font size to use in your web pages. Dreamweaver uses the font size you specify unless
another font size is specifically set for a text element.
Text Color Specifies the default color to render fonts with.
Background Color Sets a background color for your page. Click the Background color box and select a color from
the Color Picker.
September 4, 2007
DREAMWEAVER CS3
User Guide
218
Background Image Sets a background image. Click the Browse button, then browse to and select the image. Alter-
natively, enter the path to the background image in the Background Image box.
Dreamweaver tiles (repeats) the background image if it does not fill the entire window, just as browsers do. (To
prevent the background image from tiling, use Cascading Style Sheets to disable image tiling.)
Repeat Specifies how the background image will be displayed on the page:
•Select the No-repeat option to display the background image only once.
•Select the Repeat option to repeat, or tile, the image both horizontally and vertically.
•Select the Repeat-x option to tile the image horizontally.
•Select the Repeat-y option to tile the image vertically.
Left Margin and Right Margin Specify the size of the left and right page margins.
Top Margin and Bottom Margin Specify the size of the top and bottom page margins.
Set link properties
You can define the default font, font size, and colors for links, visited links, and active links.
1Select Modify > Page Properties, or click the Page Properties button in the text Property inspector.
2Choose the Links category and set the options.
Link Font Specifies the default font family to use for link text. By default, Dreamweaver uses the font family specified
for the entire page unless you specify another font.
Size Specifies the default font size to use for link text.
Link Color Specifies the color to apply to link text.
Visited Links Specifies the color to apply to visited links.
Rollover Links Specifies the color to apply when a mouse (or pointer) hovers over a link.
Active Links Specifies the color to apply when a mouse (or pointer) clicks on a link
Underline Style Specifies the underline style to apply to links. If your page already has an underline link style defined
(through an external CSS style sheet for example), the Underline Style menu defaults to a “don’t change” option. This
option alerts you to a link style that has been defined. If you modify the underline link style using the Page Properties
dialog box, Dreamweaver will change the previous link definition.
Set page heading properties
You can define the default font, font size, and colors for links, visited links, and active links.
1Select Modify > Page Properties, or click the Page Properties button in the text Property inspector.
2Choose the Headings category and set the options.
Font Specifies the default font family to use in your web pages. Dreamweaver will use the font family you specify
unless another font is specifically set for a text element.
Heading 1 through Heading 6 Specify the font size and color to use for up to six levels of heading tags.
September 4, 2007
DREAMWEAVER CS3
User Guide
219
Set title and encoding page properties
You can define the default font, font size, and colors for links, visited links, and active links. The Title/Encoding Page
Properties category lets you specify the document encoding type that is specific to the language used to author your
web pages as well as specify which Unicode Normalization Form to use with that encoding type.
1Select Modify > Page Properties, or click the Page Properties button in the text Property inspector.
2Choose the Title/Encoding category and set the options.
Title Specifies the page title that appears in the title bar of the Document window and most browser windows.
Document Type (DTD) Specifies a document type definition. For example, you can make an HTML document
XHTML-compliant by selecting XHTML 1.0 Transitional or XHTML 1.0 Strict from the pop-up menu.
Encoding Specifies the encoding used for characters in the document.
If you select Unicode (UTF-8) as the document encoding, entity encoding is not necessary because UTF-8 can safely
represent all characters. If you select another document encoding, entity encoding may be necessary to represent
certain characters. For more information on character entities, see www.w3.org/TR/REC-
html40/sgml/entities.html.
Unicode Normalization Form Enabled only if you select UTF-8 as a document encoding. There are four Unicode
Normalization Forms. The most important is Normalization Form C because it’s the most common form used in the
Character Model for the World Wide Web. The other three Unicode Normalization Forms are also provided.
Include Unicode Signature (BOM) Includes a Byte Order Mark (BOM) in the document. A BOM is 2 to 4 bytes at the
beginning of a text file that identifies a file as Unicode, and if so, the byte order of the following bytes. Because UTF-8
has no byte order, adding a UTF-8 BOM is optional. For UTF-16 and UTF-32, it is required.
Reload Converts the existing document, or reopens it using the new encoding.
Use a tracing image to design the page
You can insert an image file to use as a guide in designing your page:
1Select Modify > Page Properties, or click the Page Properties button in the text Property inspector.
2Choose the Tracing Image category and set the options.
Tracing Image Specifies an image to use as a guide for copying a design. This image is for reference only, and does
not appear when the document is displayed in a browser.
Transparency Determines the opacity of the tracing image, from completely transparent to completely opaque.
Select and view elements in the Document window
To select an element in the Design view of the Document window, click the element. If an element is invisible, you
must make it visible before you can select it.
Some HTML code doesn’t have a visible representation in a browser. For example, comment tags don’t appear in
browsers.However,itcanbeusefulwhileyou’recreatingapagetobeabletoselectsuchinvisibleelements,editthem,
move them, and delete them.
Dreamweaver enables you to specify whether it shows icons marking the location of invisible elements in the Design
view of the Document window. To indicate which element markers appear, you can set options in Invisible Elements
preferences. For example, you can specify that named anchors be visible, but not line breaks.
You can create certain invisible elements (such as comments and named anchors) using buttons in the Common
category of the Insert bar. You can then modify these elements using the Property inspector.
September 4, 2007
DREAMWEAVER CS3
User Guide
220
See also
“Viewing code” on page 307
“Use the Insert bar” on page 28
Select elements
•To select a visible element in the Document window, click the element or drag across the element.
•To select an invisible element, select View > Visual Aids > Invisible Elements (if that menu item isn’t already
selected) and then click the element’s marker in the Document window.
Some objects appear on the page in a place other than where their code is inserted. For example, in Design view an
absolutely-positioned element (AP element) can be anywhere on the page, but in Code view the code defining the
AP element is in a fixed location. When invisible elements are showing, Dreamweaver displays markers in the
Document window to show the location of the code for such elements. Selecting a marker selects the entire element;
for example, selecting the marker for an AP element selects the entire AP element.
•To select a complete tag (including its contents, if any), click a tag in the tag selector at the lower left of the
Document window. (The tag selector appears in both Design view and Code view.) The tag selector always shows
the tags that contain the current selection or insertion point. The leftmost tag is the outermost tag containing the
current selection or insertion point. The next tag is contained in that outermost tag, and so on; the rightmost tag
is the innermost one that contains the current selection or insertion point.
In the following example, the insertion point is in a paragraph tag, <p>. To select the table containing the paragraph
you want to select, select the <table> tag to the left of the <p> tag.
View the HTML code associated with the selected text or object
❖Do one of the following:
•In the Document toolbar, click the Show Code View button.
•Select View > Code.
•In the Document toolbar, click the Show Code and Design Views button.
•Select View > Code and Design.
•Select Window > Code Inspector.
When you select something in either code editor (Code view or the Code inspector), it’s generally also selected in
the Document window. You may need to synchronize the two views before the selection appears.
Show or hide marker icons for invisible elements
❖Select View > Visual Aids > Invisible Elements.
Note: Showing invisible elements may slightly change the layout of a page, moving other elements by a few pixels, so for
precision layout, hide the invisible elements.
Set invisible elements preferences
Use Invisible Elements preferences to specify which kinds of elements will be visible when you select View > Visual
Aids > Invisible Elements.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh), then click Invisible Elements.
2Select which elements should be made visible and click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
221
Note: A check mark next to the name of the element in the dialog box means the element is visible when View > Visual
Aids > Invisible Elements is selected.
Named Anchors Displays an icon that marks the location of each named anchor (a name = "") in the document.
Scripts Displays an icon that marks the location of JavaScript or VBScript code in the body of the document. Select
the icon to edit the script in the Property inspector or to link to an external script file.
Comments Displays an icon that marks the location of HTML comments. Select the icon to see the comment in the
Property inspector.
Line Breaks Displays an icon that marks the location of each line break (BR). This option is deselected by default.
Client-Side Image Maps Displays an icon marking the location of each client-side image map in the document.
Embedded Styles Displays an icon showing the location of CSS styles embedded in the body section of the
document. If CSS styles are placed in the head section of a document, they do not appear in the Document window.
Hidden Form Fields Displays an icon that marks the location of form fields that have the type attribute set to
"hidden".
Form Delimiter Displays a border around a form so you can see where to insert form elements. The border shows
the extent of the form tag, so any form elements inside that border are properly enclosed in form tags.
Anchor Points For AP elements Displays an icon that marks the location of code defining an AP element. The AP
element itself can be anywhere on the page. (AP elements are not invisible elements; only the code defining the AP
element is invisible.) Select the icon to select the AP element; you can then see the contents of the AP element even
if the AP element is marked as hidden.
Anchor Points For Aligned Elements Displays an icon showing the location of HTML code for elements that accept
the align attribute. These include images, tables, ActiveX objects, plug-ins, and applets. In some cases, the code for
the element may be separated from the visible object.
Visual Server Markup Tags Displays the location of server markup tags (such as Active Server Pages tags and
ColdFusion tags) whose content cannot be displayed in the Document window.
Nonvisual Server Markup Tags Displays the location of server markup tags (such as Active Server Pages tags and
ColdFusion tags) whose content cannot be displayed in the Document window.
CSS Display: None Displays an icon showing the location of content that’s hidden by the display:none property in
the linked or embedded stylesheet.
Show Dynamic Text As Displays any dynamic text on your page in the format of {Recordset:Field} by default. If the
length of these values is long enough to distort your page’s formatting, you can change the display to {} instead.
Server-Side Includes Displays the actual contents of each server-side include file.
Specify HTML instead of CSS
By default, Dreamweaver uses CSS tags to assign page properties. If you want to use HTML tags instead, you must
deselect the Use CSS Instead Of HTML Tags option in the General category of the Preferences dialog box.
1Select Edit > Preferences.
2IntheGeneralcategoryofthePagePropertiesdialogbox,deselectUseCSSInsteadofHTMLTags(intheEditing
options section of the General Preferences panel) and click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
222
Set the HTML Appearance page properties
The HTML Appearance Page Properties category lets you specify several basic page layout options for your web
pages:
Background Image and Background Specify a background image and background color for the page.
Text and Links Define default colors for text, links, visited links, and active links. You can also control these colors
using CSS style sheets.
Left Margin and Top Margin Specify the sizes of page margins in the body tag, for Microsoft Internet Explorer only.
Netscape Navigator ignores these values, using Margin Width and Margin Height instead. For best cross-browser
results, provide margin values for both browsers instead of just one browser; fill in all four margin values instead of
just two. To ensure that no margins appear in either browser, set all four values to 0. Dreamweaver doesn’t display
page margins in the Document window; to see the margins, use Preview In Browser.
Margin Width and Margin Height Specify the sizes of page margins in the body tag, for Netscape Navigator only.
Internet Explorer ignores these values, using Left Margin and Top Margin instead. For best cross-browser results,
provide margin values for both browsers instead of just one browser; fill in all four margin values instead of just two.
To ensure no margins in both browsers, set all four values to 0. Dreamweaver doesn’t display page margins in the
Document window; use Preview In Browser to see the margins.
See also
“Apply, remove, or rename class styles” on page 136
“About setting page properties” on page 214
“Specify HTML instead of CSS” on page 221
Web-safe colors
In HTML, colors are expressed either as hexadecimal values (for example, #FF0000)orascolornames(red). A web-
safe color is one that appears the same in Netscape Navigator and Microsoft Internet Explorer on both Windows and
Macintosh systems when running in 256-color mode. The conventional wisdom is that there are 216 common colors,
and that any hexadecimal value that combines the pairs 00, 33, 66, 99, CC, or FF (RGB values 0, 51, 102, 153, 204,
and 255, respectively) represents a web-safe color.
Testing, however, reveals that there are only 212 web-safe colors rather than a full 216, because Internet Explorer on
Windows does not correctly render the colors #0033FF (0,51,255), #3300FF (51,0,255), #00FF33 (0,255,51), and
#33FF00 (51,255,0).
When web browsers first made their appearance, most computers displayed only 265 colors (8 bits per channel (bpc).
Today, the majority of computers display thousands or millions of colors (16- and 32-bpc), so the justification for
using the browser-safe palette is greatly diminished if you are developing your site for users with current computer
systems.
Onereasontousetheweb-safecolorpaletteisifyouaredevelopingforalternativewebdevicessuchasPDAandcell
phone displays. Many of this devices offer only black and white (1-bpc) or 256 color (8-bpc) displays.
The Color Cubes (default) and the Continuous Tone palettes in Dreamweaver use the 216-color web-safe palette;
selecting a color from these palettes displays the color’s hexadecimal value.
To select a color outside the web-safe range, open the system color picker by clicking the Color Wheel button in the
upper-right corner of the Dreamweaver color picker. The system color picker is not limited to web-safe colors.
September 4, 2007
DREAMWEAVER CS3
User Guide
223
UNIX versions of Netscape Navigator use a different color palette than the Windows and Macintosh versions. If you
are developing exclusively for UNIX browsers (or your target audience is Windows or Macintosh users with 24-bpc
monitors and UNIX users with 8-bpc monitors), consider using hexadecimal values that combine the pairs 00, 40,
80, BF, or FF, which produce web-safe colors for SunOS.
Use the color picker
InDreamweaver,manyofthedialogboxes,aswellasthePropertyinspectorformanypageelements,containacolor
box, which opens a color picker. Use the color picker to select a color for a page element. You can also set the default
text color for your page elements.
1Click a color box in any dialog box or in the Property inspector.
The color picker appears.
2Do one of the following:
•Use the eyedropper to select a color swatch from the palette. All colors in the Color Cubes (default) and
Continuous Tone palettes are web-safe; other palettes are not.
•Use the eyedropper to pick up a color from anywhere on your screen—even outside the Dreamweaver windows.
To pick up a color from the desktop or another application, press and hold the mouse button; this allows the
eyedropper to retain focus, and select a color outside of Dreamweaver. If you click the desktop or another appli-
cation, Dreamweaver picks up the color where you clicked. However, if you switch to another application, you may
need to click a Dreamweaver window to continue working in Dreamweaver.
•Toexpandyourcolorselection,usethepop-upmenuattheupper-rightcornerofthecolorpicker.Youcanselect
Color Cubes, Continuous Tone, Windows OS, Mac OS, Grayscale, and Snap To Web Safe.
Note: The Color Cubes and Continuous Tone palettes are web-safe, whereas Windows OS, Mac OS and Grayscale are
not. If you are using a palette that isn’t web-safe and then select Snap to Web Safe, Dreamweaver replaces the selected
color with the closest web-safe color. In other words, you may not get the color you see.
•To clear the current color without choosing a different color, click the Default Color button .
•To open the system color picker, click the Color Wheel button .
Zoom in and out
Dreamweaver lets you increase the magnification (zoom in) in the Document window so that you can check the pixel
accuracy of graphics, select small items more easily, design pages with small text, design large pages, and so on.
Note: The zooming tools are only available in Design view.
See also
“Status bar overview” on page 18
Zoom in or out on a page
1Select the Zoom tool (the magnifying glass icon) in the lower-right corner of the Document window.
2Do one of the following:
•Click the spot on the page you want to magnify until you’ve achieved the desired magnification.
•Drag a box over the area on the page that you want to zoom in on and release the mouse button.
•Select a preset magnification level from the Zoom pop-up menu.
September 4, 2007
DREAMWEAVER CS3
User Guide
224
•Type a magnification level in the Zoom text box.
You can also zoom in without using the Zoom tool by pressing Control+= (Windows) or Command+= (Macintosh).
3To zoom out (reduce magnification), select the Zoom tool, press Alt (Windows) or Option (Macintosh) and click
on the page.
You can also zoom out without using the Zoom tool by pressing Control+- (Windows) or Command+- (Macintosh).
Edit a page after zooming
❖
Select the Pointer tool (the pointer icon) in the lower-right corner of the Document window, and click inside the page.
Pan a page after zooming
1Select the Hand tool (the hand icon) in the lower-right corner of the Document window.
2Drag the page.
Fill the Document window with a selection
1Select an element on the page.
2Select View > Fit Selection.
Fill the Document window with an entire page
❖Select View > Fit All.
Fill the Document window with the entire width of a page
❖Select View > Fit Width.
Using JavaScript behaviors to detect browsers and plug-ins
You can use behaviors to determine which browser your visitors are using and whether they have a particular plug-in
installed.
Check Browser Sends visitors to different pages depending on their browser brands and versions. For example, you
may want visitors to go to one page if they have Netscape Navigator 4.0 or later, to go to another page if they have
Microsoft Internet Explorer 4.0 or later, and to stay on the current page if they have any other kind of browser.
Check Plugin Sends visitors to different pages depending on whether they have the specified plug-in installed. For
example, you may want visitors to go to one page if they have Shockwave™ and another page if they do not.
See also
“Using JavaScript behaviors” on page 347
“Apply the Check Browser behavior” on page 351
“Apply the Check Plugin behavior” on page 352
September 4, 2007
DREAMWEAVER CS3
User Guide
225
Set download time and size preferences
Dreamweaver calculates size based on the entire contents of the page, including all linked objects, such as images and
plug-ins. Dreamweaver estimates download time based on the connection speed entered in Status Bar preferences.
Actual download time varies depending on general Internet conditions.
A good guideline to use when checking download times for a particular web page is the 8-second rule. That is, most
users will not wait longer than 8 seconds for a page to load.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select Status Bar from the Category list on the left.
3Select a connection speed with which to calculate download time and click OK.
See also
“Set window size and connection speed” on page 26
Set browser preview preferences
You can set preferences for the browser to use when previewing a site and define default primary and secondary
browsers.
1Select File > Preview In Browser > Edit Browser List.
2To add a browser to the list, click the Plus (+) button, complete the Add Browser dialog box, and then click OK.
3To delete a browser from the list, select the browser, and then click the Minus (-) button.
4To change settings for a selected browser, click the Edit button, make changes in the Edit Browser dialog box, and
then click OK.
5Select the Primary Browser or the Secondary Browser option to specify whether the selected browser is the
primary or secondary browser.
F12 (Windows) or Option+F12 (Macintosh) opens the primary browser; Control+F12 (Windows) or
Command+F12 (Macintosh) opens the secondary browser.
6SelectPreviewUsingTemporaryFiletocreateatemporarycopyforpreviewingandserverdebugging.(Deselect
this option if you want to update the document directly.)
Save and revert web pages
You can save a document using its current name and location, or save a copy of a document using a different name
and location.
When naming files, avoid using spaces and special characters in file and folder names. In particular, do not use
special characters (such as é, ç, or ¥) or punctuation (such as colons, slashes, or periods) in the names of files you
intend to put on a remote server; many servers change these characters during upload, which will cause any links to
the files to break. Also, do not begin a filename with a numeral.
See also
“Create a blank page” on page 69
September 4, 2007
DREAMWEAVER CS3
User Guide
226
Save a document
1Do one of the following:
•To overwrite the current version on the disk, and save any changes you have made, select File > Save.
•To save the file in a different folder or using a different name, select File > Save As.
2In the Save As dialog box that appears, navigate to the folder where you want to save the file.
3In the File Name text box, type a name for the file.
4Click Save to save the file.
Save all open documents
1Select File > Save All.
2If there are any unsaved documents open, the Save As dialog box is displayed for each unsaved document.
In the dialog box that appears, navigate to the folder where you want to save the file.
3In the File Name box, type a name for the file and click Save.
Revert to the last saved version of a document
1Select File > Revert.
A dialog box asks if you want to discard your changes, and revert to the previously saved version.
2Click Yes to revert to the previous version; click No to keep your changes.
Note: If you save a document, and then exit Dreamweaver, you cannot revert to the previous version of the document
when you restart Dreamweaver.
Adding and formatting text
About inserting text
Dreamweaver lets you add text to web pages by typing the text directly into a page, copying and pasting text from
another document, or dragging text from another application. You can also import text from or link to other
document types, including ASCII text files, rich format text files, and Microsoft Office documents.
Add text to a document
To add text to a Dreamweaver document, you can type text directly in the Document window, or you can cut and
paste text. You can also import text from other documents.
When you paste text into a Dreamweaver document, you can use either the Paste or the Paste Special command. The
Paste Special command lets you specify the format of pasted text in different ways. For example, if you wanted to
paste text from a formatted Microsoft Word document into your Dreamweaver document, but wanted to strip out
all of the formatting so that you could apply your own CSS style sheet to the pasted text, you could select the text in
Word, copy it to your Clipboard, and use the Paste Special command to select the option that lets you paste text only.
When using the Paste command to paste text from other applications, you can set paste preferences as default
options.
September 4, 2007
DREAMWEAVER CS3
User Guide
227
Note: Control+V (Windows) and Command+V (Macintosh) always paste text only (no formatting) in Code view.
❖Add text to your document by doing one of the following:
•Type text directly into the Document window.
•Copy text from another application, switch to Dreamweaver, position the insertion point in the Design view of the
Document window, and select Edit > Paste or Edit > Paste Special.
When you select Edit > Paste Special, you can select several paste formatting options.
You can also paste text using the following keyboard shortcuts:
Insert special characters
Certain special characters are represented in HTML by a name or a number, referred to as an entity. HTML
includes entity names for characters such as the copyright symbol (©), the ampersand (&), and the regis-
tered-trademark symbol (®). Each entity has both a name (such as —) and a numeric equivalent (such as
—).
HTML uses the angle brackets <> in its code, but you may need to express the special characters for greater than or
less than without Dreamweaver interpreting them as code. In this case, use > for greater than (>) and < for less
than (<).
Unfortunately, many browsers (especially older browsers, and browsers other than Netscape Navigator and Internet
Explorer) don’t properly display many of the named entities.
1In the Document window, place the insertion point where you want to insert a special character.
2Do one of the following:
•Select the name of the character from the Insert > HTML > Special Characters submenu.
•In the Text category of the Insert bar, click the Characters button and select the character from the submenu.
There are many other special characters available; to select one of them, select Insert > HTML > Special
Characters > Other or click the Characters button in the Text category of the Insert bar and select the Other
Characters option. Select a character from the Insert Other Character dialog box, and click OK.
Add space between characters
HTML only allows for one space between characters; to add additional space in a document you must insert a non-
breaking space. You can set a preference to automatically add non-breaking spaces in a document.
Insert a non-breaking space
❖Do one of the following:
•Select Insert > HTML > Special Characters > Non-Breaking Space.
•Press Control+Shift+Spacebar (Windows) or Option+Spacebar (Macintosh).
Paste option Keyboard shortcut
Paste Control+V (Windows)
Command+V (Macintosh)
Paste Special Control+Shift+V (Windows)
Command+Shift+V (Macintosh)
September 4, 2007
DREAMWEAVER CS3
User Guide
228
•In the Text category of the Insert bar, click the Characters button and select the Non-Breaking Space icon.
Set a preference to add non-breaking spaces
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2In the General category make sure Allow Multiple Consecutive Spaces is checked.
Create bulleted and numbered lists
You can create numbered (ordered) lists, bulleted (unordered) lists, and definition lists from existing text or from
new text as you type in the Document window.
Definition lists do not use leading characters like bullet points or numbers and are often used in glossaries or descrip-
tions. Lists can also be nested. Nested lists are lists that contain other lists. For example, you might want an ordered
or bulleted list nested within another numbered or ordered list.
You use the List Properties dialog box to set the appearance of an entire list or for an individual list item. You can set
number style, reset numbering, or set bullet style options for individual list items or for the entire list.
See also
“Set CSS properties” on page 129
Create a new list
1In the Dreamweaver document, place the insertion point where you want to add a list, then do one of the
following:
•Click either the Bulleted or Numbered List button in the Property inspector
•Select Text > List and select the type of list desired—Unordered (bulleted) List, Ordered (numbered) List, or
Definition List.
The leading character for the specified list item appears in the Document window.
2Type the list item text, then press Enter (Windows) or Return (Macintosh) to create another list item.
3To complete the list, press Enter twice (Windows) or press Return twice (Macintosh).
Create a list using existing text
1Select a series of paragraphs to make into a list.
2Click the Bulleted or Numbered List button in the Property inspector, or select Text > List and select the type of
list desired—Unordered List, Ordered List, or Definition List.
Create a nested list
1Select the list items you want to nest.
2Click the Indent button in the Property inspector, or select Text > Indent.
Dreamweaver indents the text and creates a separate list with the original list’s HTML attributes.
3Apply a new list type or style to the indented text by following the same procedure used above.
Set list properties for an entire list
1In the Document window, create at least one list item. The new style will automatically apply to additional items
you add to the list.
September 4, 2007
DREAMWEAVER CS3
User Guide
229
2With the insertion point in the list item’s text, select Text > List > Properties to open the List Properties dialog box.
3Set the options you want to define the list:
List Type Specifies list properties while List Item specifies an individual item in a list. Use the pop-up menu to select
a bulleted, numbered, directory, or menu list. Depending on the List Type you select different options appear in the
dialog box.
Style Determines the style of numbers or bullets used for a numbered or bulleted list. All items in the list will have
this style unless you specify a new style for items within the list.
Start Count Sets the value for the first item in a numbered list.
4Click OK to set the choices.
Set list properties for a list item
1In the Document window, place the insertion point in the text of a list item you want to affect
2Select Text > List > Properties.
3Under List Item, set the options you want to define:
New Style Specifies a style for the selected list item. Styles in the New Style menu are related to the type of list
displayed in the List Type menu. For example, if the List Item menu displays Bulleted List, only bullet options are
available in the New Style menu.
Reset Count To Sets a specific number from which to number list item entries.
4Click OK to set the options.
Search for and replace text
You can use the Find And Replace command to search for text and for HTML tags and attributes in a document or
a set of documents. The Search panel, in the Results panel group, shows the results of a Find All search.
Note: To search for files in a site, use different commands: Locate In Local Site and Locate In Remote Site.
See also
“Viewing code” on page 307
“About regular expressions” on page 304
Search for and replace text
1Open the document to search in, or select documents or a folder in the Files panel.
2Select Edit > Find And Replace.
3Use the Find In option to specify which files to search:
Selected Text Confines the search to the text that’s currently selected in the active document.
Current Document Confines the search to the active document.
Open Documents Searches all documents that are currently open.
Folder Confines the search to a specific folder. After choosing Folder, click the folder icon to browse to and select a
folder to search.
Selected Files In Site Confines the search to the files and folders that are currently selected in the Files panel.
September 4, 2007
DREAMWEAVER CS3
User Guide
230
Entire Current Local Site Expands the search to all the HTML documents, library files, and text documents in the
current site.
4Use the Search pop-up menu to specify the kind of search you want to perform:
Source Code Searches for specific text strings in the HTML source code. You can search for specific tags using this
option, but the Specific Tag search provides a more flexible approach to searching for tags.
Text
Searches for specific text strings in the text of the document. A text search ignores any HTML that interrupts the
string. For example, a search for
the black dog
would match both
the black dog
and
the <i>black</i> dog
.
Text (Advanced) Searches for specific text strings that are either within or not within a tag or tags. For example, in a
document that contains the following HTML, searching for tries and specifying Not Inside Tag and the itag would
find only the second instance of the word tries:John <i>tries</i> to get his work done on time, but
he doesn’t always succeed. He tries very hard. .
Specific Tag Searches for specific tags, attributes, and attribute values, such as all td tags with valign set to top.
Note: Pressing Control+Enter or Shift+Enter (Windows), or Control+Return, Shift+Return, or Command+Return
(Macintosh), adds line breaks within the text search fields, allowing you to search for a Return character. When
performing such a search, deselect the Ignore Whitespace Differences option if you’re not using regular expressions. This
search finds a Return character in particular, not simply the occurrence of a line break; for instance, it doesn’t find a <br>
tag or a <p> tag. Return characters appear as spaces in the Design view, not as line breaks.
5Use the following options to expand or limit the search:
Match Case Limits the search to text that exactly matches the case of the text you want to find. For example, if you
search for the brown derby, you will not find The Brown Derby.
Ignore Whitespace Treats all whitespace as a single space for the purposes of matching. For example, with this
option selected, this text would match this text and this text but not thistext. This option is not
available when the Use Regular Expressions option is selected; you must explicitly write your regular expression to
ignore whitespace. Note that <p> and <br> tags do not count as whitespace.
Match Whole Word Limits the search to text that matches one or more complete words.
Note: Using this option is equivalent to doing a regular-expression search for a search string that starts and ends with
\b, the word-boundary regular expression.
Use Regular Expressions Causes certain characters and short strings (such as ?, *, \w, and \b) in your search string
to be interpreted as regular expression operators. For example, a search for the b\w*\b dog will match both the
black dog and the barking dog.
Note: If you are working in Code view and make changes to your document, and try to find and replace anything other
than source code, a dialog box appears letting you know that Dreamweaver is synchronizing the two views before doing
the search.
6To search without replacing, click Find Next or Find All:
Find Next Jumps to and selects the next occurrence of the search text or tags in the current document. If there are
no more instances of the tag in the current document, Dreamweaver proceeds to the next document, if you are
searching in more than one document.
Find All Opens the Search panel in the Results panel group. If you are searching a single document, Find All displays
all occurrences of the search text or tags, with some surrounding context. If you are searching a directory or site, Find
All displays a list of documents that contain the tag.
7To replace found text or tags, click Replace or Replace All.
September 4, 2007
DREAMWEAVER CS3
User Guide
231
8When you’re finished, click Close.
Search again without displaying the Find And Replace dialog box
❖Press F3 (Windows) or Command+G (Macintosh).
View a particular search result in context
1Select Window > Results to display the Search panel.
2Double-click a line in the Search panel.
If you’re searching the current file, the Document window displays the line containing that search result.
If you’re searching a set of files, the file containing that search result opens.
Perform the same search again
❖Click the Find And Replace button.
Stop a search in progress
❖Click the Stop button.
Search for a specific tag
UsetheFindAndReplacedialogboxtosearchfortextortagsinadocument,andtoreplacethefoundmaterialwith
other text or tags.
1Select Edit > Find And Replace.
2In the Search pop-up menu, select Specific Tag.
3Select a specific tag or [any tag] fromthepop-upmenunexttotheSearchpop-upmenu,ortypeatagnamein
the text box.
4(Optional.) Limit the search with one of the following tag modifiers:
With Attribute Specifies an attribute that must be in the tag for it to match. You can specify a particular value for the
attribute or select [any value].
Without Attribute Selects an attribute that must not be in the tag for it to match. For example, select this option to
search for all img tags with no alt attribute.
Containing Specifies text or a tag that must be contained within the original tag for it to match. For example, in the
code <b><font size="4">heading 1</font></b>, the font tag is contained within the b tag.
Not Containing Specifies text or a tag that must not be contained within the original tag for it to match.
Inside Tag Specifies a tag that the target tag must be contained in for it to match.
Not Inside Tag Specifies a tag that the target tag must not be contained in for it to match.
5(Optional.) To limit the search further, click the Plus (+) button and repeat step 3.
6If you didn’t apply any tag modifiers in steps 3 and 4, then click the Minus (-) button to remove the tag modifiers
pop-up menu.
7If you want to perform an action when the tag is found (such as removing or replacing the tag), select the action
from the Action pop-up menu and, if applicable, specify any additional information necessary to perform the action.
September 4, 2007
DREAMWEAVER CS3
User Guide
232
Search for specific text (Advanced)
UsetheFindandReplacedialogboxtosearchfortextortagsinadocument,andtoreplacethefoundmaterialwith
other text or tags.
1Select Edit > Find and Replace.
2In the Search pop-up menu, select Text (Advanced).
3Enter text in the text field adjacent to the Search pop-up menu.
For example, type the word Untitled.
4Select Inside Tag or Not Inside Tag, and then select a tag from the adjacent pop-up menu.
For example, select Inside Tag and then title.
5(Optional.) Click the Plus (+) button to limit the search with one of the following tag modifiers:
With Attribute Specifies an attribute that must be in the tag for it to match. You can specify a particular value for the
attribute or select [any value].
Without Attribute Selects an attribute that must not be in the tag for it to match. For example, select this option to
search for all img tags with no alt attribute.
Containing Specifies text or a tag that must be contained within the original tag for it to match. For example, in the
code <b><font size="4">heading 1</font></b>, the font tag is contained within the b tag.
Not Containing Specifies text or a tag that must not be contained within the original tag for it to match.
Inside Tag Specifies a tag that the target tag must be contained in for it to match.
Not Inside Tag Specifies a tag that the target tag must not be contained in for it to match.
6(Optional.) To limit the search further, repeat step 4.
Define abbreviations and acronyms
HTML provides tags that let you define the abbreviations and acronyms you use in your page for search engines, spell
checkers, language translation programs, or speech synthesizers. For example, you might want to specify that the
abbreviation ME in your page stands for mechanical engineer, or the acronym WHO stands for World Health
Organization.
1Select the abbreviation or acronym in the text of your page.
2Select Insert > HTML > Text Objects > Abbreviation, or Insert > HTML > Text Objects > Acronym.
3Enter the full text of the acronym or abbreviation.
4Enter the language, such as en for English, de for German, or it for Italian.
Set copy and paste preferences
You can set special paste preferences as default options when using Edit > Paste to paste text from other applications.
For example, if you always want to paste text as text only, or text with basic formatting, you can set the default option
in the Copy/Paste Preferences dialog box.
September 4, 2007
DREAMWEAVER CS3
User Guide
233
Note: When you paste text into a Dreamweaver document, you can use either the Paste or the Paste Special command.
The Paste Special command lets you specify the format of pasted text in different ways. For example, if you wanted to
paste text from a formatted Microsoft Word document into your Dreamweaver document, but wanted to strip out all of
the formatting so that you could apply your own CSS style sheet to the pasted text, you could select the text in Word, copy
it to your Clipboard, and use the Paste Special command to select the option that lets you paste text only.
Note: Preferences set in the Copy/Paste Preferences dialog box apply only to material pasted into Design view.
1Select Edit > Preferences (Windows) or Dreamweaver Preferences (Macintosh).
2Click the Copy/Paste category.
3Set the following options and click OK.
Tex t Only Lets you paste unformatted text. If the original text is formatted, all formatting, including line breaks and
paragraphs, will be removed.
Text With Structure Lets you paste text that retains structure, but does not retain basic formatting. For example, you
can paste text and retain the structure of paragraphs, lists, and tables, without retaining bold, italics, and other
formatting.
Text With Structure Plus Basic Formatting Lets you paste both structured and simple HTML-formatted text (e.g.,
paragraphs and tables, as well as text formatted with the b,i,u,strong,em,hr,abbr, or acronym tag).
Text With Structure Plus Full Formatting Lets you paste text that retains all structure, HTML formatting, and CSS
styles.
Note: The Full Formatting option cannot retain CSS styles that come from an external style sheet, nor can it retain styles
if the application from which you are pasting does not retain styles upon pasting to the Clipboard.
Retain Line Breaks Lets you keep line breaks in pasted text. This option is disabled if you have selected Text Only.
Clean Up Word Paragraph Spacing Select this option if you selected Text With Structure or Text With Structure Plus
Basic Formatting, and want to eliminate extra space between paragraphs when you paste your text.
Check and correct spelling
Use the Check Spelling command in the Text menu to check the spelling in the current1 document. The Check
Spelling command ignores HTML tags and attribute values.
By default, the spelling checker uses the U.S. English spelling dictionary. To change the dictionary, select Edit >
Preferences > General (Windows) or Dreamweaver > Preferences > General (Macintosh), then in the Spelling
Dictionary pop-up menu select the dictionary you want to use. Dictionaries for additional languages can be
downloaded from the Dreamweaver Support Center at www.adobe.com/go/dreamweaver_support.
1Select Text > Check Spelling or press Shift+F7.
When Dreamweaver encounters an unrecognized word, the Check Spelling dialog box appears.
2Select the appropriate option based on how you want the discrepancy handled.
Add To Personal Adds the unrecognized word to your personal dictionary.
Ignore Ignores this instance of the unrecognized word.
Ignore All Ignores all instances of the unrecognized word.
Change Replaces this instance of the unrecognized word with text that you type in the Change To text box or with
the selection in the Suggestions list.
Change All Replaces all instances of the unrecognized word in the same manner.
September 4, 2007
DREAMWEAVER CS3
User Guide
234
Import tabular data
You can import tabular data into your document by first saving the files (such as Microsoft Excel files or database
files) as delimited text files.
You can import and format tabular data and import text from Microsoft Word HTML documents.
You can also add text from Microsoft Excel documents to a Dreamweaver document by importing the contents of
the Excel file into a web page.
1Select File > Import > Import Tabular Data, or Insert > Table Objects > Import Tabular Data.
2Browse for the file you want or enter its name in the text box.
3Select the delimiter used when the file was saved as delimited text. Your options are Tab, Comma, Semicolon,
Colon, and Other.
If you select Other, a blank field appears next to the option. Enter the character that was used as a delimiter.
4Use the remaining options to format or define the table into which the data will be imported and click OK.
See also
“Open and edit existing documents” on page 75
“Import and export tabular data” on page 178
Import Microsoft Office documents (Windows only)
You can insert the full contents of a Microsoft Word or Excel document in a new or existing web page. When you
import a Word or Excel document, Dreamweaver receives the converted HTML and inserts it into your web page.
The file’s size, after Dreamweaver receives the converted HTML, must be less than 300K.
Insteadofimportingtheentirecontentsofafile,youcanalsopasteportionsofaWorddocumentandpreservethe
formatting.
Note: If you use Microsoft Office 97, you cannot import the contents of a Word or Excel document; you must insert a
link to the document.
1Open the web page into which you want to insert the Word or Excel document.
2In Design view, do one of the following to select the file:
•Drag the file from its current location to the page where you want the content to appear.
•Select File > Import > Word Document or File > Import > Excel Document.
3IntheInsertDocumentdialogbox,browsetothefileyouwanttoadd,selectanyoftheformattingoptionsfrom
the Formatting pop-up menu at the bottom of the dialog box, and then click Open.
Tex t Only Inserts unformatted text. If the original text is formatted, all formatting will be removed.
Text With Structure Inserts text that retains structure, but does not retain basic formatting. For example, you can
paste text and retain the structure of paragraphs, lists, and tables, without retaining bold, italics, and other
formatting.
Text With Structure Plus Basic Formatting Inserts both structured and simple HTML-formatted text (e.g.,
paragraphs and tables, as well as text formatted with the b,i,u,strong,em,hr,abbr, or acronym tag).
Text With Structure Plus Full Formatting Inserts text that retains all structure, HTML formatting, and CSS styles.
September 4, 2007
DREAMWEAVER CS3
User Guide
235
Clean Up Word Paragraph Spacing Eliminates extra space between paragraphs when you paste your text if you
selected Text With Structure or Basic Formatting.
The contents of the Word or Excel document appear in your page.
Create a link to a Word or Excel document
You can insert a link to a Microsoft Word or Excel document in an existing page.
1Open the page where you want the link to appear.
2Drag the file from its current location to your Dreamweaver page, positioning the link wherever you want.
3Select Create A Link, and then click OK.
4If the document you are linking to is located outside of your site’s root folder, Dreamweaver prompts you to copy
the document to the site root.
By copying the document to the site’s root folder, you ensure that the document will be available when you publish
the website.
5When you upload your page to your web server, make sure to upload the Word or Excel file, too.
Your page now contains a link to the Word or Excel document. The link text is the name of the linked file; you can
change the link text.
See also
“Manage links in the site map” on page 288
About formatting text (CSS versus HTML)
Formatting text in Dreamweaver is similar to using a standard word processor. You can set default formatting styles
(Paragraph, Heading 1, Heading 2, and so on) for a block of text, change the font, size, color, and alignment of
selected text, or apply text styles such as bold, italic, code (monospace), and underline.
By default, Dreamweaver formats text using Cascading Style Sheets (CSS). CSS gives web designers and developers
greater control over web page design, while providing improved features for accessibility and reduced file size. As
you format and align text using Dreamweaver formatting commands, CSS rules are embedded in the current
document. This lets you more easily reuse existing styles, as well as name the styles you create. CSS is becoming the
preferred method by which to format text and lay out web pages.
Ifyouprefer,youcanuseHTMLmarkuptagstoformatandaligntextinyourwebpages.TouseHTMLtagsinstead
of CSS, you must change the Dreamweaver default text formatting preferences.
Using CSS is a way to control the style of a web page without compromising its structure. By separating visual design
elements (fonts, colors, margins, and so on) from the structural logic of a web page, CSS gives web designers visual
and typographic control without sacrificing the integrity of the content. In addition, defining typographic design and
page layout from within a single, distinct block of code—without having to resort to image maps, font tags, tables,
and spacer GIFs—allows for faster downloads, streamlined site maintenance, and a central point from which to
control design attributes across multiple web pages.
CSS defines the formatting for all text in a particular class or redefines the formatting for a particular HTML tag
(such as h1,h2,p, or li).
September 4, 2007
DREAMWEAVER CS3
User Guide
236
You can store styles created with CSS directly in the document (the default when you format text using the Property
inspector), or for more power and flexibility, you can store styles in an external style sheet. If you attach an external
style sheet to several web pages, all the pages automatically reflect any changes you make to the style sheet. To access
all CSS rules for a page, use the CSS Styles panel (Window > CSS Styles).
Note: You can combine CSS and HTML 3.2 formatting within the same page. Formatting is applied in a hierarchical
manner: HTML 3.2 formatting overrides formatting applied by external CSS style sheets, and CSS embedded in a
document overrides external CSS.
See also
“Open the CSS Styles panel” on page 128
“Understanding Cascading Style Sheets” on page 120
“Specify HTML instead of CSS” on page 221
Using the Property inspector to format text
The text Property inspector lets you format the currently selected text. You can change the formatting by setting new
options. The style is immediately applied to the text.
As you format text using the Property inspector, Dreamweaver keeps track of the formatting properties you assign
to each text element, and assigns each a label using the naming convention: Style1, Style2, Style3, Stylen.Ifyouassign
the same formatting attributes to two or more text elements, Dreamweaver labels those elements with the same title,
eliminating redundant style names. The label Dreamweaver applies to a given body of text can then be applied using
the Style pop-up menu, letting you build a library of styles within a page, and apply those same styles by simply
selecting the text element in the page and selecting a style from the Style menu. You can rename styles with more
meaningful labels, such as Heading1, Heading2, Body, and TableBody.
September 4, 2007
DREAMWEAVER CS3
User Guide
237
TheStylepop-upmenuinthePropertyinspectordisplaysboththenamesofstylesinyourpage,aswellasapreview
of the style’s properties. The properties shown in the preview are font family, font size, font weight, text color, and
background color.
WhenyouusethePropertyinspectortoapplyboldoritalicstyle,Dreamweaverautomaticallyappliesthe<strong>
or <em> tag,respectively.Ifyouaredesigningpagesforviewerswith3.0orolderversionbrowsers,youshouldchange
this preference in the General category of the Preferences dialog box (Edit > Preferences).
For a tutorial on formatting text with the Property inspector, see www.adobe.com/go/vid0147.
See also
“Creating and managing CSS” on page 124
“Create a new CSS rule” on page 129
“Set General preferences for Dreamweaver” on page 36
Set text properties in the Property inspector
You can use the text Property inspector to apply HTML formatting or Cascading Style Sheet (CSS) formatting.
HTML formatting lets you select text formatting options such as font, size, bold, and italic, while CSS formatting lets
you apply a CSS class style to the selected text.
Set CSS formatting in the Property inspector
1Open the Property inspector (Window > Properties), if it isn’t already open.
2Select the text you want to format.
September 4, 2007
DREAMWEAVER CS3
User Guide
238
3Set the CSS options you want to apply to the selected text:
Format Sets the paragraph style of the selected text. Paragraph applies the default format for a <p> tag, Heading 1
adds an H1 tag, and so on.
Style Displays the class style that is currently applied to the selected text. If no styles have been applied to the
selection, the pop-up menu shows No CSS Style. If multiple styles have been applied to the selection, the menu is
blank.
Use the Style menu to do any of the following:
•Select the style you want to apply to the selection.
•Select None to remove the currently selected style.
•Select Attach Style Sheet to open a dialog box that lets you attach an external style sheet.
Bold Applies either <b> or <strong> to the selected text according to the style preference set in the General category
of the Preferences dialog box.
Italic Applies either <i> or <em> to the selected text according to the style preference set in the General category of
the Preferences dialog box.
Set HTML formatting in the Property inspector
1Open the Property inspector (Window > Properties), if it isn’t already open.
2Select the text you want to format.
3Set the options you want to apply to the selected text:
Format Sets the paragraph style of the selected text. Paragraph applies the default format for a <p> tag, Heading 1
adds an H1 tag, and so on.
Font Combination Applies the selected font combination to the text. Use the pop-up menu to select the font combi-
nation you want to apply, or select Edit Font List to create or edit a font combination.
Size Applies either a specific font size (1 through 7) or a font size (+ or –1 through + or –7) relative to the basefont
size (the default is 3).
Text Color Displays the text in the selected color. Select a web-safe color by clicking the color box, or enter a
hexadecimal value (for example, #FF0000) in the adjacent text field.
Bold Applies either <b> or <strong> to the selected text according to the style preference set in the General category
of the Preferences dialog box.
Italic Applies either <i> or <em> to the selected text according to the style preference set in the General category of
the Preferences dialog box.
Left, Center, and Right Align Apply the respective alignment.
Link Creates a hypertext link of the selected text. Click the folder icon to browse to a file in your site; type the URL;
drag the Point-To-File icon to a file in the Files panel; or drag a file from the Files panel into the box.
Target Specifies the frame or window in which the linked document will load:
•_blank loads the linked file in a new, unnamed browser window.
•_parent loads the linked file in the parent frameset or window of the frame that contains the link. If the frame
containing the link is not nested, the linked file loads into the full browser window.
•_self loads the linked file in the same frame or window as the link. This target is implied, so you generally don’t
need to specify it.
September 4, 2007
DREAMWEAVER CS3
User Guide
239
•_top loads the linked file in the full browser window, thereby removing all frames.
Unordered List Creates a bulleted list of the selected text. If no text is selected, a new bulleted list is started.
Ordered List Creates a numbered list of the selected text. If no text is selected, a new numbered list is started.
List Item Opens the List Properties dialog box.
Indent and Outdent Indent or remove indentation from the selected text by applying or removing the blockquote
tag. In a list, indenting creates a nested list and removing the indentation unnests the list.
Format paragraphs
Dreamweaver supports all of the web standards used in page- and object-formatting.
Use the Format pop-up menu in the Property inspector or the Text > Paragraph Format submenu to apply the
standard paragraph and heading tags.
1Place the insertion point in the paragraph, or select some of the text in the paragraph.
2Using the Text > Paragraph Format submenu or the Format pop-up menu in the Property inspector, select an
option:
•Select a paragraph format (for example, Heading 1, Heading 2, Preformatted Text, and so on). The HTML tag
associated with the selected style (for example, h1 for Heading 1, h2 for Heading 2, pre for Preformatted text, and
so on) is applied to the entire paragraph.
•Select None to remove a paragraph format.
When you apply a heading tag to a paragraph, Dreamweaver automatically adds the next line of text as a standard
paragraph. To change this setting, select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh);
then in the General category, under Editing Options, make sure Switch To Plain Paragraph After Heading is not
selected.
See also
“Set text properties in the Property inspector” on page 237
“Set CSS properties” on page 129
Change the color of text
You can change the default color of all the text in a page, or you can change the color of selected text in the page.
See also
“Use the color picker” on page 223
Define default text colors for a page
❖Select Modify > Page Properties > Appearance or Links, and then select colors for the Text Color, Link Color,
Visited Links, and Active Links options.
Note: The active link color is the color that a link changes to while it’s being clicked. Some web browsers may not use the
color you specify.
September 4, 2007
DREAMWEAVER CS3
User Guide
240
Change the color of selected text
❖Select the text and do one of the following:
•Select a color by clicking the color box in the Property inspector.
•Select Text > Color, select a color from the system color picker, and then click OK.
•Enter the color name or hexadecimal number directly in the Property inspector field.
Return text to the default color
1In the Property inspector, click the color box to open the palette of web-safe colors.
2Click the Strike-through button (the white square button with a red line through it, found in the upper-right
corner).
Align text
You align text on the page using the Property inspector or the Text > Align submenu. You can center any element on
a page using the Text > Align > Center command.
Align text on a page
1Select the text you want to align or simply insert the pointer at the beginning of the text.
2Click an alignment option (Left, Right, or Center) in the Property inspector, or select Text > Align and select an
alignment command.
Center page elements
1Select the element (image, plug-in, table, or other page element) you want to center.
2Select Text > Align > Center.
Note: You can align and center complete blocks of text; you cannot align or center part of a heading or part of a
paragraph.
Indent text
Using the Indent command applies the blockquote HTML tag to a paragraph of text, indenting text on both sides
of the page.
1Place the insertion point in the paragraph you want to indent.
2Click the Indent or Outdent button in the Property inspector, select Text > Indent or Outdent, or select List >
Indent or Outdent from the context menu.
Note: You can apply multiple indents to a paragraph. Each time you select this command, the text indents further from
both sides of the document.
Add paragraph spacing
Dreamweaver works similarly to many word processing application: you press Enter (Windows) or Return
(Macintosh) to create a new paragraph. Web browsers automatically insert a blank line of space between paragraphs.
You can add a single line of space between paragraphs by inserting a line break.
Add a paragraph return
❖Press Enter (Windows) or Return (Macintosh).
September 4, 2007
DREAMWEAVER CS3
User Guide
241
Add a line break
❖Do one of the following:
•Press Shift+Enter (Windows) or Shift+Return (Macintosh).
•Select Insert > HTML > Special Characters > Line Break.
•In the Text category of the Insert bar, click the Characters button and select the Line Break icon.
Use horizontal rules
Horizontal rules (lines) are useful for organizing information. On a page, you can visually separate text and objects
with one or more rules.
Create a horizontal rule
1In the Document window, place the insertion point where you want to insert a horizontal rule.
2Select Insert > HTML > Horizontal Rule.
Modify a horizontal rule
1In the Document window, select the horizontal rule.
2Select Window > Properties to open the Property inspector, and modify the properties as desired:
W and H Specify the width and height of the rule in pixels or as a percentage of the page size.
Align Specifies the alignment of the rule (Default, Left, Center, or Right). This setting applies only if the width of the
rule is less than the width of the browser window.
Shading Specifies whether the rule is drawn with shading. Deselect this option to draw the rule in a solid color.
Apply font styles
You can apply text formatting to one letter, or to entire paragraphs and blocks of text in a site. Use the Property
inspector or the Text menu to set or change font characteristics for selected text. You can set the font type, style (such
as bold or italic), and size.
1Select the text. If no text is selected, the option applies to subsequent text you type.
2Select from the following options:
•To change the font, select a font combination from the Property inspector or from the Text > Font submenu. Select
Default to remove previously applied fonts; Default applies the default font for the selected text (either the browser
default font or the font assigned to that tag in the CSS style sheet).
•To change the font style, click Bold or Italic in the Property inspector, or select a font style (Bold, Italic, Underline,
and so on) from the Text > Style submenu.
Note: When you use the Property inspector to apply bold or italic style, Dreamweaver applies the <strong> or <em> tag,
respectively. If you are designing pages for viewers with 3.0 or older version browsers, you should change this preference
in the General category of the Preferences dialog box (Edit > Preferences).
•To change the font size, select a size (1 through 7) from the Property inspector or from the Text > Size submenu.
HTML font sizes are relative, not specific, point sizes. Users set the point size of the default font for their browsers;
thisisthefontsizethattheywillseewhenyouselectDefaultor3inthePropertyinspectororText>Sizesubmenu.
Sizes 1 and 2 appear smaller than the default font size; sizes 4 through 7 appear larger. Also, fonts generally look larger
in Windows than on Mac OS, though Macintosh Internet Explorer 5 uses the same default font size as Windows.
September 4, 2007
DREAMWEAVER CS3
User Guide
242
One way to ensure consistency with font size is to use CSS styles with your font size set in pixels.
•To increase or decrease the size of selected text, select a relative size (+ or –1 to + 4 or –3) from the Property
inspector or from either the Text > Size Change submenu.
Note: These numbers indicate a relative difference from the basefont size. The default basefont value is 3. Thus, a +4
valueresultsinafontsizeof3+4,or7.Themaximumsumforyourfontsizevaluesis7.Ifyoutrytosetthemhigher,
they appear as 7. Dreamweaver does not display the basefont tag (which goes in the head section), although the font
size should appear properly in a browser. To test this, compare text set at 3 and text set at +3.
See also
“Creating pages with CSS” on page 120
“Create a new CSS rule” on page 129
Rename a style
As you format text, Dreamweaver keeps track of the styles you create in each page, and builds a library of styles that
you can reuse. This makes applying the same formatting to a block of text much simpler, as well as letting you create
a more consistent look for your pages.
1Select Rename from the text Property inspector Style pop-up menu.
2Select the style you want to rename from the Rename Style pop-up menu.
3Enter a new name in the New Name text field and click OK.
Modify font combinations
Use the Edit Font List command to set the font combinations that appear in the Property inspector and the Text >
Font submenu.
Font combinations determine how a browser displays text in your web page. A browser uses the first font in the
combination that is installed on the user’s system; if none of the fonts in the combination are installed, the browser
displays the text as specified by the user’s browser preferences.
Modify font combinations
1Select Text > Font > Edit Font List.
2Select the font combination from the list at the top of the dialog box.
ThefontsintheselectedcombinationarelistedintheChosenFontslistinthelower-leftcornerofthedialogbox.To
the right is a list of all available fonts installed on your system.
3Do one of the following:
•To add or remove fonts from a font combination, click the arrows button (<< or >>) between the Chosen Fonts
list and the Available Fonts list.
•To add or remove a font combination, click the Plus (+) and Minus (–) buttons at the top of the dialog box.
•To add a font that is not installed on your system, type the font name in the text field below the Available Fonts
list and click the << button to add it to the combination. Adding a font not installed on your system is useful, for
example, for specifying a Windows-only font when you are developing pages on a Macintosh.
•To move the font combination up or down in the list, click the arrow buttons at the top of the dialog box.
September 4, 2007
DREAMWEAVER CS3
User Guide
243
Add a new combination to the font list
1Select Text > Font > Edit Font List.
2Select a font from the Available Fonts list and click the << button to move the font to the Chosen Fonts list.
3Repeat step 2 for each subsequent font in the combination.
To add a font that is not installed on your system, type the font name in the text field below the Available Fonts list
and click the << button to add the font to the combination. Adding a font not installed on your system is useful, for
example, for specifying a Windows-only font when you are developing pages on a Macintosh.
4When you have finished selecting specific fonts, select a generic font family from the Available Fonts menu and
click the << button to move the generic font family to the Chosen Fonts list.
Generic font families include cursive, fantasy, monospace, sans-serif, and serif. If none of the fonts in the Chosen
Fontslistareavailableontheuser’ssystem,thetextappearsinthedefaultfontassociatedwiththegenericfontfamily.
For example, the default monospace font on most systems is Courier.
Insert dates
Dreamweaver provides a convenient Date object, which inserts the current date in whatever format you prefer (with
or without the time) and provides the option of updating that date whenever you save the file.
Note: The dates and times shown in the Insert Date dialog box are not the current date, nor do they reflect the
dates/times that a visitor sees when they display your site. They are examples only of the way you want to display this
information.
1In the Document window, place the insertion point where you want the date to be inserted.
2Do one of the following:
•Select Insert > Date.
•In the Common category of the Insert bar, click the Date button.
3Intheresultingdialogbox,selectaformatforthenameofthedayoftheweek,aformatforthedate,andaformat
for the time.
4If you want the inserted date to be updated every time you save the document, select Update Automatically On
Save. If you want the date to become plain text when it’s inserted, and never update automatically, deselect that
option.
5Click OK to insert the date.
If you have selected Update Automatically On Save, you can edit the date format after it has been inserted into the
document by clicking on the formatted text and selecting Edit Date Format in the Property inspector.
Adding and modifying images
About images
Many different types of graphic file formats exist, but three graphic file formats are generally used in web pages—
GIF, JPEG, and PNG. GIF and JPEG file formats are the best supported and can be viewed by most browsers.
September 4, 2007
DREAMWEAVER CS3
User Guide
244
PNG files are best suited for almost any type of web graphic due to their flexibility and small file size; however, the
display of PNG images is only partially supported in Microsoft Internet Explorer (4.0 and later browsers) and
Netscape Navigator (4.04 and later browsers). So unless you are designing for a specific target audience using a
browser that supports the PNG format, use GIFs or JPEGs for broader accessibility.
GIF (Graphic Interchange Format) GIF files use a maximum of 256 colors, and are best for displaying noncon-
tinuous-tone images or those with large areas of flat colors, such as navigation bars, buttons, icons, logos, or other
images with uniform colors and tones.
JPEG (Joint Photographic Experts Group) The JPEG file format is the superior format for photographic or
continuous-tone images, because JPEG files can contain millions of colors. As the quality of a JPEG file increases, so
does the file size and the file download time. You can often strike a good balance between the quality of the image
and the file size by compressing a JPEG file.
PNG (Portable Network Group) The PNG file format is a patent-free replacement for GIFs that includes support for
indexed-color, gray scale, and true-color images, and alpha channel support for transparency. PNG is the native file
format of Adobe® Fireworks®. PNG files retain all the original layer, vector, color, and effects information (such as
drop shadows), and all elements are fully editable at all times. Files must have the .png file extension to be recognized
as PNG files by Dreamweaver.
Insert an image
When you insert an image into a Dreamweaver document, a reference to the image file is generated in the HTML
source code. To ensure that this reference is correct, the image file must be in the current site. If it is not in the current
site, Dreamweaver asks whether you want to copy the file into the site.
You can also insert images dynamically. Dynamic images are those images that change often. For example, adver-
tising banner rotation systems need to randomly select a single banner from a list of potential banners, and then
dynamically display the selected banner’s image when a page is requested.
After you insert an image, you can set image tag accessibility attributes that can be read by screen readers for visually
impaired users. These attributes can be edited in HTML code.
For a tutorial on inserting images, see www.adobe.com/go/vid0148.
1Place the insertion point where you want the image to appear in the Document window and do one of the
following:
•In the Common category of the Insert bar, click the Images icon .
•IntheCommoncategoryoftheInsertbar,clicktheImagesbuttonandselecttheImageicon.WiththeImageicon
displayed in the Insert bar, you can drag the icon to the Document window (or to the Code view window if you
are working in the code).
•Select Insert > Image.
•Drag an image from the Assets panel (Window > Assets) to the desired location in the Document window; then
skip to step 3.
•Drag an image from the Files panel to the desired location in the Document window; then skip to step 3.
•Drag an image from the desktop to the desired location in the Document window; then skip to step 3.
2In the dialog box that appears, do one of the following:
•Select File System to choose an image file.
•Select Data Source to choose a dynamic image source.
September 4, 2007
DREAMWEAVER CS3
User Guide
245
•Click the Sites And Servers button to choose an image file in a remote folder of one of your Dreamweaver sites.
3Browse to select the image or content source you want to insert.
If you are working in an unsaved document, Dreamweaver generates a file:// reference to the image file. When you
save the document anywhere in the site, Dreamweaver converts the reference to a document-relative path.
Note: When inserting images it’s also possible to use an absolute path to an image that resides on a remote server (i.e.,
an image that is not available on the local hard drive). If you experience performance problems while working, however,
you might want to disable viewing the image in Design view by deselecting Commands > Display External Files.
4Click OK. The Image Tag Accessibility Attributes dialog box appears if you have activated the dialog box in Prefer-
ences (Edit > Preferences).
5Enter values in the Alternate Text and Long Description text boxes, and click OK.
•In the Alternate Text box, enter a name or brief description for the image. The screen reader reads the information
you enter here. You should limit your entry to around 50 characters. For longer descriptions, consider providing
a link, in the Long Description text box, to a file that gives more information about the image.
•In the Long Description box, enter the location of a file that displays when the user clicks the image or click the
folder icon to browse to the file. This text box provides a link to a file that is related to, or gives more information
about, the image.
Note: You can enter information in one or both text boxes depending on your needs. The screen reader reads the Alt
attribute for the image.
Note: If you click Cancel, the image appears in the document, but Dreamweaver does not associate accessibility tags or
attributes with it.
6In the Property inspector (Window > Properties), set properties for the image.
See also
“Make images dynamic” on page 565
“Image maps” on page 293
“Optimize the work space for accessible page design” on page 707
“Set page properties” on page 216
Set image properties
TheImagesPropertyinspectorallowsyoutosetpropertiesforanimage.Ifyoudonotseealloftheimageproperties,
click the expander arrow in the lower-right corner.
1Select Window > Properties to view the Property inspector for a selected image.
2In the text box below the thumbnail image, enter a name so you can refer to the image when using a Dreamweaver
behavior (such as Swap Image) or when using a scripting language such as JavaScript or VBScript.
September 4, 2007
DREAMWEAVER CS3
User Guide
246
3Set any of the image options.
W and H Thewidthandheightoftheimage,inpixels.Dreamweaverautomaticallyupdatesthesetextboxeswiththe
image’s original dimensions when you insert an image in a page.
If you set W and H values that do not correspond to the actual width and height of the image, the image may not
display properly in a browser. (To restore the original values, click the W and H text box labels, or the Reset image
size button that appears to the right of the W and H text boxes in entering a new value.)
Note: You can change these values to scale the display size of this image instance, but this does not reduce download time,
because the browser downloads all image data before scaling the image. To reduce download time and to ensure that all
instances of an image appear at the same size, use an image-editing application to scale images.
Src Specifies the source file for the image. Click the folder icon to browse to the source file, or type the path.
Link Specifies a hyperlink for the image. Drag the Point-To-File icon to a file in the Files panel, click the folder icon
to browse to a document on your site, or manually type the URL.
Align Aligns an image and text on the same line.
Alt Specifies alternative text that appears in place of the image for text-only browsers or for browsers that have been
set to download images manually. For visually impaired users who use speech synthesizers with text-only browsers,
the text is spoken out loud. In some browsers, this text also appears when the pointer is over the image.
Map Name and Hotspot tools Allow you to label and create a client-side image map.
V Space and H Space Add space, in pixels, along the sides of the image. V Space adds space along the top and bottom
of an image. H Space adds space along the left and right of an image.
Target Specifies the frame or window in which the linked page should load. (This option is not available when the
image isn’t linked to another file.) The names of all the frames in the current frameset appear in the Target list. You
can also choose from the following reserved target names:
•_blank loads the linked file into a new, unnamed browser window.
•_parent loads the linked file into the parent frameset or window of the frame that contains the link. If the frame
containing the link is not nested, the linked file loads into the full browser window.
•_self loads the linked file into the same frame or window as the link. This target is the default, so you usually
don’t need to specify it.
•_top loads the linked file into the full browser window, thereby removing all frames.
Low Src Specifies the image that should load before the main image. Many designers use a 2-bpc (black and white)
version of the main image because it loads quickly and gives visitors an idea of what they’re waiting to see.
Border The width, in pixels, of the image’s border. The default is no border.
Edit Starts the image editor you specified in External Editors preferences and opens the selected image.
Optimize Opens the Optimization dialog box.
Crop Trims the size of an image, removing unwanted areas from the selected image.
Resample Resamples a resized image, improving its picture quality at its new size and shape.
Brightness and Contrast Adjusts the brightness and contrast settings of an image.
Sharpen Adjusts the sharpness of an image.
Reset Size Resets the W and H values to the original size of the image. This button appears to the right of the W
and H text boxes when you adjust the values of the selected image.
September 4, 2007
DREAMWEAVER CS3
User Guide
247
Edit image accessibility attributes in code
If you inserted accessibility attributes for an image, you can edit those values in the HTML code.
1In the Document window, select the image.
2Do one of the following:
•Edit the appropriate image attributes in Code view.
•Right-click (Windows) or Control-click (Macintosh), and then select Edit Tag.
•Edit the Alt value in the Property inspector.
Edit images in Dreamweaver
Dreamweaver provides basic image-editing features that let you modify images without having to use an external
image-editing application such as Fireworks. The Dreamweaver image-editing tools are designed to let you easily
work with content designers responsible for creating image files for use on your website.
Note: You do not need to have Fireworks installed on your computer to use the Dreamweaver image-editing features.
❖Select Modify > Image. Set any of these Dreamweaver image-editing features:
Resample Adds or subtracts pixels from a resized JPEG and GIF image files to match the appearance of the original
image as closely as possible. Resampling an image reduces its file size and improves download performance.
When you resize an image in Dreamweaver, you can resample it to accommodate its new dimensions. When a
bitmap object is resampled, pixels are added to or removed from the image to make it larger or smaller. Resampling
an image to a higher resolution typically causes little loss of quality. Resampling to a lower resolution, however,
always causes data loss and usually a drop in quality.
Crop Editimagesbyreducingtheareaoftheimage.Typically,you’llwanttocropanimagetoplacemoreemphasis
on the subject of the image, and remove unwanted aspects surrounding the center of interest in the image.
Brightness and Contrast Modifies the contrast or brightness of pixels in an image. This affects the highlights,
shadows, and midtones of an image. You typically use Brightness/Contrast when correcting images that are too dark
or too light.
Sharpen Adjusts the focus of an image by increasing the contrast of edges found within the image. When you scan
an image, or take a digital photo, the default action of most image capturing software is to soften the edges of objects
in the image. This prevents extremely fine details from becoming lost in the pixels from which digital images are
composed. However, to bring out the details in digital image files, it is often necessary to sharpen the image, thereby
increasing edge contrast, and making the image appear sharper.
Note: Dreamweaver image-editing features apply only to JPEG and GIF image file formats. Other bitmap image file
formats cannot be edited using these image-editing features.
Insert an image placeholder
An image placeholder is a graphic you use until final artwork is ready to be added to a web page. You can set the
placeholder’s size and color, as well as provide it with a text label.
1In the Document window, place the insertion point where you want to insert a placeholder graphic.
2Select Insert > Image Objects > Image Placeholder.
3For Name (Optional), enter text you want to appear as a label for the image placeholder. Leave the text box blank
if you do not want a label to appear. The name must begin with a letter and can contain only letters and numbers;
spaces and high ASCII characters are not allowed.
September 4, 2007
DREAMWEAVER CS3
User Guide
248
4For Width and Height (Required), type a number to set the image size in pixels.
5For Color (Optional), do one of the following to apply a color:
•Use the color picker to select a color.
•Enter the color’s hexadecimal value (for example, #FF0000).
•Enter a web-safe color name (for example, red).
6For Alternate Text (Optional), enter text to describe the image for viewers using a text-only browser.
Note: An image tag is automatically inserted into the HTML code containing an empty src attribute.
7Click OK.
The placeholder’s color, size attributes, and label appear as follows:
When viewed in a browser, the label and size text do not appear.
See also
“Visually resize an image” on page 250
“Use Fireworks to modify Dreamweaver image placeholders” on page 368
Set image placeholder properties
To set properties for an image placeholder, select the placeholder in the Document window; then select Window >
Properties to display the Property inspector. To see all properties, click the expander arrow in the lower-right corner.
Use the Property inspector to set a name, width, height, image source, alternate text description, alignment and color
for a placeholder image.
In the placeholder Property inspector, the gray text box and the Align text box are disabled. You can set these
properties in the image Property inspector when you replace the placeholder with an image.
❖Set any of the following options:
W and H Set the width and height of the image placeholder, in pixels.
Src Specifies the source file for the image. For a placeholder image, this text box is empty. Click the Browse button
to select a replacement image for the placeholder graphic.
Link Specifies a hyperlink for the image placeholder. Drag the Point-to-File icon to a file in the Files panel, click the
folder icon to browse to a document on your site, or manually type the URL.
September 4, 2007
DREAMWEAVER CS3
User Guide
249
Alt Specifies alternative text that appears in place of the image for text-only browsers or for browsers that have been
set to download images manually. For visually impaired users who use speech synthesizers with text-only browsers,
the text is spoken out loud. In some browsers, this text also appears when the pointer is over the image.
Create Starts Fireworks to create a replacement image. The Create button is disabled unless Fireworks is also
installed on your computer.
Reset Size Resets the W and H values to the original size of the image.
Color Specifies a color for the image placeholder.
See also
“Use Fireworks to modify Dreamweaver image placeholders” on page 368
Replace an image placeholder
An image placeholder does not display an image in a browser. Before you publish your site you should replace any
image placeholders you’ve added with web-friendly image files, such as GIFs or JPEGs.
If you have Fireworks, you can create a new graphic from the Dreamweaver image placeholder. The new image is set
to the same size as the placeholder image. You can edit the image, then replace it in Dreamweaver.
1In the Document window, do one of the following:
•Double-click the image placeholder.
•Click the image placeholder to select it; then in the Property inspector (Window > Properties), click the folder
icon next to the Src text box.
2
In the Image Source dialog box, navigate to the image you want to replace the image placeholder with and click OK.
See also
“Use Fireworks to modify Dreamweaver image placeholders” on page 368
Align an image
You can align an image to text, another image, a plug-in, or other elements in the same line. You can also set the
horizontal alignment of an image.
1Select the image in Design view.
2Set the alignment attributes of the image in the Property inspector with the Align popup menu.
You can set the alignment in relation to other elements in the same paragraph or line.
Note: HTML does not provide a way to wrap text around the contours of an image, as you can with some word
processing applications.
The alignment options are as follows:
Default Specifies a baseline alignment. (The default may vary depending on the site visitor’s browser.)
Baseline and Bottom Align the baseline of the text (or other element in the same paragraph) to the bottom of the
selected object.
Top Aligns the top of an image to the top of the tallest item (image or text) in the current line.
Middle Aligns the middle of the image with the baseline of the current line.
September 4, 2007
DREAMWEAVER CS3
User Guide
250
Text Top Aligns the top of the image with the top of the tallest character in the text line.
Absolute Middle Aligns the middle of the image with the middle of the text in the current line.
Absolute Bottom Aligns the bottom of the image with the bottom of the line of text (which includes descenders, as
in the letter g).
Left Places the selected image on the left margin, wrapping text around it to the right. If left-aligned text precedes
the object on the line, it generally forces left-aligned objects to wrap to a new line.
Right Places the image on the right margin, wrapping text around the object to the left. If right-aligned text precedes
the object on the line, it generally forces right-aligned objects to wrap to a new line.
Visually resize an image
You can visually resize elements such as images, plug-ins, Shockwave or Flash files, applets, and ActiveX controls in
Dreamweaver.
Visually resizing an image helps you see how the image affects the layout at different dimensions but it does not scale
the image file to the proportions that you specify. If you visually resize an image in Dreamweaver without using an
image-editing application (such as Fireworks) to scale the image file to the desired size, the user’s browser scales the
image when the page is loaded. This might cause a delay in page download time and the improper display of the
image in the user’s browser. To reduce download time and to ensure that all instances of an image appear at the same
size, use an image-editing application to scale images.
When you resize an image in Dreamweaver, you can resample it to accommodate its new dimensions. Resampling
adds or subtracts pixels from a resized JPEG and GIF image files to match the appearance of the original image as
closely as possible. Resampling an image reduces its file size and improves download performance.
See also
“Edit images in Dreamweaver” on page 247
Visually resize an element
1Select the element (for example, an image or SWF file) in the Document window.
Resize handles appear at the bottom and right sides of the element and in the lower-right corner. If resize handles
don’tappear,clicksomewhereotherthantheelementyouwanttoresizeandthenreselectit,orclicktheappropriate
tag in the tag selector to select the element.
2Resize the element by doing one of the following:
•To adjust the width of the element, drag the selection handle on the right side.
•To adjust the height of the element, drag the bottom selection handle.
•To adjust the width and the height of the element at the same time, drag the corner selection handle.
•To preserve the element’s proportions (its width-to-height ratio) as you adjust its dimensions, Shift-drag the
corner selection handle.
•To adjust the width and height of an element to a specific size (for example, 1 x 1 pixel), use the Property inspector
to enter a numeric value. Elements can be visually resized to a minimum of 8 x 8 pixels.
3To return a resized element to its original dimensions, in the Property inspector, delete the values in the W and H
text boxes, or click the Reset Size button in the image Property inspector.
September 4, 2007
DREAMWEAVER CS3
User Guide
251
Revert an image to its original size
❖Click the Reset size button in the image Property inspector.
Resample a resized image
1Resize the image as described above.
2Click the Resample button in the image Property inspector.
Note: You cannot resample image placeholders or elements other than bitmap images.
Crop an image
Dreamweaver lets you crop (or trim) bitmap file images.
Note: When you crop an image, the source image file is changed on disk. For this reason, you may want to keep a backup
copy of the image file in the event you need to revert to the original image.
1Open the page containing the image you want to crop, select the image, and do either of the following:
•Click the Crop Tool icon in the image Property inspector.
•Select Modify > Image > Crop.
Crop handles appear around the selected image.
2Adjust the crop handles until the bounding box surrounds the area of the image that you want to keep.
3Double-click inside the bounding box or press Enter to crop the selection.
4A dialog box informs you that the image file you are cropping will be changed on disk. Click OK. Every pixel in
the selected bitmap outside the bounding box is removed, but other objects in the image remain.
5Preview the image and ensure that it meets your expectations. If not, select Edit > Undo Crop to revert to the
original image.
Note: You can undo the effect of the Crop command (and revert to the original image file) up until the time that you quit
Dreamweaver, or edit the file in an external image-editing application.
Optimize an image
You can optimize images in your web pages from within Dreamweaver.
1Open the page containing the image you want to optimize, select the image, and do either of the following:
•Click the Optimize button in the image Property inspector.
•Select Modify > Image > Optimize Image In Fireworks.
2Confirm whether to optimize as a PNG file or use the open image file.
3Edit the image file, click Update, and save the file.
Adjust the brightness and contrast of an image
Brightness/Contrast modifies the contrast or brightness of pixels in an image. This affects the highlights, shadows,
and midtones of an image. You typically use Brightness/Contrast when correcting images that are too dark or too
light.
1Open the page containing the image you want to adjust, select the image, and do either of the following:
•Click the Brightness/Contrast button in the image Property inspector.
September 4, 2007
DREAMWEAVER CS3
User Guide
252
•Select Modify > Image > Brightness/Contrast.
2Drag the Brightness and Contrast sliders to adjust the settings. Values range from -100 to 100.
3Click OK.
Sharpen an image
Sharpening increases the contrast of pixels around the edges of objects to increase the image’s definition or
sharpness.
1Open the page containing the image you want to sharpen, select the image, and do either of the following:
•Click the Sharpen button in the image Property inspector.
•Select Modify > Image > Sharpen.
2You can specify the degree of sharpening Dreamweaver applies to the image by dragging the slider control, or
entering a value between 0 and 10 in the text box. As you adjust the sharpness of the image using the Sharpness dialog
box, you can preview the change to the image.
3Click OK when you are satisfied with the image.
4Save your changes by selecting File > Save, or revert to the original image by selecting Edit > Undo Sharpen.
Note: You can only undo the effect of the Sharpen command (and revert to the original image file) prior to saving the
page containing the image. After you save the page, the changes made to the image are permanently saved.
Create a rollover image
You can insert rollover images in your page. A rollover is an image that, when viewed in a browser, changes when the
pointer moves across it.
You must have two images to create the rollover: a primary image (the image displayed when the page first loads)
and a secondary image (the image that appears when the pointer moves over the primary image). Both images in a
rollovershouldbethesamesize;iftheimagesarenotthesamesize,Dreamweaverresizesthesecondimagetomatch
the properties of the first image.
Rollover images are automatically set to respond to the onMouseOver event. You can set an image to respond to a
different event (for example, a mouse click) or change a rollover image.
For a tutorial on creating rollovers, see www.adobe.com/go/vid0159.
1In the Document window, place the insertion point where you want the rollover to appear.
2Insert the rollover using one of these methods:
•In the Common category of the Insert bar, click the Images button and select the Rollover Image icon. With the
Rollover Image icon displayed in the Insert bar, you can drag the icon to the Document window.
•Select Insert > Image Objects > Rollover Image.
3Set the options and click OK.
Image Name The name of the rollover image.
Original image The image you want to display when the page loads. Enter the path in the text box, or click Browse
and select the image.
Rollover Image The image you want to display when the pointer rolls over the original image. Enter the path or click
Browse to select the image.
September 4, 2007
DREAMWEAVER CS3
User Guide
253
Preload Rollover Image Preloadstheimagesinthebrowser’scachesonodelayoccurswhentheuserrollsthepointer
over the image.
Alternate Text (Optional) Text to describe the image for viewers using a text-only browser.
When Clicked Go to URL The file that you want to open when a user clicks the rollover image. Enter the path or click
Browse and select the file.
Note: If you don’t set a link for the image, Dreamweaver inserts a null link (#) in the HTML source code to which the
rollover behavior is attached. If you remove the null link, the rollover image will no longer work.
4Select File > Preview in Browser or press F12.
5In the browser, move the pointer over the original image to see the rollover image.
Note: You cannot see the effect of a rollover image in Design view.
See also
“Apply the Swap Image behavior” on page 363
“Insert a navigation bar” on page 292
Use an external image editor
WhileinDreamweaver,youcanopenaselectedimageinanexternalimageeditor;whenyoureturntoDreamweaver
after saving the edited image file, any changes you made to the image are visible in the Document window.
You can set up Fireworks as your primary external editor. You can also set which file types an editor opens; and you
can select multiple image editors. For example, you can set preferences to start Fireworks when you want to edit a
GIF, and to start a different image editor when you want to edit a JPG or JPEG.
See also
“Working with Photoshop” on page 374
“Working with Fireworks” on page 367
“Start an external editor for media files” on page 271
Start the external image editor
❖Do one of the following:
•Double-click the image you want to edit.
•Right-click (Windows) or Control-click (Macintosh) the image you want to edit, then select Edit With > Browse
and select an editor.
•Select the image you want to edit, and click Edit in the Property inspector.
•Double-click the image file in the Files panel to start the primary image editor. If you haven’t specified an image
editor, Dreamweaver starts the default editor for the file type.
Note: When you open an image from the Files panel, the Fireworks integration features are not in effect; Fireworks does
not open the original PNG file. To use the Fireworks integration features, open images from within the Document
window.
If you don’t see an updated image after returning to the Dreamweaver window, select the image and then click the
Refresh button in the Property inspector.
September 4, 2007
DREAMWEAVER CS3
User Guide
254
Set an external image editor for an existing file type
You can select an image editor for opening and editing graphic files.
1Open the File Types/Editors Preferences dialog box by doing one of the following:
•Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh), and select File Types/Editors in
the Category list on the left.
•Select Edit > Edit with External Editor and select File Types/Editors.
2In the Extensions list, select the file extension you want to set an external editor for.
3Click the Add (+) button above the Editors list.
4In the Select External Editor dialog box, browse to the application you want to start as an editor for this file type.
5In the Preferences dialog box, click Make Primary if you want this editor to be the primary editor for this file type.
6If you want to set up an additional editor for this file type, repeat steps 3 and 4.
Dreamweaver automatically uses the primary editor when you edit this image type. You can select the other listed
editors from the context menu for the image in the Document window.
Add a new file type to the Extensions list
1Open the File Types/Editors Preferences dialog box by doing one of the following:
•Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh), and select File Types/Editors in
the Category list on the left.
•Select Edit > Edit with External Editor and select File Types/Editors.
2In the File Types/Editors Preferences dialog box, click the Add (+) button above the Extensions list.
A text box appears in the Extensions list.
3Type the file extension of the file type you want to start an editor for.
4To select an external editor for the file type, click the Add (+) button above the Editors list.
5In the dialog box that appears, select the application you want to use to edit this image type.
6Click Make Primary if you want this editor to be the primary editor for the image type.
Change an existing editor preference
1Open the File Types/Editors Preferences dialog box by doing one of the following:
•Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh), and select File Types/Editors in
the Category list on the left.
•Select Edit > Edit with External Editor and select File Types/Editors.
2In the File Types/Editors preferences dialog box, in the Extensions list select the file type you are changing to view
the existing editor(s).
3In the Editors list, select the editor you want to want to affect, then do one of the following:
•Click the Add (+) or Delete (–) buttons above the Editors list to add or remove an editor.
•Click the Make Primary button, to change which editor starts by default for editing.
September 4, 2007
DREAMWEAVER CS3
User Guide
255
Applying behaviors to images
You can apply any available behavior to an image or image hotspot. When you apply a behavior to a hotspot,
Dreamweaver inserts the HTML source code into the area tag. Three behaviors apply specifically to images: Preload
Images, Swap Image, and Swap Image Restore.
Preload Images Loadsimagesthatdonotappearonthepagerightaway(suchasthosethatwillbeswappedinwith
behaviors, AP elements, or JavaScript) into the browser cache. This prevents delays caused by downloading when it
is time for the images to appear.
Swap Image Swaps one image for another by changing the SRC attribute of the img tag. Use this action to create
button rollovers and other image effects (including swapping more than one image at a time).
Swap Image Restore Restores the last set of swapped images to their previous source files. This action is automati-
cally added whenever you attach the Swap Image action to an object by default; you should never need to select it
manually.
You can also use behaviors to create more sophisticated navigation systems, such as a navigation bar or a jump menu.
See also
“Insert a jump menu” on page 290
“Insert a navigation bar” on page 292
“Apply the Swap Image behavior” on page 363
“Apply the Preload Images behavior” on page 357
Inserting Flash content
About Flash file types
Dreamweaver comes with Flash objects you can use whether you have Flash installed on your computer or not.
BeforeyouusetheFlashcommandsavailableinDreamweaver,youshouldknowaboutthedifferentFlashfiletypes:
The Flash file (.fla) The source file for any project and is created in the Flash program. This type of file can only be
opened in Flash (not in Dreamweaver or in browsers). You can open the Flash file in Flash, then export it as an SWF
or SWT file to use in browsers.
The Flash SWF file (.swf) A compressed version of the Flash (.fla) file, optimized for viewing on the web. This file can
be played back in browsers and previewed in Dreamweaver, but cannot be edited in Flash. This is the type of file you
create when using the Flash button and Flash text objects.
The Flash template files (.swt) These files enable you to modify and replace information in a Flash SWF file. The files
are used in the Flash button object, which lets you modify the template with your own text or links, to create a custom
SWF to insert in your document. In Dreamweaver, these template files can be found in the Dreamweaver/Configu-
ration/Flash Objects/Flash Buttons and Flash Text folders.
You can download new button templates from the Adobe Exchange for Dreamweaver website
(www.adobe.com/go/dreamweaver_exchange) and place them in your Flash Buttons folder. For more information
on creating new button templates, see the article on that topic at www.adobe.com/go/flash_buttons.
September 4, 2007
DREAMWEAVER CS3
User Guide
256
The Flash element file (.swc) A Flash SWF file that lets you create Rich Internet applications by incorporating them
in a web page. Flash elements have customizable parameters that you can modify to perform different application
functions.
The Flash Video file format (.flv) A video file that contains encoded audio and video data for delivery through Flash®
Player. For example, if you had a QuickTime or Windows Media video file, you would use an encoder (such as Flash®
8 Video Encoder, or Sorensen Squeeze) to convert the video file to an FLV file. For more information, visit the Flash
Video Developer Center at www.adobe.com/go/flv_devcenter.
See also
“Working with Flash” on page 382
“Create and insert a Flash button” on page 257
“Modify a Flash button object” on page 258
“Adding Flash Video content” on page 264
Insert and preview Flash content
Use Dreamweaver to add Flash content (SWF files and Shockwave movies) in your pages, and then preview it in a
document and a browser. You can also set properties for Flash content in the Property inspector.
For a tutorial on adding Flash content to web pages, see www.adobe.com/go/vid0150.
See also
“Working with Flash” on page 382
“Edit a SWF file from Dreamweaver in Flash” on page 382
“Insert Shockwave movies” on page 273
“Adding Flash Video content” on page 264
Insert a SWF file (Flash content)
1IntheDesignviewoftheDocumentwindow,placetheinsertionpointwhereyouwanttoinsertthecontent,then
do one of the following:
•In the Common category of the Insert bar, select Media and click the Flash icon .
•Select Insert > Media > Flash.
2In the dialog box that appears, select a Flash file (.swf).
A Flash placeholder appears in the Document window (unlike Flash button and text objects).
Preview Flash content in the Document window
1In the Document window, click the Flash placeholder to select the Flash content you want to preview.
2In the Property inspector, click the Play button. Click Stop to end the preview. You can also preview the Flash
content in a browser by pressing F12.
To preview all Flash content in a page, press Control+Alt+Shift+P (Windows) or Shift+Option+Command+P
(Macintosh). All Flash objects and SWF files are set to Play.
September 4, 2007
DREAMWEAVER CS3
User Guide
257
Set Flash and Shockwave movie properties
To ensure the best results in both Internet Explorer and Netscape Navigator, Dreamweaver inserts Flash and
Shockwave movies using both the object and embed tags. (The object tag is defined by Microsoft for ActiveX
controls; embed is defined by Netscape Navigator for plug-ins.) To view the following properties in the Property
inspector, select a Flash SWF file or a Shockwave movie.
❖Select a Flash SWF file or a Shockwave movie and set the options in the Property inspector (To see all Flash SWF
file properties, click the expander arrow in the lower-right corner of the Property inspector.)
Name Specifies a name to identify the movie for scripting. Enter a name in the unlabeled text box on the far left side
of the Property inspector.
W and H Specify the width and height of the movie, in pixels.
File Specifies the path to the Flash or Shockwave file. Click the folder icon to browse to a file, or type a path.
Src Specifies the path to a Flash source document (FLA), when Dreamweaver and Flash are both installed on your
computer. To edit a Flash file (SWF), you update the movie’s source document.
Edit Start Flash to update a FLA file (a file created in the Flash authoring tool). This option is disabled if you do not
have Flash loaded on your computer.
Reset Size Returns the selected movie to its original size.
Loop Makes the movie play continuously; when unchecked, the movie plays once and stops.
Autoplay Automatically plays the movie when the page loads.
V Space and H Space Specify the number of pixels of white space above, below, and on both sides of the movie.
Quality Controls anti-aliasing during playback of the movie. A movie looks better with a high setting, but it requires
a faster processor to render correctly on the screen. Low emphasizes speed over appearance, whereas High favors
appearance over speed. Auto Low emphasizes speed at first, but improves appearance when possible. Auto High
emphasizes both qualities at first, but sacrifices appearance for speed if necessary.
Scale Determines how the movie fits into the dimensions set in the width and height text boxes. The Default setting
displays the entire movie.
No Border Fits the movie into the set dimensions so that no borders show and maintains the original aspect ratio.
Exact Fit Scales the movie to the set dimensions, regardless of the aspect ratio.
Align Determines how the movie is aligned on the page.
Bg Specifies a background color for the movie area. This color also appears while the movie is not playing (while
loading and after playing).
Parameters Opens a dialog box for entering additional parameters to pass to the movie. The movie must be designed
to receive these additional parameters.
Create and insert a Flash button
You can create and insert Flash buttons in your documents while working in Design view or Code view. Having Flash
installed is not required to do this; the Flash button object is an updateable button based on a Flash template.
Note: You must save your document before inserting a Flash button or text object.
1In the Document window, place the insertion point where you want to insert the Flash button.
September 4, 2007
DREAMWEAVER CS3
User Guide
258
2To open the Insert Flash Object dialog box, do one of the following:
•In the Common category of the Insert bar, select Media and click the Flash Button icon .
•Select Insert > Media > Flash Button.
3Complete the Insert Flash Button dialog box, and click Apply or OK to insert the Flash button in the Document
window.
To preview the button in Design view, click Apply. The dialog box remains open, and you can preview the button in
your document.
Modify a Flash button object
You can modify the properties and content of a Flash button object.
The Property inspector displays the Flash button properties. You can use the Property inspector to specify the
button’s HTML physical attributes, such as width, height, and background color. (Click the expander arrow in the
lower-right corner to see more properties.)
To modify other content properties of a Flash button, such as button text and color, and the URL the browser opens
when the button is clicked, use the Insert Flash Button dialog box.
See also
“Insert a Flash text object” on page 260
“Align an image” on page 249
“Visually resize an image” on page 250
“Use parameters to control media objects” on page 277
“Add and manage extensions in Dreamweaver” on page 710
Modify Flash object properties in the Property inspector
1In the Document window, click the Flash button object to select it.
2Open the Property inspector, if it is not already open. (Click the expander arrow in the lower-right corner to see
more properties.)
3Set the options in the Property inspector.
Name Specifies the name to identify the button for scripting. Enter a name in the unlabeled text box on the far left
side of the Property inspector.
W and H Specify the width and height of the object, in pixels. (In Design view, you can resize the object easily by
using the resizing handles. You can return the object to its original size by selecting Reset Size in the Property
inspector.)
File Specifies the path to the Flash object file. Click the folder icon to browse to a file, or type a path.
Edit Opens the Flash object dialog box for edits to the selected Flash object.
Reset Size Resets the selected object to the original size.
V Space and H Space Specify the number of pixels of white space above, below, and on both sides of the button.
Quality Sets the quality parameter for the object and embed tags that define the button. Flash content looks better
with a high setting, but it requires a faster processor to render correctly on the screen. Low emphasizes speed over
September 4, 2007
DREAMWEAVER CS3
User Guide
259
appearance, whereas High favors appearance over speed. Auto Low emphasizes speed at first, but improves
appearance when possible. Auto High emphasizes both qualities at first, but sacrifices appearance for speed if
necessary.
Scale Sets the scale parameter for the object and embed tags that define the button or text object. This parameter
defines how the Flash content displays within the area defined for the SWF file by the width and height values. The
choices are Default (Show All), No Border, and Exact Fit. Show All makes the entire SWF file visible in the specified
area, maintaining the aspect ratio of the SWF file and preventing distortion; borders of the background color may
appear on two sides of the SWF file. No Border is similar to Show All, except portions of the SWF file may be
cropped. With Exact Fit, the entire SWF file fills the specified area, but the aspect ratio of the SWF file is not
maintained and distortion may occur.
Align Defines how the object is aligned on the page.
Bg Specifies a background color for the object.
Play/Stop PreviewstheFlashobjectintheDocumentwindow.ClickthegreenPlaybuttontoseetheobjectinPlay
mode; click the red Stop button to stop the object from playing and be able to edit it.
Parameters Opens a dialog box for entering additional parameters.
Modify Flash object content
1To make changes to content, display the Insert Flash Button dialog box using one of the following methods:
•Double-click the Flash button object.
•Click Edit in the Property inspector.
•Right-click (Windows) or Control-click (Macintosh), and select Edit from the context menu.
2Select a button style from the Style list.
YoucanviewanexampleofthebuttonintheSampletextbox.Clickthesampletoseehowitfunctionsinthebrowser.
Note: While you are defining the Flash button (for example, changing text or font choices), the Sample box does not
automatically update to reflect the changes. These changes will appear when you close the dialog box and view the button
in Design view.
3(Optional) In the Button Text box, type the text you want to appear.
This text box only accepts changes if the selected button has a {Button Text} parameter defined. This is shown in the
Sample text box. The text you type in replaces the {Button Text} when you preview the file.
4From the Font menu, select the button text font.
If the default font for a button is not available on your system, select another font from the menu. The Sample box
doesn’t display the font, but you can click Apply to insert the button in the page to preview the text.
5In the Size box, enter a numeric value for the font size.
6(Optional) In the Link text box, enter a document-relative or absolute link for the button.
This is the URL the browser will open when the visitor clicks the button.
7(Optional) In the Target box, specify the location in which the linked document will open. You can select a frame
or window option in the pop-up menu. Frame names are listed only if the Flash object is being edited while in a
frameset.
8(Optional) In the Bg Color box, set the background color for the Flash SWF file. Use the color picker or type in a
web hexadecimal value (such as #FFFFFF).
September 4, 2007
DREAMWEAVER CS3
User Guide
260
9In the Save As box, enter a filename to save the new SWF file.
You can use the default filename (for example, button1.swf), or type in a new name. If the file contains a document-
relative link, you must save the file to the same directory as the current HTML document to maintain
document-relative links.
10 Click Get More Styles to go the Adobe Exchange site and download more button styles.
11 Click Apply or OK to insert the Flash button in the Document window.
Select Apply to see changes in Design view, while keeping the dialog box open—this way you can continue making
changes to the button.
Preview a Flash button object in the document
You can preview a Flash button in the Dreamweaver Document window. It’s also a good idea to preview your
document in the browser to see how the Flash button looks.
1While in Design view, in the document, select the Flash button object.
2In the Property inspector, click Play.
3Click Stop to end the preview.
Note: You can’t edit the Flash button object while it is playing.
Insert a Flash text object
The Flash text object lets you create and insert a Flash SWF file that contains just text. This allows you to create a
small, vector-graphic movie with the designer fonts and text of your choice.
1In the Document window, place the insertion point where you want to insert the Flash text.
2To open the Insert Flash Text dialog box, do one of the following:
•In the Common category of the Insert bar, select Media and click the Flash Text icon.
•Select Insert > Media > Flash Text.
3Complete the Insert Flash Text dialog box, and click Apply or OK to insert the Flash text in the Document
window.
If you click Apply, the dialog box remains open, and you can preview the text in your document.
To modify or play the Flash text object, use the same procedure as you would for a Flash button.
See also
“Modify a Flash button object” on page 258
“Working with Flash” on page 382
Downloading and installing Flash elements
To use Flash elements in your web pages, you must first add the elements to Dreamweaver using the Adobe®
Extension Manager. The Extension Manager is a separate application that lets you install and manage extensions in
Adobe applications. Start the Extension Manager from Dreamweaver by selecting Commands > Manage Extensions.
September 4, 2007
DREAMWEAVER CS3
User Guide
261
To find the latest Flash elements for Dreamweaver, use the Adobe Exchange website at
www.adobe.com/go/dreamweaver_exchange. Once there, you can log in and download Flash elements and other
Dreamweaver extensions (many of which are free), join discussion groups, view user ratings and reviews, and install
and use the Extension Manager. You must install the Extension Manager before you can install new Flash elements
or other Dreamweaver extensions.
You can use the Extension Manager to install Flash elements (as well as other Dreamweaver extensions).
See also
“Add and manage extensions in Dreamweaver” on page 710
Insert Flash elements
Using Dreamweaver you can insert Flash elements into your documents. Flash elements let you quickly and easily
build Rich Internet Applications using prebuilt elements.
1In the Document window, place the insertion point where you want to insert a Flash element and do one of the
following:
•In the Common category of the Insert bar, click the Media button and select the Flash element you want to insert.
•Select Insert > Media > Flash element name.
Dreamweaver includes one Flash element called Image Viewer.
The Save Flash Element dialog box appears.
2Enter a filename for the Flash element and save it to an appropriate location within your site.
3Click OK.
The Flash element placeholder appears in the document. You can modify the properties of the Flash element using
the Tag and Property inspectors.
4Select File > Preview in Browser to preview the Flash element.
Edit Flash elements
You edit Flash element attributes using the Tag and Property inspectors.
The Tag inspector and the Property inspector both allow you to view and edit a Flash component’s attributes. The
Tag inspector enables you to view and edit customizable attributes (parameters) associated with a given component.
The Property inspector lets you modify the height, width, and SRC attributes of a Flash element, as well as a way to
preview the Flash element in Design view.
1Do one of the following in the Document window:
•In Design view, select the Flash element.
•In Code view, click anywhere in a Flash component’s name or in its contents.
2If it is not already displayed, open the Tag inspector (Window > Tag inspector).
3Edit the Flash element attributes using the Tag inspector and the Property inspector.
•Type a new value for the attribute in the attribute-value column, to the right of the attribute name.
•To change an attribute value, select the value and edit it.
September 4, 2007
DREAMWEAVER CS3
User Guide
262
•To add a value for an attribute with no value, click in the attribute-value column to the right of the attribute and
add a value (see the next procedure).
•If the attribute takes a URL value, enter the URL.
•If the attribute takes pre-defined values, select a value from the pop-up menu (or the color picker) to the right of
the attribute-value column.
•If the attribute takes a value from a source of dynamic content (such as a database), click the Dynamic Data button
to the right of the attribute-value column. Then select a source.
4Press Enter (Windows) or Return (Macintosh), or click elsewhere in the Tag inspector, to update the tag in your
document.
See also
“Defining sources of dynamic content” on page 547
Use the Image Viewer Flash element
Adobe Dreamweaver CS3 contains a Flash element you can use in your pages: a Flash image viewer that can double
as a web photo album.
The Image Viewer element is a resizable application for loading and viewing a series of JPEG or SWF images. You
define a list of images, along with a link and caption for each image.
Users can view images in order with the previous and next buttons, or jump to a specific image by entering that
image's number. You can also set the images to play in a slide-show format.
Note: Website visitors must have Flash® Player 7 or later installed to see any Image Viewers in your pages.
1Place the insertion point in your page where you want the Image Viewer to appear and select Insert > Media >
Image Viewer.
2In the Save Flash Element dialog box, browse to a location in your site to save the element, enter a name, and click Save.
Note: It’s a good idea to save the Flash element in the same Dreamweaver site as the page to which you are adding the
Image Viewer.
The Flash element placeholder appears in your page and the Tag inspector opens.
3Select the Flash element placeholder if it’s not already selected.
4In the Tag inspector (Window > Tag inspector), click the field beside the imageURLs parameter, and click the Edit
Array Values icon at the end of the line.
5In the Edit imageURLs Array dialog box, click the Minus (-) button to remove placeholder elements; to add
images, click the Plus (+) button, click the folder icon next to the blank value line that appears, and select the image
you want to add. You can add JPEG or SWF files.
Note: It’s a good idea to use files that are located in the same Dreamweaver site as the page to which you are adding the
Image Viewer.
6Click OK to close the Edit imageURLs Array dialog box.
7(Optional) Use the Tag inspector to set other parameters for the Image Viewer.
Note: You can also set properties for the Image Viewer in the Property inspector. For more information, select the Flash
element, and click the Help icon in the Property inspector.
September 4, 2007
DREAMWEAVER CS3
User Guide
263
8With the Image Viewer placeholder selected, click the Play button in the expanded Property inspector to start the
Image Viewer, and use the following Image Viewer controls to view images:
•Click the Next or Previous button to view sequential images.
•Enter a number in the text box to skip to a specific image.
•Click the Play button to view the images as a slide show; click the Stop button to stop the slide show format.
9Click the Stop button in the expanded Property inspector to stop playing the Image Viewer.
Image Viewer parameters
Parameter Description
bgColor Specifies the background color.
frameColor Specifies the color of the border for the images. Set the
frameShow parameter to Yes to see the border.
frameShow Indicates whether a border appears around each image.
frameThickness Specifies the size, in pixels, for the border around each
image.
captionColor Specifies the color of the image captions contained in
imageCaptions.
captionFont Specifies the font for the image captions contained in
imageCaptions.
captionSize Indicates the point size of the image captions contained
in imageCaptions.
imageCaptions Contains the captions for each image specified in
imageURLs. Captions can be used for some, all, or
none of the images.
imageLinks Contains a URL for each image specified in
imageURLs. LinkURLs can be used for some, all, or
none of the images.
imageURLs Contains the location of the images to appear in the
Image Viewer. Only non-progressive JPEG or SWF files
can be used.
imgLinkTarget Specifies the browser window in which to load the URLs
specified in linkURLs. This parameter can be set to
_blank,_self,_top, or _parent.
showControls Indicates whether the Image Viewer controls appear
when the user plays the Flash Element.
slideAutoPlay Determines whether to play the images in a slide show.
If set to true, the images begin playing in a slide show as
soon as the first image loads.
slideDelay Indicates the amount of time, in seconds, to wait
between each image when the Play button is pressed or
autoPlay is enabled. Images can change less often
than the time specified for this parameter if they take
longer to load.
slideLoop Specifies that the image slide show plays in a continuous
loop.
September 4, 2007
DREAMWEAVER CS3
User Guide
264
Insert FlashPaper documents
You can insert Adobe® FlashPaper™ documents in your web pages. When a page containing the FlashPaper document
is opened in a browser, the user can browse all the pages in the FlashPaper document without loading new web pages.
The user can also search the document, print it, and zoom in or out.
For more information on FlashPaper, see the Adobe website at www.adobe.com/go/flashpaper.
1IntheDocumentwindow,placetheinsertionpointwhereyouwanttheFlashPaperdocumenttoappearonyour
page, and then select Insert > Media > FlashPaper.
2In the Insert FlashPaper dialog box, browse to and select a FlashPaper document.
3If you want, specify the dimensions of the FlashPaper object on the web page by entering a width and height in
pixels. FlashPaper will scale the document to fit the width.
4Click OK to insert the document in the page.
Because a FlashPaper document is a Flash object, a Flash placeholder appears on the page.
5To preview the FlashPaper document, click the placeholder and then click the Play button in the Property
inspector.
6Click Stop to end the preview. You can also preview the document in a browser by pressing F12. The FlashPaper
toolbar is fully functional in the browser.
To preview all Flash content in a page, press Control+Alt+Shift+P (Windows) or Shift+Option+Command+P
(Macintosh). All Flash objects and SWF files are set to Play.
7If you want, set other properties in the Property inspector.
As a Flash object, the FlashPaper object shares the Flash object’s Property inspector. For information on setting the
properties, click the Help button in the Property inspector.
Adding Flash Video content
Insert Flash Video
You can easily insert Flash Video content in your web pages without using the Flash authoring tool. You must have
an encoded Flash Video (FLV) file before you begin.
title Specifies the title that appears at the top of the Image
Viewer.
titleColor Specifies the color of the title contained in title.
titleFont Specifies the font for the Image Viewer title contained in
title.
titleSize Indicates the point size of the Image Viewer title
contained in title.
transitionsType Indicates how images appear in the Image Viewer. Select
from several loading options.
Parameter Description
September 4, 2007
DREAMWEAVER CS3
User Guide
265
Dreamweaver inserts the Flash Video component; when viewed in a browser, this component displays the Flash
Video content you select, as well as a set of playback controls.
Dreamweaver gives you the following options for delivering Flash Video to your site visitors:
Progressive Download Video Downloads the Flash Video (FLV) file to the site visitor’s hard disk and then plays it.
Unlike traditional “download and play” methods of video delivery, however, progressive download allows the video
file to start playing before the download is complete.
Streaming Video Streams the Flash Video content and plays it on a web page after a short buffer period that ensures
smooth playback. To enable streaming video on your web pages, you must have access to Adobe® Flash® Media
Server.
You must have an encoded Flash Video (FLV) file before you can use it in Dreamweaver. You can insert video files
created with two kinds of codecs (compression/decompression technologies): Sorenson Squeeze and On2.
•If you created your video with the Sorenson Squeeze codec, site visitors will need Flash® Player 7 from Adobe or
later to play progressive download video; they will need Flash Player 6.0.79 or later to play streaming video.
•If you created your video with the On2 codec, site visitors will need Flash Player 8 or later.
After inserting a Flash Video file in a page, you can insert code in the page to detect whether the user has the correct
version of Flash Player to view the Flash Video. If they don’t have the correct version, they will be prompted to
download the latest version of Flash Player.
For more information about Flash Video, visit the Flash Video Developer Center at
www.adobe.com/go/flv_devcenter.
Insert a Flash Video
1Select Insert > Media > Flash Video.
2In the Insert Flash Video dialog box, select Progressive Download or Streaming Video from the Video Type
pop-up menu.
3Complete the rest of the dialog box options and click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
266
Set options for progressive download video
The Insert Flash Video dialog box lets you set options for progressive download delivery of a Flash Video (FLV) file
inserted in a web page.
1Select Insert > Media > Flash Video (or click the Flash Video icon in the Common insert bar).
2In the Insert Flash Video dialog box, select Progressive Download Video from the Video Type menu.
3Specify the following options:
URL Specifies a relative or absolute path to the FLV file. To specify a relative path (for example, mypath/myvideo.flv),
click the Browse button, navigate to the FLV file, and select it. To specify an absolute path, type the URL (for example,
http://www.example.com/myvideo.flv) of the FLV file.
Note: For the video player to function correctly, the FLV file must contain metadata. FLV files created with Flash
Communication Server 1.5.2, FLV Exporter version 1.2, and Sorenson Squeeze 4.0 automatically contain metadata.
On the Macintosh, you must use an absolute path if you are pointing to FLV files in directories that are two or more
levels up from the HTML file.
Skin Specifies the appearance of the Flash Video component. A preview of the selected skin appears beneath the
Skin pop-up menu.
Width Specifies the width of the FLV file, in pixels. To have Dreamweaver determine the exact width of the FLV file,
click the Detect Size button. If Dreamweaver cannot determine the width, you must type a width value.
Height Specifies the height of the FLV file, in pixels. To have Dreamweaver determine the exact height of the FLV
file, click the Detect Size button. If Dreamweaver cannot determine the height, you must type a height value.
Note: Total With Skin is the width and height of the FLV file plus the width and height of the selected skin.
Constrain Maintains the same aspect ratio between the width and height of the Flash Video component. This option
is selected by default.
Auto Play Specifies whether to play the video when the web page is opened.
Auto Rewind Specifies whether the playback control returns to starting position after the video finishes playing.
Prompt Users To Download Flash Player If Necessary Inserts code in the page that detects the version of Flash Player
required to view the Flash Video, and prompts the user to download the latest version of Flash Player if they don’t
have the required version.
Message SpecifiesthemessagethatwillbedisplayediftheuserneedstodownloadthelatestversionofFlashPlayer
to view the Flash Video.
4Click OK to close the dialog box and add the Flash Video content to your web page.
The Insert Flash Video command generates a video player SWF file and a skin SWF file that are used to display your
Flash Video content on a web page. (To see the new files, you may need to click the Refresh button in the Files panel.)
These files are stored in the same directory as the HTML file to which you’re adding Flash Video content. When you
uploadtheHTMLpagecontainingFlashVideocontent,Dreamweaveruploadsthesefilesasdependentfiles(aslong
as you click Yes in the Put Dependent Files dialog box).
Set options for streaming video
The Insert Flash Video dialog box lets you set options for streaming video download of a Flash Video (FLV) file
inserted in a web page.
1Select Insert > Media > Flash Video (or click the Flash Video icon in the Common insert bar).
September 4, 2007
DREAMWEAVER CS3
User Guide
267
2Select Streaming Video from the Video Type pop-up menu.
Server URI Specifies the server name, application name, and instance name in the form
rtmp://www.example.com/app_name/instance_name.
Stream Name Specifies the name of the FLV file that you want to play (for example, myvideo.flv). The .flv extension
is optional.
Note: For the video player to function correctly, the FLV file must contain metadata. FLV files created with Flash®
Communication Server 1.5.2, FLV Exporter version 1.2, and Sorenson Squeeze 4.0 automatically contain metadata.
Skin Specifies the appearance of the Flash Video component. A preview of the selected skin appears beneath the
Skin pop-up menu.
Width Specifies the width of the FLV file, in pixels. To have Dreamweaver determine the exact width of the FLV file,
click the Detect Size button. If Dreamweaver cannot determine the width, you must type a width value.
Height Specifies the height of the FLV file, in pixels. To have Dreamweaver determine the exact height of the FLV
file, click the Detect Size button. If Dreamweaver cannot determine the height, you must type a height value.
Note: Total With Skin is the width and height of the FLV file plus the width and height of the selected skin.
Constrain Maintains the same aspect ratio between the width and height of the Flash Video component. This option
is selected by default.
Live Video Feed Specifies whether the Flash Video content is live. If Live Video Feed is selected, Flash Player will play
a live video feed streamed from Flash® Media Server. The name of the live video feed is the name specified in the
Stream Name text box.
Note: When you select Live Video Feed, only the volume control appears on the component’s skin, because you cannot
manipulate live video. Additionally, the Auto Play and Auto Rewind options have no effect.
Auto Play Specifies whether to play the video when the web page is opened.
Auto Rewind Specifies whether the playback control returns to starting position after the video finishes playing.
Buffer Time Specifies the time, in seconds, required for buffering before the video starts playing. The default buffer
time is set to 0 so that the video starts playing instantly after the Play button is clicked. (If Auto Play is selected, the
video starts playing as soon as a connection is made with the server.) You might want to set a buffer time if you are
delivering video that has a higher bit rate than the site visitor’s connection speed, or when Internet traffic might cause
bandwidth or connectivity problems. For example, if you want to send 15 seconds of video to the web page before
the web page starts to play the video, set the buffer time to 15.
Prompt Users to Download Flash Player if Necessary InsertscodeinthepagethatdetectstheversionofFlashPlayer
required to view the Flash Video, and prompts the user to download the latest version of Flash Player if they don’t
have the required version.
Message SpecifiesthemessagethatwillbedisplayediftheuserneedstodownloadthelatestversionofFlashPlayer
to view the Flash Video.
3Click OK to close the dialog box and add the Flash Video content to your web page.
The Insert Flash Video command generates a video player SWF file and a skin SWF file that are used to display your
Flash Video on a web page. The command also generates a main.asc file that you must upload to your Flash Media
Server. (To see the new files, you may need to click the Refresh button in the Files panel.) These files are stored in the
same directory as the HTML file to which you’re adding Flash Video content. When you upload the HTML page
containing Flash Video content, don’t forget to upload the SWF files to your web server, and the main.asc file to your
Flash Media Server.
September 4, 2007
DREAMWEAVER CS3
User Guide
268
Note: If you already have a main.asc file on your server, check with your server administrator before uploading the
main.asc file generated by the Insert Flash Video command.
You can easily upload all of the required media files by selecting the Flash Video component placeholder in the
Dreamweaver Document window, and clicking the Upload Media button in the Property inspector (Window >
Properties). To see a list of required files, click Show required files.
Note: The Upload Media button does not upload the HTML file that contains the Flash Video content.
Detect the Flash Player version to view the Flash Video
When inserting a Flash Video file in your page, you can also insert code to detect whether the user has the correct
version of the Flash Player to view the Flash Video. If they don’t have the correct version, they will be prompted to
download the latest version of Flash Player.
A different version of Flash Player may be needed to view a Flash Video depending on the codec used to create the
video. If your video was created with the Sorenson Squeeze codec, site visitors will need Flash Player 7 or later to play
progressive download video, and they’ll need Flash Player 6.0.79 or later to play streaming video. If your video was
created with the On2 codec, site visitors will need Flash Player 8 or later.
Insert code that detects the Flash Player version
1When inserting a Flash Video in a page, select the option Prompt Users To Download Flash Player If Necessary
in the Insert Flash Video dialog box.
If the Flash Video is already in your page, delete it and insert it again with the option selected.
Note: If you insert another Flash Video that requires a higher version of Flash Player than the first video, the detection
code prompts the user to download it.
2Accept the default warning message, or provide one of your own.
If you decide to remove the Flash Video from your page, you no longer need the detection code. You can use
Dreamweaver to remove it.
Remove the code that detects the Flash Player version
❖Select Commands > Remove Flash Video Detection.
Edit or delete a Flash Video component
To change the settings for the Flash Video content in your web page, you must either select the Flash Video
component placeholder in the Dreamweaver Document window and use the Property inspector, or you must delete
the Flash Video component and reinsert it by selecting Insert > Media > Flash Video.
Edit the Flash Video component
1Select the Flash Video component placeholder in the Dreamweaver Document window by clicking the Flash
Video icon at the center of the placeholder.
2Open the Property inspector (Window > Properties) and make your changes.
Note: You cannot change video types (from progressive download to streaming, for example) by using the Property
inspector. To change the video type, you must delete the Flash Video component, and reinsert it by selecting Insert >
Media > Flash Video.
September 4, 2007
DREAMWEAVER CS3
User Guide
269
Delete the Flash Video component
❖Select the Flash Video component placeholder in the Dreamweaver Document window and press Delete.
Adding Sound
Audio file formats
You can add sound to a web page. There are several different types of sound files and formats, including .wav, .midi,
and .mp3. Some factors to consider before deciding on a format and method for adding sound are its purpose, your
audience, file size, sound quality, and differences in browsers.
Note: Sound files are handled very differently and inconsistently by different browsers. You may want to add a sound file
to a Flash SWF file and then embed the SWF file to improve consistency.
The following list describes the more common audio file formats along with some of the advantages and disadvan-
tages of each for web design.
.midi or .mid (Musical Instrument Digital Interface) This format is for instrumental music. MIDI files are supported
by many browsers and don’t require a plug-in. Although their sound quality is very good, it can vary depending on
a visitor’s sound card. A small MIDI file can provide a long sound clip. MIDI files cannot be recorded and must be
synthesized on a computer with special hardware and software.
.wav (Waveform Extension) These files have good sound quality, are supported by many browsers, and don’t require
a plug-in. You can record your own WAV files from a CD, tape, microphone, and so on. However, the large file size
severely limits the length of sound clips that you can use on your web pages.
.aif (Audio Interchange File Format, or AIFF) The AIFF format, like WAV format, has good sound quality, can be
played by most browsers, and doesn’t require a plug-in; you can also record AIFF files from a CD, tape, microphone,
and so on. However, the large file size severely limits the length of sound clips that you can use on your web pages.
.mp3 (Motion Picture Experts Group Audio, or MPEG-Audio Layer-3) A compressed format that makes sound files
substantiallysmaller.Thesoundqualityisverygood:ifanmp3fileisrecordedandcompressedproperly,itsquality
can rival that of a CD. mp3 technology lets you “stream” the file so that a visitor doesn’t have to wait for the entire
file to download before hearing it. However, the file size is larger than a Real Audio file, so an entire song could still
take quite a while to download over a typical dial-up (telephone line) modem connection. To play mp3 files, visitors
must download and install a helper application or plug-in, such as QuickTime, Windows Media Player or RealPlayer.
.ra, .ram, .rpm, or Real Audio This format has a high degree of compression, with smaller file sizes than mp3. Entire
song files can be downloaded in a reasonable amount of time. Because the files can be “streamed” from a normal web
server,visitorscanbeginlisteningtothesoundbeforethefilehascompletelydownloaded.Visitorsmustdownload
and install the RealPlayer helper application or plug-in to play these files.
.qt, .qtm, .mov or QuickTime This format is both an audio and video format developed by Apple Computer.
QuickTime is included with Apple Macintosh operating systems, and is used by most Macintosh applications that
use audio, video, or animation. PCs can also play files in QuickTime format, but require a special QuickTime driver.
QuickTime supports most encoding formats, including Cinepak, JPEG, and MPEG.
Note: In addition to the more common formats listed above, there are many different audio and video file formats
availableforuseontheweb.Ifyouencounteramediafileformatthatyouareunfamiliarwith,locatethecreatorofthe
format for information on how best to use and deploy it.
September 4, 2007
DREAMWEAVER CS3
User Guide
270
See also
“Insert and edit media objects” on page 270
Link to an audio file
Linking to an audio file is a simple and effective way to add sound to a web page. This method of incorporating sound
files lets visitors choose whether they want to listen to the file, and makes the file available to the widest audience.
1Select the text or image you want to use as the link to the audio file.
2In the Property inspector, click the folder icon next to the Link text box to browse for the audio file, or type the
file’s path and name in the Link text box.
Embed a sound file
Embedding audio incorporates the sound directly into the page, but the sound only plays if visitors to your site have
the appropriate plug-in for the chosen sound file. Embed files if you want to use the sound as background music, or
if you want to control the volume, the way the player looks on the page, or the beginning and ending points of the
sound file.
When incorporating sound files in your web pages, carefully consider their appropriate use in your web site, and how
visitors to your site use these media resources. Always provide a control to either enable or disable the playing of the
sound, in the event that visitors don’t want to listen to the audio content.
1In Design view, place the insertion point where you want to embed the file and do one of the following:
•
IntheCommoncategoryoftheInsertbar,clicktheMediabuttonandselectthePluginiconfromthepop-upmenu.
•Select Insert > Media > Plugin.
2In the Property inspector, click the folder icon next to the Link text box to browse for the audio file, or type the
file’s path and name in the Link text box.
3Enter the width and height by entering the values in the appropriate text boxes or by resizing the plug-in place-
holder in the Document window.
These values determine the size at which the audio controls are displayed in the browser.
See also
“Insert Netscape Navigator plug-in content” on page 274
Adding other media objects
Insert and edit media objects
You can insert Flash SWF files or objects, QuickTime or Shockwave movies, Java applets, ActiveX controls, or other
audio or video objects in a Dreamweaver document. If you inserted accessibility attributes with a media object, you
can set the accessibility attributes and edit those values in the HTML code.
1Place the insertion point in the Document window where you want to insert the object.
September 4, 2007
DREAMWEAVER CS3
User Guide
271
2Insert the object by doing one of the following:
•In the Common category of the Insert bar, click the Media button and select the icon for the type of object you
want to insert.
•Select the appropriate object from the Insert > Media submenu.
•If the object you want to insert is not a Flash, Shockwave, Applet, or ActiveX object, select Plugin from the Insert >
Media submenu.
A dialog box appears letting you select a source file and specify certain parameters for the media object.
To prevent such dialog boxes from appearing, select Edit > Preferences > General (Windows) or Dreamweaver >
Preferences > General (Macintosh) and deselect the Show Dialog When Inserting Objects option. To override
whatever preference is set for showing dialog boxes, hold down the Control (Windows) or Option (Macintosh) key while
inserting the object. (For example, to insert a placeholder for a Shockwave movie without specifying the file, hold down
Control or Option, and either click the Shockwave button in Media pop-up menu of the Common Insert bar, or select
Insert > Media > Shockwave.)
3Complete the Select File or Insert Flash dialog box, and click OK.
Note: The Accessibility Attributes dialog box appears if you have chosen to show attributes when inserting media in the
Edit > Preferences dialog box.
4Set the accessibility attributes.
Note: YoucanalsoeditmediaobjectattributesbyselectingtheobjectandeditingtheHTMLcodeinCodeview,orright-
clicking (Windows) or Control-clicking (Macintosh), and selecting Edit Tag Code.
Title Enter a title for the media object.
Access Key Enter a keyboard equivalent (one letter) in the text box to select the form object in the browser. This lets
avisitortothesiteusetheControlkey(Windows)withtheAccessKeytoaccesstheobject.Forexample,ifyouenter
B as the Access Key, use Control+B to select the object in the browser.
Tab Index Enter a number for the tab order of the form object. Setting a tab order is useful when you have other links
and form objects on the page and need the user to tab through them in a specific order. If you set tab order for one
object, be sure to set the tab order for all of them.
5Click OK to insert the media object.
Note: If you click Cancel, a media object placeholder appears in the document, but Dreamweaver does not associate
accessibility tags or attributes with it.
To specify a source file, or to set dimensions and other parameters and attributes, use the Property inspector for each
object. You can edit accessibility attributes for an object.
See also
“Optimize the work space for accessible page design” on page 707
“Insert Netscape Navigator plug-in content” on page 274
Start an external editor for media files
You can start an external editor from Dreamweaver to edit most media files. You can also specify the editor you want
Dreamweaver to start to edit the file.
1Make sure the media file type is associated to an editor on your system.
September 4, 2007
DREAMWEAVER CS3
User Guide
272
To find out what editor is associated with the file type, select Edit > Preferences in Dreamweaver and select File
Types/Editors from the Category list. Click the file’s extension in the Extensions column to view the associated editor
or editors in the Editors column. You can change the editor associated to a file type.
2Double-click the media file in the Files panel to open it in the external editor.
The editor that starts when you double-click the file in the Files panel is called the primary editor. If you double-click
an image file, for example, Dreamweaver opens the file in the primary external image editor such as Adobe
Fireworks.
3If you don’t want to use the primary external editor to edit the file, you can use another editor on your system to
edit the file by doing one of the following:
•In the Files panel, right-click (Windows) or Control-click (Macintosh) the filename and select Open With from
the context menu.
•In Design view, right-click (Windows) or Control-click (Macintosh) the media element within the current page,
and select Edit With from the context menu.
Specify the editor to start from Dreamweaver
You can specify the editor you want Dreamweaver to use for editing a file type, and add or delete file types that
Dreamweaver recognizes.
Explicitly specify which external editors should be started for a given file type
1Select Edit > Preferences and select File Types/Editors from the Category list.
Filename extensions, such as .gif, .wav, and .mpg, are listed on the left under Extensions. Associated editors for a
selected extension are listed on the right under Editors.
2Select the file type extension in the Extensions list and do one of the following:
•Toassociateaneweditorwiththefiletype,clickthePlus(+)buttonabovetheEditorslistandcompletethedialog
box that appears.
For example, select the application icon for Acrobat to associate it with the file type.
•To make an editor the primary editor for a file type (that is, the editor that opens when you double-click the file
type in the Files panel), select the editor in the Editors list and click Make Primary.
•To dissociate an editor from a file type, select the editor in the Editors list and click the Minus (-) button above the
Editors list.
Add a new file type and associated editor
1Click the Plus (+) button above the Extensions list and enter a file type extension (including the period at the
beginning of the extension) or several related extensions separated by spaces.
For example, you might enter .xml .xsl if you wanted to associate them with an XML editor installed on your
system.
2Select an editor for the file type by clicking the Plus (+) button above the Editors list and completing the dialog
box that appears.
Remove a file type
❖Select the file type in the Extensions list and click the Minus (-) button above the Extensions list.
Note: You can’t undo after removing a file type, so be sure that you want to remove it.
September 4, 2007
DREAMWEAVER CS3
User Guide
273
Use Design Notes with media objects
As with other objects in Dreamweaver, you can add Design Notes to a media object. Design Notes are notes
associated with a particular file, that are stored in a separate file. You can use Design Notes to keep track of extra file
information associated with your documents, such as image source filenames and comments on file status.
1Right-click (Windows) or Control-click (Macintosh) the object in the Document window.
Note: You must define your site before adding Design Notes to any object.
2Select Design Notes from the context menu.
3Enter the information you want in the Design Note.
You can also add a Design Note to a media object from the Files panel by selecting the file, revealing the context
menu, and choosing Design Notes from the context menu.
See also
“Enable and disable Design Notes for a site” on page 102
“Storing file information in Design Notes” on page 102
Insert Shockwave movies
You can use Dreamweaver to insert Shockwave movies into your documents. Adobe® Shockwave®, a standard for
interactive multimedia on the web, is a compressed format that allows media files created in Macromedia® Director®
from Adobe to be downloaded quickly and played by most popular browsers.
1In the Document window, place the insertion point where you want to insert a Shockwave movie and do one of
the following:
•In the Common category of the Insert bar, click the Media button and select the Shockwave icon from the
popup menu.
•Select Insert > Media > Shockwave.
2In the dialog box that appears, select a movie file.
3In the Property inspector, enter the width and height of the movie in the W and H text boxes.
See also
“Insert and preview Flash content” on page 256
Add video (non-Flash)
You can add video to your web page in different ways and using different formats. Video can be downloaded to the
user or it can be streamed so that it plays while it is downloading.
1Place the clip in your site folder.
These clips are often in the AVI or MPEG file format.
2Link to the clip or embed it in your page.
To link to the clip, enter text for the link such as “Download Clip”, select the text, and click the folder icon in the
Property inspector. Browse to the video file and select it.
September 4, 2007
DREAMWEAVER CS3
User Guide
274
Note: The user must download a helper application (a plug-in) to view common streaming formats like Real Media,
QuickTime, and Windows Media.
Insert Netscape Navigator plug-in content
You can create content such as a QuickTime movie for a Netscape Navigator plug-in, and then use Dreamweaver to
insert that content into an HTML document. Typical plug-ins include RealPlayer and QuickTime, while some
content files include mp3s and QuickTime movies.
You can preview movies and animations that rely on Netscape Navigator plug-ins directly in the Design view of the
Document window. You can play all plug-in elements at one time to see how the page will look to the user, or you
can play each one individually to ensure that you have embedded the correct media element.
Note: You cannot preview movies or animations that rely on ActiveX controls.
After inserting content for a Netscape Navigator plug-in, use the Property inspector to set parameters for that
content. To view the following properties in the Property inspector, select a Netscape Navigator plug-in object.
The Property inspector initially displays the most commonly used properties. Click the expander arrow in the lower-
right corner to see all properties.
Insert Netscape Navigator plug-in content and set its properties
1IntheDesignviewoftheDocumentwindow,placetheinsertionpointwhereyouwanttoinsertthecontent,then
do one of the following:
•IntheCommoncategoryoftheInsertbar,clicktheMediabuttonandselectthePluginicon fromthemenu.
•Select Insert > Media > Plugin.
2In the dialog box that appears, select a content file for a Netscape Navigator plug-in and click OK.
3Set the plug-in options in the Property inspector.
Name Specifies a name to identify the plug-in for scripting. Enter a name in the unlabeled text box on the far left
side of the Property inspector.
W and H Specify, in pixels, the width and height allocated to the object on the page.
Src Specifies the source data file. Click the folder icon to browse to a file, or enter a filename.
Plg Url Specifies the URL of the pluginspace attribute. Enter the complete URL of the site where users can
download the plug-in. If the user viewing your page does not have the plug-in, the browser tries to download it from
this URL.
Align Determines how the object is aligned on the page.
V Space and H Space Specify the amount of white space in pixels above, below, and on both sides of the plug-in.
Border Specifies the width of the border around the plug-in.
Parameters Opens a dialog box for entering additional parameters to pass to the Netscape Navigator plug-in. Many
plug-ins respond to special parameters. The Flash plug-in, for example, includes parameters for bgcolor,salign,
and scale.
You can also view the attributes assigned to the selected plug-in by clicking the Attribute button. You can edit, add,
and delete attributes such as width and height in this dialog box.
September 4, 2007
DREAMWEAVER CS3
User Guide
275
Play plug-in content in the Document window
1Insert one or more media elements by selecting Insert > Media > Shockwave, Insert > Media > Flash, or Insert >
Media > Plugin.
2Do one of the following:
•Select one of the media elements you have inserted, and select View > Plugins > Play or click the Play button in
the Property inspector.
•Select View > Plugins > Play All to play all of the media elements on the selected page that rely on plug-ins.
Note: Play All only applies to the current document; it does not apply to other documents in a frameset, for example.
Stop playing plug-in content
❖Select a media element and select View > Plugins >Stop, or click the Stop button in the Property inspector.
You can also select View > Plugins > Stop All to stop all plug-in content from playing.
Troubleshooting Netscape Navigator plug-ins
If you have followed the steps to play plug-in content in the Document window, but some of the plug-in content does
not play, try the following:
•Makesuretheassociatedplug-inisinstalledonyourcomputer,andthatthecontentiscompatiblewiththeversion
of the plug-in you have.
•Open the file Configuration/Plugins/UnsupportedPlugins.txt in a text editor and look to see if the problematic
plug-in is listed. This file keeps track of plug-ins that cause problems in Dreamweaver and are therefore unsup-
ported. (If you experience problems with a particular plug-in, consider adding it to this file.)
•Check that you have enough memory. Some plug-ins require an additional 2 to 5 MB of memory to run.
Insert an ActiveX control
You can insert an ActiveX control in your page. ActiveX controls (formerly known as OLE controls) are reusable
components, somewhat like miniature applications, that can act like browser plug-ins. They run in Internet Explorer
with Windows, but they don’t run on the Macintosh or in Netscape Navigator. The ActiveX object in Dreamweaver
lets you supply attributes and parameters for an ActiveX control in your visitor’s browser.
After inserting an ActiveX object, use the Property inspector to set attributes of the object tag and parameters for
the ActiveX control. Click Parameters in the Property inspector to enter names and values for properties that don’t
appear in the Property inspector. There is no widely accepted standard format for parameters for ActiveX controls;
to find out which parameters to use, consult the documentation for the ActiveX control you’re using.
❖In the Document window, place the insertion point where you want to insert the content and do one of the
following:
•In the Common category of the Insert bar, click the Media button and select the ActiveX icon .
•In the Common category of the Insert bar, click the Media button and select the ActiveX icon. With the ActiveX
icon displayed in the Insert bar, you can drag the icon to the Document window.
•Select Insert > Media > ActiveX. An icon marks where the ActiveX control will appear on the page in Internet
Explorer.
September 4, 2007
DREAMWEAVER CS3
User Guide
276
ActiveX properties
The Property inspector initially displays the most commonly used properties. Click the expander arrow in the
lower-right corner to see all properties.
Name Specifies a name to identify the ActiveX object for scripting. Enter a name in the unlabeled text box on the
far left side of the Property inspector.
W and H Specify the width and height of the object, in pixels.
Class ID IdentifiestheActiveXcontroltothebrowser.Enteravalueorselectonefromthepop-upmenu.Whenthe
page is loaded, the browser uses the class ID to locate the ActiveX control required for the ActiveX object associated
with the page. If the browser doesn’t locate the specified ActiveX control, it attempts to download it from the location
specified in Base.
Embed Adds an embed tag within the object tag for the ActiveX control. If the ActiveX control has a Netscape
Navigator plug-in equivalent, the embed tag activates the plug-in. Dreamweaver assigns the values you entered as
ActiveX properties to their Netscape Navigator plug-in equivalents.
Align Determines how the object is aligned on the page.
Parameters Opens a dialog box for entering additional parameters to pass to the ActiveX object. Many ActiveX
controls respond to special parameters.
Src Defines the data file to be used for a Netscape Navigator plug-in if the Embed option is turned on. If you don’t
enter a value, Dreamweaver attempts to determine the value from the ActiveX properties entered already.
V Space and H Space Specify the amount of white space, in pixels, above, below, and on both sides of the object.
Base Specifies the URL containing the ActiveX control. Internet Explorer downloads the ActiveX control from this
location if it has not been installed in the visitor’s system. If you don’t specify a Base parameter and if your visitor
doesn’t already have the relevant ActiveX control installed, the browser can’t display the ActiveX object.
Alt Img Specifies an image to be displayed if the browser doesn’t support the object tag. This option is available only
when the Embed option is deselected.
Data Specifies a data file for the ActiveX control to load. Many ActiveX controls, such as Shockwave and RealPlayer,
do not use this parameter.
Insert a Java applet
You can insert a Java applet into an HTML document using Dreamweaver. Java is a programming language that
allows the development of lightweight applications (applets) that can be embedded in web pages.
After inserting a Java applet, use the Property inspector to set parameters. To view the following properties in the
Property inspector, select a Java applet.
1In the Document window, place the insertion point where you want to insert the applet, and then do one of the
following:
•In the Common category of the Insert bar, click the Media button and select the Applet icon .
•Select Insert > Media > Applet.
2Select a file containing a Java applet.
September 4, 2007
DREAMWEAVER CS3
User Guide
277
Java applet properties
The Property inspector initially displays the most commonly used properties. Click the expander arrow in the
lower-right corner to see all properties.
Name Specifies a name to identify the applet for scripting. Enter a name in the unlabeled text box on the far left side
of the Property inspector.
W and H Specify the width and height of the applet, in pixels.
Code Specifies the file containing the applet’s Java code. Click the folder icon to browse to a file, or enter a filename.
Base Identifies the folder containing the selected applet. When you select an applet, this text box is filled automati-
cally.
Align Determines how the object is aligned on the page.
Alt Specifies alternative content (usually an image) to be displayed if the user’s browser doesn’t support Java applets
or has Java disabled. If you enter text, Dreamweaver inserts the text as the value of the applet’s alt attribute. If you
select an image, Dreamweaver inserts an img tag between the opening and closing applet tags.
Note: To specify alternative content that is viewable in both Netscape Navigator (with Java disabled) and Lynx (a text-
based browser), select an image and then manually add an alt attribute to the img tag in the Code inspector.
V Space and H Space Specify the amount of white space in pixels above, below, and on both sides of the applet.
Parameters Opens a dialog box for entering additional parameters to pass to the applet. Many applets respond to
special parameters.
Using behaviors to control media
You can add behaviors to your page to start and stop various media objects.
Control Shockwave Or Flash Play, stop, rewind, or go to a frame in a Shockwave movie or Flash SWF file.
Play Sound Lets you play a sound; for example, you can play a sound effect whenever the user moves the mouse
pointer over a link.
Check Plugin Lets you check to see if visitors to your site have the required plug-in installed, then route them to
different URLs, depending on whether they have the right plug-in. This only applies to Netscape Navigator plug-ins,
as the Check Plugin behavior does not check for ActiveX controls.
See also
“Apply the Control Shockwave Or Flash behavior” on page 352
“Apply the Play Sound behavior” on page 356
“Apply the Check Plugin behavior” on page 352
Use parameters to control media objects
Define special parameters to control Shockwave and Flash SWF files, ActiveX controls, Netscape Navigator plug-ins,
and Java applets. Parameters are used with the object,embed,andapplet tags. Parameters set attributes specific to
different types of objects. For example, a Flash object can use a quality parameter
<paramname="quality"value="best"> for the object tag. The Parameter dialog box is available from the Property
inspector. See the documentation for the object you’re using for information on the parameters it requires.
September 4, 2007
DREAMWEAVER CS3
User Guide
278
Note: There is no widely accepted standard for identifying data files for ActiveX controls. Consult the documentation for
the ActiveX control you’re using to find out which parameters to use.
Enter a name and value for a parameter
1Select an object that can have parameters (such as a Shockwave movie, an ActiveX control, a Netscape Navigator
plug-in, or a Java applet) in the Document window.
2Open the dialog box using one of the following methods:
•Right-click (Windows) or Control-click (Macintosh) the object, and select Parameters from the context menu.
•Open the Property inspector if it isn’t already open, and click the Parameters button found in the lower half of the
Property inspector. (Make sure the Property inspector is expanded.)
3Click the Plus (+) button and enter the parameter name and value in the appropriate columns.
Remove a parameter
❖Select a parameter and press the minus (–) button.
Reorder parameters
❖Select a parameter, and use the up and down arrow buttons.
September 4, 2007
279
Chapter 9: Linking and navigation
After you’ve set up a site, you can link pages to each other. You can create HTML links, jump menus, navigation bars,
and image maps.
About linking and navigation
About links
After you’ve set up a Dreamweaver site to store your website documents and have created HTML pages, you’ll want
to create connections from your documents to other documents.
Dreamweaver provides several ways to create links to documents, images, multimedia files, or downloadable
software. You can establish links to any text or image anywhere within a document, including text or images in a
heading, list, table, absolutely positioned element (AP element), or frame.
Thesitemapgivesavisualrepresentationofhowyourfilesarelinked.Inthesitemapyoucanaddnewdocuments
to your site, create and remove document links, and check links to dependent files.
There are several different ways of creating and managing links. Some web designers prefer to create links to nonex-
istent pages or files as they work, while others prefer to create all the files and pages first and then add the links.
Another way to manage links is to create placeholder pages, in which you add and test links before completing all
your site pages.
See also
“Using site maps” on page 52
“Test links in Dreamweaver” on page 289
Document locations and paths
Understanding the file path between the document you’re linking from and the document you’re linking to is
essential to creating links.
Each web page has a unique address, called a Uniform Resource Locator (URL). However, when you create a local
link (a link from one document to another on the same site), you generally don’t specify the entire URL of the
document you’re linking to; instead, you specify a relative path from the current document or from the site’s root
folder.
There are three types of link paths:
•Absolute paths (such as http://www.adobe.com/support/dreamweaver/contents.html).
•Document-relative paths (such as dreamweaver/contents.html).
•Site root–relative paths (such as /support/dreamweaver/contents.html).
Using Dreamweaver, you can easily select the type of document path to create for your links.
Note: It is best to use the type of linking you prefer and are most comfortable with—either site or document relative.
Browsing to links, as opposed to typing in the paths, ensures that you always enter the right path.
September 4, 2007
DREAMWEAVER CS3
User Guide
280
Absolute paths
Absolute paths provide the complete URL of the linked document, including the protocol to use (usually http:// for
web pages), for example, http://www.adobe.com/support/dreamweaver/contents.html.
Youmustuseanabsolutepathtolinktoadocumentonanotherserver.Youcanalsouseabsolutepathsforlocallinks
(to documents in the same site), but that approach is discouraged—if you move the site to another domain, all of
your local absolute-path links will break. Using relative paths for local links also provides greater flexibility if you
need to move files within your site.
Note: When inserting images (not links), you can use an absolute path to an image on a remote server (that is, an image
that is not available on the local hard drive).
Document-relative paths
Document-relative paths are usually best for local links in most websites. They’re particularly useful when the current
document and the linked document are in the same folder and are likely to remain together. You can also use a
document-relative path to link to a document in another folder by specifying the path through the folder hierarchy
from the current document to the linked document.
The basic idea of document-relative paths is to omit the part of the absolute path that is the same for both the current
document and the linked document, providing only the portion of the path that differs.
For example, suppose you have a site with the following structure:
•To link from contents.html to hours.html (both in the same folder), use the relative path hours.html.
•To link to tips.html (in the resources subfolder), use the relative path resources/tips.html. At each slash (/..), you
move down one level in the folder hierarchy.
•To link to index.html (in the parent folder, one level above contents.html), use the relative path ../index.html. At
each slash (../), you move up one level in the folder hierarchy.
•To link to catalog.html (in a different subfolder of the parent folder), use the relative path ../products/catalog.html.
Here, ../ moves up to the parent folder, and products/ moves down to the products subfolder.
September 4, 2007
DREAMWEAVER CS3
User Guide
281
Whenyoumovefilesasagroup—forexample,whenyoumoveanentirefolder,sothatallthefilesinsidethatfolder
retain the same relative paths to each other—you don’t need to update document-relative links between those files.
However, when you move an individual file that contains document-relative links, or an individual file targeted by a
document-relative link, you do need to update those links. (If you move or rename files using the Files panel,
Dreamweaver updates all relevant links automatically.)
See also
“Set the relative path of new links” on page 284
“Set up and edit a local root folder” on page 42
Site root–relative paths
Site root–relative paths describe the path from the site’s root folder to a document. You may want to use these paths
if you are working on a large website that uses several servers, or one server that hosts several sites. However, if you
are not familiar with this type of path, you may want to stick to document-relative paths.
A site root–relative path begins with a leading forward slash, which stands for the root folder of the site. For example,
/support/tips.html is a site root–relative path to a file (tips.html) in the support subfolder of the site’s root folder.
A site root–relative path is often the best way to specify links if you frequently move HTML files from one folder to
another in your website. When you move a document that contains site root–relative links, you don’t need to change
the links; for example, if your HTML files use site root–relative links for dependent files (such as images), then if you
move an HTML file, its dependent-file links are still valid.
However, when you move or rename the documents targeted by site root–relative links, you must update those links,
even if the documents’ paths relative to each other haven’t changed. For example, if you move a folder, you must
update all site root–relative links to files in that folder. (If you move or rename files using the Files panel,
Dreamweaver updates all relevant links automatically.)
See also
“Set the relative path of new links” on page 284
Linking
Linking files and documents
Before creating a link, make sure you understand how absolute, document-relative, and site root–relative paths work.
You can create several types of links in a document:
•A link to another document or to a file, such as a graphic, movie, PDF, or sound file.
•A named anchor link, which jumps to a specific location in a document.
•An e-mail link, which creates a new blank e-mail message with the recipient’s address already filled in.
•Null and script links, which you use to attach behaviors to an object or to create a link that executes JavaScript
code.
You can use the Property inspector and the Point-To-File icon to create links from an image, an object, or text to
another document or file.
September 4, 2007
DREAMWEAVER CS3
User Guide
282
Dreamweaver creates the links to other pages in your site using document-relative paths. You can also tell
Dreamweaver to create new links using site root–relative paths.
Important: Always save a new file before creating a document-relative path; a document-relative path is not valid
without a definite starting point. If you create a document-relative path before saving the file, Dreamweaver temporarily
uses an absolute path beginning with file:// until the file is saved; when you save the file, Dreamweaver converts the file://
path to a relative path.
For a tutorial on creating links, see www.adobe.com/go/vid0149.
See also
“Document locations and paths” on page 279
Attaching JavaScript behaviors to links
You can attach a behavior to any link in a document. Consider using the following behaviors when you insert linked
elements into documents:
Set Text Of Status Bar Determines the text of a message and displays it in the status bar at the lower left of the
browser window. For example, you can use this behavior to describe the destination of a link in the status bar instead
of showing the URL associated with it.
Open Browser Window Opens a URL in a new window. You can specify the properties of the new window, including
its name, size, and attributes (whether it is resizable, has a menu bar, and so on).
Jump Menu Edits a jump menu. You can change the menu list, specify a different linked file, or change the browser
location in which the linked document opens.
Set Nav Bar Image Customizes the display of images in a navigation bar. For example, you can use this behavior to
display a certain image in the navigation bar or page when the pointer is over a certain portion of the navigation bar.
See also
“Applying built-in Dreamweaver behaviors” on page 350
Link to documents using the Property inspector
You can use the Property inspector’s folder icon or Link box to create links from an image, an object, or text to
another document or file.
1Select text or an image in the Document window’s Design view.
2Open the Property inspector (Window > Properties) and do one of the following:
•Click the folder icon to the right of the Link box to browse to and select a file.
The path to the linked document appears in the URL box. Use the Relative To pop-up menu in the Select HTML File
dialog box to make the path document-relative or root-relative, and then click Select. The type of path you select
applies only to the current link. (You can change the default setting of the Relative To box for the site.)
•Type the path and filename of the document in the Link box.
To link to a document in your site, enter a document-relative or site root–relative path. To link to a document outside
your site, enter an absolute path including the protocol (such as http://). You can use this approach to enter a link for
a file that hasn’t been created yet.
September 4, 2007
DREAMWEAVER CS3
User Guide
283
3From the Target pop-up menu, select a location in which to open the document:
•_blank loads the linked document in a new, unnamed browser window.
•_parent loads the linked document in the parent frame or parent window of the frame that contains the link. If
the frame containing the link is not nested, then the linked document loads in the full browser window.
•_self loads the linked document in the same frame or window as the link. This target is the default, so you
usually don’t have to specify it.
•_top loads the linked document in the full browser window, thereby removing all frames.
If all the links on your page will be set to the same target, you can specify this target once by selecting Insert >
HTML > Head Tags > Base and selecting the target information. For information about targeting frames, see
“Control frame content with links” on page 212.
See also
“Document locations and paths” on page 279
Link to documents using the Point-To-File icon
1Select text or an image in the Document window’s Design view.
2Create a link in one of two ways:
•Drag the Point-To-File icon (target icon) at the right of the Link box in the Property inspector and point to another
open document, a visible anchor in an open document, or a document in the Files panel.
•Shift-drag from the selection and point to another open document, a visible anchor in an open document, or a
document in the Files panel.
Note: You can link to an open document only if your documents are not maximized in the Document window. To tile
documents, select Window > Cascade or Window > Tile. When you point to an open document, that document moves
to the foreground of your screen while you are making your selection.
Link documents using the site map
Links you create in the site map appear at the bottom of the selected HTML files, allowing you to quickly create links
across a site.
Link documents using the site map and the Point-To-File icon
This method works well when you are building your site and you want to create links across the site quickly.
1In the Files panel, select Map View from the View pop-up menu.
2Select an HTML file in the site map.
3Drag the selected file’s Point-To-File icon (target icon) to another file in the site map or to a local file in the Site
Files view.
A link with the name of the linked file appears at the bottom of the selected HTML file.
Link documents in the site map
❖Do one of the following:
•Drag a page from the Windows Explorer or the Macintosh Finder onto a page in the site map.
•Select an HTML page in the site map, and then select Link To Existing File from the context menu.
September 4, 2007
DREAMWEAVER CS3
User Guide
284
•Select an HTML page in the site map, and then select Link To New File from the context menu.
Add a link using the Hyperlink command
The Hyperlink command lets you create a text link to an image, an object, or to another document or file.
1Place the insertion point in the document where you want the link to appear.
2Do one of the following to display the Insert Hyperlink dialog box:
•Select Insert > Hyperlink.
•In the Common category of the Insert bar, click the Hyperlink button.
3Enter the text of the link and, after Link, the name of the file to link to (or click the folder icon to browse to the file).
4In the Target pop-up menu, select the window in which the file should open or type its name.
The names of all the frames you’ve named in the current document appear in the pop-up list. If you specify a frame
that doesn’t exist, the linked page opens in a new window that has the name you specified. You can also select from
the following reserved target names:
•_blank loads the linked file into a new, unnamed browser window.
•_parent loads the linked file into the parent frameset or window of the frame that contains the link. If the frame
containing the link is not nested, the linked file loads into the full browser window.
•_self loads the linked file into the same frame or window as the link. This target is the default, so you usually
don’t need to specify it.
•_top loads the linked file into the full browser window, thereby removing all frames.
5In the Tab Index box, enter a number for the tab order.
6In the Title box, enter a title for the link.
7In the Access Key box, enter a keyboard equivalent (one letter) to select the link in the browser.
8Click OK.
Set the relative path of new links
By default, Dreamweaver creates links to other pages in your site using document-relative paths. To use site root–
relative path instead, you must first define a local folder in Dreamweaver by choosing a local root folder to serve as
the equivalent of the document root on a server. Dreamweaver uses this folder to determine the site root–relative
paths to files.
1Select Site > Manage Sites.
2In the Manage Sites dialog box, double-click your site in the list.
3In the Site Definition dialog box, click the Advanced tab, if the Advanced settings aren’t showing.
The Advanced tab of the Site Definition dialog box displays the Local Info category options.
4Set the relative path of new links by selecting the Document or Site Root option.
Changing this setting will not convert the path of existing links after you click OK. The setting applies only to new
links you create with Dreamweaver.
September 4, 2007
DREAMWEAVER CS3
User Guide
285
Note: Content linked with a site root–relative path does not appear when you preview documents in a local browser
unless you specify a testing server, or select the Preview Using Temporary File option in Edit > Preferences > Preview In
Browser. This is because browsers don’t recognize site roots—servers do. A quick way to preview content linked with site
root–relative paths is to put the file on a remote server, then select File > Preview In Browser.
5For site root–relative paths, enter your website URL in the HTTP Address box.
Dreamweaver uses this address to make sure root-relative links work on the remote server, which may have a
different site root. For example, if you are linking to an image file located in the C:\Sales\images\ folder on your hard
disk (where Sales is your local root folder), and the URL of your completed site is http://www.mysite.com/SalesApp/
(where SalesApp is your remote root folder), then entering the URL in the HTTP Address box will ensure that the
path to the linked file on the remote server is /SalesApp/images/.
Note: In previous releases, Dreamweaver failed to append the correct remote root folder, which caused pages to fail at
runtime.
6Click OK.
The new path setting applies only to the current site.
See also
“Document locations and paths” on page 279
“Set up and edit a local root folder” on page 42
Link to a specific place in a document
You can use the Property inspector to link to a particular section of a document by first creating named anchors.
Named anchors let you set markers in a document, which are often placed at a specific topic or at the top of a
document. You can then create links to these named anchors, which quickly take your visitor to the specified
position.
Creating a link to a named anchor is a two-step process. First, you create a named anchor; then you create a link to
the named anchor.
Note: You can’t place a named anchor in an absolutely positioned element (AP element).
Create a named anchor
1In the Document window’s Design view, place the insertion point where you want the named anchor.
2Do one of the following:
•Select Insert > Named Anchor.
•Press Control+Alt+A (Windows) or Command+Option+A (Macintosh).
•In the Common category of the Insert bar, click the Named Anchor button.
3In the Anchor Name box, type a name for the anchor, and click OK. (The anchor name can’t contain spaces).
The anchor marker appears at the insertion point.
Note: If you do not see the anchor marker, select View > Visual Aids > Invisible Elements.
Link to a named anchor
1In the Document window’s Design view, select text or an image to create a link from.
September 4, 2007
DREAMWEAVER CS3
User Guide
286
2In the Link box of the Property inspector, type a number sign (#) and the name of the anchor. For example, to link
to an anchor named “top” in the current document, type #top. To link to an anchor named “top” in a different
document in the same folder, type filename.html#top.
Note: Anchor names are case-sensitive.
Link to a named anchor using the point-to-file method
1Open the document containing the named anchor.
Note: If you don’t see the anchor, select View > Visual Aids > Invisible Elements to make it visible.
2In the Document window’s Design view, select text or an image you want to link from. (If this is another open
document, you must switch to it.)
3Do one of the following:
•Click the Point-To-File icon (target icon) to the right of the Link box in the Property inspector and drag it to the
anchor you want to link to: either an anchor within the same document or an anchor in another open document.
•Shift-drag in the Document window from the selected text or image to the anchor you want to link to: either an
anchor within the same document or an anchor in another open document.
Create an e-mail link
An e-mail link opens a new blank message window (using the mail program associated with the user’s browser) when
clicked. In the e-mail message window, the To box is automatically updated with the address specified in the e-mail link.
Create an e-mail link using the Insert Email Link command
1In the Document window’s Design view, position the insertion point where you want the e-mail link to appear, or
select the text or image you want to appear as the e-mail link.
2Do one of the following to insert the link:
•Select Insert > Email Link.
•In the Common category of the Insert bar, click the Email Link button.
3In the Text box, type or edit the body of the e-mail.
4In the Email box, type the e-mail address, then click OK.
Create an e-mail link using the Property inspector
1Select text or an image in the Document window’s Design view.
2In the Link box of the Property inspector, type mailto: followed by an e-mail address.
Do not type any spaces between the colon and the e-mail address.
Auto-populate the subject line of an e-mail
1Create an e-mail link using the Property inspector as outlined above.
2IntheLinkboxofthePropertyinspector,add?subject= after the email, and type a subject after the equals sign.
Do not type any spaces between the question mark and the end of the e-mail address.
The complete entry would look as follows:
mailto:someone@yoursite.com?subject=Mail from Our Site
September 4, 2007
DREAMWEAVER CS3
User Guide
287
Create null and script links
Anull link is an undesignated link. Use null links to attach behaviors to objects or text on a page. For instance, you
can attach a behavior to a null link so that it swaps an image or displays an absolutely-positioned element (AP
element) when the pointer moves over the link.
Script links execute JavaScript code or call a JavaScript function and are useful for giving visitors additional infor-
mation about an item without leaving the current web page. Script links can also be used to perform calculations,
validate forms, or do other processing tasks when a visitor clicks a specific item.
See also
“Apply a behavior” on page 349
Create a null link
1Select text, an image, or an object in the Document window’s Design view.
2In the Property inspector, type javascript:; (the word javascript,followedbyacolon,followedbyasemicolon)
in the Link box.
Create a script link
1Select text, an image, or an object in the Document window’s Design view.
2In the Link box of the Property inspector, type javascript: followed by some JavaScript code or a function call.
(Do not type a space between the colon and the code or call.)
Update links automatically
Dreamweaver can update links to and from a document whenever you move or rename the document within a local
site. This feature works best when you store your entire site (or an entire self-contained section of it) on your local
disk. Dreamweaver does not change files in the remote folder until you put the local files on or check them in to the
remote server.
Tomaketheupdatingprocessfaster,Dreamweavercancreateacachefileinwhichtostoreinformationaboutallthe
links in your local folder. The cache file is updated invisibly as you add, change, or delete links on your local site.
Enable automatic link updates
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2In the Preferences dialog box, select General from the category list on the left.
3In the Document Options section of the General preferences, select an option from the Update Links When
Moving Files pop-up menu.
Always Automatically updates all links to and from a selected document whenever you move or rename it.
Never Does not automatically update all links to and from a selected document when you move or rename it.
Prompt Displays a dialog box that lists all the files affected by the change. Click Update to update the links in these
files, or click Don’t Update to leave the files unchanged.
4Click OK.
Create a cache file for your site
1Select Site > Manage Sites.
September 4, 2007
DREAMWEAVER CS3
User Guide
288
2Select a site, and then click Edit.
3Click the Advanced tab to display the Advanced category of the Site Definition dialog box.
4Select Local Info from the category list on the left.
5In the Local Info category, select Enable Cache.
The first time you change or delete links to files in your local folder after starting Dreamweaver, Dreamweaver
promptsyoutoloadthecache.IfyouclickYes,Dreamweaverloadsthecacheandupdatesallthelinkstothefileyou
just changed. If you click No, the change is noted in the cache,butDreamweaverdoesnotloadthecacheorupdate
links.
ItmaytakeafewminutestoloadthecacheonlargersitesbecauseDreamweavermustdeterminewhetherthecache
is up to date by comparing the timestamps of the files on the local site against the timestamps recorded in the cache.
If you have not changed any files outside Dreamweaver, you can safely click the Stop button when it appears.
Re-create the cache
❖In the Files panel, select Site > Advanced > Recreate Site Cache.
Manage links in the site map
You can modify the structure of the site in the site map by adding, changing, and removing links. Dreamweaver
automatically updates the site map to display the changes to the site.
See also
“Working with a visual map of your site” on page 52
Change a link
1In the site map, select a page containing the target link you want to change (so that the document that currently
links to this page will point to another page), and then right-click (Windows) or Control-click (Macintosh), and
select Change Link from the context menu.
2Browse to the new target file or type its URL.
3Click OK.
Remove a link
1Select the page in the site map.
2Right-click (Windows) or Control-click (Macintosh), and select Remove Link from the context menu.
Removing a link does not delete the file; it removes the link from the HTML source on the page pointing to the now
unlinked file.
Open the source of a link
1Select a file in the site map.
2Do one of the following:
•Select Site > Open To Source Of Link (Windows) or Site > Site Map View > Open To Source Of Link (Macintosh).
•Right-click (Windows) or Control-click (Macintosh), and select Open To Source Of Link from the context menu.
The Property inspector and the source file containing the link open in the Document window, with the link
highlighted.
September 4, 2007
DREAMWEAVER CS3
User Guide
289
Change a link sitewide
In addition to having Dreamweaver update links automatically whenever you move or rename a file, you can
manually change all links (including e-mail, FTP, null, and script links) so that they point somewhere else.
This option is most useful when you want to delete a file that other files link to, but you can use it for other purposes.
For example, suppose you link the words “this month’s movies” to /movies/july.html throughout your site. On August
1 you would change those links so that they point to /movies/august.html.
1Select a file in the Local view of the Files panel.
Note: If you are changing an e-mail, FTP, null, or script link, you do not need to select a file.
2Select Site > Change Link Sitewide.
3Complete these options in Change Link Sitewide dialog box:
Change All Links To Click the folder icon to browse to and select the target file from which to unlink. If you are
changing an e-mail, FTP, null, or script link, type the full text of the link you are changing.
Into Links Click the folder icon to browse to and select the new file to link to. If you are changing an e-mail, FTP,
null, or script link, type the full text of the replacement link.
4Click OK.
Dreamweaver updates any documents that link to the selected file, making them point to the new file, using the path
format already used in the document (for example, if the old path was document-relative, the new path is also
document-relative).
After you change a link sitewide, the selected file becomes an orphan (that is, no files on your local disk point to it).
You can safely delete it without breaking any links in your local Dreamweaver site.
Important: Becausethesechangesoccurlocally,youmustmanuallydeletethecorrespondingorphanfileintheremote
folder and put or check in any files in which links were changed; otherwise, visitors to your site won’t see the changes.
Test links in Dreamweaver
Links are not active within Dreamweaver; that is, you cannot open a linked document by clicking the link in the
Document window.
❖Do one of the following:
•Select the link and select Modify > Open Linked Page.
•Press Control (Windows) or Command (Macintosh) and double-click the link.
Note: The linked document must reside on your local disk.
See also
“Find broken, external, and orphaned links” on page 295
“Fix broken links” on page 296
September 4, 2007
DREAMWEAVER CS3
User Guide
290
Jump menus
About jump menus
Ajump menu is a pop-up menu in a document, visible to your site visitors, listing links to documents or files. You
can create links to documents in your website, links to documents on other websites, e-mail links, links to graphics,
or links to any file type that can be opened in a browser.
Each option in a jump menu is associated with a URL. When users choose an option, they are redirected (“jump”)
to the associated URL. Jump menus are inserted within the Jump Menu form object.
A jump menu can contain three components:
•(Optional) A menu selection prompt, such as a category description for the menu items, or instructions, such as
“Choose one”.
•(Required) A list of linked menu items: a user selects an option and a linked document or file opens.
•(Optional) A Go button.
See also
“Apply the Jump Menu behavior” on page 355
“Apply the Jump Menu Go behavior” on page 356
Insert a jump menu
1Open a document, and then place the insertion point in the Document window.
2Do one of the following:
•Select Insert > Form > Jump Menu.
•In the Forms category of the Insert bar, click the Jump Menu button.
3Complete the Insert Jump menu dialog box and click OK. Here is a partial list of options:
Plus and Minus buttons ClickPlustoinsertanitem;clickPlusagaintoaddanotherone.Todeleteanitem,selectit
and click Minus.
Arrow buttons Select an item and click the arrows to move it up or down in the list.
Text Typethenameofanunnameditem.Ifyourmenuincludesaselectionprompt(suchas“Chooseone”),typeit
here as the first menu item (if so, you must also choose the Select First Item After URL Change option at the bottom).
When Selected Go To URL Browse to the target file or type its path.
Open URLs In Specify whether to open the file in the same window or in a frame. If the frame you want to target
doesn’t appear in the menu, close the Insert Jump Menu dialog box and name the frame.
Go Button After Menu Select to insert a Go button rather than a menu selection prompt.
Select First Item After URL Change
Select if you inserted a menu selection prompt (“Choose one”) as the first menu item.
See also
“View and set frame properties and attributes” on page 209
September 4, 2007
DREAMWEAVER CS3
User Guide
291
Edit jump menu items
Youcanchangetheorderofitemsinthemenuorthefileanitemlinksto,andyoucanadd,delete,orrenameanitem.
To change the location in which a linked file opens, or to add or change a menu selection prompt, you must apply
the Jump Menu behavior from the Behaviors panel.
1Open the Property inspector (Window > Properties) if it isn’t already open.
2In the Document window’s Design view, click the jump menu object to select it.
3In the Property inspector, click the List Values button.
4Use the List Values dialog box to make your changes to the menu items, and then click OK.
See also
“Apply the Jump Menu behavior” on page 355
Troubleshooting jump menus
After a user selects a jump menu item, there is no way to reselect that menu item if the user navigates back to that
page, or if the Open URL In box specifies a frame. There are two ways to work around this problem:
•Use a menu selection prompt, such as a category, or a user instruction, such as “Choose one”. The menu selection
prompt is reselected automatically after each menu selection.
•UseaGobutton,whichallowsausertorevisitthecurrentlychosenlink.WhenyouuseaGobuttonwithajump
menu, the Go button becomes the only mechanism that “jumps” the user to the URL associated with the selection
in the menu. Selecting a menu item in the jump menu no longer re-directs the user automatically to another page
or frame.
Note: Select only one of these options per jump menu, in the Insert Jump Menu dialog box, because they apply to an
entire jump menu.
Navigation bars
About navigation bars
Anavigation bar consists of an image (or set of images) whose display changes in response to user actions. Navigation
bars often provide an easy way to move between pages and files on a site.
A navigation bar element can have four states:
•Up: the image that appears when the user hasn’t yet clicked or interacted with the element.
September 4, 2007
DREAMWEAVER CS3
User Guide
292
•Over: the image that appears when the user moves the pointer over the Up image. The element’s appearance
changes (for example, it may get lighter) to let users know they can interact with it.
•Down: the image that appears after the user clicks the element. For example, when a user clicks an element, a new
page loads and the navigation bar is still displayed, but the clicked element may be darkened to show that it’s been
selected.
•Over While Down: the image that appears when the user moves the pointer over the Down image after clicking
theelement.Forexample,theelementmaybedimmed.Thisstategivesusersavisualcluethattheycan’tclickthis
element again while they are in this part of the site.
You don’t have to include navigation bar images for all four of these states; for example, you may just want Up and
Down states.
After you create a navigation bar for a document, you can add or remove images from the navigation bar using the
Modify Navigation Bar command. Use this command to change an image or set of images, to change which file opens
when an element is clicked, to select a different window or frame in which to open a file, and to reorder the images.
Insert a navigation bar
Before using the Insert Navigation Bar command, you must create a set of images for the display states of each
navigation element. (It can be helpful to think of a navigation bar element as a button, because when clicked, it takes
the user to another page.)
Youcancreateanavigationbar,copyittootherpagesinyoursite,useitwithframes,andeditthepagebehaviorsto
show different states as pages are accessed.
1Do one of the following:
•Select Insert > Image Objects > Navigation Bar.
•In the Common category of the Insert bar, click the Images button and select Insert Navigation Bar.
2Complete the Insert Navigation Bar dialog box and click OK. Here is a partial list of options:
Plus and Minus buttons Click Plus to insert an element; click Plus again to add another one. To delete an element,
select it and click Minus.
Element Name Type a name for a navigation bar element—for example, Home.Eachelementcorrespondstoabutton
with a set of up to four image states. Element names appear in the Nav Bar Elements list. Use the arrow buttons to
arrange elements in the navigation bar.
Up, Over, Down, and Over While Down Browse to select images for these four states. Only the Up image is required;
other image states are optional.
Alternate Text Enter a descriptive name for the element. Alternate text appears in place of images in text-only
browsers or in browsers that download images manually. Screen readers read alternate text, and some browsers
display alternate text when the user moves the pointer over the navigation bar element.
When Clicked, Go To URL Click the Browse button to select a linked file to open, and then specify whether to open
the file in the same window or in a frame. If the frame you want to target doesn’t appear in the menu, close the Insert
Navigation Bar dialog box and name the frame in your document.
Preload Images Select this option to download images as the page is downloaded. This option prevents delays when
the user moves the pointer over rollover images.
Show Down Image Initially Select this option for elements that you want to display initially in the Down state rather
than the default Up state. For example, the Home element on the navigation bar should be in its Down state when
September 4, 2007
DREAMWEAVER CS3
User Guide
293
thepageisfirstdownloaded.Whenyouapplythisoptiontoanelement,anasteriskappearsafteritsnameintheNav
Bar Elements list.
Insert Specify whether to insert elements vertically or horizontally.
Use Tables Select to insert elements as a table.
See also
“View and set frame properties and attributes” on page 209
Modify a navigation bar
1Select the navigation bar in the active page.
2Select Modify > Navigation Bar.
3In the Nav Bar Elements list, select the element you want to edit.
4Make changes as necessary and click OK.
Image maps
About image maps
An image map is an image that has been divided into regions called hotspots; when a user clicks a hotspot, an action
occurs (for example, a new file opens).
Client-side image maps store the hypertext link information in the HTML document—not in a separate map file as
server-side image maps do. When a site visitor clicks a hotspot in the image, the associated URL is sent directly to
theserver.Thismakesclient-sideimagemapsfasterthanserver-sideimagemaps,becausetheserverdoesnotneed
to interpret where the visitor clicked. Client-side image maps are supported by Netscape Navigator 2.0 and later
versions, NCSA Mosaic 2.1 and 3.0, and all versions of Internet Explorer.
Dreamweaver does not alter references to server-side image maps in existing documents; you can use both client-
side image maps and server-side image maps in the same document. However, browsers that support both types of
image maps give priority to client-side image maps. To include a server-side image map in a document, you must
write the appropriate HTML code.
Insert client-side image maps
When you insert a client-side image map, you create a hotspot area and then define a link that opens when a user
clicks the hotspot area.
Note: You can create multiple hotspot areas, but they are part of the same image map.
1In the Document window, select the image.
2In the Property inspector, click the expander arrow in the lower-right corner to see all properties.
3In the Map Name box, enter a unique name for the image map. If you are using multiple image maps in the same
document, make sure each map has a unique name.
4To define the image map areas, do one of the following:
•Select the circle tool and drag the pointer over the image to create a circular hotspot.
September 4, 2007
DREAMWEAVER CS3
User Guide
294
•Select the rectangle tool and drag the pointer over the image to create a rectangular hotspot.
•Select the polygon tool and define an irregularly shaped hotspot by clicking once for each corner point. Click the
arrow tool to close the shape.
After you create the hotspot, the hotspot Property inspector appears.
5InthehotspotPropertyinspector’sLinkbox,clickthefoldericontobrowsetoandselectthefileyouwanttoopen
when the user clicks the hotspot, or type the path.
6In the Target pop-up menu, select the window in which the file should open or type its name.
The names of all the frames you’ve named in the current document appear in the pop-up list. If you specify a frame
that doesn’t exist, the linked page loads into a new window that has the name you specified. You can also select from
the following reserved target names:
•_blank loads the linked file into a new, unnamed browser window.
•_parent loads the linked file into the parent frameset or window of the frame that contains the link. If the frame
containing the link is not nested, the linked file loads into the full browser window.
•_self loads the linked file into the same frame or window as the link. This target is the default, so you usually
don’t need to specify it.
•_top loads the linked file into the full browser window, thereby removing all frames.
Note: The target option isn’t available until the selected hotspot contains a link.
7In the Alt box, type alternative text for display in text-only browsers or browsers that download images manually.
Some browsers display this text as a tooltip when the user moves the pointer over the hotspot.
8Repeat steps 4 through 7 to define additional hotspots in the image map.
9When you finish mapping the image, click a blank area in the document to change the Property inspector.
Modify image map hotspots
You can easily edit the hotspots you create in an image map. You can move a hotspot area, resize hotspots, or move
a hotspot forward or back in an absolutely-positioned element (AP element).
You can also copy an image with hotspots from one document to another, or copy one or more hotspots from an
image and paste them on another image; hotspots associated with the image are also copied to the new document.
Select multiple hotspots in an image map
1Use the pointer hotspot tool to select a hotspot.
2Do one of the following:
•Shift-click the other hotspots you want to select.
•Press Control+A (Windows) or Command+A (Macintosh) to select all of the hotspots.
Move a hotspot
1Use the pointer hotspot tool to select the hotspot.
2Do one of the following:
•Drag the hotspot to a new area.
•Use the Shift + arrow keys to move a hotspot by 10 pixels in the selected direction.
•Use the arrow keys to move a hotspot by 1 pixel in the selected direction.
September 4, 2007
DREAMWEAVER CS3
User Guide
295
Resize a hotspot
1Use the pointer hotspot tool to select the hotspot.
2Drag a hotspot selector handle to change the size or shape of the hotspot.
Troubleshooting links
Find broken, external, and orphaned links
Use the Check Links feature to search for broken links and orphaned files(filesthatstillexistinthesitebutthataren’t
linked to by any other files in the site). You can search an open file, a portion of a local site, or an entire local site.
Dreamweaver verifies links only to documents within the site; Dreamweaver compiles a list of external links in the
selected document or documents but does not verify them.
You can also identify and delete files that are no longer used by other files in your site.
See also
“Identify and delete unused files” on page 83
Check links in the current document
1Save the file to a location within your local Dreamweaver site.
2Select File > Check Page > Links.
The Broken Links report appears in the Link Checker panel (in the Results panel group).
3In the Link Checker panel, select External Links from the Show pop-up menu to view another report.
The External Links report appears in the Link Checker panel (in the Results panel group).
You can check for orphaned files when you check links across an entire site.
4To save the report, click the Save Report button in the Link Checker panel. The report is a temporary file; it will
be lost if you don’t save it.
Check links in part of a local site
1In the Files panel, select a site from the Current Sites pop-up menu.
2In Local view, select the files or folders to check.
3Initiate the check by doing one of the following:
•Right-click (Windows) or Control-click (Macintosh) one of the selected files, and then select Check Links >
Selected Files/Folders from the context menu.
•Select File > Check Page > Links.
The Broken Links report appears in the Link Checker panel (in the Results panel group).
4In the Link Checker panel, select External Links from the Show pop-up menu to view another report.
The External Links report appears in the Link Checker panel (in the Results panel group).
September 4, 2007
DREAMWEAVER CS3
User Guide
296
You can check for orphaned files when you check links across an entire site.
5To save a report, click the Save Report button in the Link Checker panel.
Check links across the entire site
1In the Files panel, select a site from the Current Sites pop-up menu.
2Select Site > Check Links Sitewide.
The Broken Links report appears in the Link Checker panel (in the Results panel group).
3IntheLinkCheckerpanel,selectExternalLinksorOrphanedFilesfromtheShowpop-upmenutoviewanother
report.
A list of files that fit the report type you selected appears in the Link Checker panel.
Note: If you select Orphaned Files as your report type, you can delete orphaned files from the Link Checker panel directly
by selecting a file from the list and pressing the Delete key.
4To save a report, click the Save Report button in the Link Checker panel.
Fix broken links
After you run a links reports, you can fix broken links and image references directly in the Link Checker panel, or
you can open files from the list and fix links in the Property inspector.
Fix links in the Link Checker panel
1Run a link check report.
2In the Broken Links column (not the Files column) of the Link Checker panel (in the Results panel group), select
the broken link.
A folder icon appears next to the broken link.
3Click the folder icon next to the broken link and browse to the correct file, or type the correct path and filename.
4Press Tab or Enter (Windows) or Return (Macintosh).
If there are other broken references to this same file, you are prompted to fix the references in the other files as well.
Click Yes to have Dreamweaver update all the documents on the list that reference this file. Click No to have
Dreamweaver update the current reference only.
Note: If Enable File Check In And Check Out is enabled for the site, Dreamweaver attempts to check out files that require
changes. If it cannot check out a file, Dreamweaver displays a warning dialog box and leaves broken references
unchanged.
Fix links in the Property inspector
1Run a link check report.
2In the Link Checker panel (in the Results panel group), double-click an entry in the File column.
Dreamweaver opens the document, selects the broken image or link, and highlights the path and filename in the
Property inspector. (If the Property inspector is not visible, select Window > Properties to open it.)
3TosetanewpathandfilenameinthePropertyinspector,clickthefoldericontobrowsetothecorrectfile,ortype
over the highlighted text.
September 4, 2007
DREAMWEAVER CS3
User Guide
297
If you are updating an image reference and the new image appears at the incorrect size, click the W and H labels in
the Property inspector or click the Refresh button to reset the height and width values.
4Save the file.
As links are fixed, their entries disappear from the Link Checker list. If an entry still appears in the list after you enter
a new path or filename in the Link Checker (or after you save changes in the Property inspector), Dreamweaver
cannot find the new file and still considers the link broken.
September 4, 2007
298
Chapter 10: Previewing pages
Design view gives you an idea of how your page will look on the web but does not render pages exactly as browsers
do. The Preview in Browser feature lets you see how your pages will look in specific browsers as you create your
design.
Previewing pages in browsers
Preview in a browser
You can preview a page in a browser at any time; you don’t have to upload it to a web server first. When you preview
a page, all browser-related functions should work, including JavaScript behaviors, document-relative and absolute
links, ActiveX® controls, and Netscape Navigator plug-ins, provided that you installed the required plug-ins or
ActiveX controls in your browsers.
Before previewing a document, save the document; otherwise, the browser does not display your most recent
changes.
1Do one of the following to preview the page:
•Select File > Preview In Browser, and then select one of the listed browsers.
Note: If no browsers are listed, select Edit > Preferences or Dreamweaver > Preferences (Macintosh), and then select the
Preview In Browser category on the left to select a browser.
•Press F12 (Windows) or Option+F12 (Macintosh) to display the current document in the primary browser.
•Press Control+F12 (Windows) or Command+F12 (Macintosh) to display the current document in the secondary
browser.
2Click links and test content in your page.
If you use Internet Explorer on a Windows XP computer with Service Pack 2 installed, the browser may display a
message that tells you it has restricted the file from showing active content. You can fix this problem by including
Mark of the Web code in the file.
Note: Content linked with a site root-relative path does not appear when you preview documents in a local browser
unless you specify a testing server, or select the Preview Using Temporary File option in Edit > Preferences > Preview In
Browser. This is because browsers don’t recognize site roots—servers do.
To preview content linked with root-relative paths, put the file on a remote server, and then select File > Preview In
Browser to view it.
3Close the page in the browser when you finish testing.
See also
“Site root–relative paths” on page 281
September 4, 2007
DREAMWEAVER CS3
User Guide
299
Preview active content in Internet Explorer (Windows)
If you preview a document that contains active content in Internet Explorer after installing the Windows XP Service
Pack2update,thebrowserdoesnotshowactivecontent.YoucanfixthisproblembyinsertingMarkoftheWebcode
in your document.
Internet Explorer blocks active content and scripting that tries to run in the Local Machine zone. For security
reasons,Microsoftincreasedtherestrictionsonwhatcanruninthiszonebydefault.MarkoftheWebcodetellsthe
browser to run active content in another zone, in this case, the Internet zone. For more information, see TechNote
19578 on the Adobe website at www.adobe.com/go/19578.
Insert Mark of the Web code
❖With your document open in Dreamweaver, select Commands > Insert Mark Of The Web.
Dreamweaver inserts the following line in your code:
<!-- saved from url=(0014)about:internet -->
The line tells the browser to bypass the Local Machine zone and run the active content in the Internet zone.
Remove Mark of the Web code
1In Dreamweaver, open the document containing the Mark of the Web code.
2Select Commands > Remove Mark Of The Web.
Designate browsers for previewing
You can define up to 20 browsers for previewing, and you can designate primary and secondary browsers. It’s a good
idea to preview your site in the following browsers: Internet Explorer 6.0, Netscape Navigator 7.0, and the
Macintosh-only Safari browser. In addition to these more popular, graphical browsers, you may want to test your
pages in a text-only browser such as Lynx.
1Do one of the following to open the Preview In Browser options:
•Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh), and then select Preview In
Browser from the category list on the left.
•Select File > Preview In Browser > Edit Browser List.
2To add a browser to the list, click the Plus (+) button, complete the Add Browser dialog box, and then click OK.
3To delete a browser from the list, select the browser, and then click the Minus (-) button.
4To change settings for a selected browser, click the Edit button, make changes in the Edit Browser dialog box, and
then click OK.
5Select Primary Browser or Secondary Browser to specify whether the selected browser is the primary or secondary
browser.
F12 (Windows) or Option+F12 (Macintosh) opens the primary browser; Control+F12 (Windows) or
Command+F12 (Macintosh) opens the secondary browser.
6Select Preview Using Temporary File to create a temporary copy for previewing and server debugging. Deselect
this option to update the document directly.
September 4, 2007
DREAMWEAVER CS3
User Guide
300
Previewing pages in mobile devices
Preview mobile content with Adobe Device Central and Dreamweaver
To preview pages created in Dreamweaver on various mobile devices, use Device Central with its built-in Opera
Small-Screen Rendering feature. Different devices have different browsers installed, but the preview can give a good
impression of how content will look and behave on a selected device.
1Start Dreamweaver.
2Open a file.
3Do one of the following:
•Select File > Preview in Browser > Device Central.
•On the document window toolbar, click and hold the Preview/Debug In browser button and select Preview In
Device Central.
The file is displayed in the Device Central Emulator tab. To continue testing, double-click the name of a different
device in the Device Sets or Available Devices lists.
September 4, 2007
301
Chapter 11: Working with page code
Adobe® Dreamweaver® CS3 is a visual design tool as well as a robust code editor, which provides code hinting, code
collapsing, code debugging, and other code editing features.
About coding in Dreamweaver
Supported languages
In addition to text-editing capabilities, Adobe® Dreamweaver® CS3 provides various features, such as code hints, to
help you code in the following languages:
•HTML
•XHTML
•CSS
•JavaScript
•ColdFusion Markup Language (CFML)
•Visual Basic (for ASP and ASP.NET)
•C# (for ASP.NET)
•JSP
•PHP
Other languages, such as Perl, are not supported by the language-specific coding features in Dreamweaver; for
example, you can create and edit Perl files, but code hints don’t apply to that language.
See also
“Automatic code modification in Dreamweaver” on page 302
“Use code hints” on page 313
About fixing invalid markup
If your document contains invalid code, Dreamweaver displays that code in Design view and optionally highlights
it in Code view. If you select the code in either view, the Property inspector displays information about why it’s
invalid and how to fix it.
You can specify preferences for automatically rewriting various kinds of invalid code when you open a document.
See also
“Automatic code modification in Dreamweaver” on page 302
“Set the code rewriting preferences” on page 311
September 4, 2007
DREAMWEAVER CS3
User Guide
302
Automatic code modification in Dreamweaver
You can set options that instruct Dreamweaver to automatically clean up your hand-written code according to
criteria that you specify. However, your code is never rewritten unless the code rewriting options are enabled or you
performanactionthatchangesthecode.Forexample,Dreamweaverdoesnotalteryourwhitespaceorchangethe
case of attributes unless you use the Apply Source Formatting command.
A few of these code rewriting options are enabled by default.
The Roundtrip HTML capabilities in Dreamweaver let you move your documents back and forth between a text-
basedHTMLeditorandDreamweaverwithlittleornoeffectonthecontentandstructureofthedocument’soriginal
HTML source code. These capabilities include the following:
•Use a third-party text editor to edit the current document.
•By default, Dreamweaver does not make changes in code created or edited in other HTML editors, even if the code
is invalid, unless you enable code-rewriting options.
•Dreamweaver does not change tags it doesn’t recognize—including XML tags—because it has no criteria by which
to judge them. If an unrecognized tag overlaps another tag (for example,
<MyNewTag><em>text</MyNewTag></em>), Dreamweaver marks it as an error but doesn’t rewrite the code.
•Optionally, you can set Dreamweaver to highlight invalid code in Code view (in yellow). When you select a
highlighted section, the Property inspector displays information on how to correct the error.
See also
“Customizing the coding environment” on page 308
“Set the code rewriting preferences” on page 311
“Customizing keyboard shortcuts” on page 308
“About server behavior code” on page 306
About the XHTML code generated by Dreamweaver
Dreamweaver generates new XHTML code and cleans up existing XHTML code in a way that meets most of the
XHTML requirements. The tools that you need to meet the few XHTML requirements that remain are also provided.
Note: Some of the requirements also are required in various versions of HTML.
The following table describes the XHTML requirements that Dreamweaver meets automatically:
September 4, 2007
DREAMWEAVER CS3
User Guide
303
XHTML requirement Actions Dreamweaver performs
There must be a DOCTYPE declaration in the
document prior to the root element, and the
declaration must reference one of the three
Document Type Definition (DTD) files for XHTML
(strict, transitional, or frameset).
Adds an XHTML DOCTYPE to an XHTML document:
<!DOCTYPE html PUBLIC "-//W3C//DTD
XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xht
ml1-transitional.dtd">
Or, if the XHTML document has a frameset:
<!DOCTYPE html PUBLIC "-//W3C//DTD
XHTML 1.0 Frameset//EN"
"http://www.w3.org/TR/xhtml1/DTD/xht
ml1-frameset.dtd">
The root element of the document must be
html, and the html element must designate
the XHTML namespace.
Adds the namespace attribute to the html element,
as follows:
<html
xmlns="http://www.w3.org/1999/xhtml"
>
A standard document must have the head,
title, and body structural elements. A
frameset document must have the head,
title, and frameset structural elements.
In a standard document, includes the head,title,
and body elements. In a frameset document, includes
the head,title, and frameset elements.
All elements in the document must nest prop-
erly:
<p>This is a <i>bad
example.</p></i> <p>This is a
<i>good example.</i></p>
Generates correctly nested code and, when cleaning up
XHTML, corrects nesting in code that was not generated
by Dreamweaver.
All element and attribute names must be lower-
case.
Forces HTML element and attribute names to be lower-
case in the XHTML code that it generates and when
cleaning up XHTML, regardless of your tag and attribute
case preferences.
Every element must have a closing tag, unless it
is declared in the DTD as EMPTY.
Inserts closing tags in the code that it generates, and
when cleaning up XHTML.
Empty elements must have a closing tag, or the
opening tag must end with />. For example,
<br> is not valid; the correct form is
<br></br> or <br/>. Following are the
empty elements: area,base,basefont,
br,col,frame,hr,img,input,isindex,
link,meta, and param.
And for backwards-compatibility with browsers
that are not XML-enabled, there must be a space
before the /> (for example, <br />, not
<br/>).
Inserts empty elements with a space before the closing
slash in empty tags in the code that it generates, and
when cleaning up XHTML.
Attributes can’t be minimized; for example,
<td nowrap> is not valid; the correct form is
<td nowrap="nowrap">.
This affects the following attributes: checked,
compact,declare,defer,disabled,
ismap,multiple,noresize,noshade,
nowrap,readonly, and selected.
Inserts full attribute-value pairs in the code that it gener-
ates, and when cleaning up XHTML.
Note: If an HTML browser does not support HTML 4, it
might fail to interpret these Boolean attributes when
they appear in their full form.
All attribute values must be surrounded by
quotation marks.
Places quotation marks around attribute values in the
code that it generates, and when cleaning up XHTML.
September 4, 2007
DREAMWEAVER CS3
User Guide
304
See also
“Make pages XHTML-compliant” on page 328
About regular expressions
Regular expressions are patterns that describe character combinations in text. Use them in your code searches to help
describe concepts such as lines that begin with ‘var’” and “attribute values that contain a number.”
The following table lists the special characters in regular expressions, their meanings, and usage examples. To search
for text containing one of the special characters in the table, escape the special character by preceding it with a
backslash. For example, to search for the actual asterisk in the phrase some conditions apply*, your search
pattern might look like this: apply\*.Ifyoudon’tescapetheasterisk,you’llfindalltheoccurrencesof“apply”(aswell
as any of “appl”, “applyy”, and “applyyy”), not just the ones followed by an asterisk.
The following elements must have an id
attribute as well as a name attribute: a,
applet,form,frame,iframe,img, and
map. For example,
<a name="intro">Introduction</
a> is not valid; the correct form is
<a id="intro">Introduction</a>
or <a id="section1"
name="intro"> Introduction</a>.
Sets the name and id attributes to the same value,
whenever the name attribute is set by a Property
inspector, in the code that Dreamweaver generates, and
when cleaning up XHTML.
For attributes with values of an enumerated
type, the values must be lowercase.
An enumerated type value is a value from a
specified list of allowed values; for example, the
align attribute has the following allowed
values: center,justify,left, and
right.
Forces enumerated type values to be lowercase in the
code that it generates, and when cleaning up XHTML.
All script and style elements must have a type
attribute.
(The type attribute of the script element
has been required since HTML 4, when the
language attribute was deprecated.)
Sets the type and language attributes in script
elements, and the type attribute in style elements,
in the code that it generates and when cleaning up
XHTML.
All img and area elements must have an alt
attribute.
Sets these attributes in the code that it generates and,
when cleaning up XHTML, reports missing alt
attributes.
Character Matches Example
^ Beginning of input or line. ^T matches “T” in “This good earth” but not in “Uncle Tom’s
Cabin”
$ End of input or line. h$ matches “h” in “teach” but not in “teacher”
* The preceding character 0
or more times.
um* matches “um” in “rum”, “umm” in “yummy”, and “u” in
“huge”
+ The preceding character 1
or more times.
um+ matches “um” in “rum” and “umm” in “yummy” but
nothing in “huge”
XHTML requirement Actions Dreamweaver performs
September 4, 2007
DREAMWEAVER CS3
User Guide
305
? The preceding character at
most once (that is, indicates
that the preceding char-
acter is optional).
st?on matches “son” in “Johnson” and “ston” in “Johnston”
but nothing in “Appleton” or “tension”
. Any single character except
newline.
.an matches “ran” and “can” in the phrase “bran muffins can
be tasty”
x|y Either x or y. FF0000|0000FF matches “FF0000” in
bgcolor=”#FF0000” and “0000FF’” in font
color=”#0000FF”
{n} Exactly n occurrences of the
preceding character.
o{2} matches “oo” in “loom” and the first two o’s in
“mooooo” but nothing in “money”
{n,m} At least n, and at most m,
occurrences of the
preceding character.
F{2,4} matches “FF” in “#FF0000” and the first four Fs in
#FFFFFF
[abc] Any one of the characters
enclosed in the brackets.
Specify a range of charac-
ters with a hyphen (for
example, [a-f] is equivalent
to [abcdef]).
[e-g] matches “e” in “bed”, “f” in “folly”, and ”g” in “guard”
[^abc] Any character not enclosed
in the brackets. Specify a
range of characters with a
hyphen (for example, [^a-f]
is equivalent to [^abcdef]).
[^aeiou] initially matches “r” in “orange”, “b” in “book”,
and “k” in “eek!”
\b A word boundary (such as a
space or carriage return).
\bb matches “b” in “book” but nothing in “goober” or “snob”
\B Anything other than a word
boundary.
\Bb matches “b” in “goober” but nothing in “book”
\d Any digit character. Equiva-
lent to [0-9].
\d matches “3” in “C3PO” and “2” in “apartment 2G”
\D Any nondigit character.
Equivalent to [^0-9].
\D matches “S” in “900S” and “Q” in “Q45”
\f Form feed.
\n Line feed.
\r Carriage return.
\s Any single white-space
character, including space,
tab, form feed, or line feed.
\sbook matches ”book” in “blue book” but nothing in
“notebook”
\S Any single non-white-
space character.
\Sbook matches “book” in “notebook” but nothing in “blue
book”
\t A tab.
Character Matches Example
September 4, 2007
DREAMWEAVER CS3
User Guide
306
Use parentheses to set off groupings within the regular expression to be referred to later. Then use $1, $2, $3, and so
on in the Replace With field to refer to the first, second, third, and later parenthetical groupings.
Note: In the Search For box, to refer to a parenthetical grouping earlier in the regular expression, use \1, \2, \3, and so
on instead of $1, $2, $3.
For example, searching for (\d+)\/(\d+)\/(\d+) and replacing it with $2/$1/$3 swaps the day and month in a date
separated by slashes, thereby converting between American-style dates and European-style dates.
See also
“Search for tags, attributes, or text in code” on page 320
“Save and recall search patterns” on page 321
About server behavior code
When you develop a dynamic page and select a server behavior from the Server Behaviors panel, Dreamweaver
inserts one or more code blocks into your page to make the server behavior work.
If you manually change the code within a code block, you can no longer use panels such as the Bindings and Server
Behaviors panels to edit the server behavior. Dreamweaver looks for specific patterns in the page code to detect
server behaviors and display them in the Server Behaviors panel. If you change a code block’s code in any way,
Dreamweaver can no longer detect the server behavior and display it in the Server Behaviors panel. However, the
server behavior still exists on the page, and you can edit it in the coding environment in Dreamweaver.
See also
“Automatic code modification in Dreamweaver” on page 302
“Optimizing the workspace for visual development” on page 538
“Displaying database records” on page 570
\w Any alphanumeric char-
acter, includingunderscore.
Equivalent to [A-Za-z0-9_].
b\w* matches “barking” in “the barking dog” and both “big”
and “black” in “the big black dog”
\W Any non-alphanumeric
character. Equivalent to
[^A-Za-z0-9_].
\W matches “&” in “Jake&Mattie” and “%” in “100%”
Control+Enter
or Shift+Enter
(Windows), or
Control+
Return or
Shift+Return
or
Command+
Return
(Macintosh)
Return character. Make sure
that you deselect the
Ignore Whitespace Differ-
ences option when
searching for this, if not
using regular expressions.
Note that this matches a
particular character, not the
general notion of a line
break; for instance, it
doesn’t match a <br> tag
or a <p> tag. Return char-
acters appear as spaces in
Design view, not as line
breaks.
Character Matches Example
September 4, 2007
DREAMWEAVER CS3
User Guide
307
Setting up your coding environment
Changing your coding environment
You can adapt the coding environment in Dreamweaver to fit the way you work. For example, you can change the
way you view code, set up different keyboard shortcuts, or import and use your favorite tag library.
Viewing code
You can view the source code for the current document in several ways: you can display it in the Document window
by enabling Code view, you can split the Document window to display both the page and its associated code, or you
can work in the Code inspector, a separate coding window. The Code inspector works just like Code view; you can
think of it as a detachable Code view for the current document.
See also
“Change the code format” on page 309
“Set the code hints” on page 311
“Set the code colors” on page 312
View code in the Document window
❖Select View > Code.
Code and edit a page simultaneously in the Document window
1Select View > Code and Design.
The code appears in the top pane and the page appears in the bottom pane.
2To display the page on top, select Design View On Top from the View Options menu on the Document toolbar.
3To adjust the size of the panes in the Document window, drag the splitter bar to the desired position. The splitter
bar is located between the two panes.
CodeviewisupdatedautomaticallywhenyoumakechangesinDesignview.However,aftermakingchangesinCode
view, you must manually update the document in Design view by clicking in Design view or pressing F5.
View code in a separate window with the Code inspector
The Code inspector lets you work in a separate coding window, just like working in Code view.
❖Select Window > Code Inspector. The toolbar includes the following options:
File Management Puts or gets the file.
Preview/Debug In Browser Previews or debugs your document in a browser.
Refresh Design View Updates the document in Design view so that it reflects any changes you made in the code.
Changesyoumakeinthecodedon’tautomaticallyappearinDesignviewuntilyouperformcertainactions,suchas
saving the file or clicking this button.
Reference Opens the Reference panel. See “Use language-reference material” on page 323.
Code Navigation Lets you move quickly in the code. See “Go to a JavaScript or VBScript function” on page 320.
View Options Lets you determine how the code is displayed. See “Set the code appearance” on page 309.
September 4, 2007
DREAMWEAVER CS3
User Guide
308
To use the Coding toolbar along the left side of the window, see “Insert code with the Coding toolbar” on page 316.
Using the coder-oriented workspace (Windows only)
In Windows, you can use a workspace that looks similar to the workspace in Macromedia® HomeSite® from Adobe,
with the panel groups docked on the left side of the main window instead of on the right side. In this workspace
layout, the Property inspector is collapsed by default, and the Document window appears in Code view by default.
See also
“Choose the workspace layout (Windows)” on page 34
Customizing keyboard shortcuts
You can use your favorite keyboard shortcuts in Dreamweaver. If you’re accustomed to using specific keyboard
shortcuts—for example, Control+Enter to add a line break, Control+G to go to a specific position in the code, or
Shift+F6 to validate a file—you can add them to Dreamweaver using the Keyboard Shortcut Editor. For instructions,
see “Customize keyboard shortcuts” on page 708.
See also
“Work with code snippets” on page 315
Open files in Code view by default
When you open a file type that normally doesn’t contain any HTML (for example, a JavaScript file), the file opens in
Code view (or Code inspector) instead of Design view. You can specify which file types open in Code view.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select File Types/Editors from the Category list on the left.
3
IntheOpenInCodeViewbox,addthefilenameextensionofthefiletypeyouwanttoopenautomaticallyinCodeview.
Type a space between filename extensions. You can add as many extensions as you like.
See also
“Use an external editor” on page 313
“Find coding errors with the Validator” on page 326
Customizing the coding environment
About coding preferences
You can customize the Dreamweaver coding environment to meet your specific needs, by setting preferences for
code formatting, rewriting, and coloring, among others.
Note: To set advanced preferences, use the Tag Library editor (see “Managing tag libraries” on page 343).
September 4, 2007
DREAMWEAVER CS3
User Guide
309
Set the code appearance
You can set word wrapping, display line numbers for the code, highlight invalid code, set syntax coloring for code
elements, set indenting, and show hidden characters from the View > Code View Options menu.
1View a document in Code view or the Code inspector.
2Do one of the following:
•Select View > Code View Options
•Click the View Options button in the toolbar at the top of Code view or the Code inspector.
3Select or deselect any of the following options:
Word Wrap Wraps the code so that you can view it without scrolling horizontally. This option doesn’t insert line
breaks; it just makes the code easier to view.
Line Numbers Displays line numbers along the side of the code.
Hidden Characters Displays special characters in place of white space. For example, a dot replaces each space, a
double chevron replaces each tab, and a paragraph marker replaces each line break.
Note: Soft line breaks that Dreamweaver uses for word wrapping are not displayed with a paragraph marker.
Highlight Invalid Code Causes Dreamweaver to highlight in yellow all HTML code that isn’t valid. When you select
an invalid tag, the Property inspector displays information on how to correct the error.
Syntax Coloring Enables or disables code coloring. For information on changing the coloring scheme, see “Set the
code colors” on page 312.
Auto Indent MakesyourcodeindentautomaticallywhenyoupressEnterwhilewritingcode.Thenewlineofcode
indents to the same level as the previous line. For information on changing the indent spacing, see the Tab Size option
in “Change the code format” on page 309.
See also
“Viewing code” on page 307
“Coding toolbar overview” on page 20
Change the code format
You can change the look of your code by specifying formatting preferences such as indentation, line length, and the
case of tag and attribute names.
All the Code Format options, except the Override Case of option, are automatically applied only to new documents
or additions to documents that you subsequently create.
To reformat existing HTML documents, open the document, and select Commands > Apply Source Formatting.
1Select Edit > Preferences.
2Select Code Format from the Category list on the left.
3Set any of the following options:
Indent Indicates whether code generated by Dreamweaver should be indented (according to the indentation rules
specified in these preferences) or not.
September 4, 2007
DREAMWEAVER CS3
User Guide
310
Note: Most of the indentation options in this dialog box apply only to code generated by Dreamweaver, not to code that
youtype.Tomakeeachnewlineofcodethatyoutypeindenttothesamelevelasthepreviousline,selectView>Code
View Options Auto-Indent option. For more information, see “Set the code appearance” on page 309.
With (Text box and pop-up menu) Specifies how many spaces or tabs Dreamweaver should use to indent code that
it generates. For example, if you type 3 in the box and select Tabs in the pop-up menu, then code generated by
Dreamweaver is indented using three tab characters for every level of indentation.
Tab Size Determines how many characters wide each tab character appears in Code view. For example, if Tab Size is
set to 4, then each tab is displayed in Code view as a four-character-wide blank space. If, additionally, Indent With
is set to 3 Tabs, then code generated by Dreamweaver is indented using three tab characters for every level of inden-
tation, which appears in Code view as a twelve-character-wide blank space.
Note: Dreamweaver indents using either spaces or tabs; it doesn’t convert a run of spaces to a tab when inserting code.
Automatic Wrapping Inserts a line-break character (also known as a “hard” return) when a line reaches the specified
column width. (Dreamweaver inserts line-break characters only in places where they don’t change the appearance of
the document in browsers, so some lines may remain longer than the Automatic Wrapping option specifies.) By
contrast, the Wrap option in Code view displays long lines (that extend beyond the width of the window) as if they
contained line-break characters, but doesn’t actually insert line-break characters.
Line Break Type Specifies the type of remote server (Windows, Macintosh, or UNIX) that hosts your remote site.
Choosing the correct type of line break characters ensures that your HTML source code appears correctly when
viewedontheremoteserver.Thissettingisalsousefulwhenyouareworkingwithanexternaltexteditorthatrecog-
nizes only certain kinds of line breaks. For example, use CR LF (Windows) if Notepad is your external editor, and
use CR (Macintosh) if SimpleText is your external editor.
Note: For servers that you connect to using FTP, this option applies only to binary transfer mode; the ASCII transfer
mode in Dreamweaver ignores this option. If you download files using ASCII mode, Dreamweaver sets line breaks based
on the operating system of your computer; if you upload files using ASCII mode, the line breaks are all set to CR LF.
Default Tag Case and Default Attribute Case Control the capitalization of tag and attribute names. These options are
appliedtotagsandattributesthatyouinsertoreditinDesignview,buttheyarenotappliedtothetagsandattributes
that you enter directly in Code view, or to the tags and attributes already in a document when you open it (unless
you also select one or both of the Override Case Of options).
Note: These preferences apply only to HTML pages. Dreamweaver ignores them for XHTML pages because uppercase
tags and attributes are invalid XHTML.
Override Case Of: Tags and Attributes Specify whether to enforce your specified case options at all times, including
when you open an existing HTML document. When you select one of these options and click OK to dismiss the
dialog box, all tags or attributes in the current document are immediately converted to the specified case, as are all
tags or attributes in each document you open from then on (until you deselect this option again). Tags or attributes
you type in Code view and in the Quick Tag Editor are also converted to the specified case, as are tags or attributes
you insert using the Insert bar. For example, if you want tag names always to be converted to lowercase, specify
lowercase in the Default Tag Case option, and then select the Override Case Of: Tags option. Then when you open
a document that contains uppercase tag names, Dreamweaver converts them all to lowercase.
Note: Older versions of HTML allowed either uppercase or lowercase tag and attribute names, but XHTML requires
lowercase for tag and attribute names. The web is moving toward XHTML, so it’s generally best to use lowercase tag and
attribute names.
TD Tag: Do Not Include A Break Inside The TD Tag Addresses a rendering problem that occurs in some older
browsers when white space or line breaks exist immediately after a <td> tag, or immediately before a </td> tag. When
September 4, 2007
DREAMWEAVER CS3
User Guide
311
you select this option, Dreamweaver does not write line breaks after a <td> or before a </td> tag, even if the
formatting in the Tag Library indicates that the line break should be there.
Advanced Formatting Lets you set formatting options for Cascading Style Sheets (CSS) code and for individual tags
and attributes in the Tag Library Editor.
White Space Character (Japanese version only) Lets you select either or Zenkaku space for HTML code. The
white space selected in this option will be used for empty tags when creating a table and when the “Allow Multiple
Consecutive Spaces” option is enabled in Japanese Encoding pages.
See also
“Format CSS code” on page 140
Set the code hints
Code hints let you quickly insert tag names, attributes, and values as you type code in Code view or the Quick Tag
Editor.
Even if code hints are disabled, you can display a pop-up hint in Code view by pressing Control+Spacebar.
1Select Edit > Preferences.
2Select Code Hints from the Category list on the left.
3Set any of the following options:
Even if code hints are disabled, you can display a pop-up hint in Code view by pressing Control+Spacebar.
Close Tags Specifies how you want Dreamweaver to insert closing tags. By default, Dreamweaver inserts the closing
tag automatically after you type the characters </. You can change this default behavior so that the closing tag is
inserted after you type the final angle bracket (>) of the opening tag, or so that no closing tag is inserted at all.
Enable Code Hints Displays code hints while you enter code in Code view. Drag the Delay slider to set the time in
seconds before appropriate hints are displayed.
Menus Sets exactly which type of code hints you want displayed while typing. You can use all or some of the menus.
See also
“Use code hints” on page 313
“Use the hints menu in the Quick Tag Editor” on page 334
Set the code rewriting preferences
Use the code rewriting preferences to specify how and whether Dreamweaver modifies your code while opening
documents, when copying and pasting form elements, and when entering attribute values and URLs using tools such
as the Property inspector. These preferences have no effect when you edit HTML or scripts in Code view.
If you disable the rewriting options, invalid-markup items are displayed in the Document window for HTML that it
would have rewritten.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select Code Rewriting from the Category list on the left.
September 4, 2007
DREAMWEAVER CS3
User Guide
312
3Set any of the following options:
Fix Invalidly Nested and Unclosed Tags Rewrites overlapping tags. For example, <b><i>text</b></i> is rewritten
as <b><i>text</i></b>. This option also inserts closing quotation marks and closing brackets if they are missing.
Rename Form Items When Pasting Ensures you don’t have duplicate names for form objects. This option is enabled
by default.
Note: Unlike the other options in this preferences dialog box, this option does not apply when you open a document, only
when you copy and paste a form element.
Remove Extra Closing Tags Deletes closing tags that have no corresponding opening tag.
Warn When Fixing Or Removing Tags Displays a summary of technically invalid HTML that Dreamweaver
attempted to correct. The summary notes the location of the problem (using line and column numbers) so that you
can find the correction and ensure that it’s rendering as intended.
Never Rewrite Code: In Files With Extensions Allows you to prevent Dreamweaver from rewriting code in files with
the specified filename extensions. This option is particularly useful for files that contain third-party tags.
Encode <, >, &, And " In Attribute Values Using & Ensures that attribute values that you enter or edit using
Dreamweaver tools such as the Property inspector contain only legal characters. This option is enabled by default.
Note: This option and the following options do not apply to URLs that you type in Code view. Also, they do not cause
existing code already in a file to change.
Do Not Encode Special Characters Prevents Dreamweaver from changing URLs to use only legal characters. This
option is enabled by default.
Encode Special Characters In URL Using &# Ensures that when you enter or edit URLs using Dreamweaver tools
such as the Property inspector, those URLs contain only legal characters.
Encode Special Characters In URL Using % Operates the same way as the preceding option, but uses a different
method of encoding special characters. This encoding method (using the percent sign) may be more compatible with
older browsers, but doesn’t work as well with characters from some languages.
Insert Using Browser-safe Scripts Ensures that active content that you insert with Dreamweaver uses tags that will
display the content correctly in the latest versions of Internet Explorer. By default, Dreamweaver only uses browser-
safe scripts for Flash and Shockwave active content. The feature is extensible, however, and allows you to use third-
party extensions to insert other kinds of active content correctly.
Convert Tags To Scripts On File Open Renders <object>,<embed>, and <applet> tags null and adds the appro-
priate JavaScript tags upon opening files that contain active content.
See also
“Clean up Microsoft Word HTML files” on page 76
Set the code colors
Use the code coloring preferences to specify colors for general categories of tags and code elements, such as form-
related tags or JavaScript identifiers. To set color preferences for a specific tag, edit the tag definition in the Tag
Library editor.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select Code Coloring from the Category list on the left.
3Select a default background color for Code view and the Code inspector.
September 4, 2007
DREAMWEAVER CS3
User Guide
313
4Select a document type, and click Edit Coloring Scheme.
5
Select an item and set its text color, background color, and (optional) style (bold, italic, or underline), and click OK.
The sample code in the Preview pane changes to match the new colors and styles.
6Click OK.
See also
“Customize code coloring preferences for a template” on page 418
“Edit libraries, tags, and attributes” on page 344
Use an external editor
You can specify an external editor to use for editing files with specific filename extensions. For example, you can start
a text editor such as BBEdit, Notepad, or TextEdit from Dreamweaver to edit JavaScript (JS) files.
You can assign different external editors for different filename extensions.
See also
“Open files in Code view by default” on page 308
Set an external editor for a file type
1Select Edit > Preferences.
2Select File Types/Editors from the Category list on the left, set the options, and click OK.
Open In Code View Specifies the filename extensions that automatically open in Code view in Dreamweaver.
External Code Editor Specifies the text editor to use.
Reload Modified Files Specifies the behavior when Dreamweaver detects that changes were made externally to a
document that is open in Dreamweaver.
Save On Launch Specifies whether Dreamweaver should always save the current document before starting the
editor, never save the document, or prompt you to ask whether to save or not each time you start the external editor.
Fireworks Specifies editors for various media file types.
Start an external code editor
❖Select Edit > Edit with External Editor.
Writing and editing code
Use code hints
The code hints feature helps you insert and edit code quickly and without mistakes. When you type certain
characters in Code view, such as the first letters of a tag or attribute or CSS property name, a list appears, suggesting
options to complete your entry. You can use this feature to insert or edit code, or just to see the available attributes
for a tag, the available parameters for a function, or the available methods for an object.
September 4, 2007
DREAMWEAVER CS3
User Guide
314
Codehintsareavailableforavarietyofkindsofcode.Anappropriatelistofitemsappearswhenyoutypeaparticular
character that indicates the beginning of a piece of code; for example, to display a code hints list of HTML tag names,
type a start bracket (<).
For best results, especially when using code hints for functions and objects, set the Delay option in the Code Hints
preferences dialog box to a delay of 0 seconds.
The code hints list disappears when you press Backspace (Windows) or Delete (Macintosh).
See also
“Set the code hints” on page 311
Display a code hints menu
❖Press Control+Spacebar.
Insert markup or other code in Code view by using code hints
1Type the beginning of a piece of code. For example, to insert a tag, type a start bracket (<); to insert an attribute,
place the insertion point immediately after a tag name and press Spacebar.
A list of items (such as tag names or attribute names) appears.
To close the list at any time, press Escape.
2Scroll through the list by using the scroll bar or the Up Arrow and Down Arrow keys.
3To insert an item from the list, double-click it, or select it and press Enter (Windows) or Return (Macintosh).
If a recently created CSS style doesn’t appear in a code hints list of CSS styles, select Refresh Style List from the code
hints list. If Design view is showing, some invalid code might appear in Design view temporarily after you select
Refresh Style List; to remove that invalid code from Design view, after you finish inserting the style, press F5 to refresh
Design view again.
4To insert a closing tag, type </ (slash).
Note: By default, Dreamweaver determines what tag needs to be closed and closes it for you. You can change this default
behavior so that Dreamweaver inserts a closing tag after you type the final angle bracket (>) of the opening tag, or so
that it inserts no closing tag at all. Select Edit > Preferences > Code Hints, and then select one of the Close Tags options.
Edit a tag by using code hints
•To replace an attribute with a different attribute, delete the attribute and its value, and then add an attribute and
its value as described in the previous procedure.
•To change a value, delete the value, and then add a value as described in the previous procedure.
Edit a server-language tag with the Property inspector
Editthecodeinaserver-languagetag(suchasanASPtag)withoutenteringCodeviewbyusingthecodeProperty
inspector.
1In Design view, select the server-language tag visual icon.
2In the Property inspector, click the Edit button.
3Make changes to the tag code, and click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
315
See also
“Setting up a web application” on page 501
Work with code snippets
Code snippets let you store content for quick reuse. You can create, insert, edit, or delete snippets of HTML,
JavaScript, CFML, ASP, JSP, and more. You can also manage and share your code snippets with team members. Some
predefined snippets that you can use as a starting point are available.
Snippets that contain <font> tags and other deprecated elements and attributes are in the Legacy folder in the
Snippets panel.
Insert a code snippet
1Place the insertion point where you want to insert the code snippet, or select code to wrap a snippet around.
2In the Snippets panel (Window > Snippets), double-click the snippet.
You can also right-click (Windows) or Control-click (Macintosh) the snippet, and then select Insert from the pop-up
menu.
Create a code snippet
1In the Snippets panel, click the New Snippet icon at the bottom of the panel.
2Enter a name for the snippet.
Note: Snippet names can’t contain characters that are invalid in filenames, such as slashes(/ or \), special characters, or
double quotes (“).
3(Optional) Enter a text description of the snippet. This makes it easier for other team members to use the snippet.
4For Snippet Type, select Wrap Selection or Insert Block.
aIf you chose Wrap Selection, add code for the following options:
Insert Before Type or paste the code to insert before the current selection.
Insert After Type or paste the code to insert after the current selection.
To set default spacing for the blocks, use line breaks; press Enter (Windows) or Return (Macintosh) inside the text
boxes.
Note: Because snippets can be created as start and end blocks, you can use them to surround other tags and content. This
is useful for inserting special formatting, links, navigation elements, and script blocks. Simply highlight the content you
want to surround, then insert the snippet.
bIf you chose Insert Block, type or paste the code to insert.
5(Optional) Select a Preview Type: Code or Design.
Design Renders the code and displays it in the Preview pane of the Snippets panel.
Code Displays the code in the Preview pane.
6Click OK.
Edit or delete a code snippet
❖In the Snippets panel, select a snippet, and click the Edit Snippet button or the Remove button at the bottom of
the panel.
September 4, 2007
DREAMWEAVER CS3
User Guide
316
Create code snippet folders and manage code snippets
1In the Snippets panel, click the New Snippet Folder button at the bottom of the panel.
2Drag snippets to the new folder or other folders, as desired.
Add or edit a keyboard shortcut for a snippet
1In the Snippets panel, right-click (Windows) or Control-click (Macintosh) and select Edit Keyboard Shortcuts.
The Keyboard Shortcuts Editor appears.
2In the Commands pop-up menu, select Snippets.
A list of snippets appears.
3Select a snippet and assign a keyboard shortcut to it.
For more information, see “Customize keyboard shortcuts” on page 708.
Share a snippet with other members of your team
1Find the file corresponding to the snippet that you want to share in the Configuration/Snippets folder in the
Dreamweaver application folder.
2Copy the snippet file to a shared folder on your computer or a network computer.
3Have the other members of the team copy the snippet file to their Configuration/Snippets folder.
Insert code with the Coding toolbar
1Make sure you are in Code view (View > Code).
2Position the insertion point in the code, or select a block of code.
3Click a button in the Coding toolbar, or select an item from a pop-up menu in the toolbar.
To find out what each button does, position the pointer over it until a tooltip appears. The Coding toolbar displays
the following buttons by default:
Open Documents Liststhedocumentsthatareopen.Whenyouselectone,itisdisplayedintheDocumentwindow.
Collapse Full Tag Collapses the content between a set of opening and closing tags (for example, the content between
<table> and </table>). You must place the insertion point in the opening or closing tag and then click the Collapse
Full Tag button to collapse the tag.
You can also collapse the code outside a full tag by placing the insertion point in an opening or closing tag and
Alt-clicking (Windows) or Option-clicking (Macintosh) the Collapse Full Tag button. Additionally, Control-clicking
this button disables “smart collapse” so that Dreamweaver doesn’t adjust the content it collapses outside full tags. For
more information, see “About collapsing code” on page 324.
Collapse Selection Collapses the selected code.
You can also collapse the code outside a selection by Alt-clicking (Windows) or Option-clicking (Macintosh) the
Collapse Selection button. Additionally, Control-clicking this button disables “smart collapse” so that you can
collapse exactly what you selected without any manipulation from Dreamweaver. For more information, see “About
collapsing code” on page 324.
Expand All Restores all collapsed code.
September 4, 2007
DREAMWEAVER CS3
User Guide
317
Select Parent Tag Selects the content and surrounding opening and closing tags of the line in which you’ve placed
the insertion point. If you repeatedly click this button, and your tags are balanced, Dreamweaver eventually selects
the outermost html and /html tags.
Balance Braces Selects the content and surrounding parentheses, braces, or square brackets of the line in which you
placed the insertion point. If you repeatedly click this button, and your surrounding symbols are balanced,
Dreamweaver eventually selects the outermost braces, parentheses, or brackets in the document.
Line Numbers Lets you hide or show numbers at the beginning of each line of code.
Highlight Invalid Code Highlights invalid code in yellow.
Apply Comment Lets you wrap comment tags around selected code, or open new comment tags.
•Apply HTML Comment wraps the selected code with <!-- and --!>, or opens a new tag if no code is selected.
•Apply // Comment inserts // at the beginning of each line of selected CSS or JavaScript code, or inserts a single
// tag if no code is selected.
•Apply /* */ wraps the selected CSS or JavaScript code with /* and */.
•Apply ' Comment is for Visual Basic code. It inserts a single quotation mark at the beginning of each line of a
Visual Basic script, or inserts a single quotation mark at the insertion point if no code is selected.
•When you are working in a ASP, ASP.NET, JSP, PHP, or ColdFusion file and you select the Apply Server Comment
option, Dreamweaver automatically detects the correct comment tag and applies it to your selection.
Remove Comment Removes comment tags from the selected code. If a selection includes nested comments, only the
outer comment tags are removed.
Wrap Tag Wraps selected code with the selected tag from the Quick Tag Editor.
Recent Snippets Lets you insert a recently used code snippet from the Snippets panel. For more information, see
“Work with code snippets” on page 315.
Move or Convert CSS Lets you move CSS to another location, or convert inline CSS to CSS rules. For more infor-
mation, see “Move CSS rules” on page 137 and “Convert inline CSS to a CSS rule” on page 138.
Indent Code Shifts the selection to the right.
Outdent Code Shifts the selection to the left.
Format Source Code Applies previously specified code formats to selected code, or to the entire page if no code is
selected. You can also quickly set code formatting preferences by selecting Code Formatting Settings from the
Format Source Code button, or edit tag libraries by selecting Edit Tag Libraries.
The number of buttons available in the Coding toolbar varies depending on the size of the Code view in the
Document window. To see all of the available buttons, resize the Code view window or click the expander arrow at
the bottom of the Coding toolbar.
You can also edit the Coding toolbar to display more buttons (such as Word Wrap, Hidden Characters, and Auto
Indent) or hide buttons that you don’t want to use. To do this, however, you must edit the XML file that generates the
toolbar. For more information, see Extending Dreamweaver.
Note: The option to view hidden characters, which is not a default button in the Coding toolbar, is available from the
View menu (View > Code View Options > Hidden Characters).
September 4, 2007
DREAMWEAVER CS3
User Guide
318
See also
“Verify tags and braces are balanced” on page 327
“Coding toolbar overview” on page 20
“Display toolbars” on page 27
Insert code with the Insert bar
1Position the insertion point in the code.
2Select an appropriate category in the Insert bar.
3Click a button in the Insert bar or select an item from a pop-up menu in the Insert bar.
Whenyouclickanicon,thecodemayappearinyourpageimmediately,oradialogboxmayappearrequestingmore
information to complete the code.
To find out what each button does, position the pointer over it until a tooltip appears. The number and type of
buttons available in the Insert bar varies depending on the current document type. It also depends on whether you’re
using Code view or Design view.
Although the Insert bar provides a collection of frequently used tags, it is not comprehensive. To choose from a more
comprehensive selection of tags, use the Tag Chooser.
See also
“Insert bar overview” on page 19
Insert tags with the Tag Chooser
Use the Tag Chooser to insert in your page any tag in the Dreamweaver tag libraries (which include ColdFusion and
ASP.NET tag libraries).
1
Position the insertion point in the code, right-click (Windows) or Control-click (Macintosh), and select Insert Tag.
The Tag Chooser appears. The left pane contains a list of supported tag libraries, and the right pane shows the
individual tags in the selected tag library folder.
2Select a category of tags from the tag library, or expand the category and select a subcategory.
3Select a tag from the right pane.
4To view syntax and usage information for the tag in the Tag Chooser, click the Tag Info button. If available, infor-
mation about the tag appears.
5To view the same information about the tag in the Reference panel, click the <?> icon. If available, information
about the tag appears.
6To insert the selected tag into your code, click Insert.
If the tag appears in the right pane with angle brackets (for example, <title></title>), it doesn’t require additional
information, and it’s immediately inserted into the document at the insertion point.
If the tag does require additional information, a tag editor appears.
7If a tag editor opens, enter the additional information, and click OK.
8Click the Close button.
September 4, 2007
DREAMWEAVER CS3
User Guide
319
See also
“About Dreamweaver tag libraries” on page 343
Edit tags with Tag editors
Use Tag editors to view, specify, and edit the attributes of tags.
1Right-click (Windows) or Control-click (Macintosh) a tag in Code view or an object in Design view, and select
Edit Tag from the pop-up menu. (The contents of this dialog box change depending on the selected tag.)
2Specify or edit attributes for the tag and click OK.
To get more information about the tag within the Tag editor, click Tag Info.
Indent code blocks
As you write and edit code in Code view or the Code inspector, you can change the indentation level of a selected
block or line of code, shifting it right or left by one tab.
Indent the selected block of code
•Press Tab.
•Select Edit > Indent Code.
Unindent the selected block of code
•Press Shift+Tab.
•Select Edit > Outdent Code.
Copy and paste code
1Copy the code from Code view or from another application.
2Place the insertion point in Code view, and select Edit > Paste.
See also
“Paste and move collapsed code fragments” on page 325
Insert HTML comments
Acomment is descriptive text that you insert in HTML code to explain the code or provide other information. The
text of the comment appears only in Code view and is not displayed in a browser.
Insert a comment at the insertion point
❖Select Insert > Comment.
In Code view, a comment tag is inserted and the insertion point is placed in the middle of the tag. Type your
comment.
In Design view, the Comment dialog box appears. Enter the comment and click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
320
Display comment markers in Design view
❖Select View > Visual Aids > Invisible Elements.
Make sure that the Comments option is selected in the Invisible Elements preferences or the comment marker does
not appear.
Edit an existing comment
•In Code view, find the comment and edit its text.
•In Design view, select the Comment marker, edit the comment’s text in the Property inspector, and then click in
the Document window.
Go to a JavaScript or VBScript function
In Code view and the Code inspector, you can view a list of all of the JavaScript or VBScript functions in your code
and jump to any one of them.
1View the document in Code view (View > Code) or the Code inspector (Window > Code Inspector).
2Do one of the following:
•In Code view, right-click (Windows) or Control-click (Macintosh) anywhere in Code view, and select the
Functions submenu from the context menu.
The Functions submenu does not appear in Design view.
Any JavaScript or VBScript functions in your code appear in the submenu.
To see the functions listed in alphabetical order, Control-right-click (Windows) or Option-Control-click (Macintosh)
in Code view, and then select the Functions submenu.
•In the Code inspector, click the Code Navigation button ({ }) on the toolbar.
3Select a function name to jump to the function in your code.
Search for tags, attributes, or text in code
You can search for specific tags, attributes, and attribute values. For example, you can search for all img tags that have
no alt attribute.
You can also search for specific text strings that are within or not within a set of container tags. For example, you can
search for the word Untitled contained in a title tag to find all the untitled pages on your site.
1Open the document to search in, or select documents or a folder in the Files panel.
2Select Edit > Find And Replace.
3Specify which files to search in, and then specify the kind of search to perform, and text or tags to search for.
Optionally, specify replacement text as well. Then click one of the Find buttons or one of the Replace buttons.
4Click the Close button.
5To search again without displaying the Find And Replace dialog box, press F3 (Windows) or Command+G
(Macintosh).
September 4, 2007
DREAMWEAVER CS3
User Guide
321
See also
“About regular expressions” on page 304
“Search for and replace text” on page 229
Save and recall search patterns
You can save search patterns and reuse them later.
See also
“About regular expressions” on page 304
“Search for and replace text” on page 229
Save a search pattern
1In the Find And Replace dialog box (Edit > Find And Replace), set the parameters for the search.
2Click the Save Query button (the disk icon).
3In the dialog box that appears, navigate to the folder where you want to save queries. Then type a filename that
identifies the query, and click Save.
For example, if the search pattern involves looking for img tags with no alt attribute, you might name the query
img_no_alt.dwr.
Note: Saved queries have the filename extension .dwr. Some saved queries from older versions of Dreamweaver may
have the extension .dwq.
Recall a search pattern
1Select Edit > Find And Replace.
2Click the Load Query button (the folder icon).
3Navigate to the folder where your queries are saved. Then select a query file and click Open.
4Click Find Next, Find All, Replace, or Replace All to initiate the search.
Change code selections
1In Code view, select some code and right-click (Windows) or Control-click (Macintosh).
2Select the Selection submenu, and select any of the following options:
Collapse Selection Collapses the selected code.
Collapse Outside Selection Collapses all of the code outside the selected code.
Expand Selection Expands the selected code fragment.
Collapse Full Tag Collapses the content between a set of opening and closing tags (for example, the content between
<table> and </table>).
Collapse Outside Full Tag Collapses the content outside a set of opening and closing tags (for example, the content
outside <table> and </table>).
Expand All Restores all collapsed code.
Apply HTML Comment Wraps the selected code with <!-- and --!>, or opens a new tag if no code is selected.
September 4, 2007
DREAMWEAVER CS3
User Guide
322
Apply /* */ Comment Wraps the selected CSS or JavaScript code with /* and */.
Apply // Comment Inserts // at the beginning of each line of selected CSS or JavaScript code, or inserts a single //
tag if no code is selected.
Apply ' Comment Inserts a single quotation mark at the beginning of each line of a Visual Basic script, or inserts a
single quotation mark at the insertion point if no code is selected.
Apply Server Comment Wraps the selected code. When you are working in a ASP, ASP.NET, JSP, PHP, or ColdFusion
fileandyouselecttheApplyServerCommentoption,Dreamweaverautomaticallydetectsthecorrectcommenttag
and applies it to your selection.
Apply Backslash-comment Hack Wraps the selected CSS code with comment tags that will cause Internet Explorer
5 for Macintosh to ignore the code.
Apply Caio Hack
WrapstheselectedCSScodewithcommenttagsthatwillcauseNetscapeNavigator4toignorethecode.
Remove Comment Removes comment tags from the selected code. If a selection includes nested comments, only the
outer comment tags are removed.
Remove Backslash-comment Hack Removes comment tags from the selected CSS code. If a selection includes nested
comments, only the outer comment tags are removed.
Remove Caio Hack Removes comment tags from the selected CSS code. If a selection includes nested comments,
only the outer comment tags are removed
Convert Tabs to Spaces Converts each tab in the selection to a number of spaces equal to the Tab Size value set in
Code Format preferences. For more information, see “Change the code format” on page 309.
Convert Spaces To Tabs Converts runs of spaces in the selection to tabs. Each run of spaces that has a number of
spaces equal to the tab size is converted to one tab.
Indent Indents the selection, shifting it to the right. For more information, see “Indent code blocks” on page 319.
Outdent Shifts the selection to the left.
Remove All Tags Removes all the tags in the selection.
Convert Lines To Table Wraps the selection in a table tag with no attributes.
Add Line Breaks Adds a br tag at the end of each line of the selection.
Convert To Uppercase Converts all letters in the selection (including tag and attribute names and values) to
uppercase.
Convert To Lowercase Converts all letters in the selection (including tag and attribute names and values) to
lowercase.
Convert Tags To Uppercase Converts all tag and attribute names and attribute values in the selection to uppercase.
Convert Tags To Lowercase Converts all tag and attribute names and attribute values in the selection to lowercase.
See also
“Collapse and expand code fragments” on page 324
September 4, 2007
DREAMWEAVER CS3
User Guide
323
Use language-reference material
The Reference panel provides you with a quick reference tool for markup languages, programming languages, and
CSS styles. It provides information on the specific tags, objects, and styles that you are working with in Code view
(or the Code inspector). The Reference panel also provides example code that you can paste into your documents.
Open the Reference panel
1Do one of the following in Code view:
•Right-click (Windows) or Control-click (Macintosh) a tag, attribute, or keyword, and then select Reference from
the context menu.
•Place the insertion point in a tag, attribute, or keyword, and then press Shift+F1.
The Reference panel opens and displays information about the tag, attribute, or keyword you clicked.
2To adjust the text size in the Reference panel, select Large Font, Medium Font, or Small Font from the options
menu (the small arrow at the upper right of the panel).
Paste example code into your document
1Click anywhere in example code in the reference content.
The entire code example is highlighted.
2Select Edit > Copy, and then paste the example code into your document in Code view.
Browse the reference content in the Reference panel
1To display tags, objects, or styles from another book, select a different book from the Book pop-up menu.
2To view information about a specific item, select it from the Tag, Object, Style, or CFML pop-up menu (depending
on which book you selected).
3To view information about an attribute of the selected item, select the attribute from the pop-up menu next to the
Tag, Object, Style, or CFML pop-up menu.
Thismenucontainsthelistofattributesfortheitemyouselect.ThedefaultselectionisDescription,whichdisplays
a description of the chosen item.
Print code
You can print your code to edit it offline, archive it, or distribute it.
1Open a page in Code view.
2Select File > Print Code.
3Specify printing options, and then click OK (Windows) or Print (Macintosh).
September 4, 2007
DREAMWEAVER CS3
User Guide
324
Collapsing code
About collapsing code
You can collapse and expand code fragments so that you can view different sections of your document without
having to use the scroll bar. For example, to see all of the CSS rules in the head tag that apply to a div tag farther
down the page, you can collapse everything between the head tag and the div tagsothatyoucanseebothsections
of code at once. Although you can select code fragments by making selections in Design view or Code view, you can
collapse code only in Code view.
Note: Files created from Dreamweaver templates display all code as fully expanded, even if the template file (.dwt)
contains collapsed code fragments.
See also
“Paste and move collapsed code fragments” on page 325
“Insert code with the Coding toolbar” on page 316
“Clean up code” on page 326
Collapse and expand code fragments
When you select code, a set of collapse buttons is displayed next to the selection (Minus symbols in Windows;
vertical triangles on the Macintosh). Click the buttons to collapse and expand the selection. When the code is
collapsed, the collapse buttons change to an expand button (a Plus button in Windows; a horizontal triangle on the
Macintosh).
Sometimes, the exact fragment of code that you selected is not collapsed. Dreamweaver uses “smart collapse” to
collapse the most common and visually pleasing selection. For example, if you selected an indented tag and then
selected the indented spaces before the tag as well, Dreamweaver would not collapse the indented spaces, because
most users would expect their indentations to be preserved. To disable smart collapse and force Dreamweaver to
collapse exactly what you selected, hold down the Control key before collapsing your code.
Also, a warning icon on collapsed code fragments is displayed if a fragment contains errors or code that is unsup-
ported by certain browsers.
You can also collapse the code by Alt-clicking (Windows) or Option-clicking (Macintosh) one of the collapse buttons,
or by clicking the Collapse Selection button in the Coding toolbar.
1Select some code.
2Select Edit > Code Collapse, and select any of options.
See also
“Change code selections” on page 321
“Insert code with the Coding toolbar” on page 316
Select a collapsed code fragment
❖In Code view, click the collapsed code fragment.
September 4, 2007
DREAMWEAVER CS3
User Guide
325
Note: WhenyoumakeaselectioninDesignviewthatispartofacollapsedcodefragment,thefragmentisautomatically
expanded in Code view. When you make a selection in Design view that is a complete code fragment, the fragment
remains collapsed in Code view.
View the code in a collapsed code fragment without expanding it
❖Hold the mouse pointer over the collapsed code fragment.
Use keyboard shortcuts to collapse and expand code
❖You can also use the following keyboard shortcuts:
Paste and move collapsed code fragments
You can copy and paste collapsed code fragments, or move collapsed code fragments by dragging.
See also
“Insert code with the Coding toolbar” on page 316
“Clean up code” on page 326
Copy and paste a collapsed code fragment
1Select the collapsed code fragment.
2Select Edit > Copy.
3Place the insertion point where you want to paste the code.
4Select Edit > Paste.
Note: You can paste into other applications, but the collapsed state of the code fragment is not preserved.
Drag a collapsed code fragment
1Select the collapsed code fragment.
2Drag the selection to the new location.
To drag a copy of the selection, Control-drag (Windows) or Alt-drag (Macintosh).
Note: You cannot drag to other documents.
Command Windows Macintosh
Collapse Selection Control+Shift+C Command+Shift+C
Collapse Outside Selection Control+Alt+C Command+Alt+C
Expand Selection Control+Shift+E Command+Shift+E
Collapse Full Tag Control+Shift+J Command+Shift+J
Collapse Outside Full Tag Control+Alt+J Command+Alt+J
Expand All Control+Alt+E Command+Alt+E
September 4, 2007
DREAMWEAVER CS3
User Guide
326
Optimizing and debugging code
Find coding errors with the Validator
You can use the Validator in Dreamweaver to quickly locate tag or syntax errors in your code. You can specify the
tag-based languages against which the Validator should check, the specific problems that the Validator should check,
and the types of errors that the Validator should report.
Note: Validator preferences are ignored when you validate a document that explicitly specifies a doc type.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select Validator from the Category list on the left.
3Select tag libraries to validate against.
You can’t select multiple versions of the same tag library or language; for example, if you select HTML 4.0, you can’t
also select HTML 3.2 or HTML 2.0. Select the earliest version you want to validate against; for example, if a
document contains valid HTML 2.0 code, it will also be valid HTML 4.0 code.
4Click Options, and set options for those libraries.
5Select Display options for the types of errors and warnings that you want the Validator report to include.
6Select items the Validator should check for:
Quotes In Text Indicates that Dreamweaver should warn you about each use of quotation marks in the text of the
document; you should use the " entity instead of quotation marks in the text of HTML documents.
Entities In Text Indicates that Dreamweaver should recommend changing certain characters (such as ampersand
(&), less-than (<), and greater-than (>)) to their HTML entity equivalents.
7Click OK to close the Validator Options dialog box, and click OK again to set the preferences.
See also
“Validate tags” on page 328
Clean up code
You can automatically remove empty tags, combine nested font tags, and otherwise improve messy or unreadable
HTML or XHTML code.
For information on how to clean up HTML generated from a Microsoft Word document, see “Open and edit existing
documents” on page 75.
1Open a document:
•If the document is in HTML, select Commands > Clean Up HTML.
•If the document is in XHTML, select Commands > Clean Up XHTML.
For an XHTML document, the Clean Up XHTML command fixes XHTML syntax errors, sets the case of tag
attributes to lowercase, and adds or reports the missing required attributes for a tag in addition to performing the
HTML cleanup operations.
2In the dialog box that appears, select any of the options, and click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
327
Note: Depending on the size of your document and the number of options selected, it may take several seconds to
complete the cleanup.
Remove Empty Container Tags Removes any tags that have no content between them. For example, <b></b> and
<font color="#FF0000"></font> are empty tags, but the <b> tag in <b>some text</b> is not.
Remove Redundant Nested Tags Removes all redundant instances of a tag. For example, in the code <b>This is
what I <b>really</b> wanted to say</b>,thebtags surrounding the word really are redundant and would be
removed.
Remove Non-Dreamweaver HTML Comments Removes all comments that were not inserted by Dreamweaver. For
example, <!--begin body text--> wouldberemoved,but<!-- TemplateBeginEditable name="doctitle"
--> wouldn’t, because it’s a Dreamweaver comment that marks the beginning of an editable region in a template.
Remove Dreamweaver Special Markup Removes comments that Dreamweaver adds to code to allow documents to
be automatically updated when templates and library items are updated. If you select this option when cleaning up
code in a template-based document, the document is detached from the template. For more information, see
“Detach a document from a template” on page 414.
Remove Specific Tag(s) Removes the tags specified in the adjacent text box. Use this option to remove custom tags
inserted by other visual editors and other tags that you don’t want to appear on your site (for example, blink).
Separate multiple tags with commas (for example, font,blink).
Combine Nested <font> Tags When Possible Consolidatestwoormorefont tags when they control the same range
of text. For example, <font size="7"><font color="#FF0000">big red</font></font> would be changed to
<font size="7" color="#FF0000">big red</font>.
Show Log On Completion Displaysanalertboxwithdetailsaboutthechangesmadetothedocumentassoonasthe
cleanup is finished.
See also
“Change the code format” on page 309
“Set the code colors” on page 312
Verify tags and braces are balanced
You can check to make sure the tags, parentheses (( )), braces ({ }), and square brackets ([ ]) in your page are
balanced. Balanced means that every opening tag, parenthesis, brace, or bracket has a corresponding closing one,
and vice versa.
Check for balanced tags
1Open the document in Code view.
2Place the insertion point in the nested code you want to check.
3Select Edit > Select Parent Tag.
The enclosing matching tags (and their contents) are selected in your code. If you keep selecting Edit > Select Parent
Tag, and your tags are balanced, eventually Dreamweaver will select the outermost html and /html tags.
Check for balanced parentheses, braces, or square brackets
1Open the document in Code view.
2Place the insertion point in the code you want to check.
September 4, 2007
DREAMWEAVER CS3
User Guide
328
3Select Edit > Balance Braces.
All of the code between the enclosing parentheses, braces, or square brackets is selected. Choosing Edit > Balance
Braces again selects all of the code inside the parentheses, braces, or square brackets that enclose the new selection.
Check for browser compatibility
The Browser Compatibility Check (BCC) feature helps you locate combinations of HTML and CSS that can trigger
browser rendering bugs. This feature also tests the code in your documents for any CSS properties or values that are
unsupported by your target browsers.
Note: This feature replaces the former Target Browser Check feature, but retains the CSS functionality of that feature.
See also
“Check for cross-browser CSS rendering issues” on page 141
Validate tags
Check the current document or a selected tag for tag or syntax errors. Dreamweaver can validate documents in many
languages, including HTML, XHTML, ColdFusion Markup Language (CFML), JavaServer Pages (JSP), Wireless
Markup Language (WML), and XML.
You can set preferences for the Validator, such as specifying the tag-based languages against which the Validator
should check, the specific problems that the Validator should check for, and the types of errors that the Validator
should report. For more information, see Set the Validator preferences.
Note: To validate your document for accessibility, see “Testing your site” on page 104.
1Do one of the following:
•For an XML or XHTML file, select File > Check Page > Validate as XML.
•Select File > Check Page > Validate Markup.
TheValidationtaboftheResultspaneldisplaysa“Noerrorsorwarnings”messageorliststhesyntaxerrorsitfound.
2Double-click an error message to highlight the error in the document.
3To save the report as an XML file, click the Save Report button.
4To view the report in your primary browser (which lets you print the report), click the Browse Report button.
Make pages XHTML-compliant
When you create a page, you can make it XHTML-compliant. You can also make an existing HTML document
XHTML-compliant.
See also
“About the XHTML code generated by Dreamweaver” on page 302
Create XHTML-compliant documents
1Select File > New.
2Select a category and type of page to create.
September 4, 2007
DREAMWEAVER CS3
User Guide
329
3Select one of the XHTML document type definitions (DTD) from the DocType pop-up menu on the far right of
the dialog box, and click Create.
For example, you can make an HTML document XHTML-compliant by selecting XHTML 1.0 Transitional or
XHTML 1.0 Strict from the pop-up menu.
Note: Not all document types can be made XHTML-compliant.
Create XHTML-compliant documents by default
1Select Edit > Preferences or Dreamweaver > Preferences (Mac OS X), and select the New Document category.
2Select a default document and select one of the XHTML document type definitions from the Default Document
Type (DTD) pop-up menu, and click OK.
For example, you can make an HTML document XHTML-compliant by selecting XHTML 1.0 Transitional or
XHTML 1.0 Strict from the pop-up menu.
Make an existing HTML document XHTML-compliant
1Open a document, and do one of the following:
•For a document without frames, select File > Convert, and then select one of the XHTML document type defini-
tions.
For example, you can make an HTML document XHTML-compliant by selecting XHTML 1.0 Transitional or
XHTML 1.0 Strict from the pop-up menu.
•For a document with frames, select a frame and select File > Convert, and then select one of the XHTML
document type definitions.
2To convert the whole document, repeat this step for every frame and the frameset document.
Note: You can’t convert an instance of a template, because it must be in the same language as the template on which it’s
based. For example, a document based on an XHTML template will always be in XHTML, and a document based on a
non-XHTML-compliant HTML template will always be HTML and can’t be converted to XHTML or any other
language.
Use the ColdFusion debugger (Windows only)
If you’re a ColdFusion developer using ColdFusion as your Dreamweaver testing server, you can view ColdFusion
debugging information without leaving Dreamweaver.
Note: This feature is not supported on the Macintosh. Macintosh developers can use Preview In Browser (F12) to open
a ColdFusion page in a separate browser. If the page contains errors, information about the possible causes for the errors
appears at the bottom of the page.
If you’re running ColdFusion MX 6.1 or earlier, make sure debugging settings are enabled in the ColdFusion Admin-
istrator before you begin debugging. If you’re running ColdFusion MX 7 or later, Dreamweaver enables the settings
for you.
Also, make sure your Dreamweaver testing server is running ColdFusion. For more information, see “Set up a testing
server” on page 48.
September 4, 2007
DREAMWEAVER CS3
User Guide
330
To ensure the debug information is refreshed every time a page is displayed in the internal browser, make sure
Internet Explorer checks for newer versions of the file every time the file is requested. In Internet Explorer, select
Tools > Internet Options, select the General tab, and click the Settings button in the Temporary Internet Files area. In
the Settings dialog box, select the Every Visit to Page option.
1Open the ColdFusion page in Dreamweaver.
2Click the Server Debug icon on the Document toolbar.
Dreamweaver requests the page from the ColdFusion server and displays it in an internal Internet Explorer browser
window. If the page contains errors, possible causes for the errors appear at the bottom of the page.
At the same time, a Server Debug panel opens. The panel provides a large amount of useful information, such as all
the pages the server processed to render the page, all the SQL queries executed on the page, and all the server
variables and their values, if any. The panel also provides a summary of execution times.
3If an Exceptions category appears in the Server Debug panel, click the Plus (+) icon to expand the category.
The Exceptions category appears if the server encountered a problem or problems with the page. Expand the
category to find out more about the problem.
4Switch back to Code view (View > Code) or Design view (View > Design) and fix the error.
5Save the file and click the Server Debug icon again.
Dreamweaver renders the page in the internal browser again and updates the Server Debug panel. If there are no
more problems with the page, the Exceptions category does not reappear in the panel.
6To leave debug mode, switch to Code view (View > Code) or Design view (View > Design).
See also
“Using ColdFusion components (ColdFusion)” on page 665
Editing code in Design view
About editing code in Design view
Dreamweaver lets you visually create and edit web pages without worrying about the underlying source code, but
there are times when you might need to edit the code for greater control or to troubleshoot your web page.
Dreamweaver lets you edit some code while working in Design view.
This section is designed for people who prefer to work in Design view, but who also want quick access to the code.
Selecting child tags in Design view
If you select an object in Design view that contains child tags—for example, an HTML table—you can quickly select
the first child tag of that object by selecting Edit > Select Child.
Note: This command is only enabled in Design view.
For example, the <table> tag normally has <tr> child tags. If you select a <table> tag in the tag selector, you can
select the first row in the table by selecting Edit > Select Child. Dreamweaver selects the first <tr> tag in the tag
selector. Since the <tr> tagitselfhaschildtags,namely<td> tags, selecting Edit > Select Child again selects the first
cell in the table.
September 4, 2007
DREAMWEAVER CS3
User Guide
331
Edit code with the Property inspector
You can use the Property inspector to inspect and edit the attributes of text or of objects on your page. The properties
shown in the Property inspector generally correspond to attributes of tags; changing a property in the Property
inspector generally has the same effect as changing the corresponding attribute in Code view.
Note: The Tag inspector and the Property inspector both let you view and edit a tag’s attributes. The Tag inspector lets
you to view and edit every attribute associated with a given tag. The Property inspector shows only the most common
attributes, but provides a richer set of controls for changing those attributes’ values, and lets you edit certain objects (such
as table columns) that don’t correspond to specific tags.
1Click in the text or select an object on the page.
The Property inspector for the text or object appears below the Document window. If the Property inspector is not
visible, select Window > Properties.
2Make changes to the attributes in the Property inspector.
Edit CFML with the Property inspector
Use the Property inspector to inspect and modify ColdFusion markup in Design view.
1In the Property inspector, click the Attributes button to edit the tag’s attributes or to add new ones.
2If the tag holds content between its opening and closing tags, click the Content button to edit the content.
The Content button appears only if the selected tag is not an empty tag (that is, if it has both an opening and a closing tag).
3If the tag contains a conditional expression, make changes to it in the Expression box.
Change attributes with the Tag inspector
Use the Tag inspector to edit or add attributes and attributes’ values. The Tag inspector lets you edit tags and objects
by using a property sheet similar to the ones found in other integrated development environments (IDEs).
1Do one of the following in the Document window:
•In Code view (or the Code inspector), click anywhere in a tag’s name or in its contents.
•In Design view, select an object, or select a tag in the Tag Selector.
2Open the Tag inspector (Window > Tag Inspector), and select the Attributes tab.
The selection’s attributes and their current values appear in the Tag inspector.
3Do any of the following in the Tag inspector:
•To view the attributes organized by category, click the Show Category View button .
•To view the attributes in an alphabetical list, click the Show List View button .
•To change the attribute’s value, select the value and edit it.
•To add a value for an attribute with no value, click in the attribute-value column to the right of the attribute and
add a value.
•If the attribute takes pre-defined values, select a value from the pop-up menu (or the color picker) to the right of
the attribute-value column.
•If the attribute takes a URL value, click the Browse button or use the Point-To-File icon to select a file, or type the
URL in the box.
September 4, 2007
DREAMWEAVER CS3
User Guide
332
•If the attribute takes a value from a source of dynamic content (such as a database), click the Dynamic Data button
to the right of the attribute-value column. Then select a source.
•To delete the attribute’s value, select the value and press Backspace (Windows) or Delete (Macintosh).
•To change the name of an attribute, select the attribute name and edit it.
Note: If you change the name of a standard attribute and then add a value for that attribute, the attribute and its new
value move to the appropriate category.
•To add a new attribute not already listed, click in the empty space below the last listed attribute name and type a
new attribute name.
4Press Enter (Windows) or Return (Macintosh), or click elsewhere in the Tag inspector, to update the tag in your
document.
See also
“Using JavaScript behaviors” on page 347
“Creating and managing CSS” on page 124
“Defining sources of dynamic content” on page 547
Quick Tag Editor overview
You use the Quick Tag Editor to quickly inspect, insert, and edit HTML tags without leaving Design view.
If you type invalid HTML in the Quick Tag Editor, Dreamweaver attempts to correct it for you by inserting closing
quotation marks and closing angle brackets where needed.
To set the Quick Tag Editor options, open the Quick Tag Editor by pressing Control-T (Windows) or Command-T
(Macintosh).
The Quick Tag Editor has three modes:
•Insert HTML mode is used to insert new HTML code.
•Edit Tag mode is used to edit an existing tag.
•Wrap Tag mode is to wrap a new tag around the current selection.
Note: The mode in which the Quick Tag Editor opens depends on the current selection in Design view.
In all three modes, the basic procedure for using the Quick Tag Editor is the same: open the editor, enter or edit tags
and attributes, and then close the editor.
You can cycle through the modes by pressing Control+T (Windows) or Command+T (Macintosh) while the Quick
Tag Editor is active.
See also
“Use the hints menu in the Quick Tag Editor” on page 334
Edit code with the Quick Tag Editor
Use the Quick Tag Editor to quickly insert and edit HTML tags without leaving Design view.
September 4, 2007
DREAMWEAVER CS3
User Guide
333
See also
“Write and edit scripts in Design view” on page 335
Insert an HTML tag
1In Design view, click in the page to place the insertion point where you want to insert code.
2Press Control+T (Windows) or Command+T (Macintosh).
The Quick Tag Editor opens in Insert HTML mode.
3Enter the HTML tag and press Enter.
The tag is inserted into your code, along with a matching closing tag if applicable.
4Press Escape to exit without making any changes.
Edit an HTML tag
1Select an object in Design view.
YoucanalsoselectthetagyouwanttoeditfromthetagselectoratthebottomoftheDocumentwindow.Formore
information, see “Edit code with the tag selector” on page 334.
2Press Control+T (Windows) or Command+T (Macintosh).
The Quick Tag Editor opens in Edit Tag mode.
3Enter new attributes, edit existing attributes, or edit the tag’s name.
4Press Tab to move forward from one attribute to the next; press Shift+Tab to move back.
Note: By default, changes are applied to the document when you press Tab or Shift+Tab.
5To close the Quick Tag Editor and apply all the changes, press Enter.
6To exit without making any further changes, press Escape.
Wrap the current selection with HTML tags
1Select unformatted text or an object in Design view.
Note: If you select text or an object that includes an opening or closing HTML tag, the Quick Tag Editor opens in Edit
Tag mode instead of Wrap Tag mode.
2Press Control+T (Windows) or Command+T (Macintosh), or click the Quick Tag Editor button in the Property
inspector.
The Quick Tag Editor opens in Wrap Tag mode.
3Enter a single opening tag, such as strong, and press Enter (Windows) or Return (Macintosh).
The tag is inserted at the beginning of the current selection, and a matching closing tag is inserted at the end.
4To exit without making any changes, press Escape.
September 4, 2007
DREAMWEAVER CS3
User Guide
334
Use the hints menu in the Quick Tag Editor
The Quick Tag Editor includes an attributes hint menu that lists all the valid attributes of the tag you are editing or
inserting.
You can also disable the hints menu or adjust the delay before the menu pops up in the Quick Tag Editor.
To see a hints menu that lists valid attributes for a tag, pause briefly while editing an attribute name in the Quick Tag
Editor. A hints menu appears, listing all the valid attributes for the tag you’re editing.
Similarly, to see a hints menu listing valid tag names, pause briefly while entering or editing a tag name in the Quick
Tag Editor.
Note: The Quick Tag Editor code hints preferences are controlled by the normal code hints preferences. For more infor-
mation, see “Set the code hints” on page 311.
See also
“Quick Tag Editor overview” on page 332
Use a hints menu
1Do one of the following:
•Begin to type a tag or attribute name. The selection in the Code Hints menu jumps to the first item that starts with
the letters you typed.
•Use the Up and Down Arrow keys to select an item.
•Use the scroll bar to find an item.
2Press Enter to insert the selected item, or double-click an item to insert it.
3To close the hints menu without inserting an item, press Escape or continue typing.
Disable the hints menu or change the delay before it appears
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh) and select Quick Tag Editor.
The Quick Tag Editor Preferences dialog box appears.
2To disable the hints menu, deselect the Enable Tag Hints option.
3To change the delay before the menu appears, adjust the Delay slider, and click OK.
Edit code with the tag selector
Youcanusethetagselectortoselect,edit,orremovetagswithoutleavingDesignview.Thetagselectorislocatedin
the status bar at the bottom of the Document window and shows a series of tags, as follows:
Edit or delete a tag
1Click in the document.
The tags that apply at the insertion point appear in the tag selector.
2Right-click (Windows) or Control-click (Macintosh) a tag in the tag selector.
September 4, 2007
DREAMWEAVER CS3
User Guide
335
3To edit a tag, select Edit Tag from the menu. Make your changes in the Quick Tag Editor. For more information,
see “Edit code with the Quick Tag Editor” on page 332.
4To delete a tag, select Remove Tag from the menu.
Select an object corresponding to a tag
1Click in the document.
The tags that apply at the insertion point appear in the tag selector.
2Click a tag in the tag selector.
The object represented by the tag is selected on the page.
Use this technique to select individual table rows (tr tags) or cells (td tags).
Write and edit scripts in Design view
You can work with client-side JavaScripts and VBScripts in both Code and Design view, in the following ways:
•Write a JavaScript or VBScript script for your page without leaving Design view.
•Create a link in your document to an external script file without leaving Design view.
•Edit a script without leaving Design view.
Before starting, select View > Visual Aids > Invisible Elements to ensure that script markers appear on the page.
Write a client-side script
1Place the insertion point where you want the script.
2Select Insert > HTML > Script Objects > Script.
3Select the scripting language from the Language pop-up menu.
If you are using JavaScript and are unsure of the version, select JavaScript rather than JavaScript1.1 or JavaScript1.2.
4Type or paste your script code into the Content box.
You don’t need to include the opening and closing script tags.
5Type or paste HTML code into the No Script box. Browsers that don’t support the chosen scripting language
display this code instead of running the script.
6Click OK.
Link to an external script file
1Place the insertion point where you want the script.
2Select Insert > HTML > Script Objects > Script.
3Click OK without typing anything in the Content box.
4Select the script marker in Design view of the Document window.
5InthePropertyinspector,clickthefoldericonandbrowsetoandselecttheexternalscriptfile,ortypethefilename
in the Source box.
Edit a script
1Select the script marker.
September 4, 2007
DREAMWEAVER CS3
User Guide
336
2In the Property inspector, click the Edit button.
The script appears in the Script Properties dialog box.
If you linked to an external script file, the file opens in Code view, where you can make your edits.
Note: If there is code between the script tags, the Script Properties dialog box opens even if there is also a link to an
external script file.
3In the Language box, specify either JavaScript or VBScript as the language of the script.
4In the Type pop-up menu, specify the type of script, either client-side or server-side.
5(Optional) In the Source box, specify an externally linked script file.
Click the folder icon or the Browse button to select a file, or type the path.
6Edit the script, and click OK.
Edit ASP server-side scripts in Design view
Use the ASP script Property inspector to inspect and modify ASP server-side scripts in Design view.
1In Design view, select the server-language tag visual icon.
2In the ASP script Property inspector, click the Edit button.
3Edit the ASP server-side script, and click OK.
Edit scripts on the page by using the Property inspector
1InthePropertyinspector,selectthescriptinglanguagefromtheLanguagepop-upmenu,ortypealanguagename
in the Language box.
Note: If you are using JavaScript and are unsure of the version, select JavaScript rather than JavaScript1.1 or
JavaScript1.2.
2In the Type pop-up menu, specify the type of script, either client-side or server-side.
3(Optional) In the Source box, specify an externally linked script file. Click the folder icon to select the file, or type
the path.
4Click Edit to modify the script.
See also
“Write and edit scripts in Design view” on page 335
Using JavaScript behaviors
You can easily attach JavaScript (client-side) behaviors to page elements by using the Behaviors tab of the Tag
inspector. For more information, see “Applying built-in Dreamweaver behaviors” on page 350.
Working with head content for pages
Pages contain elements that describe the information on the page, which is used by search browsers. You can set the
properties of head elements to control how your pages are identified.
September 4, 2007
DREAMWEAVER CS3
User Guide
337
View and edit head content
You c a n v ie w the e le ment s i n th e head section of a document by using the View menu, the Document window’s Code
view, or the Code inspector.
View elements in the head section of a document
❖SelectView>HeadContent.Foreachelementofthehead content, a marker appears at the top of the Document
window in Design view.
Note: If your Document window is set to show only Code view, View > Head Content is dimmed.
Insert an element into the head section of a document
1Select an item from the Insert > HTML > Head Tags submenu.
2Enter options for the element in the dialog box that appears, or in the Property inspector.
Edit an element in the head section of a document
1Select View > Head Content.
2Click one of the icons in the head section to select it.
3Set or modify the properties of the element in the Property inspector.
Set the meta properties for the page
Ameta tagisahead element that records information about the current page, such as the character encoding, author,
copyright, or keywords. These tags can also be used to give information to the server, such as the expiration date,
refresh interval, and PICS rating for the page. (PICS, the Platform for Internet Content Selection, provides a method
for assigning ratings, such as movie ratings, to web pages.)
Add a meta tag
1Select Insert > HTML > Head Tags > Meta.
2Specify the properties in the dialog box that appears.
Edit an existing meta tag
1Select View > Head Content.
2Select the Meta marker that appears at the top of the Document window.
3Specify the properties in the Property inspector.
Meta tag properties
❖Set the meta tag properties as follows:
Attribute Specifies whether the meta tag contains descriptive information about the page (name) or HTTP header
information (http-equiv).
Value Specifies the type of information you’re supplying in this tag. Some values, such as description,keywords,
and refresh, are already well defined (and have their own individual Property inspectors in Dreamweaver), but you
can specify practically any value (for example, creationdate,documentID, or level).
Content Specifies the actual information. For example, if you specified level for Value, you might specify
beginner,intermediate, or advanced for Content.
September 4, 2007
DREAMWEAVER CS3
User Guide
338
Set the page title
There is only one title property: the title of the page. The title appears in the title bar of the Document window in
Dreamweaveraswellasinthebrowser’stitlebarwhenyouviewthepageinmostbrowsers.Thetitlealsoappearsin
the Document window toolbar.
Specify the title in the Document window
❖Enter the title in the Title text box in the Document window toolbar.
Specify the title in the head content
1Select View > Head Content.
2Select the Title marker that appears at the top of the Document window.
3Specify the page title in the Property inspector.
Specify keywords for the page
Many search-engine robots (programs that automatically browse the web gathering information for search engines
to index) read the contents of the Keywords meta tag and use the information to index your pages in their databases.
Because some search engines limit the number of keywords or characters they index, or ignore all keywords if you
go beyond the limit, it’s a good idea to use just a few well-chosen keywords.
Add a Keywords meta tag
1Select Insert > HTML > Head Tags > Keywords.
2Specify the keywords, separated by commas, in the dialog box that appears.
Edit a Keywords meta tag
1Select View > Head Content.
2Select the Keywords marker that appears at the top of the Document window.
3In the Property inspector, view, modify, or delete keywords. You can also add keywords separated by commas.
Specify descriptions for the page
Many search-engine robots (programs that automatically browse the web gathering information for search engines
to index) read the contents of the Description meta tag. Some use the information to index your pages in their
databases, and some also display the information on the search results page (instead of displaying the first few lines
of your document). Some search engines limit the number of characters they index, so it’s a good idea to limit your
description to a few words (for example, PorkbarbecuecateringinAlbany,Georgia, or webdesignatreason-
ableratesforclientsworldwide).
Add a Description meta tag
1Select Insert > HTML > Head Tags > Description.
2Enter descriptive text in the dialog box that appears.
Edit a Description meta tag
1Select View > Head Content.
2Select the Description marker that appears at the top of the Document window.
September 4, 2007
DREAMWEAVER CS3
User Guide
339
3In the Property inspector, view, modify, or delete the descriptive text.
Set the refresh properties of the page
Use the Refresh element to specify that the browser should automatically refresh your page—by reloading the
current page or going to a different one—after a certain amount of time. This element is often used to redirect users
from one URL to another, often after displaying a text message that the URL has changed.
Add a Refresh meta tag
1Select Insert > HTML > Head Tags > Refresh.
2Set the Refresh meta tag properties in the dialog box that appears.
Edit a Refresh meta tag
1Select View > Head Content.
2Select the Refresh marker that appears at the top of the Document window.
3In the Property inspector, set the Refresh meta tag properties.
Set the Refresh meta tag properties
❖Specify the Refresh meta tag properties as follows:
Delay The time in seconds to wait before the browser refreshes the page. To make the browser refresh the page
immediately after it finishes loading, enter 0 in this box.
URL or Action Specifies whether the browser should go to a different URL or refresh the current page, after the
specified delay. To make a different URL open (rather than refreshing the current page), click the Browse button,
then browse to and select the page to load.
Set the base URL properties of the page
Use the Base element to set the base URL that all document-relative paths in the page are considered relative to.
Add a Base meta tag
1Select Insert > HTML > Head Tags > Base.
2Specify the Base meta tag properties in the dialog box that appears.
Edit a Base meta tag
1Select View > Head Content.
2Select the Base marker that appears at the top of the Document window.
3In the Property inspector, specify the Base meta tag properties.
Specify the Base meta tag properties
❖Specify the Base meta tag properties as follows:
Href The base URL. Click the Browse button to browse to and select a file, or type a path in the box.
Target Specifies the frame or window in which all linked documents should open. Select one of the frames in the
current frameset, or one of the following reserved names:
•_blank loads the linked document in a new, unnamed browser window.
September 4, 2007
DREAMWEAVER CS3
User Guide
340
•_parent loads the linked document into the parent frameset or window of the frame that contains the link. If the
frame containing the link is not nested, then this is equivalent to _top; the linked document loads into the full
browser window.
•_self loads the linked document in the same frame or window as the link. This target is the default, so you usually
don’t have to specify it.
•_top loads the linked document in the full browser window, thereby removing all frames.
Set the link properties of the page
Use the link tag to define a relationship between the current document and another file.
Note: The link tag in the head section is not the same thing as an HTML link between documents in the body section.
Add a Link meta tag
1Select Insert > HTML > Head Tags > Link.
2Specify the Link meta tag properties in the dialog box that appears.
Edit a Link meta tag
1Select View > Head Content.
2Select the Link marker that appears at the top of the Document window.
3In the Property inspector, specify the Link meta tag properties.
Specify the Link meta tag properties
❖Set the Link meta tag properties as follows:
Href The URL of the file that you are defining a relationship to. Click the Browse button to browse to and select a
file, or type a path in the box. Note that this attribute does not indicate a file that you’re linking to in the usual HTML
sense; the relationships specified in a Link element are more complex.
ID Specifies a unique identifier for the link.
Title Describes the relationship. This attribute has special relevance for linked style sheets; for more information, see
the External Style Sheets section of the HTML 4.0 specification on the World Wide Web Consortium website at
www.w3.org/TR/REC-html40/present/styles.html#style-external.
Rel Specifies the relationship between the current document and the document in the Href box. Possible values
include Alternate,Stylesheet,Start,Next,Prev,Contents,Index,Glossary,Copyright,Chapter,
Section,Subsection,Appendix,Help,andBookmark.Tospecifymorethanonerelationship,separatevalueswith
a space.
Rev Specifies a reverse relationship (the opposite of Rel) between the current document and the document in the
Href box. Possible values are the same as those for Rel.
Working with server-side includes
About server-side includes
You can use Dreamweaver to insert server-side includes in your pages, edit the includes, or preview pages containing
includes.
September 4, 2007
DREAMWEAVER CS3
User Guide
341
A server-side include is a file that the server incorporates into your document when a browser requests your
document from the server.
When a visitor’s browser requests the document that contains the include instruction, your server processes the
include instruction and creates a new document in which the include instruction is replaced by the contents of the
included file. The server then sends this new document to the visitor’s browser. When you open a local document
directly in a browser, however, there’s no server to process the include instructions in that document, so the browser
opensthedocumentwithoutprocessingthoseinstructions,andthefilethat’ssupposedtobeincludeddoesn’tappear
in the browser. Thus, it can be difficult, without using Dreamweaver, to look at local files and see them as they’ll
appear to visitors after you’ve put them on the server.
With Dreamweaver you can preview documents just as they’ll appear after they’re on the server, both in the Design
view and when you use the Preview in Browser feature. To do so, however, you must make sure you are previewing
the file that contains the include as a temporary file. (Select Edit > Preferences, select the Preview in Browser
category, and make sure the Preview using temporary file option is selected.)
Note: If you are using a testing server, such as Apache or Microsoft IIS, to preview your files on your local drive, you do
not need to preview the file as a temporary file because the server does the processing for you.
Placing a server-side include in a document inserts a reference to an external file; it doesn’t insert the contents of the
specified file in the current document. The contents of the specified file should only contain the content that you
want to include. That is, the include file should not contain any head tags, body tags, or html tags (meaing the
<html> tag—formatting HTML tags, such as p tags, div tags, and so on, are fine). If it does, these tags will conflict
with the tags in the original document, and Dreamweaver won’t display the page properly.
You cannot edit the included file directly in a document. To edit the contents of a server-side include, you must
directly edit the file that you’re including. Any changes to the external file are automatically reflected in every
document that includes it.
There are two types of server-side includes: Virtual and File. Dreamweaver inserts File type includes by default, but
you can use the Property inspector to select the one that is appropriate for the type of web server you use:
•If your server is an Apache web server, select Virtual. In Apache, Virtual works in all cases, while File works only
in some cases.
•If your server is a Microsoft Internet Information Server (IIS), select File. (Virtual works with IIS only in certain
circumstances.)
Note: Unfortunately, IIS won’t let you include a file in a folder above the current folder in the folder hierarchy, unless
special software has been installed on the server. If you must include a file from a folder higher in the folder hierarchy on
an IIS server, ask your system administrator if the necessary software is installed.
•For other kinds of servers, or if you don’t know what kind of server you’re using, ask your system administrator
which option to use.
Some servers are configured to examine all files to see if they contain server-side includes; other servers are
configured to examine only files with a particular file extension, such as .shtml, .shtm, or .inc. If a server-side include
isn’tworkingforyou,askyoursystemadministratorifyouneedtouseaspecialextensioninthenameofthefilethat
uses the include. (For example, if the file is named canoe.html, you may have to rename it to canoe.shtml.) If you
want your files to retain .html or .htm extensions, ask your system administrator to configure the server to examine
all files (not just files with a certain extension) for server-side includes. Parsing a file for server-side includes takes a
little extra time, so pages that the server parses are served a little more slowly than other pages; therefore, some
system administrators won’t provide the option of parsing all files.
September 4, 2007
DREAMWEAVER CS3
User Guide
342
Insert server-side includes
You can use Dreamweaver to insert server-side includes in your page.
Insert a server-side include
1Select Insert > Server-Side Include.
2In the dialog box that appears, browse to and select a file.
By default, a File type of include is inserted.
3Tochangethetypeoftheinclude,selecttheserver-sideincludeintheDocumentwindowandchangethetypein
the Property inspector (Window > Properties), as follows:
•If your server is an Apache web server, select Virtual. In Apache, Virtual works in all cases, while File works only
in some cases.
•If your server is a Microsoft Internet Information Server (IIS), select File. (Virtual works with IIS only in certain
specific circumstances.)
Note: Unfortunately, IIS won’t allow you to include a file in a folder above the current folder in the folder hierarchy,
unless special software has been installed on the server. If you need to include a file from a folder higher in the folder
hierarchy on an IIS server, ask your system administrator if the necessary software is installed.
•For other kinds of servers, or if you don’t know what kind of server you’re using, ask your system administrator
which option to use.
Change which file is included
1Select the server-side include in the Document window.
2Open the Property inspector (Window > Properties).
3Do one of the following:
•Click the folder icon and browse to and select a new file to include.
•In the box, type the path and filename of the new file to include.
Edit the contents of server-side includes
You can use Dreamweaver to edit server-side includes. To edit the content associated with the included file, you must
open the file.
1Select the server-side include in either Design view or Code view, and click Edit in the Property inspector.
The included file opens in a new Document window.
2Edit the file, and then save it.
The changes are immediately reflected in the current document and in any subsequent document you open that
includes the file.
3Upload the include file to the remote site if necessary.
September 4, 2007
DREAMWEAVER CS3
User Guide
343
Managing tag libraries
About Dreamweaver tag libraries
Atag library, in Dreamweaver, is a collection of tags of a particular type, along with information about how
Dreamweaver should format the tags. Tag libraries provide the information about tags that Dreamweaver uses for
code hints, target browser checks, the Tag Chooser, and other coding capabilities. Using the Tag Library editor, you
can add and delete tag libraries, tags, attributes, and attribute values; set properties for a tag library, including format
(for easy identification in the code); and edit tags and attributes.
See also
“Importing custom tags into Dreamweaver” on page 345
“Customizing the coding environment” on page 308
Open and close the Tag Library editor
1Select Edit >Tag Libraries to open the Tag library editor.
The Tag Library Editor dialog box appears. (The options of this dialog box change depending on the selected tag.)
2Close the Tag Library editor in one of the following ways:
•To save changes, click OK.
•To close the editor without saving changes, click Cancel.
Note: WhenyouclickCancel,allchangesyou’vemadeintheTagLibraryeditorarediscarded.Ifyoudeletedatagortag
library, it’s restored.
Add libraries, tags, and attributes
You can use the Tag Library editor to add tag libraries, tags, and attributes to the tag libraries in Dreamweaver.
See also
“Customizing the coding environment” on page 308
“Importing custom tags into Dreamweaver” on page 345
Add a tag library
1In the Tag Library editor (Edit > Tag Libraries), click the Plus (+) button, and select New Tag Library.
2In the Library Name box, type a name (for example, Miscellaneous Tags), and click OK.
Add tags to a tag library
1In the Tag Library editor (Edit > Tag Libraries), click the Plus (+) button and select New Tags.
2Select Tag Library pop-up menu, and select a tag library.
3Type the name of the new tag. To add more than one tag, separate the tags’ names with a comma and a space (for
example: cfgraph, cfgraphdata).
4If the new tags have corresponding end tags (</...>), select Have Matching End Tags.
5Click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
344
Add attributes to a tag
1In the Tag Library editor (Edit > Tag Libraries), click the Plus (+) button and select New Attributes.
2In the Tag Library pop-up menu, select a tag library.
3In the Tag pop-up menu, select a tag.
4Type the name of the new attribute. To add more than one attribute, separate attributes’ names with a comma and
a space (for example: width, height).
5Click OK.
Edit libraries, tags, and attributes
Use the Tag Library editor to set properties for a tag library and edit tags and attributes in a library.
See also
“Customizing the coding environment” on page 308
Set properties for a tag library
1In the Tag Library editor (Edit > Tag Libraries), select a tag library (not a tag) in the Tags list.
Note: The properties for tag libraries appear only when a tag library is selected. Tag libraries are represented by the top-
level folders in the Tags list; for example, the HTML Tags folder represents a tag library, while the abbr folder within the
HTML Tags folder represents a tag.
2In the Used In list, select every document type that should use the tag library.
The document types you select here determine which document types provide code hints for the given tag library.
For example, if the HTML option is not selected for a given tag library, code hints for that tag library don’t appear in
HTML files.
3(Optional) Enter the prefix for the tags in the Tag Prefix box.
Note: A prefix is used to identify a tag in the code as part of a particular tag library. Some tag libraries don’t use prefixes.
4Click OK.
Edit a tag in a tag library
1In the Tag Library editor (Edit > Tag Libraries), expand a tag library in the Tags list and select a tag.
2Set any of the following Tag Format options:
Line Breaks Specifies where Dreamweaver inserts line breaks for a tag.
Contents Specifies how Dreamweaver inserts the contents of a tag; that is, if it applies line break, formatting, and
indentation rules to the content.
Case Specifies the case for a specific tag. Select from Default, Lowercase, Uppercase, or Mixed Case. If you select
Mixed Case, the Tag Name Mixed Case dialog box appears. Type the tag with the case Dreamweaver should use when
inserting it (for example, getProperty) and click OK.
Set Default Sets the default case for all tags. In the Default Tag Case dialog box that appears, select <UPPERCASE>
or <lowercase>, and click OK.
You might want to set your default case to be lowercase to comply with XML and XHTML standards.
September 4, 2007
DREAMWEAVER CS3
User Guide
345
Edit an attribute for a tag
1In the Tag Library editor (Edit > Tag Libraries), expand a tag library in the Tags box, expand a tag, and select a tag
attribute.
2In the Attribute Case pop-up menu, select the Default, Lowercase, Uppercase, or Mixed Case option.
If you select Mixed Case, the Attribute Name Mixed Case dialog box appears. Type the attribute with the case
Dreamweaver should use when inserting it (for example, onClick), and click OK.
Click the Set Default link to set the default case for all attribute names.
3In the Attribute Type pop-up menu, select the type of the attribute.
If you select Enumerated, type every allowed value for the attribute in the Values box. Separate the values with
commas, but no spaces. For example, the enumerated values of the showborder attribute of the cfchart tag are
listed as yes,no.
Delete libraries, tags, and attributes
1In the Tag Library editor (Edit > Tag Libraries), select a tag library, tag, or attribute in the Tags box.
2Click the Minus (–) button.
3Click OK to permanently delete the item.
The item is removed from the Tags box.
4Click OK to close the Tag Library editor and complete the deletion.
See also
“Customizing the coding environment” on page 308
Importing custom tags into Dreamweaver
About importing custom tags into Dreamweaver
You can import custom tags into Dreamweaver so that they become an integral part of the authoring environment.
For example, when you start typing an imported custom tag in Code view, a code hints menu appears, listing the tag’s
attributes and letting you select one.
Import tags from XML files
You can import tags from an XML Document Type Definition (DTD) file or a schema.
1Open the Tag Library editor (Edit > Tag Libraries).
2Click the Plus (+) button and select DTD Schema > Import XML DTD or Schema File.
3Enter the filename or URL of the DTD or schema file.
4Enter the prefix to be used with the tags.
Note: A prefix is used to identify a tag in the code as part of a particular tag library. Some tag libraries don’t use prefixes.
5Click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
346
Import custom ASP.NET tags
You can import custom ASP.NET tags into Dreamweaver.
Before you begin, make sure that the custom tag is installed on the testing server defined in the Site Definition dialog
box (see “Set up a testing server” on page 48). Compiled tags (DLL files) must be placed in the site root’s /bin folder.
Noncompiled tags (ASCX files) can reside in any virtual directory or subdirectory on the server. For more infor-
mation, see the Microsoft ASP.NET documentation.
1Open an ASP.NET page in Dreamweaver.
2Open the Tag Library editor (Edit > Tag Libraries).
3Click the Plus (+) button, select one of the following options, and click OK:
•To import all the ASP.NET custom tags from the application server, select ASP.NET > Import All ASP.NET
Custom Tags.
•To import only certain custom tags from the application server, select ASP.NET > Import Selected ASP.NET
Custom Tags. Control-click (Windows) or Command-click (Macintosh) tags from the list.
Import JSP tags from a file or server (web.xml)
Import a JSP tag library into Dreamweaver from a variety of file types or a JSP server.
1Open a JSP page in Dreamweaver.
2Open the Tag Library editor (Edit > Tag Libraries).
3Click the Plus (+) button, and select JSP > Import From File (*.tld, *.jar, *.zip), or JSP > Import from Server
(web.xml.)
4Click the Browse button or enter a filename for the file that contains the tag library.
5Enter a URI to identify the tag library.
The URI (Uniform Resource Identifier) often consists of the URL of the organization maintaining the tag library.
The URL is not used to view the organization’s website; it is used to uniquely identify the tag library.
6(Optional) Enter the prefix to be used with the tags. Some tag libraries use a prefix to identify a tag in the code as
part of a particular tag library.
7Click OK.
Import JRun tags
If you use Macromedia® JRun™ from Adobe, you can import your JRun tags into Dreamweaver.
1Open a JSP page in Dreamweaver.
2Open the Tag Library editor (Edit > Tag Libraries).
3Click the Plus (+) button and select JSP > Import JRun Server Tags From Folder.
4Enter a folder name for the folder that contains the JRun tags.
5Enter a URI to identify the tag library.
The URI (Uniform Resource Identifier) often consists of the URL of the organization maintaining the tag library.
The URL is not used to view the organization’s website; it is used to uniquely identify the tag library.
6(Optional) Enter the prefix to be used with the tags. Some tag libraries use a prefix to identify a tag in the code as
part of a particular tag library.
7Click OK.
September 4, 2007
347
Chapter 12: Adding JavaScript behaviors
You can use the built-in behaviors to enhance the look, functionality, and appeal of your website. You can attach these
behaviors to elements on your web pages without having to know JavaScript.
Using JavaScript behaviors
About JavaScript behaviors
Adobe® Dreamweaver® CS3 behaviors place JavaScript code in documents so that visitors can change a web page in
various ways or initiate certain tasks. A behavior is a combination of an event and an action triggered by that event.
In the Behaviors panel, you add a behavior to a page by specifying an action and then specifying the event that
triggers that action.
Note: Behavior code is client-side JavaScript code; that is, it runs in browsers, not on servers.
Events are, effectively, messages generated by browsers indicating that a visitor to your page has done something. For
example, when a visitor moves the pointer over a link, the browser generates an onMouseOver event for that link; the
browser then checks whether it should call some JavaScript code (specified in the page being viewed) in response.
Different events are defined for different page elements; for example, in most browsers onMouseOver and onClick
are events associated with links, whereas onLoad is an event associated with images and with the body section of the
document.
An action is pre-written JavaScript code for performing a task, such as opening a browser window, showing or hiding
an AP element, playing a sound, or stopping an Adobe Shockwave movie. The actions provided with Dreamweaver
provide maximum cross-browser compatibility.
After you attach a behavior to a page element, the behavior calls the action (JavaScript code) associated with an event
whenever that event occurs for that element. (The events that you can use to trigger a given action vary from browser
to browser.) For example, if you attach the Popup Message action to a link and specify that it will be triggered by the
onMouseOver event, then your message pops up whenever someone places the pointer over that link.
A single event can trigger several different actions, and you can specify the order in which those actions occur.
Dreamweaver provides about two dozen actions; additional actions can be found on the Exchange website at
www.adobe.com/go/dreamweaver_exchange as well as on third-party developer sites. You can write your own
actions if you are proficient in JavaScript.
Note: The terms behavior and action are Dreamweaver terms, not HTML terms. From the browser’s point of view, an
action is just like any other piece of JavaScript code.
Behaviors panel overview
You use the Behaviors panel (Window > Behaviors) to attach behaviors to page elements (more specifically to tags)
and to modify parameters of previously attached behaviors.
Behaviors that have already been attached to the currently selected page element appear in the behavior list (the main
areaofthepanel),listedalphabeticallybyevent.Ifseveralactionsarelistedforthesameevent,theywillbeexecuted
in the order in which they appear on the list. If no behaviors appear in the behavior list, no behaviors have been
attached to the currently selected element.
September 4, 2007
DREAMWEAVER CS3
User Guide
348
The Behaviors panel has the following options:
Show Set Events Displays only those events that have been attached to the current document. Events are organized
into client-side and server-side categories. Each category’s events are in a collapsible list. Show Set Events is the
default view.
Show All Events Displays an alphabetical list of all events for a given category.
Add Action (+) Displays a menu of actions that can be attached to the currently selected element. When you select
an action from this list, a dialog box appears in which you can specify parameters for the action. If all the actions are
dimmed, no events can be generated by the selected element.
Delete (–) Removes the selected event and action from the behavior list.
Up and down arrow buttons Move the selected action up or down in the behavior list for a particular event. You can
change the order of actions only for a particular event—for example, you can change the order in which several
actions occur for the onLoad event, but all the onLoad actions stay together in the behavior list. The arrow buttons
are disabled for actions that can’t be moved up or down in the list.
Events Displays a pop-up menu, visible only when an event is selected, of all the events that can trigger the action
(this menu appears when you click the arrow button next to the selected event name). Different events appear
depending on the object selected. If the events you expect don’t appear, make sure that the correct page element or
tag is selected. (To select a specific tag, use the tag selector at the lower-left corner of the Document window.) Also
make sure that you selected the correct browser or browsers in the Show Events For submenu.
Note: Event names in parentheses are available only for links; selecting one of these event names automatically adds a
null link to the selected page element, and attaches the behavior to that link instead of to the element itself. The null link
is specified as href="javascript:;" in the HTML code.
Show Events For Specifies the browsers in which the current behavior should work (this is the submenu in the
Events menu). The selection you make from this menu determines which events appear in the Events menu. Older
browsers generally support fewer events than newer browsers, and in most cases, the more general your choice of
target browsers, the fewer events are shown. For example, if you select 3.0 and Later Browsers, the only events you
can select are those available in Netscape Navigator and Microsoft Internet Explorer versions 3.0 and later—a very
limited list of events.
About events
Each browser provides a set of events that you can associate with the actions listed in the Behavior panel’s Actions
(+) menu. When a visitor to your web page interacts with the page—for example, by clicking an image—the browser
generates events; those events can be used to call JavaScript functions that perform an action. Dreamweaver supplies
many common actions that you can trigger with these events.
For names and descriptions of the events provided by each browser, see the Dreamweaver Support Center at
www.adobe.com/go/dreamweaver_support.
Different events appear in the Events menu depending on the selected object and on the browsers specified in the
Show Events For submenu. To find out what events a given browser supports for a given page element, insert the page
element in your document and attach a behavior to it, then look at the Events menu in the Behaviors panel. (By
default, events are drawn from the HTML 4.01 events list, and are supported by most modern browsers.) Events may
be disabled (dimmed) if the relevant objects do not yet exist on the page or if the selected object cannot receive
events. If the expected events don’t appear, make sure the correct object is selected, or change the target browsers in
the Show Events For submenu.
September 4, 2007
DREAMWEAVER CS3
User Guide
349
If you’re attaching a behavior to an image, some events (such as onMouseOver) appear in parentheses. These events
are available only for links. When you select one of them, Dreamweaver wraps an <a> tag around the image to define
a null link. The null link is represented by javascript:; in the Property inspector’s Link box. You can change the
link value if you want to turn it into a real link to another page, but if you delete the JavaScript link without replacing
it with another link, you will remove the behavior.
To see which tags you can use with a given event in a given browser, search for the event in one of the files in the
Dreamweaver/Configuration/Behaviors/Events folder.
Apply a behavior
You can attach behaviors to the entire document (that is, to the <body> tag) or to links, images, form elements, and
several other HTML elements.
The target browser you select determines which events are supported for a given element.
You can specify more than one action for each event. Actions occur in the order in which they’re listed in the Actions
column of the Behaviors panel, but you can change that order.
1Select an element on the page, such as an image or a link.
To attach a behavior to the entire page, click the <body> tag in the tag selector at the lower-left corner of the
Document window.
2Choose Window > Behaviors.
3Click the Plus (+) button and select an action from the Actions menu.
Actions that are dimmed in the menu can’t be chosen. They may be dimmed because a required object doesn’t exist
in the current document. For example, the Control Shockwave or Flash action is dimmed if the document contains
no Shockwave or Flash SWF files.
When you select an action, a dialog box appears, displaying parameters and instructions for the action.
4Enter parameters for the action, and click OK.
All actions provided in Dreamweaver work in modern browsers. Some actions do not work in older browsers, but
they will not cause errors.
Note: Targeted elements require a unique ID. For example, if you want to apply the Swap Image behavior to an image, the
image requires an ID. If you don’t have an ID specified for the element, Dreamweaver automatically specifies one for you.
5ThedefaulteventtotriggertheactionappearsintheEventscolumn.Ifthisisnotthetriggereventyouwant,select
another event from the Events pop-up menu. (To open the Events menu, select an event or action in the Behaviors
panel, and click the downward-pointing black arrow that appears between the event name and the action name.)
Change or delete a behavior
After attaching a behavior, you can change the event that triggers the action, add or remove actions, and change
parameters for actions.
1Select an object with a behavior attached.
2Choose Window > Behaviors.
3Make your changes:
•To edit an action’s parameters, double-click its name, or select it and press Enter (Windows) or Return
(Macintosh); then change parameters in the dialog box and click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
350
•To change the order of actions for a given event, select an action and click the Up or Down arrow. Alternatively,
you can select the action and cut and paste it into the desired location among the other actions.
•To delete a behavior, select it and click the Minus (–) button or press Delete.
Update a behavior
1Select an element that has the behavior attached to it.
2Choose Window > Behaviors and double-click the behavior.
3Make your changes and click OK in the behavior’s dialog box.
All occurrences of that behavior in that page are updated. If other pages on your site have that behavior, you must
update them page by page.
Download and install third-party behaviors
Many extensions are available on the Exchange for Dreamweaver website
(www.adobe.com/go/dreamweaver_exchange).
1Choose Window > Behaviors and select Get More Behaviors from the Actions menu.
Your primary browser opens, and the Exchange site appears.
2Browse or search for packages.
3Download and install the extension package you want.
For more information, see “Add and manage extensions in Dreamweaver” on page 710.
See also
“Add and manage extensions in Dreamweaver” on page 710
Applying built-in Dreamweaver behaviors
Using built-in behaviors
The behaviors included with Dreamweaver have been written to work in modern browsers. The behaviors fail
silently in older browsers.
Note: The Dreamweaver actions have been carefully written to work in as many browsers as possible. If you remove code
from a Dreamweaver action by hand, or replace it with your own code, you may lose cross-browser compatibility.
Although the Dreamweaver actions were written to maximize cross-browser compatibility, some browsers do not
support JavaScript at all, and many people who browse the web keep JavaScript turned off in their browsers. For best
cross-platform results, provide alternative interfaces enclosed in <noscript> tags so that people without JavaScript
can use your site.
Apply the Call JavaScript behavior
The Call JavaScript behavior executes a custom function or line of JavaScript code when an event occurs. (You can
write the script yourself, or you can use code provided by various freely available JavaScript libraries on the web.)
1Select an object and choose Call JavaScript from the Actions menu of the Behaviors panel.
September 4, 2007
DREAMWEAVER CS3
User Guide
351
2Type the exact JavaScript to be executed, or type the name of a function.
For example, to create a Back button, you might type if (history.length > 0){history.back()}.Ifyouhave
encapsulated your code in a function, type only the function name (for example, hGoBack()).
3Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
Apply the Change Property behavior
UsetheChangePropertybehaviortochangethevalueofoneofanobject’sproperties(forexample,thebackground
color of a div or the action of a form).
Note: Use this behavior only if you are very familiar with HTML and JavaScript.
1Select an object and choose Change Property from the Actions menu of the Behaviors panel.
2From the Type Of Element menu, select an element type to display all the identified elements of that type.
3Select an element from the Element ID menu.
4Select a property from the Property menu, or enter the name of the property in the box.
5Enter the new value for the new property in the New Value field.
6Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
Apply the Check Browser behavior
Note: This behavior is deprecated as of Dreamweaver 9. To access it, you must select the ~Deprecated menu item from
the Actions menu of the Behaviors panel.
Use the Check Browser behavior to send visitors to different pages depending on their browser brands and versions.
For example, you may want to send visitors using Netscape Navigator 4.0 to a different page than visitors using
Internet Explorer 4.0.
It’s useful to attach this behavior to the <body> tag of a page that is compatible with practically any browser (and that
does not use any other JavaScript); this way, visitors who come to the page with JavaScript turned off will still see
something.
Another option is to attach this behavior to a null link (such as <a href="javascript:;">) and have the action
determine the link’s destination based on the visitor’s browser brand and version.
1Select an object and choose ~Deprecated > Check Browser from the Actions menu of the Behaviors panel.
2Determine how you want to separate your visitors: by browser brand, by browser version, or both.
3Specify a version of Netscape Navigator.
4In the adjacent pop-up menus, select destination options (Go To URL, Go To Alt URL, or Stay On This Page.)
Here, you specify what to do if the browser is the Netscape Navigator version you specified or later and what to do
otherwise.
5Specify a version of Internet Explorer and select destination options as you did in step 4.
6Select an option from the Other Browsers menu to specify what to do if the browser is neither Netscape Navigator
nor Internet Explorer.
StayOnThisPageisthebestoptionforbrowsersotherthanNetscapeNavigatorandInternetExplorerbecausemost
do not support JavaScript—and if they cannot read this behavior, they will stay on the page anyway.
September 4, 2007
DREAMWEAVER CS3
User Guide
352
7Enter the paths and filenames of the URL and the alternate URL in the boxes at the bottom of the dialog box. If
you enter a remote URL, you must enter the http:// prefix in addition to the www address.
8Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
Apply the Check Plugin behavior
Use the Check Plugin behavior to send visitors to different pages depending on whether they have the specified
plug-in installed. For example, you might want visitors to go to one page if they have Shockwave and another page
if they do not.
Note: You cannot detect specific plug-ins in Internet Explorer using JavaScript. However, selecting Flash or Director will
add the appropriate VBScript code to your page to detect those plug-ins in Internet Explorer on Windows. Plug-in
detection is impossible in Internet Explorer on Mac OS.
1Select an object and choose Check Plugin from the Actions menu of the Behaviors panel.
2Select a plug-in from the Plugin menu, or click Enter and type the exact name of the plug-in in the adjacent box.
You must use the exact name of the plug-in as specified in bold on the About Plug-ins page in Netscape Navigator.
(In Windows, select Navigator’s Help > About Plug-ins command; on Mac OS, select About Plug-ins from the Apple
menu.)
3In the If Found, Go To URL box, specify a URL for visitors who have the plug-in.
If you specify a remote URL, you must include the http:// prefix in the address. If you leave the field blank, visitors
will stay on the same page.
4In the Otherwise, Go To URL box, specify an alternative URL for visitors who don’t have the plug-in. If you leave
the field blank, visitors will stay on the same page.
5Specify what to do if plug-in detection is not possible. By default, when detection is impossible, the visitor is sent
to the URL listed in the Otherwise box. To instead send the visitor to the first (If Found) URL, select the option
Always Go To First URL If Detection Is Not Possible. When selected, this option effectively means “assume that the
visitor has the plug-in, unless the browser explicitly indicates that the plug-in is not present.” In general, select this
option if the plug-in content is integral to your page; if not leave it deselected.
Note: This option applies only to Internet Explorer; Netscape Navigator can always detect plug-ins.
6Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
Apply the Control Shockwave Or Flash behavior
Note: This behavior is deprecated as of Dreamweaver 9. To access it, you must select the ~Deprecated menu item from
the Actions menu of the Behaviors panel.
Use the Control Shockwave Or Flash behavior to play, stop, rewind, or go to a frame in a Shockwave or Flash SWF file.
This behavior only affects animations in the main timeline. It will not control animations occurring inside of movie
clips.
1Select Insert > Media > Shockwave or Insert > Media > Flash to insert a Shockwave or Flash SWF file.
2SelectWindow>Propertiesandenteranameforthemovieintheupper-leftboxnexttotheShockwaveorFlash
icon. You must name the movie to control it with this behavior.
3Select the item (for example a Play button) with which to control the Shockwave or Flash SWF file.
September 4, 2007
DREAMWEAVER CS3
User Guide
353
4Choose ~Deprecated > Control Shockwave Or Flash from the Actions menu of the Behaviors panel.
5Select a movie from the Movie menu.
Dreamweaver automatically lists the names of all Shockwave and Flash SWF files in the current document. (Specif-
ically, Dreamweaver lists movies with filenames ending in .dcr, .dir, .swf, or .spl that are in <object> or <embed>
tags.)
6Specify whether to play, stop, rewind, or go to a frame in the movie. The Play option plays the movie starting from
the frame where the behavior occurs.
7Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
If you’re having trouble getting the behavior to work in a browser, consult this tech note:
http://www.adobe.com/go/tn_15431.
Apply the Drag AP Element behavior
The Drag AP Element behavior lets the visitor drag an absolutely positioned (AP) element. Use this behavior to
create puzzles, slider controls, and other movable interface elements.
You can specify in which direction the visitor can drag the AP element (horizontally, vertically, or in any direction),
a target to which the visitor should drag the AP element, whether to snap the AP element to the target if the AP
element is within a certain number of pixels of the target, what to do when the AP element hits the target, and more.
Because the Drag AP Element behavior must be called before the visitor can drag the AP element, you should attach
Drag AP Element to the body object (with the onLoad event).
1Select Insert > Layout Objects > AP Div or click the Draw AP Div button on the Insert bar and draw an AP Div
in the Document window’s Design view.
2Click <body> in the tag selector at the lower-left corner of the Document window.
3Select Drag AP Element from the Actions menu of the Behaviors panel.
If Drag AP Element is unavailable, you probably have an AP element selected.
4In the AP Element pop-up menu, select the AP element.
5Select either Constrained or Unconstrained from the Movement pop-up menu.
Unconstrained movement is appropriate for puzzles and other drag-and-drop games. For slider controls and
moveable scenery such as file drawers, curtains, and mini-blinds, select constrained movement.
6For constrained movement, enter values (in pixels) in the Up, Down, Left, and Right boxes.
Values are relative to the starting position of the AP element. To constrain movement within a rectangular region, enter
positive values in all four boxes. To allow only vertical movement, enter positive values for Up and Down and 0 for Left
and Right. To allow only horizontal movement, enter positive values for Left and Right and 0 for Up and Down.
7Enter values (in pixels) for the drop target in the Left and Top boxes.
The drop target is the spot to which you want the visitor to drag the AP element. An AP element is considered to
have reached the drop target when its left and top coordinates match the values you enter in the Left and Top boxes.
Valuesarerelativetothetopleftcornerofthebrowserwindow.ClickGetCurrentPositiontoautomaticallyfillthe
text boxes with the current position of the AP element.
8Enter a value (in pixels) in the Snap If Within box to determine how close the visitor must get to the drop target
before the AP element snaps to the target.
September 4, 2007
DREAMWEAVER CS3
User Guide
354
Larger values make it easier for the visitor to find the drop target.
9For simple puzzles and scenery manipulation, you can stop here. To define the drag handle for the AP element,
track the movement of the AP element while it is being dragged, and trigger an action when the AP element is
dropped, click the Advanced tab.
10 To specify that the visitor must click a particular area of the AP element to drag the AP element, select Area
within element from the Drag Handle menu; then enter the left and top coordinates and the width and height of the
drag handle.
This option is useful when the image inside the AP element contains an element that suggests dragging, such as a
titlebarordrawerhandle.DonotsetthisoptionifyouwantthevisitortobeabletoclickanywhereintheAPelement
to drag it.
11 Select any While Dragging options that you want to use:
•Select Bring Element To Front if the AP element should move to the front of the stacking order while it is being
dragged. If you select this option, use the pop-up menu to select whether to leave the AP element in front or restore
it to its original position in the stacking order.
•Enter JavaScript code or a function name (for example, monitorAPelement()) in the Call JavaScript box to
repeatedly execute the code or function while the AP element is being dragged. For example, you could write a
function that monitors the coordinates of the AP element and displays hints such as “you’re getting warmer” or
“you’re nowhere near the drop target” in a text box.
12 Enter JavaScript code or a function name (for example, evaluateAPelementPos()) in the second Call
JavaScript box to execute the code or function when the AP element is dropped. Select Only If Snapped if the
JavaScript should be executed only if the AP element has reached the drop target.
13 ClickOKandverifythatthedefaulteventiscorrect.Ifnot,selectanothereventorchangethetargetbrowserin
the Show Events For submenu.
Gathering information about the draggable AP element
When you attach the Drag AP element behavior to an object, Dreamweaver inserts the MM_dragLayer() function
into the head section of your document. (The function retains the old naming convention for AP elements [that is,
“Layer”] so that layers created in previous versions of Dreamweaver will remain editable.) In addition to registering
the AP element as draggable, this function defines three properties for each draggable AP element—MM_LEFTRIGHT,
MM_UPDOWN, and MM_SNAPPED—that you can use in your own JavaScript functions to determine the relative
horizontal position of the AP element, the relative vertical position of the AP element, and whether the AP element
has reached the drop target.
Note: The information provided here is intended for experienced JavaScript programmers only.
For example, the following function displays the value of the MM_UPDOWN property (the current vertical position of
the AP element) in a form field called curPosField. (Form fields are useful for displaying continuously updated
information because they are dynamic—that is, you can change their contents after the page has finished loading.)
function getPos(layerId){
var layerRef = document.getElementById(layerId);
var curVertPos = layerRef.MM_UPDOWN;
document.tracking.curPosField.value = curVertPos;
}
September 4, 2007
DREAMWEAVER CS3
User Guide
355
Instead of displaying the values of MM_UPDOWN or MM_LEFTRIGHT in a form field, you could use those values in a
variety of other ways. For example, you could write a function that displays a message in the form field depending
on how close the value is to the drop zone, or you could call another function to show or hide an AP element
depending on the value.
It is especially useful to read the MM_SNAPPED property when you have several AP elements on the page, all of which
must reach their targets before the visitor can advance to the next page or task. For example, you could write a
function to count how many AP elements have an MM_SNAPPED value of true and call it whenever an AP element is
dropped. When the snapped count reaches the desired number, you could send the visitor to the next page or display
a message of congratulations.
Apply the Go To URL behavior
The Go To URL behavior opens a new page in the current window or in the specified frame. This behavior is useful
for changing the contents of two or more frames with one click.
1Select an object and choose Go To URL from the Actions menu of the Behaviors panel.
2Select a destination for the URL from the Open In list.
The Open In list automatically lists the names of all frames in the current frameset as well as the main window. If
there are no frames, the main window is the only option.
Note: This behavior may produce unexpected results if any frame is named top, blank, self, or parent. Browsers
sometimes mistake these names for reserved target names.
3Click Browse to select a document to open, or enter the path and filename of the document in the URL box.
4Repeat steps 2 and 3 to open additional documents in other frames.
5Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
Apply the Jump Menu behavior
When you create a jump menu by using Insert > Form > Jump Menu, Dreamweaver creates a menu object and
attaches the Jump Menu (or Jump Menu Go) behavior to it. There is usually no need to attach the Jump Menu
behavior to an object by hand.
You can edit an existing jump menu in either of two ways:
•You can edit and rearrange menu items, change the files to jump to, and change the window in which those files
open, by double-clicking an existing Jump Menu behavior in the Behaviors panel.
•You can edit the items in the menu just as you would edit items in any menu, by selecting the menu and using the
List Values button in the Property inspector.
1Create a jump menu object if there isn’t one already in your document.
2Select the object and choose Jump Menu from the Actions menu of the Behaviors panel.
3Make changes as desired in the Jump Menu dialog box and then click OK.
See also
“Jump menus” on page 290
“Insert or change a dynamic HTML form menu” on page 608
September 4, 2007
DREAMWEAVER CS3
User Guide
356
Apply the Jump Menu Go behavior
TheJumpMenuGobehavioriscloselyassociatedwiththeJumpMenubehavior;JumpMenuGoletsyouassociate
a Go button with a jump menu. (Before you use this behavior, a jump menu must already exist in the document.)
Clicking the Go button opens the link that’s selected in the jump menu. A jump menu doesn’t normally need a Go
button; selecting an item from a jump menu generally causes a URL to load without any need for further user action.
But if the visitor selects the same item that’s already chosen in the jump menu, the jump doesn’t occur. In general,
that doesn’t matter, but if the jump menu appears in a frame, and the jump menu items link to pages in other frames,
a Go button is often useful, to allow visitors to re-select an item that’s already selected in the jump menu.
Note: When you use a Go button with a jump menu, the Go button becomes the only mechanism that “jumps” the user
to the URL associated with the selection in the menu. Selecting a menu item in the jump menu no longer re-directs the
user automatically to another page or frame.
1Select an object to use as the Go button (generally a button image), and choose Jump Menu Go from the Actions
menu of the Behaviors panel.
2In the Choose Jump Menu menu, select a menu for the Go button to activate and click OK.
Apply the Open Browser Window behavior
Use the Open Browser Window behavior to open a page in a new window. You can specify the properties of the new
window, including its size, attributes (whether it is resizable, has a menu bar, and so on), and name. For example, you
can use this behavior to open a larger image in a separate window when the visitor clicks a thumbnail image; with
this behavior, you can make the new window the exact size of the image.
If you specify no attributes for the window, it opens at the size and with the attributes of the window from which it
was opened. Specifying any attribute for the window automatically turns off all other attributes that are not explicitly
turned on. For example, if you set no attributes for the window, it might open at 1024 x 768 pixels and have a
navigation bar (showing the Back, Forward, Home and Reload buttons), location toolbar (showing the URL), status
bar (showing status messages, at the bottom), and menu bar (showing File, Edit, View and other menus). If you
explicitly set the width to 640 and the height to 480 and set no other attributes, the window opens at 640 x 480 pixels,
without toolbars.
1Select an object and choose Open Browser Window from the Actions menu of the Behaviors panel.
2Click Browse to select a file, or enter the URL you want to display.
3Set the options for window width and height (in pixels) and for the incorporation of various toolbars, scroll bars,
resize handles, and the like. Give the window a name (use no spaces or special characters) if you want it to be the
target of links or want to control it with JavaScript.
4Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
Apply the Play Sound behavior
You can use the Play Sound behavior to play a sound effect when the pointer moves over a link, to play a music clip
when the page loads, and so on.
Note: Browsers may require additional audio support (such as an audio plug-in) to play sounds. Because different
browsers use different plug-ins, it’s difficult to predict exactly how these effects will sound.
1Select an object and choose Play Sound from the Actions menu of the Behaviors panel.
2Click Browse to select a sound file, or enter the path and filename in the Play Sound box.
September 4, 2007
DREAMWEAVER CS3
User Guide
357
3Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
Apply the Popup Message behavior
The Popup Message behavior displays a JavaScript alert with the message you specify. Because JavaScript alerts have
only one button (OK), use this behavior to give the user information rather than to present a choice.
You can embed any valid JavaScript function call, property, global variable, or other expression in the text. To embed
a JavaScript expression, place it inside braces ({}). To display a brace, precede it with a backslash (\{).
Example:
The URL for this page is {window.location}, and today is {new Date()}.
Note: Thebrowsercontrolstheappearanceofthealert.Ifyouwantmorecontrolovertheappearance,considerusingthe
Open Browser Window behavior.
1Select an object and choose Popup Message from the Actions menu of the Behaviors panel.
2Enter your message in the Message box.
3Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
Apply the Preload Images behavior
ThePreloadImagesbehaviorshortensdisplaytimebycachingimagesthatarenotshownwhenthepagefirstappears
(for instance, images that will be swapped in with behaviors or scripts).
Note: The Swap Image behavior automatically preloads all highlight images when you select the Preload Images option
in the Swap Image dialog box, so you do not need to manually add Preload Images when using Swap Image.
1Select an object and choose Preload Images from the Actions menu of the Behaviors panel.
2Click Browse to select an image file, or enter the path and filename of an image in the Image Source File box.
3Click the Plus (+) button at the top of the dialog box to add the image to the Preload Images list.
4Repeat steps 3 and 4 for all remaining images that you want to preload on the current page.
5To remove an image from the Preload Images list, select it and click the Minus (–) button.
6Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
Apply the Set Nav Bar Image behavior
UsetheSetNavBarImagebehaviortoturnanimageintoanavigationbarimage,ortochangethedisplayandactions
of images in a navigation bar.
Use the Basic tab of the Set Nav Bar Image dialog box to create or update a navigation bar image, to change which
URL is displayed when the user clicks a button in the navigation bar, and to select a different window in which to
display a URL.
Use the Advanced tab of the Set Nav Bar Image dialog box to change the state of other images in a document based
on the current button’s state. By default, clicking an element in a navigation bar automatically causes all other
elements in the navigation bar to return to their Up states; use the Advanced tab if you want to set a different state
for an image when the selected image is in its Down or Over state.
September 4, 2007
DREAMWEAVER CS3
User Guide
358
See also
“Navigation bars” on page 291
Edit a Set Nav Bar Image behavior
1Select an image in the navigation bar, and choose Window > Behaviors.
2In the Actions menu, select the Set Nav Bar Image behavior associated with the event you’re altering.
3In the Basic tab of the Set Nav Bar Image dialog box, select editing options.
Set multiple images for a navigation bar button
1Select an image in the navigation bar to edit, and choose Window > Behaviors.
2In the Actions menu, double-click the Set Nav Bar Image action associated with the event you’re altering.
3Click the Advanced tab of the Set Nav Bar Image dialog box.
4In the When Element Is Displaying menu, select an image state.
•SelectDownImageifyouwanttochangethedisplayofanotherimageafterauserhasclickedtheselectedimage.
•Select Over Image or Over While Down Image if you want to change the display of another image when the
pointer is over the selected image.
5In the Also Set Image list, select another image on the page.
6Click Browse to select the image file to be displayed, or type the path of the image file in the To Image File box.
7If you selected Over Image or Over While Down Image in step 4, you have an additional option. In the If Down,
To Image File box, click Browse to select the image file, or type the path to the image file.
Apply the Set Text Of Frame behavior
The Set Text Of Frame behavior allows you to dynamically set the text of a frame, replacing the content and
formatting of a frame with the content you specify. The content can include any valid HTML code. Use this behavior
to display information dynamically.
Although the Set Text Of Frame behavior replaces the formatting of a frame, you can select Preserve Background
Color to preserve the page background and text color attributes.
You can embed any valid JavaScript function call, property, global variable, or other expression in the text. To embed
a JavaScript expression, place it inside braces ({}). To display a brace, precede it with a backslash (\{).
Example:
The URL for this page is {window.location}, and today is {new Date()}.
1Select an object and choose Set Text > Set Text Of Frame from the Actions menu of the Behaviors panel.
2In the Set Text Of Frame dialog box, select the target frame from the Frame menu.
3Click the Get Current HTML button to copy the current contents of the target frame’s body section.
4Enter a message in the New HTML box.
5Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
September 4, 2007
DREAMWEAVER CS3
User Guide
359
See also
“Create frames and framesets” on page 205
Apply the Set Text Of Container behavior
The Set Text Of Container behavior replaces the content and formatting of an existing container (that is, any element
that can contain text or other elements) on a page with the content you specify. The content can include any valid
HTML source code.
You can embed any valid JavaScript function call, property, global variable, or other expression in the text. To embed
a JavaScript expression, place it inside braces ({}). To display a brace, precede it with a backslash (\{).
Example:
The URL for this page is {window.location}, and today is {new Date()}.
1Select an object and select Set Text > Set Text Of Container from the Actions menu of the Behaviors panel.
2In the Set Text Of Container dialog box, use the Container menu to select the target element.
3Enter the new text or HTML in the New HTML box.
4Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
See also
“Insert an AP Div” on page 152
Apply the Set Text Of Status Bar behavior
The Set Text Of Status Bar behavior shows a message in the status bar at the lower-left corner of the browser window.
For example, you can use this behavior to describe the destination of a link in the status bar instead of showing the
URL associated with it. Visitors often ignore or overlook messages in the status bar (and not all browsers provide full
support for setting the text of the status bar); if your message is important, consider displaying it as a pop-up message
or as the text of an AP element.
Note: If you use the Set Text Of Status Bar behavior in Dreamweaver, the text of the status bar in the browser is not
guaranteed to change because some browsers require special adjustments when changing status bar text. Firefox, for
example, requires that you change an Advanced option that lets JavaScript change status bar text. For more information,
see your browser’s documentation.
You can embed any valid JavaScript function call, property, global variable, or other expression in the text. To embed
a JavaScript expression, place it inside braces ({}). To display a brace, precede it with a backslash (\{).
Example:
The URL for this page is {window.location}, and today is {new Date()}.
1Select an object and choose Set Text > Set Text Of Status Bar from the Actions menu of the Behaviors panel.
2In the Set Text Of Status Bar dialog box, type your message in the Message box.
Keep the message concise. The browser truncates the message if it doesn’t fit in the status bar.
3Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
September 4, 2007
DREAMWEAVER CS3
User Guide
360
Apply the Set Text Of Text Field behavior
The Set Text Of Text Field behavior replaces the content of a form’s text field with the content you specify.
You can embed any valid JavaScript function call, property, global variable, or other expression in the text. To embed
a JavaScript expression, place it inside braces ({}). To display a brace, precede it with a backslash (\{).
Example:
The URL for this page is {window.location}, and today is {new Date()}.
Create a named text field
1Select Insert > Form > Text Field.
If Dreamweaver prompts you to add a form tag, click Yes.
2InthePropertyinspector,typeanameforthetextfield.Makesurethenameisuniqueonthepage(don’tusethe
same name for multiple elements on the same page, even if they’re in different forms).
Apply Set Text Of Text Field
1Select a text field and choose Set Text > Set Text Of Field from the Actions menu of the Behaviors panel.
2Select the target text field from the Text Field menu and enter your new text.
3Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
Apply the Show-Hide Elements behavior
The Show-Hide Elements behavior shows, hides, or restores the default visibility of one or more page elements. This
behavior is useful for displaying information as the user interacts with the page. For example, as the user moves the
pointer over an image of a plant, you could show a page element giving details about the plant’s growing season and
region, how much sun it needs, how large it can grow, and so on. The behavior only shows or hides the pertinent
element—it does not actually remove the element from the flow of the page when it is hidden.
1Select an object and select Show-Hide Elements from the Actions menu of the Behaviors panel.
If Show-Hide Elements is unavailable, you probably have an AP element selected. Because AP elements do not accept
events in both 4.0 browsers, you must select a different object—such as the <body> tag or a link (<a> tag).
2From the Elements list, select the element you want to show or hide and click Show, Hide, or Restore (which
restores the default visibility).
3Repeat step 2 for all remaining elements whose visibility you want to change. (You can change the visibility of
multiple elements with a single behavior.)
4Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
September 4, 2007
DREAMWEAVER CS3
User Guide
361
Apply the Show Pop-Up Menu behavior
Note: This behavior is deprecated as of Dreamweaver 9 in favor of the Spry Menu Bar widget. To access the old Show
Pop-UpMenubehavior,youmustselectthe~DeprecatedmenuitemfromtheActionsmenuoftheBehaviorspanel.You
cannot use the Show Pop-Up Menu behavior to create new pop-up menus; you can only use it to edit existing menus. If
you have no existing pop-up menus (i.e., ones created with Dreamweaver 8 or earlier), the behavior will be grayed out.
To insert horizontal or vertical pop-up menus in Dreamweaver CS3, select Insert > Spry > Spry Menu Bar or click the
Spry Menu Bar icon on the Spry tab of the Insert bar. For more information, see “Working with the Menu Bar widget”
on page 453.
You can use the Show Pop-Up Menu behavior to edit a Dreamweaver pop-up menu or to open and modify a
Fireworks pop-up menu you’ve inserted in a Dreamweaver document.
You set options in the Show Pop-Up Menu dialog box to edit a horizontal or vertical pop-up menu. You can use this
dialog box to set or modify the color, text, and position of a pop-up menu.
Note: You must use the Edit button in the Dreamweaver Property inspector to edit images in a Fireworks image-based
pop-up menu. You can, however, use the Show Pop-Up Menu command to change the text in an image-based pop-up menu.
1Select an object and choose ~Deprecated > Show Pop-Up Menu from the Actions menu of the Behaviors panel.
2Use the following tabs to set options for the pop-up menu:
Contents Set the name, structure, URL, and target of individual menu items.
Appearance Set the appearance of the menu’s Up State and Over State and the font of menu items.
Advanced Set the properties of the menu cells. For example, you can set cell width and height, cell color and border
width, text indention, and the time elapsed between the moment the user moves the pointer over the trigger and the
moment the menu appears.
Position Position the menu relative to the triggering image or link.
See also
“Working with Fireworks” on page 367
Add, remove, and rearrange pop-up menu items
You use the Contents tab in the Show Pop-up Menu dialog box to create menu items. You can also use this tab to
remove existing items or to change the order in which they appear in a menu.
Add pop-up menu items
1In the Contents tab, select the default text (New Item), then enter the name of the pop-up menu item.
2Set additional options, as desired:
•To have the menu item open another file, type the file path in the Link box or click the Folder icon and browse to
the document.
•To set a location in which the document opens, for example in a new window or in a specific frame, select the
location from the Target menu.
Note: If the frame you want to target isn’t in the Target menu, close the Show Pop-Up Menu dialog box, and then in the
Document window select and name the frame.
3Click the Plus (+) button to keep adding menu items.
September 4, 2007
DREAMWEAVER CS3
User Guide
362
When you finish, click OK to accept the default settings or select another Show Pop-Up Menu tab to set additional
options.
Create a submenu item by indenting
❖In the Show Pop-Up Menu list, select the item and click Indent Item. (To remove the indent, click Outdent Item.)
Note: You cannot indent the first item in the list.
Change the order of an item in the menu
❖In the Show Pop-Up Menu list, select the item and click the Up or Down arrow.
Remove an item from the menu
❖In the Show Pop-Up Menu list, select the item and click the Minus (-) button.
Format a pop-up menu
Afteryoucreatethemenuitems,usetheAppearancetaboftheShowPop-UpMenudialogboxtosettheorientation,
font attributes, and button state attributes for the pop-up menu. Look at the preview pane as you set options to see
how they affect appearance.
1To set menu orientation, select Vertical Menu or Horizontal Menu from the pop-up menu at the top of the
Appearance tab.
2Set the text-formatting options:
•IntheFontmenu,selectafontforthemenuitems.Selectafontthatyourvisitorsarelikelytohaveontheirsystems.
•Set the font size, style attributes, and text alignment or justification options for the menu item text.
Note: If the font you want is not in the font list, use the Edit Font List option to add it.
3IntheUpStateandOverStateboxes,usethecolorpickertosetthetextandcellcolorsofthemenuitembuttons.
4When you finish, click OK or select another Show Pop-Up Menu tab to set additional options.
Advanced appearance options
Cell Width and Cell Height Set the width or height, in pixels, of the menu buttons. Cell width is set automatically
based on the widest item. To increase the cell width or height, select Pixels in the pop-up menu and enter a value
larger than the one that appears in the Cell Width or Cell Height box.
Cell Padding Set the number of pixels between a cell’s content and its boundaries.
Cell Spacing Set the number of pixels between adjacent cells.
Text Indent Set the indention, in pixels, of the menu item within the cell.
Menu Delay Set the length of time the menu displays after the user moves the pointer away from the triggering
image or link. Values are in milliseconds, so the default setting, 1000, equals 1 second. For a 3-second delay, type
3000.
Pop-up Borders Determines whether menu items have a border. If you want a border, make sure Show Borders is
selected.
Border Width Set the border’s width, in pixels.
Shadow, Border Color, and Highlight Pick a color for these border options. Shadow and highlight are not reflected
in the preview.
September 4, 2007
DREAMWEAVER CS3
User Guide
363
Position a pop-up menu in a document
Use position options to specify where the pop-up menu appears relative to the triggering image or link. You can also
specify whether the menu disappears when the user moves the pointer away from the trigger.
1In the Show Pop-Up Menu dialog box, click the Position tab.
2Set the location of the pop-up menu in one of these ways:
•Select one of the preset options.
•Specify a location by typing vertical and horizontal coordinates in the X and Y boxes, respectively. The coordinate
origin is the upper-left corner of the menu.
3To hide the pop-up menu when the pointer is not over it, select Hide Menu onMouseOut Event. Otherwise, the
menu stays in view.
4Click OK.
Modify a pop-up menu
The Show Pop-Up Menu behavior allows you to edit or update the contents of a pop-up menu. You can add, delete,
or change menu items, rearrange them, and specify where a menu is positioned relative to the triggering image or link.
Note: This behavior is deprecated as of Dreamweaver 9 in favor of the Spry Menu Bar widget. To access the old Show
Pop-UpMenubehavior,youmustselectthe~DeprecatedmenuitemfromtheActionsmenuoftheBehaviorspanel.You
cannot use the Show Pop-Up Menu behavior to create new pop-up menus; you can only use it to edit existing menus. If
you have no existing pop-up menus (i.e., ones created with Dreamweaver 8 or earlier), the behavior will be grayed out.
To insert horizontal or vertical pop-up menus in Dreamweaver CS3, select Insert > Spry > Spry Menu Bar or click the
Spry Menu Bar icon on the Spry tab of the Insert bar. For more information, see “Working with the Menu Bar widget”
on page 453.
To open an existing HTML-based pop-up menu:
1Select an object and choose ~Deprecated > Show Pop-Up Menu from the Actions menu of the Behaviors panel.
2Make your changes in the dialog box and click OK.
Apply the Swap Image behavior
The Swap Image behavior swaps one image for another by changing the src attribute of the <img> tag. Use this
behavior to create button rollovers and other image effects (including swapping more than one image at a time).
Inserting a rollover image automatically adds a Swap Image behavior to your page.
Note: Because only the src attribute is affected by this behavior, you should swap in an image that has the same dimen-
sions (height and width) as the original. Otherwise, the image you swap in shrinks or expands to fit the dimensions of
the original image.
ThereisalsoaSwapImageRestorebehavior,whichrestoresthelastsetofswappedimagestotheirprevioussource
files. This behavior is automatically added whenever you attach the Swap Image behavior to an object; if you leave
the Restore option selected while attaching Swap Image, you should never need to select the Swap Image Restore
behavior manually.
1Select Insert > Image or click the Image button on the Insert bar to insert an image.
2In the Property inspector, enter a name for the image in the leftmost text box.
It isn’t mandatory to name images; they’re named automatically when you attach the behavior to an object. However,
it is easier to distinguish images in the Swap Image dialog box if you name all the images beforehand.
September 4, 2007
DREAMWEAVER CS3
User Guide
364
3Repeat steps 1 and 2 to insert additional images.
4Select an object (generally the image you’re going to swap) and choose Swap Image from the Actions menu of the
Behaviors panel.
5From the Images list, select the image whose source you want to change.
6Click Browse to select the new image file, or enter the path and filename of the new image in the Set Source To box.
7
Repeat steps 5 and 6 for any additional images you want to change. Use the same Swap Image action for all the
images you want to change at once; otherwise, the corresponding Swap Image Restore action won’t restore all of them.
8Select the Preload Images option to cache the new images when the page is loaded.
This prevents downloading delays when it is time for the images to appear.
9Click OK and verify that the default event is correct. If not, select another event or change the target browser in
the Show Events For submenu.
Apply the Validate Form behavior
TheValidateFormbehaviorchecksthecontentsofspecifiedtextfieldstoensurethattheuserhasenteredthecorrect
type of data. Attach this behavior to individual text fields with the onBlur event to validate the fields as the user is
filling out the form, or attach it to the form with the onSubmit event to evaluate several text fields at once when the
user clicks the Submit button. Attaching this behavior to a form prevents the submission of forms with invalid data.
1Select Insert > Form or click the Form button in the Insert bar to insert a form.
2Select Insert > Form > Text Field or click the Text Field button in the Insert bar to insert a text field.
Repeat this step to insert additional text fields.
3Choose a validation method:
•To validate individual fields as the user fills out the form, select a text field and select Window > Behaviors.
•To validate multiple fields when the user submits the form, click the <form> tag in the tag selector at the lower-
left corner of the Document window and choose Window > Behaviors.
4Select Validate Form from the Actions menu.
5Do one of the following:
•If you are validating individual fields, select the same field that you selected in the Document window from the
Fields list.
•If you are validating multiple fields, select a text field from the Fields list.
6Select the Required option if the field must contain some data.
7Select one of the following Accept options:
Use Anything Checks that a required field contains data; the data can be of any type.
Use E-mail address Checks that the field contains an @ symbol.
Use Number Checks that the field contains only numerals.
Use Number From Checks that the field contains a number in a specific range.
8If you have chosen to validate multiple fields, repeat steps 6 and 7 for any additional fields that you want to
validate.
9Click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
365
If you are validating multiple fields when the user submits the form, the onSubmit event automatically appears in
the Events menu.
10 If you are validating individual fields, check that the default event is onBlur or onChange. If not, select one of
those events.
Both events trigger the Validate Form behavior when the user moves away from the field. The difference is that
onBlur occurs whether or not the user has typed in the field, and onChange occurs only if the user changed the
contents of the field. The onBlur event is preferred if the field is required.
September 4, 2007
366
Chapter 13: Working with other
applications
Adobe® Dreamweaver® CS3 integrates with many Adobe applications, including Flash, Fireworks, Adobe®
Photoshop®, and Adobe® Bridge. You can use other Adobe applications, such as Adobe® Device Central, directly from
the Dreamweaver workspace.
Cross-application integration
About Photoshop, Flash, and Fireworks integration
Photoshop, Fireworks, and Flash are powerful web-development tools for creating and managing graphics and SWF
files. You can tightly integrate Dreamweaver with these tools to simplify your web design workflow.
Note: There is also limited integration with some other applications. For example, you can export an InDesign file as
XHTML and continue working on it in Dreamweaver. For a tutorial on this workflow, see www.adobe.com/go/vid0202.
You can easily insert images and Flash content (SWF files) in a Dreamweaver document. You can also edit an image
or Flash file in its original editor after you insert it in a Dreamweaver document.
Note: To use Dreamweaver in conjunction with these Adobe applications, you must have these applications installed on
your computer.
Product integration is achieved through roundtrip editing, in the case of Fireworks and Flash, and Design Notes.
Roundtrip editing ensures that code updates are transferred correctly between Dreamweaver and these other appli-
cations (for example, to preserve rollover behaviors or links to other files).
Design Notes are small files that allow Dreamweaver to locate the source document for an exported image or Flash
file. When you export files from Fireworks, Flash, or Photoshop directly to a Dreamweaver defined site, Design
Notes containing references to the original PSD, PNG, or Flash authoring file (FLA) are automatically exported to
the site along with the web-ready file (GIF, JPEG, or SWF).
In addition to location information, Design Notes contain other pertinent information about exported files. For
example, when you export a Fireworks table, Fireworks writes a Design Note for each exported image file in the table.
If the exported file contains hotspots or rollovers, the Design Notes include information about the scripts for them.
As part of the export operation, Dreamweaver creates a folder named _notes in the same folder. This folder contains
the Design Notes that Dreamweaver needs to integrate with Photoshop or Fireworks.
Note: In order to use Design Notes, you must make sure they are not disabled for your Dreamweaver site. They are
enabled by default. However, even if they are disabled, when you insert a Photoshop image file, Dreamweaver creates a
Design Note to store the location of the source PSD file.
For a tutorial on Dreamweaver and Fireworks integration, see www.adobe.com/go/vid0188.
For a tutorial on Dreamweaver and Photoshop integration, see www.adobe.com/go/vid0200.
September 4, 2007
DREAMWEAVER CS3
User Guide
367
See also
“About Design Notes” on page 102
“Enable and disable Design Notes for a site” on page 102
Working with Fireworks
Insert a Fireworks image
Dreamweaver and Fireworks recognize and share many of the same file-editing procedures, including changes to
links, image maps, table slices, and more. Together, the two applications provide a streamlined workflow for editing,
optimizing, and placing web graphics files in HTML pages.
You can place a Fireworks exported graphic directly in a Dreamweaver document using the Insert Image command,
or you can create a new Fireworks graphic from a Dreamweaver image placeholder.
1In the Dreamweaver document, place the insertion point where you want the image to appear, then do one of the
following:
•Select Insert > Image.
•In the Common category of the Insert bar, click the Image button or drag it to the document.
2Navigate to the desired Fireworks exported file, and click OK (Windows) or Open (Macintosh).
Note: If the Fireworks file is not in the current Dreamweaver site, a message appears asking whether you want to copy
the file to the root folder. Click Yes.
See also
“About Photoshop, Flash, and Fireworks integration” on page 366
Edit a Fireworks image or table from Dreamweaver
When you open and edit an image or an image slice that is part of a Fireworks table, Dreamweaver starts Fireworks,
which opens the PNG file from which the image or table was exported.
Note: This assumes that Fireworks is set as the primary external image editor for PNG files. Fireworks is often also set
as the default editor for JPEG and GIF files, although you may wish to set Photoshop as the default editor for these file
types.
When the image is part of a Fireworks table, you can open the entire Fireworks table for edits, as long as the <!--fw
table--> comment exists in the HTML code. If the source PNG file was exported from Fireworks to a Dreamweaver
site using the Dreamweaver Style HTML And Images setting, the Fireworks table comment is automatically inserted
in the HTML code.
1In Dreamweaver, open the Property inspector (Window > Properties) if it isn’t already open.
2Click the image or image slice to select it.
When you select an image that was exported from Fireworks, the Property inspector identifies the selection as a
Fireworks image or table and displays the name of the PNG source file.
3To start Fireworks for editing, do one of the following:
•In the Property inspector, click Edit.
September 4, 2007
DREAMWEAVER CS3
User Guide
368
•Hold down Control (Windows) or Command (Macintosh) and double-click the selected image.
•Right-click (Windows) or Control-click (Macintosh) the selected image and select Edit With Fireworks from the
context menu.
Note: IfFireworkscannotlocatethesourcefile,youarepromptedtolocatethePNGsourcefile.Whenyouworkwiththe
Fireworks source file, changes are saved to both the source file and the exported file; otherwise, only the exported file is
updated.
4In Fireworks, edit the source PNG file and click Done.
Fireworks saves the changes in the PNG file, exports the updated image (or HTML and images), and returns focus
to Dreamweaver. In Dreamweaver, the updated image or table appears.
For a tutorial about Dreamweaver and Fireworks integration, see www.adobe.com/go/vid0188.
See also
“Use an external image editor” on page 253
Optimize a Fireworks image from Dreamweaver
You can use Dreamweaver to make quick changes to Fireworks images and animations. From within Dreamweaver,
you can change optimization settings, animation settings, and the size and area of the exported image.
1In Dreamweaver, select the desired image and select Command > Optimize Image.
2Make your edits in the Image Preview dialog box:
•To edit optimization settings, click the Options tab.
•To edit the size and area of the exported image, click the File tab.
3When you finish, click OK.
See also
“Choose image optimization settings” on page 378
Use Fireworks to modify Dreamweaver image placeholders
You can create a placeholder image in a Dreamweaver document and then start Fireworks to design a graphic image
or Fireworks table to replace it.
To create a new image from an image placeholder, you must have both Dreamweaver and Fireworks installed on your
system.
1Make sure you’ve already set Fireworks as the image editor for PNG files.
2In the Document window, click the image placeholder to select it.
3Start Fireworks in Editing From Dreamweaver mode by doing one of the following:
•In the Property inspector, click Create.
•Press Control (Windows) or Command (Macintosh) then double-click the image placeholder.
•Right-click (Windows) or Control-click (Macintosh) the image placeholder, then select Create Image In
Fireworks.
4Use Fireworks options to design the image.
September 4, 2007
DREAMWEAVER CS3
User Guide
369
Fireworks recognizes the following image placeholder settings you may have set while working with the image place-
holder in Dreamweaver: image size (which correlates to Fireworks canvas size), image ID (which Fireworks uses as
the default document name for the source file and export file you create), and text alignment. Fireworks also recog-
nizes links and certain behaviors (such as swap image, pop-up menu, navigation bar, and set text) you attached to
the image placeholder while working in Dreamweaver.
Note: Although Fireworks doesn’t show links you’ve added to an image placeholder, they are preserved. If you draw a
hotspot and add a link in Fireworks, it will not delete the link you added to the image placeholder in Dreamweaver;
however, if you cut out a slice in Fireworks in the new image, Fireworks will delete the link in the Dreamweaver
document when you replace the image placeholder.
Fireworks doesn’t recognize the following image placeholder settings: image alignment, color, Vspace and Hspace,
and maps. They are disabled in the image placeholder Property inspector.
5When you finish, click Done to display the save prompt.
6In the Save In text box, select the folder you defined as your Dreamweaver local site folder.
If you named the image placeholder when you inserted it in the Dreamweaver document, Fireworks populates the
File Name box with that name. You can change the name.
7Click Save to save the PNG file.
The Export dialog box appears. Use this dialog box to export the image as a GIF or JPEG file, or, in the case of sliced
images, as HTML and images.
8For Save In, select the Dreamweaver local site folder.
The Name box automatically displays the name you used for the PNG file. You can change the name.
9For Save As Type, select the type of file or files you want to export; for example, Images Only or HTML And
Images.
10 Click Save to save the exported file.
The file is saved, and focus returns to Dreamweaver. In the Dreamweaver document, the exported file or Fireworks
table replaces the image placeholder.
See also
“Use an external image editor” on page 253
“Insert an image” on page 244
About Fireworks pop-up menus
Fireworks lets you quickly and easily create CSS-based pop-up menus.
In addition to being extensible and fast to download, the pop-up menus you create with Fireworks give you the
following advantages:
•The menu items can be indexed by search engines.
•The menu items can be read by screen readers, making your pages more accessible.
•The code generated by Fireworks complies to standards and can be validated.
You can edit Fireworks pop-up menus with Dreamweaver or with Fireworks, but not both. Changes made in
Dreamweaver are not preserved in Fireworks.
September 4, 2007
DREAMWEAVER CS3
User Guide
370
See also
“Edit Fireworks pop-up menus in Dreamweaver” on page 370
Edit Fireworks pop-up menus in Dreamweaver
You can create a pop-up menu in Fireworks 8 or later and then edit it with Dreamweaver or with Fireworks (using
roundtrip editing), but with not both. If you edit your menus in Dreamweaver and then edit them in Fireworks, you
will lose all your previous edits except for the text content.
If you prefer to edit your menus with Dreamweaver, you can use Fireworks to create the pop-up menu and then use
Dreamweaver exclusively to edit and customize the menu.
If you prefer to edit the menus in Fireworks, you can use the roundtrip editing feature in Dreamweaver, but you
should not edit the menus directly in Dreamweaver.
1In Dreamweaver, select the Fireworks table that contains the pop-up menu, and then click Edit in the Property
inspector.
The source PNG file opens in Fireworks.
2In Fireworks, edit the menu with the Pop-up Menu Editor, and then click Done on the Fireworks toolbar.
Fireworks sends the edited pop-up menu back to Dreamweaver.
If you created a pop-up menu in Fireworks MX 2004 or earlier, you can edit it in Dreamweaver using the Show
Pop-Up Menu dialog box, available from the Behaviors panel.
See also
“About Fireworks pop-up menus” on page 369
Edit a pop-up menu created in Fireworks MX 2004 or earlier
1In Dreamweaver, select the hotspot or image that triggers the pop-up menu.
2In the Behaviors panel (Shift+F3), double-click Show Pop-Up Menu in the Actions list.
3Make your changes in the Pop-Up Menu dialog box and click OK.
See also
“Apply the Show Pop-Up Menu behavior” on page 361
Specify launch-and-edit preferences for Fireworks source files
When you use Fireworks to edit images, the images in your web pages are normally exported by Fireworks from a
source PNG file. When you open an image file in Dreamweaver to edit it, Fireworks automatically opens the source
PNG file, prompting you to locate the PNG file if it cannot be found. If you prefer, you can set preferences in
Fireworks to have Dreamweaver open the inserted image, or you can have Fireworks give you the option of using the
inserted image file or the Fireworks source file every time you open an image in Dreamweaver.
September 4, 2007
DREAMWEAVER CS3
User Guide
371
Note: Dreamweaver recognizes the Fireworks launch-and-edit preferences only in certain cases. Specifically, you must
be opening and optimizing an image that is not part of a Fireworks table and contains a correct Design Notes path to a
source PNG file.
1In Fireworks, select Edit > Preferences (Windows) or Fireworks > Preferences (Macintosh) and then click the
Launch And Edit tab (Windows) or select Launch And Edit from the pop-up menu (Macintosh).
2Specify the preference options to use when editing or optimizing Fireworks images placed in an external appli-
cation:
Always Use Source PNG Automatically opens the Fireworks PNG file that is defined in the Design Note as the source
of the placed image. Updates are made to the source PNG file and its corresponding placed image.
Never Use Source PNG Automatically opens the placed Fireworks image, whether or not a source PNG file exists.
Updates are made to the placed image only.
Ask When Launching Displays a message asking whether to open the source PNG file. You can also specify global
launch-and-edit preferences from this message.
Insert Fireworks HTML code in a Dreamweaver document
From Fireworks, you can use the Export command to export and save optimized images and HTML files to a
location inside a Dreamweaver site folder. You can then insert the file in Dreamweaver. Dreamweaver lets you insert
Fireworks-generated HTML code, complete with associated images, slices, and JavaScript, into a document.
1In Dreamweaver document, place the insertion point where you want to insert the Fireworks HTML code.
2Do one of the following:
•Select Insert > Image Objects > Fireworks HTML.
•In the Common category of the Insert bar, click the Images button and choose Insert Fireworks HTML from the
popup menu.
3Click Browse to select a Fireworks HTML file.
4If you will have no further use for the file, select Delete File After Insertion. Selecting this option has no effect on
the source PNG file associated with the HTML file.
Note: If the HTML file is on a network drive, it is permanently deleted—not moved to the Recycle Bin or Trash.
5Click OK to insert the HTML code, along with its associated images, slices, and JavaScript, into the Dreamweaver
document.
Paste Fireworks HTML code into Dreamweaver
A fast way to place Fireworks-generated images and tables in Dreamweaver is to copy and paste Fireworks HTML
code directly into a Dreamweaver document.
Copy and paste Fireworks HTML code into Dreamweaver
1In Fireworks, select Edit > Copy HTML Code.
2Follow the wizard as it guides you through the settings for exporting your HTML and images. When prompted,
specify your Dreamweaver site folder as the destination for the exported images.
The wizard exports the images to the specified destination and copies the HTML code to the Clipboard.
3In Dreamweaver document, place the insertion point where you want to paste the HTML code, and select Edit >
Paste.
September 4, 2007
DREAMWEAVER CS3
User Guide
372
All HTML and JavaScript code associated with the Fireworks files you exported is copied into the Dreamweaver
document, and all links to images are updated.
Export and paste Fireworks HTML code into Dreamweaver
1In Fireworks, select File > Export.
2Specify your Dreamweaver site folder as the destination for the exported images.
3In the Export pop-up menu, select HTML And Images.
4In the HTML pop-up menu, select Copy To Clipboard, and then click Export.
5IntheDreamweaverdocument,placetheinsertionpointwhereyouwanttopastetheexportedHTMLcode,and
select Edit > Paste Fireworks HTML.
All HTML and JavaScript code associated with the Fireworks files you exported is copied into the Dreamweaver
document, and all links to images are updated.
Update Fireworks HTML code placed in Dreamweaver
In Fireworks, the File > Update HTML command provides an alternative to the launch-and-edit technique for
updating Fireworks files placed in Dreamweaver. With Update HTML, you can edit a source PNG image in
Fireworks and then automatically update any exported HTML code and image files placed in a Dreamweaver
document. This command lets you update Dreamweaver files even when Dreamweaver is not running.
1In Fireworks, open the source PNG file and make your edits.
2Select File > Save.
3In Fireworks, select File > Update HTML.
4Navigate to the Dreamweaver file containing the HTML you want to update, and click Open.
5Navigate to the folder destination where you want to place the updated image files, and click Select (Windows) or
Choose (Macintosh).
Fireworks updates the HTML and JavaScript code in the Dreamweaver document. Fireworks also exports updated
images associated with the HTML and places the images in the specified destination folder.
If Fireworks cannot find matching HTML code to update, it gives you the option of inserting new HTML code into
the Dreamweaver document. Fireworks places the JavaScript section of the new code at the beginning of the
document and places the HTML table or link to the image at the end.
Create a web photo album
You can automatically generate a website that displays a photo album of images located in a given folder.
Dreamweaver uses Fireworks to create a thumbnail image and a larger image for each image in the folder.
Dreamweaver then creates a web page containing all the thumbnails, as well as links to the larger images. To create
a web photo album, you must have both Dreamweaver and Fireworks 4 or later installed on your system.
Before you begin, place all of the images for your photo album in a single folder. (The folder doesn’t need to be in a
site.) In addition, make sure that the image filenames have any of the following extensions: .gif, .jpg, .jpeg, .png, .psd,
.tif, or .tiff. Images with unrecognized file extensions won’t appear in the photo album.
1In Dreamweaver, select Commands > Create Web Photo Album.
2In the Photo Album Title text box, enter a title. The title will appear in a gray rectangle at the top of the page of
thumbnails.
September 4, 2007
DREAMWEAVER CS3
User Guide
373
Fill in the Subheading Info and Other Info text boxes to enter up to two lines of additional text below the title.
3Select the folder containing source images by clicking the Browse button next to the Source Images Folder text
box. Then select (or create) a destination folder in which to place all the exported images and HTML files by clicking
the Browse button next to the Destination Folder text box.
The destination folder should not already contain a photo album—if it does, and if any new images have the same
names as previously used images, you may overwrite existing thumbnail and image files.
4Specify display options for the thumbnail images:
•Select a size for the thumbnail images from the Thumbnail Size menu. Images are scaled proportionally so that
the thumbnails fit within a square of the specified pixel dimensions.
•To display the filename of each original image below its thumbnail, select Show Filenames.
•Enter the number of columns for the table that displays the thumbnails.
5From the Thumbnail Format menu, select one of the GIF (128 or 256 colors) or JPEG (better picture quality or
smaller file size) formats.
6FromthePhotoFormatmenu,selectaGIForJPEGformatforthelargeimages.Itdoesn’thavetobethesameas
the format you specified for the thumbnails.
Note: You can’t use your original image files as the large images, because original image formats other than GIF and
JPEG might not be displayed properly on all browsers. If your original images are JPEG files, the large images may have
larger file sizes or be of lower quality than the original images.
7Select a Scale percentage for the large-size images.
Setting Scale to 100% creates large-size images the same size as the originals. The scale percentage is applied to all
the images; if your original images aren’t all the same size, scaling them by the same percentage may not produce the
desired results.
8Select Create Navigation Page For Each Photo to create an individual web page for each source image, containing
navigation links labeled Back, Home, and Next.
If you select this option, the thumbnails link to the navigation pages. If you don’t select this option, the thumbnails
link directly to the large images.
9Click OK to create the HTML and image files for the web photo album.
Fireworks starts (if it’s not already running) and creates the thumbnails and large images. This may take several
minutes if you have many image files. When the processing is complete, Dreamweaver becomes active again and
creates the page containing the thumbnails.
10 When you see the “Album Created” message, click OK.
You may have to wait a few seconds for your photo album page to appear. The thumbnails appear alphabetically by
filename.
Note: If you click Cancel while Dreamweaver is creating the album, you don’t stop the process. Clicking Cancel merely
prevents Dreamweaver from displaying the main photo album page.
September 4, 2007
DREAMWEAVER CS3
User Guide
374
Working with Photoshop
About Photoshop integration
You can insert Photoshop image files (PSD format) into web pages in Dreamweaver and let Dreamweaver optimize
them as web-ready images (GIF, JPEG, and PNG formats). You can also paste all or part of a multi-layered or multi-
sliced Photoshop image into a web page in Dreamweaver.
Note: If you use this integration feature often, you may want to store your Photoshop images on your website for easier
access. If you do, be sure to cloak them to avoid unnecessary handling between the local site and the remote server.
For a tutorial about working with Dreamweaver and Photoshop, see www.adobe.com/go/vid0200.
See also
“Cloak and uncloak specific file types” on page 100
Working with Photoshop and Dreamweaver
If you use Photoshop to create images, you can use Dreamweaver to optimize your images for the web and insert
them in web pages. You can also select slices or layers in a Photoshop image, and then use Dreamweaver to insert
them as images in web pages. After inserting these images in web pages, you can still edit the source files in
Photoshop and update the corresponding web images in Dreamweaver.
Use the following workflow to insert an image created in Photoshop into a web page:
•In Photoshop, save your image as a regular Photoshop file (PSD). You don't have to convert the image to JPEG,
GIF, or PNG first.
•In Dreamweaver, select the PSD file and insert it into the web page. Dreamweaver lets you optimize the image for
the web, and then inserts it in the page.
Use the following workflow for using a slice or layer in a Photoshop image as an image in a web page:
•In Photoshop, select and copy the slice or layer to the Clipboard.
•InDreamweaver,pastethesliceorlayerintothewebpage.Dreamweaverletsyouoptimizetheimagefortheweb,
and then inserts it in the page.
Use the following workflow for updating web images originally created in Photoshop:
•In Dreamweaver, select the JPEG, GIF, or PNG file that you derived from a PSD file and inserted with
Dreamweaver,andthenclicktheeditimagebuttoninthePropertiespanel.Dreamweaveropensthesourcefilein
Photoshop.
•In Photoshop, make your changes to the source file and save it. Then select all or part of the image and copy it on
the Clipboard.
•In Dreamweaver, paste the image over the web image in the page. Dreamweaver optimizes the source file using
the original optimization settings, and then replaces the image on the Clipboard with the updated version.
For a video tutorial on working with Photoshop and Dreamweaver, see www.adobe.com/go/vid0200.
September 4, 2007
DREAMWEAVER CS3
User Guide
375
See also
“Insert a Photoshop image into your page” on page 375
“Copy a Photoshop selection into your page” on page 375
“Use Photoshop to edit images in Dreamweaver pages” on page 376
Insert a Photoshop image into your page
1In Dreamweaver (Design or Code view), place the insertion point on your page where you want the image
inserted.
2Select Insert > Image.
3Locate your Photoshop PSD image file in the Select Image Source dialog box by clicking the Browse button and
navigating to it.
4In the Image Preview dialog box that appears, adjust optimization settings as needed and click OK.
5Save the web-ready image file to a location within your website’s root folder.
•If you have a default images folder and you save the file to a location outside your root folder, the file is saved to
that location and also copied to your default images folder.
•If you do not have a default images folder and you save the file to a location outside your root folder, Dreamweaver
saves it to that location and also asks if you want a copy of the file saved in your root folder. Typically you will
choose to accept this option. If you cancel at this point, the file is not placed in the Dreamweaver page, but the
web-ready image is saved to the external location you chose.
Dreamweaver defines the image according to the optimization settings and places a web-ready version of your image
in your page. Information about the image, such as the filename and location of the original PSD file, is saved in a
Design Note, regardless of whether you have enabled Design Notes for your site. The Design Note allows you to
return to edit the original Photoshop source file from Dreamweaver.
Note: If you decide later that you want to change the optimization settings for an image placed in your pages, you can
click the Optimize button on the image’s Property inspector and reoptimize the image.
See also
“Dreamweaver and accessibility” on page 704
“Choose image optimization settings” on page 378
Copy a Photoshop selection into your page
You can copy all or some of a Photoshop image and paste the selection into your Dreamweaver page as a web-ready
image. You can copy a single layer or a set of layers for a selected area of the image or you can copy a slice of the image.
1In Photoshop, do one of the following:
•CopyallorpartofasinglelayerbyusingtheMarqueetooltoselecttheportionyouwanttocopy,andthenchoose
Edit > Copy. This copies only the active layer for the selected area into the clipboard. If you have layer-based
effects, they are not copied.
•CopyandmergemultiplelayersbyusingtheMarqueetooltoselecttheportionyouwanttocopy,andthenchoose
Edit > Copy Merged. This flattens and copies all the selected area’s active and lower layers into the clipboard. If
you have layer-based effects associated with any of these layers, they are copied.
September 4, 2007
DREAMWEAVER CS3
User Guide
376
•Copy a slice by using the Slice Select tool to select the slice, and then choose Edit > Copy. This flattens and copies
all the slice’s active and lower layers into the clipboard.
You can choose Select > All to quickly select all of an image for copying.
2In Dreamweaver (Design or Code view), place the insertion point on your page where you want the image
inserted.
3Select Edit > Paste.
4In the Image Preview dialog box, adjust optimization settings as needed and click Export.
5Save the web-ready image file to a location within your website’s root folder.
•If you have a default images folder and you save the file to a location outside your root folder, the file is saved to
that location and also copied to your default images folder.
•If you do not have a default images folder and you save the file to a location outside your root folder, Dreamweaver
saves it to that location and also asks if you want a copy of the file saved in your root folder. Typically you will
choose to accept this option. If you cancel at this point, the file is not placed in the Dreamweaver page, although
the web-ready image is saved to the external location you chose.
Dreamweaver defines the image according to your optimization settings and places a web-ready version of your
image in your page. Information about the image, such as the location of the original PSD source file, is saved in a
Design Note, regardless of whether you have enabled Design Notes for your site. The Design Note allows you to
return to edit the original Photoshop file from Dreamweaver.
For a tutorial on copying and pasting between different applications, including Dreamweaver and Photoshop, see
www.adobe.com/go/vid0193.
See also
“Dreamweaver and accessibility” on page 704
“Choose image optimization settings” on page 378
Use Photoshop to edit images in Dreamweaver pages
After you place Photoshop images in your Dreamweaver pages, you can edit, in Photoshop, either the original PSD
source image or the web-ready JPEG, GIF, or PNG file that was displayed in the page. If you make changes to the
web-ready version of the file, the source PSD file is not updated and the two versions will diverge. It is recommended
that you make your edits to the source PSD file to maintain single sourcing.
Note: Make sure you have Photoshop set as your primary external image editor for the file type you want to edit.
See also
“Edit images in Dreamweaver” on page 247
“Use an external image editor” on page 253
“Choose image optimization settings” on page 378
“Reinsert a Photoshop image from Dreamweaver” on page 377
“Recopy a Photoshop image selection” on page 378
“Visually resize an image” on page 250
September 4, 2007
DREAMWEAVER CS3
User Guide
377
Edit the original PSD source file in Photoshop
1In Dreamweaver, select a web-ready image that was originally created in Photoshop and do one of the following:
•Click the Edit button in the image’s Property inspector.
•Press Control (Windows) or Command (Macintosh) as you double-click the file.
•Right-click (Windows) or Control-click (Macintosh) an image, choose Edit Source With from the context menu,
and then choose Photoshop.
Note: This assumes that Photoshop is set as the primary external image editor for PSD image files. You may also want
to set Photoshop as the default editor for JPEG, GIF, and PNG file types.
2After you edit the file in Photoshop, you can do one of the following to update the image in your page:
•Reinsert the file and redefine optimization settings.
•Paste the image or selection into your page. Dreamweaver uses your existing optimization settings
To reoptimize, click the Optimize button in the Property inspector to open the Image Preview dialog box. If the
image was created in Photoshop, the Photoshop image is reimported and you can reapply optimization settings to it.
If there is no Photoshop PSD file associated with the image, the web-ready image is displayed.
Edit the web-ready image file in Photoshop
1In Dreamweaver, select Edit > Preferences > File Types and define Photoshop as the default editor for JPEG, GIF,
and PNG file types. It is set by default as the primary editor for PSD files.
•To add a new file type, click the plus (+) above the left-hand panel.
•To add or change the external editor for a file type, select that type in the left-hand panel and click the plus (+)
above the right-hand panel. This puts you into the Select External Editor file locator dialog box.
2Select an image that originated in Photoshop and do one of the following:
•Press Alt (Windows) or Option (Macintosh) as you double-click the file.
•Right-click (Windows) or Control-click (Macintosh) the selected image, choose Edit With > Browse from the
context menu, and then locate the Photoshop application file.
•Select Modify > Image > Photoshop.
3After you have edited the file as needed in Photoshop, save the file.
4In Dreamweaver, the file is updated with your revisions, although you may need to reset the image’s size.
You can perform minor editing of your web-ready images, such as cropping or reoptimizing, with the Dreamweaver
image-editing tools in the image’s Property inspector or by using the Modify > Image menu commands. The source
PSD file is not updated with these actions, only the web-ready image.
Reinsert a Photoshop image from Dreamweaver
If you replace a Photoshop-derived image in a Dreamweaver page by inserting a different PSD file, the Image Preview
dialog box reappears and you must reenter optimization settings for the new image.
1In Dreamweaver, select a different Photoshop PSD file in one of the following ways:
•Use the point-to-file icon to grab a different PSD file from the Files panel.
•Double-click an existing image and then browse to a new file.
2From here on, the steps are the same as for inserting a new image: adjusting optimization settings and saving the
file in your site.
September 4, 2007
DREAMWEAVER CS3
User Guide
378
Recopy a Photoshop image selection
If you replace a Photoshop-derived image in your Dreamweaver page with a copied selection from a PSD file, the
Image Preview dialog box does not appear. Instead Dreamweaver reuses the optimization settings you set for that
image in your page.
1In Photoshop, edit an image and copy all or part of it.
2In Dreamweaver, select an existing image.
3Select Edit > Paste.
Choose image optimization settings
The Image Preview dialog box has three sections:
•The Options tab allows you to define which file format to use and set preferences such as color.
•The File tab allows you to set the scale and size of the image.
•The Preview panel allows you to see a version of the image with your settings.
See also
“Optimization settings” on page 379
Choose the image file’s options in the Options tab
1Choose the type of file to use from the Format pop-up menu in the Options tab: JPEG, GIF, or PNG.
2(Optional) Choose other image options settings in the Options tab for the type of file format you have chosen.
(Optional) Review your settings in the Image Preview dialog box
1In the Image Preview dialog box, choose the Preview option if you want to see what the image looks like with your
settings. If performance is an issue, you may want to deselect this option.
2Select one of the saved color palette settings from the pop-up menu if you want to use a preset set of options.
3Use the pointer tool to grab the previewed image and pan it to see different parts.
4Use the crop tool to reduce the image’s size. You may need to first zoom out to see the entire image.
5ChooseavaluefromtheZoompop-upmenutoexpandorreduceyourviewofthepreviewedimage.Youcanalso
choose the Zoom tool to click to zoom in or to Alt-click (Windows) or Option-click (Macintosh) to zoom out.
6You can preview two or four different optimizations by clicking the 2-up or 4-up button at the bottom of the
preview panel and choosing different color palettes for each pane.
7Animation controls do not apply to Photoshop images.
(Optional) Change the image’s scale or export area options on the File tab
1Select the File tab.
2Shrink or expand the image in one of the following ways:
•Specify a scale percentage.
•Enter absolute pixel values for width or height.
3Select Constrain to maintain the image’s original proportions as you rescale it.
September 4, 2007
DREAMWEAVER CS3
User Guide
379
4Change the shape of the placed image by choosing the Export Area option and doing one of the following:
•Dragthedottedborderaroundthepreviewedimageasneeded.Youcandragtheimagewithintheborderstomove
hidden areas into view.
•Enter pixel coordinates for the image’s boundaries.
Export and save the image
1When you have defined all your settings, click OK.
2Youarepromptedtosavethefileinthedefaultimagesfolderifyoudefinedoneforyoursiteorthesite’srootfolder
otherwise. Browse to the location you want and click OK.
To reoptimize, click the Optimize button in the Property inspector and the Image Preview dialog box appears. If the
image was derived from Photoshop, the Photoshop image is reimported and you can reapply optimization settings
to it. If there is no Photoshop PSD file associated with the image, the web-ready image is displayed.
Optimization settings
When you insert an image file or copy part of an image from Photoshop, Dreamweaver displays the Image Preview
dialog box to allow you to define and preview settings for a web-ready version of your image that has the right mix
of color, compression, and quality:
•File format, including image compression options
•(Optional) Color palette adjustments to eliminate colors and reduce file size
•(Optional) Scale or export area for the image
September 4, 2007
DREAMWEAVER CS3
User Guide
380
A web-ready image is one that can be displayed by all modern web browsers and looks the same no matter what
system or browser the viewer is using. When you insert a Photoshop image, the Image Preview dialog box allows you
to adjust various settings for optimal web publication. In general, the settings result in a trade-off between quality
and file size.
Note: Whatever settings you select only affect the exported version of the image file. The original Photoshop PSD file
always remains untouched.
Many image options are available in the Options tab and they vary depending on the file format you choose. Several
sets of GIF and JPEG image options available for your convenience in the Saved Settings pop-up menu of the Image
Preview dialog box.
JPEG image options
You can optimize a JPEG image by setting its compression and smoothing options. You cannot edit its color palette.
Quality Use the slider to increase or decrease the quality of the image. Better quality results in a larger file.
Smoothing Allows you to increase the smoothing as needed. Lower quality images may require a higher value.
Progressive Browser Display Displaysanimageinitiallyatlowresolutionandprogressivelyincreasestheresolution
during download. Not selected by default.
Sharpen Color Edges Allows you to get a higher quality image.
September 4, 2007
DREAMWEAVER CS3
User Guide
381
Matte Allows you to set the image’s background. You can maintain the transparency of a 32-bpc (bits per channel)
PNG by clicking the transparency icon in the Matte dialog box. You can also use Matte to anti-alias soft-edged
objects that lie directly above the canvas by matching the matte color to the target background.
Optimize to Size Specifies the image size, in kilobytes. For 8-bpc images, the wizard attempts to achieve the
requested file size by adjusting the number of colors or dithering.
GIF and PNG image options
In the Options tab, you can set a transparency value for individual colors in GIF and 8-bpc PNG images so that the
background of the web page is visible through areas with those colors. Do this by adjusting the color palette on the
left of the Options tab. PNG images that have 32-bpc format automatically contain transparency, though you won’t
see a transparency option for 32-bpc PNGs in the Optimize panel.
Palette Set to Adaptive by default.
Loss Set to 0 by default. Not applicable to 8-bpc PNG images.
Dither Approximates colors not in the current palette by alternating similar-colored pixels so that they appear to
blend to the missing color. Dithering is especially helpful when exporting images with complex blends or gradients,
or when exporting photographic images to an 8-bpc graphic format such as GIF. Not selected by default.
Note: Dithering can greatly increase file size.
Number Of Colors List Set to 256 by default. The number of colors is dependent on the current behavior of the
palette. For example, the "Web 216" palette only displays 216 colors.
Color Palette The display of colors varies depending on the selected palette behavior and maximum number of
colors.
Palette Tools Click on any pixel in the palette and then click on these icons to change, add, or delete color, or to make
a color transparent, web safe, or locked.
Select Transparency Color Icons Thesebuttonsallowyoutoselect,add,orremoveapalettecolor.Forexample,ifyou
choose the Select Transparency Color option, you can click on any pixel in the palette or on a point of color in the
preview panel to render it transparent.
Transparency Pop-Up Menu Allows you to set index, alpha, or no transparency. A gray-and-white checkerboard on
document previews denotes transparent areas. To see how your choices affect the image, choose 2-up or 4-up in the
image preview and click on an image other than the original.
•Index Use index transparency when exporting GIF images that contain transparent areas. With index trans-
parency, you set specific colors to be transparent upon export. Index transparency turns on or turns off pixels with
specific color values.
•Alpha Use alpha transparency when exporting 8-bpc PNG images that contain transparent areas. Alpha trans-
parency allows gradient transparency and semi-opaque pixels.
Matte Lets you set the image’s background. You can maintain the transparency of a 32-bpc PNG by clicking the
transparency icon in the Matte dialog box. You can also use Matte to anti-alias soft-edged objects that lie directly
above the canvas by matching the matte color to the target background.
Remove Unused Colors Reduces file size by removing colors not used in the image.
Interlaced Browser Display Displays an interlaced image initially at low resolution and progressively increases to full
resolution during download. Not selected by default.
Optimize To Size Lets you specify a size, in kilobytes, for the image. For 8-bpc images, the wizard attempts to achieve
the requested file size by adjusting the number of colors or dithering.
September 4, 2007
DREAMWEAVER CS3
User Guide
382
Saved settings
Dreamweaver provides several option settings for your convenience. Depending on the saved settings you choose,
the file-type-specific image options described above may change.
GIF Web 216 Forces all colors to web-safe colors. The color palette contains up to 216 colors.
GIF Websnap 256 Converts web-unsafe colors to their closest web-safe color. The color palette contains up to a
maximum of 256 colors.
GIF Websnap 128 Converts web-unsafe colors to their closest web-safe color. The color palette contains up to 128
colors.
GIF Adaptive 256 A color palette that contains only the actual colors used in the graphic. The color palette contains
up to a maximum of 256 colors.
JPEG Better Quality Sets quality to 80 and smoothing to 0, resulting in a high-quality but larger graphic..
JPEG Smaller File Sets quality to 60 and smoothing to 2, resulting in a graphic less than half the size of a Better
Quality JPEG but with reduced quality.
Animated GIF Websnap 128 Sets the file format to Animated GIF and converts web-unsafe colors to their closest
web-safe colors. The color palette contains up to 128 colors.
See also
“Choose image optimization settings” on page 378
Working with Flash
Edit a SWF file from Dreamweaver in Flash
If you have both Flash and Dreamweaver installed, you can select a SWF file in a Dreamweaver document and use
Flash to edit it. Flash does not edit the SWF file directly; it edits the source document (FLA file) and re-exports the
SWF file.
1In Dreamweaver, open the Property inspector (Window > Properties).
2In the Dreamweaver document, do one of the following:
•Click the SWF file placeholder to select it; then in the Property inspector click Edit.
•Right-click (Windows) or Control-click (Macintosh) the placeholder for the SWF file, and select Edit With Flash
from the context menu.
Dreamweaver switches the focus to Flash, and Flash attempts to locate the Flash authoring file (FLA) for the selected
SWF file. If Flash cannot locate the Flash authoring file, you are prompted to locate it.
Note: If the FLA file or SWF file is locked, check out the file in Dreamweaver.
3In Flash, edit the FLA file. The Flash Document window indicates that you are modifying the file from within
Dreamweaver.
4When you finish making edits, click Done.
Flash updates the FLA file, re-exports it as a SWF file, closes, and then returns the focus to the Dreamweaver
document.
September 4, 2007
DREAMWEAVER CS3
User Guide
383
Note: To update the SWF file and keep Flash open, in Flash select File > Update for Dreamweaver.
5To view the updated file in the document, click Play in the Dreamweaver Property inspector or press F12 to
preview your page in a browser window.
Update links in a SWF file
You can use Dreamweaver to update a URL link in a Flash (SWF) file, and then update the change in the Flash
authoring document (FLA) file.
1Set up a home page for the site, if you haven’t already done so.
To build a site map, you need to set up a home page. To update a link in a SWF file, you need to display dependent
files in Map view. By default, the site map does not show dependent files, so you must display them.
2Select Map View from the View pop-up menu in the Files panel.
3Toshowdependentfiles,selectViewfromtheOptionsmenuatthetoprightcorneroftheFilespanel;thenselect
Site Map Options > Show Dependent Files.
4In the site map, change the link beneath the SWF file by doing one of the following:
•To change the link in the selected SWF, right-click (Windows) or Control-click (Macintosh) the link, select
Change Link and type the new URL path in the dialog box.
•To update all instances of the link, select Site > Change Link Sitewide. In the Change All Links To text box, browse
to the link you are changing or type its path. In the Into Links To text box, browse to the new URL or type its path.
5Click OK.
Any links updated by Dreamweaver in the SWF file are conveyed to the FLA source document when you start Flash
to edit. Dreamweaver automatically logs any link changes to the SWF file in the Design Notes. When Flash passes
the changes to the FLA file, it removes them from the Design Notes.
See also
“Using site maps” on page 52
“Show or hide site map files” on page 54
Working with Bridge
About Adobe Bridge
Dreamweaver provides seamless integration with Adobe® Bridge, a stand-alone file-browsing application. Adobe
Bridge is a cross-platform application included with Adobe® Creative Suite® 3 components that helps you locate,
organize, and browse the assets you need to create print, web, video, and audio content. You can start Bridge from
any Creative Suite component (except Acrobat 8), and use it to access both Adobe and non-Adobe asset types.
From Adobe Bridge, you can:
•Manage image files: Preview, search, sort, and process files in Bridge without opening individual applications. You
can also edit metadata for files, and use Bridge to place files into your documents, projects, or compositions.
September 4, 2007
DREAMWEAVER CS3
User Guide
384
•Manage your photos: Import and edit photos from your digital camera card, group related photos in stacks, and
open or import camera raw files and edit their settings without starting Photoshop. You can also search leading
stock libraries and download royalty-free images by way of Adobe Stock Photos.
•Work with Adobe Version Cue®-managed assets.
•Perform automated tasks, such as batch commands.
• Synchronize color settings across color-managed Creative Suite components.
For a tutorial on Adobe Bridge and the web development workflow, see www.adobe.com/go/vid0192.
Start Bridge from Dreamweaver
You can start Bridge from Dreamweaver to view your files before placing them or dragging them in your page layout.
❖You can start Bridge in several different ways:
•Select File > Browse In Bridge.
•Click the Browse In Bridge button in the Standard toolbar.
•Press the Browse In Bridge shortcut from the keyboard: Control+Alt+O (Windows) or Command+Option+O
(Macintosh).
Bridge opens in File Browser mode, showing the contents of the last-opened folder in Dreamweaver. If Bridge was
already open, it becomes the active window.
Note: If you don't have Bridge installed, Dreamweaver displays an error message and you will need to install the appli-
cation before you can use these features.
Placing files into Dreamweaver from Bridge
You can insert files into Dreamweaver pages by inserting them or by dragging them from Bridge into your page. The
Dreamweaver document in which you want to insert the file must be open and in Design view to use this feature.
You can insert most file types into your pages, but Dreamweaver handles them differently:
•If you insert a web-ready image (JPEG, GIF, or PNG), Dreamweaver inserts the image files directly into your page
and places a copy in your website’s default images folder.
•If you insert a Photoshop PSD file, you need to define its optimization settings before Dreamweaver can place in
your page.
•If you insert a non-image file, such as mp3, PDF, or a file with an unknown file type, Dreamweaver inserts a link
to the source file.
•If you insert an HTML file, Dreamweaver inserts a link to the source file.
•(Windows only) If you have Microsoft Office installed and you are inserting a Microsoft Word or Excel file, you
must specify if you want to insert the file itself or insert a link to the source file. If you want to insert the file, you
can specify how much of the file’s formatting you want to keep.
See also
“Insert a Photoshop image into your page” on page 375
“Working with Photoshop” on page 374
September 4, 2007
DREAMWEAVER CS3
User Guide
385
Place a Bridge file in your page
1In Dreamweaver (Design view), place the insertion point on your page where you want the file inserted.
2In Bridge, select the file and choose File > Place In Dreamweaver.
3If the file is not in your site's root folder, you are prompted to copy it there.
4If you have set Edit > Preferences > Accessibility to show attributes when inserting images, the Image Tag Acces-
sibility Attributes dialog box is displayed when you insert web-ready images such as JPEG and GIF.
Note: If your insertion point is in Code view, Bridge starts as usual but cannot place the file. You can only place files in
Design view.
Drag a file from Bridge into your page
1In Dreamweaver (Design view), place the insertion point on your page where you want the image inserted.
2Start Bridge if it isn't already open.
3In Bridge, select one or more files and drag them into your Dreamweaver page.
4If a file is not in your site’s root folder, you are prompted to copy it there.
5If you have set Edit > Preferences > Accessibility to show attributes when inserting images, the Image Tag Acces-
sibility Attributes dialog box is displayed when you insert web-safe images such as JPEG and GIF.
Note: If your insertion point is in Code view, Bridge starts as usual but cannot place the file. You can only place files in
Design view.
Start Dreamweaver from Bridge
❖Select a file in Bridge and do one of the following:
•Select File > Open With > Adobe Dreamweaver.
•Right-click (Control-click on Macintosh) and then choose Open With > Adobe Dreamweaver from the context menu.
Note: If Dreamweaver is already open, this action makes the program active. If Dreamweaver is not open, Bridge starts
it, bypassing the Welcome Screen.
Working with Device Central
Using Adobe Device Central with Dreamweaver
Device Central enables Dreamweaver web designers and developers to preview how Dreamweaver files will look on
a wide variety of mobile devices. Device Central uses Opera’s Small-Screen Rendering™ to give designers and devel-
opers an impression of how their web page looks on a small screen. It also enables designers and developers to test
if their CSS behaves correctly.
For example, a web developer may have a customer who wants to make a website available on mobile phones. The
web developer can use Dreamweaver to create preliminary pages and use Device Central to test how those pages look
on different devices.
September 4, 2007
DREAMWEAVER CS3
User Guide
386
Tips for creating Dreamweaver web content for mobile devices
Device Central previews web pages created in Dreamweaver using Opera’s Small-Screen Rendering. This preview
can give you a good idea of what a web page looks like on a mobile device.
Note: Opera’s Small-Screen Rendering may or may not be pre-installed on any individual emulated device. Device
Central simply gives a preview of how the content would look if Opera’s Small-Screen Rendering was installed.
Use the tips below to ensure that web pages created in Dreamweaver display well on mobile devices.
•If you use the Adobe® Spry framework to develop content, add the following line of HTML to your pages so they
can render CSS and execute JavaScript™ correctly in Device Central:
<link href="SpryAccordion.css" media="screen" rel="stylesheet" type="text/css"/>
<link href="SpryAccordion2.css" media="handheld" rel="stylesheet" type="text/css"/>
•Opera’s Small-Screen Rendering does not support frames, pop-ups, underlining, strikethrough, overlining, blink,
and marquee. Try to avoid these design elements.
•Keep web pages for mobile devices simple. In particular, use a minimum number of fonts, font sizes, and colors.
•Scaling down image sizes and reducing the number of colors required increase the chances that the images will
appear as intended. Use CSS or HTML to specify an exact height and width for each image used. Provide alt text
for all images.
Note: The Opera software website is a good source of information about optimizing web pages for mobile devices.
For more tips and techniques for creating content for mobile phones and devices, see
www.adobe.com/go/learn_cs_mobilewiki_en.
September 4, 2007
387
Chapter 14: Creating and managing
templates
A template is useful when you want to create many pages based on a single design, or when you want to create
specified areas of a page that users can edit. Adobe® Dreamweaver® CS3 provides many tools for creating and
managing templates.
About Dreamweaver templates
Understanding Dreamweaver templates
A template is a special type of document that you use to design a “fixed” page layout; you can then create documents
based on the template that inherit its page layout. As you design a template, you specify as “editable” which content
users can edit in a document based on that template. Templates enable template authors to control which page
elements template users—such as writers, graphic artists, or other web developers—can edit. There are several types
of template regions the template author can include in a document.
Note: Templates enable you to control a large design area and reuse complete layouts. If you want to reuse individual
design elements, such as a site’s copyright information or a logo, create library items.
Using templates enables you to update multiple pages at once. A document that is created from a template remains
connected to that template (unless you detach the document later). You can modify a template and immediately
update the design in all documents based on it.
Note: TemplatesinDreamweaverdifferfromtemplatesinsomeotherAdobeCreativeSuitesoftwareinthatpagesections
of Dreamweaver templates are fixed (or uneditable) by default.
See also
“Managing assets and libraries” on page 108
“Creating a Dreamweaver template” on page 395
Types of template regions
When you save a document as a template, most regions of a document are locked. As a template author, you specify
which regions of a template-based document will be editable by inserting editable regions or editable parameters in
the template.
Asyoucreatethetemplate,youcanmakechangestobotheditableandlockedregions.Inadocumentbasedonthe
template, however, a template user can make changes only in the editable regions; the locked regions can’t be
modified.
There are four types of template regions:
An editable region An unlocked region in a template-based document—a section a template user can edit. A
template author can specify any area of a template as editable. For a template to be effective, it should contain at least
one editable region; otherwise, pages based on the template can’t be edited.
September 4, 2007
DREAMWEAVER CS3
User Guide
388
A repeating region Asectionofthedocumentlayoutthatissetsothatthetemplateusercanaddordeletecopiesof
the repeating region in a document based on the template as necessary. For example, you can set a table row to repeat.
Repeating sections are editable so that the template user can edit the content in the repeating element, while the
design itself is under the control of the template author.
There are two types of repeating regions you can insert in a template: repeating region and repeating table.
An optional region A section of a template that holds content—such as text or an image—that may or may not
appear in a document. In the template-based page, the template user usually controls whether the content is
displayed.
An editable tag attribute Lets you unlock a tag attribute in a template, so the attribute can be edited in a template-
based page. For example, you can “lock” which image appears in the document but let the template user set the
alignment to left, right, or center.
See also
“Editing content in a template-based document” on page 414
“Creating editable regions” on page 398
“Creating repeating regions” on page 399
“Using optional regions” on page 402
“Defining editable tag attributes” on page 404
Links in templates
When you create a template file by saving an existing page as a template, the new template in the Templates folder,
and any links in the file are updated so that their document-relative paths are correct. Later, when you create a
document based on that template and save it, all the document-relative links are updated again to continue to point
to the correct files.
When you add a new document-relative link to a template file, it’s easy to enter the wrong path name if you type the
path into the link text box in the Property inspector. The correct path in a template file is the path from the Templates
folder to the linked document, not the path from the template-based document’s folder to the linked document.
Ensure that the correct paths for links exist by using either the folder icon or the Point-to-file icon in the Property
inspector when creating links in templates.
Dreamweaver 8.01 link update preference
Previous to Dreamweaver 8 (that is, Dreamweaver MX 2004 and earlier), Dreamweaver did not update links to files
that resided in the Templates folder. (For example, if you had a file called main.css in the Templates folder, and had
written href=”main.css” as a link in the template file, Dreamweaver would not update this link when creating a
template-based page.)
Some users took advantage of the way Dreamweaver treated links to files in the Templates folder, and used this
inconsistency to create links that they intentionally did not want to update when creating template-based pages. For
example, if you are using Dreamweaver MX 2004, and have a site with different folders for different applications—
Dreamweaver, Flash, and Photoshop. Each product folder contains a template-based index.html page, and a unique
version of the main.css file at the same level. If the template file contains the document-relative link href=”main.css”
September 4, 2007
DREAMWEAVER CS3
User Guide
389
(a link to a version of the main.css file in the Templates folder), and you want your template-based index.html pages
also to contain this link as written, you can create the template-based index.html pages without having to worry
about Dreamweaver updating those particular links. When Dreamweaver MX 2004 creates the template-based
index.html pages, the (un-updated) href=”main.css” links refer to the main.css files that reside in the Dreamweaver,
Flash, and Photoshop folders, not to the main.css file that resides in the Templates folder.
In Dreamweaver 8, however, this behavior was changed so that all document-relative links are updated when
creating template-based pages, regardless of the apparent location of the linked files. In this scenario, Dreamweaver
examines the link in the template file (href="main.css") and creates a link in the template-based page that is relative
to the location of the new document. For example, if you are creating a template-based document one level up from
the Templates folder, Dreamweaver would write the link in the new document as href=”Templates/main.css”. This
update in Dreamweaver 8 broke links in pages created by those designers who had taken advantage of Dreamweaver’s
former practice of not updating links to files in the Templates folder.
Dreamweaver 8.01 added a preference that enables you to turn the update relative links behavior on and off. (This
special preference only applies to links to files in the Templates folder, not to links in general.) The default behavior
is to not update these links (as in Dreamweaver MX 2004 and before), but if you want Dreamweaver to update these
kinds of links when creating template-based pages, you can deselect the preference. (You would only do this if, for
example, you had a Cascading Style Sheets (CSS) page, main.css, in your Templates folder, and you wanted a
template-based document to contain the link href=”Templates/main.css”; but this is not recommended practice as
only Dreamweaver template (DWT) files should reside in the Templates folder.)
To have Dreamweaver update document-relative paths to non-template files in the Templates folder, select the
Templates category on the Advanced tab of the Site Definition dialog box, and deselect the Don’t Rewrite Document
Relative Paths option.
For more information, see the Dreamweaver TechNote on the Adobe website at www.adobe.com/go/f55d8739
See also
“Link to documents using the Point-To-File icon” on page 283
“Document-relative paths” on page 280
Server scripts in templates and template-based documents
Some server scripts are inserted at the very beginning or end of the document (before the <html> tag or after the
</html> tag). Such scripts require special treatment in templates and template-based documents. Normally, if you
makechangestoscriptcodebeforethe<html> tag or after the </html> tag in a template, the changes are not copied
to documents based on that template. This can cause server errors if other server scripts, within the main body of
the template, depended on the scripts that are not copied. An alert warns you if you change scripts before the <html>
tag or after the </html> tag in a template.
To avoid this problem, you can insert the following code in the head section of the template:
<!-- TemplateInfo codeOutsideHTMLIsLocked="true" -->
When this code is in a template, changes to scripts before the <html> tag or after the </html> tag are copied to
documentsbasedonthattemplate.However,youwillnolongerbeabletoeditthosescriptsindocumentsbasedon
the template. Thus, you can choose to either edit these scripts in the template, or in documents based on the template,
but not both.
September 4, 2007
DREAMWEAVER CS3
User Guide
390
Template parameters
Template parameters indicate values for controlling content in documents based on a template. Use template param-
eters for optional regions or editable tag attributes, or to set values you want to pass to an attached document. For
each parameter, you select a name, a data type, and a default value. Each parameter must have a unique name that is
case sensitive. They must be one of five permitted data types: text, boolean, color, URL, or number.
Template parameters are passed to the document as instance parameters. In most cases, a template user can edit the
parameter’s default value to customize what appears in a template-based document. In other cases, the template
author might determine what appears in the document, based on the value of a template expression.
Note: A related useful article is available online at http://www.adobe.com/devnet/dream-
weaver/articles/template_parameters.html.
See also
“Using optional regions” on page 402
“Defining editable tag attributes” on page 404
Template expressions
Template expressions are statements that compute or evaluate a value.
You can use an expression to store a value and display it in a document. For example, an expression can be as simple
as the value of a parameter, such as @@(Param)@@, or complex enough to compute values which alternate the
background color in a table row, such as @@((_index & 1) ? red : blue)@@.
You can also define expressions for if and multiple-if conditions. When an expression is used in a conditional
statement, Dreamweaver evaluates it as true or false. If the condition is true, the optional region appears in the
template-based document; if it is false, it doesn’t appear.
You can define expressions in Code view or in the Optional Region dialog box when you insert an optional region.
In Code view, there are two ways to define template expressions: use the <!-- TemplateExpr expr=“your
expresson”--> comment or @@(your expression)@@. When you insert the expression in the template code, an
expression marker appears in Design view. When you apply the template, Dreamweaver evaluates the expression and
displays the value in the template-based document.
See also
“Template expression language” on page 390
“Multiple If condition in template code” on page 391
Template expression language
The template expression language is a small subset of JavaScript, and uses JavaScript syntax and precedence rules.
Use JavaScript operators to write an expression like this:
@@(firstName+lastName)@@
The following features and operators are supported:
•numeric literals, string literals (double-quote syntax only), Boolean literals (true or false)
•variable reference (see the list of defined variables later in this section)
September 4, 2007
DREAMWEAVER CS3
User Guide
391
•field reference (the “dot” operator)
•unary operators: +, -, ~, !
•binary operators: +, -, *, /, %, &, |, ^, &&, ||, <, <=, >, >=, ==, !=, <<, >>
•conditional operator: ?:
•parentheses: ()
The following data types are used: Boolean, IEEE 64-bpc floating point, string, and object. Dreamweaver templates
do not support the use of JavaScript “null” or “undefined” types. Nor do they allow scalar types to be implicitly
converted into an object; thus, the expression "abc".length would trigger an error, instead of yielding the value 3.
The only objects available are those defined by the expression object model. The following variables are defined:
_document Contains the document-level template data with a field for each parameter in the template.
_repeat Only defined for expressions which appear inside a repeating region. Provides built-in information about
the region:
_index The numerical index (from 0) of the current entry
_numRows The total number of entries in this repeating region
_isFirst True if the current entry is the first entry in its repeating region
_isLast True if the current entry is the last entry in its repeating region
_prevRecord The _repeat object for the previous entry. It is an error to access this property for the first entry in the
region.
_nextRecord The _repeat object for the next entry. It is an error to access this property for the last entry in the
region.
_parent In a nested repeated region, this gives the _repeat object for the enclosing (outer) repeated region. It is an
error to access this property outside of a nested repeated region.
During expression evaluation, all fields of the _document object and _repeat object are implicitly available. For
example, you can enter title instead of _document.title to access the document’s title parameter.
In cases where there is a field conflict, fields of the _repeat object take precedence over fields of the _document
object. Therefore, you shouldn’t need to explicitly reference _document or _repeat except that _document might be
needed inside a repeating region to reference document parameters that are hidden by repeated region parameters.
When nested repeated regions are used, only fields of the innermost repeated regions are available implicitly. Outer
regions must be explicitly referenced using _parent.
Multiple If condition in template code
You can define template expressions for if and multiple-if conditions. This example demonstrates defining a
parameter named "Dept", setting an initial value, and defining a multiple-if condition which determines which logo
to display.
The following is an example of the code you might enter in the head section of the template:
<!-- TemplateParam name="Dept" type="number" value="1" -->
The following condition statement checks the value assigned to the Dept parameter. When the condition is true or
matches, the appropriate image is displayed.
September 4, 2007
DREAMWEAVER CS3
User Guide
392
<!-- TemplateBeginMultipleIf -->
<!-- checks value of Dept and shows appropriate image-->
<!-- TemplateBeginIfClause cond="Dept == 1" --> <img src=".../sales.gif"> <!--
TemplateEndIfClause -->
<!-- TemplateBeginIfClause cond="Dept == 2" --> <img src=".../support.gif"> <!--
TemplateEndIfClause-->
<!-- TemplateBeginIfClause cond="Dept == 3" --> <img src=".../hr.gif"> <!--
TemplateEndIfClause -->
<!-- TemplateBeginIfClause cond="Dept != 3" --> <img src=".../spacer.gif"> <!--
TemplateEndIfClause -->
<!-- TemplateEndMultipleIf -->
When you create a template-based document, the template parameters are automatically passed to it. The template
user determines which image to display.
See also
“Modify template properties” on page 415
Recognizing templates and template-based
documents
Recognizing templates in Design view
In Design view, editable regions appear in the Document window surrounded by rectangular outlines in a preset
highlight color. A small tab appears at the upper-left corner of each region, showing the name of the region.
You can identify a template file by looking at the title bar in the Document window. The title bar for a template file
contains the word <<Template>> in the title bar, and the filename extension for the file is .dwt.
September 4, 2007
DREAMWEAVER CS3
User Guide
393
Recognizing templates in Code view
In Code view, editable content regions are marked in HTML with the following comments:
<!-- TemplateBeginEditable> and <!-- TemplateEndEditable -->
You can use code color preferences to set your own color scheme so you can easily distinguish template regions when
you view a document in Code view.
Everything between these comments will be editable in documents based on the template. The HTML source code
for an editable region might look like this:
<table width="75%" border="1" cellspacing="0" cellpadding="0">
<tr bgcolor="#333366">
<td>Name</td>
<td><font color="#FFFFFF">Address</font></td>
<td><font color="#FFFFFF">Telephone Number</font></td>
</tr>
<!-- TemplateBeginEditable name="LocationList" -->
<tr>
<td>Enter name</td>
<td>Enter Address</td>
<td>Enter Telephone</td>
</tr>
<!-- TemplateEndEditable -->
</table>
Note: When you edit template code in Code view, be careful not to change any of the template-related comment tags that
Dreamweaver relies on.
See also
“Customize code coloring preferences for a template” on page 418
Recognizing template-based documents in Design view
In Design view, a document based on a template (a template-based document), editable regions appear in the
Document window surrounded by rectangular outlines in a preset highlight color. A small tab appears at the upper-
left corner of each region, showing the name of the region.
September 4, 2007
DREAMWEAVER CS3
User Guide
394
In addition to the editable-region outlines, the entire page is surrounded by a different-colored outline, with a tab in
the upper-right corner giving the name of the template that the document is based on. This highlighted rectangle
remindsyouthatthedocumentisbasedonatemplateandthatyoucan’tchangecontentoutsidetheeditableregions.
See also
“Set highlighting preferences for template regions” on page 419
Recognizing template-based documents in Code view
In Code view, editable regions of a document derived from a template appear in a different color than code in the
non-editable regions. You can make changes only to code in the editableregions or editable parameters but you
cannot type in locked regions.
Editable content is marked in HTML with the following Dreamweaver comments:
<!-- InstanceBeginEditable> and <!-- InstanceEndEditable -->
Everything between these comments is editable in a template-based document. The HTML source code for an
editable region might look like this:
September 4, 2007
DREAMWEAVER CS3
User Guide
395
<body bgcolor="#FFFFFF" leftmargin="0">
<table width="75%" border="1" cellspacing="0" cellpadding="0">
<tr bgcolor="#333366">
<td>Name</td>
<td><font color="#FFFFFF">Address</font></td>
<td><font color="#FFFFFF">Telephone Number</font></td>
</tr>
<!-- InstanceBeginEditable name="LocationList" -->
<tr>
<td>Enter name</td>
<td>Enter Address</td>
<td>Enter Telephone</td>
</tr>
<!-- InstanceEndEditable -->
</table>
</body>
The default color for non-editable text is gray; you can select a different color for the editable and non-editable
regions in the Preferences dialog box.
See also
“Customize code coloring preferences for a template” on page 418
Creating a Dreamweaver template
About creating Dreamweaver templates
You can create a template from an existing document (such as an HTML, Macromedia ColdFusion, or Microsoft
Active Server Pages document) or you can create a template from a new document.
After you create a template, you can insert template regions, and set template preferences for code color and template
region highlight color.
You can store additional information about a template (such as who created it, when it was last changed, or why you
madecertainlayoutdecisions)inaDesignNotesfileforthetemplate.Documentsbasedonatemplatedonotinherit
the template’s Design Notes.
Note: Templates in Adobe Dreamweaver differ from templates in some other Adobe Creative Suite products in that page
sections of Dreamweaver templates are fixed (or uneditable) by default.
For a tutorial on creating templates, see www.adobe.com/go/vid0157.
For a tutorial on using templates, see www.adobe.com/go/vid0158.
See also
“Types of template regions” on page 387
“Setting authoring preferences for templates” on page 418
“Associate Design Notes with files” on page 103
September 4, 2007
DREAMWEAVER CS3
User Guide
396
Create a template from an existing document
You can create a template from an existing document.
1Open the document you want to save as a template.
2Do one of the following:
•Select File > Save As Template.
•In the Common category of the Insert bar, click the Templates button, then select Make Template from the pop-
up menu.
Note: Unless you selected Don’t Show This Dialog Again in the past, you’ll receive a warning that says the document
you’re saving has no editable regions. Click OK to save the document as a template, or click Cancel to exit this dialog box
without creating a template.
3SelectasitetosavethetemplateinfromtheSitepop-upmenu,andthenenterauniquenameforthetemplatein
the Save As box.
4Click Save. Dreamweaver saves the template file in the site’s Templates folder in the local root folder of the site,
with a .dwt filename extension. If the Templates folder does not already exist in the site, Dreamweaver automatically
creates it when you save a new template.
Note: DonotmoveyourtemplatesoutoftheTemplatesfolder,orputanynon-templatefilesintheTemplatesfolder.Also,
do not move the Templates folder out of your local root folder. Doing so causes errors in paths in the templates.
See also
“Create a blank template” on page 70
“Creating and opening documents” on page 68
Use the Assets panel to create a new template
1In the Assets panel (Window > Assets), select the Templates category on the left side of the panel .
2Click the New Template button at the bottom of the Assets panel.
A new, untitled template is added to the list of templates in the Assets panel.
3While the template is still selected, enter a name for the template, then press Enter (Windows) or Return
(Macintosh).
Dreamweaver creates a blank template in the Assets panel and in the Templates folder.
About creating templates for Contribute sites
Using Dreamweaver, you can create templates to help Adobe® Contribute® users create new pages, to provide a
consistent look and feel for your site, and to enable you to update the layout of many pages at once.
Whenyoucreateatemplateanduploadittotheserver,itbecomesavailabletoallContributeuserswhoconnectto
your site, unless you’ve set restrictions on template use for certain Contribute roles. If you have set restrictions on
template use, you might need to add each new template to the list of templates a Contribute user can use (see Admin-
istering Contribute).
Note: Make sure that the site root folder defined in each Contribute user’s site definition is the same as the site root folder
definedinyoursitedefinitioninDreamweaver.Ifauser’ssiterootfolderdoesn’tmatchyours,thatuserwon’tbeableto
use templates.
September 4, 2007
DREAMWEAVER CS3
User Guide
397
In addition to Dreamweaver templates, you can create non-Dreamweaver templates using the Contribute adminis-
tration tools. A non-Dreamweaver template is an existing page that Contribute users can use to create new pages; it’s
similar to a Dreamweaver template, except that pages that are based on it don’t update when you change the template.
Also, non-Dreamweaver templates can’t contain Dreamweaver template elements such as editable, locked, repeating,
and optional regions.
When a Contribute user creates a new document within a site containing Dreamweaver templates, Contribute lists
the available templates (both Dreamweaver and non-Dreamweaver templates) in the New Page dialog box.
To include pages that use encodings other than Latin-1 in your site, you might need to create templates (either
Dreamweaver templates or non-Dreamweaver templates). Contribute users can edit pages that use any encoding, but
when a Contribute user creates a new blank page, it uses the Latin-1 encoding. To create a page that uses a different
encoding, a Contribute user can create a copy of an existing page that uses a different encoding, or can use a template
that uses a different encoding. However, if there are no pages or templates in the site that use other encodings, then
you must first create a page or a template in Dreamweaver that uses that other encoding.
Create a template for a Contribute site
1Select Site > Manage Sites.
2Select a site and click Edit.
3In the Site Definition dialog box, click the Advanced tab.
4Select the Contribute category from the category list on the left.
5If you haven’t already done so, you need to enable Contribute compatibility.
Select Enable Contribute Compatibility, and then enter a site root URL.
6Click Administer Site In Contribute.
7If prompted, enter the administrator password, and then click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
398
8In the Users And Roles category, select a role, and then click the Edit Role Settings button.
9Select the New Pages category, and then add existing pages to the list under Create A New Page By Copying A
Page From This List.
For more information, see Administering Contribute.
10 Click OK twice to close the dialog boxes.
See also
“Prepare a site for use with Contribute” on page 59
Creating editable regions
Insert an editable region
Editable template regions control which areas of a template-based page a user can edit. Before you insert an editable
region, save the document you are working in as a template.
Note: If you insert an editable region in a document rather than a template file, an alert warns you that the document
will automatically be saved as a template.
Youcanplaceaneditableregionanywhereinyourpage,butconsiderthefollowingpointsifyouaremakingatable
or an absolutely-positioned element (AP element) editable:
•You can mark an entire table or an individual table cell as editable, but you can’t mark multiple table cells as a single
editable region. If a <td> tag is selected, the editable region includes the region around the cell; if not, the editable
region affects only content inside the cell.
•AP elements and AP element content are separate elements; making an AP element editable lets you change the
position of the AP element as well as its contents, but making an AP element’s contents editable lets you change
only the content of the AP element, not its position.
1In the Document window, do one of the following to select the region:
•Select the text or content that you want to set as an editable region.
•Place the insertion point where you want to insert an editable region.
2Do one of the following to insert an editable region:
•Select Insert > Template Objects > Editable Region.
•Right-click (Windows) or Control-click (Macintosh), then select Templates > New Editable Region.
•In the Common category of the Insert bar, click the Templates button, then select Editable Region from the pop-
up menu.
3IntheNamebox,enterauniquenamefortheregion.(Youcannotusethesamenameformorethanoneeditable
region in a particular template.)
Note: Do not use special characters in the Name box.
4Click OK. The editable region is enclosed in a highlighted rectangular outline in the template, using the
highlighting color that is set in preferences. A tab at the upper-left corner of the region shows the name of the region.
If you insert an empty editable region in the document, the name of the region also appears inside the region.
September 4, 2007
DREAMWEAVER CS3
User Guide
399
See also
“Creating a Dreamweaver template” on page 395
“Set highlighting preferences for template regions” on page 419
Select editable regions
You can easily identify and select template regions in both, the template document and template-based documents.
Select an editable region in the Document window
❖Click the tab in the upper-left corner of the editable region.
Find an editable region and select it in the document
❖Select Modify > Templates, then select the name of the region from the list at the bottom of that submenu.
Note: Editable regions that are inside a repeated region do not appear in the menu. You must locate these regions by
looking for tabbed borders in the Document window.
The editable region is selected in the document.
Remove an editable region
If you’ve marked a region of your template file as editable and you want to lock it (make it noneditable in template-
based documents) again, use the Remove Template Markup command.
1Click the tab in the upper-left corner of the editable region to select it.
2Do one of the following:
•Select Modify > Templates > Remove Template Markup.
•Right-click (Windows) or Control-click (Macintosh), then select Templates > Remove Template Markup.
The region is no longer editable.
Change an editable region’s name
After you insert an editable region, you can later change its name.
1Click the tab in the upper-left corner of the editable region to select it.
2In the Property inspector (Window > Properties), enter a new name.
3Press Enter (Windows) or Return (Macintosh).
Creating repeating regions
About template repeating regions
A repeating region is a section of a template that can be duplicated many times in a template-based page. Typically,
repeating regions are used with tables but you can define a repeating region for other page elements.
Repeating regions enable you to control your page layout by repeating certain items, such as a catalog item and
description layout, or a row for data such as a list of items.
September 4, 2007
DREAMWEAVER CS3
User Guide
400
There are two repeating region template objects you can use: repeating region and repeating table.
See also
“Types of template regions” on page 387
Create a repeating region in a template
Repeating regions enable template users to duplicate a specified region in a template as often as desired. A repeating
region is not necessarily an editable region.
To make content in a repeating region editable (for example, to allow a user to enter text in a table cell in a template-
based document), you must insert an editable region in the repeating region.
1In the Document window, do one of the following:
•Select the text or content you want to set as a repeating region.
•Place the insertion point in the document where you want to insert the repeating region.
2Do one of the following:
•Select Insert > Template Objects > Repeating Region.
•Right-click (Windows) or Control-click (Macintosh), then select Templates > New Repeating Region.
•IntheCommoncategoryoftheInsertbar,clicktheTemplatesbutton,thenselectRepeatingRegionfromthepop-
up menu.
3IntheNamebox,enterauniquenameforthetemplateregion.(Youcannotusethesamenameformorethanone
repeating region in a template.)
Note: When you name a region, do not use special characters.
4Click OK.
See also
“Insert an editable region” on page 398
Insert a repeating table
You can use a repeating table to create an editable region (in table format) with repeating rows. You can define table
attributes and set which table cells are editable.
1IntheDocumentwindow,placetheinsertionpointinthedocumentwhereyouwanttoinserttherepeatingtable.
2Do one of the following:
•Select Insert > Template Objects > Repeating Table.
•In the Common category of the Insert bar, click the Templates button, and then select Repeating Table from the
pop-up menu.
3Specify the following options and click OK.
Rows determines the number of rows the table has.
Columns Determines the number of columns the table has.
Cell Padding Determines the number of pixels between a cell’s content and the cell boundaries.
September 4, 2007
DREAMWEAVER CS3
User Guide
401
Cell Spacing Determines the number of pixels between adjacent table cells.
If you don’t explicitly assign values for cell padding and cell spacing, most browsers display the table as if cell padding
weresetto1andcellspacingweresetto2.Toensurethatbrowsersdisplaythetablewithnopaddingorspacing,set
Cell Padding and Cell Spacing to 0.
Width Specifies the width of the table in pixels, or as a percentage of the browser window’s width.
Border Specifies the width, in pixels, of the table’s borders.
Ifyoudon’texplicitlyassignavalueforborder,mostbrowsersdisplaythetableasiftheborderweresetto1.Toensure
that browsers display the table with no border, set Border to 0. To view cell and table boundaries when the border is
set to 0, select View > Visual Aids > Table Borders.
Repeat Rows of the Table Specify which rows in the table are included in the repeating region.
Starting Row Sets the row number entered as the first row to include in the repeating region.
Ending Row Sets the row number entered as the last row to include in the repeating region.
Region Name Lets you set a unique name for the repeating region.
Set alternating background colors in a repeating table
After you insert a repeating table in a template, you can customize it by alternating the background color of the table
rows.
1In the Document window, select a row in the repeating table.
2Click the Show Code View or Show Code And Design Views button in the Document toolbar so you can access
the code for the selected table row.
3In Code view, edit the <tr> tag to include the following code:
<tr bgcolor="@@( _index & 1 ? '#FFFFFF' : '#CCCCCC' )@@">
You can replace the #FFFFFF and #CCCCCC hexadecimal values with other color choices.
4Save the template.
The following is a code example of a table that includes alternating background table row colors:
<table width="75%" border="1" cellspacing="0" cellpadding="0">
<tr><th>Name</th><th>Phone Number</th><th>Email Address</th></tr>
<!-- TemplateBeginRepeat name="contacts" -->
<tr bgcolor="@@(_index & 1 ? '#FFFFFF' : '#CCCCCC')@@">
<td> <!-- TemplateBeginEditable name="name" --> name <!-- TemplateEndEditable -->
</td>
<td> <!-- TemplateBeginEditable name="phone" --> phone <!-- TemplateEndEditable -->
</td>
<td> <!-- TemplateBeginEditable name="email" --> email <!-- TemplateEndEditable -->
</td>
</tr>
<!-- TemplateEndRepeat -->
</table>
September 4, 2007
DREAMWEAVER CS3
User Guide
402
Using optional regions
About template optional regions
Anoptionalregionisaregioninatemplatethatuserscansettoshowortohideinatemplate-baseddocument.Use
an optional region when you want to set conditions for displaying content in a document.
When you insert an optional region, you can either set specific values for a template parameter or define conditional
statements (If...else statements) for template regions. Use simple true/false operations, or define more complex
conditional statements and expressions. You can later modify the optional region if necessary. Based on the condi-
tions you define, template users can edit the parameters in template-based documents they create and control
whether the optional region is displayed.
You can link multiple optional regions to a named parameter. In the template-based document, both regions will
show or hide as a unit. For example, you can show a “closeout” image and sales price text area for a sale item.
See also
“Modify template properties” on page 415
“Types of template regions” on page 387
Insert an optional region
Useanoptionalregiontocontrolcontentthatmayormaynotbedisplayedinatemplate-baseddocument.Thereare
two types of optional regions:
•Non-editable optional regions, which enables template users to show and hide specially marked regions without
enabling them to edit the content.
The template tab of an optional region is preceded by the word if. Based on the condition set in the template, a
template user can define whether the region is viewable in pages they create.
•Editable optional regions, which enables template users to set whether the region shows or hides and enables them
to edit content in the region.
For example, if the optional region includes an image or text, the template user can set whether the content is
displayed, as well as make edits to the content if desired. An editable region is controlled by a conditional statement.
See also
“Modify template properties” on page 415
Insert a non-editable optional region
1In the Document window, select the element you want to set as an optional region.
2Do one of the following:
•Select Insert > Template Objects > Optional Region.
•Right-click (Windows) or Control-click (Macintosh) the selected content, then select Templates > New Optional
Region.
•In the Common category of the Insert bar, click the Templates button, then select Optional Region from the pop-
up menu.
September 4, 2007
DREAMWEAVER CS3
User Guide
403
3Enter a name for the optional region, click the Advanced tab if you want to set values for the optional region, and
then click OK.
Insert an editable optional region
1In the Document window, place the insertion point where you want to insert the optional region.
You cannot wrap a selection to create an editable optional region. Insert the region, then insert the content in the
region.
2Do one of the following:
•Select Insert > Template Objects > Editable Optional Region.
•In the Common category of the Insert bar, click the Templates button, then select Editable Optional Region from
the pop-up menu.
3Enter a name for the optional region, click the Advanced tab if you want to set values for the optional region, and
click OK.
Set values for an optional region
You can edit optional region settings after you’ve inserted the region in a template. For example, you can change
whether the default setting for the content is to be displayed or not, to link a parameter to an existing optional region,
or to modify a template expression.
Create template parameters and define conditional statements (If...else statements) for template regions. You can use
simple true/false operations, or define more complex conditional statements and expressions.
In the Advanced tab you can link multiple optional regions to a named parameter. In the template-based document,
both regions will show or hide as a unit. For example, you can show a “closeout” image and sales price text area for
a sale item.
You can also use the Advanced tab to write a template expression that evaluates a value for the optional region and
shows it or hides it based on the value.
1In the Document window, do one of the following:
•In Design view, click the template tab of the optional region you want to modify.
•In Design view, place the insertion point in the template region; then in the tag selector at the bottom of the
Document window, select the template tag, <mmtemplate:if>.
•In Code view, click the comment tag of the template region you want to modify.
2In the Property inspector (Window > Properties), click Edit.
3In the Basics tab, enter a name for the parameter in the Name box.
4Select Show By Default to set the selected region to show in the document. Deselect it to set the default value to
false.
Note: To set a different value for the parameter, in Code view locate the parameter in the section of the document and
edit the value.
5(Optional) Click the Advanced tab, then set the following options:
•If you want to link optional region parameters, click the Advanced tab, select Use Parameter, then from the pop-up
menu select the existing parameter you want to link the selected content to.
September 4, 2007
DREAMWEAVER CS3
User Guide
404
•If you want to write a template expression to control the display of an optional region, click the Advanced tab,
select Enter Expression, then enter the expression in the box.
Note: Dreamweaver inserts double-quotation marks around the text you enter.
6Click OK.
When you use the Optional Region template object, Dreamweaver inserts template comments in the code. A
template parameter is defined in the head section, as in the following example:
<!-- TemplateParam name="departmentImage" type="boolean" value="true" -->
At the location where the optional region is inserted, code similar to the code below appears:
<!-- TemplateBeginIf cond="departmentImage" -->
<p><img src="/images/airfare_on.gif" width="85" height="22"> </p>
<!-- TemplateEndIf -->
You can access and edit template parameters in the template-based document.
See also
“Modify template properties” on page 415
“Template expressions” on page 390
Defining editable tag attributes
Specify editable tag attributes in a template
You can allow a template user to modify specified tag attributes in a document created from a template.
For example, you can set a background color in the template document, yet enable template users to set a different
background color for pages they create. Users can update only the attributes you specify as editable.
You can also set multiple editable attributes in a page so that template users can modify the attributes in template-
based documents. The following data types are supported: text, Boolean (true/false), color, and URL.
Creating an editable tag attribute inserts a template parameter in the code. An initial value for the attribute is set in
the template document; when a template-based document is created, it inherits the parameter. A template user can
then edit the parameter in the template-based document.
Note: If you make the link to a style sheet an editable attribute, then the attributes of the style sheet are no longer
available for either viewing or editing in the template file.
1In the Document window, select an item you want to set an editable tag attribute for.
2Select Modify > Templates > Make Attribute Editable.
3IntheAttributebox,enteranameorselectanattributeintheEditableTagAttributesdialogboxbydoingoneof
the following:
•If the attribute you want to make editable is listed in the Attribute pop-up menu, select it.
•If the attribute you want to make editable isn’t listed in the Attribute pop-up menu, click Add, and in the dialog
box that opens, enter the name of the attribute you want to add, then click OK.
4Make sure the Make Attribute Editable option is selected.
September 4, 2007
DREAMWEAVER CS3
User Guide
405
5In the Label box, enter a unique name for the attribute.
To make it easier to identify a specific editable tag attribute later, use a label that identifies the element and the
attribute. For example, you might label an image whose source is editable logoSrc or label the editable background
color of a body tag bodyBgcolor.
6In the Type menu, select the type of value allowed for this attribute by setting one of the following options:
•To enable a user to enter a text value for the attribute, select Text. For example, you can use text with the align
attribute; the user can then set the attribute’s value to left,right, or center.
•To insert a link to an element, such as the file path to an image, select URL. Using this option automatically updates
the path used in a link. If the user moves the image to a new folder, the Update Links dialog box appears.
•To make the color picker available for selecting a value, select Color.
•To enable a template user to type a numerical value to update an attribute (for example, to change the height or
width values of an image), select Number.
7The Default Value box displays the value of the selected tag attribute in the template. Enter a new value in this box
to set a different initial value for the parameter in the template-based document.
8(Optional) If you want to make changes to another attribute of the selected tag, select the attribute and set the
options for that attribute.
9Click OK.
See also
“Modify template properties” on page 415
Make an editable tag attribute uneditable
A tag previously marked as editable can be marked as uneditable.
1In the template document, click the element associated with the editable attribute or use the tag selector to select
the tag.
2Select Modify > Templates > Make Attribute Editable.
3In the Attributes pop-up menu, select the attribute you want to affect.
4Deselect Make Attribute Editable and click OK.
5Update documents based on the template.
Creating a nested template
About nested templates
A nested template is a template whose design and editable regions are based on another template. Nested templates
are useful for controlling content in pages of a site that share many design elements, but have a few variations
between pages. For example, a base template might contain broader design areas and be usable by many content
contributors for a site, while a nested template might further define the editable regions in pages for a specific section
in a site.
September 4, 2007
DREAMWEAVER CS3
User Guide
406
Editable regions in a base template are passed through to the nested template, and remain editable in pages created
from a nested template unless new template regions are inserted in these regions.
Changes to a base template are automatically updated in templates based on the base template, and in all template-
based documents that are based on the main and nested templates.
In the following example, the template trioHome contains three editable regions, named Body,NavBar,andFooter:
September 4, 2007
DREAMWEAVER CS3
User Guide
407
To create a nested template, a new document based on the template was created and then saved as a template and
named TrioNested. In the nested template, two editable regions have been added in the editable region named Body.
When you add a new editable region in an editable region passed through to the nested template, the highlighting
color of the editable region changes to orange. Content you add outside the editable region, such as the graphic in
the editableColumn, is no longer editable in documents based on the nested template. The blue highlighted
editable areas, whether added in the nested template or passed through from the base template, remain editable in
documents that are based on the nested template. Template regions that do not contain an editable region pass
through to template-based documents as editable regions.
Create a nested template
Nested templates let you create variations of a base template. You can nest multiple templates to define increasingly
specific layouts.
By default, all editable template regions from the base template pass through the nested template to the document
based on the nested template. That means that if you create an editable region in a base template, then create a nested
template, the editable region appears in documents based on the nested template (if you did not insert any new
template regions in that region in the nested template).
September 4, 2007
DREAMWEAVER CS3
User Guide
408
Note: You can insert template markup inside an editable region so that it won’t pass through as an editable region in
documents based on the nested template. Such regions have an orange border instead of a blue border.
1Create a document from the template on which you want to base the nested template by doing one of the
following:
•In the Assets panel’s Templates category, right-click (Windows) or Control-click (Macintosh) the template you
want to create a new document from, then select New From Template from the context menu.
•Select File > New. In the New Document dialog box, select the Page from Template category, then select the site
that contains the template you want to use; in the Template list, double-click the template to create a new
document.
2Select File > Save As Template to save the new document as a nested template:
3Enter a name in the Save As box and click OK.
See also
“Server scripts in templates and template-based documents” on page 389
Prevent an editable region from passing through to a nested template
In nested templates, pass-through editable regions have a blue border. You can insert template markup inside an
editable region so that it won’t pass through as an editable region in documents based on the nested template. Such
regions have an orange border instead of a blue border.
1In Code view, locate the editable region you want to prevent from passing through.
Editable regions are defined by template comment tags.
2Add the following code to the editable region code:
@@("")@@
This template code can be placed anywhere within the <!-- InstanceBeginEditable --><!-- InstanceEndEd-
itable --> tags that surround the editable region. For example:
<!-- InstanceBeginEditable name="EditRegion1" -->
<p>@@("")@@ Editable 1 </p>
<!-- InstanceEndEditable -->
For more information, see TechNote 16416 on the Adobe website at www.adobe.com/go/16416.
Editing, updating, and deleting templates
About editing and updating templates
Whenyoumakechangestoandsaveatemplate,allthedocumentsbasedonthetemplateareupdated.Youcanalso
manually update a template-based document or the entire site if necessary.
Note: To edit a template for a Contribute site, you must use Dreamweaver; you cannot edit templates in Contribute.
Use the Templates category of the Assets panel to manage existing templates, including renaming template files and
deleting template files.
September 4, 2007
DREAMWEAVER CS3
User Guide
409
You can perform the following template management tasks with the Assets panel:
•Create a template
•Edit and update templates
•Apply or remove a template from an existing document
Dreamweaver checks template syntax when you save a template but it’s a good idea to manually check the template
syntax while you’re editing a template.
See also
“Creating a Dreamweaver template” on page 395
“Check template syntax” on page 418
“Applying or removing a template from an existing document” on page 413
Open a template for editing
You can open a template file directly for editing, or you can open a template-based document, then open the attached
template for editing.
When you make a change to a template, Dreamweaver prompts you to update the documents based on the template.
Note: You can also manually update the documents for template changes if necessary.
See also
“Check template syntax” on page 418
Open and edit a template file
1In the Assets panel (Window > Assets), select the Templates category on the left side of the panel .
The Assets panel lists all of the available templates for your site and displays a preview of the selected template.
2In the list of available templates, do one of the following:
•Double-click the name of the template you want to edit.
•Select a template to edit, then click the Edit button at the bottom of the Assets panel.
3Modify the contents of the template.
To modify the template’s page properties, select Modify > Page Properties. (Documents based on a template inherit
the template’s page properties.)
4Save the template. Dreamweaver prompts you to update pages based on the template.
5Click Update to update all documents based on the modified template; click Don’t Update if you don’t want to
update documents based on the modified template.
Dreamweaver displays a log indicating the files that were updated.
Open and modify the template attached to the current document
1Open the template-based document in the Document window.
2Do one of the following:
•Select Modify > Templates > Open Attached Template.
September 4, 2007
DREAMWEAVER CS3
User Guide
410
•Right-click (Windows) or Control-click (Macintosh), then select Templates > Open Attached Template.
3Modify the contents of the template.
To modify the template’s page properties, select Modify > Page Properties. (Documents based on a template inherit
the template’s page properties.)
4Save the template. Dreamweaver prompts you to update pages based on the template.
5Click Update to update all documents based on the modified template; click Don’t Update if you don’t want to
update documents based on the modified template.
Dreamweaver displays a log indicating the files that were updated.
Rename a template
1In the Assets panel (Window > Assets), select the Templates category on the left side of the panel .
2Click the name of the template to select it.
3Click the name again so that the text is selectable, then enter a new name.
This method of renaming works in the same way as renaming a file in Windows Explorer (Windows) or the Finder
(Macintosh). As with Windows Explorer and the Finder, be sure to pause briefly between clicks. Do not double-click
the name, because that opens the template for editing.
4Click in another area of the Asset panel, or press Enter (Windows) or Return (Macintosh) for the change to take
effect.
An alert asks if you want to update documents that are based on this template.
5To update all documents in the site that are based on this template, click Update. Click Don’t Update if you do not
want to update any document based on this template.
See also
“Creating a Dreamweaver template” on page 395
“Applying or removing a template from an existing document” on page 413
Change a template description
The template description appears in the New Document dialog box when you’re creating a page from an existing
template.Younormallysetthedescriptionthefirsttimeyousaveapageasatemplate,butyoucanalwayschangethe
description later.
1Select Modify > Templates > Description.
2In the Template Description dialog box, edit the description and click OK.
See also
“Creating a Dreamweaver template” on page 395
Manually update documents based on templates
When you make a change to a template, Dreamweaver prompts you to update the documents based on the template,
butyoucanmanuallyupdatethecurrentdocumentortheentiresiteifnecessary.Manuallyupdatingtemplate-based
documents is the same as reapplying the template.
September 4, 2007
DREAMWEAVER CS3
User Guide
411
Apply template changes to the current template-based document
1Open the document in the Document window.
2Select Modify > Templates > Update Current Page.
Dreamweaver updates the document with any template changes.
Update the entire site or all documents that use a specified template
You can update all the pages in the site, or only update pages for a specific template.
1Select Modify > Templates > Update Pages.
2In the Look In menu, do one of the following:
•To update all the files in the selected site to their corresponding templates, select Entire Site, then select the site
name from the adjacent pop-up menu.
•To update files for a specific template, select Files That Use, then select the template name from the
adjacent pop-up menu.
3Make sure Templates is selected in the Update option.
4If you don’t want to see a log of the files Dreamweaver updates, deselect the Show Log option; otherwise, leave that
option selected.
5Click Start to update the files as indicated. If you selected the Show Log option, Dreamweaver provides infor-
mation about the files it attempts to update, including information on whether they were updated successfully.
6Click Close.
Update templates in a Contribute site
Contribute users can’t make changes to a Dreamweaver template. You can, however, use Dreamweaver to change a
template for a Contribute site
Keep these factors in mind when updating templates in a Contribute site:
•Contribute retrieves new and changed templates from the site only when Contribute starts up and when a
Contribute user changes their connection information. If you make changes to a template while a Contribute user
is editing a file based on that template, the user won’t see the changes to the template until they restart Contribute.
•If you remove an editable region from a template, a Contribute user editing a page based on that template might
be confused about what to do with the content that was in that editable region.
To update a template in a Contribute site, complete the following steps.
1OpentheContributetemplateinDreamweaver,editit,andthensaveit.Forinstructions,see“Openatemplatefor
editing” on page 409.
2Notify all of the Contribute users who are working on the site to restart Contribute.
Delete a template file
1In the Assets panel (Window > Assets), select the Templates category on the left side of the panel .
2Click the name of the template to select it.
3Click the Delete button at the bottom of the panel, then confirm that you want to delete the template.
Important: After you delete a template file, you can’t retrieve it. The template file is deleted from your site.
September 4, 2007
DREAMWEAVER CS3
User Guide
412
Documents that are based on a deleted template are not detached from the template; they retain the structure and
editableregionsthatthetemplatefilehadbeforeitwasdeleted.YoucanconvertsuchadocumentintoanHTMLfile
without editable or locked regions.
See also
“Detach a document from a template” on page 414
“Applying or removing a template from an existing document” on page 413
“Creating a Dreamweaver template” on page 395
Exporting and importing template content
About template XML content
You can think of a document based on a template as containing data represented by name-value pairs. Each pair
consists of the name of an editable region, and the contents of that region.
You can export the name-value pairs into an XML file so that you can work with the data outside of Dreamweaver
(for example, in an XML editor or a text editor, or a database application). Conversely, if you have an XML document
that’s structured appropriately, you can import the data from it into a document based on a Dreamweaver template.
Export a document’s editable regions as XML
1Open a template-based document that contains editable regions.
2Select File > Export > Template Data As XML.
3Select one of the Notation options:
•If the template contains repeating regions or template parameters, select Use Standard Dreamweaver XML Tag.
•If the template does not contain repeating regions or template parameters, select Use Editable Region Names as
XML Tags.
4Click OK.
5In the dialog box that appears, select a folder location, enter a name for the XML file, and then click Save.
An XML file is generated that contains the material from the document’s parameters and editable regions, including
editable regions inside repeating regions or optional regions. The XML file includes the name of the original
template, as well as the name and contents of each template region.
Note: Content in the non-editable regions is not exported to the XML file.
Import XML content
1Select File > Import > Import XML into Template.
2Select the XML file and click Open.
Dreamweaver creates a new document based on the template specified in the XML file. It fills in the contents of each
editable region in that document using the data from the XML file. The resulting document appears in a new
Document window.
September 4, 2007
DREAMWEAVER CS3
User Guide
413
If your XML file isn’t set up exactly the way Dreamweaver expects, you might not be able to import your data. One
solution to this problem is to export a dummy XML file from Dreamweaver, so that you’ll have an XML file with
exactly the right structure. Then copy the data from your original XML file into the exported XML file. The result is an
XML file with the correct structure that contains the appropriate data, ready to be imported.
Export a site without template markup
You can export template-based documents in a site to another site without including the template markup.
1Select Modify > Templates > Export Without Markup.
2IntheFolderbox,enterthefilepathtothefolderyouwanttoexportthefiletoorclickBrowseandselectthefolder.
Note: You must select a folder outside of the current site.
3If you want to save an XML version of exported template-based documents, select Keep Template Data Files.
4If you want to update changes to previously exported files, select Extract Only Changed Files and click OK.
Applying or removing a template from an existing
document
Apply a template to an existing document
When you apply a template to a document which contains existing content, Dreamweaver attempts to match the
existing content to a region in the template. If you are applying a revised version of one of your existing templates,
the names are likely to match.
If you apply a template to a document that hasn’t had a template applied to it, there are no editable regions to compare
and a mismatch occurs. Dreamweaver tracks these mismatches so you can select which region or regions to move
the current page’s content to, or you can delete the mismatched content.
You can apply a template to an existing document using the Assets panel or from the Document window. You can
undo a template application if necessary.
Important: When you apply a template to an existing document, the template replaces the document’s contents with the
template’s boilerplate content. Always backup a page’s contents before applying a template to it.
Apply a template to an existing document using the Assets panel
1Open the document you want to apply the template to.
2In the Assets panel (Window > Assets), select the Templates category on the left side of the panel .
3Do one of the following:
•Drag the template you want to apply from the Assets panel to the Document window.
•Select the template you want to apply, then click the Apply button at the bottom of the Assets panel.
If content exists in the document that can’t be automatically assigned to a template region, the Inconsistent Region
Names dialog box appears.
4SelectadestinationforthecontentbyusingtheMoveContenttoNewRegionmenutoselectoneofthefollowing:
•Select a region in the new template to move the existing content to.
September 4, 2007
DREAMWEAVER CS3
User Guide
414
•Select Nowhere to remove the content from the document.
5To move all unresolved content to the selected region, click Use For All.
6Click OK to apply the template or click Cancel to cancel the application of the template to the document.
Important: When you apply a template to an existing document, the template replaces the document’s contents with the
template’s boilerplate content. Always backup a page’s contents before applying a template to it.
Apply a template to an existing document from the Document window
1Open the document you want to apply the template to.
2Select Modify > Templates > Apply Template to Page.
The Select Template dialog box appears.
3Choose a template from the list, then click Select.
If content exists in the document that can’t be automatically assigned to a template region, the Inconsistent Region
Names dialog box appears.
4SelectadestinationforthecontentbyusingtheMoveContenttoNewRegionmenutoselectoneofthefollowing:
•Select a region in the new template to move the existing content to.
•Select Nowhere to remove the content from the document.
5To move all unresolved content to the selected region, click Use For All.
6Click OK to apply the template or click Cancel to cancel the application of the template to the document.
Important: When you apply a template to an existing document, the template replaces the document’s contents with the
template’s boilerplate content. Always backup a page’s contents before applying a template to it.
Undo the template changes
❖Select Edit > Undo Apply Template.
The document reverts to its state before the template was applied.
Detach a document from a template
Tomakechangestothelockedregionsofadocumentbasedonatemplate,youmustdetachthedocumentfromthe
template. When the document is detached, the entire document becomes editable.
1Open the template-based document you want to detach.
2Select Modify > Templates > Detach from Template.
The document is detached from the template and all template code is removed.
Editing content in a template-based document
About editing content in template-based documents
Dreamweaver templates specify regions that are locked (uneditable) and others that are editable for template-based
documents.
September 4, 2007
DREAMWEAVER CS3
User Guide
415
In pages based on templates, template users can edit content in editable regions only. You can easily identify and
select editable regions to edit content. Template users cannot edit content in locked regions
Note: If you try to edit a locked region in a document based on a template when highlighting is turned off, the mouse
pointer changes to indicate that you can’t click in a locked region.
Template users can also modify properties and edit entries for a repeating region in template-based documents.
See also
“Create a page based on an existing template” on page 72
“About Dreamweaver templates” on page 387
“Select editable regions” on page 399
Modify template properties
When template authors create parameters in a template, documents based on the template automatically inherit the
parameters and their initial value settings. A template user can update editable tag attributes and other template
parameters (such as optional region settings).
See also
“Template parameters” on page 390
“Using optional regions” on page 402
“Defining editable tag attributes” on page 404
Modify an editable tag attribute
1Open the template-based document.
2Select Modify > Template Properties.
The Template Properties dialog box opens, showing a list of available properties. The dialog box shows optional
regions and editable tag attributes.
3In the Name list, select the property.
The bottom area of the dialog box updates to show the selected property’s label and its assigned value.
4In the field to the right of the property label, edit the value to modify the property in the document.
Note: The field name and updateable values are defined in the template. Attributes that do not appear in the Name list
are not pocketable in the template-based document.
5Select Allow Nested Templates To Control This if you want to pass the editable property along to a documents
based on the nested template.
Modify optional region template parameters
1Open the template-based document.
2Select Modify > Template Properties.
The Template Properties dialog box opens, showing a list of available properties. The dialog box shows optional
regions and editable tag attributes.
September 4, 2007
DREAMWEAVER CS3
User Guide
416
3In the Name list, select a property.
The dialog box updates to show the selected property’s label and its assigned value.
4Select Show to display the optional region in the document, or deselect Show to hide the optional region.
Note: The field name and default setting are defined in the template,.
5Select Allow Nested Templates To Control This if you want to pass the editable property along to a documents
based on the nested template.
Add, delete, and change the order of a repeating region entry
Use repeating region controls to add, delete, or change the order of entries in template-based documents. When you
add a repeating region entry, a copy of the entire repeating region is added. To update the content in the repeating
regions, the original template must include an editable region in the repeating region.
See also
“Creating repeating regions” on page 399
Add, delete, or change the order of a repeating region
1Open the template-based document.
2Place the insertion point in the repeating region to select it.
3Do one of the following:
•Click the Plus (+) button to add a repeating region entry below the currently selected entry.
•Click the Minus (–) button to delete the selected repeating region entry.
•Click the Down Arrow button to move the selected entry down one position.
•Click the Up Arrow button to move the selected entry up one position.
Note: Alternatively, you can select Modify > Template, then select one of the repeating entry options near the bottom of
the context menu. You can use this menu to insert a new repeating entry or move the selected entry’s position.
Cut, copy, and delete entries
1Open the template-based document.
2Place the insertion point in the repeating region to select it.
3Do one of the following:
•To cut a repeating entry, select Edit > Repeating Entries > Cut Repeating Entries.
•To copy a repeating entry, select Edit > Repeating Entries > Copy Repeating Entries.
•To remove a repeating entry, select Edit > Repeating Entries > Delete Repeating Entries.
September 4, 2007
DREAMWEAVER CS3
User Guide
417
•To paste a repeating entry, select Edit > Paste.
Note: Pasting inserts a new entry; it does not replace an existing entry.
Template syntax
General syntax rules
Dreamweaver uses HTML comment tags to specify regions in templates and template-based documents, so
template-based documents are still valid HTML files. When you insert a template object, template tags are inserted
in the code.
General syntax rules are as follows:
•Wherever a space appears, you can substitute any amount of white space (spaces, tabs, line breaks). The white
space is mandatory except at the very beginning or end of a comment.
•Attributes can be given in any order. For example, in a TemplateParam, you can specify the type before the name.
•Comment and attribute names are case sensitive.
•All attributes must be in quotation marks. Single or double quotes can be used.
Template tags
Dreamweaver uses the following template tags:
<!-- TemplateBeginEditable name="..." -->
<!-- TemplateEndEditable -->
<!-- TemplateParam name="..." type="..." value="..." -->
<!-- TemplateBeginRepeat name="..." -->
<!-- TemplateEndRepeat -->
<!-- TemplateBeginIf cond="..." -->
<!-- TemplateEndIf -->
<!-- TemplateBeginPassthroughIf cond="..." -->
<!-- TemplateEndPassthroughIf -->
<!-- TemplateBeginMultipleIf -->
<!-- TemplateEndMultipleIf -->
<!-- TemplateBeginPassthroughMultipleIf -->
<!-- TemplateEndPassthroughMultipleIf -->
<!-- TemplateBeginIfClause cond="..." -->
<!-- TemplateEndIfClause -->
<!-- TemplateBeginPassthroughIfClause cond="..." -->
<!-- TemplateEndPassthroughIfClause -->
<!-- TemplateExpr expr="..." --> (equivalent to @@...@@)
<!-- TemplatePassthroughExpr expr="..." -->
<!-- TemplateInfo codeOutsideHTMLIsLocked="..." -->
Instance tags
Dreamweaver uses the following instance tags:
September 4, 2007
DREAMWEAVER CS3
User Guide
418
<!-- InstanceBegin template="..." codeOutsideHTMLIsLocked="..." -->
<!-- InstanceEnd -->
<!-- InstanceBeginEditable name="..." -->
<!-- InstanceEndEditable -->
<!-- InstanceParam name="..." type="..." value="..." passthrough="..." -->
<!-- InstanceBeginRepeat name="..." -->
<!-- InstanceEndRepeat -->
<!-- InstanceBeginRepeatEntry -->
<!-- InstanceEndRepeatEntry -->
Check template syntax
Dreamweaverchecksthetemplatesyntaxwhenyousaveatemplate,butyoucanmanuallycheckthetemplatesyntax
prior to saving a template. For example, if you add a template parameter or expression in Code view, you can check
that the code follows correct syntax.
1Open the document you want to check in the Document window.
2Select Modify > Templates > Check Template Syntax.
An error message appears if the syntax is badly formed. The error message describes the error and refers to the
specific line in the code where the error exists.
See also
“Recognizing templates and template-based documents” on page 392
“Template expressions” on page 390
Setting authoring preferences for templates
Customize code coloring preferences for a template
Code color preferences control the text, background color, and style attributes of the text displayed in Code view.
You can set your own color scheme so you can easily distinguish template regions when you view a document in
Code view.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select Code Coloring from the category list on the left.
3Select HTML from the Document Type list, then click the Edit Coloring Scheme button.
4In the Styles For list select Template Tags.
5Set color, background color, and style attributes for the Code view text by doing the following:
•If you want to change the text color, in the Text Color box type the hexadecimal value for the color you want to
apply to the selected text, or use the color picker to select a color to apply to the text. Do the same in the
Background field to add or change an existing background color for the selected text.
•If you want to add a style attribute to the selected code, click the B (bold), I (italic), or U (underline) buttons to set
the desired format.
6Click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
419
Note: If you want to make global changes, you can edit the source file that stores your preferences. On Windows XP, this
is located at C:\Documents and Settings\%username%\Application Data\Adobe\Dreamweaver 9\Configu-
ration\CodeColoring\Colors.xml. On Windows Vista, this is located at C:\Users\%username%\Application
Data\Adobe\Dreamweaver 9\Configuration\CodeColoring\Colors.xml
Set highlighting preferences for template regions
You can use the Dreamweaver highlighting preferences to customize the highlight colors for the outlines around the
editable and locked regions of a template in Design view. The editable region color appears in the template as well as
in documents based on the template.
See also
“Recognizing template-based documents in Design view” on page 393
“Recognizing templates in Design view” on page 392
Change template highlight colors
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select Highlighting from the category list on the left.
3Click the Editable Regions, Nested Regions, or Locked Regions color box, then select a highlight color using the
color picker (or enter the hexadecimal value for the highlight color in the box).
For information about using the color picker, see “Use the color picker” on page 223.
4(Optional) Repeat the process for other template region types, as necessary.
5Click the Show option to enable or disable displaying colors in the Document window.
Note: Nested Region does not have a Show option; its display is controlled by the Editable Region option.
6Click OK.
View highlight colors in the Document window
❖Select View > Visual Aids > Invisible Elements.
Highlight colors appear in the document window only when View > Visual Aids > Invisible Elements is enabled and
the appropriate options are enabled in Highlighting preferences.
Note: If invisible elements are showing but the highlight colors are not, select Edit > Preferences (Windows) or
Dreamweaver > Preferences (Macintosh), and then select the Highlight category. Make sure that the Show option next
to the appropriate highlight color is selected. Also make sure that the desired color is visible against the background color
of your page.
September 4, 2007
420
Chapter 15: Displaying XML data
Adobe® Dreamweaver® CS3 includes tools that let you display Extensible Markup Language (XML) data on your web
page and create pages that perform Extensible Stylesheet Language Transformations (XSLT) on either the client or
the server.
About XML and XSLT
Using XML and XSL with web pages
Extensible Markup Language (XML) is a language that lets you structure information. Like HTML, XML lets you
structure your information using tags, but XML tags are not predefined as HTML tags are. Instead, XML lets you
create tags that best define your data structure (schema). Tags are nested within others to create a schema of parent
and child tags. Like most HTML tags, all tags in an XML schema have an opening and closing tag.
The following example shows the basic structure of an XML file:
<?xml version=“1.0”>
<mybooks>
<book bookid=“1”>
<pubdate>03/01/2004</pubdate>
<title>Displaying XML Data with Adobe Dreamweaver</title>
<author>Charles Brown</author>
</book>
<book bookid=“2”>
<pubdate>04/08/2004</pubdate>
<title>Understanding XML</title>
<author>John Thompson</author>
</book>
</mybooks>
In this example, each parent <book> tag contains three child tags: <pubdate>,<title>, and <author>. But each
<book> tag is also a child tag of the <mybooks> tag, which is one level higher in the schema. You can name and
structure XML tags in any way, provided that you nest tags accordingly within others, and assign each opening tag
a corresponding closing tag.
XML documents do not contain any formatting—they are simply containers of structured information. Once you
have an XML schema, you can use the Extensible Stylesheet Language (XSL) to display the information. In the way
that Cascading Style Sheets (CSS) let you format HTML, XSL lets you format XML data. You can define styles, page
elements, layout, and so forth in an XSL file and attach it to an XML file so that when a user views the XML data in
a browser, the data is formatted according to whatever you’ve defined in the XSL file. The content (the XML data)
and presentation (defined by the XSL file) are entirely separate, providing you with greater control over how your
information appears on a web page. In essence, XSL is a presentation technology for XML, where the primary output
is an HTML page.
September 4, 2007
DREAMWEAVER CS3
User Guide
421
Extensible Stylesheet Language Transformations (XSLT) is a subset language of XSL that actually lets you display
XML data on a web page, and “transform” it, along with XSL styles, into readable, styled information in the form of
HTML. You can use Dreamweaver to create XSLT pages that let you perform XSL transformations using an appli-
cation server or a browser. In a server-side XSL transformation, the server does the work of transforming the XML
and XSL, and displaying it on the page. In a client-side transformation, a browser (such as Internet Explorer) does
the work.
The approach you ultimately take (server-side transformations versus client-side transformations) depends on what
you are trying to achieve as an end result, the technologies available to you, the level of access you have to XML
source files, and other factors. Both approaches have their own benefits and limitations. For example, server-side
transformations work in all browsers while client-side transformations are restricted to modern browsers only
(Internet Explorer 6, Netscape 8, Mozilla 1.8, and Firefox 1.0.2). Server-side transformations let you display XML
data dynamically from your own server or from anywhere else on the web, while client-side transformations must
use XML data that is locally hosted on your own web server. Finally, server-side transformations require that you
deploy your pages to a configured application server, while client-side transformations only require access to a web
server.
For a tutorial about understanding XML, see www.adobe.com/go/vid0165.
Server-side XSL transformations
Dreamweaver provides methods for creating XSLT pages that let you perform server-side XSL transformations.
When an application server performs the XSL transformation, the file containing the XML data can reside on your
own server, or anywhere else on the web. Additionally, any browser can display the transformed data. Deploying
pages for server-side transformations, however, is somewhat complex, and requires that you have access to an appli-
cation server.
When working with server-side XSL transformations, you can use Dreamweaver to create XSLT pages that generate
full HTML documents (entire XSLT pages), or XSLT fragments that generate a portion of an HTML document. An
entire XSLT page is similar to a regular HTML page. It contains a <body> tag and a <head> tag, and lets you display
a combination of HTML and XML data on the page. An XSLT fragment is a piece of code, used by a separate
document,thatdisplaysformattedXMLdata.UnlikeanentireXSLTpage,itisanindependentfilethatcontainsno
<body> or <head> tag. If you want to display XML data on a page of its own, you would create an entire XSLT page,
and bind your XML data to it. If, on the other hand, you wanted to display XML data in a particular section of an
existing dynamic page—for example, a dynamic home page for a sporting goods store, with sports scores from an
RSS feed displayed on one side of the page—you would create an XSLT fragment and insert a reference to it in the
dynamic page. Creating XSLT fragments, and using them in conjunction with other dynamic pages to display XML
data, is the more common scenario.
September 4, 2007
DREAMWEAVER CS3
User Guide
422
The first step in creating these types of pages is to create the XSLT fragment. It is a separate file that contains the
layout, formatting, and so on of the XML data that you eventually want to display in the dynamic page. Once you
create the XSLT fragment, you insert a reference to it in your dynamic page (for example, a PHP or ColdFusion page).
The inserted reference to the fragment works much like an Server Side Include (SSI) — the formatted XML data (the
fragment) resides in a separate file, while in Design view, a placeholder for the fragment appears on the dynamic page
itself. When a browser requests the dynamic page containing the reference to the fragment, the server processes the
included instruction and creates a new document in which the formatted contents of the fragment appear instead of
the placeholder.
You use the XSL Transformation server behavior to insert the reference to an XSLT fragment in a dynamic page.
When you insert the reference, Dreamweaver generates an includes/MM_XSLTransform/ folder in the site’s root
folder that contains a runtime library file. The application server uses the functions defined in this file when trans-
forming the specified XML data. The file is responsible for fetching the XML data and XSLT fragments, performing
the XSL transformation, and outputting the results on the web page.
The file containing the XSLT fragment, the XML file containing your data, and the generated run-time library file
must all be on the server for your page to display correctly. (If you select a remote XML file as your data source—one
from an RSS feed, for example—that file must of course reside somewhere else on the Internet.)
September 4, 2007
DREAMWEAVER CS3
User Guide
423
You can also use Dreamweaver to create entire XSLT pages for use with server-side transformations. An entire XSLT
pageworksinexactlythesamewayasanXSLTfragment,onlywhenyouinsertthereferencetotheentireXSLTpage
using the XSL Transformation server behavior, you are inserting the full contents of an HTML page. Thus, the
dynamic page (the .cfm, .php, .asp, or .net page that acts as the container page) must be cleared of all HTML before
you insert the reference.
Dreamweaver supports XSL transformations for ColdFusion, ASP, ASP.NET, and PHP pages.
Note: Your server must be correctly configured to perform server-side transformations. For more information, contact
your server administrator, or visit www.adobe.com/go/dw_xsl.
See also
“Performing XSL transformations on the server” on page 427
Client-side XSL transformations
You can perform XSL transformations on the client without the use of an application server. You can use
Dreamweaver to create an entire XSLT page that will do this; however, client-side transformations require manipu-
lation of the XML file that contains the data you want to display. Additionally, client-side transformations will only
work in modern browsers (Internet Explorer 6, Netscape 8, Mozilla 1.8, and Firefox 1.0.2). For more information on
browsers that do and don’t support XSL transformations, see www.w3schools.com/xsl/xsl_browsers.asp.
First, create an entire XSLT page and attach an XML data source. (Dreamweaver prompts you to attach the data
source when you create the new page.) You can create an XSLT page from scratch, or you can convert an existing
HTML page to an XSLT page. When you convert an existing HTML page to an XSLT page you must attach an XML
data source using the Bindings panel (Window > Bindings).
After you’ve created your XSLT page, you must link it to the XML file containing the XML data by inserting a
reference to the XSLT page in the XML file itself (much like you would insert a reference to an external CSS style
sheet in the <head> section of an HTML page). Your site visitors must view the XML file (not the XSLT page) in a
browser. When your site visitors view the page, the browser performs the XSL transformation and displays the XML
data, formatted by the linked XSLT page.
September 4, 2007
DREAMWEAVER CS3
User Guide
424
The relationship between the linked XSLT and XML pages is conceptually similar, yet different from the external
CSS/HTML page model. When you have an HTML page that contains content (such as text), you use an external
style sheet to format that content. The HTML page determines the content, and the external CSS code, which the
user never sees, determines the presentation. With XSLT and XML, the situation is reversed. The XML file (which
the user never sees in its raw form), determines the content while the XSLT page determines the presentation. The
XSLT page contains the tables, layout, graphics, and so forth that the standard HTML usually contains. When a user
views the XML file in a browser, the XSLT page formats the content.
When you use Dreamweaver to link an XSLT page to an XML page, Dreamweaver inserts the appropriate code for
you at the top of the XML page. If you own the XML page to which you’re linking (that is, if the XML file exclusively
lives on your web server), all you need to do is use Dreamweaver to insert the appropriate code that links the two
pages. When you own the XML file, the XSL transformations performed by the client are fully dynamic. That is,
whenever you update the data in the XML file, any HTML output using the linked XSLT page will be automatically
updated with the new information.
Note: TheXMLandXSLfilesyouuseforclient-sidetransformationsmustresideinthesamedirectory.Iftheydon’t,the
browser will read the XML file and find the XSLT page for the transformation, but will fail to find assets (style sheets,
images, and so on) defined by relative links in the XSLT page.
If you don’t own the XML page to which you’re linking (for example, if you want to use XML data from an RSS feed
somewhere out on the web), the workflow is a bit more complicated. To perform client-side transformations using
XML data from an external source, you must first download the XML source file to the same directory where your
XSLT page resides. When the XML page is in your local site, you can use Dreamweaver to add the appropriate code
that links it to the XSLT page, and post both pages (the downloaded XML file and the linked XSLT page) to your web
server. When the user views the XML page in a browser, the XSLT page formats the content, just like in the previous
example.
September 4, 2007
DREAMWEAVER CS3
User Guide
425
The disadvantage of performing client-side XSL transformations on XML data that comes from an external source
is that the XML data is only partially “dynamic.” The XML file that you download and alter is merely a “snapshot” of
thefilethatliveselsewhereontheweb.IftheoriginalXMLfileoutonthewebchanges,youmustdownloadthefile
again, link it to the XSLT page, and repost the XML file to your web server. The browser only renders the data that
it receives from the XML file on your web server, not the data contained in the original XML source file.
See also
“Performing XSL transformations on the client” on page 444
XML data and repeating elements
The Repeating Region XSLT object lets you display repeating elements from an XML file within a page. Any region
containing an XML data placeholder can be turned into a repeated region. However, the most common regions are
a table, a table row, or a series of table rows.
The following example shows how the Repeating Region XSLT object is applied to a table row that displays menu
information for a restaurant. The initial row displays three different elements from the XML schema: item,
description,andprice.WhentheRepeatingRegionXSLTobjectisappliedtothetablerow,andthepageisprocessed
by an application server or a browser, the table is repeated with unique data inserted in each new table row.
September 4, 2007
DREAMWEAVER CS3
User Guide
426
When you apply a Repeating Region XSLT object to an element in the Document window, a thin, tabbed, gray
outline appears around the repeated region. When you preview your work in a browser (File > Preview in Browser),
the gray outline disappears and the selection expands to display the specified repeating elements in the XML file, as
in the previous illustration.
When you add the Repeating Region XSLT object to the page, the length of the XML data placeholder in the
Document window is truncated. This is because Dreamweaver updates the XPath (XML Path language) expression
for the XML data placeholder so that it is relative to the path of the repeating element.
For example, the following code is for a table that contains two dynamic placeholders, without a Repeating Region
XSLT object applied to the table:
<table width="500" border="1">
<tr>
<td><xsl:value-of select="rss/channel/item/title"/></td>
</tr>
<tr>
<td><xsl:value-of select="rss/channel/item/description"/></td>
</tr>
</table>
The following code is for the same table with the Repeating Region XSLT object applied to it:
<xsl:for-each select="rss/channel/item">
<table width="500" border="1">
<tr>
<td><xsl:value-of select="title"/></td>
</tr>
<tr>
<td><xsl:value-of select="description"/></td>
</tr>
</table>
</xsl:for-each>
In the previous example, Dreamweaver has updated the XPath for the items that fall within the Repeating Region
(title & description) to be relative to the XPath in the enclosing <xsl:for-each> tags, rather than the full document.
Dreamweaver generates context-relative XPath expressions in other cases as well. For example, if you drag an XML
data placeholder to a table that already has a Repeating Region XSLT object applied to it, Dreamweaver automatically
displays the XPath relative to the existing XPath in the enclosing <xsl:for-each> tags.
See also
“Display repeating XML elements” on page 432
Previewing XML data
When you use Preview in Browser (File > Preview in Browser) to preview XML data that you’ve inserted in an XSLT
fragment or an entire XSLT page, the engine that performs the XSL transformation differs from situation to situation.
For dynamic pages containing XSLT fragments, the application server always performs the transformation. At other
times, either Dreamweaver or the browser might be performing the transformation.
The following table summarizes the situations when using Preview in Browser, and the engines that perform the
respective transformations:
September 4, 2007
DREAMWEAVER CS3
User Guide
427
The following topics provide guidelines for helping you determine the appropriate previewing methods, based on
your needs.
Previewing pages for server-side transformations
In the case of server-side transformations, the content the site visitor ultimately sees is transformed by your appli-
cation server. When building XSLT and dynamic pages for use with server-side transformations, it is always
preferable to preview the dynamic page that contains the XSLT fragment instead of the XSLT fragment itself. In the
formerscenario,youmakeuseoftheapplicationserver,whichensuresthatyourpreviewisconsistentwithwhatyour
sitevisitorswillseewhentheyvisityourpage.Inthelatterscenario,Dreamweaverperformsthetransformation,and
could provide slightly inconsistent results. You can use Dreamweaver to preview your XSLT fragment while you are
building it, but you’ll be able to see the most accurate results of the data rendering if you use the application server
to preview your dynamic page after you’ve inserted the XSLT fragment.
Previewing pages for client-side transformations
In the case of client-side transformations, the content the site visitor ultimately sees is transformed by a browser. You
accomplish this by adding a link from the XML file to the XSLT page. If you open the XML file in Dreamweaver and
preview it in a browser, you force the browser to load the XML file and perform the transformation. This provides
you with the same experience as that of your site visitor.
Using this approach, however, makes it more difficult to debug your page because the browser transforms the XML
and generates the HTML internally. If you select the browser’s View Source option to debug the generated HTML,
you will only see the original XML that the browser received, not the full HTML (tags, styles, and so forth) respon-
siblefortherenderingofthepage.ToseethefullHTMLwhenviewingsourcecode,youmustpreviewtheXSLTpage
in a browser instead.
Previewing entire XSLT pages and XSLT fragments
When creating entire XSLT pages and XSLT fragments, you’ll want to preview your work to make sure that your data
is being displayed correctly. If you use Preview in Browser to display an entire XSLT page or an XSLT fragment,
Dreamweaver performs the transformation using a built-in transformation engine. This method gives you quick
results, and makes it easier for you to incrementally build and debug your page. It also provides a way for you to view
the full HTML (tags, styles, and so forth) by selecting the View Source option in the browser.
Note: This previewing method is commonly used when you begin building XSLT pages, regardless of whether you use
the client or the server to transform your data.
Performing XSL transformations on the server
Workflow for performing server-side XSL transformations
You can perform server-side XSL transformations on the server. Read about server-side and client-side XSL trans-
formations and about using XML and XSL with web pages before building pages that display XML data.
Type of page previewed in browser Data transformation performed by
Dynamic page containing XSLT fragment Application server
XSLT fragment or entire XSLT page Dreamweaver
XML file with link to entire XSLT page Browser
September 4, 2007
DREAMWEAVER CS3
User Guide
428
Note: Your server must be correctly configured to perform server-side transformations. For more information, contact
your server administrator, or visit www.adobe.com/go/dw_xsl.
The general workflow for performing server-side XSL transformations is as follows (each step is described in other
topics):
1. Set up a Dreamweaver site.
2. Choose a server technology and set up an application server.
3. Test the application server.
Forexample,createapagethatrequiresprocessing,andmakesurethattheapplicationserverprocessesthepage.For
a tutorial on how to do this, visit www.adobe.com/go/dw_xsl.
4. Create an XSLT fragment or page, or convert an HTML page to an XSLT page.
•In your Dreamweaver site, create an XSLT fragment or an entire XSLT page.
•Convert an existing HTML page to an entire XSLT page.
5. Attach an XML data source to the page.
6. Display XML data by binding the data to the XSLT fragment or to the entire XSLT page.
7. If appropriate, add a Repeating Region XSLT object to the table or table row that contains the XML data
placeholders.
8. Insert references.
•To insert a reference to the XSLT fragment in your dynamic page, use the XSL Transformation server behavior.
•To insert a reference to the entire XSLT page in the dynamic page, delete all of the HTML code from a dynamic
page, and then use the XSL Transformation server behavior.
9. Post the page and the fragment.
Post both the dynamic page and the XSLT fragment (or entire XSLT page) to your application server. If you are using
a local XML file, you will need to post that as well.
10. View the dynamic page in a browser.
When you do so, the application server transforms the XML data, inserts it in the dynamic page, and displays it in
the browser.
See also
“Setting up a Dreamweaver site” on page 40
“Choosing your application server” on page 502
“Using XML and XSL with web pages” on page 420
“Client-side XSL transformations” on page 423
“Server-side XSL transformations” on page 421
September 4, 2007
DREAMWEAVER CS3
User Guide
429
Create an XSLT page
You can create XSLT pages that let you display XML data on web pages. You can create either an entire XSLT page—
an XSLT page that contains a <body> tag and a <head> tag—or you can create an XSLT fragment. When you create
an XSLT fragment, you create an independent file that contains no body or head tag—a simple piece of code that is
later inserted in a dynamic page.
Note: If you are starting with an existing XSLT page, you need to attach an XML data source to it.
1Select File > New.
2In the Blank Page category of the New Document dialog box, select one of the following from the Page Type
column:
•Select XSLT (Entire page) to create an entire XSLT page.
•Select XSLT (Fragment) to create an XSLT fragment.
3Click Create and do one of the following in the Locate XML Source dialog box:
•Select Attach A Local File, click the Browse button, browse to a local XML file on your computer, and click OK.
•Select Attach A Remote File, enter the URL of an XML file on the Internet (such as one coming from an RSS feed),
and click OK.
Note: Clicking the Cancel button generates a new XSLT page with no attached XML data source.
The Bindings panel is populated with the schema of your XML data source.
The following table provides an explanation of the various elements in the schema that might appear:
Element Represents Details
<> Required non-repeating XML
element
An element that appears exactly
once within its parent node
<>+ Repeating XML element An element that appears one or
more times within its parent node
September 4, 2007
DREAMWEAVER CS3
User Guide
430
4Save your new page (File > Save) with the .xsl or .xslt extension (.xsl is the default).
Convert HTML pages to XSLT pages
You can also convert existing HTML pages to XSLT pages. For example, if you have a predesigned static page to
which you want to add XML data, you can convert the page to an XSLT page, instead of creating an XSLT page and
redesigning the page from scratch.
1Open the HTML page that you want to convert.
2Select File > Convert > XSLT 1.0.
A copy of the page opens in the Document window. The new page is an XSL style sheet, saved with the .xsl extension.
Attach XML data sources
If you are starting with an existing XSLT page, or if you don’t attach an XML data source when creating a new XSLT
page with Dreamweaver, you must attach an XML data source using the Bindings panel.
1In the Bindings panel (Window > Bindings), click the XML link.
Note: You can also click the Source link at the upper-right corner of the Bindings panel to add an XML data source.
2Do one of the following:
•Select Attach A Local File, click the Browse button, browse to a local XML file on your computer, and click OK.
•Select Attach A Remote File, enter the URL of an XML file on the Internet (such as one coming from an RSS feed).
3Click OK to close the Locate XML Source dialog box.
The Bindings panel is populated with the schema of your XML data source.
<>+ Optional XML element An element that appears zero or
more times within its parent node
Element node in boldface type Current context element Normally the repeating element
when the insertion point is inside a
repeating region
@ XML attribute
Element Represents Details
September 4, 2007
DREAMWEAVER CS3
User Guide
431
Display XML data in XSLT pages
Afteryou’vecreatedanXSLTpageandattachedanXMLdatasource,youcanbinddatatothepage.Todothis,you
add an XML data placeholder to your page and then use the XPath Expression Builder or the Property inspector to
format selected data that will be displayed on the page.
1Open an XSLT page with an attached XML data source.
2(Optional) Select Insert > Table to add a table to the page. A table helps you organize your XML data.
Note: In most cases, you use the Repeating Region XSLT object to display repeating XML elements on a page. In this case,
you might want to create a single-row table with one or more columns, or a two-row table if you want to include a table
header.
3In the Bindings panel, select an XML element and drag it to the place on the page where you want to insert data.
An XML data placeholder appears on the page. The placeholder is highlighted and in curly brackets. It uses the XPath
(XML Path language) syntax to describe the hierarchical structure of the XML schema. For example, if you drag the
child element title to the page, and that element has the parent elements rss,channel, and item, then the syntax for
the dynamic content placeholder will be {rss/channel/item/title}.
Double-click the XML data placeholder on the page to open the XPath Expression Builder. The XPath Expression
Builder lets you format selected data, or select other items from the XML schema.
4(Optional) Apply styles to your XML data by selecting an XML data placeholder and applying styles to it like any
other piece of content using the Property inspector or the CSS Styles panel. Alternatively, you can use Design-time
style sheets to apply styles to XSLT fragments. Each of these methods has its own set of benefits and limitations.
5Preview your work in a browser (File > Preview in Browser).
Note: When you preview your work using Preview in Browser, Dreamweaver performs an internal XSL transformation
without the use of an application server.
September 4, 2007
DREAMWEAVER CS3
User Guide
432
See also
“Previewing XML data” on page 426
“Presenting content with tables” on page 176
Display repeating XML elements
The Repeating Region XSLT object lets you display repeating elements from an XML data source in a web page. For
example, if you are displaying article titles and descriptions from a news feed, and that news feed contains between
10 and 20 articles, each title and description in the XML file would probably be a child element of a repeating
element.
Any region in Design view containing an XML data placeholder can be changed to a repeated region. However, the
most common regions are tables, table rows, or a series of table rows.
1In Design view, select a region that contains an XML data placeholder or placeholders.
The selection can be anything, including a table, a table row, or even a paragraph of text.
Toselectaregiononthepageprecisely,youcanusethetagselectorinthelower-leftcorneroftheDocumentwindow.
For example, if the region is a table, click inside the table on the page, and then click the tag in the tag selector.
2Do one of the following
•Select Insert > XSLT Objects > Repeating Region.
•In the XSLT category of the Insert bar, click the Repeating Region button.
September 4, 2007
DREAMWEAVER CS3
User Guide
433
3In the XPath Expression Builder, select the repeating element, indicated by a small plus sign.
4Click OK.
In the Document window, a thin, tabbed, gray outline appears around the repeated region. When you preview your
work in a browser (File > Preview in Browser), the gray outline disappears and the selection expands to display the
specified repeating elements in the XML file.
When you add the Repeating Region XSLT object to the page, the XML data placeholder in the Document window
is truncated. This is because Dreamweaver truncates the XPath for the XML data placeholder so that it is relative to
the path of the repeating element.
See also
“Use the XPath Expression Builder to add expressions for XML data” on page 440
“XML data and repeating elements” on page 425
Set Repeating Region (XSL) properties
In the Property inspector, you can select a different XML node to create the repeating region.
❖In the Select box, enter a new node, and then press the lightning bolt icon and select the node from the XML
schema tree that appears.
Edit a Repeating Region XSLT object
After you’ve added a Repeating Region XSLT object to a region, you can edit it using the Property inspector.
1Select the object by clicking the gray tab that surrounds the repeated region.
2In the Property inspector (Window > Properties), click the dynamic icon next to the Select text field.
3In the XPath Expression Builder, make your changes and click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
434
Insert XSLT fragments in dynamic pages
After you have created an XSLT fragment, you can insert it in a dynamic web page using the XSL Transformation
server behavior. When you add the server behavior to your page and view the page in a browser, an application server
performs a transformation that displays the XML data from the selected XSLT fragment. Dreamweaver supports XSL
transformations for ColdFusion, ASP, ASP.NET, or PHP pages.
Note: If you want to insert the contents of an entire XSLT page in a dynamic page, the procedure is exactly the same.
Before using the XSL Transformation server behavior to insert the entire XSLT page, delete all HTML code from the
dynamic page.
1Open an existing ColdFusion, ASP, ASP.NET, or PHP page.
2In Design view, place the insertion point in the location where you want to insert the XSLT fragment.
Note: When inserting XSLT fragments, you should always click the Show Code And Design Views button after placing
the insertion point on the page so that you can ensure that the insertion point is in the correct location. If it isn’t, you
might need to click somewhere else in Code view to place the insertion point where you want it.
3In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select XSL Transfor-
mation.
4
In the XSL Transformation dialog box, click the Browse button and browse to an XSLT fragment or an entire XSLT page.
Dreamweaver populates the next text field with the file path or URL of the XML file that is attached to the specified
fragment. To change it, click the Browse button and browse to another file.
5(Optional) Click the Plus (+) button to add an XSLT parameter.
6Click OK to insert a reference to the XSLT fragment in the page. The fragment is not editable. You can double-
click the fragment to open the fragment’s source file and edit it.
An includes/MM_XSLTransform/ folder is also created in the site’s root folder that contains a runtime library file.
The application server uses the functions defined in this file to perform the transformation.
September 4, 2007
DREAMWEAVER CS3
User Guide
435
7Upload the dynamic page to your server (Site > Put) and click Yes to include dependent files. The file containing
the XSLT fragment, the XML file containing your data, and the generated run-time library file must all be on the
server for your page to display correctly. (If you selected a remote XML file as your data source, that file must reside
somewhere else on the Internet.)
See also
“Create an XSLT page” on page 429
“Server-side XSL transformations” on page 421
Delete XSLT fragments from dynamic pages
You can remove an XSLT fragment from a page by deleting the XSL Transformation server behavior used to insert
the fragment. Deleting the server behavior deletes the XSLT fragment only—it does not delete the associated XML,
XSLT, or run-time library files.
1In the Server Behaviors panel (Window > Server Behaviors), select the XSL Transformation server behavior that
you want to delete.
2Click the minus (-) button.
Note: You should always remove server behaviors in this fashion. Manually deleting the generated code only partially
removes the server behavior, even though the server behavior may disappear from the Server Behaviors panel.
Edit XSL Transformation server behaviors
After you’ve added an XSLT fragment to a dynamic web page, you can edit the XSL Transformation server behavior
at any time.
1In the Server Behaviors panel (Window > Server Behaviors), double-click the XSL Transformation server
behavior that you want to edit.
2Make your changes and click OK.
Create a dynamic link
You can create a dynamic link on your XSLT page that links to a specific URL when the user clicks a specified word
or group of words from your XML data. For full instructions, see the Dreamweaver errata at
www.adobe.com/go/dw_documentation.
Applying styles to XSLT fragments
WhenyoucreateanentireXSLTpage(thatis,anXSLTpagethatcontains<body> and <head> tags), you can display
XML data on the page and then format the data like any other piece of content using the Property inspector or the
CSS Styles panel. When you create an XSLT fragment for insertion in a dynamic page, however (for example, a
fragment for insertion in an ASP, PHP, or Cold Fusion page), the rendering of styles in the fragment and in the
dynamic page becomes more complicated. Although you work on an XSLT fragment separately from the dynamic
page, it is important to remember that the fragment is intended for use within the dynamic page, and that the output
from the XSLT fragment ultimately resides somewhere within the <body> tags of the dynamic page. Given this
workflow, it is important to make sure that you do not include <head> elements (such as style definitions or links to
external style sheets) in XSLT fragments. Doing so will cause the application server to place these elements into the
<body> of the dynamic page, thereby generating invalid markup.
September 4, 2007
DREAMWEAVER CS3
User Guide
436
Forexample,youmightwanttocreateanXSLTfragmentforinsertioninadynamicpageandformatthefragment
using the same external style sheet as the dynamic page. If you attach the same style sheet to the fragment, the
resulting HTML page contains a duplicate link to the style sheet (one in the <head> section of the dynamic page, and
another in the <body> section of the page, where the content of the XSLT fragment appears). Instead of this
approach, you should use Design-time style sheets to reference the external style sheet.
When formatting the content of XSLT fragments, use the following workflow:
•First, attach an external style sheet to the dynamic page. (This is a best practice for applying styles to the content
of any web page).
•Next, attach the same external style sheet to the XSLT fragment as a Design-time style sheet. As the name implies,
Design-time style sheets only work in the Dreamweaver Design view.
After you have completed the two previous steps, you can create new styles in your XSLT fragment using the same
style sheet that you’ve attached to your dynamic page. The HTML output will be cleaner (because the reference to
the style sheet is only valid while working in Dreamweaver), and the fragment will still display the appropriate styles
inDesignview.Additionally,allofyourstyleswillbeappliedtoboththefragmentandthedynamicpagewhenyou
view the dynamic page in Design view, or preview the dynamic page in a browser.
Note: If you preview the XSLT fragment in a browser, the browser does not display the styles. Instead you should preview
the dynamic page in the browser to see the XSLT fragment within the context of the dynamic page.
For more information on using CSS to format XSLT fragments, see www.adobe.com/go/dw_xsl_styles.
See also
“Use Design-Time style sheets” on page 143
Use parameters with XSL transformations
YoucandefineparametersforyourXSLtransformationwhenaddingtheXSLTransformationserverbehaviortoa
web page. A parameter controls how XML data is processed and displayed. For example, you might use a parameter
to identify and list a specific article from a news feed. When the page loads in a browser, only the article you specified
with the parameter appears.
Add an XSLT parameter to an XSL transformation
1Open the XSL Transformation dialog box. You can do this by double-clicking an XSL Transformation server
behavior in the Server Behaviors panel (Window > Server Behaviors), or by adding a new XSL Transformation server
behavior.
September 4, 2007
DREAMWEAVER CS3
User Guide
437
2In the XSL Transformation dialog box, click the Plus (+) button next to XSLT Parameters.
3In the Add Parameters dialog box, enter a name for the parameter in the Name box. The name can only contain
alphanumeric characters. It cannot contain spaces.
4Do one of the following:
•If you want to use a static value, enter it in the Value box.
•If you want to use a dynamic value, click the dynamic icon next to the Value box, complete the Dynamic Data
dialog box, and click OK. For more information, click the Help button in the Dynamic Data dialog box.
5In the Default Value box, enter the value you want the parameter to use if the page receives no run-time value, and
click OK.
Edit an XSLT parameter
1Open the XSL Transformation dialog box. You can do this by double-clicking an XSL Transformation server
behavior in the Server Behaviors panel (Window > Server Behaviors), or by adding a new XSL Transformation server
behavior.
2Select a parameter from the XSLT parameters list.
3Click the Edit button.
4Make your changes and click OK.
Delete an XSLT parameter
1Open the XSL Transformation dialog box. You can do this by double-clicking an XSL Transformation server
behavior in the Server Behaviors panel (Window > Server Behaviors), or by adding a new XSL Transformation server
behavior.
2Select a parameter from the XSLT parameters list.
3Click the minus (-)button.
Create and edit conditional XSLT regions
You can create simple conditional regions or multiple conditional regions on an XSLT page. You can either select an
element in Design view and apply a conditional region to the selection, or you can insert a conditional region
wherever the insertion point is in the document.
September 4, 2007
DREAMWEAVER CS3
User Guide
438
For example, if you wanted to display the word “Unavailable” next to the price of an item when the item is
unavailable, you type the text “Unavailable” on the page, select it, and then apply a conditional region to the selected
text. Dreamweaver surrounds the selection with <xsl:if> tags, and only displays the word “Unavailable” on the
page when the data match the conditions of the conditional expression.
Apply a conditional XSLT region
You can write a simple conditional expression to insert into your XSLT page. If content is selected when you open
the Conditional Region dialog box, the content will be wrapped in an <xsl:if> block. If you content is not selected,
the <xsl:if> block is added at the insertion point on the page. It’s a good idea to use the dialog box to get started
and then customize the expression in Code view.
The <xsl:if> element is similar to the if statement in other languages. The element provides a way for you to test
a condition and take a course of action based on the result. The <xsl:if> element allows you to test an expression
for a single true or false value.
1Select Insert > XSLT Objects > Conditional Region or click the Conditional Region icon in the XLST category of
the Insert bar.
2In the Conditional Region dialog box, enter the conditional expression to use for the region.
In the following example, you want to test to see if the context node’s @available attribute value is true.
3Click OK.
The following code is inserted in your XSLT page:
<xsl:if test="@available='true'">
Content goes here
</xsl:if>
Note: You must surround string values such as true in quotes. Dreamweaver encodes the quotes for you (') so that
they are entered as valid XHTML.
In addition to testing nodes for values, you can use any of the supported XSLT functions in any conditional
statement. The condition is tested for the current node within your XML file. In the following example, you want to
test for the last node in the result set:
September 4, 2007
DREAMWEAVER CS3
User Guide
439
For more information and examples on writing conditional expressions, see the <xsl:if> section in the Reference
panel (Help > Reference).
Apply multiple conditional XSLT regions
You can write a simple conditional expression to insert into your XSLT page. If content is selected when you open
the Conditional Region dialog box, the content is wrapped in an <xsl:choose> block. If you do not select content,
the <xsl:choose> block is added at the insertion point on the page. It’s a good idea to use the dialog box to get
started and then customize the expression in Code view.
The <xsl:choose> element is similar to the case statement in other languages. The element provides a way for you
to test a condition and take a course of action based on the result. The <xsl:choose> element allows you to test for
multiple conditions.
1Select Insert > XSLT Objects > Multiple Conditional Region or click the Multiple Conditional Region icon in the
XLST category of the Insert bar.
2In the Multiple Conditional Region dialog box, enter the first condition.
In the following example, you want to test to see if the context node’s price subelement is less than 5.
3Click OK.
In the example, the following code is inserted in your XSLT page:
<xsl:choose>
<xsl:when test="price<5">
Content goes here
</xsl:when>
<xsl:otherwise>
Content goes here
</xsl:otherwise>
</xsl:choose>
4To insert another condition, place the insertion point in Code view between <xsl:when> tag pairs or just before
the <xsl:otherwise> tag, and then insert a conditional region (Insert > XSLT Objects > Conditional Region).
After you specify the condition and click OK, another <xsl:when> tag is inserted in the <xsl:choose> block.
For more information and examples on writing conditional expressions, see the <xsl:choose> sections in the
Reference panel (Help > Reference).
Set conditional region (If) properties
The purpose of the Set Conditional Region Property inspector is to change the condition used in a conditional region
in your XSL page. The conditional region tests the condition and takes a course of action based on the result.
❖In the Test box, enter a new condition, and then press Enter.
September 4, 2007
DREAMWEAVER CS3
User Guide
440
Set conditional (When) properties
The purpose of the Set Conditional Region Property inspector is to change the condition used in a multiple condi-
tional region in your XSL page. The multiple conditional region tests the condition and takes a course of action based
on the result.
❖In the Test box, enter a new condition, and then press Enter.
Insert XSL comments
You can add XSL comment tags to a document, or you can wrap a selection in XSL comment tags.
Add XSL comment tags to a document
❖Do one of the following:
•In Design view, select Insert > XSLT Objects > XSL Comment, type the contents of the comment (or leave the box
blank), and click OK.
•In Code view, select Insert > XSLT Objects > XSL Comment.
You can also click on the XSL Comment icon in the XSLT category of the Insert bar.
Wrap a selection in XSL comment tags
1Switch to Code view (View > Code).
2Select the code you want to comment.
3In the Coding toolbar, click the Apply Comment button and select Apply <xsl:comment></xsl:comment>
Comment.
Use the XPath Expression Builder to add expressions for XML data
XPath (XML Path Language) is a non-XML syntax for addressing portions of an XML document. It is used mostly
as a query language for XML data, just as the SQL language is used to query databases. For more information on
XPath, see the XPath language specification on the W3C website at www.w3.org/TR/xpath.
The XPath Expression Builder is a Dreamweaver feature that lets you build simple XPath expressions for identifying
specific nodes of data and for repeating regions. The advantage of using this method instead of dragging values from
the XML schema tree is that you can format the value that is displayed. The current context is identified based on
the position of the insertion point in the XSL file when the XPath Expression Builder dialog box is opened. The
current context is in boldface type in the XML schema tree. As you make selections within this dialog box, the correct
XPath statements, relative to your current context, are generated. This simplifies the process of writing correct XPath
expressions for beginners and advanced users.
Note: This feature is designed to help you build simple XPath expressions to identify a specific node or for repeating
regions. It does not allow you to edit the expressions by hand. If you need to create complex expressions, use the XPath
Expression Builder to get started and then customize your expressions in Code view or with the Property inspector.
Create an XPath expression to identify a specific node
1Double-click the XML data placeholder on the page to open the XPath Expression Builder.
2In the XPath Expression Builder (Dynamic Text) dialog box, select any node in the XML schema tree.
The correct XPath expression is written in the Expression box to identify the node.
September 4, 2007
DREAMWEAVER CS3
User Guide
441
Note: If you select a different node in the XML schema tree, the expression changes to reflect your choice.
In the following example, you want to display the price subelement of the item node:
This selection would insert the following code in your XSLT page:
<xsl:value-of select="price"/>
3(Optional) Select a formatting option from the Format pop-up menu.
Formatting a selection is useful when the value of your node returns a number. Dreamweaver provides a predefined
list of formatting functions. For a complete list of available formatting functions and examples, see the Reference
panel.
In the following example, you want to format the price subelement as a currency with two decimal places:
September 4, 2007
DREAMWEAVER CS3
User Guide
442
These options would insert the following code in your XSLT page:
<xsl:value-of select="format-number(provider/store/items/item/price,'$#.00')"/>
4Click OK.
5To display the value of each node in the XML file, apply a repeating region to the element containing the dynamic
text (for example, an HTML table row or a paragraph).
For more information and examples on selecting nodes to return a value, see the <xsl:value-of/> section in the
Reference panel.
Select a node to repeat
You can select a node to repeat over and, optionally, to filter the results. In the XPath Expression Builder dialog box,
your selected content will be wrapped inside an <xsl:for-each> block. If you have not selected content, the
<xsl:for-each> block will be entered at the insertion point of your cursor.
1Double-click the XML data placeholder on the page to open the XPath Expression Builder.
2In the XPath Expression Builder (Repeating Region) dialog box, select the item to repeat in the XML schema tree.
The correct XPath expression is written in the Expression box to identify the node.
Note: Repeating items are identified with a Plus (+) symbol in the XML schema tree.
In the following example, you want to repeat each item node within the XML file.
When you click OK, the following code is inserted in your XSLT page:
<xsl:for-each select="provider/store/items/item">
Content goes here
</xsl:for-each>
In some cases, you may want to work with a subset of the repeating nodes—for example, you may only want items
where an attribute has a specific value. In this case, you need to create a filter.
September 4, 2007
DREAMWEAVER CS3
User Guide
443
Filter the data to be repeated
Use a filter to identify repeating nodes that have specific attribute values.
1In the XML schema tree, select a node to repeat.
2Click the Build Filter expander button.
3Click the Plus (+) button to create an empty filter.
4Enter the filter criteria in the following fields:
Filter By Specifies the repeating node that contains the data you want to filter by. The pop-up menu provides a list
of ancestor nodes relative to the node you selected in the XML schema tree.
Where Specifies the attribute or subelement of the Filter By node that will be used to limit the results. You can select
an attribute or subelement from the pop-up menu, or you can enter your own XPath expression in this field to
identify children that exist deeper within the schema tree.
Operator Specifies the comparison operator to use in the filter expression.
Value Specifies the value to check for in the Filter By node. Enter the value. If dynamic parameters are defined for
your XSLT page, you can select one from the pop-up menu.
5To specify another filter, click the Plus (+) button again.
As you enter values or make selections in the pop-up menus, the XPath expression in the Expression box changes.
Inthefollowingexample,youwanttorestricttheresultsettothoseitem nodes where the value of the @available
attribute is true.
When you click OK, the following code is inserted in your XSLT page:
<xsl:for-each select="provider/store/items/item[@available = 'true']">
Content goes here
</xsl:for-each>
September 4, 2007
DREAMWEAVER CS3
User Guide
444
Note: You need to surround string values such as true in quotes. Dreamweaver encodes the quotes for you (') so
that they are entered as valid XHTML.
You can create more complex filters that allow you to specify parent nodes as part of your filter criteria. In the
following example, you want to restrict the result set to those item nodes where the store’s @id attribute is equal to
1 and the item’s price node is greater than 5.
When you click OK, the following code is inserted in your XSLT page:
<xsl:for-each select="provider/store[@id = 1]/items/item[price > 5]">
Content goes here
</xsl:for-each>
For more information and examples of repeating regions, see the <xsl:for-each> section in the Reference panel.
Troubleshooting XSL transformations
If you can’t get your XSL transformations to work, look at the troubleshooting guide available at
www.adobe.com/go/dw_xsl_faq. It provides answers to many frequently asked questions.
Performing XSL transformations on the client
Workflow for performing client-side XSL transformations
You can perform client-side XSL transformations. Read about server-side and client-side XSL transformations and
about using XML and XSL with web pages before building pages that display XML data.
September 4, 2007
DREAMWEAVER CS3
User Guide
445
The general workflow for performing client-side XSL transformations is as follows (each step is described in other
topics):
1. Set up a Dreamweaver site.
2. Create an XSLT page or convert an HTML page to XSLT.
•In your Dreamweaver site, create an entire XSLT page.
•Convert an existing HTML page to an entire XSLT page.
3. Attach an XML data source to the page (if you haven’t already done so).
The XML file that you attach must reside in the same directory as the XSLT page.
4. Bind your XML data to the XSLT page.
5. Display XML data by binding the data to the entire XSLT page.
6. If appropriate, add a Repeating Region XSLT object to the table or table row that contains the XML data
placeholder(s).
7. Attach the XSLT page to the XML page.
8. Post both the XML page and the linked XSLT page to your web server.
9. View the XML page in a browser.
When you do so, the browser transforms the XML data, formats it with the XSLT page, and displays the styled page
in the browser.
See also
“Setting up a Dreamweaver site” on page 40
“Choosing your application server” on page 502
“Link an XSLT page to an XML page” on page 446
“Using XML and XSL with web pages” on page 420
“Client-side XSL transformations” on page 423
“Server-side XSL transformations” on page 421
Creating entire XSLT pages and displaying data
You must use an entire XSLT page for client-side transformations. (XSLT fragments don’t work for this type of trans-
formation.) Follow these general steps for creating, binding XML data to, and formatting XSLT pages for client-side
transformations:
September 4, 2007
DREAMWEAVER CS3
User Guide
446
1. Create the XSLT page.
2. Display data in the XSLT page.
3. Display repeating elements in the XSLT page.
4. Troubleshoot any problems.
See also
“Create an XSLT page” on page 429
“Display XML data in XSLT pages” on page 431
“Display repeating XML elements” on page 432
“Troubleshooting XSL transformations” on page 444
Link an XSLT page to an XML page
After you have an entire XSLT page with dynamic content placeholders for your XML data, you must insert a
reference to the XSLT page in the XML page.
Note: TheXMLandXSLfilesyouuseforclient-sidetransformationsmustresideinthesamedirectory.Iftheydon’t,the
browser will read the XML file and find the XSLT page for the transformation, but will fail to find assets (style sheets,
images, and so on) defined by relative links in the XSLT page.
1Open the XML file that you want to link to your XSLT page.
2Select Commands > Attach an XSLT Stylesheet.
3In the dialog box, click the Browse button, browse to the XSLT page you want to link to, select it, and click OK.
4Click OK to close the dialog box and insert the reference to the XSLT page at the top of the XML document.
Troubleshooting XSL transformations
If you can’t get your XSL transformations to work, look at the troubleshooting guide available at
www.adobe.com/go/dw_xsl_faq. It provides answers to many frequently asked questions.
Missing character entities
Specify a missing character entity
In XSLT, some characters are not allowed in certain contexts. For example, you cannot use the less than sign (<) and
the ampersand (&) in the text between tags or in an attribute value. The XSLT transformation engine will give you
an error if those characters are used incorrectly. To solve the problem, you can specify character entities to replace
the special characters.
A character entity is a string of characters that represents other characters. Character entities are either named or
numbered. A named entity begins with an ampersand (&) followed by the name or characters, and ends with a
semicolon (;). For example, < represents the left angle bracket character (<). Numbered entities also start and end
the same way, except that a hash sign (#) and a number specifies the character.
September 4, 2007
DREAMWEAVER CS3
User Guide
447
XSLT has the following five predefined entities:
If you use other character entities in an XSL file, you need to define them in the DTD section of the XSL file.
Dreamweaver provides several default entity definitions that you can see at the top of an XSL file created in
Dreamweaver. These default entities cover a broad selection of the most commonly used characters.
When you preview your XSL file in a browser, Dreamweaver checks the XSL file for undefined entities and notifies
you if an undefined entity is found.
If you preview an XML file attached to an XSLT file or if you preview a server-side page with an XSLT transfor-
mation, the server or browser (instead of Dreamweaver) notifies you of an undefined entity. The following is an
example of a message you may get in Internet Explorer when you request an XML file transformed by an XSL file
with a missing entity definition:
Reference to undefined entity 'auml'. Error processing resource
'http://localhost/testthis/list.xsl'. Line 28, Position 20
<p class=''test''>ä</p>
-------------------^
To correct the error in your page, you must add the entity definition to your page manually.
Specify a missing entity definition
1Look up the missing character in the character entity reference page on the W3C website at
www.w3.org/TR/REC-html40/sgml/entities.html.
This web page contains the 252 allowed entities in HTML 4 and XHTML 1.0.
For example, if the character entity Egrave is missing, search for “Egrave” on the W3C web page. You will find the
following entry:
<!ENTITY Egrave CDATA "È" -- latin capital letter E with grave, U+00C8 ISOlat1 -->
2Make a note of the entity name and entity code in the entry.
In the example, Egrave is the entity name, and È is the entity code.
3With this information, switch to Code view and enter the following entity tag at the top of your XSL file (following
the Doctype declaration and with the other entity tags):
<!ENTITY entityname "entitycode;">
In the example, you would enter the following entity tag:
<!ENTITY Egrave "È">
4Save your file.
If you repeatedly use the same character entities, you may want to permanently add their definitions in the XSL files
Dreamweaver creates by default when you use File > New.
Character Entity Code
< (less-than) <
& (ampersand) &
> (greater-than) >
" (quote) "
‘ (apostrophe) '
September 4, 2007
DREAMWEAVER CS3
User Guide
448
Add entity definitions to the XSL files Dreamweaver creates by default
1Locate the following configuration file in the Dreamweaver application folder and open it in any text editor:
Configuration/DocumentTypes/MMDocumentTypeDeclarations.xml
2Locate the declaration called mm_xslt_1:
<documenttypedeclaration id="mm_xslt_1">
3Enter the new entity tag or tags in the list of entity tags, as follows:
<!ENTITY entityname "entitycode;">
4Save the file and restart Dreamweaver.
September 4, 2007
449
Chapter 16: Building Spry pages visually
The Spry framework is a JavaScript and CSS library that lets you build richer web pages. You can use the framework
to display XML data and create interactive page elements that display dynamic data without requiring the entire page
to refresh.
About the Spry framework
About the Spry framework
The Spry framework is a JavaScript library that provides web designers with the ability to build web pages that offer
richer experiences to their site visitors. With Spry, you can use HTML, CSS, and a minimal amount of JavaScript to
incorporate XML data into your HTML documents, create widgets such as accordions and menu bars, and add
different kinds of effects to various page elements. The Spry framework is designed so that markup is simple and easy
to use for those who have basic knowledge of HTML, CSS, and JavaScript.
The Spry framework is meant primarily for users who are web design professionals or advanced nonprofessional web
designers. It is not intended as a full web application framework for enterprise-level web development (though it can
be used in conjunction with other enterprise-level pages).
For more information on the Spry framework, see www.adobe.com/go/learn_dw_spryframework.
For a tutorial about using Spry to build web pages, see www.adobe.com/go/vid0166.
Adding Spry widgets
About Spry widgets
ASpry widget is a page element that provides a richer user experience by enabling user interaction. A Spry widget
comprises the following parts:
Widget structure An HTML code block that defines the structural composition of the widget.
Widget behavior JavaScript that controls how the widget responds to user-initiated events.
Widget styling CSS that specifies the appearance of the widget.
The Spry framework supports a set of reusable widgets written in standard HTML, CSS, and JavaScript. You can
easily insert these widgets—the code is HTML and CSS at its simplest—and then style the widget. The behaviors in
the framework include functionality that lets users show or hide content on the page, change the appearance (such
as color) of the page, interact with menu items, and much more.
Each widget in the Spry framework is associated with unique CSS and JavaScript files. The CSS file contains every-
thing necessary for styling the widget, and the JavaScript file gives the widget its functionality. When you insert a
widget by using the Dreamweaver interface, Dreamweaver automatically links these files to your page so that your
widget contains functionality and styling.
September 4, 2007
DREAMWEAVER CS3
User Guide
450
The CSS and JavaScript files associated with a given widget are named after the widget, so it’s easy for you to know
which files correspond to which widgets. (For example, the files associated with the Accordion widget are called
SpryAccordion.css and SpryAccordion.js). When you insert a widget in a saved page, Dreamweaver creates a
SpryAssets directory in your site, and saves the corresponding JavaScript and CSS files to that location.
For a tutorial on using Spry widgets, see www.adobe.com/go/vid0167.
See also
“Understanding Cascading Style Sheets” on page 120
Insert a Spry widget
❖Select Insert > Spry, and select the widget to insert.
When you insert a widget, Dreamweaver automatically includes the necessary Spry JavaScript and CSS files in your
site when you save the page.
Note: You can also insert Spry widgets by using the Spry category in the Insert bar.
Select a Spry widget
1Hold the mouse pointer over the widget until you see the widget’s blue tabbed outline.
2Click the widget’s tab at the upper-left corner of the widget.
Edit a Spry widget
❖Select the widget to edit and make your changes in the Property inspector (Window > Properties).
For details on making changes to specific widgets, see the appropriate sections for each widget.
Style a Spry widget
❖Locate the appropriate CSS file for the widget in the SpryAssets folder of your site, and edit the CSS according to
your preferences.
For details on styling specific widgets, see the appropriate customization sections for each widget.
YoucanalsoformataSprywidgetbyeditingstylesintheCSSpanel,justasyouwouldforanyotherstyledelement
on the page.
Change the default Spry assets folder
When you insert a Spry widget, data set, or effect in a saved page, Dreamweaver creates a SpryAssets directory in
your site, and saves the corresponding JavaScript and CSS files to that location. You can change the default location
where Dreamweaver saves Spry assets if you prefer to save them somewhere else.
1Select Sites > Manage Sites.
2Select your site in the Manage Sites dialog box and click Edit.
3Select the Spry category in the Site Definition dialog box.
4Enter a path to the folder you want to use for Spry assets and click OK. You can also click the folder icon to browse
to a location.
September 4, 2007
DREAMWEAVER CS3
User Guide
451
See also
“Define a Spry XML data set” on page 480
“Spry effects overview” on page 486
Working with the Accordion widget
About the Accordion widget
An Accordion widget is a set of collapsible panels that can store a large amount of content in a compact space. Site
visitors hide or reveal the content stored in the accordion by clicking the tab of the panel. The panels of the accordion
expand or contract accordingly as the visitor clicks different tabs. In an accordion, only one content panel is open
and visible at a given time. The following example shows an Accordion widget, with the first panel expanded:
A. Accordion panel tab B. Accordion panel content C. Accordion panel (open)
The default HTML for the Accordion widget comprises an outer div tag that contains all of the panels, a div tag for
each panel, and a header div and content div within the tag for each panel. An Accordion widget can contain any
number of individual panels. The HTML for the Accordion widget also includes script tags in the head of the
document and after the accordion’s HTML markup.
For a more comprehensive explanation of how the Accordion widget works, including a full anatomy of the
Accordion widget’s code, see www.adobe.com/go/learn_dw_spryaccordion.
Insert the Accordion widget
❖Select Insert > Spry > Spry Accordion.
Note: You can also insert an Accordion widget by using the Spry category in the Insert bar.
Add a panel to an Accordion widget
1Select an Accordion widget in the Document window.
2Click the Panels Plus (+) button in the Property inspector (Window > Properties).
3(Optional) Change the name of the panel by selecting the panel’s text in Design view and altering the text.
A
BC
September 4, 2007
DREAMWEAVER CS3
User Guide
452
Delete a panel from an Accordion widget
1Select an Accordion widget in the Document window.
2In the Panels menu of the Property inspector (Window > Properties), select the name of the panel to delete, and
click the Minus (-) button.
Open a panel for editing
❖Do one of the following:
•Move the mouse pointer over the tab of the panel to open it in Design view, and click the eye icon that appears at
the right of the tab.
•SelectanAccordionwidgetintheDocumentwindow,andthenclickthenameofthepaneltoedititinthePanels
menu of the Property inspector (Window > Properties).
Change the order of panels
1Select an Accordion widget in the Document window.
2In the Property inspector (Window > Properties), select the name of the Accordion panel you want to move.
3Click the up or down arrows to move the panel up or down.
Customize the Accordion widget
Although the Property inspector enables you to make simple edits to an Accordion widget, it does not support
customized styling tasks. You can alter the CSS rules for the Accordion widget and create an accordion that is styled
to your liking. For a more advanced list of styling tasks, see www.adobe.com/go/learn_dw_spryaccordion_custom.
All CSS rules in the following topics refer to the default rules located in the SpryAccordion.css file. Dreamweaver
saves the SpryAccordion.css file in the SpryAssets folder of your site whenever you create a Spry Accordion widget.
This file also contains commented information about various styles that apply to the widget, so you might find it
helpful to consult the file as well.
Although you can easily edit rules for the Accordion widget directly in the CSS file, you can also use the CSS Styles
panel to edit the accordion’s CSS. The CSS Styles panel is helpful for locating the CSS classes assigned to different
parts of the widget, especially if you use the panel’s Current mode.
See also
“The CSS Styles panel in Current mode” on page 125
Style Accordion widget text
YoucanstylethetextofanAccordionwidgetbysettingpropertiesfortheentireAccordionwidgetcontainer,orby
setting properties for the components of the widget individually.
❖TochangethetextstylingofanAccordionwidget,usethefollowingtabletolocatetheappropriateCSSrule,and
then add your own text styling properties and values:
September 4, 2007
DREAMWEAVER CS3
User Guide
453
Change Accordion widget background colors
❖To change the background colors of different parts of an Accordion widget, use the following table to locate the
appropriate CSS rule, and then add or change background color properties and values:
Constrain the width of an accordion
By default, the Accordion widget expands to fill available space. You can constrain the width of an Accordion widget,
however, by setting a width property for the accordion container.
1Locate the .Accordion CSS rule by opening up the SpryAccordion.css file. This is the rule that defines properties
for the main container element of the Accordion widget.
You can also locate the rule by selecting the Accordion widget, and looking in the CSS Styles panel (Window > CSS).
Make sure the panel is set to Current mode.
2Add a width property and value to the rule, for example width: 300px;.
Working with the Menu Bar widget
About the Menu Bar widget
A Menu Bar widget is a set of navigational menu buttons that display submenus when a site visitor hovers over one
of the buttons. Menu Bars let you display a large amount of navigational information in a compact space, and also
give visitors to the site a sense of what is available on the site without having to browse it extensively.
Dreamweaver lets you insert two kinds of Menu Bar widgets: vertical and horizontal. The following example shows
a horizontal Menu Bar widget, with the third menu item expanded:
Text to change Relevant CSS rule Example of properties and values
to add
Text in the entire accordion (includes
both tab and content panel)
.Accordion or .AccordionPanel font: Arial; font-size:medium;
Text in accordion panel tabs only .AccordionPanelTab font: Arial; font-size:medium;
Text in accordion content panels
only
.AccordionPanelContent font: Arial; font-size:medium;
Part of widget to change Relevant CSS rule Example of property and value to
add or change
Background color of accordion panel
tabs
.AccordionPanelTab background-color: #CCCCCC; (This is
the default value.)
Background color of accordion
content panels
.AccordionPanelContent background-color: #CCCCCC;
Background color of the open accor-
dion panel
.AccordionPanelOpen .Accordion-
PanelTab
background-color: #EEEEEE; (This is
the default value.)
Background color of panel tabs on
hover
.AccordionPanelTabHover color: #555555; (This is the default
value.)
Background color of open panel tab
on hover
.AccordionPanelOpen .Accordion-
PanelTabHover
color: #555555; (This is the default
value.)
September 4, 2007
DREAMWEAVER CS3
User Guide
454
Menu Bar widget (consists of <ul>, <li>, and <a> tags)
A. Menu item has submenu B. Submenu item has submenu
TheHTMLfortheMenuBarwidgetcomprisesanouterul tag that contains an li tag for each of the top-level menu
items. The top-level menu items (li tags) in turn contain ul and li tags that define submenus for each of the items,
and submenus can likewise contain submenus. Top-level menus and submenus can contain as many submenu items
as you like.
For a more comprehensive explanation of how the Menu Bar widget works, including a full anatomy of the Menu
Bar widget’s code, see www.adobe.com/go/learn_dw_sprymenubar.
For a tutorial on creating a Spry Menu Bar, see www.adobe.com/go/vid0168.
Insert the Menu Bar widget
1Select Insert > Spry > Spry Menu Bar.
2Select Horizontal or Vertical, and click OK.
Note: You can also insert a Menu Bar widget using the Spry category of the Insert bar.
Note: The Spry Menu Bar widget uses DHTML layers to display sections of HTML on top of other sections. If your page
contains Flash content, this might cause a problem because Flash movies are always displayed on top of all other
DHTML layers, so the Flash content might be displayed on top of your submenus. The workaround for this situation is
to change the parameters for the Flash movie to use wmode="transparent". For more information, see
www.adobe.com/go/15523.
Add or delete menus and submenus
Use the Property inspector (Window > Properties) to add or delete menu items to and from the Menu Bar widget.
Add a main menu item
1Select a Menu Bar widget in the Document window.
2In the Property inspector, click the plus button above the first column.
3(Optional) Rename the new menu item by changing the default text in either the Document window or the Text
box of the Property inspector.
Add a submenu item
1Select a Menu Bar widget in the Document window.
2In the Property inspector, select the name of the main menu item to which you want to add the submenu.
3Click the plus button above the second column.
4(Optional) Rename the new submenu item by changing the default text in either the Document window or the
Text box of the Property inspector.
A B
September 4, 2007
DREAMWEAVER CS3
User Guide
455
To add a submenu to a submenu, select the name of the submenu item to which you want to add another submenu
item, and click the plus button above the third column in the Property inspector.
Note: Dreamweaver only supports two levels of submenus in Design view, but you can add as many submenus as you
want in Code view.
Delete a main menu or submenu item
1Select a Menu Bar widget in the Document window.
2In the Property inspector, select the name of the main menu or submenu item you want to delete and click the
minus button.
Change the order of menu items
1Select a Menu Bar widget in the Document window.
2In the Property inspector (Window > Properties), select the name of the menu item you want to reorder.
3Click the up or down arrows to move the menu item up or down.
Change the text of a menu item
1Select a Menu Bar widget in the Document window.
2InthePropertyinspector(Window>Properties)selectthenameofthemenuitemwhosetextyouwanttochange.
3Make your changes in the Text box.
Link a menu item
1Select a Menu Bar widget in the Document window.
2In the Property inspector (Window > Properties) select the name of the menu item to which you want to apply a link.
3Type the link in the Link text box, or click the folder icon to browse to a file.
Create a tool tip for a menu item
1Select a Menu Bar widget in the Document window.
2In the Property inspector (Window > Properties) select the name of the menu item for which you want to create
a tool tip.
3Type the text for the tool tip in the Title text box.
Assign a target attribute for a menu item
The target attribute specifies where to open a linked page. For example, you can assign a target attribute to a menu
item so that the linked page opens in a new browser window when the site visitor clicks the link. If you are using
framesets, you can also specify the name of a frame where you want the linked page to open.
1Select a Menu Bar widget in the Document window.
2In the Property inspector (Window > Properties), select the name of the menu item to which you want to assign
a target attribute.
3Enter one of the four attributes in the Target box:
_blank Opens the linked page in a new browser window.
September 4, 2007
DREAMWEAVER CS3
User Guide
456
_self Loads the linked page in the same browser window. This is the default option. If the page is in a frame or
frameset, the page loads within that frame.
_parent Loads the linked document in the immediate frameset parent of the document.
_top Loads the linked page in the topmost window of a frameset.
Turn off styles
You can disable the styling of a Menu Bar widget so that you can better see the HTML structure of the widget in
Design view. For example, when you disable styles, menu bar items are displayed in a bulleted list on the page, rather
than as the styled items of the menu bar.
1Select a Menu Bar widget in the Document window.
2Click the Turn Styles Off button in the Property Inspector (Window > Properties).
Change the orientation of a Menu Bar widget
You can change the orientation of a Menu Bar widget from horizontal to vertical, and vice versa. All you need to do
is alter the HTML code for the menu bar and make sure you have the correct CSS file in your SpryAssets folder.
The following example changes a horizontal Menu Bar widget to a vertical Menu Bar widget.
1In Dreamweaver, open the page that contains a horizontal Menu Bar widget.
2Insert a vertical Menu Bar widget (Insert > Spry > Spry Menu Bar) and save the page. This step ensures that the
correct CSS file for a vertical menu bar is included in your site.
Note: If your site already has a vertical Menu Bar widget somewhere else, you don’t need to insert a new one. You can
simply attach the SpryMenuBarVertical.css file to the page instead by clicking the Attach Style Sheet button in the CSS
Styles panel (Windows > CSS Styles).
3Delete the vertical Menu Bar.
4In Code view (View > Code), locate the MenuBarHorizontal class and change it to MenuBarVertical. The
MenuBarHorizontal class is defined in the container ul tag for the menu bar (<ul id="MenuBar1"
class="MenuBarHorizontal">).
5After the code for the menu bar, locate the menu bar constructor:
var MenuBar1 = new Spry.Widget.MenuBar("MenuBar1",
{imgDown:"SpryAssets/SpryMenuBarDownHover.gif",
imgRight:"SpryAssets/SpryMenuBarRightHover.gif"});
6Remove the imgDown preload option (and comma) from the constructor:
var MenuBar1 = new Spry.Widget.MenuBar("MenuBar1",
{imgRight:"SpryAssets/SpryMenuBarRightHover.gif"});
Note: Ifconvertingfromaverticalmenubartoahorizontalone,addtheimgDown preload option and comma instead.
7(Optional) If your page no longer contains any other horizontal Menu Bar widgets, delete the link to the former
MenuBarHorizontal.css file in the head of the document.
8Save the page.
September 4, 2007
DREAMWEAVER CS3
User Guide
457
Customize the Menu Bar widget
Although the Property inspector enables you to make simple edits to a Menu Bar widget, it does not support
customized styling tasks. You can alter the CSS rules for the Menu Bar widget and create a menu bar that is styled to
your liking. For a more advanced list of styling tasks, see www.adobe.com/go/learn_dw_sprymenubar_custom.
All CSS rules in the topics below refer to the default rules located in the SpryMenuBarHorizontal.css or
SpryMenuBarVertical.css file (depending on your selection). Dreamweaver saves these CSS files in the SpryAssets
folder of your site whenever you create a Spry Menu Bar widget. These files also contain useful commented infor-
mation about various styles that apply to the widget.
Although you can easily edit rules for the Menu Bar widget directly in the accompanying CSS file, you can also use
the CSS Styles panel to edit the menu bar’s CSS. The CSS Styles panel is helpful for locating the CSS classes assigned
to different parts of the widget, especially if you use the panel’s Current mode.
See also
“The CSS Styles panel in Current mode” on page 125
Change text styling of a menu item
The CSS attached to the <a> tag contains the information for text styling. There are also several relevant text styling
class values attached to the <a> tag that pertain to different menu states.
❖To change the text styling of a menu item, use the following table to locate the appropriate CSS rule, and then
change the default value:
Change the background color of a menu item
The CSS attached to the <a> tag contains the information for a menu item’s background color. There are also several
relevant background color class values attached to the <a> tag that pertain to different menu states.
❖To change the background color of a menu item, use the following table to locate the appropriate CSS rule, and
then change the default value:
Style to change CSS rule for vertical or horizontal
menu bar
Relevant properties and default
values
Default text ul.MenuBarVertical a, ul.MenuBarHo-
rizontal a
color: #333; text-decoration: none;
Text color when mouse pointer
moves over it
ul.MenuBarVertical a:hover,
ul.MenuBarHorizontal a:hover
color: #FFF;
Text color when in focus ul.MenuBarVertical a:focus,
ul.MenuBarHorizontal a:focus
color: #FFF;
Menu Bar item color when mouse
pointer moves over it
ul.MenuBarVertical a.MenuBarItem-
Hover, ul.MenuBarHorizontal
a.MenuBarItemHover
color: #FFF;
Submenu item color when mouse
pointer moves over it
ul.MenuBarVertical a.MenuBarItem-
SubmenuHover, ul.MenuBarHori-
zontal a.MenuBarItemSubmenu-
Hover
color: #FFF;
September 4, 2007
DREAMWEAVER CS3
User Guide
458
Change the dimension of menu items
You change the dimension of menu items by changing the width properties of the menu item’s li and ul tags.
1Locate the ul.MenuBarVertical li or ul.MenuBarHorizontal li rule.
2Change the width property to a desired width (or change the property to auto to remove a fixed width, and add
the property and value white-space: nowrap; to the rule).
3Locate the ul.MenuBarVertical ul or ul.MenuBarHorizontal ul rule.
4Change the width property to a desired width (or change the property to auto to remove a fixed width).
5Locate the ul.MenuBarVertical ul li or ul.MenuBarHorizontal ul li rule:
6Add the following properties to the rule: float: none; and background-color: transparent;.
7Delete the width: 8.2em; property and value.
Position submenus
The position of Spry Menu Bar submenus is controlled by the margin property on submenu ul tags.
1Locate the ul.MenuBarVertical ul or ul.MenuBarHorizontal ul rule.
2Change the margin: -5% 0 0 95%; default values to the desired values.
Working with the Collapsible Panel widget
About the Collapsible Panel widget
A Collapsible Panel widget is a panel that can store content in a compact space. Users hide or reveal the content
stored in the Collapsible Panel by clicking the tab of the widget. The following example shows a Collapsible Panel
widget, expanded and collapsed:
Color to change CSS rule for vertical or horizontal
menu bar
Relevant properties and default
values
Default background ul.MenuBarVertical a, ul.MenuBarHo-
rizontal a
background-color: #EEE;
Background color when mouse
pointer moves over it
ul.MenuBarVertical a:hover,
ul.MenuBarHorizontal a:hover
background-color: #33C;
Background color when in focus ul.MenuBarVertical a:focus,
ul.MenuBarHorizontal a:focus
background-color: #33C;
Menu Bar item color when mouse
pointer moves over it
ul.MenuBarVertical a.MenuBarItem-
Hover, ul.MenuBarHorizontal
a.MenuBarItemHover
background-color: #33C;
Submenu item color when mouse
pointer moves over it
ul.MenuBarVertical a.MenuBarItem-
SubmenuHover, ul.MenuBarHori-
zontal a.MenuBarItemSubmenu-
Hover
background-color: #33C;
September 4, 2007
DREAMWEAVER CS3
User Guide
459
A. Expanded B. Collapsed
TheHTMLfortheCollapsiblePanelwidgetcomprisesanouterdiv tag that contains the content div tag and the tab
container div tag. The HTML for the Collapsible Panel widget also includes script tags in the head of the document
and after the Collapsible Panel’s HTML markup.
For a more comprehensive explanation of how the Collapsible Panel widget works, including a full anatomy of the
Collapsible Panel widget’s code, see www.adobe.com/go/learn_dw_sprycollapsiblepanel.
Insert the Collapsible Panel widget
❖Select Insert > Spry > Spry Collapsible Panel.
Note: You can also insert a Collapsible Panel widget by using the Spry category in the Insert bar.
Open or close the Collapsible Panel in Design view
❖Do one of the following:
•Move the mouse pointer over the tab of the panel in Design view and click the eye icon that appears at the right
of the tab.
•Select a Collapsible Panel widget in the Document window, and then select Open or Closed from the Display pop-
up menu in the Property inspector (Window > Properties).
Set the default state of a Collapsible Panel widget
You can set the default state (open or closed) of the Collapsible Panel widget when the web page loads in a browser.
1Select a Collapsible Panel widget in the Document window.
2In the Property inspector (Window > Properties), select Open or Closed from the Default state pop-up menu.
Enable or disable animation for the Collapsible Panel widget
By default, when you enable animation for a Collapsible Panel widget, the panel gradually and smoothly opens and
closes when the site visitor clicks the panel’s tab. If you disable animation, the collapsible panel snaps open and closed
abruptly.
1Select a Collapsible Panel widget in the Document window.
2In the Property inspector (Window > Properties), select or deselect Enable Animation.
AB
September 4, 2007
DREAMWEAVER CS3
User Guide
460
Customize the Collapsible Panel widget
Although the Property inspector enables you to make simple edits to a Collapsible Panel widget, it does not support
customized styling tasks. You can alter the CSS for the Collapsible Panel widget and create a collapsible panel that is
styled to your liking. For a more advanced list of styling tasks, see
www.adobe.com/go/learn_dw_sprycollapsiblepanel_custom.
All CSS rules in the topics below refer to the default rules located in the SpryCollapsiblePanel.css file. Dreamweaver
saves the SpryCollapsiblePanel.css file in the SpryAssets folder of your site whenever you create a Spry Collapsible
Panel widget. This file also contains useful commented information about various styles that apply to the widget.
While you can easily edit rules for the Collapsible Panel widget directly in the accompanying CSS file, you can also
use the CSS Styles panel to edit the collapsible panel’s CSS. The CSS Styles panel is helpful for locating the CSS classes
assigned to different parts of the widget, especially if you use the panel’s Current mode.
See also
“The CSS Styles panel in Current mode” on page 125
Style Collapsible Panel widget text
You can style the text of a Collapsible Panel widget by setting properties for the entire Collapsible Panel widget
container, or by setting properties for the components of the widget individually.
❖TochangethetextformatofaCollapsiblePanelwidget,usethefollowingtabletolocatetheappropriateCSSrule,
and then add your own text styling properties and values:
Change Collapsible Panel widget background colors
❖To change the background colors of different parts of a Collapsible Panel widget, use the following table to locate
the appropriate CSS rule, and then add or change background color properties and values to your liking:
Style to change Relevant CSS rule Example of properties and values
to add or change
Text in the entire collapsible panel .CollapsiblePanel font: Arial; font-size:medium;
Text in panel tab only .CollapsiblePanelTab font: bold 0.7em sans-serif; (This is
the default value.)
Text in content panel only .CollapsiblePanelContent font: Arial; font-size:medium;
Color to change Relevant CSS rule Example of property and value to
add or change
Background color of panel tab .CollapsiblePanelTab background-color: #DDD; (This is the
default value.)
Background color of content panel .CollapsiblePanelContent background-color: #DDD;
Background color of tab when panel
is open
.CollapsiblePanelOpen .Collaps-
iblePanelTab
background-color: #EEE; (This is the
default value.)
Background color of open panel tab
when the mouse pointer moves over
it
.CollapsiblePanelTabHover, .Collaps-
iblePanelOpen .CollapsiblePanelTab-
Hover
background-color: #CCC; (This is the
default value.)
September 4, 2007
DREAMWEAVER CS3
User Guide
461
Constrain the width of a collapsible panel
By default, the Collapsible Panel widget expands to fill available space. You can constrain the width of a Collapsible
Panel widget, however, by setting a width property for the collapsible panel container.
1Locate the .CollapsiblePanel CSS rule by opening the SpryCollapsible Panel.css file. This rule defines properties
for the main container element of the Collapsible Panel widget.
You can also locate the rule by selecting the Collapsible Panel widget, and looking in the CSS Styles panel (Window
> CSS Styles). Make sure the panel is set to Current mode.
2Add a width property and value to the rule, for example width: 300px;.
Working with the Tabbed Panels widget
About the Tabbed Panels widget
A Tabbed Panels widget is a set of panels that can store content in a compact space. Site viewers hide or reveal the
content stored in the Tabbed Panels by clicking the tab of the panel they want to access. The panels of the widget
open accordingly as the visitor clicks different tabs. In a Tabbed Panels widget, only one content panel is open at a
given time. The following example shows a Tabbed Panels widget, with the third panel open:
A. Tab B. Content C. Tabbed Panel s widget D. Tabbed panel
The HTML code for the Tabbed Panels widget comprises an outer div tag that contains all of the panels, a list for the
tabs, a div to contain the content panels, and a div for each content panel. The HTML for the Tabbed Panels widget
also includes script tags in the head of the document and after the Tabbed Panel widget’s HTML markup.
For a more comprehensive explanation of how the Tabbed Panels widget works, including a full anatomy of the
widget’s code, see www.adobe.com/go/learn_dw_sprytabbedpanels.
Insert the Tabbed Panels widget
❖Select Insert > Spry > Spry Tabbed Panels.
Note: You can also insert a Tabbed Panels widget by using the Spry category in the Insert bar.
Add a panel to a Tabbed Panels widget
1Select a Tabbed Panels widget in the Document window.
2Click the Panels plus button in the Property inspector (Window > Properties).
3(Optional) Change the tab name by selecting the tab’s text in Design view and altering it.
AB
C
D
September 4, 2007
DREAMWEAVER CS3
User Guide
462
Delete a panel from a Tabbed Panels widget
1Select a Tabbed Panels widget in the Document window.
2In the Panels menu of the Property inspector (Window > Properties), select the name of the panel you want to
delete and click the minus button.
Open a panel for editing
❖Do one of the following:
•Move the mouse pointer over the tab of the panel you want to open in Design view and click the eye icon that
appears at the right of the tab.
•Select a Tabbed Panels widget in the Document window and click the name of the panel you want to edit in the
Panels menu of the Property inspector (Window > Properties).
Change the order of panels
1Select a Tabbed Panels widget in the Document window.
2InthePanelsmenuofthePropertyinspector(Window>Properties),selectthenameofthepanelyouwanttomove.
3Click the up or down arrows to move the panel up or down.
Set the default open panel
You can set which panel of the Tabbed Panels widget opens by default when the page opens in a browser.
1Select a Tabbed Panels widget in the Document window.
2In the Property inspector (Window > Properties), select the panel you want open by default from the Default
panel pop-up menu.
Customize the Tabbed Panels widget
Although the Property inspector enables you to make simple edits to a Tabbed Panels widget, it does not support
customized styling tasks. You can alter the CSS rules for the Tabbed Panels widget and create a widget that is styled
to your liking. For a more advanced list of styling tasks, see
www.adobe.com/go/learn_dw_sprytabbedpanels_custom.
All CSS rules in the topics below refer to the default rules located in the SpryTabbedPanels.css file. Dreamweaver
saves the SpryTabbedPanels.css file in the SpryAssets folder of your site whenever you create a Spry Tabbed Panels
widget. This file also contains useful commented information about various styles that apply to the widget.
Although you can easily edit rules for the Tabbed Panels widget directly in the accompanying CSS file, you can also
use the CSS Styles panel to edit the widget’s CSS. The CSS Styles panel is helpful for locating the CSS classes assigned
to different parts of the widget, especially if you use the panel’s Current mode.
See also
“The CSS Styles panel in Current mode” on page 125
September 4, 2007
DREAMWEAVER CS3
User Guide
463
Style Tabbed Panels widget text
You can style the text of a Tabbed Panels widget by setting properties for the entire Tabbed Panels widget container,
or by setting properties for the components of the widget individually.
❖To change the text styling of a Tabbed Panels widget, use the following table to locate the appropriate CSS rule,
and then add your own text styling properties and values:
Change Tabbed Panels widget background colors
❖To change the background colors of different parts of a Tabbed Panels widget, use the following table to locate the
appropriate CSS rule, and then add or change background color properties and values to your liking:
Constrain the width of tabbed panels
By default, the Tabbed Panels widget expands to fill available space. You can constrain the width of a Tabbed Panels
widget, however, by setting a width property for the accordion container.
1Locate the .TabbedPanels CSS rule by opening the SpryTabbedPanels.css file. This rule defines properties for the
main container element of the Tabbed Panels widget.
You can also locate the rule by selecting the Tabbed Panels widget, and looking in the CSS Styles panel (Window >
CSS Styles). Make sure the panel is set to Current mode.
2Add a width property and value to the rule, for example width: 300px;.
Text to change Relevant CSS rule Example of properties and values
to add
Text in the entire widget .TabbedPanels font: Arial; font-size:medium;
Text in panel tabs only .TabbedPanelsTabGroup or .Tabbed-
PanelsTab
font: Arial; font-size:medium;
Text in content panels only .TabbedPanelsContentGroup or
.TabbedPanelsContent
font: Arial; font-size:medium;
Color to change Relevant CSS rule Example of property and value to
add or change
Background color of panel tabs .TabbedPanelsTabGroup or .Tabbed-
PanelsTab
background-color: #DDD; (This is the
default value.)
Background color of content panels .Tabbed PanelsContentGroup or
.TabbedPanelsContent
background-color: #EEE; (This is the
default value.)
Background color of selected tab .TabbedPanelsTabSelected background-color: #EEE; (This is the
default value.)
Background color of panel tabs
when the mouse pointer moves over
them
.TabbedPanelsTabHover background-color: #CCC; (This is the
default value.)
September 4, 2007
DREAMWEAVER CS3
User Guide
464
Working with the Validation Text Field widget
About the Validation Text Field widget
A Spry Validation Text Field widget is a text field that displays valid or invalid states when the site visitor enters text.
For example, you can add a Validation Text Field widget to a form in which visitors type their e-mail addresses. If
they fail to type the “@” symbol and a period in the e-mail address, the widget returns a message stating that the
information the user entered is invalid.
The following example shows a Validation Text Field widget in various states:
A. Textfield widget, hint activated B. Textfield widget, valid state C. Textfield widget, invalid state D. Textfield widget, required state
The Validation Text Field widget includes a number of states (for example, valid, invalid, required value, and so on).
YoucanalterthepropertiesofthesestatesusingthePropertyInspector,dependingonthedesiredvalidationresults.
A Validation Text Field widget can validate at various points—for example, when the visitor clicks outside the widget,
when they type, or when they try to submit the form.
Initial state The widget state when the page loads in the browser, or when the user resets the form.
Focus state The widget state when the user places the insertion point in the widget.
Valid state The widget state when the user has entered information correctly, and the form can be submitted.
Invalid state Thewidgetstatewhentheuserhasenteredtextinaninvalidformat.(Forexample,06forayearinstead
of 2006).
Required state The widget state when the user has failed to enter required text in the text field.
Minimum Number Of Characters state The widget state when the user has entered fewer than the minimum number
of characters required in the text field.
Maximum Number Of Characters state The widget state when the user has entered greater than the maximum
number of characters allowed in the text field.
Minimum Value state The widget state when the user has entered a value that is less than the value required by the
text field. (Applies to integer, real, and data type validations.)
Maximum Value state The widget state when the user has entered a value that is greater than the maximum value
allowed by the text field. (Applies to integer, real, and data type validations.)
Whenever a Validation Text Field widget enters one of these states through user interaction, the Spry framework
logic applies a specific CSS class to the HTML container for the widget at run time. For example, if a user tries to
submit a form, but has entered no text in a required text field, Spry applies a class to the widget that causes it to
display the error message, “A value is required”. The rules that control the style and display states of error messages
exist in the CSS file that accompanies the widget, SpryValidationTextField.css.
A
B
C
D
September 4, 2007
DREAMWEAVER CS3
User Guide
465
The default HTML for the Validation Text Field widget, usually inside of a form, comprises a container <span> tag
that surrounds the <input> tag of the text field. The HTML for the Validation Text Field widget also includes script
tags in the head of the document and after the widget’s HTML markup.
For a more comprehensive explanation of how the Validation Text Field widget works, including a full anatomy of
the Validation Text Field widget’s code, see www.adobe.com/go/learn_dw_sprytextfield.
Insert the Validation Text Field widget
1Select Insert > Spry > Spry Validation Text Field.
2Complete the Input Tag Accessibility Attributes dialog box and click OK.
Note: You can also insert a Validation Text Field widget by using the Spry category in the Insert bar.
See also
“Create accessible HTML forms” on page 612
Specify a validation type and format
You can specify different validation types for the Validation Text Field widget. For example, you can specify a credit
card validation type if the text field will receive credit card numbers.
1Select a Validation Text Field widget in the Document window.
2In the Property inspector (Window > Properties), select a validation type from the Type menu.
3If applicable, select a format from the Format pop-up menu.
Most validation types cause the text field to expect a standard format. For example, if you apply the integer validation
type to a text field, the widget won’t validate unless the user has entered numbers in the text field. Some validation
types, however, let you choose the kind of format your text field will accept. The following table lists validation types
and formats that are available through the Property inspector:
Validation type Format
None No particular format required.
Integer Text field accepts numbers only.
Email Text field accepts e-mail addresses that contain @ and a
period (.) that is both preceded and followed by at least
one letter.
Date Formats vary. Make your selection from the Format pop-
up menu of the Property inspector.
Time Formats vary. Make your selection from the Format pop-
up menu of the Property inspector. (“tt” stands for
am/pm format; “t” stands for a/p format.)
Credit Card Formats vary. Make your selection from the Format pop-
up menu of the Property inspector. You can choose to
accept all credit cards, or specify a particular kind of
credit card (MasterCard, Visa, etc.). The text field does not
accept spaces in creditcard numbers, i.e. 4321 3456 4567
4567.
September 4, 2007
DREAMWEAVER CS3
User Guide
466
Specify when validation occurs
You can set the point at which validation occurs—when the site visitor clicks outside the widget, as the visitor types,
or when the visitor tries to submit the form.
1Select a Validation Text Field widget in the Document window.
2In the Property inspector (Window > Properties) select the option that indicates when you want validation to
occur. You can select all of the options or none of them.
Blur Validates whenever the user clicks outside the text field.
Change Validates as the user changes text inside the text field.
Submit Validates when the user tries to submit the form.
Specify a minimum and maximum number characters
This option is only available for None, Integer, E-mail Address, and URL validation types.
1Select a Validation Text Field widget in the Document window.
2In the Property inspector (Window > Properties), enter a number in the Min Chars or Max Chars box. For
example, if you enter 3 in the Min Chars box, the widget only validates if the user enters three or more characters.
Zip Code Formats vary. Make your selection from the Format pop-
up menu of the Property inspector.
Phone Number Text field accepts phone numbers formatted for U.S. and
Canada (000) 000-0000 or custom formats. If you select
custom format as an option, enter the format, for
example, 000.00(00), in the Pattern text box.
Social Security Number Text field accepts social security numbers formatted as
000-00-0000. If you want to use a different format, select
Custom as your validation type and specify a pattern.
The pattern validation mechanism accepts only ASCII
characters.
Currency Text field accepts currency formatted as 1,000,000.00 or
1.000.000,00.
Real Number/Scientific Notation Validates various kinds of numbers: integers (for
example, 1); float values (for example, 12.123); and float
values in scientific notation (for example, 1.212e+12,
1.221e-12 where e is used as a power of 10).
IP Address Formats vary. Make your selection from the Format pop-
up menu of the Property inspector.
URL Text field accepts URLs formatted as http://xxx.xxx.xxx or
ftp://xxx.xxx.xxx.
Custom Lets you specify a custom validation type and format.
Enter the format pattern (and hint if desired) in the Prop-
erty inspector. The pattern validation mechanism
accepts only ASCII characters.
Validation type Format
September 4, 2007
DREAMWEAVER CS3
User Guide
467
Specify minimum and maximum values
This option is only available for Integer, Time, Currency, and Real Number/Scientific Notation validation types.
1Select a Validation Text Field widget in the Document window.
2In the Property inspector (Window > Properties), enter a number in the Min Value or Max Value box. For
example, if you enter 3 in the Min Value box, the widget only validates if the user enters the number 3 or a value
greater (4, 5, 6, and so on) in the text field.
Display widget states in Design view
1Select a Validation Text Field widget in the Document window.
2In the Property inspector (Window > Properties), select the state you want to see from the Preview States pop-up
menu. For example, if you want to see the widget in its valid state, select Valid.
Change required status of a text field
By default, all Validation Text Field widgets that you insert with Dreamweaver require user input when published on
a web page. You can, however, make the completion of text fields optional for the user.
1Select a Validation Text Field widget in the Document window.
2In the Property inspector (Window > Properties), select or deselect the Required option, depending on your
preference.
Create a hint for a text field
Because there are so many different kinds of formats for text fields, it is helpful to give your users a hint as to what
format they need to enter. For example, a text field set with the Phone Number validation type will only accept phone
numbers in the form (000) 000-0000. You can enter these sample numbers as a hint so that the text field displays the
correct format when the user loads the page in a browser.
1Select a Validation Text Field widget in the Document window.
2In the Property inspector (Window > Properties), enter a hint in the Hint text box.
Block invalid characters
You can prevent your users from entering invalid characters in a Validation Text Field widget. For example, if you
select this option for a widget set with the Integer validation type, nothing appears in the text field if the user tries to
type a letter.
1Select a Validation Text Field widget in the Document window.
2In the Property inspector (Window > Properties), select the Enforce Pattern option.
Customize the Validation Text Field widget
Although the Property inspector enables you to make simple edits to a Validation Text Field widget, it does not
support customized styling tasks. You can alter the CSS for the Validation Text Field widget so that you can create a
widget that is styled to your liking. For a more advanced list of styling tasks, see
www.adobe.com/go/learn_dw_sprytextfield_custom.
September 4, 2007
DREAMWEAVER CS3
User Guide
468
All CSS rules in the topics below refer to the default rules located in the SpryValidationTextField.css file.
Dreamweaver saves the SpryValidationTextField.css file in the SpryAssets folder of your site whenever you create a
Spry Validation Text Field widget. Consulting this file is helpful because it contains commented information about
various styles that apply to the widget.
Although you can easily edit rules for the Validation Text Field widget directly in the accompanying CSS file, you can
also use the CSS Styles panel to edit the widget’s CSS. The CSS Styles panel is helpful for locating the CSS classes
assigned to different parts of the widget, especially if you use the panel’s Current mode.
See also
“The CSS Styles panel in Current mode” on page 125
Style Validation Text Field widget error message text
By default, error messages for the Validation Text Field widget appear in red with a 1-pixel border surrounding the text.
❖To change the text styling of Validation Text Field widget error messages, use the following table to locate the
appropriate CSS rule, and then change the default properties, or add your own text styling properties and values:
Change Validation Text Field widget background colors
❖To change the background colors of the Validation Text Field widget in various states, use the following table to
locate the appropriate CSS rule, and then change the default background color values:
Text to change Relevant CSS rule Relevant properties to change
Error message text .textfieldRequiredState .textfieldRequiredMsg, .textfield-
InvalidFormatState .textfieldInvalidFormatMsg, .text-
fieldMinValueState .textfieldMinValueMsg, .textfield-
MaxValueState .textfieldMaxValueMsg,
.textfieldMinCharsState .textfieldMinCharsMsg, .text-
fieldMaxCharsState .textfieldMaxCharsMsg
color: #CC3333; border: 1px solid
#CC3333;
Color to change Relevant CSS rule Relevant property to change
Background color of
widget in valid state
.textfieldValidState input, input.textfieldValidState background-color: #B8F5B1;
Background color of
widget in invalid state
input.textfieldRequiredState, .textfieldRequiredState
input, input.textfieldInvalidFormatState, .textfieldIn-
validFormatState input, input.textfieldMinVal-
ueState, .textfieldMinValueState input, input.text-
fieldMaxValueState, .textfieldMaxValueState input,
input.textfieldMinCharsState, .textfieldMin-
CharsState input, input.textfieldMaxCharsState,
.textfieldMaxCharsState input
background-color: #FF9F9F;
Background color widget
in focus
.textfieldFocusState input, input.textfieldFocusState background-color: #FFFFCC;
September 4, 2007
DREAMWEAVER CS3
User Guide
469
Working with the Validation Text Area widget
About the Validation Text Area widget
A Spry Validation Text Area widget is a text area that displays valid or invalid states when the user enters a few
sentences of text. If the text area is a required field and the user fails to enter any text, the widget returns a message
stating that a value is required.
The following example shows a Validation Text Area widget in various states:
A. Characters remaining counter B. Text Area widget in focus, maximum number of characters state C. Text Area widget in focus, valid state
D. Text Area widget, required state E. Characters typed counter
The Validation Text Area widget includes a number of states (for example, valid, invalid, required value, and so on).
YoucanalterthepropertiesofthesestatesusingthePropertyinspector,dependingonthedesiredvalidationresults.
A Validation Text Area widget can validate at various points—for example, when the user clicks outside the widget,
as the user types, or when the user tries to submit the form.
Initial state The widget state when the page loads in the browser, or when the user resets the form.
Focus state The widget state when the user places the insertion point in the widget.
Valid state The widget state when the user has entered information correctly, and the form can be submitted.
Required state The widget state when the user has failed to enter any text.
Minimum Number Of Characters state The widget state when the user has entered fewer than the minimum number
of characters required in the text area.
Maximum Number Of Characters state The widget state when the user has entered greater than the maximum
number of characters allowed in the text area.
Whenever a Validation Text Area widget enters one of these states through user interaction, the Spry framework
logic applies a specific CSS class to the HTML container for the widget at run time. For example, if a user tries to
submit a form, but has not entered text in the text area, Spry applies a class to the widget that causes it to display the
error message, “A value is required.” The rules that control the style and display states of error messages exist in the
CSS file that accompanies the widget, SpryValidationTextArea.css.
A
E
B
C
D
September 4, 2007
DREAMWEAVER CS3
User Guide
470
The default HTML for the Validation Text Area widget, usually inside of a form, comprises a container <span> tag
that surrounds the <textarea> tag of the text area. The HTML for the Validation Text Area widget also includes script
tags in the head of the document and after the widget’s HTML markup.
For a more comprehensive explanation of how the Validation Text Area widget works, including a full anatomy of
the Validation Text Area widget’s code, see www.adobe.com/go/learn_dw_sprytextarea.
Insert the Validation Text Area widget
1Select Insert > Spry > Spry Validation Textarea.
2Complete the Input Tag Accessibility Attributes dialog box and click OK.
Note: You can also insert a Validation Text Area widget by using the Spry category in the Insert bar.
See also
“Create accessible HTML forms” on page 612
Specify when validation occurs
You can set the point at which validation occurs—when the user clicks outside the widget, as the user types, or when
the user tries to submit the form.
1Select a Validation Text Area widget in the Document window.
2In the Property inspector (Window > Properties), select the Validate On option that indicates when you want
validation to occur. You can select all of the options or none of them.
Blur Validates whenever the user clicks outside the text field.
Change Validates as the user changes text inside the text field.
Submit Validates when the user tries to submit the form.
Specify a minimum and maximum number of characters
1Select a Validation Text Area widget in the Document window.
2In the Property inspector (Window > Properties), enter a number in the Min Chars or Max Chars box. For
example, if you enter 20 in the Min Chars box, the widget only validates if the user enters 20 or more characters in
the text area.
Add a character counter
You can add a character counter that lets your users know how many characters they have typed, or how many
characters are remaining when entering text in the text area. By default, when you add a character counter, the
counter appears outside the lower-right corner of the widget.
1Select a Validation Text Area widget in the Document window.
2In the Property inspector (Window > Properties), select either the Chars Count or Chars Remaining option.
Note: The Chars Remaining option is only available if you’ve already set a maximum number of characters allowed.
Display widget states in Design view
1Select a Validation Text Area widget in the Document window.
September 4, 2007
DREAMWEAVER CS3
User Guide
471
2In the Property inspector (Window > Properties), select the state you want to see from the Preview States pop-up
menu. For example, if you want to see the widget in its valid state, select Valid.
Change required status of a text area
By default, all Validation Text Area widgets that you insert with Dreamweaver require user input when published on
a web page. You can, however, make text areas optional for validation.
1Select a Validation Text Area widget in the Document window.
2In the Property inspector (Window > Properties), select or deselect the Required option, depending on your
preference.
Create a hint for a text area
You can add a hint to the text area (for example, “Type your description here”), to let your users know the kind of
information they should enter in the text area. The text area displays the hint text when the user loads the page in a
browser.
1Select a Validation Text Area widget in the Document window.
2In the Property inspector (Window > Properties), enter a hint in the Hint text box.
Block extra characters
You can prevent your users from entering more than the maximum number of allowed characters in a Validation
Text Area widget. For example, if you select this option for a widget set to accept no more than 20 characters, the
user will not be able to type more than 20 characters in the text area.
1Select a Validation Text Area widget in the Document window.
2In the Property inspector (Window > Properties), select the Block Extra Characters option.
Customize the Validation Text Area widget
Although the Property inspector enables you to make simple edits to a Validation Text Area widget, it does not
support customized styling tasks. You can alter the CSS for the Validation Text Area widget so that you can create a
widget that is styled to your liking. For a more advanced list of styling tasks, see
www.adobe.com/go/learn_dw_sprytextarea_custom.
All CSS rules in the topics below refer to the default rules located in the SpryValidationTextArea.css file.
Dreamweaver saves the SpryValidationTextArea.css file in the SpryAssets folder of your site whenever you create a
Spry Validation Text Area widget. Consulting this file is helpful because it contains commented information about
various styles that apply to the widget.
Although you can easily edit rules for the Validation Text Area widget directly in the accompanying CSS file, you can
also use the CSS Styles panel to edit the widget’s CSS. The CSS Styles panel is helpful for locating the CSS classes
assigned to different parts of the widget, especially if you use the panel’s Current mode.
See also
“The CSS Styles panel in Current mode” on page 125
September 4, 2007
DREAMWEAVER CS3
User Guide
472
Style Validation Text Area widget error message text
By default, error messages for the Validation Text Area widget appear in red with a 1-pixel border surrounding the text.
❖To change the text styling of Validation Text Area widget error messages, use the following table to locate the
appropriate CSS rule, and then change the default properties, or add your own text styling properties and values:
Change Validation Text Area widget background colors
❖To change the background colors of the Validation Text Area widget in various states, use the following table to
locate the appropriate CSS rule, and then change the default background color values:
Working with the Validation Select widget
About the Validation Select widget
A Spry Validation Select widget is a drop-down menu that displays valid or invalid states when the user makes a
selection. For example, you can insert a Validation Select widget that contains a list of states, grouped into different
sections and divided by horizontal lines. If the user accidentally selects one of the divider lines as opposed to one of
the states, the Validation Select widget returns a message to the user stating that their selection is invalid.
The following example shows an expanded Validation Select widget, as well as the collapsed form of the widget in
various states:
Text to change Relevant CSS rule Relevant properties to change
Error message text .textareaRequiredState .textareaRe-
quiredMsg, .textareaMinCharsState
.textareaMinCharsMsg, .textar-
eaMaxCharsState .textareaMax-
CharsMsg
color: #CC3333; border: 1px solid
#CC3333;
Background color to change Relevant CSS rule Relevant property to change
Background color of widget in valid
state
.textareaValidState textarea,
textarea.textareaValidState
background-color: #B8F5B1;
Background color of widget in
invalid state
textarea.textareaRequiredState,
.textareaRequiredState textarea,
textarea.textareaMinCharsState,
.textareaMinCharsState textarea,
textarea.textareaMaxCharsState,
.textareaMaxCharsState textarea
background-color: #FF9F9F;
Background color of widget in focus .textareaFocusState textarea,
textarea.textareaFocusState
background-color: #FFFFCC;
September 4, 2007
DREAMWEAVER CS3
User Guide
473
A. Validation Select widget in focus B. Select widget, valid state C. Select widget, required state D. Select widget, invalid state
The Validation Select widget includes a number of states (for example, valid, invalid, required value, and so on). You
can alter the properties of these states using the Property inspector, depending on the desired validation results. A
Validation Select widget can validate at various points—for example, when the user clicks outside the widget, as the
makes selections, or when the user tries to submit the form.
Initial state The widget state when the page loads in the browser, or when the user resets the form.
Focus state The widget state when the user clicks the widget.
Valid state The widget state when the user has selected a valid item, and the form can be submitted.
Invalid state The widget state when the user has selected an invalid item.
Required state The widget state when the user has failed to select a valid item.
Whenever a Validation Select widget enters one of the above states through user interaction, the Spry framework
logic applies a specific CSS class to the HTML container for the widget at run time. For example, if a user tries to
submit a form, but has not selected an item from the menu, Spry applies a class to the widget so that it displays the
error message, “Please select an item.” The rules that control the style and display states of error messages reside in
the CSS file that accompanies the widget, SpryValidationSelect.css.
The default HTML for the Validation Select widget, usually inside of a form, comprises a container <span> tag that
surrounds the <select> tag of the text area. The HTML for the Validation Select widget also includes script tags in
the head of the document and after the widget’s HTML markup.
For a more comprehensive explanation of how the Validation Select widget works, including a full anatomy of the
Validation Select widget’s code, see www.adobe.com/go/learn_dw_spryselect.
Insert the Validation Select widget
1Select Insert > Spry > Spry Validation Select.
2Complete the Input Tag Accessibility Attributes dialog box and click OK.
3In Code view, add option tags that contain menu items and values. Dreamweaver does not do this for you
automatically. For more information, see the previous topic.
Note: You can also insert a Validation Select widget by using the Spry category in the Insert bar.
See also
“Create accessible HTML forms” on page 612
A
B
C
D
September 4, 2007
DREAMWEAVER CS3
User Guide
474
Specify when validation occurs
You can set the point at which validation occurs—when the user clicks outside the widget, as the user types, or when
the user tries to submit the form.
1Select a Validation Select widget in the Document window.
2In the Property inspector (Window > Properties) select the option that indicates when you want validation to
occur. You can select all of the options or none of them.
Blur Validates whenever the user clicks outside the widget.
Change Validates as the user makes selections.
Submit Validates when the user tries to submit the form.
Display widget states in Design view
1Select a Validation Select widget in the Document window.
2In the Property inspector (Window > Properties), select the state you want to see from the Preview States pop-up
menu. For example, if you want to see the widget in its valid state, select Valid.
Prohibit or allow blank values
By default, all Validation Select widgets that you insert with Dreamweaver require that users select menu items that
are have an associated value when the widget is published on a web page. You can, however, disable this option.
1Select a Validation Select widget in the Document window.
2In the Property inspector (Window > Properties), select or deselect the Do Not Allow Blank Values option,
depending on your preference.
Specify an invalid value
You can specify a value that will register as invalid if the user selects a menu item that is associated with that value.
For example, if you specify -1 as an invalid value, and you assign the value to an option tag, the widget will return an
error message if the user selects that menu item.
<option value="-1"> ------------------- </option>
1Select a Validation Select widget in the Document window.
2
In the Property inspector (Window > Properties), enter a number to use as in invalid value in the Invalid Value box.
Customize the Validation Select widget
Although the Property inspector enables you to make simple edits to a Validation Select widget, it does not support
customized styling tasks. You can alter the CSS for the Validation Select widget so that you can create a widget that
is styled to your liking. For a more advanced list of styling tasks, see
www.adobe.com/go/learn_dw_spryselect_custom.
All CSS rules in the topics below refer to the default rules located in the SpryValidationSelect.css file. Dreamweaver
saves the SpryValidationSelect.css file in the SpryAssets folder of your site whenever you create a Spry Validation
Select widget. Consulting this file is helpful because it contains commented information about various styles that
apply to the widget.
September 4, 2007
DREAMWEAVER CS3
User Guide
475
Although you can easily edit rules for the Validation Select widget directly in the accompanying CSS file, you can
also use the CSS Styles panel to edit the widget’s CSS. The CSS Styles panel is helpful for locating the CSS classes
assigned to different parts of the widget, especially if you use the panel’s Current mode.
See also
“The CSS Styles panel in Current mode” on page 125
Style Validation Select widget error message text
By default, error messages for the Validation Select widget appear in red with a 1-pixel border surrounding the text.
❖To change the text styling of Validation Select widget error messages, use the following table to locate the appro-
priate CSS rule, and then change the default properties, or add your own text styling properties and values:
Change Validation Select widget background colors
❖To change the background colors of the Validation Select widget in various states, use the following table to locate
the appropriate CSS rule, and then change the default background color values:
Working with the Validation Checkbox widget
About the Validation Checkbox widget
A Spry Validation Checkbox widget is a check box or group of check boxes in an HTML form that display valid or
invalid states when the user selects or fails to select a check box. For example, you can add a Validation Checkbox
widget to a form in which a user might be required to make three selections. If the user fails to make all three selec-
tions, the widget returns a message stating that the minimum number of selections has not been met.
The following example shows a Validation Checkbox widget in various states:
Text to style Relevant CSS rule Relevant properties to change
Error message text .selectRequiredState .selectRe-
quiredMsg, .selectInvalidState
.selectInvalidMsg
color: #CC3333; border: 1px solid
#CC3333;
Background color to change Relevant CSS rule Relevant property to change
Background color of widget in valid
state
.selectValidState select,
select.selectValidState
background-color: #B8F5B1;
Background color of widget in
invalid state
select.selectRequiredState, .selec-
tRequiredState select, select.select-
InvalidState, .selectInvalidState
select
background-color: #FF9F9F;
Background color of widget in focus .selectFocusState select,
select.selectFocusState
background-color: #FFFFCC;
September 4, 2007
DREAMWEAVER CS3
User Guide
476
A. Validation checkbox widget group, minimum number of selections state B. Validation Checkbox widget, required state
The Validation Checkbox widget includes a number of states (for example, valid, invalid, required value, and so on).
YoucanalterthepropertiesofthesestatesusingthePropertyinspector,dependingonthedesiredvalidationresults.
A Validation Checkbox widget can validate at various points—for example, when the user clicks outside the widget,
as the user makes selections, or when the user tries to submit the form.
Initial state The widget state when the page loads in the browser, or when the user resets the form.
Valid state The widget state when the user has made a selection, or the correct number of selections, and the form
can be submitted.
Required state The widget state when the user has failed to make a required selection.
Minimum Number Of Selections state The widget state when the user has selected fewer than the minimum number
of check boxes required.
Maximum Number Of Selections state The widget state when the user has selected greater than the maximum
number of check boxes allowed.
Whenever a Validation Checkbox widget enters one of these states through user interaction, the Spry framework
logic applies a specific CSS class to the HTML container for the widget at run time. For example, if a user tries to
submit a form, but has made no selections, Spry applies a class to the widget that causes it to display the error
message, “Please make a selection.” The rules that control the style and display states of error messages reside in the
CSS file that accompanies the widget, SpryValidationCheckbox.css.
The default HTML for the Validation Checkbox widget, usually inside of a form, comprises a container <span> tag
that surrounds the <input type="checkbox"> tag of the check box. The HTML for the Validation Checkbox widget
also includes script tags in the head of the document and after the widget’s HTML markup.
For a more comprehensive explanation of how the Validation Checkbox widget works, including a full anatomy of
the Validation Checkbox widget’s code, see www.adobe.com/go/learn_dw_sprycheckbox.
Insert the Validation Checkbox widget
1Select Insert > Spry > Spry Validation Checkbox.
2Complete the Input Tag Accessibility Attributes dialog box and click OK.
Note: You can also insert a Validation Checkbox widget by using the Spry category in the Insert bar.
See also
“Create accessible HTML forms” on page 612
A
B
September 4, 2007
DREAMWEAVER CS3
User Guide
477
Specify when validation occurs
You can set the point at which validation occurs—when the user clicks outside the widget, as the user makes selec-
tions, or when the user tries to submit the form.
1Select a Validation Checkbox widget in the Document window.
2In the Property inspector (Window > Properties), select the option that indicates when you want validation to
occur. You can select all of the options or none of them.
Blur Validates whenever the user clicks outside the check box.
Change Validates as the user makes selections.
Submit Validates when the user tries to submit the form.
Specify a minimum and maximum selection range
By default, a Validation Checkbox widget is set to required by default. If you insert a number of check boxes on your
page, however, you can specify a minimum and maximum selection range. For example, if you have six check boxes
within the <span> tag for a single Validation Checkbox widget, and you want to make sure that the user selects at
least three check boxes, you can set such a preference for the entire widget.
1Select a Validation Checkbox widget in the Document window.
2In the Property inspector (Window > Properties), select the Enforce Range option.
3Enter a minimum or maximum number (or both) of check boxes that you want the user to select.
Display widget states in Design view
1Select a Validation Checkbox widget in the Document window.
2In the Property inspector (Window > Properties), select the state you want to see from the Display state pop-up
menu. For example, select Initial to see the widget in its initial state.
Customize Validation Checkbox widget error messages
By default, error messages for the Validation Checkbox widget appear in red with a 1-pixel border surrounding the
text. You can alter the CSS for the Validation Checkbox widget so that you can create a widget that is styled to your
liking. For a more advanced list of styling tasks, see www.adobe.com/go/learn_dw_sprycheckbox_custom.
1Open the SpryValidationCheckbox.css file.
Dreamweaver saves the SpryValidationCheckbox.css file in the SpryAssets folder of your site whenever you create a
Spry Validation Checkbox widget. It’s helpful to consult this file because it contains commented information about
various styles that apply to the widget.
2Use the following table to locate the appropriate CSS rule, and then change the default properties, or add your own
text styling properties and values:
Text to style Relevant CSS rule Relevant properties to change
Error message text .checkboxRequiredState .check-
boxRequiredMsg, .checkboxMinSe-
lectionsState .checkboxMinSelec-
tionsMsg,
.checkboxMaxSelectionsState
.checkboxMaxSelectionsMsg
color: #CC3333; border: 1px solid
#CC3333;
September 4, 2007
DREAMWEAVER CS3
User Guide
478
Although you can easily edit rules for the Validation Checkbox widget directly in the accompanying CSS file, you can
also use the CSS Styles panel to edit the widget’s CSS. The CSS Styles panel is helpful for locating the CSS classes
assigned to different parts of the widget, especially if you use the panel’s Current mode.
See also
“The CSS Styles panel in Current mode” on page 125
Displaying data with Spry
About Spry data sets
With the Spry framework, you can insert data objects to allow users to interact with a page quickly and dynamically
from a browser window. For example, you can insert a sortable table that users can rearrange or include a Spry
dynamic table object that triggers a data update elsewhere on the page without requiring a full-page refresh.
To do this, you first identify, in Dreamweaver, one or more XML source files (the “Spry data set”) that contain your
data, and then insert one or more Spry data objects to display this data. When the user opens the page in a browser,
the data set loads as a flattened array of XML data that looks like a standard table containing rows and columns.
For example, suppose you have the following XML data structure in your XML file:
<products>
<product>
<name>Adobe Photoshop CS2</name>
<category>Digital Imaging</category>
<boximage>images/photoshop.gif</boximage>
<descheader>The professional standard in desktop digital imaging</descheader>
<desc>Adobe Photoshop CS2 software, the professional image-editing ...</desc>
</product>
<product>
<name>Adobe Illustrator CS2</name>
<category>Print Publishing</category>
<boximage>images/illustrator.gif</boximage>
<descheader>Vector graphics reinvented</descheader>
<desc>Adobe Illustrator CS2 software gives you new creative freedom ...</desc>
</product>
</products>
If you select <product> as a repeating element, the flattened array of XML data results in a column of data for each
product element, such as <name>, in the data set:
September 4, 2007
DREAMWEAVER CS3
User Guide
479
You can insert objects that display this data in a variety of ways. The following example shows how you can create a
table on a web page that includes only three elements:
With Spry, you can easily add such a table into a Dreamweaver page. You can also make one or more columns
sortable so that a user simply clicks a column to sort it.
You can also insert a dynamic table and a separate region (called a Spry detail region) on the page, and then bind
data to the detail region that displays only the <desc> element—the detailed product description-—for a single
product. After the data is bound to both regions (the dynamic table and the detail region), the detail region is
updated with the product details when the user clicks a row in the dynamic table.
When the user clicks on another product in the table, the detail region is updated with that product’s information.
Neither of these actions—sorting a table or updating a detail region when a user clicks it—require the browser to do
a full-page refresh.
You can incorporate Spry data objects into your Dreamweaver pages in many ways, some of which require a deeper
knowledge of the Spry framework. For more information about the framework, visit
www.adobe.com/go/learn_dw_spryframework. For more information on Spry Data Sets in particular, visit
www.adobe.com/go/learn_dw_sprydataset.
About dynamic Spry tables
One of the most common uses of Spry data sets is to create one or more HTML tables that dynamically update other
page data in response to a user action. For example, if a user selects a product in a table listing, Dreamweaver can
immediately update data somewhere else in your page with detailed specifications about that one product without
requiring a full-page refresh.
Name Category Descheader
Adobe Photoshop CS2 Digital Imaging The professional standard in
desktop digital imaging.
Adobe Illustrator CS2 Print Publishing Vector graphics reinvented.
September 4, 2007
DREAMWEAVER CS3
User Guide
480
These are referred to as master and detail dynamic regions. Typically, one area on the page (the master table) displays
an abbreviated set of columns from the data set, and another area of the page (the detail region) displays more infor-
mation about a selected record. Because the detail region is dependent on the master table, any changes made to the
data in the master table results in changes to the the data in the detail region.
When working with dynamic regions, you create two regions each time: the master table and a detail region, and you
must select the Update Detail Region When Row Is Clicked option as you create the master table in order to bind a
detail region to it.
When the user selects a row in the master table, Spry identifies the current row that has been acted upon and dynam-
ically updates the data displayed in the associated detail region.
Define a Spry XML data set
Before you can add Spry regions, tables, or lists to an HTML page, you need to identify the data that you want to
work with.
Note: If you don’t already have an XML data set to use for testing, the Spry assets available at
www.adobe.com/go/learn_dw_spryframework includes several sample data sets.
1Select Insert > Spry > Spry XML Data Set.
You can also click the Spry XML Data Set button in the Spry category in the Insert bar.
2You can accept the “ds1” default Spry Data Set name or you can enter a name that is more meaningful to you.
3If you have an XML data file you want to work with, click the Browse button to select it.
4If you want to design the page by using a sample feed on your test server, click the Design Time Feed link.
5After you have identified the data set to use, click the Get Schema button to populate the Row Elements panel.
This panel shows you which elements repeat (marked with a small plus sign “+”) and which are subordinate to others
(indented).
September 4, 2007
DREAMWEAVER CS3
User Guide
481
6In the Row Elements panel, select the element that contains the data you want to display. Typically this is a
repeating node, such as <product>, with several subordinate fields, such as <name>, <category>, and <descheader>.
7The XPath text box displays an expression that shows where the chosen node is located in the XML source file.
For example, if you use a data set with a schema like the one in the graphic above and then select the <product>
repeating node, the XPath text box displays “products/product” to indicate that the data found in the repeating
<product> node within the <products> data set should be displayed.
Note: XPath (XML Path Language) is a syntax for addressing portions of an XML document. It is used mostly as a query
language for XML data, just as the SQL language is used to query databases. For more information on XPath, see the
XPath language specification on the W3C website at www.w3.org/TR/xpath
8To see how your data will look in a browser, click the Preview button. This displays the first twenty rows of your
XML data file, with a column for each element.
9Sometimesit’shelpfultodefineafieldasaspecifictype,suchasnumeric,toallowvalidationofthedatainputor
todefineaspecificsortorder.Ifyouwanttochangethedatatypeforanyelement,selecttheelementintheDataSet
Columns panel and choose another value from the Data Type menu.
September 4, 2007
DREAMWEAVER CS3
User Guide
482
10 Ifyouwantyourdatatosortautomaticallyasitloads,selectanelementfromtheSortmenu.Ifyoulaterinserta
sortable Spry table with a different sort order, that sort order takes precedence.
11 Select Ascending or Descending from the Direction menu to indicate the type of sort to perform.
12 To ensure that there are no duplicate columns, select the Distinct On Load option.
13 Select the Turn XML Caching Off option if you want to load data directly from the server. By default, the Spry
XML data set is loaded to a local cache on the user’s computer to improve performance, but if you have highly
dynamic data, there is no advantage to this method.
14 Select the Auto Refresh Data option and enter a value in milliseconds. If you select this option, the data set
automatically refreshes the XML data from the server at the specified interval. This is helpful with data that changes
frequently.
15 Click OK to associate this data set with your page.
Important: When you define a Spry data set, various lines of code are added to your file to identify the Spry assets: the
xpath.js and SpryData.js files. Do not remove this code or the Spry data set functions will not work.
Use a design-time feed
If you are working with data that is still being developed, you may find it useful to use a design-time feed. For
example, if the server developer is still finalizing the database behind your XML data file, you can use a test version
of the file to design your page separately from the database development.
To use a design-time feed, you must complete the Testing Server category of the Site Definition dialog box.
❖To obtain a design-time feed, browse to locate the file and click OK. (You arrive at this dialog box by clicking the
link in the Define Spry Data Set dialog box.)
Note: When you upload your final file, remember to change the data set file location to use the server file.
See also
“Set up a testing server” on page 48
Create a Spry region
The Spry framework uses two types of regions: one is a Spry Region that wraps around data objects such as tables
and repeat lists, and the other is a Spry Detail Region that is used in conjunction with a master table object to allow
dynamic updating of data on a Dreamweaver page.
All Spry data objects must be enclosed in a Spry Region. (If you try to add a Spry data object before adding a Spry
region to a page, Dreamweaver prompts you to add a Spry region.) By default, Spry regions are in HTML <div>
containers. You can add them before you add a table, add them automatically when you insert a table or repeat list,
or you can wrap them around existing table or repeat list objects.
Ifyouareaddingadetailregion,typicallyyouaddthemastertableobjectfirstandselecttheUpdateDetailRegions
option. The only value that is different and specific for a detail region is the Type option in the Insert Spry Region
dialog box.
1Select Insert > Spry > Spry Region.
You can also click the Spry Region button in the Spry category in the Insert bar.
2For the object container, select the <div> or <span> option. The default is to use a <div> container.
September 4, 2007
DREAMWEAVER CS3
User Guide
483
3Choose one of the following options:
•To create a Spry Region, select Region (the default) as the type of region to insert.
•To create a Spry Detail Region, select the Detail Region option. You would only use a detail region if you want to
bind dynamic data that updates as data in another Spry region changes.
Important: You need to insert a detail region in a different <div> from the master table region. You might need to use
Code view to place the insertion point precisely.
4Choose your Spry data set from the menu.
5Ifyouwanttocreateorchangetheregiondefinedforanobject,selecttheobjectandchooseoneofthefollowing:
Wrap Selection Puts a new region around an object.
Replace Selection Replaces an existing region for an object.
6When you click OK, Dreamweaver puts a region placeholder into your page with the text “Content for Spry
RegionGoesHere.”YoucanreplacethisplaceholdertextwithaSprydataobjectsuchasatableorrepeatlist,orwith
dynamic data from the Bindings panel.
7ToreplacetheplaceholdertextwithaSprydataobject(forexample,aSpryTable),clicktheappropriateSprydata
object button in the Spry category of the Insert Bar.
8To replace the placeholder text with dynamic data, use one of the following methods:
•Drag one or more elements from the Bindings panel on top of the selected text.
Note: In the Bindings panel, there are some built-in Spry elements, ds_RowID, ds_CurrentRowID, and ds_RowCount,
also listed. Spry uses these to define the row in which a user clicked when determining how to update dynamic detail
regions.
•In Code view, type the code for one or more elements directly. Use this format: {dataset-name::element-
name},asin{ds1::category}.or{dsProducts::desc}. If you are only using one data set in your file, or if you
areusingdataelementsfromthesamedatasetthatyoudefinedfortheregion,youcanomitthedatasetnameand
simply write {category} or {desc}.
Regardless of which method you use to define the contents of your region, the following lines are added to your
HTML code:
<div spry:region="ds1">{name}{category}</div>
<div spry:region="ds2">{ds1::name}{ds1::descheader}</div>
September 4, 2007
DREAMWEAVER CS3
User Guide
484
Create a Spry table
There are two types of Spry tables: a simple table and a dynamic master table that binds a detail region to it in order
to allow dynamic updating of data on a Dreamweaver page.
If you are creating a simple table, you can set one or more columns as sortable and define CSS styles for various table
elements.
The process for creating a dynamic master table is the same as the process for creating a simple table; with a master
table, however, you can bind a detail dynamic region to the table so that when a user clicks on a row in the master
table, data in the detail region is dynamically updated.
To build a dynamic master Spry table, first you insert a master table, which displays the data used to trigger the
dynamic changes, and then you insert a detail region, which contains the data that undergoes change.
1Select Insert > Spry > Spry Table.
You can also click the Spry Table button in the Spry category in the Insert bar.
2Choose your Spry data set from the menu.
Note: Ifyoutrytoinsertatablebutyouhaven’tcreatedaregion,Dreamweaverpromptsyoutoaddonebeforeinserting
the table. All Spry data objects must be contained within regions.
3In the Columns panel, adjust the columns for your table by doing the following:
•Click the plus (+) or minus (-) signs to add or subtract columns.
•Click the up or down arrows to move a column. Moving a column up moves it further left in the displayed table;
moving a column down moves it to the right.
4To define a column to sort on, select it in the Columns panel and choose Sort Column When Header Is Clicked.
Repeat this for each column you want to sort on.
5IfyouhaveCSSstylesassociatedwithyourpage,eitherasanattachedstylesheetorasasetofindividualstylesin
your HTML page, you can choose a CSS class for one or more of the following options:
Odd Row Class Changes the appearance of the odd-numbered rows.
Even Row Class Changes the appearance of the even-numbered rows.
Hover Class Changes the appearance of a row when you move the mouse over it.
Select Class Changes the appearance of a row when you click on it.
Note: The order of the odd, even, hover, and select classes in your style sheet is very important. The rules should be in
theexactorderindicatedabove(odd,even,hover,select).Ifthehoverruleappearsbelowtheselectruleinthestylesheet,
the hover effect won’t appear until the user mouses over a different row. If the hover and select rules appear above the
even and odd rules in the style sheet, the even and odd effects will not work at all. You can drag rules in the CSS panel
to order them correctly, or you can manipulate the CSS code directly.
6If you are creating a simple Spry Table, deselect the default option, Update Detail Region When Row Is Clicked.
Keep the option selected if you are creating a dynamic master Spry table.
Note: If you are inserting a dynamic master table, you can see in Code view that Dreamweaver has inserted HTML table
tags and a spry:repeat tag with an onClick operation for the current row. This is how Spry determines where the user
clicked and which data to update dynamically.
September 4, 2007
DREAMWEAVER CS3
User Guide
485
7Click OK to see the table appear in Design view with a row of headers and a row of data references, enclosed in
curly brackets ({}), for each of the included elements. In Code view, HTML table tags are inserted into your file, along
with code that identifies the sortable name and category columns.
Create a Spry repeat region
You can add repeat regions to display your data. A repeat region is a simple data structure that you can format as
needed to present your data. For example, if you had a set of photograph thumbnails you want to place one after
another within a page layout object such as an AP div element.
1Select Insert > Spry > Spry Repeat.
You can also click the Spry Repeat button in the Spry category in the Insert bar.
2For the object container, select the <div> or <span> option depending on the type of tag you want. The default is
to use a <div> container.
3Select the Repeat (default) or Repeat Children option.
If you want more flexibility, you may want to use the Repeat Children option where data validation is done for each
line in a list at the child level. For instance, if you have a <ul> list, the data is checked at the <li> level. If you choose
the Repeat option, the data is checked at the <ul> level. The Repeat Children option may be especially useful if you use
conditional expressions in your code.
4Choose your Spry data set from the menu.
5If you already have text or elements selected, you can wrap or replace them.
6Click OK to display a repeat region on your page.
Note: All Spry data objects must be within regions, so make sure you’ve created a Spry region on your page before
inserting a repeat region.
7When you click OK, Dreamweaver inserts a region placeholder into your page with the text “Content for Spry
RegionGoesHere.”YoucanreplacethisplaceholdertextwithaSprydataobjectsuchasatableorrepeatlistorwith
dynamic data from the Bindings panel.
8To replace the placeholder text with a Spry data object, click the appropriate Spry data object button in the Insert Bar.
9To replace the placeholder text with one or more dynamic data, use one of the following methods:
•Drag one or more elements from the Bindings panel on top of the selected text.
Note: The Bindings panel has some built-in Spry elements, ds_RowID, ds_CurrentRowID, and ds_RowCount, also
listed. Spry uses these to define the row in which a user clicked when determining how to update dynamic detail regions.
September 4, 2007
DREAMWEAVER CS3
User Guide
486
•In Code view, type the code for one or more elements directly. Use this format: {dataset-name::element-
name},asin{ds1::category}.or{dsProducts::desc}. If you are only using one data set in your file, or if you
areusingdataelementsfromthesamedatasetthatyoudefinedfortheregion,youcanomitthedatasetnameand
simply write {category} or {desc}.
Regardless of which method you use to define the contents of your region, the following lines of code are added to
your HTML code:
<div spry:region="ds1">{name}{category}</div>
<div spry:region="ds2">{ds1::name}{ds1::descheader}</div>
Create a Spry repeat list region
You can add repeat lists to display your data as an ordered list, an unordered (bulleted) list, a definition list, or a drop-
down list.
1Select Insert > Spry > Spry Repeat List.
You can also click the Spry Repeat List button in the Spry category in the Insert bar.
2Select the container tag you want to use: UL, OL, DL, or SELECT. The other options vary depending on which
container you choose. If you choose SELECT, you must define the following fields:
•Display Column: This is what users see when they view the page in their browsers.
•Value Column: This is the actual value sent to the background server.
For example, you can create a list of states and show users Alabama and Alaska, but send AL or AL to the server. You
can also use the SELECT as a navigational tool and show product names such as “Adobe Dreamweaver” and “Adobe
Acrobat” to users, but send URLs such as “support/products/dreamweaver.html” and
“support/products/acrobat.html” to the server.
3Choose your Spry data set from the menu.
4Choose the columns you want to display.
5Click OK to display a repeat list region on your page. In Code View, you can see that HTML <ul>, <ol>, <dl> or
FORM select tags are inserted into your file.
Note: If you try to insert a repeat list region but you haven’t created a region, Dreamweaver prompts you to add one
before inserting the table. All Spry data objects must be contained within regions.
Adding Spry effects
Spry effects overview
Spry effects are visual enhancements that you can apply to almost any element on an HTML page using JavaScript.
Effects are often used to highlight information, create animated transitions, or alter a page element visually for a
duration of time. You can apply effects to HTML elements without needing additional custom tags.
Note: To apply an effect to an element, it must be currently selected or it must have an ID. If, for example, you are
applying highlighting to a div tag that is not currently selected, the div must have a valid ID value. If the element doesn’t
already, you will need to add one to the HTML code.
September 4, 2007
DREAMWEAVER CS3
User Guide
487
Effects can alter an element’s opacity, scale, position, and styling properties such as background color. You can create
interesting visual effects by combining two or more properties.
Because these effects are Spry-based, when a user clicks on an object with an effect, only the object is dynamically
updated, without refreshing the entire HTML page.
Spry includes these effects:
Appear/Fade Makes an element appear or fade away.
Highlight Changes the background color of an element.
Blind Up/Down Simulates a window blind that goes up or down to hide or reveal the element.
Slide Moves the element up or down.
Grow/Shrink Increases or reduces the size of the element.
Shake Simulates shaking the element from left to right.
Squish Makes the element disappear into the upper-left corner of the page.
Important: When you use an effect, various lines of code are added to your file in the Code view. One line identifies the
SpryEffects.js file, which is necessary to include the effects. Do not remove this line from your code or the effects will not work.
For a comprehensive overview of the Spry effects available in the Spry framework, visit
www.adobe.com/go/learn_dw_spryeffects.
Apply an Appear/Fade effect
Note: You can use this effect with any HTML objects except applet, body, iframe, object, tr, tbody, or th.
1(Optional) Select the content or layout object you want to apply the effect to.
2
In the Behaviors panel (Window > Behaviors), click the Plus (+) button and select Effects > Appear/Fade from the menu.
3Select the object’s ID from the target element menu. If you already selected an object, choose <Current Selection>.
4In the Effect Duration box, define the time it takes for the effect to occur, in milliseconds.
5Select the effect you want to apply: Fade or Appear.
6In the Fade From box, define the percentage of opacity you want the effect to have when it appears.
7In the Fade To box, define the percentage of opacity you want to fade to.
8Select Toggle Effect if you want the effect to be reversible, going from fade to appear and back again with
successive clicks.
Apply a Blind up/Blind down effect
Note: You can only use this effect with these HTML objects: address, dd, div, dl, dt, form, h1, h2, h3, h4, h5, h6, p, ol, ul,
li, applet, center, dir, menu, or pre.
1(Optional) Select the content or layout object you want to apply the effect to.
2In the Behaviors panel (Window > Behaviors), click the Plus (+) button and select Effects > Blind from the menu.
3Select the object’s ID from the target element menu. If you already selected object, choose <Current Selection>.
4In the Effect Duration box, define the time it takes for the effect to occur, in milliseconds.
5Select the effect you want to apply: Blind Up or Blind Down.
September 4, 2007
DREAMWEAVER CS3
User Guide
488
6In the Blind Up From/Blind Down From box, define the blind-scrolling starting point as a percentage or as a pixel
number. These values are calculated from the top of the object.
7In the Blind Up To/Blind Down To field, define the blind-scrolling end point as a percentage or as a pixel number.
These values are calculated from the top of the object.
8Select Toggle Effect if you want the effect to be reversible, scrolling up and down with successive clicks.
Apply a Grow/Shrink effect
Note: You can use this effect with these HTML objects: address, dd, div, dl, dt, form, p, ol, ul, applet, center, dir, menu,
or pre.
1(Optional) Select the content or layout object you want to apply the effect to.
2In the Behaviors panel (Window > Behaviors), click the Plus (+) button and select Effects > Grow/Shrink from
the popup menu.
3Select the object’s ID from the target element pop-up menu. If you have already selected an object, choose
<Current Selection>.
4In the Effect Duration field, define the time it takes for the effect to occur, in milliseconds.
5Select the effect you want to apply: Grow or Shrink.
6In the Grow/Shrink From box, define the object’s size when the effect starts. This is a percentage of the size or a
pixel value.
7In the Grow/Shrink To box, define the object’s size when the effect ends. This is a percentage of the size or a pixel
value.
8If you choose pixels for either the Grow/Shrink From or To boxes, the wide/high field becomes visible. Depending
on the option you choose, the element will grow or shrink proportionately.
9Select whether you want the element to grow or shrink to the upper-left corner of the page or into the page’s center.
10 Select Toggle Effect if you want the effect to be reversible, growing and shrinking with successive clicks.
Apply a Highlight effect
Note: You can use this effect with any HTML objects except applet, body, frame, frameset, or noframes.
1(Optional) Select the content or layout object you want to apply the effect to.
2
In the Behaviors panel (Window > Behaviors), click the Plus (+) button and select Effects > Highlight from the menu.
3Select the object’s ID from the target element menu. If you already selected an object, choose <Current Selection>.
4In the Effect Duration box, define how long you want the effect to last, in milliseconds.
5Select the color you want the highlight to start with.
6Select the color you want the highlight to end with. This color lasts only as long as the duration you define in Effect
Duration.
7Select the color for the object after the highlight has finished.
8Select Toggle Effect if you want the effect to be reversible, cycling through the highlight colors with successive
clicks.
September 4, 2007
DREAMWEAVER CS3
User Guide
489
Apply a Shake effect
Note: You can use this effect with these HTML objects: address, blockquote, dd, div, dl, dt, fieldset, form, h1, h2, h3, h4,
h5, h6, iframe, img, object, p, ol, ul, li, applet, dir, hr, menu, pre, or table.
1(Optional) Select the content or layout object you want to apply the effect to.
2In the Behaviors panel (Window > Behaviors), click the Plus (+) button and select Effects > Shake from the menu.
3Select the object’s ID from the target element menu. If you have already selected an object, choose <Current
Selection>.
Apply a Slide effect
FortheSlideeffecttoworkproperlythetargetelementmustbewrappedinacontainertagthathasauniqueID.The
container tag with which you wrap the target element must be a blockquote,dd,form,div, or center tag.
The target element tag must be one of the following: blockquote,dd,div,form,center,table,span,input,
textarea,select, or image.
1(Optional) Select the container tag of the content you want to apply the effect to.
2In the Behaviors panel (Window > Behaviors), click the Plus (+) button and select Effects > Slide from the menu.
3Select the container tag’s ID from the target element menu. If the container is already selected, choose <Current
Selection>.
4In the Effect Duration field, define the time it takes for the effect to occur, in milliseconds.
5Select the effect you want to apply: Slide Up or Slide Down.
6In the Slide Up From box, define the sliding starting point as a percentage or as a pixel number.
7In the Slide Up To box, define the sliding end point as a percentage or as a positive pixel amount.
8Select Toggle Effect if you want the effect to be reversible, sliding up and down with successive clicks.
Apply a Squish effect
Note: You can only use this effect with these HTML objects: address, dd, div, dl, dt, form, img, p, ol, ul, applet, center,
dir, menu, or pre.
1(Optional) Select the content or layout object you want to apply the effect to.
2In the Behaviors panel (Window > Behaviors), click the Plus (+) button and select Effects > Squish from the menu.
3Select the object’s ID from the target element menu. If you have already selected an object, choose <Current
Selection>.
Add an additional effect
You can associate multiple effect behaviors with the same object to produce interesting results.
1(Optional) Select the content or layout object you want to apply the effect to.
2In the Behaviors panel (Window > Behaviors), click the Plus (+) button and select an effect from the Effects menu.
3Select the object’s ID from the target element menu. If you have already selected an object, choose <Current
Selection>.
September 4, 2007
DREAMWEAVER CS3
User Guide
490
Delete an effect
You can remove one or more effect behaviors from an object.
1(Optional) Select the content or layout object you want to apply the effect to.
2In the Behaviors panel (Window > Behaviors), click the effect you want to delete from the list of behaviors.
3Do one of the following:
•Click the Remove Event button in the subpanel title bar (-).
•Right-click (Windows) or Control-click (Macintosh) the behavior, and select Delete Behavior.
September 4, 2007
491
Chapter 17: Preparing to build dynamic
sites
Before you begin building dynamic web pages, there are a few preparations that must be done, including setting up
a web application server and connecting to a database for Coldfusion, ASP, ASP.NET, JSP, and PHP applications.
Adobe® Dreamweaver® CS3 handles database connections differently depending on your server technology.
Understanding web applications
About web applications
A web application is a website that contains pages with partly or entirely undetermined content. The final content of
a page is determined only when the visitor requests a page from the web server. Because the final content of the page
varies from request to request based on the visitor’s actions, this kind of page is called a dynamic page.
Web applications are built to address a variety of challenges and problems. This section describes common uses for
web applications and gives a simple example.
Common uses for web applications
Web applications have many uses for both site visitors and developers, including the following:
•Let visitors find information quickly and easily on a content-rich website.
This kind of web application gives visitors the ability to search, organize, and navigate content as they see fit.
Examples include company intranets, Microsoft MSDN (www.msdn.microsoft.com), and Amazon.com
(www.amazon.com).
•Collect, save, and analyze data provided by site visitors.
In the past, data entered in HTML forms was sent as e-mail messages to employees or CGI applications for
processing. A web application can save form data directly into a database and also extract the data and create web-
based reports for analysis. Examples include online banking pages, store check-out pages, surveys, and user-feedback
forms.
•Update websites that have constantly changing content.
A web application frees the web designer from continually updating the site’s HTML. Content providers such as news
editors provide the web application with content, and the web application updates the site automatically. Examples
include the Economist (www.economist.com) and CNN (www.cnn.com).
Web application example
Janet is a professional web designer and longtime Dreamweaver user responsible for maintaining the intranet and
Internet sites of a medium-sized company of 1000 employees. One day, Chris from Human Resources comes to her
with a problem. HR administers an employee fitness program that gives employees points for every mile walked,
biked, or run. Each employee must report his or her monthly mile totals in an e-mail to Chris. At the end of the
month, Chris gathers all the e-mail messages and awards employees small cash prizes according to their point totals.
September 4, 2007
DREAMWEAVER CS3
User Guide
492
Chris’s problem is that the fitness program has grown too successful. So many employees now participate that Chris
is inundated with e-mails at the end of each month. Chris asks Janet if a web-based solution exists.
Janet proposes an intranet-based web application that performs the following tasks:
•Lets employees enter their mileage on a web page using a simple HTML form
•Stores the employees’ mileage in a database
•Calculates fitness points based on the mileage data
•Lets employees track their monthly progress
•Gives Chris one-click access to point totals at the end of each month
Janet gets the application up and running before lunchtime using Dreamweaver, which has the tools she needs to
build this kind of application quickly and easily.
How a web application works
A web application is a collection of static and dynamic web pages. A static web page is one that does not change when
a site visitor requests it: The web server sends the page to the requesting web browser without modifying it. In
contrast, a dynamic web page ismodifiedbytheserverbeforeitissenttotherequestingbrowser.Thechangingnature
of the page is why it’s called dynamic.
For example, you could design a page to display fitness results, while leaving certain information (such as employee
name and results) to be determined when the page is requested by a particular employee.
The next sections describe how web applications work in greater detail.
Processing static web pages
A static website comprises a set of related HTML pages and files hosted on a computer running a web server.
A web server is software that serves web pages in response to requests from web browsers. A page request is
generated when a visitor clicks a link on a web page, selects a bookmark in a browser, or enters a URL in a browser’s
address text box.
The final content of a static web page is determined by the page designer and doesn’t change when the page is
requested. Here’s an example:
<html>
<head>
<title>Trio Motors Information Page</title>
</head>
<body>
<h1>About Trio Motors</h1>
<p>Trio Motors is a leading automobile manufacturer.</p>
</body>
</html>
Every line of the page’s HTML code is written by the designer before the page is placed on the server. Because the
HTML doesn’t change once it’s on the server, this kind of page is called a static page.
Note: Strictly speaking, a “static” page may not be static at all. For example, a rollover image or Flash content (a SWF
file) can make a static page come alive. However, this documentation refers to a page as static if it is sent to the browser
without modifications.
September 4, 2007
DREAMWEAVER CS3
User Guide
493
When the web server receives a request for a static page, the server reads the request, finds the page, and sends it to
the requesting browser, as the following example shows:
A. Step 1 - Web browser requests static page. B. Step 2 - Web server finds page. C. Step 3 - Web server sends page to requesting browser.
In the case of web applications, certain lines of code are undetermined when the visitor requests the page. These lines
mustbedeterminedbysomemechanismbeforethepagecanbesenttothebrowser.Themechanismisdiscussedin
the following section.
Processing dynamic pages
When a web server receives a request for a static web page, the server sends the page directly to the requesting
browser. When the web server receives a request for a dynamic page, however, it reacts differently: It passes the page
to a special piece of software responsible for finishing the page. This special software is called an application server.
The application server reads the code on the page, finishes the page according to the instructions in the code, and
then removes the code from the page. The result is a static page that the application server passes back to the web
server, which then sends the page to the requesting browser. All the browser gets when the page arrives is pure
HTML. Here’s a view of the process:
A
B
C
September 4, 2007
DREAMWEAVER CS3
User Guide
494
A. Step 1 - Web browser requests dynamic page. B. Step 2 - Web server finds page and passes it to application server. C. Step 3- Application
server scans page for instructions and finishes page. D. Step 4- Application server passes finished page back to web server E. Step 5 - Web
server sends finished page to requesting browser
Accessing a database
Anapplicationserverletsyouworkwithserver-sideresourcessuchasdatabases.Forexample,adynamicpagemay
instruct the application server to extract data from a database and insert it into the page’s HTML. For more infor-
mation, see www.adobe.com/go/learn_dw_dbguide.
The instruction to extract data from a database is called a database query. A query consists of search criteria
expressed in a database language called SQL (Structured Query Language). The SQL query is written into the page’s
server-side scripts or tags.
An application server cannot communicate directly with a database because the database’s proprietary format
renders the data undecipherable in much the same way that a Microsoft Word document opened in Notepad or
BBEdit may be undecipherable. The application server can communicate with the database only through the inter-
mediary of a database driver: software that acts like an interpreter between the application server and the database.
After the driver establishes communication, the query is executed against the database and a recordset is created. A
recordset is a set of data extracted from one or more tables in a database. The recordset is returned to the application
server, which uses the data to complete the page.
Here’s a simple database query written in SQL:
SELECT lastname, firstname, fitpoints
FROM employees
This statement creates a three-column recordset and fills it with rows containing the last name, first name, and fitness
points of all employees in the database. For more information, see www.adobe.com/go/learn_dw_sqlprimer.
The following example shows the process of querying a database and returning data to the browser:
A
B
C
E
D
September 4, 2007
DREAMWEAVER CS3
User Guide
495
A. Step 1 - Web browser requests dynamic page. B. Step 2 - Web server finds page and passes it to application server. C. Step 3 - Application
server scans page for instructions. D. Step4-Applicationserversendsquerytodatabasedriver. E. Step 5 - Driver executes the query against
the database. F. Step6-Recordsetisreturnedtodriver. G. Step 7 - Driver passes recordset to application server H. Step 8 - Application server
inserts data in page, and then passes the page to the web server I. Step 9 - Web server sends finished page to requesting browser.
You can use almost any database with your web application, as long as the appropriate database driver for it is
installed on the server.
If you plan to build small low-cost applications, you can use a file-based database, such as one created in Microsoft
Access. If you plan to build robust, business-critical applications, you can use a server-based database, such as one
created in Microsoft SQL Server, Oracle 9i, or MySQL.
If your database is located on a system other than your web server, make sure you have a fast connection between
the two systems so that your web application can operate quickly and efficiently.
Authoring dynamic pages
Authoring a dynamic page consists of writing the HTML first, and then adding the server-side scripts or tags to the
HTMLtomakethepagedynamic.Whenyouviewtheresultingcode,thelanguageappearsembeddedinthepage’s
HTML. Accordingly, these languages are known as HTML embedded programming languages. The following basic
example uses ColdFusion Markup Language (CFML):
A
B
C
D
E
I
H
G
F
September 4, 2007
DREAMWEAVER CS3
User Guide
496
<html>
<head>
<title>Trio Motors Information Page</title>
</head>
<body>
<h1>About Trio Motors</h1>
<p>Trio Motors is a leading automobile manufacturer.</p>
<!--- embedded instructions start here --->
<cfset department="Sales">
<cfoutput>
<p>Be sure to visit our #department# page.</p>
</cfoutput>
<!--- embedded instructions end here --->
</body>
</html>
The embedded instructions on this page perform the following actions:
1Create a variable called department and assign the string "Sales" to it.
2Insert the variable’s value, "Sales", in the HTML code.
The application server returns the following page to the web server:
<html>
<head>
<title>Trio Motors Information Page</title>
</head>
<body>
<h1>About Trio Motors</h1>
<p>Trio Motors is a leading automobile manufacturer.</p>
<p>Be sure to visit our Sales page.</p>
</body>
</html>
The web server sends the page to the requesting browser, which displays it as follows:
About Trio Motors
Trio Motors is a leading automobile manufacturer.
Be sure to visit our Sales page.
You choose a scripting or tag-based language to use depending on the server technology available on your server.
Here are the most popular languages for the five server technologies supported by Dreamweaver:
Server technology Language
ColdFusion ColdFusion Markup Language (CFML)
ASP.NET Visual Basic
C#
Active Server Pages (ASP) VBScript
JavaScript
JavaServer Pages (JSP) Java
PHP PHP
September 4, 2007
DREAMWEAVER CS3
User Guide
497
Dreamweaver can create the server-side scripts or tags necessary to make your pages work, or you can write them by
hand in the Dreamweaver coding environment.
See also
“Choosing your application server” on page 502
Web application terminology
This section defines frequently used terms relating to web applications.
An application server Software that helps a web server process web pages containing server-side scripts or tags.
When such a page is requested from the server, the web server hands the page off to the application server for
processing before sending the page to the browser. For more information, see “How a web application works” on
page 492.
Common application servers include ColdFusion, Macromedia JRun Server, the Microsoft .NET Framework, IBM
WebSphere, and Apache Tomcat.
A database Acollectionofdatastoredintables.Eachrowofatableconstitutesonerecordandeachcolumnconsti-
tutes a field in the record, as shown in the following example:
A database driver Software that acts as an interpreter between a web application and a database. Data in a database
is stored in a proprietary format. A database driver lets the web application read and manipulate data that would
otherwise be undecipherable.
A database management system (DBMS, or database system) Software used to create and manipulate databases.
Common database systems include Microsoft Access, Oracle 9i, and MySQL.
A database query The operation that extracts a recordset from a database. A query consists of search criteria
expressed in a database language called SQL. For example, the query can specify that only certain columns or only
certain records be included in the recordset.
A dynamic page A web page customized by an application server before the page is sent to a browser.
A recordset A set of data extracted from one or more tables in a database, as in the following example:
September 4, 2007
DREAMWEAVER CS3
User Guide
498
A relational database A database containing more than one table, with the tables sharing data. The following
database is relational because two tables share the DepartmentID column.
A server technology The technology that an application server uses to modify dynamic pages at runtime.
The Dreamweaver development environment supports the following server technologies:
•Macromedia® ColdFusion® from Adobe
•Microsoft ASP.NET
•Microsoft Active Server Pages (ASP)
•Sun JavaServer Pages (JSP)
•PHP: Hypertext Preprocessor (PHP)
YoucanalsousetheDreamweavercodingenvironmenttodeveloppagesforanyotherservertechnologynotlisted.
A static page Awebpagethatisnotmodifiedbyanapplicationserverbeforethepageissenttoabrowser.Formore
information, see “Processing static web pages” on page 492.
A web application A website that contains pages with partly or entirely undetermined content. The final content of
these pages is determined only when a visitor requests a page from the web server. Because the final content of the
page varies from request to request based on the visitor’s actions, this kind of page is called a dynamic page.
A web server Software that sends out web pages in response to requests from web browsers. A page request is
generated when a visitor clicks a link on a web page in the browser, selects a bookmark in the browser, or enters a
URL in the browser’s address text box.
Popular web servers include Microsoft Internet Information Server, Microsoft Personal Web Server, Apache HTTP
Server, Netscape Enterprise Server, and Sun ONE Web Server.
Installing a local web server
Web server basics
Todevelopandtestdynamicwebpages,youneedafunctioningwebserver.Awebserverissoftwarethatservesweb
pages in response to requests from web browsers. A web server is sometimes called an HTTP server. You can install
and use a web server on your local computer.
If you’re a Macintosh user, you can use the Apache web server already installed on your Macintosh.
Note: Adobe does not provide technical support for third-party software such as Microsoft Internet Information Server.
If you need assistance with a Microsoft product, please contact Microsoft technical support.
September 4, 2007
DREAMWEAVER CS3
User Guide
499
If you use Internet Information Server (IIS) to develop web applications, the default name of your web server is the
name of your computer. You can change the server name by changing the name of your computer. If your computer
has no name, the server uses the word localhost.
The server name corresponds to the server’s root folder, which (on a Windows computer) is most likely
C:\Inetpub\wwwroot. You can open any web page stored in the root folder by entering the following URL in a
browser running on your computer:
http://your_server_name/your_file_name
For example, if the server name is mer_noire and a web page called soleil.html is stored in C:\Inetpub\wwwroot\,
you can open the page by entering the following URL in a browser running on the local computer:
http://mer_noire/soleil.html
Note: Remember to use forward slashes, not backslashes, in URLs.
You can also open any web page stored in any subfolder of the root folder by specifying the subfolder in the URL.
For example, suppose the soleil.html file is stored in a subfolder called gamelan, as follows:
C:\Inetpub\wwwroot\gamelan\soleil.html
You can open this page by entering the following URL in a browser running on your computer:
http://mer_noire/gamelan/soleil.html
When the web server is running on your computer, you can replace the server name with localhost.Forexample,
the following URLs open the same page in a browser:
http://mer_noire/gamelan/soleil.html
http://localhost/gamelan/soleil.html
Note: .Another expression you can use instead of the server name or localhost is 127.0.0.1 (for example,
http://127.0.0.1/gamelan/soleil.html).
See also
“Installing a local web server” on page 498
Choosing your web server
To develop and test web applications, you can choose from a number of common web servers including Microsoft
Internet Information Server (IIS), Netscape Enterprise Server, Sun ONE Web Server, and Apache HTTP Server.
If you’re not using a web hosting service, choose a web server and install it on your local computer or on a remote
computer. Windows users who want to develop ColdFusion web applications can use the web server included in the
developer edition of the ColdFusion MX 7 application server, which you can install and use for free.
Other Windows users can run a web server on their local computer by installing IIS. This web server may already be
installed on your system. Check your folder structure to see if it contains a C:\Inetpub or D:\Inetpub folder. IIS
creates this folder during installation.
ASP.NET pages only work with one web server: Microsoft IIS 5 or later. Because IIS 5 is a service of the Windows
2000 and Windows XP Professional operating systems, you can use these two versions of Windows to host ASP.NET
applications. However, you can develop (as opposed to host) ASP.NET applications on any computer running
Dreamweaver, including the Mac OS.
September 4, 2007
DREAMWEAVER CS3
User Guide
500
For the Mac OS, you can use a web hosting service or install the required software on a remote computer. You can
also develop PHP sites locally using the Apache web server and PHP application server installed with your operating
system.
For information on installing and configuring other web servers, see the server vendor’s documentation or your
system administrator.
Install Internet Information Server (Windows)
Windows XP Professional users can install Internet Information Server (IIS).
Note: If you want to develop ColdFusion applications, you can instead use the web server installed with the developer
edition of the ColdFusion MX 7.
If you’re a Windows XP Professional user, check whether IIS is already installed and running on your system. The
way to do this is to look for the C:\Inetpub folder. If it doesn’t exist, IIS is probably not installed on your system.
1Select Start > Settings > Control Panel > Add or Remove Programs, or Start > Control Panel > Add or Remove
Programs.
2Select Add/Remove Windows Components.
3Select Internet Information Services (IIS) and click Next.
4Follow the installation instructions and test the web server.
Test Internet Information Server (IIS)
1Create a simple HTML page called myTestFile.html, and save it in the Inetpub\wwwroot folder on the computer
where the web server is running. The HTML page can consist of a single line:
<p>My web server is working.</p>
2Open the test page in a web browser with an HTTP request. If IIS is running on your local computer, enter the
following URL in your web browser:
http://localhost/myTestFile.html
3IfIISisrunningonanetworkedcomputer,usethenetworkedcomputer’snameasthedomainname.Forexample,
if the name of the computer running IIS is rockford-pc, enter the following URL in your browser:
http://rockford-pc/myTestFile.html
4If the browser displays your page, the web server is running normally.
If the browser fails to display the page, make sure the server is running. If the page still fails to open, make sure your
test page is located in the Inetpub\wwwroot folder and has a .htm or .html file extension.
Start the Macintosh web server
You can use the Apache web server already installed on your Macintosh to develop PHP or ColdFusion applications.
Note: If you want to develop ColdFusion applications, you can instead use the web server installed with the developer
edition of the ColdFusion MX 7.
1Select Apple > System Preferences > Sharing.
2Select the Personal Web Sharing option from the Services tab.
3Click the Start button and test the web server.
September 4, 2007
DREAMWEAVER CS3
User Guide
501
Test the Macintosh web server
1Create a simple HTML page called myTestFile.html and save it in the /Users/your_user_name/Sites/ folder on
your Macintosh (where your_user_name is your Macintosh user name). The HTML page can consist of a single line,
such as:
<p>My web server is working.</p>
2Open the test page in a web browser with an HTTP request by entering the following URL in your web browser:
http://localhost/~your_user_name/myTestFile.html
3If the browser displays your page, the web server is running normally. If the browser fails to display the page, make
sure you specified your Macintosh user name prefixed with the ~ character.
Note: Your Apache web server won’t work with PHP by default; you must configure it before you can use PHP.
See also
“Install a PHP application server” on page 503
Setting up a web application
What you need to build web applications
To build web applications in Adobe® Dreamweaver® CS3, you need the following software:
•A web server
•An application server that works with your web server
Note: In the context of web applications, the terms web server and application server refer to software, not hardware.
If you want to use a database with your application, you require the following additional software:
•A database system
•A database driver that supports your database
Several web hosting companies offer plans that let you use their software to test and deploy web applications. In some
cases, you can install the required software on the same computer as Dreamweaver for development purposes. You
can also install the software on a network computer (typically a Windows 2000 or XP computer) so that other devel-
opers on your team can work on a project.
If you want to use a database with your web application, you must first connect to it.
See also
“Installing a local web server” on page 498
September 4, 2007
DREAMWEAVER CS3
User Guide
502
Choosing your application server
An application server is software that helps a web server process dynamic pages. When choosing an application
server, you should consider several factors, including your budget, the server technology you want to use
(ColdFusion, ASP.NET, ASP, JSP, or PHP), and the type of web server.
Budget Some vendors sell high-end application servers that are expensive to buy and administer. Others vendors
provide easier, more cost-effective solutions (examples include ColdFusion and JRun servers). Some application
servers are built into web servers (such as Microsoft IIS) and others can be downloaded for free from the Internet
(such as Jakarta Tomcat and PHP).
Server technology Application servers use different technologies. Dreamweaver supports five server technologies:
ColdFusion, ASP.NET, ASP, JSP, and PHP. The following table shows common application servers available for the
five server technologies supported by Dreamweaver:
Note: Make sure the application server works with your web server. For example, the .NET Framework only works with
IIS 5 or higher.
To learn more about ColdFusion, select ColdFusion Help from the Help menu.
To learn more about ASP.NET, visit the Microsoft website at http://msdn.microsoft.com/asp.net/.
To learn more about ASP, visit the Microsoft website at
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnanchor/html/activeservpages.asp.
To learn more about JSP, visit the Sun Microsystems website at java.sun.com/products/jsp/.
To learn more about PHP, visit the PHP website at www.php.net/.
Installing a ColdFusion application server
To run ColdFusion pages, you need the ColdFusion application server. This server is available for Windows, Linux,
Solaris, and HP-UX systems.
Both Windows and Macintosh users can download and install a fully functional, developer edition of ColdFusion
MX 7 from the Adobe website at www.adobe.com/go/coldfusion/.
Note: The Developer Edition is for non-commercial use for developing and testing web applications. It is not licensed for
deployment. It supports requests from the local host and two remote IP addresses. You can use it to develop and test your
web applications as long as you want; the software does not expire. For more information, see ColdFusion help (Help >
ColdFusion Help).
Server technology Application server
ColdFusion Macromedia ColdFusion MX 7
ASP.NET Microsoft IIS 6 with .NET Framework
ASP Microsoft IIS
Sun ONE Active Server Pages
JSP Macromedia JRun
Apache Tomcat
PHP PHP server
September 4, 2007
DREAMWEAVER CS3
User Guide
503
During installation, you can configure ColdFusion to use the web server built into ColdFusion or another web server
installed on your system. Generally, it’s best to match your development environment to your production
environment. Therefore, if you have an existing web server such as Microsoft IIS on your development computer,
you may want to use it instead of the built-in ColdFusion web server.
After installing the application server, create a root folder for your web application.
Install a PHP application server
To run PHP pages, you need the PHP application server, which is open-source software available on the web.
Editions of the application server exist for Windows, Linux, UNIX, HP-UX, Solaris, and Mac OS X systems.
For more information on the application server, see the PHP documentation, which you can also download from the
PHP website at www.php.net/download-docs.php.
Install the PHP application server in Windows
1If applicable, log into your Windows system using the Administrator account.
2Download the Windows PHP 5.x installer from the PHP website at www.php.net/downloads.php.
3Double-click the installer file you downloaded and follow the onscreen installation instructions.
4At the Choose Items To Install screen, click the Plus (+) button next to Extensions, locate MySQL in the list, and
then select the Will Be Installed On Local Hard Drive option.
With PHP 5, the MySQL extension that allows PHP to work with a MySQL database server is not installed or enabled
by default by the Windows installer.
5In the PHP installation folder (likely C:\Program Files\PHP), locate the file called php.ini and open it in Notepad.
You must edit this file to enable the MySQL extension.
6Find the following line in the php.ini file:
;extension=php_mysql.dll
The semicolon (;) at the start of the line tells PHP to ignore the line.
7Delete the semicolon at the start of the line to enable the extension.
extension=php_mysql.dll
8Save and close the php.ini file.
9In the PHP installation folder, locate the file called libmysql.dll and copy it to the C:\Windows\system32 folder.
This file is required so that IIS can work with PHP 5 and MySQL.
10 Restart IIS.
After installing PHP, you can test the server to make sure it works properly. See the next section.
Test the PHP installation in Windows
1In Dreamweaver or any text editor, create a plain text file and name it timetest.php.
2In the file, enter the following code:
<p>This page was created at <b>
<?php echo date("h:i:s a", time()); ?>
</b> on the computer running PHP.</p>
September 4, 2007
DREAMWEAVER CS3
User Guide
504
This code displays the time when the page was processed on the server.
3Copy the file to the C:\Inetpub\wwwroot folder of the Windows computer running IIS.
4In your web browser, enter the URL of your test page, and then press Enter.
If you installed PHP on your local computer, you can enter the following URL:
http://localhost/timetest.php
The test page should open and display the time of day.
The specified time is known as dynamic content because it changes every time you request the page. Click your
browser’s Refresh button to generate a new page with a different time.
Note: Looking at the source code (View > Source In Internet Explorer) will confirm that the page does not use any client-
side JavaScript to achieve this effect.
If the page doesn’t work as expected, check for the following possible errors:
•The file does not have a .php extension.
•You typed the page’s file path (C:\Inetput\wwwroot\timetest.php) instead of its URL (for example,
http://localhost/timetest.php) in the browser’s address text box.
If you type a file path in the browser (as you might be used to doing with normal HTML pages), you bypass the web
server and the application server. As a result, your page never gets processed by the server.
•The URL contains a typing mistake. Check for errors and make sure the filename is not followed by a slash, such
as http://localhost/timetest.php/.
•The page code contains a typing mistake.
After installing and testing the server software, create a root folder for your web application. See “Creating a root
folder for the application” on page 506.
To install the PHP application server on the Macintosh
1If applicable, log into your Macintosh system using the Administrator account.
2Create a folder named webapps in your main user folder, Users/your_user_name/webapps).
3From the Entropy web site at www.entropy.ch/software/macosx/php/, download the PHP for 5.x for Apache 1.3
package (for example, entropy-php-5.2.0-3.tar.gz) and save it in your webapps folder.
4On your Macintosh, open Terminal (Applications/Utilities) and change the default folder to webapps by typing
the following line on the Command line and pressing Enter:
cd webapps
5In Terminal, uncompress the gz file by typing gunzip followed by the name of the gz file in your webapps folder.
For example, if you downloaded entropy-php-5.2.0-3.tar.gz, enter the following command and press Enter:
gunzip entropy-php-5.2.0-3.tar.gz
Note: Do not use Stuffit Expander to uncompress the file.
6In Terminal, open the tar archive that was uncompressed by typing tar xf followed by the name of the tar file.
Example:
tar xf entropy-php-5.2.0-3.tar
An installer package called entropy-php.mpkg is extracted from the archive.
September 4, 2007
DREAMWEAVER CS3
User Guide
505
7Double-click the installer package entropy-php.mpkg and follow the onscreen instructions.
After installing PHP, you can test the server to make sure it works properly. See the next section.
Test the PHP installation on the Macintosh
1In Dreamweaver or any text editor, create a plain text file and name it timetest.php.
2In the file, enter the following code:
<p>This page was created at <b>
<?php echo date("h:i:s a", time()); ?>
</b> on the computer running PHP.</p>
This code displays the time the page when was processed on the server.
3Copy the file to the /Users/your_user_name/Sites folder on your Macintosh.
This Sites folder is your personal root folder for the Apache web server.
4In your web browser, enter the following URL and press Return:
http://localhost/~your_user_name/timetest.php
The test page should open and display the time of day.
The specified time is known as dynamic content because it changes every time you request the page. Click your
browser’s Refresh button to generate a new page with a different time.
Note: Lookingatthesourcecode(View>ViewSourceInSafari)willconfirmthatthepagedoesnotuseanyclient-side
JavaScript to achieve this effect.
If the page doesn’t work as expected, check for the following possible errors:
•The file does not have a .php extension.
•TheURLcontainsatypingmistake.Checkforerrorsandmakesurethefilenameisnotfollowedbyaslash,suchas
http://localhost/~your_user_name/timetest.php/. Also make sure you included the tilde (~) before your user name.
•The page code contains a typing mistake.
•The Apache server is not running. Look in System Preferences, in the Sharing category, to see whether Personal
Web Sharing is enabled.
After testing and testing the server software, create a root folder for your web application. See “Creating a root folder
for the application” on page 506.
Installing an ASP application server
To run ASP pages, you need an application server that supports Microsoft Active Server Pages 2.0., such as Microsoft
IIS (Internet Information Services), which comes with Windows 2000 and Windows XP Professional.
Windows XP Professional users can install and run IIS on their local computer. For instructions, see “Install Internet
Information Server (Windows)” on page 500.
Macintosh users can use a web hosting service with an ASP plan or install IIS on a remote computer.
After installing IIS, create a root folder for your web application.
September 4, 2007
DREAMWEAVER CS3
User Guide
506
Install an ASP.NET application server
To develop and run ASP.NET pages, you need the following software:
•A Windows 2000 or Windows XP Professional computer running IIS 5 or later
•The Microsoft .NET Framework 1.1 and the Microsoft .NET Framework 1.1 Software Development Kit (SDK),
which you can download from the Microsoft website
Note: Make sure that both the Framework and the SDK are installed on a Windows 2000 or Windows XP Professional
system running IIS 5 or higher.
1Check that the .NET Framework is installed on your system by reviewing the list of applications in the Add Or
Remove Programs dialog box (Start > Control Panel > Add Or Remove Programs). If Microsoft .NET Framework
1.1 is listed, the Framework is already installed and you can skip to step 3.
2If the .NET Framework is not installed on your system, download and install the Microsoft .NET Framework 1.1
Redistributable package from the Microsoft website and follow the installation instructions on the website.
Note: You install the Framework as a Windows update.
3Download the Microsoft .NET Framework 1.1 Software Development Kit (SDK) from the Microsoft website and
follow the installation instructions.
After installing the .NET Framework and SDK, you should also install the Microsoft Data Access Components
(MDAC) 2.8 package. You can download and install it for free from the Microsoft website at
http://msdn.microsoft.com/data/mdac/downloads/.
Macintosh users can use a web hosting service with an ASP.NET plan or install the .NET Framework and SDK on a
remote Windows 2000 or Windows XP Professional computer running IIS 5 or later.
After installing the .NET Framework and SDK, create a root folder for your web application.
Installing a JSP application server
To run JSP pages, you need an application server that supports JavaServer Pages. Here are some popular choices:
•Macromedia JRun for Windows, Mac OS X, Linux, Solaris, or UNIX. You can download a trial version of JRun
from the Adobe website at www.adobe.com/go/jrun/.
•Tomcat for Windows and UNIX (including Mac OS X). You can download a copy of Tomcat from the Jakarta
Project website at http://tomcat.apache.org/. For more information on installing Tomcat on a Macintosh, see the
Apple website at http://developer.apple.com/internet/java/tomcat1.html.
After installing a JSP application server, create a root folder for your web application.
Creating a root folder for the application
After signing up with a web hosting company or setting up the server software yourself, create a root folder for your
web application on the computer running the web server. The root folder can be local or remote, depending on where
your web server is running.
ThewebservercanserveanyfileinthisfolderorinanyofitssubfoldersinresponsetoanHTTPrequestfromaweb
browser. For example, on a computer running ColdFusion MX 7, any file in the \CFusionMX7\wwwroot folder or
any of its subfolders can be served to a web browser.
The following are the default root folders of selected web servers:
September 4, 2007
DREAMWEAVER CS3
User Guide
507
Totestthewebserver,placeatestHTMLpageinthedefaultrootfolderandattempttoopenitbyenteringthepage’s
URL in a browser. The URL comprises the domain name and the filename of the HTML page, as follows:
www.example.com/testpage.htm.
If the web server is running on your local computer, you can use localhost instead of a domain name. Enter one
of the following localhost URLs to match your web server:
Note: By default the ColdFusion MX 7 web server runs on port 8500 and the Jakarta Tomcat web server runs on port
8080.
If the page doesn’t open as expected, check for the following errors:
•The web server is not started. Consult the web server’s documentation for starting instructions.
•The file does not have an .htm or .html extension.
•You entered the page’s file path (for example, c:\CFusionMX7\wwwroot\testpage.htm), not its URL (for example,
http://localhost:8500/testpage.htm), in the browser’s address text box.
•The URL contains a typing mistake. Check for errors and make sure the filename is not followed by a slash, such
as http://localhost:8080/testpage.htm/.
After creating a root folder for your application, define a Dreamweaver site to manage your files.
See also
“Installing a local web server” on page 498
“Setting up a Dreamweaver site” on page 40
About defining a Dreamweaver site
After configuring your system to develop web applications, define a Dreamweaver site to manage your files.
Web server Default root folder
ColdFusion MX 7 \CFusionMX7\wwwroot
IIS \Inetpub\wwwroot
Apache (Windows) \apache\htdocs
Apache (Macintosh) Users:MyUserName:Sites
Jakarta Tomcat (Windows) \jakarta-tomcat-4.x.x\webapps\ROOT\
Web server Localhost URL
ColdFusion MX 7 http://localhost:8500/testpage.htm
IIS http://localhost/testpage.htm
Apache (Windows) http://localhost:80/testpage.htm
Apache (Macintosh) http://localhost/~MyUserName/testpage.htm (where MyUserName is
your Macintosh user name)
Jakarta Tomcat (Windows) http://localhost:8080/testpage.htm
September 4, 2007
DREAMWEAVER CS3
User Guide
508
Before you start, make sure you meet the following requirements:
•You have access to a web server. The web server can be running on your local computer, on a remote computer
such as a development server, or on a server maintained by a web hosting company.
•An application server is installed and running on the system running your web server.
•You created a root folder for your web application on the system running your web server.
Defining a Dreamweaver site for your web application consists of three steps:
1. Define a local folder
The local folder is the folder you use to store working copies of site files on your hard disk. You can define a local
folder for each new web application you create. Defining a local folder also gives you the ability to manage your files
and to transfer files to and from your web server easily.
2. Define a remote folder
Define a folder located on the computer running your web server as a Dreamweaver remote folder. The remote folder
is the folder you created for your web application on the web server.
3. Define a testing folder
Dreamweaver uses this folder to generate and display dynamic content and connect to databases while you work.
The testing server can be your local computer, a development server, a staging server, or a production server. As long
as it can process the kind of dynamic pages you plan to develop, the choice doesn’t matter.
After the Dreamweaver site is defined, you can start building your web application.
See also
“Setting up a Dreamweaver site” on page 40
“Set up and edit a local root folder” on page 42
“Set up a remote folder” on page 43
“Set up a testing server” on page 48
Database connections for ColdFusion developers
Connecting to a ColdFusion database
When developing a ColdFusion web application in Dreamweaver, you connect to a database by selecting a
ColdFusion data source defined in Dreamweaver or in ColdFusion Administrator, the server’s management console.
Before connecting to a database, you must set up a ColdFusion web application. You must also set up a database on
your local computer or on a system to which you have network or FTP access.
Make sure that Dreamweaver knows where to find the ColdFusion data sources. To retrieve the ColdFusion data
sources at design time, Dreamweaver places scripts in a folder on the computer running ColdFusion. You must
specify this folder in the Testing Server category of the Site Definition dialog box.
Next, you must create a ColdFusion data source in Dreamweaver or in ColdFusion Administrator (if one doesn’t
already exist). After creating a ColdFusion data source, you can use it in Dreamweaver to connect to the database.
September 4, 2007
DREAMWEAVER CS3
User Guide
509
Create or modify a ColdFusion data source
Before you can use database information in your page, you must create a ColdFusion data source. If you’re running
ColdFusion MX 7 or later, you can create or modify the data source directly in Dreamweaver. If you’re running
ColdFusion MX, you must use the server’s management console, ColdFusion MX Administrator, to create or modify
the data source. You can still use Dreamweaver to open ColdFusion MX Administrator in that case.
See also
“Set up a testing server” on page 48
“Enable the ColdFusion enhancements” on page 674
Create or modify a ColdFusion data source if running ColdFusion MX 7 or later
1Make sure a computer running ColdFusion MX 7 or later is defined as a testing server for your site.
2Open any ColdFusion page in Dreamweaver.
3To create a new data source, click the Plus (+) button in the Databases panel (Windows > Databases) and enter
the parameter values specific to the database driver.
Note: Dreamweaver displays the Plus (+) button only if you’re running ColdFusion MX 7 or later.
4To modify a data source, double-click the database connection in the Databases panel and make your changes.
You can edit any parameter except the name of the data source. For more information, see the driver vendor’s
documentation or consult your system administrator.
Create or modify a ColdFusion data source if running ColdFusion MX 6.1 or 6.0
1Open any ColdFusion page in Dreamweaver.
2In the Databases panel (Window > Databases) in Dreamweaver, click Modify Data Sources in the panel toolbar.
3Log in to ColdFusion MX Administrator, and create or modify the data source.
For instructions, see ColdFusion help (Help > ColdFusion Help).
You must provide certain parameter values to create the ColdFusion data source. For the parameter values specific
to your database driver, see the driver vendor’s documentation or consult your system administrator.
After you create a ColdFusion data source, you can use it in Dreamweaver.
Connecting to the database in Dreamweaver
After creating a ColdFusion data source, use it to connect to the database in Dreamweaver.
Open any ColdFusion page in Dreamweaver, then open the Databases panel (Window > Databases). Your
ColdFusion data sources should appear in the panel.
Ifthedatasourcesdonotappear,completethechecklistinthepanel.MakesurethatDreamweaverknowswhereto
find the ColdFusion data sources. In the Testing Server category of the Site Definition dialog box, specify the site’s
root folder on the computer running ColdFusion.
See also
“Troubleshooting database connections” on page 525
September 4, 2007
DREAMWEAVER CS3
User Guide
510
Database connections for ASP developers
About ASP database connections
An ASP application must connect to a database through an open database connectivity (ODBC) driver or an object
linking and embedding database (OLE DB) provider. The driver or provider acts as an interpreter that lets the web
application communicate with the database. The following table shows some drivers you can use with Microsoft
Access, Microsoft SQL Server, and Oracle databases:
You can use a data source name (DSN) or a connection string to connect to the database. You must use a connection
string if you’re connecting through an OLE DB provider or an ODBC driver not installed on a Windows system.
A DSN is a one-word identifier, such as myConnection, that points to the database and contains all the information
needed to connect to it. You define a DSN in Windows. You can use a DSN if you’re connecting through an ODBC
driver installed on a Windows system.
A connection string is a hand-coded expression that identifies the database and lists the information needed to
connect to it, as shown in the following example:
Driver={SQL Server};Server=Socrates;Database=AcmeMktg;
UID=wiley;PWD=roadrunner
Note: You can also use a connection string if you’re connecting through an ODBC driver installed on a Windows system,
but using a DSN is easier.
See also
“Accessing a database” on page 494
About OLE DB connections
You can use an OLE DB provider to communicate with your database (OLE DB is available only on Windows NT,
2000, or XP). Creating a direct database-specific OLE DB connection can improve the speed of your connection by
eliminating the ODBC layer between your web application and the database.
If you don’t specify an OLE DB provider for your database, ASP uses the default OLE DB provider for ODBC drivers
to communicate with an ODBC driver, which in turn communicates with the database.
Different OLE DB providers exist for different databases. You can obtain OLE DB providers for Microsoft Access and
SQL Server by downloading and installing the Microsoft Data Access Components (MDAC) 2.5 and 2.7 packages
on the Windows computer running IIS. You can download the MDAC packages for free from the Microsoft website
at http://msdn.microsoft.com/data/mdac/downloads/.
Database Database driver
Microsoft Access Microsoft Access Driver (ODBC)
Microsoft Jet Provider for Access (OLE DB)
Microsoft SQL Server Microsoft SQL Server Driver (ODBC)
Microsoft SQL Server Provider (OLE DB)
Oracle Microsoft Oracle Driver (ODBC)
Oracle Provider for OLE DB
September 4, 2007
DREAMWEAVER CS3
User Guide
511
Note: Make sure you install MDAC 2.5 before installing MDAC 2.7.
You can download OLE DB providers for Oracle databases from the Oracle website at
www.oracle.com/technology/software/tech/windows/ole_db/index.html (registration is required).
In Dreamweaver, you create an OLE DB connection by including a Provider parameter in a connection string. For
example, here are parameters for common OLE DB providers for Access, SQL Server, and Oracle databases, respec-
tively:
Provider=Microsoft.Jet.OLEDB.4.0;...
Provider=SQLOLEDB;...
Provider=OraOLEDB;...
For the parameter value of your OLE DB provider, see your provider vendor’s documentation, or consult your system
administrator.
About connection strings
A connection string combines all the information your web application needs to connect to a database. Dreamweaver
inserts this string in your page’s server-side scripts for later processing by your application server.
A connection string for Microsoft Access and SQL Server databases consists of a combination of the following
parameters separated by semicolons:
Provider SpecifiestheOLEDBproviderforyourdatabase.Forexample,hereareparametersforcommonOLEDB
providers for Access, SQL Server, and Oracle databases, respectively:
Provider=Microsoft.Jet.OLEDB.4.0;...
Provider=SQLOLEDB;...
Provider=OraOLEDB;...
For the parameter value of your OLE DB provider, see your provider vendor’s documentation, or consult your system
administrator.
If you don’t include a Provider parameter, then the default OLE DB provider for ODBC is used and you must specify
an appropriate ODBC driver for your database.
Driver Specifies the ODBC driver to use if you don’t specify an OLE DB provider for your database.
Server Specifies the server hosting the SQL Server database if your web application runs on a different server.
Database The name of a SQL Server database.
DBQ The path to a file-based database such as one created in Microsoft Access. The path is the one on the server
hosting the database file.
UID Specifies the user name.
PWD Specifies the user password.
DSN The data source name, if you use one. Depending on how you define the DSN on your server, you can omit the
connection string’s other parameters. For example, DSN=Results can be a valid connection string if you define the
other parameters when you create the DSN.
Connectionstringsforotherkindsofdatabasesmaynotusetheparameterslistedabove,orwillhavedifferentnames
or uses for the parameters. For more information, see your database vendor’s documentation, or consult your system
administrator.
Here’s an example of a connection string that will create an ODBC connection to an Access database called
trees.mdb:
September 4, 2007
DREAMWEAVER CS3
User Guide
512
Driver={Microsoft Access Driver (*.mdb)};
DBQ=C:\Inetpub\wwwroot\Research\trees.mdb
Here’s an example of a connection string that will create an OLE DB connection to a SQL Server database called
Mothra located on a server called Gojira:
Provider=SQLOLEDB;Server=Gojira;Database=Mothra;UID=jsmith;
PWD=orlando8
Create a connection using a local DSN
Note: This section assumes you have set up an ASP application. It also assumes a database is set up on your local
computer or on a system to which you have network or FTP access.
You can use a data source name (DSN) to create an ODBC connection between your web application and your
database. A DSN is a name containing all the parameters needed to connect to a specific database using an ODBC
driver.
Because you can only specify an ODBC driver in a DSN, you must use a connection string if you want to use an OLE
DB provider.
You can use a locally defined DSN to create a database connection in Dreamweaver.
1Define a DSN on the Windows computer running Dreamweaver.
For instructions, see the following articles on the Microsoft website:
•If the computer runs Windows 2000, see Microsoft Knowledge Base Article 300596 at
http://support.microsoft.com/default.aspx?scid=kb;en-us;300596
•If the computer runs Windows XP, see Microsoft Knowledge Base Article 305599 at
http://support.microsoft.com/default.aspx?scid=kb;en-us;305599
2Open an ASP page in Dreamweaver, and then open the Databases panel (Window > Databases).
3Click the Plus (+) button on the panel and select Data Source Name (DSN) from the menu.
4Enter a name for the new connection, without spaces or special characters.
5Select the Using Local DSN option and choose the DSN you want to use from the Data Source Name (DSN) menu.
If you want to use a local DSN but haven’t defined one yet, click Define to open the Windows ODBC Data Source
Administrator.
6Complete the User Name and Password boxes.
7You can restrict the number of database items Dreamweaver retrieves at design time by clicking Advanced, and
entering a schema or catalog name.
Note: You cannot create a schema or catalog in Microsoft Access.
8Click Test to connect to the database, and then click OK. If the connection fails, double-check the connection
string or check the settings for the test folder Dreamweaver uses to process dynamic pages.
See also
“Restrict database information displayed in Dreamweaver” on page 540
“Setting up a web application” on page 501
“Troubleshooting database connections” on page 525
September 4, 2007
DREAMWEAVER CS3
User Guide
513
Create a connection using a remote DSN
Note: This section assumes you have set up an ASP application. It also assumes a database is set up on your local
computer or on a system to which you have network or FTP access.
Note: Dreamweaver can retrieve only server DSNs created with the Windows ODBC Data Source Administrator.
You can use a DSN defined on a remote computer to create a database connection in Dreamweaver. If you want to use
a remote DSN, the DSN must be defined on the Windows computer running your application server (probably IIS).
Note: Because you can only specify an ODBC driver in a DSN, you must use a connection string if you want to use an
OLE DB provider.
1Define a DSN on the remote system running your application server.
For instructions, see the following articles on the Microsoft website:
•If the remote computer runs Windows 2000, see Microsoft Knowledge Base Article 300596 at
http://support.microsoft.com/default.aspx?scid=kb;en-us;300596
•If the remote computer runs Windows XP, see Microsoft Knowledge Base Article 305599 at
http://support.microsoft.com/default.aspx?scid=kb;en-us;305599
2Open an ASP page in Dreamweaver, then open the Databases panel (Window > Databases).
3Click the Plus (+) button on the panel and select Data Source Name (DSN) from the menu.
4Enter a name for the new connection, without spaces or special characters.
5Select Using DSN On Testing Server.
Note: Macintosh users can ignore this step because all database connections use DSNs on the application server.
6Enter the DSN or click the DSN button to connect to the server and select the DSN for the database you want,
then complete the options.
7Complete the User Name and Password boxes.
8You can restrict the number of database items Dreamweaver retrieves at design time by clicking Advanced and
entering a schema or catalog name.
Note: You cannot create a schema or catalog in Microsoft Access.
9Click Test to connect to the database, and then click OK. If the connection fails, double-check the connection
string or check the settings for the testing folder Dreamweaver uses to process dynamic pages.
See also
“Setting up a web application” on page 501
“Restrict database information displayed in Dreamweaver” on page 540
“Troubleshooting database connections” on page 525
Create a connection using a connection string
You can use a DSN-less connection to create an ODBC or OLE DB connection between your web application and
your database. You use a connection string to create this kind of connection.
1Open an ASP page in Dreamweaver, and then open the Databases panel (Window > Databases).
September 4, 2007
DREAMWEAVER CS3
User Guide
514
2Click the Plus (+) button on the panel, select Custom Connection String from the menu, complete the options,
and click OK.
3Enter a name for the new connection without spaces or special characters.
4Enter a connection string to the database. If you do not specify an OLE DB provider in the connection string—
that is, if you don’t include a Provider parameter—ASP will automatically use the OLE DB provider for ODBC
drivers. In that case, you must specify an appropriate ODBC driver for your database.
If your site is hosted by an ISP and you don’t know the full path to your database, use the MapPath method of the
ASP server object in your connection string.
5If the database driver specified in the connection string is not installed on the same computer as Dreamweaver,
select Using Driver On Testing Server.
Note: Macintosh users can ignore this step because all database connections use the application server.
6You can restrict the number of database items Dreamweaver retrieves at design time by clicking Advanced and
entering a schema or catalog name.
Note: You cannot create a schema or catalog in Microsoft Access.
7Click Test to connect to the database, and then click OK. If the connection fails, double-check the connection
string or check the settings for the testing folder Dreamweaver uses to process dynamic pages.
See also
“Connecting to a ColdFusion database” on page 508
“Restrict database information displayed in Dreamweaver” on page 540
“Troubleshooting database connections” on page 525
Connecting to a database on an ISP
If you’re an ASP developer working with a commercial Internet service provider (ISP), you often don’t know the
physical path of the files you upload, including your database file or files.
If your ISP doesn’t define a DSN for you or is slow to do so, you must find another way to create the connections to
your database files. One alternative is to create a DSN-less connection to a database file, but you can define such a
connection only if you know the physical path of the database file on the ISP server.
You can obtain the physical path of a database file on a server by using the MapPath method of the ASP server object.
Note: The techniques discussed in this section apply only if your database is file-based, such as a Microsoft Access
database where data is stored in an .mdb file.
Understanding physical and virtual paths
After using Dreamweaver to upload your files to a remote server, the files reside in a folder in the server’s local
directory tree. For example, on a server running Microsoft IIS, the path to your home page could be as follows:
c:\Inetpub\wwwroot\accounts\users\jsmith\index.htm
This path is known as the physical path to your file.
The URL to open your file, however, does not use the physical path. It uses the name of the server or domain followed
by a virtual path, as in the following example:
www.plutoserve.com/jsmith/index.htm
September 4, 2007
DREAMWEAVER CS3
User Guide
515
The virtual path, /jsmith/index.htm, stands in for the physical path,
c:\Inetpub\wwwroot\accounts\users\jsmith\index.htm.
Find a file’s physical path with the virtual path
If you work with an ISP, you don’t always know the physical path to the files you upload. ISPs typically provide you
with an FTP host, possibly a host directory, and a login name and password. ISPs also specify a URL to view your
pages on the Internet, such as www.plutoserve.com/jsmith/.
If you know the URL, then you can get the file’s virtual path—it’s the path that follows the server or domain name in
a URL. Once you know the virtual path, you can get the file’s physical path on the server using the MapPath method.
The MapPath methodtakesthevirtualpathasanargumentandreturnsthefile’sphysicalpathandfilename.Here’s
the method’s syntax:
Server.MapPath("/virtualpath")
If a file’s virtual path is /jsmith/index.htm, then the following expression returns its physical path:
Server.MapPath("/jsmith/index.htm")
You can experiment with the MapPath method as follows.
1Open an ASP page in Dreamweaver and switch to Code view (View > Code).
2Enter the following expression in the page’s HTML code.
<%Response.Write(stringvariable)%>
3Use the MapPath method to obtain a value for the stringvariable argument.
Here’s an example:
<% Response.Write(Server.MapPath("/jsmith/index.htm")) %>
4Switch to Design view (View > Design) and enable Live Data (View > Live Data) to view the page.
The page displays the physical path of the file on the application server, for example:
c:\Inetpub\wwwroot\accounts\users\jsmith\index.htm
For more information on the MapPath method, consult the online documentation that comes with Microsoft IIS.
Use a virtual path to connect to a database
TowriteaDSN-lessconnectionstringtoadatabasefilelocatedonaremoteserver,youmustknowthephysicalpath
to the file. The following example is a typical DSN-less connection string for a Microsoft Access database:
Driver={Microsoft Access Driver (*.mdb)};
DBQ=c:\Inetpub\wwwroot\accounts\users\jsmith\data\statistics.mdb
If you don’t know the physical path of your files on the remote server, you can get the path by using the MapPath
method in your connection string.
1Upload the database file to the remote server and make a note of its virtual path—for example,
/jsmith/data/statistics.mdb.
2Open an ASP page in Dreamweaver, then open the Databases panel (Window > Databases).
3Click the Plus (+) button on the panel and select Custom Connection String from the menu.
4Enter a name for the new connection, without spaces or special characters.
5Enter the connection string and use the MapPath method to supply the DBQ parameter.
September 4, 2007
DREAMWEAVER CS3
User Guide
516
Suppose that the virtual path to your Microsoft Access database is /jsmith/data/statistics.mdb; the connection string
can be expressed as follows if you use VBScript as your scripting language:
“Driver={Microsoft Access Driver (*.mdb)};DBQ=” & Server.MapPath¬
("/jsmith/data/statistics.mdb")
The ampersand (&) is used to concatenate (combine) two strings. The first string is enclosed in quotation marks and
thesecondisreturnedbytheServer.MapPath expression. When the two strings are combined, the following string
is created:
Driver={Microsoft Access Driver (*.mdb)};
DBQ=C:\Inetpub\wwwroot\accounts\users\jsmith\data\statistics.mdb
If you use JavaScript, the expression is identical except that you use a Plus (+) sign instead of an ampersand (&) to
concatenate the two strings:
“Driver={Microsoft Access Driver (*.mdb)};DBQ=” + Server.MapPath¬
("/jsmith/data/statistics.mdb")
6Select Using Driver On Testing Server, click Test, and then click OK.
Note: Macintosh users can ignore this step because all database connections use the application server.
Note: If the connection fails, double-check the connection string or contact your ISP to make sure that the database driver
youspecifiedintheconnectionstringisinstalledontheremoteserver.AlsocheckthattheISPhasthemostrecentversion
of the driver. For example, a database created in Microsoft Access 2000 will not work with Microsoft Access Driver 3.5.
You need Microsoft Access Driver 4.0 or later.
7Update the database connection of existing dynamic pages (open the page in Dreamweaver, double-click the
recordset name in the Bindings panel or Server Behaviors panel, and select the connection you just created from the
Connection menu) and use the new connection with any new page you build.
Edit or delete a database connection
When you create a database connection, Dreamweaver stores the connection information in an include file in the
Connections subfolder in the site’s local root folder. You can edit or delete the connection information in the file
manually or as follows.
Edit a connection
1Open an ASP page in Dreamweaver and then open the Databases panel (Window > Databases).
2Right-click (Windows) or Control-click (Macintosh) the connection and select Edit Connection from the menu.
3Edit the connection information and click OK.
Dreamweaver updates the include file, which updates all the pages in the site that use the connection.
Delete a connection
1Open an ASP page in Dreamweaver and then open the Databases panel (Window > Databases).
2Right-click (Windows) or Control-click (Macintosh) the connection and select Delete Connection from the
menu.
3In the dialog box that appears, confirm that you want to delete the connection.
Note: To avoid receiving errors after deleting a connection, update every recordset that uses the old connection by double-
clicking the name of the recordset in the Bindings panel and choosing a new connection.
September 4, 2007
DREAMWEAVER CS3
User Guide
517
Database connections for PHP developers
About PHP database connections
For PHP development, Dreamweaver only supports the MySQL database system. Other database systems such as
Microsoft Access or Oracle are not supported. MySQL is open-source software you can download for free from the
Internet for non-commercial use. For more information, see the MySQL website at
http://dev.mysql.com/downloads/.
This section assumes you have set up a PHP application. It also assumes a MySQL database is set up on your local
computer or on a system to which you have network or FTP access.
For development purposes, download and install the Windows Essentials version of the MySQL database server.
See also
“Setting up a web application” on page 501
Connect to a database
To connect to a database when developing a PHP application in Dreamweaver, you must have one or more MySQL
databases and the MySQL server must be started.
1Open a PHP page in Dreamweaver, and then open the Databases panel (Window > Databases).
2Click the Plus (+) button on the panel, select MySQL Connection from the menu, and complete the dialog box.
•Enter a name for the new connection, without spaces or special characters.
•In the MySQL Server box, enter an IP address or a server name for the computer hosting MySQL. If MySQL is
running on the same computer as PHP, you can enter localhost.
•Enter your MySQL user name and password.
•IntheDatabasebox,enterthenameofthedatabase,orclickSelectandselectthedatabasefromthelistofMySQL
databases, and click Test.
Dreamweaver attempts to connect to the database. If the connection fails, double-check the server name, user name,
and password. If the connection still fails, check the settings for the testing folder Dreamweaver uses to process
dynamic pages.
Dreamweaver makes a best guess at auto-populating the value for the URL prefix in the Testing Server category of
the Site Definition dialog box, but sometimes you will have to adjust the URL prefix to get your connection to work.
Make sure that the URL prefix is the URL that users type in their browsers to open the web application, minus the
file name (or start page) of the application.
3Click OK.
Note: If you encounter the error message “Client does not support authentication protocol requested. Consider upgrading
MySQL client” when testing a PHP database connection to MySQL 4.1, see “Troubleshooting MySQL error messages” on
page 530.
September 4, 2007
DREAMWEAVER CS3
User Guide
518
Edit or delete a database connection
When you create a database connection, Dreamweaver stores the connection information in an include file in the
Connections subfolder in the site’s local root folder. You can edit or delete the connection information in the file
manually or as follows.
Edit a connection
1Open a PHP page in Dreamweaver, and then open the Databases panel (Window > Databases).
2Right-click (Windows) or Control-click (Macintosh) the connection and select Edit Connection from the menu.
3Edit the connection information and click OK.
Dreamweaver updates the include file, which updates all the pages in the site that use the connection.
Delete a connection
1Open a PHP page in Dreamweaver, and then open the Databases panel (Window > Databases).
2Right-click (Windows) or Control-click (Macintosh) the connection and select Delete Connection from the
menu.
3In the dialog box that appears, confirm that you want to delete the connection.
Note: To avoid getting errors after deleting a connection, update every recordset that uses the old connection by double-
clicking the name of the recordset in the Bindings panel and selecting a new connection in the Recordset dialog box.
Database connections for ASP.NET developers
Connecting to an ASP.NET database
Beforeyoucanconnecttoadatabase,youmustobtainanOLE DB provider for your database. If you want to connect
to a Microsoft SQL Server database, you can use the Managed Data Provider for SQL Server that is supplied by the
.NET Framework Software Development Kit (SDK).
Before connecting to the database, you must set up an ASP.NET application. Also, the database must be set up either
on your local computer or on a system to which you have network or FTP access.
After the database provider is installed, you can use it to connect to the database.
Obtaining an OLE DB provider for your database
An ASP.NET application must connect to a database through an OLE DB provider. The provider acts as an inter-
preter that lets an ASP.NET application communicate with a database.
IfyouwanttoconnecttoaMicrosoftSQLServerdatabase,youcanusetheManagedDataProviderforSQLServer
that comes with the .NET Framework 1.1 SDK. This provider, which is optimized for SQL Server and is very fast, is
installed when you install the SDK.
If you want to connect to a database other than SQL Server, make sure an OLE DB provider for your database is
installed on the computer running the .NET Framework. You can obtain an OLE DB provider for Microsoft Access
by downloading and installing the Microsoft Data Access Components (MDAC) 2.7 package from the Microsoft
website at http://msdn.microsoft.com/data/mdac/downloads/.
September 4, 2007
DREAMWEAVER CS3
User Guide
519
You can download OLE DB providers for Oracle databases from the Oracle website at
www.oracle.com/technology/software/tech/windows/ole_db/index.html. You can also purchase OLE DB providers
from third-party vendors.
See also
“Accessing a database” on page 494
Create an ASP.NET database connection in Dreamweaver
After obtaining an OLE DB provider for your database, use it to create a database connection in Dreamweaver.
Another option is to use the Microsoft Data Link Properties dialog box to help you create the connection.
1Open an ASP.NET page in Dreamweaver, and then open the Databases panel (Window > Databases).
2Click the Plus (+) button on the panel, and select OLE DB Connection or SQL Server Connection from the menu.
Note: Select SQL Server Connection only if you want to connect to a Microsoft SQL Server database.
3Enter a name for the new connection, without spaces or special characters, and enter the connection string.
Note: IfyouneedhelpwithanOLEDBconnectionstring,clickTemplatestoopentheConnectionStringTemplatedialog
box, select your OLE DB provider, and click OK.
4Replace the placeholders in the string with the requested information, click Test, and then click OK.
See also
“Sample OLE DB connection parameters for ASP.NET” on page 520
“Troubleshooting database connections” on page 525
Create a connection using data link properties
AfterobtaininganOLEDBproviderforyourdatabase,youcancreateadatabaseconnectionbyusingtheDataLink
Properties dialog box in Windows. You can use this method only if the OLE DB provider you want to use is installed
on the same Windows computer as Dreamweaver.
1Open an ASP.NET page in Dreamweaver and then open the Databases panel (Window > Databases). The panel
displays the connections defined for the site.
2Click the Plus (+) button on the panel and select OLE DB Connection from the menu.
3In the OLE DB Connection dialog box, Click Build. The OLE DB providers currently on the Windows computer
running Dreamweaver are displayed.
4Complete the Data Link Properties dialog box and click OK to insert a connection string.
5Click Test to connect to the database, and then click OK. If the connection fails, double-check the connection
string or check the settings for the testing folder Dreamweaver uses to process dynamic pages.
See also
“Set up a testing server” on page 48
“Troubleshooting database connections” on page 525
September 4, 2007
DREAMWEAVER CS3
User Guide
520
Sample OLE DB connection parameters for ASP.NET
An OLE DB connection string combines all the information your ASP.NET application needs to connect to a
database. Dreamweaver inserts this string in your page’s server-side scripts for later processing by your application
server.
Dreamweaver provides you with string templates to create OLE DB connection strings for ASP.NET applications. To
create a connection string, you replace placeholders in the template with the requested parameter values. The
following are sample parameters for Microsoft Access and SQL Server databases.
Note: For the parameter values specific to other databases, see the database vendor’s documentation or consult your
system administrator.
Case 1: You have the .NET Framework on your local computer and you want to connect to a Microsoft Access
database called sdSchool.mdb located in the following folder on your hard disk: c:\Inetpub\wwwroot\SkyDive-
School\data\sdSchool.mdb. Here are the parameters to create this connection string:
Provider=Microsoft.Jet.OLEDB.4.0;
Data Source=c:\Inetpub\wwwroot\SkyDiveSchool\data\sdSchool.mdb;
Case 2: You use the .NET Framework on a remote development server and you want to connect to a Microsoft
Access database called mtnSchool.mdb located on the server in the following folder:
d:\users\tara\projects\MtnDrivingSchool\data\mtnSchool.mdb. Here are the parameters to create the connection
string:
Provider=Microsoft.Jet.OLEDB.4.0;
Data Source=d:\users\tara\projects\MtnDrivingSchool\data\mtnSchool.mdb;
Case 3: You use the .NET Framework on a networked development server called Savant and you want to connect to
a Microsoft SQL Server database called pubs on the server. Your SQL Server user name is “sa” and there is no
password. If you use the Managed Data Provider for SQL Server (that is, if you chose SQL Connection in the
Databases panel), here are the parameters to create the connection string:
Data Source=Savant;
Initial Catalog=pubs;
User ID=sa;
Password=;
Edit or delete a database connection
When you create a database connection, Dreamweaver stores the connection information in an include file in the
Connections subfolder in the site’s local root folder. You can edit or delete the connection information in the file
manually or as follows.
If you rename a connection, update every data set (record set) that uses the old connection name by double-clicking
the recordset in the Bindings panel and selecting the new connection name in the DataSet dialog box.
Edit a connection
1Open an ASP.NET page in Dreamweaver, then open the Databases panel (Window > Databases).
2Right-click (Windows) or Control-click (Macintosh) the connection, and select Edit Connection from the menu.
3MakethechangesandclickOK.Dreamweaverupdatestheincludefile,whichupdatesallthepagesinthesitethat
use the connection.
Delete a connection
1Open an ASP.NET page in Dreamweaver, and then open the Databases panel (Window > Databases).
September 4, 2007
DREAMWEAVER CS3
User Guide
521
2Right-click (Windows) or Control-click (Macintosh) the connection, and select Delete Connection from the
menu.
3In the dialog box that appears, confirm that you want to delete the connection.
Database connections for JSP developers
About JSP database connections
A JSP application must connect to a database through a JDBC driver. After you install the database driver, you can
connect to the database through it.You must specify certain parameter values to connect through your JDBC driver.
For the parameter values specific to your driver, see the driver vendor’s documentation or consult your system
administrator.
You can also use an ODBC driver (and a Windows DSN) if you have a JDBC-ODBC Bridge driver.
Note: The JSP application server must be running on a local or remote computer. You must also have a database set up
on your local computer or on a system to which you have network or FTP access.
See also
“Setting up a web application” on page 501
“Accessing a database” on page 494
JDBC connection parameters
When you create a JSP database connection in Dreamweaver, you usually need to enter JDBC connection param-
eters. JDBC connections usually consist of four parameters: the driver, user name, password, and URL (which
specifies the location of the database). Generally, the values of the driver parameter and the URL parameter depend
on the driver type.
This example shows how to define connection parameters in Dreamweaver using the Oracle Thin JDBC driver as an
example. For the connection parameters of other drivers, consult the driver vendor’s documentation.
The Oracle Thin JDBC driver supports Oracle databases. If you want to use this driver to connect to your Oracle
database, click the Plus (+) button on the Databases panel and select the Oracle Thin Driver (Oracle) driver from the
pop-up menu. The Oracle Thin Driver dialog box appears.
Enter a connection name and replace the placeholders (in square brackets) with valid connection parameters. For
the [hostname] placeholder, enter the IP address or the name assigned to the database server by the system admin-
istrator. For the [sid] placeholder, enter the database system identifier. If you have more than one Oracle database
running on the same system, you use the SID to tell them apart.
September 4, 2007
DREAMWEAVER CS3
User Guide
522
For instance, if your server is called Aristotle, the database port is 1521, and you defined a database SID called
patients on that server, you would enter the following parameter values in Dreamweaver:
Obtaining a JDBC driver for your database
MakesureyouhaveaJDBCdriverforyourdatabasebeforeyoutrytocreateadatabaseconnection.Somecommon
JDBCdriversincludetheOracleThinJDBCdriver,theOracleJavaDriver,andthei-netJDBCdriversforMicrosoft
SQL Server.
Database system vendors such as Oracle often include drivers with their systems. You can also purchase drivers from
third-party vendors. For example, you can obtain a JDBC driver for Microsoft SQL Server from i-net software at
www.inetsoftware.de/products/jdbc/.
Sun also provides a searchable database of JDBC drivers and their vendors on its website at http://devel-
opers.sun.com/product/jdbc/drivers.
See also
“Installing the Sun JDBC-ODBC Bridge driver” on page 523
Create a JSP database connection
After installing an appropriate JDBC driver for your database on the computer running your application server, you
can create a database connection in Dreamweaver.
1Open a JSP page in Dreamweaver, then open the Databases panel (Window > Databases).
2Click the Plus (+) button and select your driver from the menu. (If your driver is not listed, select Custom JDBC
Connection.)
3Enter the connection parameters in the dialog box.
4Specify the location of the JDBC driver you want to use.
•If your JDBC driver is installed on the same computer as Dreamweaver, select Using Driver On This Machine.
•If your JDBC driver is not installed on the same computer as Dreamweaver, select Using Driver On Testing Server.
Note: Macintosh users can ignore this step because all database connections use the application server.
5If you want, restrict the number of database items Dreamweaver retrieves at design time by clicking Advanced and
entering a schema or catalog name.
Note: You cannot create a schema or catalog in Microsoft Access.
6Click Test, and then click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
523
Dreamweaver attempts to connect to the database. If the connection fails, double-check the connection parameters.
If the connection still fails, check the settings for the testing folder Dreamweaver uses to process dynamic pages.
See also
“Restrict database information displayed in Dreamweaver” on page 540
“Obtaining a JDBC driver for your database” on page 522
“JDBC connection parameters” on page 521
“Troubleshooting database connections” on page 525
Connecting through an ODBC driver
Although JSP applications must communicate with databases through JDBC drivers, they can communicate through
ODBC drivers if you have a JDBC-ODBC bridge driver. The bridge driver acts as an interpreter between your JSP
application, which “speaks” JDBC, and your ODBC driver, which “speaks” ODBC. This channel of communication
lets your JSP application communicate with the database.
This kind of connection offers two advantages for Windows users. First, you can use the free ODBC drivers from
Microsoft. Second, you can use a DSN to simplify the task of creating the connection.
The following requirements must be met to connect through an ODBC driver:
•Your JSP application server must be running on a Windows computer.
•An ODBC driver for your database must be installed on the Windows computer running the application server.
•A JDBC-ODBC bridge driver must be installed on the Windows computer running the application server.
If you meet these requirements, you can connect through an ODBC driver.
Checking for the ODBC driver
Make sure an ODBC driver for your database is installed on the Windows computer running the JSP application
server. If an appropriate driver is not installed, you can download and install the Microsoft Data Access Components
(MDAC) 2.5 and 2.7 packages on the computer running the JSP application server. You can download MDAC for
free from the Microsoft website at http://msdn.microsoft.com/data/mdac/downloads/. These packages contain the
latest ODBC drivers from Microsoft.
Note: Install the MDAC 2.5 package before installing MDAC 2.7.
Installing the Sun JDBC-ODBC Bridge driver
To connect through an ODBC driver, you must install the Sun JDBC-ODBC Bridge driver on the Windows
computer running the JSP application server. The driver comes with the Sun Java 2 SDK, Standard Edition, for
Windows.
TofindoutifyoualreadyhavetheJava2SDKwiththedriver,checkyourharddiskforanyofthefollowingfolders:
jdk1.2, jdk1.3, or j2sdk1.4.
Ifyoudon’thavetheSDK,youcandownloadandinstallitfromtheSunwebsiteathttp://java.sun.com/j2se/,which
also installs the driver.
September 4, 2007
DREAMWEAVER CS3
User Guide
524
Although it is adequate for development use with lower-end database systems such as Microsoft Access, the Sun
JDBC-ODBC Bridge driver is not intended for production use. For example, it lets only one JSP page connect to the
database at a time (it does not support concurrent use by multiple threads). For more information on the driver’s
limitations, see TechNote 17392 on the Adobe support center at www.adobe.com/go/17392.
After you install the bridge driver, you can create the database connection.
Create an ODBC connection
Before connecting through an ODBC driver, make sure the appropriate ODBC driver and the Sun JDBC-ODBC
Bridge driver are installed on the Windows computer running the JSP application server.
1Define a DSN on the Windows system hosting your application server.
For instructions, see the following articles on the Microsoft website:
•Windows 2000 users, see Microsoft Knowledge Base Article 300596 at
http://support.microsoft.com/default.aspx?scid=kb;en-us;300596
•Windows XP users, see Microsoft Knowledge Base Article 305599 at
http://support.microsoft.com/default.aspx?scid=kb;en-us;305599
2Open a JSP page in Dreamweaver, and then open the Databases panel (Window > Databases).
3Click the Plus (+) button on the panel, and select Sun JDBC-ODBC Driver (ODBC Database) from the menu.
4Enter a name for the new connection, without spaces or special characters.
5Replace the [odbc dsn] placeholder in the URL box with the DSN you defined in step 1. The URL box should
look like this:
jdbc:odbc:myDSN
6Specify the user name and password to access the database.
If you don’t need a user name or password, leave the boxes blank. For example, if your DSN is called Acme and you
don’t need a user name or password to access the database, enter the following parameter values:
Driver: sun.jdbc.odbc.JdbcOdbcDriver
URL: jdbc:odbc:Acme
7Specify the location of the JDBC-ODBC Bridge driver.
•If the driver is installed on the same computer as Dreamweaver, select Using Driver On This Machine.
•If the driver is not installed on the same computer as Dreamweaver, select Using Driver On Testing Server.
Note: Macintosh users can ignore this step because all database connections use the application server.
8Click Test, and then click OK.
Dreamweaver attempts to connect to the database. If the connection fails, double-check the DSN and the other
connection parameters. If the connection still fails, check the settings for the testing folder Dreamweaver uses to
process dynamic pages.
See also
“Set up a testing server” on page 48
“Troubleshooting database connections” on page 525
September 4, 2007
DREAMWEAVER CS3
User Guide
525
Edit or delete a database connection
When you create a database connection, Dreamweaver stores the connection information in an include file in the
Connections subfolder in the site’s local root folder. You can edit or delete the connection information in the file
manually or as follows.
Edit a connection
1Open a JSP page in Dreamweaver, and then open the Databases panel (Window > Databases).
2Right-click (Windows) or Control-click (Macintosh) the connection and select Edit Connection from the menu.
3Edit the connection formation and click OK.
Dreamweaver updates the include file, which updates all of the pages in the site that use the connection.
If you rename a connection, update every recordset that uses the old connection name by double-clicking the
recordset in the Bindings panel and choosing the new connection name in the Recordset dialog box.
Delete a connection
1Open a JSP page in Dreamweaver, then open the Databases panel (Window > Databases).
2Right-click (Windows) or Control-click (Macintosh) the connection, and select Delete Connection from the
menu.
3In the dialog box that appears, confirm that you want to delete the connection.
Note: To avoid getting errors after deleting a connection, update every recordset that uses the old connection by double-
clicking the name of the recordset in the Bindings panel and choosing a new connection in the Recordset dialog box.
Troubleshooting database connections
Troubleshooting permissions problems
One of the most common problems is insufficient folder or file permissions. If your database is located on a Windows
2000 or Windows XP computer and you receive an error message when you try to view a dynamic page in a web
browser or in Live Data mode, the error might be due to a permissions problem.
The Windows account attempting to access the database doesn’t have sufficient permissions. The account might be
either the anonymous Windows account (by default, IUSR_computername) or a specific user account, if the page has
been secured for authenticated access.
You must change the permissions to give the IUSR_computername accountthecorrectpermissionssothewebserver
can access the database file. In addition, the folder containing the database file must also have certain permissions
set to write to that database.
Ifthepageismeanttobeaccessedanonymously,givetheIUSR_computername account full control to the folder and
database file, as described in the procedure below.
Additionally, if the path to the database is being referenced using UNC (\\Server\Share), make sure the Share Permis-
sions give the IUSR_computername account full access. This step applies even if the share is on the local web server.
If you copy the database from another location, it may not inherit the permissions from its destination folder and
you may have to change the permissions for the database.
September 4, 2007
DREAMWEAVER CS3
User Guide
526
Check or change the database file permissions (Windows XP)
1Make sure that you have administrator privileges on the computer.
2In Windows Explorer, locate the database file or the folder containing the database, right-click the file or folder,
and select Properties.
3Select the Security tab.
Note: This step applies only if you have an NTFS file system. If you have an FAT file system, the dialog box won't have
a Security tab.
4If the IUSR_computername account is not listed in the Group or User Names list, click the Add button to add it.
5In the Select Users or Groups dialog box, click Advanced.
The dialog box changes to show more options.
6Click Locations and select the computer’s name.
7Click Find Now to display a list of account names associated with the computer.
8Select the IUSR_computername account and click OK; then click OK again to clear the dialog box.
9To assign the IUSR account full permissions, select Full Control and click OK.
Check or change the database file permissions (Windows 2000)
1Make sure that you have administrator privileges on the computer.
2In Windows Explorer, locate the database file or the folder containing the database, right-click the file or folder,
and select Properties.
3Select the Security tab.
Note: This step applies only if you have an NTFS file system. If you have an FAT file system, the dialog box won't have
a Security tab.
4If the IUSR_computername account is not listed among the Windows accounts in the File Permissions dialog box,
click the Add button to add it.
5In the Select Users, Computers, or Groups dialog box, select the computer name from the Look In menu to display
a list of account names associated with the computer.
6Select the IUSR_computername account and click Add.
7To assign the IUSR account full permissions, select Full Control from the Type Of Access menu and click OK.
For added security, permissions can be set so that Read permission is disabled for the web folder containing the
database. Browsing the folder won’t be permitted, but web pages will still be able to access the database.
For more information about the IUSR account and web server permissions, see the following TechNotes on the
Adobe Support Center:
•Understanding anonymous authentication and the IUSR account at www.adobe.com/go/authentication
•Setting IIS web server permissions at www.adobe.com/go/server_permissions
Troubleshooting Microsoft error messages
These Microsoft error messages can occur when you request a dynamic page from the server if you use Internet
Information Server (IIS) with a Microsoft database system such as Access or SQL Server.
September 4, 2007
DREAMWEAVER CS3
User Guide
527
Note: Adobe does not provide technical support for third-party software such as Microsoft Windows, and IIS. If this
information does not fix your problem, please contact Microsoft technical support or visit the Microsoft support website
at http://support.microsoft.com/.
For more information on 80004005 errors, see “INFO: Troubleshooting Guide for 80004005 Errors in Active Server
Pages and Microsoft Data Access Components (Q306518),” on the Microsoft website at
http://support.microsoft.com/default.aspx?scid=kb;en-us;Q306518.
[Reference]80004005—Data source name not found and no default driver specified
This error occurs when you attempt to view a dynamic page in a web browser or in Live Data mode. The error
message may vary depending on your database and web server. Other variations of the error message include:
•80004005—Driver's SQLSetConnectAttr failed
•80004005—General error unable to open registry key 'DriverId'
Here are possible causes and solutions:
•Thepagecan’tfindtheDSN.MakesureaDSNhasbeencreatedonboththewebserverandonthelocalmachine.
•The DSN might have been set up as a user DSN, not as a system DSN. Delete the user DSN and create a system
DSN to replace it.
Note: If you don’t delete the user DSN, the duplicate DSN names produce a new ODBC error.
If you use Microsoft Access, the database file (.mdb) might be locked. The lock might be due to a DSN with a
different name accessing the database. In Windows Explorer, search for the lock file (.ldb) in the folder containing
thedatabasefile(.mdb)anddeletethe.ldbfile.IfanotherDSNispointingtothesamedatabasefile,deletetheDSN
to prevent the error in the future. Reboot the computer after making any changes.
[Reference]80004005—Couldn’t use ‘(unknown)’; file already in use
This error occurs when you use a Microsoft Access database and attempt to view a dynamic page in a web browser
or in Live Data mode. Another variation of this error message is “80004005—Microsoft Jet database engine cannot
open the file (unknown).”
The probable cause is a permissions problem. Here are some specific causes and solutions:
•The account being used by Internet Information Server (usually IUSR) might not have the correct Windows
permissions for a file-based database or for the folder containing the file. Check the permissions on the IIS account
(IUSR) in the user manager.
•You might not have permission to create or destroy temporary files. Check the permissions on the file and the
folder. Make sure that you have permission to create or destroy any temporary files. Temporary files are usually
created in the same folder as the database, but the file may also be created in other folders such as /Winnt.
•In Windows 2000, the time-out value may need to be changed for the Access database DSN. To change the time-
out value, select Start > Settings > Control Panel > Administrative Tools > Data Sources (ODBC). Click the
System tab, highlight the correct DSN, and click the Configure button. Click the Options button and change the
Page Timeout value to 5000.
If you still have problems, see the following Microsoft Knowledge Base articles:
•PRB: 80004005 “Couldn't Use ‘(unknown)’; File Already in Use” at
http://support.microsoft.com/default.aspx?scid=kb;en-us;Q174943.
•PRB: Microsoft Access Database Connectivity Fails in Active Server Pages at
http://support.microsoft.com/default.aspx?scid=kb;en-us;Q253604.
September 4, 2007
DREAMWEAVER CS3
User Guide
528
•PRB: Error “Cannot Open File Unknown” Using Access at http://support.microsoft.com/default.aspx?scid=kb;en-
us;Q166029.
[Reference]80004005—Logon Failed()
This error occurs when you use Microsoft SQL Server and attempt to view a dynamic page in a web browser or in
Live Data mode.
ThiserrorisgeneratedbySQLServerifitdoesn’tacceptorrecognizethelogonaccountorpasswordbeingsubmitted
(if you’re using standard security), or if a Windows account does not map to a SQL account (if you’re using integrated
security).
Here are possible solutions:
•Ifyouusestandardsecurity,theaccountnameandpasswordmightbeincorrect.TrythesystemAdminaccount
and password (UID= “sa” and no password), which must be defined in the connection string line. (DSNs do not
store user names and passwords.)
•If you use integrated security, check the Windows account calling the page and find its mapped SQL account (if any).
•SQL Server does not allow an underscore in SQL account names. If someone manually maps the Windows
IUSR_machinename account to a SQL account of the same name, it will fail. Map any account that uses an under-
score to an account name on SQL that does not use an underscore.
[Reference]80004005—Operation must use an updateable query
This error occurs when an event is updating a recordset or inserting data in a recordset.
Here are possible causes and solutions:
•The permissions set on the folder containing the database are too restrictive. IUSR privileges must be set to
read/write.
•The permissions on the database file itself does not have full read/write privileges in effect.
•The database might be located outside the Inetpub/wwwroot directory. Though you can view and search the data,
you might not be able to update it unless the database is located in the wwwroot directory.
•The recordset is based on a non-updateable query. Joins are good examples of non-updateable queries within a
database. Restructure your queries so they are updateable.
For more information on this error, see “PRB: ASP ‘Error The Query Is Not Updateable’ When You Update Table
Record,” in the Microsoft Knowledge Base at http://support.microsoft.com/default.aspx?scid=kb;en-us;Q174640.
[Reference]80040e07—Data type mismatch in criteria expression
This error occurs when the server tries to process a page containing an Insert Record or Update Record server
behavior, and the server behavior attempts to set the value of a Date/Time column in a Microsoft Access database to
an empty string ("").
Microsoft Access has strong data typing; it imposes a rigorous set of rules on given column values. The empty string
value in the SQL query cannot be stored in an Access Date/Time column. Currently, the only known workaround is
to avoid inserting or updating Date/Time columns in Access with empty strings ("") or with any other value that does
not correspond to the range of values specified for the data type.
[Reference]80040e10—Too few parameters
This error occurs when a column specified in your SQL query does not exist in the database table. Check the column
names in your database table against the SQL query. The cause of this error is often a typographical error.
September 4, 2007
DREAMWEAVER CS3
User Guide
529
[Reference]80040e10—COUNT field incorrect
This error occurs when you preview a page containing an Insert Record server behavior in a web browser and try to
use it to insert a record in a Microsoft Access database.
You might be trying to insert a record into a database field that has a question mark (?) in its field name. The question
mark is a special character for some database engines, including Microsoft Access, and should not be used for
database table names or field names.
Open your database system and delete the question mark (?) from the field names, and update the server behaviors
on your page that refer to this field.
[Reference]80040e14—Syntax error in INSERT INTO statement
This error occurs when the server tries to process a page containing an Insert Record server behavior.
This error typically results from one or more of the following problems with the name of a field, object, or variable
in the database:
•Using a reserved word as a name. Most databases have a set of reserved words. For example, “date” is a reserved
word and cannot be used for column names in a database.
•Using special characters in the name. Examples of special characters include:
. / * : ! # & - ?
•Using a space in the name.
The error can also occur when an input mask is defined for an object in the database, and the inserted data does not
conform to the mask.
Tofixtheproblem,avoidusingreservedwordssuchas“date”,“name”,“select”,“where,”and“level”whenspecifying
column names in your database. Also, eliminate spaces and special characters.
See the following web pages for lists of reserved words for common database systems:
•Microsoft Access at http://support.microsoft.com/default.aspx?scid=kb;en-us;Q209187
•Microsoft SQL Server at http://msdn.microsoft.com/library/default.asp?url=/library/en-us/tsqlref/ts_ra-
rz_9oj7.asp
•MySQL at http://dev.mysql.com/doc/mysql/en/reserved-words.html
[Reference]80040e21—ODBC error on Insert or Update
This error occurs when the server tries to process a page containing an Update Record or Insert Record server
behavior. The database cannot handle the update or insert operation the server behavior is trying to perform.
Here are possible causes and solutions:
•The server behavior is trying to update a database table’s auto-number field or to insert a record into an auto-
number field. Because auto-number fields are populated automatically by the database system, any attempt to
externally populate them with a value fails.
•The data the server behavior is updating or inserting is the wrong type for the database field, such as inserting a
date into a Boolean (yes/no) field, inserting a string into a numeric field, or inserting an improperly formatted
string into Date/Time field.
[Reference]800a0bcd—Either BOF or EOF is true
This error occurs when you attempt to view a dynamic page in a web browser or in Live Data mode.
September 4, 2007
DREAMWEAVER CS3
User Guide
530
The problem occurs when the page tries to display data from an empty recordset. To solve the problem, apply the
Show Region server behavior to the dynamic content to be displayed on the page, as follows:
1Highlight the dynamic content on the page.
2IntheServerBehaviorspanel,clickthePlus(+)buttonandselectShowRegion>ShowRegionIfRecordsetIsNot
Empty.
3Select the recordset supplying the dynamic content and click OK.
4Repeat steps 1 to 3 for each element of dynamic content on the page.
Troubleshooting MySQL error messages
One common error message that you might encounter when testing a PHP database connection to MySQL 4.1 is
“Client does not support authentication protocol requested. Consider upgrading MySQL client.”
You may have to revert to an earlier version of MySQL, or install PHP 5 and copy some dynamic link libraries (DLLs).
For detailed instructions, see “Install a PHP application server” on page 503.
Also see the following TechNotes:
•TechNote c45f8a29 at www.adobe.com/go/c45f8a29.
•TechNote 16515 at www.adobe.com/go/16515.
Removing connection scripts
Using the Remove Connection Scripts command
YoucanusetheRemoveConnectionScriptscommandtoremovescriptsthatDreamweaverplacesinaremotefolder
to access databases. These scripts are only needed for design-time authoring in Dreamweaver.
When you select the Using Driver On Testing Server option or the Using DSN On Testing Server option in the
Database Connections dialog box, Dreamweaver uploads an MMHTTPDB script file to the testing server. This
allows Dreamweaver to manipulate the remote database driver with the HTTP protocol, which in turn allows
Dreamweaver to get the database information it needs to help you create your site. However, this file does make it
possible to see the data source names (DSNs) defined on the system. If the DSNs and databases are not password
protected, the script also enables an attacker to issue SQL commands to the database.
The MMHTTPDB script files are located in the _mmServerScripts folder, which is located in the root of your
website.
Note: The Dreamweaver file browser (the Files panel) hides the _mmServerScripts folder. You can see the
_mmServerScripts folder if you use a third-party FTP client or the file browser.
In some configurations these scripts are not necessary at all. The scripts are not involved when serving web pages to
visitors to your website, so they should not be placed on a production server.
If you’ve uploaded the MMHTTPDB scripts file to a production server, you should delete the MMHTTPDB scripts
file. The Remove Connection Scripts command automatically removes the script files for you.
For more information, see TechNote 19214 on the Adobe website at www.adobe.com/go/19214.
September 4, 2007
531
Chapter 18: Data sources for web
applications
You can display data on a web page using a number of sources. These sources can include databases, form and URL
parameters, and session variables. You can use these data sources in various ways to collect and display different
kinds of data.
Using a database to store content
Storing content in databases
Web-based applications and dynamic websites require a content source from which to retrieve data. Typically, data
consists of text or numerical information returned to a web page, and displayed in some form to the user. You can
use Adobe® Dreamweaver® CS3 to design web forms to insert, update, or delete data from the database.
Using a database to store content allows you to separate your website’s design from the content you want to display
to site users. Instead of writing individual HTML files for every page, you only need to write a page—or template—
for the different kinds of information you want to present. You can then upload content into a database and then
have the website retrieve that content in response to a user request. You can also update information in a single
source, and then populate that change throughout the website without having to manually edit each page.
Databases come in many forms depending upon the amount and the complexity of the data they must store. A
database commonly installed on Windows computers is Microsoft Access. If you are new to databases, Access
provides an easy-to-use interface that lets you work with database tables. You can use Access as a data source for most
website applications, be aware that Access has a file size limitation of 2 gigabytes (GB), and is limited to 255 concurrent
users. Access is a reasonable choice for website development and corporate workgroups. However, if you anticipate a
large user community accessing the site, use a database designed to support your site’s intended user base.
For websites requiring greater flexibility in their data modeling, and the ability to support large, concurrent user
communities, server-based relational databases (typically referred to as RDBMS) are used including MySQL,
Microsoft SQL Server, and Oracle.
Accessing data stored in a database
Web pages can’t directly access the data stored in a database. Instead, they interact with a recordset.Arecordsetisa
subset of the information (records), extracted from the database using a database query. A query is a search
statement designed to find and extract specific information from a database. Dreamweaver uses the Structured
Query Language (SQL, pronounced “sequel”) to build queries. Although you don’t need to learn SQL to create simple
queriesusingDreamweaver,abasicknowledgeofthislanguageletsyoucreatemoreadvancedqueries,andprovides
you with greater flexibility in designing dynamic pages.
A SQL query can produce a recordset that includes only certain columns, only certain records, or a combination of
both. A recordset can also include all the records and columns of a database table. However, because applications
rarely need to use every piece of data in a database, you should strive to make your recordsets as small as possible.
Because the web server temporarily holds the recordset in memory, using a smaller recordset uses less memory, and
can potentially improve server performance.
September 4, 2007
DREAMWEAVER CS3
User Guide
532
Collecting data submitted by users
About collecting data
You can use web pages to gather information from users, store that information in the server’s memory, and then use
theinformationtocreateadynamicresponsebasedontheuser’sinput.Themostcommontoolsforgatheringuser
information are HTML forms and hypertext links.
HTML forms Let you gather information from users and store it in the server’s memory. An HTML form can send
the information either as form parameters or as URL parameters.
Hypertext links Let you gather information from users and store it in the server’s memory. You specify a value (or
values) to be submitted when a user clicks a link—a preference, for example—by appending the value to the URL
specified in the anchor tag. When a user clicks the link, the browser sends the URL and the appended value to the
server.
HTML form parameters
Form parameters are sent to the server using an HTML form using either the POST or GET method. When using the
POST method, parameters are sent in the body of the message. In contrast, the GET method appends parameters to
the requested URL.
You can use Dreamweaver to quickly design HTML forms that send form parameters to the server. Be aware of the
method you use to transmit information from the browser to the server.
Form parameters take the names of their corresponding form objects. For example, if your form contains a text field
named txtLastName, then the following form parameter is sent to the server when the user clicks the Submit button:
txtLastName=enteredvalue
In cases where a web application expects a precise parameter value (for example, when it performs an action based
on one of several options), use a radio button, check box, or list/menu form object to control the values the user can
submit. This prevents users from typing information incorrectly and causing an application error. The following
example depicts a pop-up menu form offering three choices:
September 4, 2007
DREAMWEAVER CS3
User Guide
533
Each menu choice corresponds to a hard-coded value that is submitted as a form parameter to the server. The List
Values dialog box in the following example matches each list item to a value (Add, Update, or Delete):
Afteraformparameteriscreated,Dreamweavercanretrievethevalueanduseitinawebapplication.Afterdefining
the form parameter in Dreamweaver, you can insert its value within a page.
See also
“Creating forms” on page 600
“Adding dynamic content to pages” on page 564
“Accessing data stored in a database” on page 531
URL parameters
URL parameters let you pass user-supplied information from the browser to the server. When a server receives a
request and parameters are appended to the URL of the request, the server gives the requested page access to the
parameters before serving that page to the browser.
A URL parameter is a name-value pair appended to a URL. The parameter begins with a question mark (?) and takes
the form name=value. If more than one URL parameter exists, each parameter is separated by an ampersand (&).
The following example shows a URL parameter with two name-value pairs:
http://server/path/document?name1=value1&name2=value2
In this example workflow, the application is a web-based storefront. Because the developers of the site want to reach
the widest possible audience, the site is designed to support foreign currencies. When users log in to the site, they
can select the currency in which to view the prices of the available items.
1The browser requests the report.cfm page from the server. The request includes the URL parameter
Currency="euro". The Currency="euro" variable specifies that all monetary amounts retrieved be displayed as the
European Union euro.
2The server temporarily stores the URL parameter in memory.
3The report.cfm page uses the parameter to retrieve the cost of items in euros. These monetary amounts can either
be stored in a database table of different currencies, or converted from a single currency associated with each item
(any currency supported by the application).
September 4, 2007
DREAMWEAVER CS3
User Guide
534
4The server sends the report.cfm page to the browser and displays the value of items in the requested currency.
When this user ends the session, the server clears the value of the URL parameter, freeing server memory to hold
new user requests.
URL parameters are created when the HTTP GET method is used in conjunction with an HTML form. The GET
method specifies that the parameter value be appended to the URL request when the form is submitted.
Typical uses of URL parameters include personalizing websites based on user preferences. For example, a URL
parameter consisting of a user name and password can be used to authenticate a user, displaying only information
that user has subscribed to. Common examples of this include financial websites that display individual stock prices
based on stock market symbols the user has previously chosen. Web application developers commonly use URL
parameters to pass values to variables within applications. For example, you could pass search terms to SQL variables
in a web application to generate search results.
Creating URL parameters using HTML links
You create URL parameters within an HTML link by using the href attribute of the HTML anchor tag. You can enter
the URL parameters directly in the attribute in Code view (View > Code), or by appending the URL parameters at
the end of the link URL in the Property inspector Link box.
In the following example, three links create a single URL parameter (action) with three possible values (Add,
Update, and Delete). When the user clicks a link, a parameter value is sent to the server, and the requested action
is performed.
<a href="http://www.mysite.com/index.cfm?action=Add">Add a record</a>
<a href="http://www.mysite.com/index.cfm?action=Update">Update a record</a>
<a href="http://www.mysite.com/index.cfm?action=Delete">Delete a record</a>
The Property inspector (Window > Properties) lets you create the same URL parameters by selecting the link and
appending the URL parameter values at the end of the link URL in the Link box.
After a URL parameter is created, Dreamweaver can retrieve the value and use it in a web application. After defining
the URL parameter in Dreamweaver, you can insert its value within a page.
September 4, 2007
DREAMWEAVER CS3
User Guide
535
See also
“About URL and form parameters” on page 544
“Define form parameters” on page 557
“Adding dynamic content to pages” on page 564
“Accessing data stored in a database” on page 531
Accessing data stored in session variables
How session variables work
Session variables store information (usually form or URL parameters submitted by users) and make it available to all
of a web application’s pages for the duration of the user’s visit. For example, when users log on to a web portal that
provides access to e-mail, stock quotes, weather reports, and daily news, the web application stores the login infor-
mation in a session variable that identifies the user throughout the site’s pages. This allows the user to see only the
types of content they have selected as they navigate through the site. Session variables can also provide a safety
mechanism by terminating the user’s session if the account remains inactive for a certain period of time. This also
frees server memory and processing resources if the user forgets to log off a website.
Session variables store information for the life of the use session. The session begins when the user opens a page
within the application and ends when the user does not open another page in the application for a certain period of
time, or when the user explicitly terminates the session (typically by clicking a “log-off ” link). While it exists, the
session is specific to an individual user, and every user has a separate session.
Use session variables to store information that every page in a web application can access. The information can be as
diverse as the user’s name, preferred font size, or a flag indicating whether the user has successfully logged in.
Another common use of session variables is to keep a running tally, such as the number of questions answered
correctly so far in an online quiz, or the products the user selected so far from an online catalog.
Sessionvariablescanonlyfunctioniftheuser’sbrowserisconfiguredtoacceptcookies.Theservercreatesasession
ID number that uniquely identifies the user when the session is first initiated, then sends a cookie containing the ID
numbertotheuser’sbrowser.Whentheuserrequestsanotherpageontheserver,theserverreadsthecookieinthe
browser to identify the user and to retrieve the user’s session variables stored in the server’s memory.
Collecting, storing, and retrieving information in session variables
Before creating a session variable, you must first obtain the information you want to store, and then send it to the
server for storage. You can gather and send information to the server using HTML forms or hypertext links
containingURLparameters.Youcanalsoobtaininformationfromcookiesstoredontheuser’scomputer,fromthe
HTTP headers sent by the user’s browser with a page request, or from a database.
A typical example of storing URL parameters in session variables is a product catalog that uses hard-coded URL
parameters created using a link to send product information back to the server to be stored in a session variable.
When a user clicks the “Add to shopping cart” link, the product ID is stored in a session variable while the user
continues to shop. When the user proceeds to the check-out page, the product ID stored in the session variable is
retrieved.
September 4, 2007
DREAMWEAVER CS3
User Guide
536
A form-based survey is a typical example of a page that stores form parameters in session variables. The form sends
the selected information back to the server, where an application page scores the survey and stores the responses in
a session variable to be passed to an application that might tally up the responses gathered from the survey
population. Or the information might be stored in a database for later use.
After information is sent to the server, you store the information in session variables by adding the appropriate code
for your server model to the page specified by the URL or form parameter. Referred to as the destination page, this
page is specified in either the action attribute of the HTML form or the href attribute of the hypertext link on the
starting page.
After you store a value in a session variable, you can use Dreamweaver to retrieve the value from session variables
and use it in a web application. After you define the session variable in Dreamweaver, you can insert its value in a
page.
The HTML syntax for each appears as follows:
<form action="destination.html" method="get" name="myform"> </form>
<param name="href"value="destination.html">
Both the server technology used and the method you use to obtain the information determines the code used to store
the information in a session variable. The basic syntax for each server technology is as follows:
ColdFusion
<CFSET session.variable_name = value>
ASP and ASP.NET
<% Session("variable_name") = value %>
The value expression is usually a server expression such as Request.Form(“lastname”).Forexample,ifyouuse
a URL parameter called product (or an HTML form with the GET methodandatextfieldcalledproduct)togather
information, the following statements store the information in a session variable called prodID:
ColdFusion
<CFSET session.prodID = url.product>
ASP and ASP.NET
<% Session("prodID") = Request.QueryString("product") %>
If you use an HTML form with the post method and a text field called txtProduct to gather the information, then
the following statements store the information in the session variable:
ColdFusion
<CFSET session.prodID = form.txtProduct>
ASP and ASP.NET
<% Session("prodID") = Request.Form("txtProduct") %>
See also
“Adding dynamic content to pages” on page 564
“Define session variables” on page 558
September 4, 2007
DREAMWEAVER CS3
User Guide
537
Example of information stored in session variables
You’re working on a site with a large audience of senior citizens. In Dreamweaver, add two links to the Welcome
screen that let users customize the size of the site’s text. For larger, easy-to-read text, the user clicks one link, and for
regular-size text, the user clicks another link.
Each link has a URL parameter called fontsize that submits the user’s text preference to the server, as the following
Macromedia ColdFusion® from Adobe example shows:
<a href="resort.cfm?fontsize=large">Larger Text</a><br>
<a href="resort.cfm?fontsize=small">Normal Text</a>
Store the user’s text preference in a session variable and use it to set the font size on each page the user requests.
Near the top of the destination page, enter the following code to create a session called font_pref that stores the
user’s font size preference.
ColdFusion
<CFSET session.font_pref = url.fontsize>
ASP and ASP.NET
<% Session("font_pref") = Request.QueryString("fontsize") %>
When the user clicks the hypertext link, the page sends the user’s text preference in a URL parameter to the desti-
nation page. The code on the destination page stores the URL parameter in the font_pref session variable. For the
duration of the user’s session, all the pages of the application retrieve this value and display the selected font size.
September 4, 2007
538
Chapter 19: Making pages dynamic
You can create dynamic pages that display information from dynamic content sources such as databases and session
variables. Adobe® Dreamweaver® CS3 supports dynamic page development for ColdFusion, ASP, ASP.NET, JSP, and
PHP server models.
You can also use an Ajax-based framework called Spry to create dynamic pages that display and process XML data.
Using prebuilt Spry form elements lets you build dynamic pages that don’t require a full-page refresh.
Optimizing the workspace for visual development
Displaying web-application development panels
Click the Data tab in the Insert bar to display a set of buttons that let you add dynamic content and server behaviors
to your page.
The number and type of buttons that appear vary depending upon the document type opened in the Document
window. Move your mouse over an icon to display a tooltip that describes what that button does.
The Insert bar includes buttons to add the following items to the page:
•Recordsets
•Dynamic text or tables
•Record navigation bars
If you switch to Code view (View > Code), additional panels might appear in their own Insert bar category, allowing
you to insert code in the page. For example, if you view a ColdFusion page in Code view, a CFML panel becomes
available in the CFML category of the Insert bar.
Several panels provide ways for you to create dynamic pages:
•Select the Bindings panel (Window > Bindings) to define sources of dynamic content for your page and add the
content to the page.
•Select the Server Behaviors panel (Window > Server Behaviors) to add server-side logic to your dynamic pages.
•Select the Databases panel (Window >Databases) to explore databases or create database connections.
•Select the Components panel (Window > Components) to inspect, add, or modify code for JavaBeans, Adobe
ColdFusion components, or web services.
Note: The Components panel is enabled only if you open a ColdFusion, a JSP, or an ASP.NET page. Also, the document
might not support certain components. For example, ColdFusion documents do not support JavaBeans.
A server behavior is the set of instructions inserted in a dynamic page at design time and executed on the server at
run time.
For a tutorial on setting up the development workspace, see www.adobe.com/go/vid0144.
September 4, 2007
DREAMWEAVER CS3
User Guide
539
See also
“Bindings panel” on page 546
“Server Behaviors panel” on page 546
“Databases panel” on page 547
“Components panel” on page 547
View your database within Dreamweaver
After connecting to your database, you can view its structure and data within Dreamweaver.
1Open the Databases panel (Window > Databases).
The Databases panel displays all the databases for which you created connections. If you’re developing a ColdFusion
site, the panel displays all the databases that have data sources defined in the ColdFusion Administrator.
Note: Dreamweaver looks at the ColdFusion server you defined for the current site.
If no database appears in the panel, you must create a database connection.
2To display the tables, stored procedures, and views in the database, click the Plus (+) sign beside a connection in
the list.
3To display the columns in the table, click a table name.
The column icons reflect the data type and indicate the primary key of the table.
4To view the data in a table, right-click (Windows) or Control-click (Macintosh) the table name in the list, and
select View Data from the pop-up menu.
See also
“Setting up a web application” on page 501
Previewing dynamic pages in a browser
Webapplicationdevelopersoftendebugtheirpagesbycheckingthemofteninawebbrowser.Youcanquicklyview
dynamic pages in a browser without first manually uploading them to a server (press F12).
To preview dynamic pages, you must complete the Testing Server category of the Site Definition dialog box.
You can also use Design view to quickly check your pages while working on them. Design view displays a fully
editable, visual representation of your page, including live data.
You can specify that Dreamweaver use temporary files instead of the original files. With this option, Dreamweaver
runsatemporarycopyofthepageonawebserverbeforedisplayingitinyourbrowser.(Dreamweaverthendeletes
the temporary file from the server.) To set this option, select Edit > Preferences > Preview In Browser.
ThePreviewInBrowseroptiondoesnotuploadrelatedpagessuchasaresultsoradetailpage,dependentfilessuch
as image files, or server-side includes. To upload a missing file, select Window > Site to open the Site panel, select the
file under Local Folder, and click the blue up arrow in the toolbar to copy the file to the web server folder.
September 4, 2007
DREAMWEAVER CS3
User Guide
540
See also
“Set up a testing server” on page 48
“View live data in Design view” on page 579
Restrict database information displayed in Dreamweaver
Advanced users of large database systems like Oracle should restrict the number of database items retrieved and
displayedbyDreamweaveratdesigntime.AnOracledatabasemaycontainitemsthatDreamweavercannotprocess
at design time. You can create a schema in Oracle and use it in Dreamweaver to filter out unnecessary items at design
time.
Note: You cannot create a schema or catalog in Microsoft Access.
Other users may benefit from restricting the amount of information Dreamweaver retrieves at design time. Some
databases contain dozens or even hundreds of tables, and you might prefer not to list them all while you work. A
schema or catalog can restrict the number of database items that are retrieved at design time.
YoumustcreateaschemaorcataloginyourdatabasesystembeforeyoucanapplyitinDreamweaver.Consultyour
database system documentation or your system administrator.
Note: You cannot apply a schema or catalog in Dreamweaver if you’re developing a ColdFusion application, or using
Microsoft Access.
1Open a dynamic page in Dreamweaver; then open the Databases panel (Window > Databases).
•If the database connection exists, right-click (Windows) or Control-click (Macintosh) the connection in the list,
and select Edit Connection from the pop-up menu.
•If the connection does not exist, click the Plus (+) button at the top of the panel and create it.
2In the dialog box for the connection, click Advanced.
3Specify your schema or catalog, and click OK.
Set the Property inspector for ColdFusion stored procedures, ASP commands, and JSP
callables
Modify the selected stored procedure. The available options vary depending on the server technology.
❖Edit any of the options. When you select a new option in the inspector, Dreamweaver updates the page.
See also
“Edit dynamic content” on page 568
Set the Property inspector for JSP prepared statements
The purpose of this Property inspector is to modify the selected JSP prepared statement.
❖Edit any of the options. When you select a new option in the inspector, Dreamweaver updates the page.
Input Name options
This Property inspector appears when Dreamweaver encounters an unrecognized input type. Typically this occurs
because of a typing or other data entry error.
September 4, 2007
DREAMWEAVER CS3
User Guide
541
If you change the field type in the Property inspector to a value that Dreamweaver recognizes—for example, if you
correct the spelling error—the Property inspector updates to show the properties for the recognized type. Set any of
the following options in the Property inspector:
Input Name Assigns a name to the field. This box is required, and the name must be unique.
Type Sets the input type of the field. The contents of this box reflect the input type value that currently appears in
your HTML source code.
Value Sets the value of the field.
Parameters Opens the Parameters dialog box so you can view the current attributes of the field, as well as add or
remove attributes.
Designing dynamic pages
Dreamweaver and dynamic page design
Follow these general steps to successfully design and create a dynamic website.
1Design the page.
A key step in designing any website—whether static or dynamic—is the visual design of the page. When adding
dynamic elements to a web page, the design of the page becomes crucial to its usability. You should carefully consider
how users will interact with both individual pages and the website as a whole.
A common method of incorporating dynamic content into a web page is to create a table to present content, and
import dynamic content into one or more of the table’s cells. Using this method you can present information of
various types in a structured format.
2Create a source of dynamic content.
Dynamic websites require a content source from which to extract data before they can display it on a web page.
Before you can use content sources in a web page, you must do the following:
•Create a connection to the dynamic content source (such as a database) and the application server processing the
page. Create the data source by using the Bindings panel; then you can select and insert the data source in the page.
•Specify what information in the database you want to display, or what variables to include in the page by creating
arecordset.YoucanalsotestthequeryfromwithintheRecordsetdialogbox,andmakeanyneededadjustments
before adding it to the Bindings panel.
•Select and insert dynamic content elements into the selected page.
3Add dynamic content to a web page.
After you define a recordset or other data source, and add it to the Bindings panel, you can insert the dynamic
content the recordset represents into the page. The Dreamweaver menu-driven interface makes adding dynamic
content elements as easy as selecting a dynamic content source from the Bindings panel, and inserting it into an
appropriate text, image, or form object within the current page.
When you insert a dynamic content element or other server behavior into a page, Dreamweaver inserts a server-side
script into the page’s source code. This script instructs the server to retrieve data from the defined data source and
render it within the web page. To place dynamic content within a web page, you can do one of the following:
•To place dynamic content within a web page, you can do one of the following:
September 4, 2007
DREAMWEAVER CS3
User Guide
542
•Place it at the insertion point in either Code or Design view.
•Replace a text string or other placeholder.
Insert it into an HTML attribute. For example, dynamic content can define the src attribute of an image or the value
attribute of a form field.
4Add server behaviors to a page.
In addition to adding dynamic content, you can incorporate complex application logic into web pages by using server
behaviors. Server behaviors are predefined pieces of server-side code that add application logic to web pages,
providing greater interaction and functionality.
The Dreamweaver server behaviors let you add application logic to a website without having to write the code
yourself. The server behaviors supplied with Dreamweaver support ColdFusion, ASP, ASP.NET, JSP, and PHP
document types. The server behaviors are written and tested to be fast, secure, and robust. The built-in server
behaviors support cross-platform web pages for all browsers.
Dreamweaver provides a point-and-click interface that makes applying dynamic content and complex behaviors to
a page as easy as inserting textual and design elements. The following server behaviors are available:
•Define a recordset from an existing database. The recordset you define is then stored in the Bindings panel.
•Displaymultiplerecordsonasinglepage.Youselecteitheranentiretableorindividualcellsorrowsthatcontain
dynamic content, and specify the number of records to display on each page view.
•Create and insert a dynamic table into a page, and associate the table with a recordset. You can later modify both
the tables appearance and the repeating region by using the Property inspector and Repeating Region Server
Behavior, respectively.
•Insert a dynamic text object into a page. The text object you insert is an item from a predefined recordset, to which
you can apply any of the data formats.
•Create record navigation and status controls, master/detail pages, and forms for updating information in a
database.
•Display more than one record from a database record.
•Create recordset navigation links that allow users to view the previous or next records from a database record.
•Add a record counter to help users keep track of how many records were returned, and where they are in the
returned result.
You can also extend Dreamweaver server behaviors by writing your own, or installing server behaviors written by
third parties.
5Test and debug the page.
Before making a dynamic page—or an entire website—available on the web, you should test its functionality. You
should also consider how your application’s functionality might affect people with disabilities.
For a tutorial on creating dynanic pages, see www.adobe.com/go/learn_dw_webapp.
See also
“Presenting content with tables” on page 176
“Adding and formatting text” on page 226
“Adding and modifying images” on page 243
September 4, 2007
DREAMWEAVER CS3
User Guide
543
“Inserting Flash content” on page 255
“Data sources for web applications” on page 531
Dynamic content sources overview
About dynamic content sources
Adynamic content source is a store of information from which you can retrieve and display dynamic content for use
in a web page. Sources of dynamic content include not only information stored in a database, but values submitted
by HTML forms, values contained in server objects, values of JavaBeans properties, and other content sources.
Dreamweaver lets you easily connect to a database and create a recordset from which to extract dynamic content. A
recordset is the result of a database query. It extracts the specific information you request and allows you to display
that information within a specified page. You define the recordset based on the information contained in the
database and the content you want to display.
Different technology vendors may use different terminology for a recordset. In ASP and ColdFusion, a recordset is
definedasaquery.InJSP,arecordsetiscalledaresultset. ASP.NET refers to a recordset as a DataSet.Ifyouareusing
other sources of data, such as user input or server variables, the name of the data source that is defined in
Dreamweaver is the same as the data source name itself.
Dynamic websites require a data source from which to retrieve and display dynamic content. Dreamweaver lets you
use databases, request variables, URL variables, server variables, form variables, stored procedures, and other sources
of dynamic content. Depending on the data source, you can either retrieve new content to satisfy a request, or modify
the page to meet the needs of users.
Any content source that you define in Dreamweaver is added to the list of content sources in the Bindings panel.
Then you can insert the content source into the currently selected page.
About recordsets
When using a database as a content source for a dynamic web page, you must first create a recordset in which to store
the retrieved data. Recordsets serveasanintermediarybetweenthedatabasestoringthecontentandtheapplication
server generating the page. Recordsets consist of the data returned by a database query, and are temporarily stored
in the application server’s memory for faster data retrieval. The server discards the recordset when it is no longer
needed.
The recordset itself is a collection of data retrieved from a specified database. It can include an entire database table,
orasubsetofthetable’srowsandcolumns.Theserowsandcolumnsareretrievedbymeansofadatabasequerythat
is defined in the recordset. Database queries are written in Structured Query Language (SQL), a simple language that
allowsyoutoretrieve,add,anddeletedatatoandfromadatabase.TheSQLbuilderincludedwithDreamweaverlets
you create simple queries without having to understand SQL. However, if you want to create complex SQL queries,
you will need to learn SQL, and manually write SQL statements that you enter into Dreamweaver.
Note: Microsoft ASP.NET refers to a recordset as a DataSet. If you are working with ASP.NET document types, the dialog
boxes and menu choices specific to ASP.NET use the label DataSet. The Dreamweaver documentation generically refers
to both types as recordsets, but uses DataSet when specifically describing ASP.NET features.
If you will be writing SQL for use with ASP.NET, there are some conditions specific to ASP.NET that you should be
aware of.
September 4, 2007
DREAMWEAVER CS3
User Guide
544
Before you define a recordset for use with Dreamweaver, you must create a connection to a database and—if no data
exists yet—enter data into the database. If you have not yet defined a database connection for your site, refer to the
database connection chapter for the server technology you are developing for, and follow the instructions on creating
a database connection.
See also
“Define a recordset without writing SQL” on page 547
Writing SQL for ASP.NET
When writing SQL statements in the Advanced DataSet dialog box, there are conditions specific to ASP.NET that
you must be aware of. These conditions are described in the next sections.
Parameters
The syntax you use to reference parameters varies depending on the database connection in use (for example, OLE
DB or Microsoft SQL Server).
•OLE DB
When connecting to a database using OLE DB, parameters must be referenced using a question mark (?). For
example:
SELECT * FROM Employees WHERE HireDate > ?
•Microsoft SQL Server
When connecting to Microsoft SQL Server using the Managed Data Provider for SQL Server supplied with the .NET
Framework, all parameters must be named. For example:
SELECT * FROM Employees WHERE HireDate > @hireDate
Insert code within SQL statements
When inserting code within SQL statements written for ASP.NET, you must enclose all strings in quotes (" "), and
enclose the code in parentheses ( ).
SELECT * FROM Employees WHERE HireDate > "+ (Request.queryString("hireDate"))
See also
“Database connections for ASP.NET developers” on page 518
About URL and form parameters
URL parameters store retrieved information input by users. To define a URL parameter you create a form or
hypertext link that uses the GET method to submit data. The information is appended to the URL of the requested
page and communicated to the server. When using URL variables, the query string contains one or more name-value
pairs that are associated with the form fields. These name-value pairs are appended to the URL.
Form parameters store retrieved information that is included in the HTTP request for a web page. If you create a
form that uses the POST method, the data submitted by the form is passed to the server. Before you begin, make sure
you pass a form parameter to the server.
September 4, 2007
DREAMWEAVER CS3
User Guide
545
See also
“URL parameters” on page 533
“Define form parameters” on page 557
About session variables
Session variables let you store and display information maintained for the duration of a user’s visit (or session). The
server creates a different session object for each user and maintains it for a set period of time or until the object is
explicitly terminated.
Because session variables last throughout the user’s session and persist when the user moves from page to page
within the website, they’re ideal for storing user preferences. Session variables can also be used for inserting a value
in the page’s HTML code, assigning a value to a local variable, or providing a value to evaluate a conditional
expression.
Before defining session variables for a page, you must create them in the source code. After you create a session
variable in the web application’s source code, you can use Dreamweaver to retrieve its value and use it in a web page.
See also
“Define session variables” on page 558
ASP and ColdFusion application variables
In ASP and ColdFusion, you can use application variables to store and display information that is maintained for the
lifetime of the application and persists from user to user. The application’s lifetime lasts from the time the first user
requests a page in the application to the time the web server is stopped. (An application is defined as all the files in
a virtual directory and its subdirectories.)
Because application variables last for the lifetime of the application, and persist from user to user, they’re ideal for
storing information that must exist for all users, such as the current time and date. The value of the application
variable is defined in the application’s code.
ASP server variables
You can define the following ASP server variables as sources of dynamic content: Request.Cookie,
Request.QueryString,Request.Form,Request.ServerVariables, and Request.ClientCertificates.
See also
“Define server variables” on page 559
ColdFusion server variables
You can define the following ColdFusion server variables:
Client variables Associate data with a specific client. Client variables maintain the application’s state as the user
moves from page to page in the application, as well as from session to session. “Maintaining state” means to preserve
information from one page (or session) to the next so that the application remembers the user, and the user’s
previous choices and preferences.
Cookie variables Access cookies passed to the server by the browser.
September 4, 2007
DREAMWEAVER CS3
User Guide
546
CGI variables Provide information about the server running ColdFusion, the browser requesting a page, and other
information about the processing environment.
Server variables Can be accessed by all clients and applications on the server. They persist until the server is stopped.
Local variables Created with the CFSET tag or CFPARAM tag within a ColdFusion page.
See also
“Define server variables” on page 559
Dynamic content panels
Bindings panel
Use the Bindings panel to define and edit sources of dynamic content, add dynamic content to a page, and apply data
formats to dynamic text.
You can perform the following tasks with this panel:
•“Defining sources of dynamic content” on page 547
•“Adding dynamic content to pages” on page 564
•“Change or delete content sources” on page 563
•“Use predefined data formats” on page 578
•“Attach XML data sources” on page 430
•“Display XML data in XSLT pages” on page 431
•“URL parameters” on page 533
•“Define session variables” on page 558
•“Define application variables for ASP and ColdFusion” on page 558
•“Define server variables” on page 559
•“Cache content sources” on page 563
•“Copy a recordset from one page to another page” on page 563
•“Make HTML attributes dynamic” on page 566
Server Behaviors panel
Use the Server Behavior panel to add Dreamweaver server behaviors to a page, edit server behaviors, and create
server behaviors.
You can perform the following tasks with this panel:
•“Displaying database records” on page 570
•“Defining sources of dynamic content” on page 547
•“Build master and detail pages in one operation (ColdFusion, ASP, JSP, PHP)” on page 622
•“Building search and results pages (ColdFusion, ASP, JSP, PHP)” on page 624
September 4, 2007
DREAMWEAVER CS3
User Guide
547
•“Building a database search page (ASP.NET)” on page 629
•“Building a record insert page (all servers)” on page 633
•“Building pages to update a record (all servers)” on page 637
•“Building pages to delete a record (all servers)” on page 643
•“Building a page only authorized users can access (ColdFusion, ASP, JSP, PHP)” on page 662
•“Building a registration page (ColdFusion, ASP, JSP, PHP)” on page 658
•“Building a login page (ColdFusion, ASP, JSP, PHP)” on page 660
•“Building a page only authorized users can access (ColdFusion, ASP, JSP, PHP)” on page 662
•“Add a stored procedure (ColdFusion)” on page 654
•“Add a stored procedure (ASP.NET)” on page 655
•“Delete dynamic content” on page 568
•“Adding custom server behaviors” on page 589
Databases panel
Use the Databases panel to create database connections, to inspect databases, and to insert database-related code in
your pages.
You can view and connect to your database with this panel:
•“View your database within Dreamweaver” on page 539
•“Database connections for ColdFusion developers” on page 508
•“Database connections for ASP.NET developers” on page 518
•“Database connections for ASP developers” on page 510
•“Database connections for JSP developers” on page 521
•“Database connections for PHP developers” on page 517
Components panel
Use the Components panel to create and inspect components, and to insert component code in your pages.
Note: The panel does not work in Design view.
You can perform the following tasks with this panel:
•“Using ColdFusion components (ColdFusion)” on page 665
•“Using web services” on page 583
Defining sources of dynamic content
Define a recordset without writing SQL
You can create a recordset without manually entering SQL statements.
1In the Document window, open the page that will use the recordset.
September 4, 2007
DREAMWEAVER CS3
User Guide
548
2Select Windows > Bindings to display the Bindings panel.
3In the Bindings panel, click the Plus (+) button and select Recordset (Query) from the pop-up menu.
The simple Recordset dialog box appears. If you are developing a ColdFusion or ASP.NET site, the Recordset dialog
box is slightly different. (If the advanced Recordset dialog appears instead, click the Simple button to switch to the
simple Recordset dialog box.)
4Complete the Recordset dialog box for your document type.
For instructions, see the topics below.
5Click the Test button to execute the query and ensure that it retrieves the information you intended.
If you defined a filter that uses parameters input by users, enter a value in the Test Value box, and click OK. If an
instance of the recordset is successfully created, a table appears that displays data extracted from the recordset.
6Click OK to add the recordset to the list of available content sources in the Bindings panel.
See also
“Database connections for ASP.NET developers” on page 518
Options for the simple Recordset dialog box (PHP, ASP, JSP)
1In the Name box, enter a name for the recordset.
A common practice is to add the prefix rs to recordset names to distinguish them from other object names in the
code, for example: rsPressReleases.
Recordset names can only contain letters, numbers, and the underscore character (_). You cannot use special
characters or spaces.
2Select a connection from the Connection pop-up menu.
If no connection appears in the list, click Define to create one.
3In the Table pop-up menu, select the database table that will provide data to the recordset.
The pop-up menu displays all tables in the specified database.
4To include a subset of the table’s columns in the recordset, click Selected and choose the desired columns by
Control-clicking (Windows) or Command-clicking (Macintosh) them in the list.
5To further limit the records returned from the table, complete the Filter section:
•From the first pop-up menu, select a column in the database table to compare against a test value you define.
•From the second pop-up menu, select a conditional expression to compare the selected value in each record
against the test value.
•From the third pop-up menu, select Entered Value.
•In the box, enter the test value.
If the specified value in a record meets your filtering condition, the record is included the recordset.
6(Optional) To sort the records, select a column to sort by, and then specify whether the records should be sorted
in ascending order (1, 2, 3... or A, B, C...) or descending order.
7Click Test to connect to the database and create an instance of the data source, and click OK to close the data
source.
September 4, 2007
DREAMWEAVER CS3
User Guide
549
A table appears displaying the returned data. Each row contains a record and each column represents a field in that
record.
8Click OK. The newly defined recordset appears in the Bindings panel.
Options for the simple Recordset dialog box (ColdFusion)
Define a recordset for ColdFusion document types as a source of dynamic content without you having to hand code
SQL statements.
Note: If you are creating recordsets for use with ColdFusion 5 or earlier, use the generic Simple Recordset dialog box
common to other document types such as ASP and JSP.
1In the Name box, enter a name for the recordset.
A common practice is to add the prefix rs to recordset names to distinguish them from other object names in your
code. For example: rsPressReleases
Recordset names can only contain letters, numbers, and the underscore character (_). You cannot use special
characters or spaces.
2If you’re defining a recordset for a ColdFusion component (that is, if a CFC file is currently open in
Dreamweaver), select an existing CFC function from the Function pop-up menu, or click the New Function button
to create a new function.
Note: The Function pop-up menu is only available if a CFC file is the current document and you have access to a
computer running ColdFusion MX 7 or better.
The recordset is defined in the function.
3Select a data source from the Data Source pop-up menu.
If no data source appears in the pop-up menu, you must create a ColdFusion data source.
4In the Username and Password boxes, enter the user name and password for the ColdFusion application server if
required.
Data sources in ColdFusion may require a user name and password to access them. If you do not have the user name
and password to access a data source in ColdFusion, contact your organization’s ColdFusion administrator.
5In the Table pop-up menu, select the database table that will provide data to the recordset.
The Table pop-up menu displays all tables in the specified database.
6To include a subset of the table’s columns in the recordset, click Selected and choose the desired columns by
Control-clicking (Windows) or Command-clicking (Macintosh) them in the list.
7To further limit the records returned from the table, complete the Filter section:
•From the first pop-up menu, select a column in the database table to compare against a test value you define.
•From the second pop-up menu, select a conditional expression to compare the selected value in each record
against the test value.
•From the third pop-up menu, select Entered Value.
•In the box, enter the test value.
If the specified value in a record meets your filtering condition, the record is included in the recordset.
8(Optional) To sort the records, select a column to sort by, and then specify whether the records should be sorted
in ascending (1, 2, 3... or A, B, C...) or descending order.
September 4, 2007
DREAMWEAVER CS3
User Guide
550
9Click Test to connect to the database and create an instance of the data source.
A table appears displaying the returned data. Each row contains a record and each column represents a field in that
record. Click OK to close the test recordset.
10 Click OK. The newly defined ColdFusion recordset appears in the Bindings panel.
Options for the simple DataSet dialog box (ASP.NET)
Define an ASP.NET DataSet as a source of dynamic content without hand coding SQL statements.
1In the Name box, enter a name for the DataSet.
A common practice is to add the prefix ds to DataSet names to distinguish them from other object names in your
code, for example: dsPressReleases.
DataSet names can only contain letters, numbers, and the underscore character (_). You cannot use special
characters or spaces.
2Select a connection from the Connection pop-up menu.
If no connection appears in the list, click Define to create one.
3In the Table pop-up menu, select the database table that will provide data to the DataSet.
The pop-up menu displays all the tables in the specified database.
4To include a subset of the table’s columns in the DataSet, click Selected and choose the desired columns by
Control-clicking (Windows) or Command-clicking (Macintosh) them in the list.
5To include only some of the table’s records, complete the Filter section as follows:
•From the first pop-up menu, select a column in the database table to compare against a test value you define.
•From the second pop-up menu, select a conditional expression to compare the selected value in each record
against the test value.
•From the third pop-up menu, select Entered Value.
•In the box, enter the test value.
If the specified value in a record meets your filtering condition, the record will be included in the DataSet.
6(Optional) To sort the records, select a column to sort by, and then specify whether the records should be sorted
in ascending order (1, 2, 3... or A, B, C...) or descending order.
7You can specify a page to redirect users to if the DataSet query should for some reason fail. For example, if the
database were to become unavailable during a query and failed to return the DataSet for the page, you could display
an error page with a link to the site’s home page.
8Click Test to connect to the database, and create an instance of the data source.
A table appears displaying the returned data. Each row contains a record and each column represents a field in that
record. Click OK to close the DataSet.
9Click OK. The newly defined DataSet appears in the Bindings panel.
Define an advanced recordset by writing SQL
Write your own SQL statements by using the advanced Recordset dialog box, or create a SQL statement by using the
graphical Database Items tree.
September 4, 2007
DREAMWEAVER CS3
User Guide
551
Note: If you are writing SQL statements for ASP.NET document types, see “Writing SQL for ASP.NET” on page 544 for
rules specific to ASP.NET.
1In the Document window, open the page that will use the recordset.
2Select Windows > Bindings to display the Bindings panel.
3In the Bindings panel, click the Plus (+) button and select Recordset (Query) from the pop-up menu.
The advanced Recordset dialog box appears. If you are developing a ColdFusion or ASP.NET site, the Recordset
dialog box is slightly different. (If the simple Recordset dialog box appears instead, switch to the advanced Recordset
dialog box by clicking the Advanced button.)
4Complete the advanced Recordset dialog box.
For instructions, see the topics below.
5Click the Test button to execute the query and ensure that it retrieves the information you intended.
If you defined a filter that uses parameters input by users, the Test button displays the Test Value dialog box. Enter a
valueintheTestValueboxandclickOK.Ifaninstanceoftherecordsetissuccessfullycreated,atabledisplayingthe
data from the recordset appears.
6Click OK to add the recordset to the list of available content sources in the Bindings panel.
See also
“Create SQL queries using the Database Items tree” on page 555
“Database connections for ASP developers” on page 510
“Database connections for PHP developers” on page 517
“Defining sources of dynamic content” on page 547
“Add a stored procedure (ColdFusion)” on page 654
Options for the advanced Recordset dialog box (PHP, ASP, JSP)
Define a recordset as a source of dynamic content by writing a custom SQL statement, or by creating a SQL statement
using the graphical Database Items tree.
1In the Name box, enter a name for the recordset.
A common practice is to add the prefix rs to recordset names to distinguish them from other object names in the
code. For example: rsPressRelease
Recordset names can only contain letters, numbers, and the underscore character (_). You cannot use special
characters or spaces.
2Select a connection from the Connection pop-up menu.
3Enter a SQL statement in the SQL text area or use the graphical Database Items tree at the bottom of the dialog
box to build a SQL statement from the chosen recordset.
Do the following to use the Database Items tree to build the SQL statement:
•Ensure the SQL text area is blank.
•Expand the branches of the tree until you find the database object you need—a column in a table, for example, or
a stored procedure in the database.
•Select the database object and click one of the buttons on the right side of the tree.
September 4, 2007
DREAMWEAVER CS3
User Guide
552
For example, if you select a table column, the available buttons are SELECT, WHERE, and ORDER BY. Click one of
the buttons to add the associated clause to your SQL statement.
You can also use a predefined SQL statement in a stored procedure by selecting the stored procedure from the
Database Items tree and clicking the Procedure button. Dreamweaver automatically fills in the SQL and Variable
areas.
4If the SQL statement contains variables, define their values in the Variables area by clicking the Plus (+) button
and entering the variable’s name, default value (the value the variable should take if no run-time value is returned),
and run-time value.
IftheSQLstatementcontainsvariables,makesuretheDefaultValuecolumnoftheVariablesboxcontainsvalidtest
values.
The run-time value is usually a URL or form parameter entered by a user in an HTML form field.
URL parameters in the Run-time Value column.
Form parameters in the Run-time Value column:
5Click Test to connect to the database and create an instance of the recordset.
IftheSQLstatementcontainsvariables,makesuretheDefaultValuecolumnoftheVariablesboxcontainsvalidtest
values before clicking Test.
If successful, a table appears displaying the data in your recordset. Each row contains a record and each column
represents a field in that record. Click OK to clear the recordset.
6If satisfied with your work, click OK.
Options for the advanced Recordset dialog box (ColdFusion)
Use the advanced Recordset dialog box to write custom SQL queries, or use the Database Items tree to author SQL
queries using a point-and-click interface.
Note: If you are creating advanced recordsets for use with ColdFusion 5 or earlier, use the generic advanced Recordset
dialog box common to other document types such as ASP and JSP.
1In the Name box, enter a name for the recordset.
A common practice is to add the prefix rs to recordset names to distinguish them from other object names in your
code. For example: rsPressReleases
Server Model Run-Time value expression for URL parameter
ASP Request.QueryString(“formFieldName”)
JSP request.getParameter("formFieldName")
PHP #formFieldName#
Server Model Run-Time value expression for form parameter
ASP Request.Form(“formFieldName”)
JSP request.getParameter("formFieldName")
PHP #formFieldName#
September 4, 2007
DREAMWEAVER CS3
User Guide
553
Recordset names can only contain letters, numbers, and the underscore character (_). You cannot use special
characters or spaces.
If you’re defining a recordset for a ColdFusion component (that is, if a CFC file is currently open in Dreamweaver),
select an existing CFC function from the Function pop-up menu, or click the New Function button to create a new
function.
Note: The Function pop-up menu is only available if a CFC file is the current document and you have access to a
computer running ColdFusion MX 7 or better.
The recordset is defined in the function.
2Select a data source from the Data Source pop-up menu.
If no data source appears in the pop-up menu list, you will need to first create a ColdFusion data source.
3In the Username and Password boxes, enter the user name and password for the ColdFusion application server if
required.
Data sources in ColdFusion may require a user name and password to access them. If you do not have the user name
and password to access a data source in ColdFusion, contact your organization’s ColdFusion administrator.
4Enter a SQL statement in the SQL text area or use the graphical Database Items tree at the bottom of the dialog
box to build a SQL statement from the chosen recordset.
5(Optional) Do the following to use the Database Items tree to build the SQL statement:
•Ensure the SQL text area is blank.
•Expand the branches of the tree until you find the database object you need—for example, a column in a table.
•Select the database object and click one of the buttons on the right side of the tree.
For example, if you select a table column, the available buttons are Select, Where, and Order By. Click one of the
buttons to add the associated clause to your SQL statement.
If your SQL statement contains parameters, define their values in the Parameters area by clicking the Plus (+) button
and entering the parameter’s name and default value (the value the parameter should take if no run-time value is
returned).
If the SQL statement contains parameters, make sure the Default Value column of the Parameters box contains valid
test values.
The Page Parameters allow you to provide default values for run-time value references in the SQL you write. For
example, the following SQL statement selects an employee record based on the value of the employee’s ID. You can
assign a default value to this parameter, ensuring that a run-time value is always returned. In this example,
FormFieldName refers to a form field in which the user enters an employee ID:
SELECT * FROM Employees WHERE EmpID = + (Request.Form(#FormFieldName#))
The Add Page Parameters dialog box would contain a name-value pairing similar to:
The run-time value is usually a URL or form parameter entered by a user in an HTML form field.
6Click Test to connect to the database and create an instance of the recordset.
Name Default values
FormFieldName 0001
September 4, 2007
DREAMWEAVER CS3
User Guide
554
If the SQL statement contains run-time references, make sure the Default Value column of the Page Parameters field
contains valid test values before clicking Test.
If successful, a table appears displaying the data in your recordset. Each row contains a record and each column
represents a field in that record. Click OK to clear the recordset.
7If satisfied with your work, click OK.
Options for the advanced DataSet dialog box (ASP.NET)
DefineaDataSetasasourceofdynamiccontentbywritingacustomSQLstatement,orbycreatingaSQLstatement
using the Database Items tree.
1In the Name box, enter a name for the DataSet.
A common practice is to add the prefix ds to DataSet names to distinguish them from other object names in your
code. For example: dsPressRelease
DataSet names can only contain letters, numbers, and the underscore character (_). You cannot use special
characters or spaces.
2Select a connection from the Connection pop-up menu.
3EnteraSQLstatementintheSQLtextareaorusetheDatabaseItemstreeatthebottomofthedialogboxtobuild
a SQL statement from the chosen database tables.
Do the following to use the Database Items tree to build the SQL statement:
•Ensure the SQL text area is blank.
•Expand the branches of the tree until you find the database object you need—a column in a table, for example, or
a stored procedure in the database.
•Select the database object, and click one of the buttons on the right side of the tree.
For example, if you select a table column, the available buttons are SELECT, WHERE, and ORDER BY. Click one of
the buttons to add the associated clause to your SQL statement.
You can also use a predefined SQL statement in a stored procedure by selecting the stored procedure from the
Database Items tree and clicking the Procedure button. Dreamweaver automatically fills in the SQL and Parameters
areas.
4You can specify a page to redirect users to if the DataSet query should for some reason fail. For example, if the
database were to become unavailable during a query and failed to return the DataSet for the page, you could display
an error page with a link to the site’s home page.
5If the SQL statement contains parameters, define their values in the Parameters area by clicking the Plus (+)
button and entering the parameter’s name and default value (the value the parameter should take if no run-time
value is returned).
If the SQL statement contains parameters, make sure the Default Value column of the Parameters box contains valid
test values.
The Page Parameters allow you to provide default values for run-time value references in the SQL you write. For
example, the following SQL statement selects an employee record based on the value of the employee’s ID. You can
assign a default value to this parameter, ensuring that a run-time value is always returned. In this example,
FormFieldName refers to a form field in which the user enters an employee ID.
“SELECT * FROM Employees WHERE EmpID = “ + (Request.Form(“FormFieldName”))
The Add Page Parameters dialog box would contain a name-value pairing similar to:
September 4, 2007
DREAMWEAVER CS3
User Guide
555
The run-time value is usually a URL or form parameter entered by a user in an HTML form field.
6Click Test to connect to the database and create an instance of the recordset.
If the SQL statement contains run-time references, make sure the Default Value column of the Page Parameters field
contains valid test values before clicking Test.
If successful, a table appears displaying the data in your DataSet. Each row contains a record and each column repre-
sents a field in that record. Click OK to clear the DataSet.
7If satisfied with your work, click OK.
Define parameters in a SQL statement (ColdFusion, ASP.NET)
Define parameters in a SQL statement; the default value is the value that the parameter should use if no run-time
value is returned.
1Select a parameter name from the Name pop-up menu.
2Enter a default value for the parameter in the Default Parameter box, and click OK.
Define parameters in a SQL statement (PHP)
Define parameters in a SQL statement; the default value is the value that the parameter should use if no run-time
value is returned.
1Enter a parameter name in the Name box.
2Enter a default value for the parameter in the Default Parameter box.
3Enter a run-time value for a parameter in the Run-time Value box, and click OK.
Create SQL queries using the Database Items tree
Instead of manually typing SQL statements into the SQL box, you can use the Database Item’s point-and-click
interface to create complex SQL queries. The Database Items tree lets you select database objects and link them using
the SQL SELECT, WHERE, and ORDER BY clauses. After you create a SQL query, you can define any variables using
the Variables area of the dialog box.
The next two examples describe two SQL statements and the steps for creating them using the advanced Recordset
dialog box’s Database Items tree.
Example: Selecting a table
This example selects the entire contents of the Employees table. The SQL statement defining the query appears as
follows:
SELECT * FROM Employees
To create this query, follow these steps.
1Expand the Tables branch to display all of the tables in the selected database.
2Select the Employees table.
3Click the Select button.
Name Default value
FormFieldName 0001
September 4, 2007
DREAMWEAVER CS3
User Guide
556
4Click OK to add the recordset to the Bindings panel.
Example: Selecting specific rows from a table and ordering the results
ThefollowingexampleselectstworowsfromtheEmployeestable,andselectsthejobtypeusingavariablethatyou
must define. The results are then ordered by employee name.
SELECT emplNo, emplName
FROM Employees
WHERE emplJob = 'varJob'
ORDER BY emplName
1Expand the Tables branch to display all of the tables in the selected database; then expand the Employees table to
display the individual table rows.
2Build the SQL statement as follows:
•Select emplNo, and click the Select button.
•Select emplName, and click the Select button.
•Select emplJob, and click the Where button.
•Select emplName, and click the Order By button.
3Place the insertion point after WHERE emplJob in the SQL text area and type ='varJob' (include the equal sign).
4Define the variable 'varJob' by clicking the Plus (+) button in the Variables area and entering the following
values in the Name, Default Value, and Run-Time Value columns: varJob,CLERK,Request("job").
5Click OK to add the recordset to the Bindings panel.
Define URL parameters
URL parameters store retrieved information input by users. Before you begin, make sure you pass a form or URL
parameter to the server. After you define the URL variable, you can use its value in the currently selected page.
1In the Document window, open the page that will use the variable.
2Select Windows > Bindings to display the Bindings panel.
3In the Bindings panel, click the Plus (+) button and select one of the following from the pop-up menu:
4In the URL Variable dialog box, enter the name of the URL variable in the box, and click OK.
The URL variable name is normally the name of the HTML form field or object used to obtain its value.
5The URL variable appears in the Bindings panel.
Document Types Menu item in Bindings panel for URL variable
ASP Request Variable > Request.QueryString
ColdFusion URL Variable
JSP Request Variable
PHP URL Variable
September 4, 2007
DREAMWEAVER CS3
User Guide
557
See also
“About URL and form parameters” on page 544
“Adding dynamic content to pages” on page 564
“URL parameters” on page 533
“ColdFusion server variables” on page 545
“URL parameters” on page 533
Define form parameters
Form parameters store retrieved information that is included in the HTTP request for a web page. If you create a
form that uses the POST method, the data submitted by the form is passed to the server. Before you begin, make sure
you pass a form parameter to the server. After you define the form parameter as a content source, you can use its
value in your page.
1In the Document window, open the page that will use the variable.
2Select Windows > Bindings to display the Bindings panel.
3In the Bindings panel, click the Plus (+) button and select one of the following from the pop-up menu:
4IntheFormVariabledialogbox,enterthenameoftheformvariable,andclickOK.Theformparameternameis
normally the name of the HTML form field or object used to obtain its value.
The form parameter appears in the Bindings panel.
See also
“About dynamic content sources” on page 543
“About URL and form parameters” on page 544
“Define server variables” on page 559
Document Types Menu item in Bindings panel for form variable
ASP Request Variable > Request.Form
ColdFusion Form Variable
JSP Request Variable
PHP Form Variable
September 4, 2007
DREAMWEAVER CS3
User Guide
558
Define session variables
You can use session variables to store and display information maintained for the duration of a user’s visit (or
session). The server creates a different session object for each user and maintains it for a set period of time or until
the object is explicitly terminated.
Before defining session variables for a page, you must create them in the source code. After you create a session
variable in the web application’s source code, you can use Dreamweaver to retrieve its value and use it in a web page.
1Create a session variable in the source code, and assign a value to it.
For example, this ColdFusion example instantiates a session called username, and assigns it the value Cornelius:
<CFSET session.username = Cornelius>
2Select Window > Bindings to display the Bindings panel.
3Click the Plus (+) button, and select Session Variable from the pop-up menu.
4Enter the name of the variable you defined in the application’s source code, and click OK.
See also
“Collecting data submitted by users” on page 532
“Accessing data stored in session variables” on page 535
“How session variables work” on page 535
“Collecting, storing, and retrieving information in session variables” on page 535
Define application variables for ASP and ColdFusion
In ASP and ColdFusion, you can use application variables to store and display information that is maintained for the
lifetime of the application and persists from user to user. After you define the application variable, you can use its
value in a page.
Note: There are no application variable objects in JSP or PHP.
1Open a dynamic document type in the Document window.
2Select Window > Bindings to display the Bindings panel.
3Click the Plus (+) button, and select Application Variable from the pop-up menu.
4Enter the name of the variable as defined in the application’s source code, and click OK.
The application variable appears in the Bindings panel under the Application icon.
September 4, 2007
DREAMWEAVER CS3
User Guide
559
See also
“About adding dynamic content” on page 564
“Define server variables” on page 559
Use a variable as a data source for a ColdFusion recordset
When you define a recordset for a page in the Bindings panel, Dreamweaver enters the name of the ColdFusion data
source in the cfquery tag on the page. For more flexibility, you can store a data source name in a variable and use
the variable in the cfquery tag. Dreamweaver provides a visual method of specifying such a variable in your
recordsets.
1Make sure a ColdFusion page is active in the Document window.
2In the Bindings panel, click the Plus (+) button and select Data Source Name Variable from the pop-up menu.
The Data Source Name Variable dialog box appears.
3Define a variable, and click OK.
4When defining the recordset, select the variable as the Data Source for the recordset.
In the Recordset dialog box, the variable appears in the Data Source pop-up menu along with the ColdFusion data
sources on the server.
5Complete the Recordset dialog box, and click OK.
6Initialize the variable.
Dreamweaver does not initialize the variable for you so that you can initialize it how and where you want. You can
initialize the variable in the page code (before the cfquery tag), in an include file, or in some other file as a session
or application variable.
Define server variables
You define server variables as sources of dynamic content for use within a web application. Server variables vary from
document type to document type and include form variables, URL variables, session variables, and application
variables.
Server variables can be accessed by all clients that access the server, and by any applications running on the server.
The variables persist until the server is stopped.
See also
“Adding dynamic content to pages” on page 564
“URL parameters” on page 533
“HTML form parameters” on page 532
“ColdFusion server variables” on page 545
Define ColdFusion server variables
1Open the Bindings panel (Window > Bindings). In the Server Variable dialog box, enter the name of the server
variable, and click OK.
2Click the Plus (+) button and select the server variable from the pop-up menu.
3Enter the name of the variable, and click OK. The ColdFusion server variable appears in the Bindings panel.
September 4, 2007
DREAMWEAVER CS3
User Guide
560
The following table lists the built-in ColdFusion server variables:
Define a ColdFusion local variable
Local variables are variables created with the CFSET or CFPARAM tag within a ColdFusion page. The defined local
variable appears in the Bindings panel.
❖In the Local Variable dialog box, enter the name of the local variable and click OK.
Define ASP server variables
You can define the following ASP server variables as sources of dynamic content: Request.Cookie,
Request.QueryString,Request.Form,Request.ServerVariables, and Request.ClientCertificates.
1Open the Bindings panel (Window > Bindings).
2Click the Plus (+) button, and select Request Variable from the pop-up menu.
3In the Request Variable dialog box, select one of the following request collections from the Type pop-up menu:
The QueryString collection Retrieves information appended to the sending page’s URL, such as when the page has
an HTML form using the GET method. The query string consists of one or more name-value pairs (for example,
last=Smith,first=Winston) appended to the URL with a question mark (?). If the query string has more than
one name-value pair, they are combined with ampersands (&).
The Form collection Retrieves form information included in the body of the HTTP request by an HTML form using
the POST method.
The ServerVariables collection Retrieves the values of predefined environment variables. The collection has a long
list of variables, including CONTENT_LENGTH (the length of content submitted in the HTTP request, which you can
use to see if a form is empty), and HTTP_USER_AGENT (provides information about the user’s browser).
For example, Request.ServerVariables("HTTP_USER_AGENT") contains information about the submitting
browser, such as Mozilla/4.07 [en] (WinNT; I), which denotes a Netscape Navigator 4.07 browser.
For a complete list of ASP server environment variables, see the online documentation installed with Microsoft
Personal Web Server (PWS) or Internet Information Server (IIS).
Variable Description
Server.ColdFusion.Product-
Name
ColdFusion product name.
Server.ColdFusion.Product-
Version
ColdFusion version number.
Server.ColdFusion.ProductLev
el
ColdFusion edition (Enterprise, Professional).
Server.ColdFusion.Serial-
Number
Serial number of currently installed version of ColdFusion.
Server.OS.Name Name of operating system running on the server (Windows XP, Windows
2000, Linux).
Server.OS.AdditionalInforma-
tion
Additional information about installed operating system (service packs,
updates).
Server.OS.Version Version of installed operating system.
Server.OS.BuildNumber Build number of installed operating system.
September 4, 2007
DREAMWEAVER CS3
User Guide
561
The Cookies collection Retrieves the values of the cookies sent in an HTTP request. For example, suppose the page
reads a cookie called "readMe" on the user’s system. On the server, the values of the cookie are stored in the variable
Request.Cookies("readMe").
The ClientCertificate collection Retrieves the certification fields from the HTTP request sent by the browser. The
certification fields are specified in the X.509 standard.
4Specify the variable in the collection that you want to access, and click OK.
For example, if you want to access the information in the Request.ServerVariables("HTTP_USER_AGENT")
variable, enter the argument HTTP_USER_AGENT. If you want to access the information in the
Request.Form("lastname") variable, enter the argument lastname.
The request variable appears in the Bindings panel.
Define PHP and JSP server variables
Define server variables as a source of dynamic content for PHP document types and JSP pages. The PHP and JSP
server variables appear in the Bindings panel.
1Open the Bindings panel (Window > Bindings).
2Click the Plus (+) button, and select the variable from the pop-up menu.
The JSP request variable is typically a form or URL parameter. If the parameter was passed by an HTML form, the
variable name is the name of the form field or object used to obtain its value.
3In the Request Variable dialog box, enter the name of the variable, and click OK.
Define a ColdFusion client variable
Define a ColdFusion client variable as a source of dynamic content for the page. The newly defined ColdFusion client
variables appear in the Bindings panel.
❖In the Client Variable dialog box, enter the name of the variable, and click OK.
For example, to access the information in the Client.LastVisit ColdFusion variable, enter LastVisit.
Client variables are variables created in the code to associate data with a specific client. Client variables maintain the
application’s state as the user moves from page to page within the application, as well as from session to session.
Client variables can be user-defined or built-in. The following table lists the built-in ColdFusion client variables:
Variable Description
Client.CFID An incremental ID for each client that connects to the server.
Client.CFTOKEN A randomly generated number used to uniquely identify a particular
client.
Client.URLToken A combination of CFID and CFTOKEN to be passed between templates
when cookies are not used.
Client.LastVisit Records the timestamp of the last visit made by a client.
Client.HitCount The number of page requests tied to a single client (tracked using CFID and
CFTOKEN).
Client.TimeCreated Records the timestamp when CFID and CFTOKEN were first created for a
particular client.
September 4, 2007
DREAMWEAVER CS3
User Guide
562
Define a ColdFusion cookie variable
Cookie variables are created in the code, and access information contained in cookies passed to the server by a
browser. The defined cookie variable appears in the Bindings panel.
❖In the Cookie Variable dialog box, enter the name of the cookie variable, and click OK.
Define a ColdFusion CGI variable
The defined CGI variable appears in the Bindings panel.
❖In the CGI Variable dialog box, enter the name of the variable, and click OK.
For example, if you want to access the information in the CGI.HTTP_REFERER variable, enter HTTP_REFERER.
The following table lists the most common ColdFusion CGI variables that are created on the server:
Variable Description
SERVER_SOFTWARE The name and version of the information server software answering the request
(and running the gateway). Format: name/version.
SERVER_NAME The server's hostname, DNS alias, or IP address as it appears in self-referencing URLs.
GATEWAY_INTERFACE The revision of the CGI specification to which this server complies. Format: CGI/revi-
sion.
SERVER_PROTOCOL The name and revision of the information protocol this request came in with. Format:
protocol/revision.
SERVER_PORT The port number to which the request was sent.
REQUEST_METHOD The method with which the request was made. For HTTP, this is Get, Head, Post, and
so on.
PATH_INFO The extra path information, as given by the client. Scripts can be accessed by their
virtual pathname, followed by extra information at the end of this path. The extra
information is sent as PATH_INFO.
PATH_TRANSLATED The server provides a translated version of PATH_INFO, which takes the path and
does any virtual-to-physical mapping to it.
SCRIPT_NAME A virtual path to the script being executed; used for self-referencing URLs.
QUERY_STRING The query information that follows the question mark (?) in the URL that referenced
this script.
REMOTE_HOST The hostname making the request. If the server does not have this information, it
sets REMOTE_ADDR and does not set REMOTE_HOST.
REMOTE_ADDR The IP address of the remote host making the request.
AUTH_TYPE If the server supports user authentication, and the script is protected, this is the
protocol-specific authentication method used to validate the user.
REMOTE_USER AUTH_USER If the server supports user authentication, and the script is protected, this is the user
name they have authenticated as. (Also available as AUTH_USER.)
REMOTE_IDENT If the HTTP server supports RFC 931 identification, this variable is set to the remote
user name retrieved from the server. Use this variable for logging only.
CONTENT_TYPE For queries that have attached information, such as HTTP POST and PUT, this is the
content type of the data.
CONTENT_LENGTH The length of the content as given by the client.
September 4, 2007
DREAMWEAVER CS3
User Guide
563
The following table lists the most common CGI variables created by the browser and passed to the server:
Cache content sources
You can cache—or store—sources of dynamic content in a Design Note. This lets you work on a site even if you don’t
have access to the database or application server storing the sources of dynamic content. Caching may also speed up
development by eliminating repeated access across a network to the database and application server.
❖Click the arrow button in the top right corner of the Bindings panel and toggle Cache in the pop-up menu.
If you make changes to one of the content sources, you can refresh the cache by clicking the Refresh button (the
circle-arrow icon) in the upper-right corner of the Bindings panel. (Expand the panel if you don’t see the button.)
Change or delete content sources
You can change or delete any existing source of dynamic content—that is, any content source listed in the Bindings
panel.
Changing or deleting a content source in the Bindings panel does not change or delete any instance of that content
on the page. It merely changes or deletes it as a possible source of content for the page.
Change a content source in the Bindings panel
1In the Bindings panel (Window > Bindings), double-click the name of the content source you want to edit.
2Make your changes in the dialog box that appears.
3If satisfied with your work, click OK.
Delete a content source from the Bindings panel
1In the Bindings panel (Window > Bindings), select the content source from the list.
2Click the Minus (-) button.
Copy a recordset from one page to another page
You can copy a recordset from one page to another within a defined site.
1Select the recordset in either the Bindings panel or the Server Behaviors panel.
2Right-click the recordset, and select Copy from the pop-up menu.
3Open the page you want to copy the recordset to.
4Right-click the Bindings panel or the Server Behaviors toolbar, and select Paste from the pop-up menu.
Variable Description
HTTP_REFERER The referring document. This is the document that linked to or submitted form data.
HTTP_USER_AGENT The browser the client is currently using to send the request. Format: soft-
ware/version library/version.
HTTP_IF_MODIFIED_SINCE The last time the page was modified. This variable is sent at the discretion of the
browser, usually in response to the server having sent the LAST_MODIFIED HTTP
header. It can be used to take advantage of browser-side caching.
September 4, 2007
DREAMWEAVER CS3
User Guide
564
See also
“About dynamic content sources” on page 543
“Change or delete content sources” on page 563
Adding dynamic content to pages
About adding dynamic content
After you define one or more sources of dynamic content, you can use the sources to add dynamic content on the
page. Content sources can include a column in a recordset, a value submitted by an HTML form, the value contained
in a server object, or other data.
In Dreamweaver, you can place dynamic content almost anywhere in a web page or its HTML source code. You can
place dynamic content at the insertion point, replace a text string, or insert it as an HTML attribute. For example,
dynamic content can define the src attribute of an image, or the value attribute of a form field.
You can add dynamic content to a page by selecting a content source in the Bindings panel. Dreamweaver inserts a
server-side script in the page’s code instructing the server to transfer the data from the content source to the page’s
HTML code when the page is requested by a browser.
There is often more than one way to make a given page element dynamic. For example, to make an image dynamic
you can use the Bindings panel, the Property inspector, or the Image command in the Insert menu.
By default, an HTML page can display only one record at a time. To display the other records in the recordset, you
canaddalinktomovethroughtherecordsoneatatime,oryoucancreatearepeatingregiontodisplaymorethan
one record on a single page.
See also
“Defining sources of dynamic content” on page 547
“Create a recordset navigation bar” on page 571
“Display multiple recordset results” on page 574
“Applying typographic and page layout elements to dynamic data” on page 570
“Use predefined data formats” on page 578
About dynamic text
Dynamic text adopts any text formatting applied to the existing text or to the insertion point. For example, if a
Cascading Style Sheet (CSS) style affects the selected text, the dynamic content replacing it is also affected by the
style. You can add or change the text format of dynamic content by using any of the Dreamweaver text formatting
tools.
You can also apply a data format to dynamic text. For example, if your data consists of dates, you can specify a
particular date format such as 04/17/00 for U.S. visitors, or 17/04/00 for Canadian visitors.
Make text dynamic
You can replace existing text with dynamic text, or you can place dynamic text at a given insertion point on the page.
September 4, 2007
DREAMWEAVER CS3
User Guide
565
See also
“About recordsets” on page 543
“Use predefined data formats” on page 578
Add dynamic text
1In Design view, select text on the page, or click where you want to add dynamic text.
2In the Bindings panel (Window > Bindings), select a content source from the list. If you select a recordset, specify
the column you want in the recordset.
The content source should contain plain text (ASCII text). Plain text includes HTML. If no content sources appear
in the list, or if the available content sources don’t meet your needs, click the Plus (+) button to define a new content
source.
3(Optional) Select a data format for the text.
4Click Insert, or drag the content source onto the page.
The dynamic content appears on the page if you’re working in Design view with Live Data enabled (View > Live
Data).
If Live Data is disabled, a placeholder appears instead. (If you selected text on the page, the placeholder replaces the
text selection.) The placeholder for recordset content uses the syntax {RecordsetName.ColumnName}, where
Recordset is the name of the recordset and ColumnName is the name of the column you chose from the recordset.
Sometimes, the length of the placeholders for dynamic text distorts the page’s layout in the Document window. You
can solve the problem by using empty curly braces as placeholders, as described in the next topic.
Display placeholders for dynamic text
1Select Edit > Preferences > Invisible Elements (Windows) or Dreamweaver > Preferences > Invisible Elements
(Macintosh).
2In the Show Dynamic Text As pop-up menu, select { }, and click OK.
Make images dynamic
You can make images on your page dynamic. For example, suppose you design a page to display items for sale at a
charity auction. Each page would include descriptive text and a photo of one item. The page’s general layout would
remain the same for each item, but the photo (and descriptive text) could change.
1WiththepageopeninDesignview(View>Design),placetheinsertionpointwhereyouwanttheimagetoappear
on the page.
2Select Insert > Image.
The Select Image Source dialog box appears.
3Click the Data Sources option (Windows) or the Data Source button (Macintosh).
A list of content sources appears.
4Select a content source from the list, and click OK.
The content source should be a recordset that contains the paths to your image files. Depending on the file structure
of your site, the paths can be absolute, document relative, or root relative.
Note: Dreamweaver does not currently support binary images stored in a database.
September 4, 2007
DREAMWEAVER CS3
User Guide
566
If no recordsets appear in the list, or if the available recordsets don’t meet your needs, define a new recordset.
See also
“Define a recordset without writing SQL” on page 547
Make HTML attributes dynamic
You can dynamically change the appearance of a page by binding HTML attributes to data. For example, you can
change the background image of a table by binding the table’s background attribute to a field in a recordset.
You can bind HTML attributes with the Bindings panel or with the Property inspector.
Make HTML attributes dynamic with the Bindings panel
1Open the Bindings panel by choosing Window > Bindings.
2Ensure that the Bindings panel lists the data source you want to use.
The content source should contain data that’s appropriate for the HTML attribute you want to bind. If no sources of
content appear in the list, or if the available content sources don’t meet your needs, click the Plus (+) button to define
a new data source.
3In Design view, select an HTML object.
For example, to select an HTML table, click inside the table and click the <table> tag in the tag selector on the
bottom-left of the Document window.
4In the Bindings panel, select a content source from your list.
5In the Bind To box, select an HTML attribute from the pop-up menu.
6Click Bind.
The next time the page runs on the application server, the value of the data source will be assigned to the HTML
attribute.
Make HTML attributes dynamic with the Property inspector
1In Design view, select an HTML object and open the Property inspector (Window > Properties).
For example, to select an HTML table, click inside the table and click the <table> tag in the tag selector on the
bottom-left of the Document window.
2How you bind a dynamic content source to the HTML attribute depends on where it is located.
•If the attribute you want to bind has a folder icon next to it in the Property inspector, click the folder icon to open
a file selection dialog box; then click the Data Sources option to display a list of data sources.
•Iftheattributeyouwanttobinddoesnothaveafoldericonnexttoit,clicktheListtab(thelowerofthetwotabs)
on the left side of the inspector.
The Property inspector’s List view appears.
•If the attribute you want to bind is not listed in the List view, click the Plus (+) button; then enter the attribute’s
name or click the small arrow button and select the attribute from the pop-up menu.
3To make the attribute’s value dynamic, click the attribute; then click the lightning-bolt icon or folder icon at the
end of the attribute’s row.
If you clicked the lightning bolt icon, a list of data sources appears.
September 4, 2007
DREAMWEAVER CS3
User Guide
567
If you clicked the folder icon, a file selection dialog box appears. Select the Data Sources option to display a list of
content sources.
4Select a source of content from the list of content sources, and click OK.
The content source should hold data that’s appropriate for the HTML attribute you want to bind. If no content
sources appear in the list, or if the available content sources don’t meet your needs, define a new content source.
The next time the page runs on the application server, the value of the data source will be assigned to the HTML
attribute.
Make ActiveX, Flash, and other object parameters dynamic
You can make the parameters of Java applets and plug-ins dynamic, as well as the parameters of ActiveX, Flash,
Shockwave, Director, and Generator objects.
Before starting, make sure the fields in your recordset hold data that’s appropriate for the object parameters you want
to bind.
1In Design view, select an object on the page and open the Property inspector (Window > Properties).
2Click the Parameters button.
3If your parameter does not appear in the list, click the Plus (+) button and enter a parameter name in the
Parameter column.
4Click the parameter’s Value column, and then click the lightning-bolt icon to specify a dynamic value.
A list of data sources appears.
5Select a data source from the list, and click OK.
The data source should hold data that’s appropriate for the object parameter you want to bind. If no data sources
appear in the list, or if the available data sources don’t meet your needs, define a new data source.
See also
“Data sources for web applications” on page 531
Changing dynamic content
About dynamic content
You can change the dynamic content on your page by editing the server behavior that provides the content. For
example, you can edit a recordset server behavior to provide more records to your page.
Dynamic content on a page is listed in the Server Behaviors panel. For example, if you add a recordset to your page,
the Server Behaviors panel lists it as follows:
Recordset(myRecordset)
If you add another recordset to your page, the Server Behaviors panel lists both recordsets as follows:
Recordset(mySecondRecordset)Recordset(myRecordset)
September 4, 2007
DREAMWEAVER CS3
User Guide
568
Edit dynamic content
1Open the Server Behaviors panel (Window > Server Behaviors).
2Click the Plus (+) button to display the server behaviors, and double-click the server behavior in the panel.
The dialog box that you used to define the original data source appears.
3Make your changes in the dialog box, and click OK.
Delete dynamic content
❖After adding dynamic content to a page, delete it in one the following ways:
•Select the dynamic content on the page, and press Delete.
•Select the dynamic content in the Server Behaviors panel, and click the Minus (-) button.
Note: Thisoperationremovestheserver-sidescriptinthepagethatretrievesthedynamiccontentfromthedatabase.It
does not delete the data in the database.
Test dynamic content
You can preview and edit dynamic content using the Live Data window.
Note: Links don’t work in the Live Data window. To test your links, use the Dreamweaver Preview in Browser feature.
While dynamic content is displayed, you can perform the following tasks:
•Adjust the page’s layout using the page-design tools
•Add, edit, or delete dynamic content
•Add, edit, or delete server behaviors
To achieve this effect, Dreamweaver runs the dynamic page on your server before displaying it in the Live Data
window. Whenever you switch to the Live Data window, a temporary copy of the open document is sent to your
application server for processing. The resulting page is returned and displayed in the Live Data window, and the
temporary copy on the server is deleted.
You can toggle between the Document window and the Live Data window (View > Live Data). If a page expects data
from the user—for example, the ID number of a record selected in a master page—you can provide the page with
that data yourself in the Live Data Settings dialog box.
1Make the necessary changes to the page.
2If your page expects URL parameters from an HTML form using the GET method, enter the name-value pairs in
the box in the toolbar, and click the Refresh button (the circle-arrow icon).
Enter the test data in the following format:
name=value;
In this format, name is the URL parameter’s name expected by your page and value is the value held by that
parameter.
You can also define name-value pairs in the Live Data Settings dialog box (View > Live Data Settings) and save them
with the page.
3Click the Refresh button if your page needs refreshing.
September 4, 2007
DREAMWEAVER CS3
User Guide
569
See also
“Provide the page with expected parameters” on page 581
“View live data in Design view” on page 579
“HTML form parameters” on page 532
“URL parameters” on page 533
“How session variables work” on page 535
Let Adobe Contribute users edit dynamic content
When a Contribute user edits a page containing dynamic content or invisible elements (such as scripts and
comments), Contribute displays the dynamic content and invisible elements as yellow markers. By default,
Contribute users can’t select or delete these markers.
IfyouwantContributeuserstobeabletoselectanddeletedynamiccontentandotherinvisibleelementsfromapage,
you can change permission-group settings to allow them to do so; Contribute users normally can never edit dynamic
content, even when you allow them to select it.
Note: Using some server technologies, you can display static text using a server tag or function. To allow Contribute users
to edit the static text in a dynamic page that uses such a server technology, place the static text outside of the server tags.
For more information, see Administering Adobe Contribute.
1Select Site > Administer Contribute Site.
2If certain required options for Contribute compatibility aren’t enabled, a dialog box appears, asking if you want to
enable those options. Click OK to enable those options and Contribute compatibility.
3If prompted, enter the administrator password, and then click OK.
The Administer Website dialog box appears.
4In the Users And Roles category, select a role, and then click the Edit Role Settings button.
5Select the Editing category, and deselect the option to protect scripts and forms.
6Click OK to close the Edit Settings dialog box.
7Click Close to close the Administer Website dialog box.
See also
“Managing Contribute sites with Dreamweaver” on page 56
“Create a template for a Contribute site” on page 397
Modify recordsets with the Property inspector
Use the Property inspector is to modify the selected recordset. The available options vary depending on the server
model.
1Open the Property inspector (Window > Properties) and then select the recordset in the Server Behaviors panel
(Window > Server Behavior).
2Edit any of the options. When you select a new option in the inspector, Dreamweaver updates the page.
September 4, 2007
DREAMWEAVER CS3
User Guide
570
See also
“Edit dynamic content” on page 568
Displaying database records
About database records
Displaying database records involves retrieving information stored in a database or other source of content, and
renderingthatinformationtoawebpage.Dreamweaverprovidesmanymethodsofdisplayingdynamiccontent,and
provides several built-in server behaviors that let you both enhance the presentation of dynamic content, and allow
users to more easily search through and navigate information returned from a database.
Databases and other sources of dynamic content provide you with more power and flexibility in searching, sorting,
andviewinglargestoresofinformation.Usingadatabasetostorecontentforwebsitesmakessensewhenyouneed
to store large amounts of information, and then retrieve and display that information in a meaningful way.
Dreamweaver provides you with several tools and prebuilt behaviors to help you effectively retrieve and display
information stored in a database.
Server behaviors and formatting elements
Dreamweaver provides the following server behaviors and formatting elements to let you enhance the display of
dynamic data:
Formats let you apply different types of numerical, monetary, date/time, and percentage values to dynamic text.
For example, if the price of an item in a recordset reads 10.989, you can display the price on the page as $10.99 by
selecting the Dreamweaver “Currency - 2 Decimal Places” format. This format displays a number using two decimal
places. If the number has more than two decimal places, the data format rounds the number to the closest decimal.
If the number has no decimal places, the data format adds a decimal point and two zeros.
Repeating Region server behaviors let you display multiple items returned from a database query, and let you specify
the number of records to display per page.
Recordset Navigation server behaviors let you insert navigation elements that allow users to move to the next or
previous set of records returned by the recordset. For example, if you choose to display 10 records per page using the
Repeating Region server object, and the recordset returns 40 records, you can navigate through 10 records at a time.
Recordset Status Bar server behaviors let you include a counter that shows users where they are within a set of
records relative to the total number of records returned.
Show Region server behaviors let you choose to show or hide items on the page based on the relevance of the
currently displayed records. For example, if a user has navigated to the last record in a recordset, you can hide the
Next link, and display only the Previous records link.
Applying typographic and page layout elements to dynamic data
A powerful feature of Dreamweaver is the ability to present dynamic data within a structured page, and to apply
typographic formatting using HTML and CSS. To apply formats to dynamic data in Dreamweaver, format the tables
andplaceholdersforthedynamicdatausingtheDreamweaverformattingtools.Whenthedataisinsertedfromits
data source, it automatically adopts the font, paragraph, and table formatting you specified.
September 4, 2007
DREAMWEAVER CS3
User Guide
571
See also
“Presenting content with tables” on page 176
“Adding and formatting text” on page 226
Navigating database recordset results
Recordset navigation links let users move from one record to the next, or from one set of records to the next. For
example,afterdesigningapagetodisplayfiverecordsatatime,youmightwanttoaddlinkssuchasNext or Previous
that let users display the five next or previous records.
You can create four types of navigation links to move through a recordset: First, Previous, Next, and Last. A single
page can contain any number of these links, provided they all work on a single recordset. You can’t add links to move
through a second recordset on the same page.
Recordset navigation links require the following dynamic elements:
•A recordset to navigate
•Dynamic content on the page to display the record or records
•Text or images on the page to serve as a clickable navigation bar
•A Move To Record set of server behaviors to navigate the recordset
YoucanaddthelasttwoelementsbyusingtheRecordNavigationBarserverobject,oryoucanaddthemseparately
by using the design tools and the Server Behaviors panel.
Create a recordset navigation bar
YoucancreatearecordsetnavigationbarinasingleoperationusingtheRecordsetNavigationBarserverbehavior.
The server object adds the following building blocks to the page:
•An HTML table with either text or image links
•A set of Move To server behaviors
•A set of Show Region server behaviors
The text version of the Recordset Navigation Bar looks like this:
The image version of the Recordset Navigation Bar looks like this:
Before placing the navigation bar on the page, make sure the page contains a recordset to navigate and a page layout
in which to display the records.
After placing the navigation bar on the page, you can use the design tools to customize the bar to your liking. You
can also edit the Move To and Show Region server behaviors by double-clicking them in the Server Behaviors panel.
Dreamweaver creates a table that contains text or image links that allow the user to navigate through the selected
recordsetwhenclicked.Whenthefirstrecordintherecordsetisdisplayed,theFirst and Previous links or images are
hidden. When the last record in the recordset is displayed, the Next and Last links or images are hidden.
September 4, 2007
DREAMWEAVER CS3
User Guide
572
You can customize the layout of the navigation bar by using the design tools and the Server Behaviors panel.
1In Design view, place the insertion point at the location on the page where you want the navigation bar to appear.
2Display the Recordset Navigation Bar dialog box (Insert > Data Objects > Recordset Paging > Recordset
Navigation Bar).
3Select the recordset you want to navigate from the Recordset pop-up menu.
4From the Display Using section, select the format to display the navigation links on the page, and click OK.
Text Places text links on the page.
Images Includes graphical images as links. Dreamweaver uses its own image files. You can replace these images with
image files of your own after placing the bar on the page.
Custom recordset navigation bars
You can create your own recordset navigation bar that uses more complex layout and formatting styles than the
simple table created by the Recordset Navigation Bar server object.
To create your own recordset navigation bar, you must:
•Create navigation links in text or images
•Place the links in the page in Design view
•Assign individual server behaviors to each navigation link
This section describes how to assign individual server behaviors to the navigation links.
Create and assign server behaviors to a navigation link
1In Design view, select the text string or image on the page you want to use as a record navigation link.
2Open the Server Behaviors panel (Window > Server Behaviors), and click the Plus (+) button.
3Select Recordset Paging from the pop-up menu; then select a server behavior appropriate to that link from the
listed server behaviors.
If the recordset contains a large number of records, the Move To Last Record server behavior can take a long time to
run when the user clicks the link.
4In the Recordset pop-up menu, select the recordset that contains the records, and click OK.
The server behavior is assigned to the navigation link.
Set the Move To (server behavior) dialog box options
Add links that let the user navigate through records in a recordset.
1If you didn’t select anything on the page, select a link from the pop-up menu.
2Select the recordset that contains the records to page through, and click OK.
Note: If the recordset contains a large number of records, the Move To Last Record server behavior can take a long time
to run when the user clicks the link.
Navigation bar design tasks
When creating a custom navigation bar, begin by creating its visual representation using the Dreamweaver page-
design tools. You don’t have to create a link for the text string or image, Dreamweaver creates one for you.
September 4, 2007
DREAMWEAVER CS3
User Guide
573
The page you create the navigation bar for must contain a recordset to navigate. A simple recordset navigation bar
might look like this, with link buttons created out of images, or other content elements:
After you have added a recordset to a page, and have created a navigation bar, you must apply individual server
behaviorstoeachnavigationelement.Forexample,atypicalrecordsetnavigationbarcontainsrepresentationsofthe
following links matched to the appropriate behavior:
See also
“About recordsets” on page 543
Display and hide regions based on recordset results
You can also specify that a region be displayed or hidden based on whether the recordset is empty. If a recordset is
empty (for example, no records were found matching the query), you can display a message informing the user that
no records were returned. This is especially useful when creating search pages that rely on user input search terms
torunqueriesagainst.Similarly,youcandisplayanerrormessageifthereisaproblemconnectingtoadatabase,or
if a user’s user name and password do not match those recognized by the server.
The Show Region server behaviors are:
•Show If Recordset Is Empty
•Show If Recordset Is Not Empty
•Show If First Page
•Show If Not First Page
•Show If Last Page
•Show If Not Last Page
1In Design view, select the region on the page to show or hide.
2In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button.
3Select Show Region from the pop-up menu, select one of the listed server behaviors, and click OK.
See also
“About database records” on page 570
“Create a dynamic table” on page 575
Navigation link Server behavior
Go to first page Move to first page
Go to previous page Move to previous page
Go to next page Move to next page
Go to last page Move to last page
September 4, 2007
DREAMWEAVER CS3
User Guide
574
Display multiple recordset results
The Repeating Region server behavior lets you display multiple records from a recordset within a page. Any dynamic
data selection can be turned into a repeating region. However, the most common regions are a table, a table row, or
a series of table rows.
1In Design view, select a region that contains dynamic content.
The selection can be anything, including a table, a table row, or even a paragraph of text.
To select a region on the page precisely, you can use the tag selector on the left corner of the document window. For
example, if the region is a table row, click inside the row on the page, then click the rightmost <tr> tag in the tag
selector to select the table row.
2Select Window > Server Behaviors to display the Server Behaviors panel.
3Click the Plus (+) button, and select Repeating Region.
4Select the name of the recordset to use from the pop-up menu.
5Select the number of records to display per page, and click OK.
In the Document window, a thin, tabbed, gray outline appears around the repeating region. In the Live Data window
(View > Live Data), the gray outline disappears and the selection expands to display the number of records you
specified.
See also
“About database records” on page 570
“Edit dynamic content” on page 568
Modify repeating regions in the Property inspector
❖Modify the selected repeating region by changing any of the following options:
•The name of the repeating region.
•The recordset providing the records for the repeating region.
•The number of records displayed
When you select a new option, Dreamweaver updates the page.
Create and add a repeating region to display multiple records on a page
1Specify the recordset that contains the data to display in the repeating region.
2Specify the number of records to display per page, and click OK.
If you specify a limited number of records per page and it’s possible the number of records requested might exceed
it, add record navigation links to let users display the other records.
September 4, 2007
DREAMWEAVER CS3
User Guide
575
Create a dynamic table
The following example illustrates how the Repeating Region server behavior is applied to a table row, and specifies
that nine records are displayed per page. The row itself displays four different records: city, state, street address, and
ZIP code.
To create a table such as the one in the previous example, you must create a table that contains dynamic content, and
apply the Repeating Region server behavior to the table row containing the dynamic content. When the page is
processed by the application server, the row is repeated the number of times specified in the Repeating Region server
object, with a different record inserted in each new row.
Note: The Dynamic Table server object is not available when using ASP.NET document types.
1Do one of the following to insert a dynamic table:
•Select Insert > Data Objects > Dynamic Data > Dynamic Table to display the Dynamic Table dialog box.
•From the Data category of the Insert bar, click the Dynamic Data button and select the Dynamic Table icon from
the pop-up menu.
2Select the recordset from the Recordset pop-up menu.
3Select the number of records to display per page.
4(Optional) Input values for the table border, cell padding, and cell spacing.
The Dynamic Table dialog box retains the values you enter for table borders, cell padding, and cell spacing.
Note: If you are working on a project that requires several dynamic tables with the same appearance, enter the table
layout values, which further simplifies page development. You can adjust these values after inserting the table by using
the table Property inspector.
5Click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
576
A table and placeholders for the dynamic content defined in its associated recordset are inserted into the page.
In this example, the recordset contains four columns: AUTHORID, FIRSTNAME, LASTNAME, and BIO. The table’s
heading row is populated with the names of each column. You can edit the headings using any descriptive text, or
replace them with representative images.
Create record counters
Record counters give users a reference point when they are navigating through a set of records. Typically, record
counters display the total number of records returned, and the current records being viewed. For example, if a
recordset returns 40 individual records, and 8 records are displayed per page, the record counter on the first page
would indicate “Displaying records 1-8 of 40.”
Before you create a record counter for a page, you must create a recordset for the page, an appropriate page layout to
contain the dynamic content, and then a recordset navigation bar.
See also
“About recordsets” on page 543
“Create a recordset navigation bar” on page 571
“Display multiple recordset results” on page 574
“Create a dynamic table” on page 575
Create simple record counters
Record counters let users know where they are within a given set of records relative to the total number of records
returned. For this reason record counters are a useful behavior that can significantly add to the usability of a web
page.
Create a simple record counter by using the Recordset Navigation Status server object. This server object creates a
text entry on the page to display the current record status. You can customize the record counter by using
Dreamweaver page-design tools.
1Place the insertion point where you want to insert the record counter.
2Select Insert > Data Objects > Display Record Count > Recordset Navigation Status, select the recordset from the
Recordset pop-up menu, and click OK.
The Recordset Navigation Status server object inserts a text record counter that appears similar to the following
example:
When viewed in the Live Data window or a browser, the counter appears similar to the following example:
September 4, 2007
DREAMWEAVER CS3
User Guide
577
Build and add the record counter to the page
❖In the Insert Recordset Navigation Status dialog box, select the recordset to track, and click OK.
Create custom record counters
You use individual record count behaviors to create custom record counters. Creating a custom record counter lets
you create a record counter beyond the simple, single row table inserted by the Recordset Navigation Status server
object. You can arrange design elements in a number of creative ways, and apply an appropriate server behavior to
each element.
The Record Count server behaviors are:
•Display Starting Record Number
•Display Ending Record Number
•Display Total Records
Before you create a custom record counter for a page, you must first create a recordset for the page, an appropriate
page layout to contain the dynamic content, and a recordset navigation bar.
This example creates a record counter that appears similar to the example in “Simple record counters.” In this
example, the text in sans-serif font represents the record count placeholders that will be inserted in the page. The
record counter in this example appears as follows:
Displaying records StartRow through EndRow of RecordSet.RecordCount.
1In Design view, enter the counter’s text on the page. The text can be anything you want, for example:
Displaying records thru of .
2Place the insertion point at the end of the text string.
3Open the Server Behaviors panel (Window > Server Behaviors).
4Click the Plus (+) button in the upper-left corner, and click Display Record Count. Within this submenu, select
Display Total Records. The Display Total Records behavior is inserted into the page, and a placeholder is inserted
where the insertion point was. The text string now appears as follows:
Displaying records thru of {Recordset1.RecordCount}.
5Place the insertion point after the word records,andselecttheDisplayStartingRecordCountNumberfromthe
Server Behaviors > Plus (+) button > Record Count panel. The text string now appear as follows:
Displaying records {StartRow_Recordset1} thru of {Recordset1.RecordCount}.
6Now place the insertion point between the words thru and of, and select the Display Starting Record Count
Number from the Server Behaviors > Plus (+) button > Record Count panel. The text string now appear as follows:
Displaying records {StartRow_Recordset1} thru {EndRow_Recordset1}
of{Recordset1.RecordCount}.
7Confirm that the counter functions correctly by viewing the page in the Live Data window (View > Live Data);
the counter is similar to the following example:
Displaying records 1 thru 8 of 40.
If the results page has a navigation link to move to the next set of records, clicking the link updates the record counter
to read as follows:
Showing records 9 thru 16 of 40.
September 4, 2007
DREAMWEAVER CS3
User Guide
578
Linksdon’tworkintheLiveDatawindow.Totestthem,youcanusethePreviewinBrowserfeature.Ensurethatyou
selectthePreviewUsingLiveDataServeroptionisselectedinPreferences(Edit>Preferences>PreviewInBrowser
(Windows) or Dreamweaver > Preferences > Preview In Browser (Macintosh)); then select File > Preview In
Browser.
Display the current DataSet page number (ASP.NET)
A DataSet page in ASP.NET is a subset of records displayed in a DataGrid or DataList. You can insert code in your
ASP.NET page that displays the current DataSet page number. For example, if you display only 10 records in your
control and your DataSet contains 24 records, the DataSet has three pages (consisting of 10, 10, and 4 records).
1In the DataSet page, place the insertion point where you want the page number to appear.
2Select Insert > Data Objects > Display Record Count > Current Page Number.
3In the Display Current Page Number dialog box, select the DataSet and click OK.
Use predefined data formats
Dreamweaver includes several predefined data formats that you can apply to dynamic data elements. The data format
styles include date and time, currency, numerical, and percentage formats.
Apply data formats to dynamic content
1Select the dynamic content in either the Live Data window or its placeholder in the Document window.
2Select Window > Bindings to display the Bindings panel.
3Click the down arrow button in the Format column.
If the down arrow is not visible, expand the panel.
4From the Format pop-up menu, select the data format category you want.
Ensure that the data format is appropriate for the type of data you are formatting. For example, the Currency formats
work only if the dynamic data consists of numerical data. Note that you cannot apply more than one format to the
same data.
5Verify that the format was applied correctly by previewing the page in either the Live Data window or a browser.
Customize a data format
1Open a page that contains dynamic data in Design view.
2Select the dynamic data whose format you want to customize.
The bound data item whose dynamic text you selected is highlighted in the Bindings panel (Window > Bindings).
The panel displays two columns for the selected item—Binding and Format. If the Format column is not visible,
widen the Bindings panel to reveal it.
3In the Bindings panel, click the down arrow in the Format column to expand the pop-up menu of available data
formats.
If the down arrow is not visible, widen the Bindings panel more.
4Select Edit Format List from the pop-up menu.
5Complete the dialog box, and click OK.
aSelect the format from the list, and click Edit.
September 4, 2007
DREAMWEAVER CS3
User Guide
579
bChange any of the following parameters in the Currency, Number, or Percent dialog boxes, and click OK.
•The number of digits to display after the decimal point
•Whether to place a leading zero in front of fractions
•Whether to use parentheses or a minus sign for negative values
•Whether to group digits
cTo delete a data format, click the format in the list, and click the Minus (-) button.
Create a data format
1Open a page containing dynamic data in Design view.
2Select the dynamic data you want to create a custom format for.
3Select Window > Bindings to display the Bindings panel, and click the down arrow in the Format column. If the
down arrow is not visible, expand the panel.
4Select Edit Format List from the pop-up menu.
5Click the Plus (+) button, and select a format type.
Note: Dreamweaver only supports creating data formats for ASP and JSP server models. ColdFusion, PHP, and
ASP.NET users cannot create data formats from within Dreamweaver.
6Define the format, and click OK.
7Enter a name for the new format in the Name column, and click OK.
Note: If you are a ColdFusion, PHP, or ASP.NET extension developer, you can download formats that other developer
created, and create server formats and post them to the Dreamweaver Exchange. For more information on the Server
Format API, see Extending Dreamweaver (Help > Extending Dreamweaver > Server Formats).
Viewing live data
View live data in Design view
Dreamweaver can display the dynamic content of a page while you work on the page in Design view.
1Make sure Dreamweaver is properly configured to display live data.
For more information, see “Requirements for displaying live data” on page 580.
2Select View > Live Data.
The page appears in Design view complete with dynamic content.
When Live Data is enabled in Design view, you can do the following:
•Adjust the page’s layout using the page-design tools
•Add, edit, or delete dynamic content
•Add, edit, or delete server behaviors
Note: Links don’t work in Design view. To test your links, use the Preview In Browser feature.
Whenyoumakeachangetothepagethataffectsdynamiccontent,youcanrefreshthepagebyclickingtheRefresh
button (the circle-arrow icon). Dreamweaver can also refresh the page for you automatically.
September 4, 2007
DREAMWEAVER CS3
User Guide
580
The following example shows a dynamic page with Live Data disabled:
The following example shows the same page with Live Data turned on:
Requirements for displaying live data
To view live data in Design view, you must do the following:
•Define a folder to process dynamic pages.
When you enable Live Data, a temporary copy of the open document is sent to the folder for processing. The
resulting page is returned and displayed in Design view, and the temporary copy on the server is deleted.
If the page displays an error message when you enable Live Data, make sure the URL prefix in the Site Definition
dialog box is correct.
•Copy related files (if any) to the folder.
•Provide the page with any parameters a user would normally provide.
If you have difficulty getting Live Data view to work, see “Troubleshooting Live Data view” on page 582.
September 4, 2007
DREAMWEAVER CS3
User Guide
581
Provide a page with live data in Design view
1Open the Live Data Settings dialog box (View > Live Data Settings).
2In the URL Request area, click the Plus (+) button and enter a parameter your page expects.
3Specify a name and a test value for each parameter.
4In the Method pop-up menu, select the HTML form method your page expects: POST or GET.
5In the Initialization Script text area, include any source code you want to insert at the top of the page before it runs.
Initialization scripts usually consist of code that sets session variables.
6To save your settings for the current page, click Save Settings For This Document, and click OK.
Note: To save the settings, you must enable Design Notes (File > Design Notes).
See also
“Switch between views in the Document window” on page 24
“Previewing dynamic pages in a browser” on page 539
Copy dependent files
Some dynamic pages rely on other files to work properly. You must upload all related files, including server-side
includes and dependent files such as image files and JSP class files, to the folder you defined for processing dynamic
pages. Dreamweaver does not automatically copy dependent files to the folder when you enable Live Data in Design
view.
Note: Live Data supports code in server-side includes and application files such as global.asa (ASP) and application.cfm
(ColdFusion). Make sure to upload these files to the server before enabling Live Data.
1Open the Site panel (Window > Site Files), and click the Expand button (the last icon on the panel toolbar).
The Site panel expands to full size.
2Click the Application Server icon on the expanded Site panel toolbar (the second icon from the left).
The application server’s root folder appears under Remote Site.
3Under Local Folder, select the dependent files.
4Click the blue up arrow in the toolbar to copy the files to the application server, or drag the files to the appropriate
folder under Remote Site.
You need to do this only once for your site unless you add more dependent files, in which case you must also copy
them to the folder.
See also
“Setting up a web application” on page 501
Provide the page with expected parameters
To generate dynamic content, some pages require parameters from the user—for example, a page needs the ID
number of a record to find and display that record. Without that data, Dreamweaver cannot generate dynamic
content to display in Design view.
September 4, 2007
DREAMWEAVER CS3
User Guide
582
If a page expects parameters from the user, you must provide the parameters as follows.
1In the Document window, select Live Data Settings from the View menu.
2Complete the dialog box and click OK.
If you specify the GET method in the Live Data Settings dialog box, a text box appears on the Design view toolbar.
Use this box to enter different URL parameters; then click the Refresh button (the circle-arrow icon) to see how the
parameters affect the page.
Enter each URL parameter in the following format:
name=value;
In this format, name is the URL parameter name expected by your page and value is the value held by that
parameter.
See also
“URL parameters” on page 533
Refresh the page
•With Live Data enabled, click the Refresh button (the circle-arrow icon) on the document toolbar to refresh the
page after making a change that affects dynamic content.
•Select the Auto Refresh option in the toolbar to refresh the page whenever you make a change affecting dynamic
content. If you have a slow database connection, you might want to leave this option off when working in the Live
Data window.
Troubleshooting Live Data view
Many problems with Live Data view can be traced back to missing or incorrect values in the Site Definition dialog
box (Site > Edit Sites).
Check the Testing Server category of the Site Definition dialog box. The Remote Folder box should specify a folder
capable of processing dynamic pages. Here’s an example of a suitable remote folder if you’re running IIS or PWS on
your hard disk:
C:\Inetpub\wwwroot\myapp\
Verify that the URL Prefix box specifies a URL that corresponds (maps) to the remote folder. For example, if PWS
or IIS is running on your local computer, then the following remote folders have the following URL prefixes:
Remote folder URL prefix
C:\Inetpub\wwwroot\ http://localhost/
C:\Inetpub\wwwroot\myapp\ http://localhost/myapp/
C:\Inetpub\wwwroot\fs\planes http://localhost/fs/planes
September 4, 2007
DREAMWEAVER CS3
User Guide
583
Work in Design view without live data
If Live Data is disabled or if you’re temporarily disconnected from your application server, you can still work on your
dynamic pages in Design view. Dreamweaver uses placeholders to visually represent dynamic content on the page.
For example, the placeholder for dynamic text extracted from a database uses the syntax {Record-
setName.ColumnName},whereRecordset isthenameoftherecordsetandColumnName is the name of the column
you chose from the recordset.
Sometimes, the length of the placeholders for dynamic text distorts the page’s layout in Design view. You can solve
the problem by using empty curly braces as placeholders.
1Select Edit > Preferences > Invisible Elements, or Dreamweaver > Preferences > Invisible Elements (Mac OS X).
2In the Show Dynamic Text As pop-up menu, select {}, and click OK.
Using web services
About web services
Web services are an emerging technology that allow web pages to access distributed applications. By providing
functionality as a service that a web page connects to and uses as needed, web services give developers and service
providers greater flexibility in designing and deploying powerful, distributed applications. Web services can be
deliveredandpaidforasstreamsofservicesthatallowubiquitousaccessfromanyplatform,regardlessofoperating
system or programming language. Examples of web services, and the information and functionality they provide,
include the following:
•User authentication and authorization
•Credit card validation
•Financial markets services that return stock prices associated with specified ticker symbols
•Purchasing services that allow users to order products online
•Information services that provide news or other information types based on a selected interest, location, or other
personal information
Beforeyoucreateawebpagethatusesawebservice,youmustbefamiliarwiththeunderlyingservertechnologyof
your application and the programming constructs that the application requires.
The web page that connects to the web service is commonly known as a consumer, and the service itself is known as
apublisher. Dreamweaver lets you create pages and sites that are consumers of web services. Dreamweaver lets you
create web-service consumers that use ColdFusion, ASP.NET, and JavaServer Pages (JSP) document types, and
publish and deploy web services using ColdFusion. Specifically, Dreamweaver lets you perform the following web
service development tasks:
•Select web services available on the Internet.
•Generate a web service proxy that allows the web page to communicate with the web service publisher.
The proxy (also known as an abstraction class) contains the fields, methods, and properties of the web service, and
makes them available to the locally hosted page. When you generate a proxy for your page, Dreamweaver lets you
view them in the Components panel.
•Drag methods and data types into the web page’s code.
September 4, 2007
DREAMWEAVER CS3
User Guide
584
The Dreamweaver web service workflow
TocreateapageorsitethatisaconsumerofawebservicethatusesDreamweaver,youmustperformthefollowing
tasks:
1. Install and configure a proxy generator.
Dreamweaver comes preconfigured with Axis, the Apache SOAP proxy generator that supports JSP web service
development. If you are developing ColdFusion pages, the web service proxy generator is included in the ColdFusion
server. Establishing a connection to the ColdFusion server gives you access to the proxy generator.
If you are developing web service pages for use with ASP.NET, you must install the ASP.NET SDK, which is available
from Microsoft.
2. Using a browser, view a web-based registry of web services.
There are several sources of web services, ranging from web service registry sites to simple lists. The registries use
UDDI, a standard that lets service providers and requestors find and transact with one another. UDDI allows
businesses to locate services on the web that meet their needs. For example, using UDDI you can specify certain
criteria, such as the lowest price for a certain service, or that specific information be returned.
3. After locating and selecting a web service that provides the functionality you require, enter the URL of the
WSDL in the Adding a Web Service dialog box.
4. Generate a proxy for the web service from the WSDL description of the service publisher.
To embed a web service into a web page, you must create a proxy. The proxy provides the web page with the necessary
information to communicate with the web service, and access the methods the web service provides.
To create a proxy from the WSDL file, use a proxy generator. After you create the proxy, you can install it on either
of the following:
•The local computer where you are developing the web service consumer.
•The server computer running the application server. To deploy the web page and have it communicate with the
web service publisher you must install the proxy on the server.
5. Using Dreamweaver, add the web service to a page and edit the necessary parameters and methods to use
the service’s functionality.
See also
“About proxy generators” on page 585
“Add a web service to a page” on page 588
Finding web service publishers
Web services themselves are made available by service publishers. Typically, the service publisher makes its web
service available through a web-based registry that maintains a directory of available services that you can access. A
number of websites provide such a directory, including:
•X Methods at http://www.xmethods.net
•Microsoft UDDI registry at http://uddi.microsoft.com/default.aspx
September 4, 2007
DREAMWEAVER CS3
User Guide
585
These registries use the Universal Description, Discovery and Integration (UDDI) service, an open, e-commerce
service registry that provides a forum for businesses to describe themselves and the goods or services they can
provide to other businesses. A group of companies, called operators, maintain the registry. The operators have
pledged to share all public information about registrants among themselves and with users of the service, and to
maintain inter-operability among the multiple peer nodes of the UDDI service network. In addition to public web
services, there are also private UDDI registries available on a subscription basis.
The UDDI specification is based on existing Internet standards, ensuring that it is platform and implementation
neutral.
Web service software components
For a web page to access and use a web service, it must communicate with the service and have a description of the
functionality the service provides, the available methods that it can invoke, and the parameters the service returns.
The Web Service Description Language (WSDL) is an XML-based description of the service. Each web service
provides a WSDL that describes how to bind to the service, the available methods that the web page can invoke, and
the data inputs and outputs. The WSDL can reside in a file, or it can be generated by the web service at run time.
Communication between the web page that requests the service and the web service itself uses the Simple Object
Access Protocol (SOAP). SOAP is an XML-based protocol that lets a web client access and invoke the web service’s
methods and parameters.
See also
“Add a web service proxy using the WSDL description” on page 587
Web service references
To learn more about web services, and the underlying technologies that make them possible, visit the following
websites:
•WSDL specification at http://www.w3.org/TR/wsdl
•UDDI specification at http://www.uddi.org/specification.html
•XML specification at http://www.w3.org/TR/REC-xml
•SOAP specification at http://www.w3.org/TR/SOAP/
About proxy generators
Proxy generators generate a web service proxy,asoftwarecomponentthatawebpageusestocommunicatewiththe
webservicepublisher.ThewebserviceproxyisgeneratedfromtheWebServiceDescriptionLanguage(WSDL)that
describes the web service. Depending on the server technology you want to develop web service consumers for, you
may need to install and configure a proxy generator that supports that technology.
Dreamweaver installs the Axis proxy generator, which supports JSP web services. Axis is an open-source proxy
generator distributed through the Apache SOAP project. Dreamweaver lets you add obtain and configure proxy
generators that support other vendor’s web service implementations, or new web service technologies.
Note: Dreamweaver installs by default all the necessary software to use Axis.
To learn more about Axis, see the Apache Axis website at http://ws.apache.org/axis/.
September 4, 2007
DREAMWEAVER CS3
User Guide
586
Obtaining additional proxy generators
To install a proxy generator that is not supplied with Dreamweaver, you must obtain the proxy generator and any
related software components from the vendor. You should be able to download all the necessary files from the
vendor’s website.
Some proxy generators create proxies that depend on other software libraries, which must be appropriately installed
so the proxy generator can access them. For example, the Axis proxy generator creates proxies that depend on the
Apache SOAP library, which, in turn, depends on other software libraries. When selecting a proxy generator, consult
the provided documentation, and ensure that you have all the required software components and libraries, so that
you can properly install and configure them.
After you properly install and configure the proxy generator, you must configure it to work with Dreamweaver.
Note: Currently, web services development with Dreamweaver is limited to the Windows environment. To develop pages
that access web services on the Macintosh, you must use a separate application server running either Windows
NT/2000/XP or UNIX on which to run the web service proxy and its application environment.
Configure a proxy generator to work with Dreamweaver
When you install a web-service proxy generator, you must configure it to work with Dreamweaver.
1Select Window > Components to open the Components panel.
2In the Components panel, select Web Services from the pop-up menu in the upper-left corner of the panel, then
click the Plus (+) button and select Add Using WSDL.
3In the Add Using WSDL dialog box, select Edit Proxy Generator List from the Proxy Generator pop-up menu.
4Click New, select the proxy generator from the pop-up menu, and click Done.
•To delete a proxy generator from the list, select it in the list and click Remove.
•To modify a proxy generator, select it in the list and click Edit. Make changes in the resulting dialog box.
•To create a copy of a proxy generator, select it in the list and click Duplicate.
Note: The ColdFusion MX proxy generator is not editable.
5Select Default Proxy Generator to configure the selected proxy generator or a new proxy generator, set the
following options, and click OK:
Name The name of the proxy generator instance to appear in the pop-up menu.
Server Models Supported Thelistofservermodelsthattheproxygeneratorsupports.EditthelistbyusingthePlus
(+) and Minus (-) buttons.
Clicking the Plus (+) button displays the Select Server Models dialog box. Select a server model from the list of
available server models, and click OK. You can select multipleservermodelsbyholdingtheControlkeyandselecting
from the list.
Generate Proxy Command Generate proxy source code from WSDL information. The following tokens can be used
in the proxy generator commands:
Compile Proxy Command Compiles the proxy source code to executable code.
Introspect Compiled Proxy Introspect the compiled proxy by selecting an introspector from the pop-up menu.
Destination Folder Folder in which to put the compiled web service proxy and its source code.
September 4, 2007
DREAMWEAVER CS3
User Guide
587
When Dreamweaver reads a WSDL description of a web service, Dreamweaver carries out the following actions
relating to the fields of the Default Proxy Generator:
•Reads the WSDL as input to find the web service.
•Generates the web service proxy with the specified run-time environment.
•Compiles the proxy with the specified compiler.
•Returns the proxy source code and the compiled proxy in the specified destination folder.
Add a web service proxy using the WSDL description
Afteryouspecifyaproxygeneratorandconfigurethewebserviceservermodelsthatyoumustsupport,youidentify
a web service that provides the desired functionality and generate a proxy for that service.
1Open the page that you want to add the web service to.
2In the Components panel (Window > Components), select Web Services from the pop-up menu in the upper-left
corner of the panel, click the Plus (+) button, and select Add Using WSDL.
3Specify the URL of the WSDL file to use in one of these ways:
•If you know the URL of the WSDL file, enter it in the URL of the WSDL box. This URL is used to generate the
proxy and scripting information for the web service.
•If you don’t know the URL of the WSDL file, click the UDDI browse button (globe icon) to browse a directory of
web services, select one of the listed web service registries, or copy and paste the URL of the web service into the
WSDL edit box.
Note: You can edit the list of web service registries to include additional web service directories or specific web service
providers.
4Select a proxy generator that supports your web services server model from the Proxy Generator pop-up menu.
5Ensure that the proxy generator is installed and configured on your system, and click OK.
The proxy generator creates a proxy for the web service and introspects it. Introspection is the process where the
proxy generator queries the internal structure of the web service proxy, and makes its interfaces, methods, and
properties available through Dreamweaver.
Thewebserviceisnowavailableforuseinthesite,andappearsintheComponentspanel.Youcannowaddtheweb
service to a page.
See also
“Web service software components” on page 585
Change the UDDI-based web service site list
The Web Service Chooser provides a list of UDDI-based web service directories from which you can select web
services. You can edit this list to add or delete web service directories.
1In the Components panel (Window > Components), select Web Services from the pop-up menu in the upper-left
corner of the panel, and then click the Plus (+) button to add a web service.
2In the Web Services Chooser, click the globe icon and select Edit UDDI Site List from the pop-up menu.
September 4, 2007
DREAMWEAVER CS3
User Guide
588
3Complete the UDDI Sites dialog box, and click Done.
•To add a new site, or modify an existing one, click the New or Edit button. Enter the name and URL of a UDDI
website, and click OK.
•To remove an existing site, select it from the list, and click the Remove button.
Add a web service to a page
After selecting a web service, generating its proxy, and adding it to the Components panel, you insert it in a page.
The following example shows the Components panel with the web service proxy Helloworld added. The
Helloworld proxy provides one method, sayHello, which prints “Hello World.”
The following example instantiates the HelloWorld web service using ColdFusion.
1In the Document window, in Code view, drag the sayHello method into the page’s HTML.
Dreamweaver adds the method and dummy parameters to the page.
2Edit the inserted code with appropriate service instance names, data types, and parameter values, as required by
the web service. The web service provides descriptions of the data types and parameter values.
InthefollowingColdFusionexample,thewebserviceisenclosedbythe<cfinvoke> tags. When developing a web
service in ColdFusion, use <cfinvoke> to instantiate the web service and invoke its methods.
<html>
<head>
<title>Web Service</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<cfinvoke
webservice="http://www.mysite.com:8500:8500/helloworld/HelloWorld.cfc?wsdl"
method="sayHello"
returnvariable="aString">
</cfinvoke>
</body>
</html>
3To bind a return value to a visual element, switch to Design view and place a visual element on the page that can
accept data binding. Then switch back to Code view and enter the appropriate code to bind the returned value to the
visual element. When creating web services, refer to the technology provider’s documentation for the proper syntax
with which to both instantiate the service and display the returned values to the page.
In this example, the value returned for the variable aString is output using the ColdFusion <cfoutput> tag. This
displays the sentence “The web service says: Hello world!” to the page.
September 4, 2007
DREAMWEAVER CS3
User Guide
589
<html>
<head>
<title>Web Service</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<cfinvoke
webservice="http://www.mysite.com:8500/helloworld/HelloWorld.cfc?wsdl"
method="sayHello"
returnvariable="aString">
</cfinvoke>
The web service says: <cfoutput>#aString#</cfoutput>
</body>
</html>
4Whenyoudeploywebpagestoaproductionserver,Dreamweaverautomaticallycopiesthepages,theproxy,and
any necessary libraries to the web server.
Note: If you develop the application with a proxy that is installed on a separate computer from the one where you
developed the pages, or if you use a site management tool that does not copy all of the related files to the server, you must
ensurethatyoudeployboththeproxyandanydependentlibraryfiles.Otherwise,yourpagescannotcommunicatewith
the web service application.
Add a web service using a proxy class
Select a local .NET DLL or JSP Reader to introspect web service proxies when using the .NET or JSP development
framework.
1Select Window > Components to open the Components panel.
2IntheComponentspanel,selectWebServicesfromthepop-upmenuintheupper-leftcornerofthepanel,then
click the Plus (+) button and select Add Using Proxy Classes.
3Enter the location of the proxy class reader in the box, or browse for the file.
4Select a proxy reader from the pop-up menu, and click OK.
There are two default proxy readers:
•The .NET DLL Reader for ASP.NET document types
•The Java Class Reader for JSP document types
Adding custom server behaviors
About custom server behaviors
Dreamweaver comes with a set of built-in server behaviors that lets you easily add dynamic capabilities to a site. You
can extend the Dreamweaver functionality by creating server behaviors to suit your development needs, or by
obtaining server behaviors from the Dreamweaver Exchange website.
Before creating your own server behaviors, you should check the Dreamweaver Exchange website to see if another
party has already created a server behavior that supplies the functionality you’d like to add to your website. Often, a
third-party developer has created and tested a server behavior that will address your needs.
September 4, 2007
DREAMWEAVER CS3
User Guide
590
Access Dreamweaver Exchange
1In Dreamweaver, access Dreamweaver Exchange in one of these ways:
•Select Help > Dreamweaver Exchange.
•Select Window > Server Behaviors, click the Plus (+) button, and select Get More Server Behaviors.
The Dreamweaver Exchange web page opens in your browser.
2Log on to the Exchange using your Adobe ID, or, if you have not yet created a Dreamweaver Exchange ID for
yourself, follow the instructions to open an Adobe account.
Install a server behavior or other extension in Dreamweaver
1Start the Extension Manager by selecting Commands > Manage Extensions.
2Select File > Install Package in the Extension Manager.
For more information, see Using the Extension Manager.
Custom server behaviors workflow
If you are a developer proficient in ColdFusion, ASP.NET, JavaScript, VBScript, PHP, or Java, you can write your own
server behaviors. The steps to create a server behavior include the following tasks:
•Write one or more code blocks that perform the required action.
•Specify where the code block should be inserted within the page’s HTML code.
•If the server behavior requires that a value be specified for a parameter, create a dialog box that prompts the web
developer applying the behavior to supply an appropriate value.
•Test the server behavior before making it available to others.
See also
“Request a parameter for the server behavior” on page 597
“Testing server behaviors” on page 600
Use the Server Behavior Builder
Use the Server Behavior Builder to add the code block or blocks that the behavior inserts into a page.
1In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button, and select New Server
Behavior.
2FromtheDocumentTypepop-upmenu,selectthedocumenttypethatyouaredevelopingtheserverbehaviorfor.
3In the Name box, enter a name for the server behavior.
4(Optional) To copy an existing server behavior to add to the behavior you are creating, select the Copy Existing
Server Behavior option, and then select the server behavior in the Behavior to Copy pop-up menu. Click OK.
The Server Behavior Builder dialog box is displayed.
5To add a new code block, click the Plus (+) button, enter a name for the code block, and click OK.
The name you enter appears in the Server Behavior Builder, with the appropriate scripting tags visible in the Code
block box.
6In the Code Block box, enter the run-time code necessary to implement the server behavior.
September 4, 2007
DREAMWEAVER CS3
User Guide
591
Note: When entering code in the Code Block box, you can only insert a single tag or code block for each named code
block (for example, myBehavior_block1,myBehavior_block2,myBehavior_blockn, etc.). If you have to enter
multiple tags or code blocks, create an individual code block for each one. You can also copy and paste code from other
pages.
7Place the insertion point in the code block where you’d like to insert the parameter, or select a string to replace
with a parameter.
8Click the Insert Parameters in Code Block button.
9Enter a name for the parameter in the Parameter Name box (for example, Session), and click OK.
The parameter is inserted into the code block at the location where you placed the insertion point prior to defining
the parameter. If you selected a string, every instance of the selected string in the code block is replaced with a
parameter marker (for example, @@Session@@).
10 Select an option from the Insert Code pop-up menu specifying where to embed the code blocks.
11 (Optional) To specify additional information about the server behavior, click the Advanced button.
12 To create more code blocks, repeat steps 5 through 11.
13 If the server behavior requires that parameters be supplied to it, you must create a dialog box that accepts param-
eters from the person applying the behavior. See the link below.
14 After you perform the required steps to create the server behavior, click OK.
The Server Behaviors panel lists the server behavior.
15 Test the server behavior and ensure that it functions properly.
See also
“Repeating code blocks with the loop directive” on page 595
“Coding guidelines” on page 599
“Request a parameter for the server behavior” on page 597
“Adding custom server behaviors” on page 589
Advanced options
After you specify the source code and insert location for each code block, the server behavior is completely defined.
In most cases, you don’t need to specify any additional information.
If you are an advanced user, you can set any of the following options:
Identifier Specifies whether the code block should be treated as an identifier.
By default, every code block is an identifier. If Dreamweaver finds an identifier code block anywhere in a document,
it lists the behavior in the Server Behaviors panel. Use the Identifier option to specify whether the code block should
be treated as an identifier.
Atleastoneoftheserverbehavior’scodeblocksmustbeanidentifier.Acodeblockshouldnotbeanidentifierifone
ofthefollowingconditionsapplies:thesamecodeblockisusedbysomeotherserverbehavior;orthecodeblockis
so simple that it might occur naturally on the page.
Server Behavior Title Specifies the title of the behavior in the Server Behaviors panel.
September 4, 2007
DREAMWEAVER CS3
User Guide
592
When the page designer clicks the Plus (+) button on the Server Behaviors panel, the new server behavior’s title will
appear in the pop-up menu. When a designer applies an instance of a server behavior to a document, the behavior
appears in the list of applied behaviors in the Server Behaviors panel. Use the Server Behavior Title box to specify
the contents of the Plus (+) pop-up menu and the list of applied behaviors.
The initial value in the box is the name you supplied in the New Server Behavior dialog box. As parameters are
defined, the name is automatically updated so that the parameters appear inside parentheses after the server behavior
name.
Set Session Variable (@@Name@@, @@Value@@)
If the user accepts the default value, everything before the parentheses appears in the Plus (+) pop-up menu (for
example, Set Session Variable). The name plus the parameters will appear in the list of applied behaviors—for
example, Set Session Variable ("abcd", "5").
Code Block to Select Specifies what code block is selected when the user selects the behavior in the Server Behaviors
panel.
Whenyouapplyaserverbehavior,oneofthecodeblockswithinthebehaviorisdesignatedthe“codeblocktoselect.”
If you apply the server behavior and then select the behavior in the Server Behaviors panel, the designated block is
selected in the Document window. By default, Dreamweaver selects the first code block that is not above the html
tag. If all the code blocks are above the html tag, then the first one is selected. Advanced users can specify which code
block is the selected one.
Creating code blocks
ThecodeblocksyoucreateintheServerBehaviorBuilderareencapsulatedinaserverbehaviorthatappearsinthe
Server Behaviors panel. The code can be any valid run-time code for the specified server model. For example, if you
choose ColdFusion as the document type for your custom server behavior, the code you write must be valid
ColdFusion code that runs on a ColdFusion application server.
You can create the code blocks either directly in the Server Behavior Builder, or you can copy and paste the code from
othersources.EachcodeblockyoucreateintheServerBehaviorBuildermustbeasingletagorscriptblock.Ifyou
must insert multiple tag blocks, split them into separate code blocks.
Conditions in code blocks
Dreamweaver lets you develop code blocks that incorporate control statements that execute conditionally. The
Server Behavior Builder uses if,elseif, and else statements, and may also contain server behavior parameters.
This enables you to insert alternate text blocks based on the values of OR relationships among server behavior
parameters.
The following example shows the if,elseif,andelse statements. The square brackets ([ ]) denote optional code
andtheasterisk(*)denoteszeroormoreinstances.Toexecuteaportionofacodeblockortheentirecodeblockonly
if a certain condition or conditions apply, use the following syntax:
<@ if (expression1) @>conditional text1[<@ elseif (expression2) @>conditional text2]*[<@
else @>
conditional text3]<@ endif @>
Condition expressions can be any JavaScript expression that can be evaluated using the JavaScript eval() function,
and may include a server behavior parameter marked by @@’s. (The @@’s distinguish the parameter from JavaScript
variables and keywords.)
September 4, 2007
DREAMWEAVER CS3
User Guide
593
Effectively using conditional expressions
When using if,else,andelseif directives within the insertText XML tag, the participant text is preprocessed
to resolve the if directives and to determine which text to include in the result. The if and elseif directives take
the expression as an argument. The condition expression is the same as that for JavaScript condition expressions, and
can also contain server behavior parameters. Directives such as this allow you to choose between alternative code
blocks based on the values of, or relationships between, server behavior parameters.
For example, the following JSP code comes from a Dreamweaver server behavior that uses a conditional code block:
@@rsName@@.close();
<@ if (@@callableName@@ != '') @>
@@callableName@@.execute();
@@rsName@@ = @@callableName@@.getResultSet();<@ else @>
@@rsName@@ = Statement@@rsName@@.executeQuery();
<@ endif @>
@@rsName@@_hasData = @@rsName@@.next();
The conditional code block starts with <@ if (@@callableName@@ != '') @> and ends with <@ endif @>.
According to the code, if the user enters a value for the @@callableName@@ parameter in the server behavior's
Parameter dialog box—in other words, if the @@callableName@@ parameter value is not null, or
(@@callableName@@ != '')—then the conditional code block is replaced with the following statements:
@@callableName@@.execute();
@@rsName@@ = @@callableName@@.getResultSet();
Otherwise, the code block is replaced with the following statement:
@@rsName@@ = Statement@@rsName@@.executeQuery();
See also
“Repeating code blocks with the loop directive” on page 595
Positioning a code block
When you create code blocks using the Server Behavior Builder, you must specify where to insert them in the page’s
HTML code.
For example, if you insert a code block above the opening <html> tag,youmustthenspecifythecodeblock’sposition
relative to other tags, scripts, and server behaviors in that section of the page’s HTML code. Typical examples include
positioning a behavior either before or after any recordset queries that might also exist in the page code above the
opening <html> tag.
When you select a positioning option from the Insert Code pop-up menu, the options available in the Relative
Position pop-up menu change to provide relevant options for that part of the page. For example, if you select Above
The <html> TagInTheInsertCodepop-upmenu,thepositioningoptionsavailableintheRelativePositionpop-up
menu reflect choices relevant for that part of the page.
The following table shows the code block insert options, and the relative positioning options available for each:
September 4, 2007
DREAMWEAVER CS3
User Guide
594
To specify a custom position, you must assign a weight tothecodeblock.UsetheCustomPositionoptionwhenyou
need to insert more than one code block in a particular order. For example, to insert an ordered series of three code
blocks after the code blocks that open recordsets, you would enter a weight of 60 for the first block, 65 for the second,
and 70 for the third.
By default, Dreamweaver assigns a weight of 50 to all recordset-opening code blocks inserted above the <html> tag.
If the weight of two or more blocks match, Dreamweaver randomly sets the order among the blocks.
See also
“Request a parameter for the server behavior” on page 597
“Coding guidelines” on page 599
“About custom server behaviors” on page 589
“Creating code blocks” on page 592
“Testing server behaviors” on page 600
Position a code block (general instructions)
1Using the Server Behavior Builder, write a code block.
2In the Server Behavior Builder dialog box, select a position in which to insert the code block from the Insert Code
pop-up menu.
3IntheServerBehaviorBuilderdialogbox,selectapositionrelativetothatwhichyouselectedintheInsertCode
pop-up menu.
4If you complete the authoring of the code block, click OK.
Insert Code options Relative position options
Above the <html> Tag •At the beginning of the file
•Just before the recordsets
•Just after the recordsets
•Just above the <html> tag
•Custom position
Below the </html> Tag •Before the end of the file
•Before the recordset close
•After the recordset close
•After the </html> tag
•Custom position
Relative to a Specific Tag Select a tag from the Tag pop-up menu, and then choose from the tag
positioning options.
Relative to the Selection Before the selection
After the selection
Replace the selection
Wrap the selection
September 4, 2007
DREAMWEAVER CS3
User Guide
595
The server behavior is listed in the Server Behaviors panel (Window > Server Behavior); click the Plus (+) button to
view the server behavior.
5Test the server behavior and ensure that it functions properly.
Position a code block relative to another tag on the page
1In the Insert Code pop-up menu, select Relative To A Specific Tag.
2In the Tag box, enter the tag or select one from the pop-up menu.
If you enter a tag, don’t include the angled brackets (<>).
3Specify a location relative to the tag by choosing an option in the Relative Position pop-up menu.
Position a code block relative to a tag selected by the page designer
1In the Insert Code pop-up menu, select Relative To The Selection.
2Specify a location relative to the selection by choosing an option in the Relative Position pop-up menu.
Youcaninsertyourcodeblockjustbeforeorjustaftertheselection.Youcanalsoreplacetheselectionwithyourcode
block, or you can wrap the code block around the selection.
Towrapthecodeblockaroundaselection,theselectionmustconsistofanopeningandclosingtagwithnothingin
between, as follows:
<CFIF Day=”Monday”></CFIF>
Inserttheopeningtagpieceofthecodeblockbeforetheselection’sopeningtagandtheclosingtagpieceofthecode
block after the selection’s closing tag.
Repeating code blocks with the loop directive
To repeat a portion of a code block or the entire code block a number of times, use the following syntax:
<@ loop (@@param1@@,@@param2@@) @>code block<@ endloop @>
When creating server behaviors, you can use looping constructs to repeat a code block a specified number of times.
<@ loop (@@param1@@,@@param2@@,@@param3@@,@@param_n@@) @>code block
<@ endloop @>
The loop directive accepts a comma-separated list of parameter arrays as arguments. In this case, parameter array
arguments allow a user to supply multiple values for a single parameter. The repeating text is duplicated n times,
where nis the length of the parameter array arguments. If more than one parameter array argument is specified, all
the arrays must have the same length. On the ith evaluation of the loop, the ith elements of the parameter arrays
replace the associated parameter instances in the code block.
When you create a dialog box for the server behavior, you can add a control to the dialog box that lets the page
designer create parameter arrays. Dreamweaver includes a simple array control that you can use to create dialog
boxes. This control, called Text Field Comma Separated List, is available through the Server Behavior Builder. To
create user interface elements of greater complexity, see the API documentation to create a dialog box with a control
to create arrays (a grid control, for example).
You can nest any number of conditionals or a loop directive within a conditional directive. For example, you can
specify that if an expression is true to execute a loop.
The following example shows how such repeating code blocks can be used to create server behaviors (the example is
a ColdFusion behavior used to access a stored procedure):
September 4, 2007
DREAMWEAVER CS3
User Guide
596
<CFSTOREDPROC procedure="AddNewBook"
datasource=#MM_connection_DSN#
username=#MM_connection_USERNAME#
password=#MM_connection_PASSWORD#>
<CFPROCPARAM type="IN" dbvarname="@CategoryId" value="#Form.CategoryID#"
cfsqltype="CF_SQL_INTEGER">
<CFPROCPARAM type="IN" dbvarname="@ISBN" value="#Form.ISBN#"
cfsqltype="CF_SQL_VARCHAR">
</CFSTOREDPROC>
In this example, the CFSTOREDPROC tagcanincludezeroormoreCFPROCPARAM tags. However, without support for
the loop directive, there is no way to include the CFPROCPARAM tags within the inserted CFSTOREDPROC tag. If this
were to be created as a server behavior without the use of the loop directive, you would need to divide this example
into two participants: a main CFSTOREDPROC tag, and a CFPROCPARAM tag whose participant type is multiple.
Using the loop directive, you can write the same procedure as follows:
<CFSTOREDPROC procedure="@@procedure@@"
datasource=#MM_@@conn@@_DSN#
username=#MM_@@conn@@_USERNAME#
password=#MM_@@conn@@_PASSWORD#>
<@ loop (@@paramName@@,@@value@@,@@type@@) @>
<CFPROCPARAM type="IN"
dbvarname="@@paramName@@"
value="@@value@@"
cfsqltype="@@type@@">
<@ endloop @>
</CFSTOREDPROC>
Note: New lines after each “@>” are ignored.
If the user entered the following parameter values in the Server Behavior Builder dialog box:
procedure = "proc1"
conn = "connection1"
paramName = ["@CategoryId", "@Year", "@ISBN"]
value = ["#Form.CategoryId#", "#Form.Year#", "#Form.ISBN#"]
type = ["CF_SQL_INTEGER", "CF_SQL_INTEGER", "CF_SQL_VARCHAR"]
The server behavior would insert the following run-time code in the page:
<CFSTOREDPROC procedure="proc1"
datasource=#MM_connection1_DSN#
username=#MM_connection1_USERNAME#
password=#MM_connection1_PASSWORD#>
<CFPROCPARAM type="IN" dbvarname="@CategoryId" value="#Form.CategoryId#"
cfsqltype="CF_SQL_INTEGER">
<CFPROCPARAM type="IN" dbvarname="@Year" value="#Form.Year#"
cfsqltype="CF_SQL_INTEGER">
<CFPROCPARAM type="IN" dbvarname="@ISBN" value="#Form.ISBN#"
cfsqltype="CF_SQL_VARCHAR">
</CFSTOREDPROC>
Note: Parameter arrays cannot be used outside of a loop except as part of a conditional directive expression.
September 4, 2007
DREAMWEAVER CS3
User Guide
597
Using the loop directive’s _length and _index variables
The loop directive includes two built-in variables that you can use for embedded if conditions. The variables are:
_length and _index. The _length variable evaluates to the length of the arrays processed by the loop directive,
while the _index variable evaluates to the current index of the loop directive. To ensure that the variables are only
recognized as directives, and not as actual parameters to be passed into the loop, do not enclose either variable in @@s.
An example of using built-in variables is to apply them to the import attribute of the page directive. The import
attribute requires comma separation of packages. If the loop directive extends around the entire import attribute,
you would only output the attribute name import= on the first iteration of the loop—this includes the closing double
quote (")—and not output a comma on the last iteration of the loop. Using the built-in variable, you can express this
as follows:
<@loop (@@Import@@)@>
<@ if(_index == 0)@>import="
<@endif@>@@Import@@<@if (_index == _length-1)@>"<@else@>,
<@ endif @>
<@endloop@>
Request a parameter for the server behavior
Server behaviors often require that the page designer supply a parameter value. This value must be inserted before
the server behavior’s code is inserted into the page.
You create the dialog box by defining the designer-supplied parameters in the code. Then you generate a dialog box
for the server behavior, which prompts the page designer for a parameter value.
Note: Aparameterisaddedtoyourcodeblockwithoutyourinterventionifyouspecifythatyourcodeshouldbeinserted
relativetoaspecifictagchosenbythepagedesigner(thatis,youchoseRelativetoaSpecificTagintheInsertCodepop-up
menu). The parameter adds a tag menu to the behavior’s dialog box to let the page designer select a tag.
Define the parameter in the server behavior code
1Enter a parameter marker in the code where you want to insert the supplied parameter value. The parameter has
the following syntax:
@@parameterName@@
2Enclose the formParam string in parameter markers (@@):
<% Session(“lang_pref”) = Request.Form(“@@formParam@@”); %>
For example, if the server behavior contains the following code block:
<% Session(“lang_pref”) = Request.Form(“Form_Object_Name”); %>
TorequirethepagedesignersupplythevalueofForm_Object_Name, enclose the string in parameter markers (@@):
<% Session(“lang_pref”) = Request.Form(“@@Form_Object_Name@@”); %>
You can also highlight the string and click the Insert Parameter In Code Block button. Enter a parameter name and
click OK. Dreamweaver replaces every instance of the highlighted string with the specified parameter name enclosed
in parameter markers.
September 4, 2007
DREAMWEAVER CS3
User Guide
598
Dreamweaver uses the strings that you enclose in parameter markers to label the controls in the dialog box it
generates (see the following procedure). In the previous example, Dreamweaver creates a dialog box with the
following label:
Note: Parameter names in the server behavior code cannot have any spaces. Therefore, the dialog box labels cannot have
any spaces. If you want to include spaces in the label, you can edit the generated HTML file.
Create a dialog box for your server behavior to request the parameter value
1In the Server Behavior Builder, click Next.
2To change the display order of the dialog box controls, select a parameter and click the up and down arrows.
3To change a parameter’s control, select the parameter and selecting another control in the Display As column.
4Click OK.
Dreamweaver generates a dialog box with a labeled control for each designer-supplied parameter that you defined.
View the dialog box
❖Click the Plus (+) button in the Server Behaviors panel (Window > Server Behaviors), and select your custom
server behavior from the pop-up menu.
Edit the dialog box you created for the server behavior
1In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button, and select Edit Server
Behaviors from the pop-up menu.
2Select your server behavior from the list, and click Open.
3Click Next.
A dialog box appears listing all the designer-supplied parameters that you defined in your code.
4To change the display order of the dialog box controls, select a parameter and click the up and down arrows.
5To change a parameter’s control, select the parameter and select another control in the Display As column.
6Click OK.
Edit and modify server behaviors
YoucaneditanyserverbehaviorcreatedwiththeServerBehaviorBuilder,includingserverbehaviorsyoudownload
from the Dreamweaver Exchange website, and other third-party developers.
If you apply a server behavior to a page and then edit the behavior in Dreamweaver, instances of the old behavior no
longer appear in the Server Behaviors panel. The Server Behaviors panel searches the page for code that matches the
code of known server behaviors. If the code of a server behavior changes, the panel does not recognize earlier
versions of the behavior on that page.
September 4, 2007
DREAMWEAVER CS3
User Guide
599
See also
“Use the Server Behavior Builder” on page 590
“Positioning a code block” on page 593
Retain the old and new versions of the behavior in the panel
❖ClickthePlus(+)buttonontheServerBehaviorspanel(Window>ServerBehaviors),selectNewServerBehavior,
and create a copy of the old server behavior.
Edit the code of a server behavior created with the Server Behavior Builder
1In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select Edit Server
Behaviors from the pop-up menu.
The Edit Server Behaviors dialog box displays all the behaviors for the current server technology.
2Select the server behavior and click Edit.
3Select the appropriate code block and modify the code, the parameter marks, or the position of the code block to
be inserted in pages.
4If the modified code does not contain any designer-supplied parameters, click OK.
Dreamweaver regenerates the server behavior without a dialog box. The new server behavior appears in the Plus (+)
pop-up menu of the Server Behaviors panel.
5If the modified code does contain designer-supplied parameters, click Next.
Dreamweaver asks you whether you want to create a new dialog box, overwriting the old one. Make your changes
and click OK.
Dreamweaver saves all changes in the server behavior’s EDML file.
Coding guidelines
In general, your server behavior’s code should be compact and robust. Web application developers are very sensitive
to the code added to their pages. Follow generally accepted coding practices for the document type’s language
(ColdFusion, ASP.NET, JavaScript, VBScript, PHP, Visual Basic or Java). When writing comments, consider the
differenttechnicalaudiencesthatmightneedtounderstandthecode,suchaswebandinteractiondesigners,orother
web application developers. Include comments that accurately describe the purpose of the code, and any special
instructions for including it within a page.
Keep in mind the following coding guidelines when you create server behaviors:
Error checking An important requirement. The server behavior’s code should handle error cases gracefully. Try to
foresee every possibility. For example, what if a parameter request fails? What if no records are returned from a
query?
Unique names Help to ensure that your code is clearly identifiable and avoids name collisions with existing code.
For example, if the page contains a function called hideLayer() and a global variable called ERROR_STRING, and
your server behavior inserts code that uses those names too, the server behavior may conflict with the existing code.
Code prefixes Allow you to identify your own run-time functions and global variables in a page. One convention is
to use your initials. Never use the MM_ prefix, as it is reserved for Macromedia use only. Macromedia preceded all
functions and global variables with the prefix MM_ to prevent them from conflicting with any code that you write.
September 4, 2007
DREAMWEAVER CS3
User Guide
600
var MM_ERROR_STRING = "...";
function MM_hideLayer() {
Avoid similar code blocks sothatthecodeyouwritedoesn’tresembletoocloselythecodeinotherblocks.Ifacode
block looks too much like another code block on the page, the Server Behaviors panel might mistakenly identify the
first code block as an instance of the second code block (or conversely). A simple solution is to add a comment to a
code block to make it more unique.
See also
“About custom server behaviors” on page 589
“Custom server behaviors workflow” on page 590
Testing server behaviors
The Dreamweaver Exchange recommends performing the following tests on each server behavior you create:
•Apply the behavior from the Server Behaviors panel. If it has a dialog box, enter valid data in each field and click
OK. Verify that no error occurs when the behavior is applied. Verify that the run-time code for the server behavior
appears in the Code inspector.
•Apply the server behavior again and enter invalid data in each field of the dialog box. Try leaving the field blank,
using large or negative numbers, using invalid characters (such as /, ?, :, *, and so on), and using letters in numeric
fields. You can write form validation routines to handle invalid data (validation routines involve hand-coding,
which is beyond the scope of this book).
After successfully applying your server behavior to the page, verify the following:
•Check the Server Behaviors panel to make sure the name of the server behavior appears in the list of behaviors
added to the page.
•If applicable, verify that server-side script icons show up on the page. The generic server-side script icons are gold
shields. To see the icons, enable Invisible Elements (View > Visual Aids > Invisible Elements).
•In Code view (View > Code), verify that no invalid code is generated.
In addition, if your server behavior inserts code in the document establishing a connection to a database, create a
test database to test the code inserted in the document. Verify the connection by defining queries that produce
different sets of data, and different sizes of data sets.
Finally, upload the page to the server and open it in a browser. View the page’s HTML source code and verify that no
invalid HTML has been generated by the server-side scripts.
Creating forms
About forms
You can use Dreamweaver to create forms with text fields, password fields, radio buttons, check boxes, pop-up
menus,clickablebuttons,andotherformobjects.Dreamweavercanalsowritecodethatvalidatestheinformationa
visitor provides. For example, you can check that an e-mail address that a user enters contains an “@” symbol, or that
a required text field contains a value.
For more information on ColdFusion and ASP.NET forms, see “Building ColdFusion MX 7 forms” on page 674 and
“Building ASP.NET forms” on page 686.
September 4, 2007
DREAMWEAVER CS3
User Guide
601
Client-side role of forms
Forms support the client side of the client-server relationship. When a visitor enters information into a form
displayed in a web browser (the client) and clicks the submit button, the information is sent to the server where a
server-side script or application processes it. The server responds by sending requested information back to the user
(or client), or performing some action based on the form’s contents.
Note: You can also send form data directly to an e-mail recipient.
Form objects
In Dreamweaver, form input types are called form objects. Form objects are the mechanisms that allow users to input
data. You can add the following form objects to a form:
Text fields Accept any type of alphanumeric text entry. The text can be displayed as a single line, multiple lines, and
as a password field where entered text is replaced by asterisks or bullets to hide the text from onlookers.
Note: Passwords and other information sent to a server using a password field are not encrypted. The transferred data
can be intercepted and read as alphanumeric text. For this reason, you should always provide encryption for data you
want to keep secure.
Hidden fields Store information entered by a user, such as a name, e-mail address, or viewing preference, and then
use that data when the user next visits the site.
Buttons Perform actions when clicked. You can add a custom name or label for a button, or use one of the predefined
“Submit” or “Reset” labels. Use a button to submit form data to the server or to reset the form. You can also assign
other processing tasks that you define in a script. For example, the button might calculate the total cost of items
selected based on assigned values.
September 4, 2007
DREAMWEAVER CS3
User Guide
602
Check boxes Allow multiple responses within a single group of options. A user can select as many options as apply.
The following example shows three check box items selected: Surfing, Mountain Biking, and Rafting.
Radio buttons Represent exclusive choices. Selecting a button within a radio button group deselects all others in the
group (a group consists of two or more buttons that share the same name). In the example below, Rafting is the
currently selected option. If the user clicks Surfing, the Rafting button is automatically cleared.
List menus Displayoptionvalueswithinascrollinglistthatallowsuserstoselectmultipleoptions.TheListoption
displaystheoptionvaluesinamenuthatallowsuserstoselectonlyasingleitem.Usemenuswhenyouhavealimited
amount of space, but must display many items, or to control the values returned to the server. Unlike text fields where
users can type anything they want, including invalid data, you set the exact values returned by a menu.
Note: A pop-up menu on an HTML form is not the same as a graphical pop-up menu. For information on creating,
editing, and showing and hiding a graphical pop-up menu, see the link at the end of this section.
Jump menus Navigational lists or pop-up menus that let you insert a menu in which each option links to a document
or file.
File fields Let users browse to a file on their computer and upload the file as form data.
Image fields Let you insert an image in a form. Use image fields to make graphical buttons such as Submit or Reset
buttons. Using an image to perform tasks other than submitting data requires attaching a behavior to the form object.
See also
“Apply the Show Pop-Up Menu behavior” on page 361
Create an HTML form
1Open a page and place the insertion point where you want the form to appear.
September 4, 2007
DREAMWEAVER CS3
User Guide
603
2Select Insert > Form, or select the Forms category in the Insert bar and click the Form icon.
In Design view, forms are indicated by a dotted red outline. If you don’t see this outline, select View > Visual Aids >
Invisible Elements.
3Set the properties of the HTML form in the Property inspector (Window >Properties):
aIn the Document window, click the form outline to select the form.
bIn the Form Name box, type a unique name to identify the form.
Naming a form makes it possible to reference or control the form with a scripting language, such as JavaScript or
VBScript. If you do not name the form, Dreamweaver generates a name using the syntax formn, and increments the
value of n for each form added to the page.
cIn the Action box, specify the page or script that will process the form data by typing the path, or clicking the folder
icon to navigate to the appropriate page or script.
dIn the Method pop-up menu, specify the method to transmit the form data to the server. Set any of the following
options:
Default Uses the browser’s default setting to send the form data to the server. Typically, the default value is the GET
method.
GET Appends the value to the URL requesting the page.
POST Embeds the form data in the HTTP request.
Do not use the GET method to send long forms. URLs are limited to 8192 characters. If the amount of data sent is too
large, data will be truncated, leading to unexpected or failed processing results.
Dynamic pages generated by parameters passed by the GET method can be bookmarked because all the values
needed to regenerate the page are contained in the URL displayed in the browser’s Address box. In contrast, dynamic
pages generated by parameters passed by the POST method cannot be bookmarked.
If you collect confidential user names and passwords, credit card numbers, or other confidential information, the
POST method may appear more secure than the GET method.However,theinformationsentbythePOST method is
notencryptedandcaneasilyberetrievedbyahacker.Toensuresecurity,useasecureconnectiontoasecureserver.
e(Optional) In the Enctype pop-up menu, specify the MIME encoding type of the data submitted to the server for
processing.
The default setting of application/x-www-form-urlencode is typically used in conjunction with the POST
method. If you are creating a file-upload field, specify the multipart/form-data MIME type.
f(Optional) In the Target pop-up menu, specify the window in which to display the data returned by the invoked
program.
Ifthenamedwindowisnotalreadyopen,anewwindowwiththatnameopens.Setanyofthefollowingtargetvalues:
_blank Opens the destination document in a new unnamed window.
_parent Opens the destination document in the parent window of the one displaying the current document.
_self Opens the destination document in the same window as the one in which the form was submitted.
_top Opensthedestinationdocumentinthebodyofthecurrentwindow.Thisvaluecanbeusedtoensurethatthe
destination document takes over the full window even if the original document was displayed in a frame.
4Insert form objects in the page:
aPlace the insertion point where the form object should appear in the form.
September 4, 2007
DREAMWEAVER CS3
User Guide
604
bSelect the object in the Insert > Form menu, or in the Forms category of the Insert bar.
cSet the properties of the objects.
dEnter a name for the object in the Property inspector.
Every text field, hidden field, check box, and list/menu object must have a unique name that identifies the object in
the form. Form object names cannot contain spaces or special characters. You can use any combination of alphanu-
meric characters and an underscore (_). The label you assign to the object is the variable name that stores the value
(the entered data) of the field. This is the value sent to the server for processing.
Note: All radio buttons in a group must have the same name.
eTo label the text field, check box, or radio button object on the page, click beside the object and type the label.
5Adjust the layout of the form.
Use line breaks, paragraph breaks, preformatted text, or tables to format your forms. You cannot insert a form in
another form (that is, you cannot overlap tags), but you can include more than one form in a page.
When designing forms, remember to label the form fields with descriptive text to let users know what they’re
responding to—for example, “Type your name” to request name information.
Use tables to provide structure for form objects and field labels. When using tables in forms make sure all the table
tags are included between the form tags.
For a tutorial on creating forms, see www.adobe.com/go/vid0160.
For a tutorial on styling forms with CSS, see www.adobe.com/go/vid0161.
See also
“Building ASP.NET forms” on page 686
“Building ColdFusion MX 7 forms” on page 674
“About dynamic form objects” on page 608
“Attach JavaScript behaviors to HTML form objects” on page 612
“Attach custom scripts to HTML form buttons” on page 612
Insert a group of radio buttons
1Place the insertion point inside the form outline.
2Select Insert > Form > Radio Group.
3Complete the dialog box and click OK.
aIn the Name box, enter a name for the radio button group.
Ifyousettheradiobuttonstopassparametersbacktotheserver,theparametersareassociatedwiththename.For
example, if you name the group myGroup and set the form method to GET (that is, you want the form to pass URL
parameters instead of form parameters when the user clicks the submit button), the expression myGroup=”Checked-
Value” is passed in the URL to the server.
bClick the Plus (+) button to add a radio button to the group. Enter a label and checked value for the new button.
cClick the up or down arrows to reorder the buttons.
dTosetaparticularradiobuttontobeselectedwhenthepageopensinabrowser,enteravalueequaltotheradio
button’s value in the Select Value Equal To box.
September 4, 2007
DREAMWEAVER CS3
User Guide
605
Enter a static value or specify a dynamic one by clicking the lightning bolt icon beside the box and selecting a
recordset that contains possible checked values. In either case, the value you specify should match the checked value
of one of the radio buttons in the group. To view the checked values of the radio buttons, select each radio button
and open its Property inspector (Window > Properties).
eSelect the format in which you want Dreamweaver to lay out the buttons.
Lay out the buttons using line breaks or a table. If you select the table option, Dreamweaver creates a single-column
table, and places the radio buttons on the left and the labels on the right.
You can also set the properties in the Property inspector or directly in Code view.
Insert an image button
You can use images as button icons. Using an image to perform tasks other than submitting data requires attaching
a behavior to the form object.
1In the document, place the insertion point inside the form outline.
2Select Insert > Form > Image Field.
The Image Source dialog box appears.
3Select the image for the button in the Select Image Source dialog box, and click OK.
4Set any of the following options in the Property inspector:
ImageField Assignsanametothebutton.Tworeservednames,SubmitandReset,telltheformtosubmittheform
data to the processing application or script, or to reset all the form fields to their original values, respectively.
Src Specifies the image you want to use for the button.
Alt Lets you enter descriptive text in case the image fails to load in the browser.
Align Sets the align attribute of the object.
Edit Image starts your default image editor and opens the image file for editing.
Class Lets you apply CSS rules to the object.
5To attach a JavaScript behavior to the button, select the image, and then select the behavior in the Behaviors panel
(Window > Behaviors).
Insert file-upload fields
You can create a file-upload field that lets users select a file on their computer—such as a word processing document
or graphics file—and upload the file to the server. A file field looks like other text fields except it also contains a
Browse button. The user either manually enters the path to the file they want to upload, or uses the Browse button
to locate and select the file.
Before you can use file-upload fields, you must have a server-side script or a page capable of handling file submis-
sions. Consult the documentation of the server technology you use to process form data. For example, if you use
PHP, see “Handling files uploads” in the online PHP Manual at http://us2.php.net/features.file-upload.php.
FilefieldsrequirethatyouusethePOST method to transmit files from the browser to the server. The file is posted to
the address you specify in the form’s Action box.
Note: Contact your server’s administrator to confirm that anonymous file uploads are allowed before using the file field.
1Insert a form in the page (Insert > Form).
2Select the form to display its Property inspector.
September 4, 2007
DREAMWEAVER CS3
User Guide
606
3Set the form Method to POST.
4From the Enctype pop-up menu, select multipart/form-data.
5In the Action box, specify the server-side script or page capable of handling the uploaded file.
6Place the insertion point inside the form outline, and select Insert > Form > File Field.
7Set any of the following options in the Property inspector:
File Field Name Specifies the name for the file field object.
Char Width Specifies the maximum number of characters that can be displayed in the field.
Max Chars Specifies the maximum number of characters the field will hold. If the user browses to locate the file, the
filename and path can exceed the specified Max Chars value. However, if the user attempts to type in the filename
and path, the file field will only allow the number of characters specified by the Max Chars value.
HTML text field object properties
Select the text field object, and set any of the following options in the Property inspector:
Char Width Specifies the maximum number of characters that can be displayed in the field. This number can be less
than Max Chars, which specifies the maximum number of characters that can be entered in the field. For example,
if the Char Width is set to 20 (the default value) and a user enters 100 characters, only 20 of those characters will be
viewable in the text field. Although you cannot view the characters in the field, they are recognized by the field object
and are sent to the server for processing.
Max Chars Specifies the maximum number of characters that the user can enter in the field for single-line text fields.
Use Max Chars to limit zip codes to 5 digits, limit passwords to 10 characters, and so on. If you leave the Max Chars
box blank, users can enter any amount of text. If the text exceeds the character width of the field the text will scroll.
If a user exceeds the maximum number of characters, the form produces an alert sound.
Num Lines (Available when the Multiline option is selected) Sets the height of the field for multiple-line text fields.
Wrap (Available when the Multiline option is selected) Specifies how the user’s input will be displayed when the user
enters more information than can be displayed within the defined text area. The wrap options are as follows:
•Off or Default Prevents text from wrapping to the next line. When the user’s input exceeds the right boundary of
the text area, text scrolls toward the left. Users must press Return to move the insertion point to the next line in the
text area.
•Virtual Sets word wrap in the text area. When the user’s input exceeds the right boundary of the text area, text
wraps to the next line. When data is submitted for processing, word wrap isn’t applied to the data. It is submitted as
one string of data.
•Physical Sets word wrap in the text area, as well as to the data when it is submitted for processing.
Type Designates the field as a single-line, multiple-line, or password field.
•Single-line Results in an input tag with its type attribute set to text. The Char Width setting maps to the size
attribute, and the Max Chars setting maps to the maxlength attribute.
•Multi-line Results in a textarea tag. The Char Width setting maps to the cols attribute, and the Num Lines
setting maps to the rows attribute.
•Password Results in an input tag with its type attribute set to password. The Char Width and Max Chars
settings map to the same attributes as in single-line text fields. When a user types in a password text field, the input
appears as bullets or asterisks to protect it from observation by others.
September 4, 2007
DREAMWEAVER CS3
User Guide
607
Init Value Assigns the value displayed in the field when the form first loads. For example, you might indicate that
the user enters information in the field by including a note or example value.
Class Lets you apply CSS rules to the object.
Button object options
Button Name Assignsanametothebutton.Tworeservednames,SubmitandReset,telltheformtosubmittheform
data to the processing application or script, or to reset all the form fields to their original values, respectively.
Label Determines the text that appears on the button.
Action Determines what happens when the button is clicked.
•Submit Form Submits the form data for processing when the user clicks the button. The data is submitted to the
page or script specified in the form’s Action property.
•Reset Form Clears the contents of the form when the button is clicked.
•None Specifies the action to be performed when the button is clicked. For example, you can add a JavaScript
behavior that opens another page when the user clicks the button.
Class Applies CSS rules to the object.
HTML check box object options
Checked Value Sets the value to be sent to the server when the check box is checked. For example, in a survey you
might set a value of 4 for strongly agree and a value of 1 for strongly disagree.
Initial State Determines whether the check box is selected when the form loads in the browser.
Dynamic Lets the server dynamically determine the initial state of the check box. For example, you can use check
boxes to visually present the Yes/No information stored in a database record. At design time, you don’t know that
information. At run time the server reads the database record and selects the check box if the value is Yes.
Class Applies Cascading Style Sheets (CSS) rules to the object.
Single radio button object options
Checked Value Sets the value to be sent to the server when the radio button is selected. For example, you might type
skiing in the Checked Value box to indicate a user chose skiing.
Initial State Determines whether the radio button is selected when the form loads in the browser.
Dynamic Lets the server dynamically determine the initial state of the radio button. For example, you can use radio
buttonstovisuallypresentinformationstoredinadatabase record. At design time, you don’t know that information.
At run time the server reads the database record and checks the radio button if the value matches one you specified.
Class Applies CSS rules to the object.
Menu options
List/Menu Assigns a name to the menu. The name must be unique.
Type Indicates whether the menu drops down when clicked (the Menu option) or displays a scrollable list of items
(the List option). Select the Menu option if you want only one option to be visible when the form is displayed in a
browser. To display the other choices, the user must click the down arrow.
SelecttheListoptiontolistsomeoralltheoptionswhentheformisdisplayedinabrowser,toletusersselectmultiple
items.
September 4, 2007
DREAMWEAVER CS3
User Guide
608
Height (List type only) Sets the number of items displayed in the menu.
Selections (List type only) Indicates whether the user can select multiple items from the list.
List Values Opens a dialog box that lets you add the items to a form menu:
1Use the Plus (+) and Minus (–) buttons to add and remove items in the list.
2Enter label text and an optional value for each menu item.
Each item in the list has a label (the text that appears in the list) and a value (the value that is sent to the processing
application if the item is selected). If no value is specified, the label is sent to the processing application instead.
3Use the up and down arrow buttons to rearrange items in the list.
ItemsappearinthemenuinthesameorderastheyappearintheListValuesdialogbox.Thefirstitemonthelistis
the selected item when the page is loaded in a browser.
Dynamic Lets the server dynamically select an item in the menu when it is first displayed.
Class Lets you apply CSS rules to the object.
Initially Selected Sets the items selected in the list by default. Click the item or items in the list.
Hidden field object options
HiddenField Specifies the name for the field.
Value Assigns a value to the field. This value is passed to the server when the form is submitted.
Class Applies CSS rules to the object.
About dynamic form objects
Adynamic form object is a form object whose initial state is determined by the server when the page is requested
from the server, not by the form designer at design time. For example, when a user requests a PHP page that contains
a form with a menu, a PHP script in the page automatically populates the menu with values stored in a database. The
server then sends the completed page to the user’s browser.
Making form objects dynamic can simplify site maintenance. For example, many sites use menus to present users
with a set of options. If the menu is dynamic, you can add, remove, or change menu items in a single place—the
database table in which the items are stored—to update all instances of the same menu on the site.
See also
“Defining sources of dynamic content” on page 547
Insert or change a dynamic HTML form menu
YoucandynamicallypopulateanHTMLformmenuorlistmenuwithentriesfromadatabase.Formostpages,you
can use an HTML menu object.
Note: For ASP.NET pages, you must use a DropDownList or ListBox form control.
Before you begin, you must insert an HTML form in a ColdFusion, PHP, ASP, or JSP page, and you must define a
recordset or other source of dynamic content for the menu.
1Insert an HTML List/Menu form object in your page:
aClick inside the HTML form on the page (Insert > Form > Form).
September 4, 2007
DREAMWEAVER CS3
User Guide
609
bSelect Insert > Form > List/Menu to insert the form object.
2Do one of the following:
•Select the new or an existing HTML List/Menu form object, and then click the Dynamic button in the Property
inspector.
•Select Insert > Data Objects > Dynamic Data > Dynamic Select List.
3Complete the Dynamic List/Menu dialog box, and click OK.
aIn the Options From Recordset pop-up menu, select the recordset to use as a content source. You also use this
menu to edit both static and dynamic list/menu items later.
bIn the Static Options area, enter a default item in the list or menu. Also, use this option to edit static entries in a
list/menu form object after adding dynamic content.
c(Optional) Use the Plus (+) and Minus (–) buttons to add and remove items in the list. Items are in the same order
as in the Initial List Values dialog box. The first item on the list is the selected item when the page is loaded in a
browser. Use the up and down arrow buttons to rearrange items in the list.
dIn the Values pop-up menu, select the field containing the values of the menu items.
eIn the Labels pop-up menu, select the field containing the labels for the menu items.
f(Optional) To specify that a particular menu item is selected when the page opens in a browser or when a record
is displayed in the form, enter a value equal to the menu item’s value, in the Select Value Equal To box.
You can enter a static value or you can specify a dynamic one by clicking the lightning bolt icon beside the box, and
selectingadynamicvaluefromthelistofdatasources.Ineithercase,thevalueyouspecifyshouldmatchoneofthe
menu item values.
Make existing HTML form menus dynamic
1In Design view, select the list/menu form object.
2In Property inspector, click the Dynamic button.
3Complete the dialog box, and click OK.
Display dynamic content in HTML text fields
You can display dynamic content in HTML text fields when the form is viewed in a browser.
Note: For ASP.NET pages, you must use the ASP.NET TextBox control.
Before you begin, you must create the form in a ColdFusion, PHP, ASP, or JSP page, and you must define a recordset
or other source of dynamic content for the text field.
1Select the text field in the HTML form on your page.
2
In the Property inspector, click the lightning bolt icon beside the Init Val box to display the Dynamic Data dialog box.
3Select the recordset column that will supply a value to the text field, and then click OK.
Set the Dynamic Text Field dialog box options
1Select the text field to make dynamic from the Text Field pop-up menu.
2Click the lightning bolt icon beside the Set Value To box, select a data source from the list of data sources, and
click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
610
The data source should contain textual information. If no data sources appear in the list, or if the available data
sources don’t meet your needs, click the Plus (+) button to define a new data source.
See also
“Data sources for web applications” on page 531
Dynamically preselect an HTML check box
You can let the server decide whether to select a check box when the form is displayed in a browser.
Before you begin, you must create the form in a ColdFusion, PHP, ASP, or JSP page, and you must define a recordset
orothersourceofdynamiccontentforthecheckboxes.Ideally,thesourceofcontentshouldcontainBooleandata,
such as Yes/No or true/false.
Note: For ASP.NET pages, you must use the ASP.NET CheckBox control.
1Select a check box form object on your page.
2In the Property inspector, click the Dynamic button.
3Complete the Dynamic CheckBox dialog box, and click OK:
•Click the lightning bolt icon beside the Check If box and select the field from the list of data sources.
ThedatasourcemustcontainBooleandatasuchasYes and No,ortrue and false. If no data sources appear in the
list, or if the available data sources don’t meet your needs, click the Plus (+) button to define a new data source.
•In the Equal To box, enter the value the field must have for the check box to appear selected.
For example, for the check box to appear selected when a specific field in a record has a value of Yes, enter Yes in
the Equal To box.
Note: This value is also returned to the server if the user clicks the form’s Submit button.
Dynamically preselect an HTML radio button
Dynamically preselect an HTML radio button when a record is displayed in the HTML form in a browser.
Before you begin, you must create the form in a ColdFusion, PHP, ASP, or JSP page, and insert at least one group of
HTML radio buttons (Insert > Form > Radio Group). You must also define a recordset or other source of dynamic
content for the radio buttons. Ideally, the source of content should contain Boolean data, such as Yes/No or true/false.
Note: For ASP.NET pages, you must use the ASP.NET RadioButtonList control.
1In Design view, select a radio button in the radio group.
2In the Property inspector, click the Dynamic button.
3Complete the Dynamic Radio Group dialog box, and click OK.
Set the Dynamic Radio Group dialog box options
1In the Radio Button Group pop-up menu, select a form and radio button group in the page.
The Radio Button Value box displays the values of all radio buttons in the group.
2Select a value to dynamically preselect from the list of values. This value is displayed in the Value box.
3Click the lightning bolt icon beside the Select Value Equal To box and select a recordset that contains possible
checked values for the radio buttons in the group.
September 4, 2007
DREAMWEAVER CS3
User Guide
611
The recordset you select contains values that match the radio buttons’ checked values. To view the checked values of
the radio buttons, select each radio button and open its Property inspector (Window > Properties).
4Click OK.
Set the Dynamic Radio Group dialog box options (ColdFusion, ASP.NET)
1Select a radio group and form from the Radio Group pop-up menu.
2Click the lightning bolt icon next to Select Value Equal To box.
3Complete the Dynamic Data dialog box, and click OK.
aSelect a data source from the list of data sources.
b(Optional) Select a data format for the text.
c(Optional) Modify the code that Dreamweaver inserts in your page to display the dynamic text.
4Click OK to close the Dynamic Radio Group dialog box, and insert the dynamic content placeholder in the Radio
Group.
Validate HTML form data
Dreamweaver can add JavaScript code that checks the contents of specified text fields to ensure that the user has
entered the correct type of data.
You can use Spry form widgets to build your forms and validate the contents of specified form elements. For more
information, consult the Spry topics listed below.
You can also build ColdFusion and ASP.NET forms in Dreamweaver that validate the contents of specified fields. For
ASP.NET forms, you can insert ASP.NET validation controls in Code view. For more information, consult the
ColdFusion and ASP.NET chapter listed below.
1Create an HTML form that includes at least one text field and one Submit button.
Make sure every text field that you want to validate has a unique name.
2Select the Submit button.
3In the Behaviors panel (Window > Behaviors), click the Plus (+) button and select the Validate Form behavior
from the list.
4Set the validation rules for each text field, and click OK.
For example, you might specify that a text field for a person’s age accepts only numbers.
Note: The Validate Form behavior is available only if a text field has been inserted into the document.
See also
“Working with the Validation Text Field widget” on page 464
“Working with the Validation Text Area widget” on page 469
“Working with the Validation Select widget” on page 472
“Working with the Validation Checkbox widget” on page 475
“Building ASP.NET and ColdFusion forms” on page 674
“Validate ColdFusion form data” on page 685
September 4, 2007
DREAMWEAVER CS3
User Guide
612
Attach JavaScript behaviors to HTML form objects
You can attach JavaScript behaviors stored in Dreamweaver to HTML form objects such as buttons.
Note: This feature does not work with ASP.NET form controls because these controls are processed on the server.
1Select the HTML form object.
2In the Behaviors panel (Window > Behaviors), click the Plus (+) button, and select a behavior from the list.
Attach custom scripts to HTML form buttons
Some forms use JavaScript or VBScript to perform form processing or some other action on the client as opposed to
sending the form data to the server for processing. You can use Dreamweaver to configure a form button to run a
specific client-side script when the user clicks the button.
Note: This feature does not work with ASP.NET forms.
1Select a Submit button in a form.
2In the Behaviors panel (Window > Behaviors), click the Plus (+) button, and select Call JavaScript from the list.
3In the Call JavaScript box, enter the name of the JavaScript function to run when the user clicks the button, and
click OK.
For example, you can enter the name of a function that doesn’t exist yet, such as processMyForm().
4If your JavaScript function doesn’t exist in the head section of the document yet, add it now.
For example, you could define the following JavaScript function in the head section of the document to display a
message when the user clicks the Submit button:
function processMyForm(){
alert('Thanks for your order!');
}
See also
“Apply the Call JavaScript behavior” on page 350
Create accessible HTML forms
When you insert an HTML form object, you can make the form object accessible, and change the accessibility
attributes later.
Add an accessible form object
1The first time you add accessible form objects, activate the Accessibility dialog box for form objects (see
“Optimizing the workspace for visual development” on page 538).
This is a one-time-only step.
2In the document, place the insertion point where you want the form object to appear.
3Select Insert > Form, and select a form object to insert.
The Input Tag Accessibility Attributes dialog box appears.
4Complete the dialog box, and click OK. Here is a partial list of options:
September 4, 2007
DREAMWEAVER CS3
User Guide
613
Note: The screen reader reads the name you enter as the Label attribute for the object.
ID assigns an ID to the form field. This value can be used to refer to the field from JavaScript; it's also used as the
value of the for attribute if you choose the Attach Label Tag Using For option under the Style options.
Wrap With Label Tag Wraps a label tag around the form item, as follows:
<label>
<input type="radio" name="radiobutton" value="radiobutton">
RadioButton1</label>
Attach Label Tag Using For Uses the for attribute to wrap a label tag around the form item, as follows:
<input type="radio" name="radiobutton" value="radiobutton" id="radiobutton">
<label for="radiobutton">RadioButton2</label>
This choice causes the browser to render text associated with a check box and radio button with a focus rectangle,
and enables the user to select the check box and radio button by clicking anywhere in the associated text instead of
just the check box or radio button control.
Note: This is the preferred option for accessibility; however, the functionality may vary depending on the browser.
No Label Tag Does not use a label tag, as follows:
<input type="radio" name="radiobutton" value="radiobutton">
RadioButton3
Access Key Uses a keyboard equivalent (one letter) and the Alt key (Windows) or the Control key (Macintosh) to
selecttheformobjectinthebrowser.Forexample,ifyouenterBas the Access Key, users with a Macintosh browser
could type Control+B to select the form object.
Tab Index Specifies a tab order for the form objects. If you set tab order for one object, you must set the tab order for
all objects.
Setting a tab order is useful when you have other links and form objects on the page and need the user to tab through
them in a specific order.
5Click Yes to insert a form tag.
The form object appears in the document.
Note: If you press Cancel, the form object appears in the document, but Dreamweaver does not associate accessibility
tags or attributes with it.
Edit accessibility values for a form object
1In the Document window, select the object.
2Do one of the following:
•Edit the appropriate attributes in Code view.
•Right-click (Windows) or Control-click (Macintosh), and then select Edit Tag.
September 4, 2007
614
Chapter 20: Building applications visually
In Adobe® Dreamweaver® CS3, you can use Adobe ColdFusion, PHP, JSP, ASP, or ASP. NET to build pages that let
you search, insert, delete, and update database records, display master and detail information, and restrict access to
certain users.
Building master and detail pages (all servers)
About master and detail pages
Master and detail pages are sets of pages used to organize and display recordset data. These pages provide a visitor
to your site with both an overview and a detailed view. The master page lists all of the records and contains links to
detail pages that display additional information about each record.
Master page
September 4, 2007
DREAMWEAVER CS3
User Guide
615
Detail page
You can build master and detail pages by inserting a data object to create a master page and detail page in one
operation or by using server behaviors to build the master and detail pages in a more customized way. When using
server behaviors to build master and detail pages, you first create a master page to list the records and then add links
from the list to the detail pages.
See also
“About search and results pages” on page 624
Build a master page
Before you start, ensure that you define a database connection for your site.
1To create a blank page, select File > New > Blank Page, select a page type, and click Create. This page becomes the
master page.
2Define a recordset.
In the Bindings panel (Windows > Bindings), click the Plus (+) button, select Recordset (ColdFusion, PHP) or
DataSet (ASP.NET), and choose options. If you want to write your own SQL statement, click Advanced.
Ensurethattherecordsetcontainsallthetablecolumnsyouneedtocreateyourmasterpage.Therecordsetmustalso
include the table column containing the unique key of each record—that is, the record ID column. In the following
example, the Code column contains the unique key of each record.
September 4, 2007
DREAMWEAVER CS3
User Guide
616
Recordset columns selected for a master page
Typically,therecordsetonthemasterpageextractsafewcolumnsfromadatabasetablewhilerecordsetonthedetail
page extracts more columns from the same table to provide the extra detail.
The recordset can be defined by the user at run time. For more information, see “Building search and results pages
(ColdFusion, ASP, JSP, PHP)” on page 624.
3(ColdFusion, PHP) Insert a dynamic table to display the records.
Place the insertion point where you want the dynamic table to appear on the page. Select Insert > Data Objects >
Dynamic Data > Dynamic Table, set the options, and click OK.
If you don’t want to show record IDs to users, you can delete the column from the dynamic table. Click anywhere on
the page to move the focus to the page. Move the cursor near the top of the column in the dynamic table until the
column cells are outlined in red, and then click to select the column. Press Delete to delete the column from the table.
4(ASP.NET) Create a DataGrid to display the records.
September 4, 2007
DREAMWEAVER CS3
User Guide
617
In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button, and select DataGrid. Accept
the default column type of Simple Data Field for each column in your DataGrid. The following example shows three
columns defined for a DataGrid:
See also
“Define a recordset without writing SQL” on page 547
“Define an advanced recordset by writing SQL” on page 550
“Create a dynamic table” on page 575
Create links to the detail page
After building the master page and adding the recordset, you create links that open the detail page. You then modify
the links to pass the IDs of the records the user selects. The detail page uses this ID to find the requested record in
the database and display it.
Note: You create links to update pages using the same process. The results page is similar to a master page, and the update
page is similar to a detail page.
See also
“Building pages to update a record (all servers)” on page 637
Open the detail page and pass a record ID (ColdFusion, PHP)
1In the dynamic table, select the content placeholder for text that will serve as a link.
Links applied to placeholder selected.
September 4, 2007
DREAMWEAVER CS3
User Guide
618
2In the Property inspector, click the folder icon beside the Link box.
3Browse and select the detail page. The detail page appears in the Link box in the Property inspector.
In the dynamic table, the selected text appears linked. When the page runs on the server, the link is applied to the
text in every table row.
4On the master page, select the link in the dynamic table.
If Live Data view is enabled, select the link in the first row.
5(ColdFusion) In the Link box in the Property inspector, add the following string at the end of the URL:
?recordID=#recordsetName.fieldName#
ThequestionmarktellstheserverthatwhatfollowsisoneormoreURLparameters.ThewordrecordIDisthename
of the URL parameter (you can make up any name you like). Make a note of the name of the URL parameter because
you'll use it in the detail page later.
The expression after the equal sign is the value of the parameter. In this case, the value is generated by a ColdFusion
expression that returns a record ID from the recordset. A different ID is generated for each row in the dynamic table.
In the ColdFusion expression, replace recordsetName with the name of your recordset, and replace fieldName with
the name of the field in your recordset that uniquely identifies each record. In most cases, the field will consist of a
record ID number. In the following example, the field consists of unique location codes.
locationDetail.cfm?recordID=#rsLocations.CODE#
When the page runs, the values of the recordset's CODE field are inserted in the corresponding rows in the dynamic
table. For example, if the Canberra, Australia, rental location has the code CBR, the following URL is used in the
Canberra row in the dynamic table:
locationDetail.cfm?recordID=CBR
6(PHP) In the Link field in the Property inspector, add the following string at the end of the URL:
?recordID=<?php echo $row_recordsetName['fieldName']; ?>
ThequestionmarktellstheserverthatwhatfollowsisoneormoreURLparameters.ThewordrecordID is the name
of the URL parameter (you can use any name you like). Make a note of the name of the URL parameter because you’ll
use it in the detail page later.
The expression after the equal sign is the value of the parameter. In this case, the value is generated by a PHP
expression that returns a record ID from the recordset. A different ID is generated for each row in the dynamic table.
In the PHP expression, replace recordsetName with the name of your recordset, and replace fieldName with the
name of the field in your recordset that uniquely identifies each record. In most cases, the field will consist of a record
ID number. In the following example, the field consists of unique location codes.
locationDetail.php?recordID=<?php echo $row_rsLocations['CODE']; ?>
When the page runs, the values of the recordset’s CODE field are inserted in the corresponding rows in the dynamic
table. For example, if the Canberra, Australia, rental location has the code CBR, the following URL is used in the
Canberra row in the dynamic table:
locationDetail.php?recordID=CBR
7Save the page.
Open the detail page and pass a record ID (ASP, JSP)
1Select the dynamic content to double as a link.
September 4, 2007
DREAMWEAVER CS3
User Guide
619
2In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button, and select Go to Detail Page
from the pop-up menu.
3In the Detail Page box, click Browse and locate the page.
4Specify the value you want to pass to the detail page by selecting a recordset and a column from the Recordset and
Column pop-up menus. Typically the value is unique to the record, such as the record’s unique key ID.
5If desired, pass existing page parameters to the detail page by selecting the URL Parameters or Form Parameters
options.
6Click OK.
A special link surrounds the selected text. When the user clicks the link, the Go To Detail Page server behavior passes
a URL parameter containing the record ID to the detail page. For example, if the URL parameter is called id and the
detail page is called customerdetail.asp, the URL looks something like the following when the user clicks on the link:
http://www.mysite.com/customerdetail.asp?id=43
The first part of the URL, http://www.mysite.com/customerdetail.asp, opens the detail page. The second part,
?id=43, is the URL parameter. It tells the detail page what record to find and display. The term id is the name of the
URL parameter and 43 is its value. In this example, the URL parameter contains the record’s ID number, 43.
Open a detail page and pass a record ID (ASP.NET)
1Double-click your DataGrid in the Server Behaviors panel (Window > Server Behaviors).
2In the Columns box, select the title of the column to apply links to.
3Click the Change Column Type button and select Hyperlink from the pop-up menu. The Hyperlink Column
dialog box appears.
4In the Hyperlink Text area, specify the text to be displayed in the hyperlink column.
Static Text Enter the text for the link to create a generic link, such as Details, for each row in the DataGrid. Each row
in the DataGrid displays the same text (such as Details) in the hyperlink column.
Data Field Select a data field in your DataSet to add links to data displayed in the column. The data field provides
the text for the links in your hyperlink column. In the following example, each row in the DataGrid displays a
location name:
5In the Linked Page area, build the URL to apply to the text in the hyperlink column.
The URL not only has to open the detail page, it must uniquely identify the record to display on that page.
To identify the record to display on the detail page, select the Data Field option and select a field in your DataSet that
uniquely identifies each record. In most cases, the field consists of a record ID number. In the following example, the
field consists of unique location codes:
6
In the Format String box in the Linked Page area, click the Browse button, and then locate and select your detail page.
September 4, 2007
DREAMWEAVER CS3
User Guide
620
Dreamweaver creates a URL to the detail page that includes a URL parameter identifying the record the detail page
should display. Make a note of the name of the URL parameter because you’ll use it in the detail page later.
For example, if you select locationDetail.aspx as your detail page, the following URL is created:
In this case, the URL parameter is called CODE.Dreamweavercopiesthenameofthedatafield,butyoudon’thaveto
use that name. You can change it to something more descriptive, such as recordID, as the following example shows:
The {0} element is a placeholder corresponding to the data field’s value. When the page runs, the values of the
DataSet’s CODE field are inserted in the corresponding rows in the DataGrid. For example, if the Canberra,
Australia, rental location has the code CBR, the following URL is used in the Canberra row in the DataGrid:
locationDetail.aspx?recordID=CBR
7Click OK to close the Hyperlink dialog box; then click OK to close the DataGrid dialog box.
The DataGrid on your page updates.
Find and display the requested record on the detail page
In order to display the record requested by the master page, you must define a recordset to hold a single record and
bind the recordset columns to the detail page.
1Switch to the detail page. If you don’t have a detail page yet, create a blank page (File > New).
2In the Bindings panel (Window > Bindings), click the Plus (+) button and select Recordset (Query) or DataSet
(Query) from the pop-up menu.
The simple Recordset or DataSet dialog box appears. If the advanced dialog box appears instead, click Simple.
3Name the recordset, and select a data source and the database table that will provide data to your recordset.
4In the Columns area, select the table columns to include in the recordset.
The recordset can be identical to or different from the recordset on the master page. Usually a detail page recordset
has more columns to display more detail.
If the recordsets are different, make sure the recordset on the detail page contains at least one column in common
with the recordset on the master page. The common column is usually the record ID column, but it can also be the
join field of related tables.
To include only some of the table’s columns in the recordset, click Selected and choose the desired columns by
Control-clicking (Windows) or Command-clicking (Macintosh) them in the list.
September 4, 2007
DREAMWEAVER CS3
User Guide
621
5Complete the Filter section as to find and display the record specified in the URL parameter passed by the master
page:
•From the first pop-up menu in the Filter area, select the column in the recordset containing values that match the
value of the URL parameter passed by the master page. For example, if the URL parameter contains a record ID
number, select the column containing record ID numbers. In the example discussed in the previous section, the
recordset column called CODE contains the values that match the value of the URL parameter passed by the
master page.
•From the pop-up menu beside the first menu, select the equal sign (it should already be selected).
•From the third pop-up menu, select URL Parameter. The master page uses a URL parameter to pass information
to the detail page.
•In the fourth box, enter the name of the URL parameter passed by the master page.
6Click OK. The recordset appears in the Bindings panel.
7Bind the recordset columns to the detail page by selecting the columns in the Bindings panel (Window >
Bindings) and dragging them onto the page.
After uploading both the master and detail pages to the server, you can open the master page in a browser. After
clicking a detail link on the master page, the detail page opens with more information about the selected record.
See also
“Set up a testing server” on page 48
Create a link to open a related page (ASP, JSP)
You can create a link that opens a related page and that passes existing parameters to that page. The server behavior
is only available when using the ASP or JSP server models.
Before adding a Go To Related Page server behavior to a page, make sure the page receives form or URL parameters
from another page. The job of the server behavior is to pass these parameters to a third page. For example, you can
pass search parameters received by a results page to another page and save the user from entering the search param-
eters again.
Also, you can select text or an image on the page to serve as the link to the related page, or you can position your
pointer on the page without selecting anything, and the link text is inserted.
1In the Go To Related Page box, click Browse and locate the related page file.
If the current page submits data to itself, enter the current page’s file name.
2If the parameters you want to pass were received directly from an HTML form using the GET method, or are listed
in the page’s URL, select the URL Parameters option.
3If the parameters you want to pass were received directly from an HTML form using the POST method, select the
Form Parameters option.
4Click OK.
When the new link is clicked, the page passes the parameters to the related page using a query string.
See also
“Collecting data submitted by users” on page 532
September 4, 2007
DREAMWEAVER CS3
User Guide
622
Find a specific record and display it on a page (ASP, JSP)
You can add a server behavior that finds a specific record in a recordset so that you can display the record data on
the page. The server behavior is only available when using the ASP or JSP server models.
1Create a page that has the following prerequisites:
•A record ID contained in a URL parameter passed by another page to the current page. You can create URL
parameters on the other page with HTML hyperlinks or with an HTML form. For more information, see
“Collecting data submitted by users” on page 532.
•A recordset defined for the current page. The server behavior extracts the record details from this recordset. For
instructions, see “Define a recordset without writing SQL” on page 547 or “Define an advanced recordset by
writing SQL” on page 550.
•Recordset columns bound to the page. The specific record must be displayed on the page. For more information,
see “Make text dynamic” on page 564.
2Add the server behavior to find the record specified by the URL parameter by clicking the Plus (+) button on the
Server Behaviors panel (Window > Server Behaviors) and selecting Recordset Paging > Move to Specific Record.
3In the Move To Record In pop-up menu, select the recordset you defined for the page.
4In the Where Column pop-up menu, select the column that contains the value passed by the other page.
For example, if the other page passes a record ID number, select the column containing record ID numbers.
5In the Matches URL Parameter box, enter the name of the URL parameter passed by the other page.
For example, if the URL the other page used to open the detail page is id=43, enter
id
in the Matches URL Parameter box.
6Click OK.
The next time the page is requested by a browser, the server behavior will read the record ID in the URL parameter
passed by the other page and move to the specified record in the recordset.
Build master and detail pages in one operation (ColdFusion, ASP, JSP, PHP)
When developing web applications, you can quickly build master and detail pages using the Master Detail Page Set
data object.
1To create a blank dynamic page, select File > New > Blank Page, select a dynamic page from the Page Type list,
and click Create.
This page becomes the master page.
2Define a recordset for the page.
Make sure the recordset contains not only all the columns you’ll need for the master page, but also all the columns
you’ll need for the detail page. Typically, the recordset on the master page extracts a few columns from a database
table while the recordset on the detail page extracts more columns from the same table to provide the extra detail.
3Open the master page in Design view, and select Insert > Data Objects > Master Detail Page Set.
4In the Recordset pop-up menu, make sure the recordset containing the records you want to display on the master
page is chosen.
5In the Master Page Fields area, select the recordset columns to display on the master page.
By default, all the columns in the recordset are selected. If your recordset contains a unique key column such as
recordID, select it and click the Minus (-) button so that it is not displayed on your page.
September 4, 2007
DREAMWEAVER CS3
User Guide
623
6To change the order in which the columns appear on the master page, select a column in the list and click the up
or down arrow.
Onthemasterpage,therecordsetcolumnswillbearrangedhorizontallyinatable.Clickingtheuparrowmovesthe
column to the left; clicking the down arrow moves the column to the right.
7In the Link To Detail From pop-up menu, select the column in the recordset that will display a value that also
serves as a link to the detail page.
Forexample,ifyouwanteachproductnameonyourmasterpagetohavealinktothedetailpage,selecttherecordset
column containing product names.
8In the Pass Unique Key pop-up menu, select the column in the recordset containing values identifying the records.
Usually,thecolumnchosenistherecordIDnumber.Thisvalueispassedtothedetailpagesothatitcanidentifythe
record chosen by the user.
9Deselect the Numeric option if the unique key column is not numeric.
Note: This option is selected by default; it does not appear for all server models.
10 Specify the number of records to display on the master page.
11 In the Detail Page Name box, click Browse and locate the detail page file you created, or enter a name and let the
data object create one for you.
12 In the Detail Page Fields area, select the columns to be displayed on the detail page.
By default, all the columns in the master page’s recordset are selected. If the recordset contains a unique key column
such as recordID, select it and click the Minus (-) button so that it is not displayed on the detail page.
13 To change the order in which the columns appear on the detail page, select a column in the list and click the up
or down arrow.
On the detail page, the recordset columns are arranged vertically in a table. Clicking the up arrow moves the column
up; clicking the down arrow moves the column down.
14 Click OK.
The data object creates a detail page (if you didn’t already create one) and adds dynamic content and server behaviors
to both the master and detail pages.
15 Customize the layout of the master and detail pages to suit your needs.
You can fully customize the layout of each page by using the Dreamweaver page-design tools. You can also edit the
server behaviors by double-clicking them in the Server Behaviors panel.
After creating master and detail pages with the data object, use the Server Behaviors panel (Window > Server
Behaviors) to modify the various building blocks the data object inserts into the pages.
See also
“Edit dynamic content” on page 568
“Defining sources of dynamic content” on page 547
September 4, 2007
DREAMWEAVER CS3
User Guide
624
Building search and results pages (ColdFusion, ASP,
JSP, PHP)
About search and results pages
You can use Dreamweaver to build a set of pages to let users search your database and view the search results. The
method you use is identical for ColdFusion, ASP, JSP, and PHP pages.
In most cases, you need at least two pages to add this feature to your web application. The first page is a page that
contains an HTML form in which users enter search parameters. Although this page doesn’t do any actual searching,
it is referred to as the search page.
Thesecondpageyouneedistheresultspage,whichperformsmostofthework.Theresult’spagedoesthefollowing
tasks:
•Reads the search parameters submitted by the search page
•Connects to the database and search for records
•Builds a recordset with the records found
•Displays the contents of the recordset
Optionally, you can add a detail page. A detail page gives users more information about a particular record on the
results page.
If you use ASP.NET, you can combine both the search page and the results page into one page.
If you have only one search parameter, Dreamweaver lets you add search capabilities to your web application without
using SQL queries and variables. Simply design your pages and complete a few dialog boxes. If you have more than
one search parameter, you need to write a SQL statement and define multiple variables for it.
Dreamweaver inserts the SQL query in your page. When the page runs on the server, each record in the database
table is checked. If the specified field in a record meets your SQL query conditions, the record is included in a
recordset. The SQL query in effect builds a recordset containing only the search results.
For example, field sales staff might have information about customers in a certain area who have incomes above a
certainlevel.Inaformonasearchpage,thesalesassociateentersageographicalareaandaminimumincomelevel,
and then clicks the Submit button to send the two values to a server. On the server, the values are passed to the results
page’s SQL statement, which then creates a recordset containing only customers in the specified area with incomes
above the specified level.
See also
“Defining sources of dynamic content” on page 547
“Building search and results pages (ColdFusion, ASP, JSP, PHP)” on page 624
“Building a database search page (ASP.NET)” on page 629
Build the search page (ColdFusion, ASP, JSP, PHP)
A search page on the web typically contains form fields in which the user enters search parameters. At minimum,
your search page must have an HTML form with a Submit button.
September 4, 2007
DREAMWEAVER CS3
User Guide
625
To add an HTML form to a search page, complete the following procedure.
1Open the search page or a new page, and select Insert > Form > Form.
Anemptyformiscreatedonthepage.YoumightneedtoenableInvisibleElements(View>VisualAids>Invisible
Elements) to see the form’s boundaries, which are represented by thin red lines.
2Add form objects for users to enter their search parameters by selecting Form from the Insert menu.
Form objects include text fields, menus, options, and radio buttons. You can add as many form objects as you want
to help users refine their searches. However, keep in mind that the greater the number of search parameters on the
search page, the more complex your SQL statement will be.
3Add a Submit button to the form (Insert > Form > Button).
4(Optional) Change the label of the Submit button by selecting the button, opening the Property inspector
(Window > Properties), and entering a new value in the Value box.
Next, you’ll tell the form where to send the search parameters when the user clicks the Submit button.
5Select the form by selecting the <form> tag in the tag selector at the bottom of the Document window, as the
following image shows:
6In the Action box in the form’s Property inspector, enter the filename of the results page that will conduct the
database search.
7In the Method pop-up menu, select one of the following methods to determine how the form sends data to the
server:
•GET sends the form data by appending it to the URL as a query string. Because URLs are limited to 8192 characters,
don’t use the GET method with long forms.
•POST sends the form data in the body of a message.
•Default uses the browser’s default method (usually GET).
The search page is done.
See also
“About search and results pages” on page 624
“Creating forms” on page 600
Build a basic results page (ColdFusion, ASP, JSP, PHP)
When the user clicks the form’s Search button, the search parameters are sent to a results page on the server. The
results page on the server, not the search page on the browser, is responsible for retrieving records from the database.
Ifthesearchpagesubmitsasinglesearchparametertotheserver,youcanbuildtheresultspagewithoutSQLqueries
and variables. You create a basic recordset with a filter that excludes records that don’t meet the search parameter
submitted by the search page.
Note: If you have more than one search condition, you must use the advanced Recordset dialog box to define your
recordset (see “Build an advanced results page (ColdFusion, ASP, JSP, PHP)” on page 627).
September 4, 2007
DREAMWEAVER CS3
User Guide
626
See also
“About search and results pages” on page 624
“Build the search page (ColdFusion, ASP, JSP, PHP)” on page 624
“Create a detail page for a results page (ColdFusion, ASP, JSP, PHP)” on page 629
Create the recordset to hold the search results
1Open your results page in the Document window.
If you don’t have a results page yet, create a blank dynamic page (File > New > Blank Page).
2Create a recordset by opening the Bindings panel (Window > Bindings), clicking the Plus (+) button, and selecting
Recordset from the pop-up menu.
3Make sure the simple Recordset dialog box appears.
If the advanced dialog box appears instead, switch to the simple dialog box by clicking the Simple button.
4Enter a name for the recordset, and select a connection.
The connection should be to a database containing data you want the user to search.
5In the Table pop-up menu, select the table to be searched in the database.
Note: In a single-parameter search, you can search for records in only a single table. To search more than one table at a
time, you must use the advanced Recordset dialog box and define a SQL query.
6To include only some of the table’s columns in the recordset, click Selected and select the desired columns by
Control-clicking (Windows) or Command-clicking (Macintosh) them in the list.
You should include only the columns containing information you want to display on the results page.
Leave the Recordset dialog box open for now. You’ll use it next to retrieve the parameters sent by the search page and
create a recordset filter to exclude records that don’t meet the parameters.
Create the recordset filter
1From the first pop-up menu in the Filter area, select a column in the database table in which to search for a match.
September 4, 2007
DREAMWEAVER CS3
User Guide
627
For example, if the value sent by the search page is a city name, select the column in your table that contains city
names.
2From the pop-up menu beside the first menu, select the equal sign (it should be the default).
3From the third pop-up menu, select Form Variable if the form on your search page uses the POST method, or URL
Parameter if it uses the GET method.
The search page uses either a form variable or a URL parameter to pass information to the results page.
4In the fourth box, enter the name of the form object that accepts the search parameter on the search page.
The name of the object doubles as the name of the form variable or URL parameter. You can get the name by
switching to the search page, clicking the form object on the form to select it, and checking the object’s name in the
Property inspector.
For example, suppose you want to create a recordset that includes only adventure trips to a specific country. Assume
youhaveacolumninthetablecalledTRIPLOCATION. Also assume the HTML form on your search page uses the GET
method and contains a menu object called Location that displays a list of countries. The following example shows
how your Filter section should look:
5(Optional) Click Test, enter a test value, and click OK to connect to the database and create an instance of the
recordset.
The test value simulates the value that would otherwise have been returned from the search page. Click OK to close
the test recordset.
6If you’re satisfied with the recordset, click OK.
A server-side script is inserted on your page that checks each record in the database table when it runs on the server.
If the specified field in a record meets the filtering condition, the record is included in a recordset. The script builds
a recordset that contains only the search results.
The next step is to display the recordset on the results page. For more information, see “Display the search results
(ColdFusion, ASP, JSP, PHP)” on page 628.
Build an advanced results page (ColdFusion, ASP, JSP, PHP)
If the search page submits more than one search parameter to the server, you must write a SQL query for the results
page and use the search parameters in SQL variables.
Note: If you have only one search condition, you can use the simple Recordset dialog box to define your recordset (see
“Build a basic results page (ColdFusion, ASP, JSP, PHP)” on page 625).
1Open the results page in Dreamweaver, and then create a recordset by opening the Bindings panel (Window >
Bindings), clicking the Plus (+) button, and selecting Recordset from the pop-up menu.
2Make sure the advanced Recordset dialog box appears.
TheadvanceddialogboxhasatextareatoenterSQLstatements.Ifthesimpledialogboxappearsinstead,switchto
the advanced dialog box by clicking the Advanced button.
3Enter a name for the recordset, and select a connection.
The connection should be to a database containing data you want the user to search.
September 4, 2007
DREAMWEAVER CS3
User Guide
628
4Enter a Select statement in the SQL text area.
Make sure the statement includes a WHERE clause with variables to hold the search parameters. In the following
example, the variables are called varLastName and varDept:
SELECT EMPLOYEEID, FIRSTNAME, LASTNAME, DEPARTMENT, EXTENSION ¬
FROM EMPLOYEE WHERE LASTNAME LIKE 'varLastName' AND DEPARTMENT ¬
LIKE 'varDept'
To reduce the amount of typing, you can use the tree of database items at the bottom of the advanced Recordset
dialog box. For instructions, see “Define an advanced recordset by writing SQL” on page 550.
For help on SQL syntax, see the SQL primer at www.adobe.com/go/learn_dw_sqlprimer.
5Give the SQL variables the values of the search parameters by clicking the Plus (+) button in the Variables area
and entering the variable’s name, default value (the value the variable should take if no run-time value is returned),
and run-time value (usually a server object holding a value sent by a browser, such as a request variable).
In the following ASP example, the HTML form on the search page uses the GET method and contains one text field
called LastName and another called Department:
In ColdFusion, the run-time values would be #LastName# and #Department#. In JSP, the run-time values would be
request.getParameter("LastName") and request.getParameter("Department").
6(Optional) Click Test to create an instance of the recordset using the default variable values.
The default values simulate the values that would otherwise have been returned from the search page. Click OK to
close the test recordset.
7If you’re satisfied with the recordset, click OK.
The SQL query is inserted in your page.
The next step is to display the recordset on the results page.
Display the search results (ColdFusion, ASP, JSP, PHP)
After creating a recordset to hold the search results, you must display the information on the results page. Displaying
the records can be a simple matter of dragging individual columns from the Bindings panel to the results page. You
can add navigation links to move forward and backward through the recordset, or you can create a repeating region
to display more than one record on the page. You can also add links to a detail page.
For more information on methods of displaying dynamic content on a page other than displaying results in a
dynamic table, see “Displaying database records” on page 570.
1Place the insertion point where you want the dynamic table to appear on the results page, and select Insert > Data
Objects > Dynamic Data > Dynamic Table.
2Complete the Dynamic Table dialog box, selecting the recordset you defined to hold the search results.
3Click OK. A dynamic table that displays search results is inserted on the results page.
September 4, 2007
DREAMWEAVER CS3
User Guide
629
Create a detail page for a results page (ColdFusion, ASP, JSP, PHP)
Your set of search and results pages can include a detail page to display more information about specific records on
the results page. In this situation, your results page also doubles as the master page in a master-detail page set.
See also
“Build master and detail pages in one operation (ColdFusion, ASP, JSP, PHP)” on page 622
“Build the search page (ColdFusion, ASP, JSP, PHP)” on page 624
“Build a basic results page (ColdFusion, ASP, JSP, PHP)” on page 625
Building a database search page (ASP.NET)
About a database search page (ASP.NET)
You can use Dreamweaver to build a page that searches a database and displays the results in a DataGrid. You can
specify how the user can search the database by adding form controls, and control how the results are displayed.
See also
“About search and results pages” on page 624
Add the search controls (ASP.NET)
A search page on the web typically contains form fields in which the user enters search parameters. When the user
clicks a button, the search results are displayed.
1Open the search page, and select Insert > Form > Form.
An empty form is created on the page. You may have to enable Invisible Elements (View > Visual Aids > Invisible
Elements) to see the form’s boundaries, which are represented by thin red lines.
In the form’s Property inspector, you should select POST as the form’s Method attribute. You don’t need to specify an
Actionattributefortheform.TheASP.NETpagepostsbacktoitselfandthesearchresultsaredisplayedonthesamepage.
2Add form controls for users to enter their search parameters (Insert > ASP.NET Objects).
You can insert any ASP.NET form control, including a TextBox, CheckBox, RadioButton, ListBox, or DropDownList
control. You can add as many controls as you want to help users refine their searches. However, keep in mind that
the greater the number of search parameters on the search page, the more complex your SQL statement will be.
For each control, make sure you specify an ID attribute such as txtCity for a TextBox control or lbxCountry for a
ListBox control. For more information, see “Add ASP.NET form controls to a page” on page 686.
3Add an ASP.NET button to the form (Insert > ASP.NET Objects > asp:Button).
Make sure you specify an ID attribute for the button, such as btnSearch, and text for the button label, such as Search.
The search form is done. The next step in creating the search page is to define a DataSet to find and store the search
results.
September 4, 2007
DREAMWEAVER CS3
User Guide
630
Search with only one search parameter (ASP.NET)
When the user clicks the page’s Search button, the search parameter is sent to the server. The server processes the
request, builds a filtered DataSet based on the parameter, populates a DataGrid, and sends the page back to the
browser.
Before adding the DataGrid, you must define a DataSet that finds and stores all the records that meet the search
criteria.
Create a DataSet to hold the search results
1In the Bindings panel (Window > Bindings), click the Plus (+) button and select DataSet (Query).
Iftheadvanceddialogboxappears,clicktheSimplebuttontoopenthesimpledialogbox.Theadvanceddialogbox
has a text area to enter SQL statements; the simple one does not.
2Name the DataSet, and then select a connection and database table containing the data you want users to search.
3In the Columns area, click the Selected option and select a key column (usually the record ID column) and the
columns containing the data you want to display in the DataGrid.
Leave the DataSet dialog box open to retrieve the search parameters sent to the server and create a DataSet filter to
exclude records that don’t meet the parameters.
Create a DataSet filter
1From the first pop-up menu in the Filter area, select a column in the table to compare against the search parameter
sent by the search page.
For example, if the value sent by the search page is a city name, select the column in your table that contains city
names.
2From the pop-up menu beside the first menu, select the equal sign (it should be the default).
This choice states that the user wants only those records in which the selected table column is exactly the same as the
one specified on the search page. You can use a less restrictive option such as “begins with” or “contains.”
3From the third pop-up menu, select Form Variable.
The parameter is sent to the server by a form using the POST method.
4In the fourth box, enter the name of the form control that sent the search parameter to the server.
You can get the name by clicking the form control on the form to select it, and checking the control’s ID in the
Property inspector.
5If you want, click Test, enter a test value, and click OK to connect to the database and create an instance of the
DataSet.
The test value simulates the value that would otherwise have been returned from the search page. Click OK to close
the Dataset.
6If you’re satisfied with the DataSet, click OK.
Code is inserted in your page. When the code runs on the server, it checks each record in the database table. If the
specified field in a record meets the filtering condition, the record is included in a DataSet. The code builds a
recordset that contains only the search results.
The next step in creating the search page is to display the search results in a DataGrid. See “Display the results in a
DataGrid (ASP.NET)” on page 632.
September 4, 2007
DREAMWEAVER CS3
User Guide
631
Search with multiple search parameters (ASP.NET)
If the search page submits more than one search parameter to the server, you must write a SQL query and use the
search parameters in SQL variables.
Note: If you have only one search condition, you can use the simple DataSet dialog box to define your DataSet (see
“Search with only one search parameter (ASP.NET)” on page 630).
1Open the results page in Dreamweaver, and then create a DataSet by opening the Bindings panel (Window >
Bindings), clicking the Plus (+) button, and selecting DataSet from the pop-up menu.
2Make sure the advanced DataSet dialog box appears.
If the simple dialog box appears instead, switch to the advanced dialog box by clicking the Advanced button. The
advanced dialog box has a text area to enter SQL statements.
3Enter a name for the DataSet, and select a connection.
The connection should be to a database containing data you want the user to search.
4Enter a Select statement in the SQL text area.
Make sure the statement includes a WHERE clause with question mark (?) placeholders for the search parameters.
The following example contains two placeholders:
SELECT EMPLOYEEID, FIRSTNAME, LASTNAME, DEPARTMENT, EXTENSION
FROM EMPLOYEE WHERE LASTNAME LIKE ?
AND DEPARTMENT LIKE ?
5Give the placeholders the values of the search parameters by clicking the Plus (+) button in the Parameters area
and entering the parameter’s name, type, and value.
The parameters must be listed in the same order they appear in the SQL statement.
In the Name box, enter any valid parameter name. The name cannot contain any spaces or special characters.
In the Type pop-up menu, select a data type. For example, if the parameter will hold text, select WChar.
In the Value box, enter the server variable that will contain the parameter value. For example, if the name of the form
control on the search page is txtCity, a server variable called Request.Form(“txtCity”) will be created and a value is
stored in it.
You can also enter a more complete expression that specifies a default value in case the server variable doesn’t exist.
For example, if searching a Microsoft Access database, you can use % as a default value. The following expression
checks to see if the server variable Request.Form("txtCity") exists. If the variable exists (that is, if it’s not equal to
nothing), the expression returns the variable’s value; if it doesn’t exist, the expression returns the default value of %.
(IIf((Request.Form("txtCity") <> Nothing),
Request.Form("txtCity"), "")) + "%"
For more information, see a Visual Basic or C# language reference.
6If you want to, click Test to create an instance of the DataSet using the default variable values.
The default values simulate the values that would otherwise have been returned from the search page. Click OK to
close the test DataSet.
7If you’re satisfied with the DataSet, click OK.
The SQL query is inserted in your page.
The next step is to display the search results in a DataGrid.
September 4, 2007
DREAMWEAVER CS3
User Guide
632
Display the results in a DataGrid (ASP.NET)
After creating a DataSet to hold the search results, you can use a DataGrid to display the information on the page.
1On the search page, place the insertion point where you want the DataGrid to appear.
2In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select DataGrid.
The DataGrid dialog box appears.
3In the ID box, enter a name for the DataGrid such as dgLocation.
4In the DataSet pop-up menu, select the DataSet you defined to hold the search results.
5Complete the rest of the dialog box as desired.
The following example shows a DataGrid dialog box that creates a DataGrid with three columns and ten rows, and
links to previous and next pages of results:
The DataGrid appears the first time the search page loads even if the user hasn’t conducted a search yet. You can hide
the DataGrid when the page loads the first time.
See also
“Search with only one search parameter (ASP.NET)” on page 630
“Search with multiple search parameters (ASP.NET)” on page 631
Hide the DataGrid the first time the page loads (ASP.NET)
When the search page first loads, you can hide the DataGrid that will be used to display the search results.
1Open the search page in Code view (View > Code).
2Immediately following the Register directive at the top of the page, enter the following code block if the page
language is Visual Basic:
September 4, 2007
DREAMWEAVER CS3
User Guide
633
<script runat="server">
Sub Page_Load()
If Not IsPostBack Then
dgName.Visible = falseElse
dgName.Visible = trueEnd IfEnd Sub
</script>
where dgName is the ID of your DataGrid.
If the page language is C#, enter the following code:
<script runat="server">
void Page_Load() {
if (!IsPostBack) {
dgName.Visible = false;} else {
dgName.Visible = true;}}
</script>
3Save the page.
Creating a detail page (ASP.NET)
Your search page can include a detail page to display more information about specific records listed in the DataGrid.
In this situation, the search page acts as the master page in a master-detail page set. For more information, see
“Building master and detail pages (all servers)” on page 614.
Building a record insert page (all servers)
About building record insert pages
Your application can contain a page that lets users insert new records in a database.
For a tutorial on creating a record insert page, see www.adobe.com/go/learn_dw_webapp.
An insert page consists of two building blocks:
•An HTML form that lets users enter data
•An Insert Record server behavior that updates the database
When a user clicks Submit on a form, the server behavior inserts records in a database table.
You can add these building blocks in a single operation using the Record Insertion Form data object or you can add
them separately using the Dreamweaver form tools and the Server Behaviors panel.
Note: The insert page can contain only one record-editing server behavior at a time. For example, you cannot add an
Update Record or a Delete Record server behavior to the insert page.
Build an insert page block by block
You can also build an insert page by using the forms tools and server behaviors.
See also
“Creating forms” on page 600
September 4, 2007
DREAMWEAVER CS3
User Guide
634
Add an HTML form to an insert page
1Create a dynamic page (File > New > Blank Page), and lay out your page using the Dreamweaver design tools.
2Add an HTML form by placing the insertion point where you want the form to appear and selecting Insert >
Form > Form.
An empty form is created on the page. You may have to enable Invisible Elements (View > Visual Aids > Invisible
Elements) to see the form’s boundaries, which are represented by thin red lines.
3Name the HTML form by clicking the <form> tag at the bottom of the Document window to select the form,
opening the Property inspector (Window > Properties), and entering a name in the Form Name box.
You don’t need to specify an action or method attributefortheformtotellitwhereandhowtosendtherecorddata
when the user clicks the Submit button. The Insert Record server behavior sets these attributes for you.
4Add a form object such as a text field (Insert > Form > Text Field) for each column in the database table you want
to insert records into.
The form objects are for data entry. Text fields are common for this purpose, but you can also use menus, options,
and radio buttons.
5Add a Submit button to the form (Insert > Form > Button).
You can change the label of the Submit button by selecting the button, opening the Property inspector (Window >
Properties), and entering a new value in the Label box.
Add a server behavior to insert records in a database table (ColdFusion)
1In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select Insert Record
from the pop-up menu.
2Select a form from the Submit Values From pop-up menu.
3In the Data Source pop-up menu, select a connection to the database.
4Enter your user name and password.
5In the Insert Into Table pop-up menu, select the database table to insert the record in.
6Specify a database column to insert the record in, select the form object that will insert the record from the Value
pop-up menu, and then select a data type for the form object from the Submit As pop-up menu.
The data type is the kind of data the column in your database table is expecting (text, numeric, Boolean option
values).
Repeat the procedure for each form object in your form.
7In the After Inserting, Go To box, enter the page to open after the record is inserted in the table or click the Browse
button to browse to the file.
8Click OK.
Dreamweaver adds a server behavior to the page that lets users insert records in a database table by filling out the
HTML form and clicking the Submit button.
Add a server behavior to insert records in a database table (ASP, JSP)
1In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select Insert Record
from the pop-up menu.
2In the Connection pop-up menu, select a connection to the database.
Click the Define button if you need to define a connection.
September 4, 2007
DREAMWEAVER CS3
User Guide
635
3In the Insert Into Table pop-up menu, select the database table into which the record should be inserted.
4In the After Inserting, Go To box, enter the page to open after the record is inserted into the table or click Browse
to browse to the file.
5In the Get Values From pop-up menu, select the HTML form used to enter the data.
Dreamweaver automatically selects the first form on your page.
6Specify a database column to insert the record in, select the form object that will insert the record from the Value
pop-up menu, and then select a data type for the form object from the Submit As pop-up menu.
The data type is the kind of data the column in your database table is expecting (text, numeric, Boolean option
values).
Repeat the procedure for each form object in your form.
7Click OK.
Dreamweaver adds a server behavior to the page that lets users insert records in a database table by filling out the
HTML form and clicking the Submit button.
To edit the server behavior, open the Server Behaviors panel (Window > Server Behaviors) and double-click the
Insert Record behavior.
Add a server behavior to insert records in a database table (ASP.NET)
1In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select Insert Record
from the pop-up menu.
2Select a form from the Submit Values From pop-up menu.
3In the Connection pop-up menu, select a connection to the database.
Click the Define button if you need to define a connection.
4In the Insert Into Table pop-up menu, select the database table to insert the record in.
5Specify a database column to insert the record in, select the form object that will insert the record from the Value
pop-up menu, and then select a data type for the form object from the Submit As pop-up menu.
The data type is the kind of data the column in your database table is expecting (text, numeric, Boolean option
values).
Repeat the procedure for each form object in your form.
6In the On Success, Go To box, enter the location of a page to display after the server behavior runs successfully or
click the Browse button to browse to the location.
7IntheOnFailure,GoTobox,enterthelocationofapagetodisplayiftheserverbehaviorfailsorclicktheBrowse
button to browse to the location.
8Select the Display Debugging Information On Failure option if you want debugging information when the server
behavior fails.
When you select this option, Dreamweaver ignores the On Failure, Go To option.
Use the debugging option during development and use the On Failure, Go To option when your site is live.
9Click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
636
Dreamweaver adds a server behavior to the page that lets users insert records in a database table by filling out the
HTML form and clicking the Submit button.
Add a server behavior to insert records in a database table (PHP)
1In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select Insert Record
from the pop-up menu.
2Select a form from the Submit Values From pop-up menu.
3In the Connection pop-up menu, select a connection to the database.
4In the Insert Table pop-up menu, select the database table to insert the record in.
5Specify a database column to insert the record in, select the form object that will insert the record from the Value
pop-up menu, and then select a data type for the form object from the Submit As pop-up menu.
The data type is the kind of data the column in your database table is expecting (text, numeric, Boolean option
values).
Repeat the procedure for each form object in your form.
6In the After Inserting, Go To box, enter the page to open after the record is inserted in the table or click the Browse
button to browse to the file.
7Click OK.
Dreamweaver adds a server behavior to the page that lets users insert records in a database table by filling out the
HTML form and clicking the Submit button.
Build the insert page in one operation
1Open the page in Design view, and select Insert > Data Objects > Insert Record > Record Insertion Form Wizard.
2In the Connection pop-up menu, select a connection to the database. Click Define if you need to define a
connection.
3In the Insert Into Table pop-up menu, select the database table into which the record should be inserted.
4If you use ColdFusion, enter a user name and password.
5In the After Inserting, Go To box, enter the page to open after the record is inserted into the table or click the
Browse button to browse to the file.
6If you use ASP.NET, you can specify a page to go to on success, and a page to go to on failure. Or you can choose
to display debugging information upon failure.
If you select Display Debugging Information On Failure, Dreamweaver ignores the On Failure, Go To option.
Use the Display Debugging Information On Failure option during development and use the On Failure, Go To option
when your page is live.
7In the Form Fields area, specify the form objects you want to include on the insert page’s HTML form, and which
columns in your database table each form object should update.
By default, Dreamweaver creates a form object for each column in the database table. If your database automatically
generates unique key IDs for each new record created, remove the form object corresponding to the key column by
selecting it in the list and clicking the Minus (-) button. This eliminates the risk that the user of the form will enter
an ID value that already exists.
September 4, 2007
DREAMWEAVER CS3
User Guide
637
You can also change the order of the form objects on the HTML form by selecting a form object in the list and
clicking the up or down arrow on the right side of the dialog box.
8Specify how each data-entry field should be displayed on the HTML form by clicking a row in the Form Fields
table and entering the following information in the boxes below the table:
•In the Label box, enter a descriptive label to display beside the data-entry field. By default, Dreamweaver displays
the table column’s name in the label.
•In the Display As pop-up menu, select a form object to serve as the data-entry field. You can select Text Field, Text
Area, Menu, Checkbox, Radio Group, and Text. For read-only entries, select Text. You can also select Password
Field, File Field, and Hidden Field.
Note: Hidden fields are inserted at the end of the form.
•In the Submit As pop-up menu, select the data format accepted by your database table. For example, if the table
column only accepts numeric data, select Numeric.
•Set the form object’s properties. You have different options depending on the form object you select as your data-
entry field. For text fields, text areas, and text, you can enter an initial value. For menus and radio groups, you open
another dialog box to set the properties. For options, select the Checked or Unchecked option.
•If you use ASP.NET, you can choose to use web form control.
9Click OK.
Dreamweaver adds both an HTML form and an Insert Record server behavior to your page. The form objects are
laid out in a basic table, which you can customize using the Dreamweaver page design tools. (Make sure all the form
objects remain within the form’s boundaries.)
To edit the server behavior, open the Server Behaviors panel (Window > Server Behaviors) and double-click the
Insert Record behavior.
Building pages to update a record (all servers)
About record update pages
Your application can contain a set of pages that lets users update existing records in a database table. The pages
normally consist of a search page, a results page, and an update page. The search and results page let users retrieve
the record and the update page lets users modify the record.
Search for the record to update
When users want to update a record, they must first find that record in the database. Accordingly, you need a search
and a results page to work with the update page. The user enters search criteria in the search page and selects the
record on the results page. When the user clicks the record on the results page, the update page opens and displays
the record in an HTML form.
See also
“Building search and results pages (ColdFusion, ASP, JSP, PHP)” on page 624
“Building a database search page (ASP.NET)” on page 629
September 4, 2007
DREAMWEAVER CS3
User Guide
638
Create links to the update page
After creating the search and results pages, you create links on the results page to open the update page. You then
modify the links to pass the IDS of the records the user selects. The update page uses this ID to find the requested
record in the database and display it.
YouusethesameprocesstoopentheupdatepageandpassarecordIDthatyoudotoopenadetailpageandpassa
record ID. For more information, see “Create links to the detail page” on page 617.
See also
“URL parameters” on page 533
Retrieve the record to update
After the results page passes a record ID to the update page identifying the record to update, the update page must
read the parameter, retrieve the record from the database table, and store it temporarily in a recordset.
1Create a page in Dreamweaver and save it.
The page will become your update page.
2In the Bindings panel (Window > Bindings), click the Plus (+) button and select Recordset.
If the advanced dialog box appears, click Simple. The advanced dialog box has a text area to enter SQL statements;
the simple one does not.
3Name the recordset and specify where the data you want to update is located using the Connection and Table
pop-up menus.
4Click Selected, and select a key column (usually the record ID column) and the columns that contain the data to
be updated.
5Configure the Filter area so that the value of your key column equals the value of the corresponding URL
parameter passed by the results page.
This kind of filter creates a recordset that contains only the record specified by the results page. For example, if your
key column contains record ID information and is called PRID, and if the results page passes the corresponding
record ID information in the URL parameter called id, the Filter area should look like the following example:
6Click OK.
When the user selects a record on the results page, the update page generates a recordset containing only the selected
record.
Complete the update page block by block
An update page has three building blocks:
•A filtered recordset to retrieve the record from a database table
•An HTML form to let users modify the record’s data
•An Update Record server behavior to update the database table
September 4, 2007
DREAMWEAVER CS3
User Guide
639
You can add the final two basic building blocks of an update page separately using the form tools and the Server
Behaviors panel.
See also
“Retrieve the record to update” on page 638
“Creating forms” on page 600
Add an HTML form to an update page
1Create a page (File > New > Blank Page). This becomes your update page.
2Lay out your page using the Dreamweaver design tools.
3Add an HTML form by placing the insertion point where you want the form to appear and selecting Insert >
Form > Form.
An empty form is created on the page. You may have to enable Invisible Elements (View > Visual Aids > Invisible
Elements) to see the form’s boundaries, which are represented by thin red lines.
4Name the HTML form by clicking the <form> tag at the bottom of the Document window to select the form,
opening the Property inspector (Window > Properties), and entering a name in the Form Name box.
You don’t have to specify an action or method attributefortheformtotellitwhereandhowtosendtherecorddata
when the user clicks the Submit button. The Update Record server behavior sets these attributes for you.
5Add a form object such as a text field (Insert > Form > Text Field) for each column you want to update in the
database table.
The form objects are for data entry. Text fields are common for this purpose, but you can also use menus, options,
and radio buttons.
Each form object should have a corresponding column in the recordset you defined earlier. The only exception is the
unique key column, which should have no corresponding form object.
6Add a Submit button to the form (Insert > Form > Button).
You can change the label of the Submit button by selecting the button, opening the Property inspector (Window >
Properties), and entering a new value in the Label box.
Display the record in the form
1Make sure you defined a recordset to hold the record the user wants to update.
See “Retrieve the record to update” on page 638.
2Bind each form object to data in the recordset, as described in the following topics:
•“Display dynamic content in HTML text fields” on page 609
•“Dynamically preselect an HTML check box” on page 610
•“Dynamically preselect an HTML radio button” on page 610
•“Insert or change a dynamic HTML form menu” on page 608
•“Make existing HTML form menus dynamic” on page 609
September 4, 2007
DREAMWEAVER CS3
User Guide
640
Add a server behavior to update the database table
1In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select Update Record
from the pop-up menu.
The Update Record dialog box appears.
2Select a form from the Submit Values From pop-up menu.
3In the Data Source or Connection pop-up menu, select a connection to the database.
4Enter your user name and password if applicable.
5In the Update Table pop-up menu, select the database table that contains the record you are updating.
6(ColdFusion, PHP, ASP.NET) Specify a database column to update, select the form object that will update the
columnfromtheValuepop-upmenu,selectadatatypefortheformobjectfromtheSubmitAspop-upmenu,and
select Primary Key if you want to identify this column as the primary key.
The data type is the kind of data the column in your database table is expecting (text, numeric, Boolean option
values).
Repeat the procedure for each form object in your form.
7(ASP, JSP) In the Select Record From pop-up menu, specify the recordset that contains the record displayed in the
HTML form. In the Unique Key Column pop-up menu, select a key column (usually the record ID column) to
identify the record in the database table. Select the Numeric option if the value is a number. A key column usually
accepts only numeric values, but sometimes accepts text values.
8In the After Updating or On Success, Go To box, enter the page to open after the record updates in the table or
click the Browse button to browse to the file.
9(ASP.NET) In the On Failure, Go To box, enter the location of a page to display if the server behavior fails or click
the Browse button to browse to the location.
10 (ASP.NET) Select the Display Debugging Information On Failure option if you want debugging information
when the server behavior fails. When you select this option, Dreamweaver ignores the On Failure, Go To Option.
Use the debugging option during development and use the OnFailure, GoTo option when your site is live.
11 (ASP, JSP) Specify a database column to update, select the form object that will update the column from the
Valuepop-upmenu,andthenselectadatatypefortheformobjectfromtheSubmitAspop-upmenu.Thedatatype
is the kind of data the column in your database table is expecting (text, numeric, Boolean option values). Repeat the
procedure for each form in your form.
12 Click OK.
Dreamweaver adds a server behavior to the page that lets users update records in a database table by modifying the
information displayed in the HTML form and clicking the Submit button.
To edit the server behavior, open the Server Behaviors panel (Window > Server Behaviors) and double-click the
Update Record behavior.
Complete the update page in one operation
An update page has three building blocks:
•A filtered recordset to retrieve the record from a database table
•An HTML form to let users modify the record’s data
September 4, 2007
DREAMWEAVER CS3
User Guide
641
•An Update Record server behavior to update the database table
YoucanaddthefinaltwobuildingblocksofanupdatepageinasingleoperationusingtheRecordUpdateFormdata
object. The data object adds both an HTML form and an Update Record server behavior to the page.
Before you can use the data object, your web application must be able to identify the record to update, and your
update page must be able to retrieve it.
Afterthedataobjectplacesthebuildingblocksonthepage,youcanusetheDreamweaverdesigntoolstocustomize
the form to your liking, or the Server Behaviors panel to edit the Update Record server behavior.
Note: Theupdatepagecancontainonlyonerecord-editingserverbehavioratatime.Forexample,youcannotaddan
Insert Record or a Delete Record server behavior to the update page.
1OpenthepageinDesignview,andselectInsert>DataObjects>UpdateRecord>RecordUpdateFormWizard.
The Record Update Form dialog box appears.
2In the Connection pop-up menu, select a connection to the database.
Click the Define button if you need to define a connection.
3In the Table To Update pop-up menu, select the database table that contains the record to update.
4In the Select Record From pop-up menu, specify the recordset that contains the record displayed in the HTML form.
5In the Unique Key Column pop-up menu, select a key column (usually the record ID column) to identify the
record in the database table.
If the value is a number, select the Numeric option. A key column usually accepts only numeric values, but
sometimes it accepts text values.
6In the After Updating, Go To box (On Success Go To box for ASP.NET), enter the page to open after the record
updates in the table.
7(ASP.NET) If the update fails, choose to display a web page or debugging information about the failure.
Use the debugging option during development and use the On Failure, Go To option when your site is live. When
you select the debugging option, Dreamweaver ignores the On Failure, Go To option.
8In the Form Fields area, specify which columns in your database table each form object should update.
By default, Dreamweaver creates a form object for each column in the database table. If your database automatically
generates unique key IDs for each new record created, remove the form object corresponding to the key column by
selecting it in the list and clicking the Minus (-) button. This eliminates the risk that the user of the form will enter
an ID value that already exists.
You can also change the order of the form objects on the HTML form by selecting a form object in the list and
clicking the up or down arrow on the right side of the dialog box.
9Specify how each data-entry field should appear on the HTML form by clicking a row in the Form Fields table
and entering the following information in the boxes below the table:
•In the Label box, enter a descriptive label to display beside the data-entry field. By default, Dreamweaver displays
the table column’s name in the label.
•In the Display As pop-up menu, select a form object to serve as the data-entry field. You can select Text Field, Text
Area, Menu, Checkbox, Radio Group, and Text. For read-only entries, select Text. You can also select Password
Field, File Field, and Hidden Field.
Note: Hidden fields are inserted at the end of the form.
September 4, 2007
DREAMWEAVER CS3
User Guide
642
•In the Submit As pop-up menu, select the data format expected by your database table. For example, if the table
column only accepts numeric data, select Numeric.
•Set the form object’s properties. You have different options depending on the form object you select as your data-
entry field. For text fields, text areas, and text, you can enter an initial value. For menus and radio groups, you open
another dialog box to set the properties. For options, select the Checked or Unchecked option.
10 Set the properties of other form objects by selecting another Form Fields row and entering a label, display as
value, and submit as value.
For menus and radio groups, open another dialog box to set the properties. For options, define a comparison
between the current record’s value for the option and a given value to determine whether the option is checked when
the record is displayed.
11 Click OK.
Dreamweaver adds both an HTML form and an Update Record server behavior to your page.
ThedataobjectaddsbothanHTMLformandanUpdateRecordserverbehaviortoyourpage.Theformobjectsare
laid out in a basic table, which you can customize using the Dreamweaver page design tools. (Make sure all the form
objects remain within the form’s boundaries.)
To edit the server behavior, open the Server Behaviors panel (Window > Server Behaviors) and double-click the
Update Record behavior.
See also
“Retrieve the record to update” on page 638
“Insert or change a dynamic HTML form menu” on page 608
Form Element Properties options
The purpose of the Form Element Properties dialog box is to set the options for form elements on pages that let users
update records in a database.
1Select either Manually or From Database, depending on how you plan to create the form element.
2Click the Plus (+) button to add an element.
3Enter a label and value for the element.
4In the Select Value Equal To box, if you want a particular element selected when the page opens in a browser or
when a record displays in the form, enter a value equal to the element’s value.
You can enter a static value or you can specify a dynamic value by clicking the lightning bolt icon, and selecting a
dynamic value from the list of data sources. In either case, the value you specify should match one of the element’s
values.
September 4, 2007
DREAMWEAVER CS3
User Guide
643
Building pages to delete a record (all servers)
About record delete pages
Your application can contain a set of pages that lets users delete records in a database. The pages normally consist of
a search page, a results page, and a delete page. A delete page is usually a detail page working in tandem with a results
page. The search and results pages let the user retrieve the record and the delete page lets the user confirm and delete
the record.
After creating the search and results pages, you add links on the results page to open the delete page and then build
a delete page that displays the records and a Submit button.
Search for the record to delete
When users want to delete a record, they must first find that record in the database. Accordingly, you need a search
and a results page to work with the delete page. The user enters search criteria in the search page and selects the
record on the results page. When the user clicks the record, the delete page opens and displays the record in an
HTML form.
See also
“Building search and results pages (ColdFusion, ASP, JSP, PHP)” on page 624
“Building a database search page (ASP.NET)” on page 629
Create links to a delete page (ColdFusion, PHP, ASP.NET)
After creating the search and results pages, you must create links on the results page to open the delete page. You
then modify the links to pass the IDs of the records the user wants to delete. The delete page uses this ID to find and
display the record.
See also
“URL parameters” on page 533
Open the delete page and pass a record ID (ColdFusion, PHP)
1On the results page, create a column in the table used to display records by clicking inside the last table column
and selecting Modify > Table > Insert Rows or Columns.
2Select the Columns option and the After Current Column option, and click OK.
A column is added to the table.
3In the newly created table column, enter the string Delete in the row containing the dynamic content place-
holders. Make sure you enter the string inside the tabbed repeating region.
You can also insert an image with a word or symbol for delete.
If Live Data view is enabled, enter the string in the first row of records and click the Refresh icon.
4Select the Delete string to apply a link to it.
If Live Data view is enabled, select the string in the first row of records.
5In the Property inspector, enter the delete page in the Link box. You can enter any filename.
September 4, 2007
DREAMWEAVER CS3
User Guide
644
After clicking outside the Link box, the Delete string appears linked in the table. If you enable Live Data view
(View > Live Data), you can see that the link is applied to the same text in every table row. If Live Data view is already
enabled, click the Refresh icon to apply the links to each row.
6Select the Delete link on the results page.
If Live Data view is enabled, select the link in the first row.
7(ColdFusion, PHP) In the Link box in the Property inspector, add the following string at the end of the URL:
?recordID=#recordsetName.fieldName#
ThequestionmarktellstheserverthatwhatfollowsisoneormoreURLparameters.ThewordrecordIDisthename
of the URL parameter (you can make up any name you like). Note the name of the URL parameter because you'll use
it in the delete page later.
The expression after the equal sign is the value of the parameter. In this case, the value is generated by a ColdFusion
expression that returns a record ID from the recordset. A different ID is generated for each row in the dynamic table.
In the ColdFusion expression, replace recordsetName with the name of your recordset, and replace fieldName
with the name of the field in your recordset that uniquely identifies each record. In most cases, the field will consist
of a record ID number. In the following example, the field consists of unique location codes:
confirmDelete.cfm?recordID=#rsLocations.CODE#
When the page runs, the values of the recordset's CODE field are inserted in the corresponding rows in the dynamic
table. For example, if the Canberra, Australia, rental location has the code CBR, the following URL is used in the
Canberra row in the dynamic table:
confirmDelete.cfm?recordID=CBR
8(PHP) In the Link field in the Property inspector, add the following string at the end of the URL:
?recordID=<?php echo $row_recordsetName['fieldName']; ?>
ThequestionmarktellstheserverthatwhatfollowsisoneormoreURLparameters.ThewordrecordIDisthename
of the URL parameter (you can make up any name you like). Note the name of the URL parameter because you'll use
it in the delete page later.
September 4, 2007
DREAMWEAVER CS3
User Guide
645
The expression after the equal sign is the value of the parameter. In this case, the value is generated by a PHP
expression that returns a record ID from the recordset. A different ID is generated for each row in the dynamic table.
In the PHP expression, replace recordsetName with the name of your recordset, and replace fieldName with the
name of the field in your recordset that uniquely identifies each record. In most cases, the field will consist of a record
ID number. In the following example, the field consists of unique location codes:
confirmDelete.php?recordID=<?php echo $row_rsLocations['CODE']; ?>
When the page runs, the values of the recordset's CODE field are inserted in the corresponding rows in the dynamic
table. For example, if the Canberra, Australia, rental location has the code CBR, the following URL is used in the
Canberra row in the dynamic table:
confirmDelete.php?recordID=CBR
9Save the page.
Open the delete page and pass a record ID (ASP.NET)
In a DataGrid, you create the delete links by adding a hyperlink column and setting its attributes.
1Double-click your DataGrid in the Server Behaviors panel. Make sure you double-click the DataGrid listed in the
panel, not the DataGrid item that appears in the pop-up menu when you click the Plus (+) button.
2Add a column of delete links by clicking the Plus (+) button and selecting Hyperlink.
3In the Title box, enter a column title such as Delete.
The title appears in the column heading.
4Select the Static Text option, and enter the text of the link such as delete record.
Each row in the DataGrid displays the same text in the hyperlink column.
5In the Linked Page area, build the URL to apply to the text in the hyperlink column.
The URL not only has to open the delete page, it must uniquely identify the record to display on that page.
To identify the record to display on the delete page, select the Data Field option and select a field in your DataSet
that uniquely identifies each record. In most cases, the field will consist of a record ID number.
6
In the Format String box in the Linked Page area, click the Browse button, and then locate and select your delete page.
A URL to the delete page is created, which includes a URL parameter that identifies the record the delete page should
display. Make a note of the name of the URL parameter because you’ll use it for the delete page later.
For example, if you select locationDelete.aspx as your delete page and you selected CODE as the field in your DataSet
that uniquely identifies each record, the following URL is created:
In this case, a URL parameter called CODE is created. Dreamweaver copies the name of the data field, but you don’t
have to use that name. You can change it to something more descriptive, such as recordID, as in the following
example.
locationDelete.aspx?recordID={0}
September 4, 2007
DREAMWEAVER CS3
User Guide
646
The {0} element is a placeholder corresponding to the data field’s value. When the page runs, the values of the
DataSet’s CODE field are inserted in the corresponding rows in the DataGrid. For example, if the Canberra,
Australia, rental location has the code CBR, the following URL is used in the Canberra row in the DataGrid:
locationDelete.aspx?recordID=CBR
7Click OK to close the Hyperlink dialog box; then click OK to close the DataGrid dialog box.
The DataGrid is updated on your page. The following example shows a DataGrid viewed in a browser after searching
for all the cities that start with the letter c:
Build the delete page
After completing the page listing the records, switch to the delete page. The delete page shows the record and asks
the user if they're sure they want to delete it. When the user confirms the operation by clicking the form button, the
web application deletes the record from the database.
Building this page consists of creating an HTML form, retrieving the record to display in the form, displaying the
record in the form, and adding the logic to delete the record from the database. Retrieving and displaying the record
consists of defining a recordset to hold a single record—the record the user wants to delete—and binding the
recordset columns to the form.
Note: The delete page can contain only one record-editing server behavior at a time. For example, you cannot add an
Insert Record or an Update Record server behavior to the delete page.
Create an HTML form to display the record
1Create a page and save it as the delete page you specified in the previous section.
You specified a delete page when you created the Delete link in the previous section. Use this name when saving the
file for the first time (for example, deleteConfirm.cfm).
2Insert an HTML form on the page (Insert > Form > Form).
3Add a hidden form field to the form.
The hidden form field is required to store the record ID passedbytheURLparameter.Toaddahiddenfield,place
the insertion point in the form and select Insert > Form > Hidden Field.
4Add a button to the form.
September 4, 2007
DREAMWEAVER CS3
User Guide
647
The user will click the button to confirm and delete the displayed record. To add a button, place the insertion point
in the form and select Insert > Form > Button.
5Enhance the design of the page any way you want and save it.
Retrieve the record the user wants to delete
1In the Bindings panel (Window > Bindings), click the Plus (+) button and select Recordset (Query) from the
pop-up menu.
The simple Recordset or DataSet dialog box appears. If the advanced Recordset dialog box appears instead, click
Simple.
2Name the recordset, and select a data source and the database table that contains the records that users can delete.
3In the Columns area, select the table columns (record fields) you want to display on the page.
To display only some of the record’s fields, click Selected and choose the desired fields by Control-clicking
(Windows) or Command-clicking (Macintosh) them in the list.
Make sure to include the record ID field even if you won't be displaying it.
4Complete the Filter section as follows to find and display the record specified in the URL parameter passed by the
results page:
•From the first pop-up menu in the Filter area, select the column in the recordset containing values that match the
value of the URL parameter passed by the page with the Delete links. For example, if the URL parameter contains
a record ID number, select the column containing record ID numbers. In the example discussed in the previous
section, the recordset column called CODE contains the values that match the value of the URL parameter passed
by the page with the Delete links.
•From the pop-up menu beside the first menu, select the equal sign, if not already selected.
•From the third pop-up menu, select URL Parameter. The page with the Delete links uses a URL parameter to pass
information to the delete page.
•In the fourth box, enter the name of the URL parameter passed by the page with the Delete links.
5Click OK.
The recordset appears in the Bindings panel.
September 4, 2007
DREAMWEAVER CS3
User Guide
648
Display the record the user wants to delete
1Select the recordset columns (record fields) in the Bindings panel, and drag them to the delete page.
Make sure you insert this read-only dynamic content within the form boundaries. For more information on insert
dynamic content in a page, see “Make text dynamic” on page 564.
Next, you must bind the record ID column to the hidden form field.
2Make sure Invisible Elements are enabled (View > Visual Aids > Invisible Elements), and then click the yellow
shield icon that represents the hidden form field.
The hidden form field is selected.
3In the Property inspector, click the lightning bolt icon beside the Value box.
4In the Dynamic Data dialog box, select the record ID column in the recordset.
In the following example, the record ID column, CODE, contains unique store codes.
Record ID column selected
5Click OK and save the page.
September 4, 2007
DREAMWEAVER CS3
User Guide
649
Completed delete page
Add logic to delete the record (ColdFusion, PHP, ASP.NET)
After displaying the selected record on the delete page, you must add logic to the page that deletes the record from
the database when the user clicks the Confirm Deletion button. You can add this logic quickly and easily by using
the Delete Record server behavior.
1Make sure the delete page is open in Dreamweaver.
2In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button, and select Delete Record.
3In the First Check If Variable Is Defined box, make sure Primary Key Value is selected.
You specify the primary key value later in the dialog box.
4In the Connection or Data Source (ColdFusion) pop-up menu, select a connection to the database so that the
server behavior can connect to the affected database.
5In the Table pop-up menu, select the database table that contains the records that will be deleted.
6In the Primary Key Column pop-up menu, select the table column that contains record IDs.
The Delete Record server behavior searches this column for a match. The column should contain the same record
ID data as the recordset column you bound to the hidden form field on the page.
If the record ID is numeric, select the Numeric option.
7(ASP.NET) In the Submit Primary Key as pop-up menu, select the data type of your primary key column.
8(PHP) In the Primary Key Value pop-up menu, select the variable on your page that contains the record ID identi-
fying the record to be deleted.
The variable is created by your hidden form field. It has the same name as the name attribute of the hidden field and
is either a form or URL parameter, depending on the form’s method attribute.
9In the After Deleting, Go To box, or the On Success, Go To box, specify a page to open after the record has been
deleted from the database table.
September 4, 2007
DREAMWEAVER CS3
User Guide
650
You can specify a page that contains a brief success message to the user, or a page listing the remaining records so
that the user can verify that the record has been deleted.
10 (ASP.NET)(Optional) Select the Display Debugging Information On Failure option. The debugging information
is generated by the server. To provide a custom error message, deselect the Display Debugging Information On
Failure option and specify a page to open in the On Failure, Go To box.
11 Click OK, and save your work.
Upload the pages to your web server, open a browser and search for a record to delete. When you click a Delete link
on the results page, the delete page appears. Click the Confirm button to delete the record from the database. To
verify that the record has been deleted, open the page with the Delete links again. The record should no longer appear
in the list.
Note: Click Refresh if the record still appears on the page.
Add logic to delete the record (ASP, JSP)
Afteraddingabuttontheusercanclicktodeletetherecord,thefinalstepistoaddtheDeleteRecordserverbehavior
to update the database table after the user clicks the Submit button.
1In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select Delete Record
from the pop-up menu.
2In the Connection pop-up menu, select a connection to the database.
Click the Define button if you need to define a connection.
3In the Delete from Table pop-up menu, select the database table that contains the record to delete.
4In the Select Record From pop-up menu, specify the recordset that contains the record to delete.
5In the Unique Key Column pop-up menu, select a key column (usually the record ID column) to identify the
record in the database table.
If the value is a number, select the Numeric option. A key column usually accepts only numeric values, but
sometimes it accepts text values
6In the Delete By Submitting pop-up menu, specify the HTML form with the Submit button that sends the delete
command to the server.
7IntheAfterDeleting,GoTobox,enterthepagetoopenaftertherecordisdeletedfromthedatabasetableorclick
the Browse button to browse to the file.
September 4, 2007
DREAMWEAVER CS3
User Guide
651
Dreamweaver adds a server behavior to the page that lets users delete records in a database table by clicking the
Submit button on the form.
Building pages with advanced data manipulation
objects (ColdFusion, ASP, ASP.NET, JSP)
About ASP command objects
An ASP command object is a server object that performs some operation on a database. The object can contain any
valid SQL statement, including one that returns a recordset, or one that inserts, updates, or deletes records in a
database. A command object can alter the structure of a database if the SQL statement adds or deletes a column in a
table. You can also use a command object to run a stored procedure in a database.
A command object can be reusable, in the sense that the application server can reuse a single compiled version of
the object to execute the command a number of times. You make a command reusable by setting the Prepared
property of the Command object to true, as in the following VBScript statement:
mycommand.Prepared = true
Ifyouknowthecommandwillbeexecutedmorethanafewtimes,havingasinglecompiledversionoftheobjectcan
make database operations more efficient.
Note: Not all database providers support prepared commands. If your database does not support it, it might return an
error when you set this property to true. It might even ignore the request to prepare the command and set the Prepared
property to false.
A command object is created by scripts on an ASP page, but Dreamweaver lets you create command objects without
writing a line of ASP code.
Use ASP commands to modify a database
You can use Dreamweaver to create ASP command objects that insert, update, or delete records in a database. You
supply the command object with the SQL statement or stored procedure that performs the operation on the database.
1In Dreamweaver, open the ASP page that will run the command.
2Open the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button, and select Command.
3Enteranameforthecommand,selectaconnectiontothedatabasethatcontainstherecordsyouwanttoedit,and
select the editing operation that you want the command to perform—Insert, Update, or Delete.
Dreamweaver starts the SQL statement, based on the type of operation you select. For example, if you select Insert,
the dialog box looks like the following example:
September 4, 2007
DREAMWEAVER CS3
User Guide
652
4Complete the SQL statement.
For information on writing SQL statements that modify databases, consult a Transact-SQL manual.
5Use the Variables area to define any SQL variables. Provide the name and run-time value. Specifying the type and
size of each variable prevent injection attacks.
The following example shows an Insert statement that contains three SQL variables. The values of these variables are
provided by URL parameters passed to the page, as defined in the Run-Time Value column of the Variables area.
To get the Size value, use the Databases panel in Dreamweaver. Find your database in the Databases panel and
expand it. Next, find the table you’re working with and expand it. The table lists the sizes for your fields. For example,
it might say ADDRESS (WChar 50). In this example, 50 is the size. You can also find the size in your database appli-
cation.
Note: Numeric, Boolean and date/time data types always use -1 as the size.
To determine the Type value, see the following table:
For more information on the type and size of SQL variables, see www.adobe.com/go/4e6b330a.
6Close the dialog box.
Type in database Type in Dreamweaver Size
Numeric (MS Access, MS SQL Server,
MySQL)
Double -1
Boolean, Yes/No (MS Access, MS SQL
Server, MySQL)
Double -1
Date/Time (MS Access, MS SQL
Server, MySQL)
DBTimeStamp -1
All other types of text fields,
including the MySQL text data types
char, varchar and longtext
LongVarChar check database table
Text (MS Access) or nvarchar, nchar
(MS SQL Server)
VarWChar check database table
Memo (MS Access), ntext (MS SQL
Server), or fields that support large
amounts of text
LongVarWChar 1073741823
September 4, 2007
DREAMWEAVER CS3
User Guide
653
Dreamweaver inserts ASP code in your page that, when run on the server, creates a command that inserts, updates,
or deletes records in the database.
Bydefault,thecodesetsthePreparedpropertyoftheCommandobjecttotrue,whichmakestheapplicationserver
reuse a single compiled version of the object every time the command is run. To change this setting, switch to Code
view and change the Prepared property to false.
7Create a page with an HTML form so users can enter record data. In the HTML form, include three text fields
(txtCity, txtAddress, and txtPhone) and a submit button. The form uses the GET method and submits the text field
values to the page that contains your command.
About JSP prepared statements
AJSP prepared statement is a reusable server object that contains a SQL statement. You can place any valid SQL
statement in a prepared statement. For example, a prepared statement can contain a SQL statement that returns a
recordset, or one that inserts, updates, or deletes records in a database.
A prepared statement is reusable in the sense that the application server uses a single instance of the prepared
statement object to query the database a number of times. Unlike the JSP statement object, a new instance of the
prepared statement object is not created for each new database query. If you know the statement will be executed
more than a few times, having a single instance of the object can make database operations more efficient and take
up less server memory.
A prepared statement object is created by a Java scriptlet on a JSP page. However, Dreamweaver lets you create
prepared statements without writing a single line of Java code.
If you’re interested in the code, the following scriptlet creates a prepared statement:
String myquery = “SELECT * FROM EMPLOYEES WHERE DEPARTMENT = ?”;
PreparedStatement mystatement = connection.prepareStatement(myquery);
The first line stores the SQL statement in a string variable called myquery, with a question mark serving as a place-
holder for the SQL variable value. The second line creates a prepared statement object called mystatement.
Next, you assign a value to the SQL variable, as follows:
mystatement.setString(1, request.getParameter(“myURLparam”));
The setString method assigns the value to the variable and takes two arguments. The first argument specifies the
affected variable by its position (here, the first position in the SQL statement). The second argument specifies the
variable’s value. In this example, the value is provided by a URL parameter passed to the page.
Note: You must use different methods to assign non-string values to SQL variables. For example, to assign an integer to
the variable, you would use the mystatement.setInt() method.
Finally, you generate the recordset, as follows:
ResultSet myresults = mystatement.execute();
Use JSP prepared statements to modify a database
You can use Dreamweaver to create JSP prepared statements that insert, update, or delete records in a database. A
JSP prepared statement is a reusable server object that contains a SQL statement. You supply the prepared statement
with the SQL that performs the operation on the database.
1In Dreamweaver, open the JSP page that will run the command.
September 4, 2007
DREAMWEAVER CS3
User Guide
654
2Open the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select Prepared
(Insert, Update, Delete).
The Prepared (Insert, Update, Delete) dialog box appears.
3Enter a name for the prepared statement, select a connection to the database containing the records you want to
edit, and select the editing operation you want the prepared statement to perform—Insert, Update, or Delete.
Dreamweaver starts the SQL statement for you based on the type of operation you select.
4Complete the SQL statement.
For information on writing SQL statements that modify databases, consult a Transact-SQL manual.
5Use the Variables area to define any SQL variables.
In the Param column, enter the name of the SQL parameters used in the SQL statement. In the Run-Time Value
column, enter the form or URL parameter supplying a value to each SQL parameter. For example, if the value to be
assigned to a SQL parameter is supplied by a URL parameter called txtCity, enter the following run-time value:
request.getParameter(“txtCity”)
6Click OK.
After you close the dialog box, the JSP code is inserted in your page; when the code runs on the server, it creates a
prepared statement that inserts, updates, or deletes records in the database.
About stored procedures
Although you can use server behaviors to build pages that modify databases, you can also use database manipulation
objects such as stored procedures, ASP command objects, or JSP prepared statements to build the pages.
Astored procedure is a reusable database item that performs some operation on the database. A stored procedure
contains SQL code that can, among other things, insert, update, or delete records. Stored procedures can also alter
the structure of the database itself. For example, you can use a stored procedure to add a table column or even delete
a table.
A stored procedure can also call another stored procedure, as well as accept input parameters and return multiple
values to the calling procedure in the form of output parameters.
A stored procedure is reusable in the sense that you can reuse a single compiled version of the procedure to execute
a database operation a number of times. If you know a database task will be executed more than a few times—or the
same task will be executed by different applications—using a stored procedure to execute that task can make database
operations more efficient.
Note: MySQL and Microsoft Access databases do not support stored procedures.
Add a stored procedure (ColdFusion)
You can use a stored procedure to modify a database. A stored procedure is a reusable database item that performs
some operation on the database.
Before you use a stored procedure to modify a database, make sure the stored procedure contains SQL that modifies
thedatabaseinsomeway.Tocreateandstoreoneinyourdatabase,consultyourdatabasedocumentationandagood
Transact-SQL manual.
1In Dreamweaver, open the page that will run the stored procedure.
2In the Bindings panel (Window > Bindings), click the Plus (+) button, and then select Stored Procedure.
September 4, 2007
DREAMWEAVER CS3
User Guide
655
3In the Data Source pop-up menu, select a connection to the database containing the stored procedure.
4Enter the ColdFusion Data Source user name and password.
5Select a stored procedure from the Procedures pop-up menu.
Dreamweaver automatically fills in any parameters.
6Select a parameter, and click Edit if you have to make changes.
TheEditStoredProcedureVariabledialogboxappears.ThenameofthevariableyouareeditingappearsintheNamebox.
Note: You must enter test values for any stored procedure input parameters.
7Make changes as necessary:
•Select a Direction from the pop-up menu. A stored procedure might have input values, output values, or both
input and output values.
•Select a SQL type from the pop-up menu. Enter a return variable, a run-time value, and a test value.
8If the stored procedure takes a parameter, click the Plus (+) button to add a page parameter.
Note: You must enter corresponding page parameters for each stored procedure parameter return value. Do not add page
parameters unless there is a corresponding return value.
Click the Plus (+) button again to add another page parameter, if necessary.
9Select a page parameter, and click the Minus (-) button to delete the parameter if necessary or click Edit to make
changes to the parameter.
10 Select the Returns Recordset Named option, and then enter a name for the recordset; if the stored procedure
returns a recordset, click the Test button to see the recordset that the stored procedure returns.
Dreamweaver runs the stored procedure and displays the recordset, if any.
Note: If the stored procedure returns a recordset and takes parameters, you must enter a value in the Default Value
column in the Variables box to test the stored procedure.
You can use different test values to generate different recordsets. To change test values, click the Edit button for
Parameter, and change the test value, or click the Edit button for Page Parameter and change the default value.
11 Select the Returns Status Code Named option, enter a name for the status code, if the stored procedure returns
a status code return value. Click OK.
After you close the box, Dreamweaver inserts ColdFusion code in your page that calls a stored procedure in the
database, when the code runs on the server. The stored procedure in turn performs a database operation, such as
inserting a record.
If the stored procedure takes parameters, you can create a page that gathers the parameter values and submits them
to the page with the stored procedure. For example, you may create a page that uses URL parameters or an HTML
form to gather parameter values from users.
See also
“Define an advanced recordset by writing SQL” on page 550
Add a stored procedure (ASP.NET)
You can use a stored procedure to modify a database. A stored procedure is a reusable database item that performs
some operation on the database.
September 4, 2007
DREAMWEAVER CS3
User Guide
656
Before you use a stored procedure to modify a database, make sure the stored procedure contains SQL that modifies
thedatabaseinsomeway.Tocreateandstoreoneinyourdatabase,consultyourdatabasedocumentationandagood
Transact-SQL manual.
1In Dreamweaver, open the page that will run the stored procedure.
2In the Bindings panel (Window > Bindings), click the Plus (+) button, and select Stored Procedure.
3In the Stored Procedures dialog box, enter a name for the stored procedure.
4In the Connection pop-up menu, select a connection to the database that contains the stored procedure.
Click the Define button if you need to define a connection.
5Select a stored procedure from the Procedures pop-up menu.
Dreamweaver automatically fills in any parameters.
6Select the Returns DataSet option if the stored procedure returns a DataSet, and then click Test to see the DataSet
the stored procedure returns.
7Select a parameter, and click the Edit button if you need to make changes.
8In the Edit Stored Procedure Variable dialog box, make changes as necessary:
•The name of the variable you are editing appears in the Name box.
•Select the variable type from the pop-up menu. Enter the size of the variable.
•Select a direction from the pop-up menu. A stored procedure might have input values, output values, or both.
•Enter a test value.
•Click the Build button to build the value. In the Build Value dialog box, select a source from the pop-up menu,
enter a default value, and click OK.
•Click OK to close the Edit Stored Procedure Variable dialog box and accept your changes.
9In the On Success, Go To box back in the Stored Procedure dialog box, enter the location of a page to display after
the stored procedure runs successfully or click the Browse button to browse to the location.
10 In the On Failure, Go To box, enter the location of a page to display if the stored procedure fails or click the
Browse button to browse to the location.
11 Select the Display Debugging Information On Failure option if you want debugging information when the stored
procedure fails.
When you select this option, Dreamweaver ignores the On Failure, Go To option.
Use the debugging option during development, and then use the On Failure, Go To option when your site is live.
12 Click OK.
After you close the dialog box, Dreamweaver inserts ASP.NET code in your page that, when run on the server,
executes a stored procedure in the database. The stored procedure in turn performs a database operation, such as
inserting a record or executing a query.
If the stored procedure takes parameters, you might create a page that gathers the parameter values and submits them
to the page with the stored procedure. For example, you may create a page that uses URL parameters or an HTML
form to gather parameter values from users.
September 4, 2007
DREAMWEAVER CS3
User Guide
657
See also
“Define an advanced recordset by writing SQL” on page 550
Run a stored procedure (ASP)
With ASP pages, you must add a command object to a page to run a stored procedure. For more information on
command objects, see “About ASP command objects” on page 651.
1In Dreamweaver, open the page that will run the stored procedure.
2In the Bindings panel (Window > Bindings), click the Plus (+) button, and then select Command (Stored
Procedure).
The Command dialog box appears.
3Enter a name for the command, select a connection to the database containing the stored procedure, and then
select Stored Procedure from the Type pop-up menu.
4Select your stored procedure by expanding the Stored Procedures branch in the Database Items box, selecting the
stored procedure from the list, and clicking the Procedure button.
5Enter any required parameters in the Variables table.
You don’t need to enter any parameters for any RETURN_VALUE variable.
6Click OK.
After you close the dialog box, ASP code is inserted in your page. When the code runs on the server, the code creates
a command object that runs a stored procedure in the database. The stored procedure in turn performs a database
operation, such as inserting a record.
Bydefault,thecodesetsthePreparedpropertyoftheCommandobjecttotrue,whichmakestheapplicationserver
reuse a single compiled version of the object every time the stored procedure is run. If you know the command will
be executed more than a few times, having a single compiled version of the object can improve the efficiency of
databaseoperations.However,ifthecommandwillonlybeexecutedoneortwotimes,usingonemightactuallyslow
down your web application because the system has to pause to compile the command. To change the setting, switch
to Code view and change the Prepared property to false.
Note: Not all database providers support prepared commands. If your database does not support it, you might get an
error message when you run the page. Switch to Code view and change the Prepared property to false.
If the stored procedure takes parameters, you might create a page that gathers the parameter values and submits them
to the page with the stored procedure. For example, you may create a page that uses URL parameters or an HTML
form to gather parameter values from users.
Run a stored procedure (JSP)
With JSP pages, you must add a Callable server behavior to a page to run a stored procedure.
1In Dreamweaver, open the page that will run the stored procedure.
2In the Bindings panel (Window > Bindings), click the Plus (+) button and select Callable (Stored Procedure).
3In the Callable (Stored Procedure) dialog box, enter a name for the stored procedure.
4In the Connections pop-up menu, select a connection to the database containing the stored procedure.
5In the Database Items box, expand the Stored Procedures branch, select the stored procedure from the list, and
click the Procedure button.
September 4, 2007
DREAMWEAVER CS3
User Guide
658
Dreamweaver automatically fills in the Callable Text and Variables boxes.
6Select the Returns Recordset Named option, enter a name for the recordset, if the stored procedure returns a
recordset, and then click the Test button to see the recordset that the stored procedure returns.
Dreamweaver runs the stored procedure and displays the recordset, if any.
Note: If the stored procedure returns a recordset and takes parameters, you must enter a value in the Default Value
column in the Variables box to test the stored procedure.
7Click OK.
After you close the Callable (Stored Procedure) dialog box, JSP code is inserted in your page. When the code runs
on the server, it calls a stored procedure in the database. The stored procedure in turn performs a database operation,
such as inserting a record.
If the stored procedure takes parameters, you can create a page that gathers the parameter values and submits them
to the page with the stored procedure. For example, you may create a page that uses URL parameters or an HTML
form to gather parameter values from users.
Building a registration page (ColdFusion, ASP, JSP, PHP)
About registration pages
Your web application can contain a page that requires users to register the first time they visit your site.
A registration page is made up of the following building blocks:
•A database table to store login information about the users
•An HTML form that lets users select a user name and password
You can also use the form to obtain other personal information from users.
•An Insert Record server behavior to update the database table of site users
•ACheckNewUsernameserverbehaviortomakesuretheusernameenteredbytheuserisnottakenbyanotheruser
The method you use is identical for ColdFusion, ASP, JSP, and PHP pages. Dreamweaver does not have authenti-
cation server behaviors for ASP.NET pages.
See also
“Add an HTML form for selecting a user name and password (ColdFusion, ASP, JSP, PHP)” on page 659
“Update the database table of users (ColdFusion, ASP, JSP, PHP)” on page 659
“Add a server behavior to ensure a unique user name (ColdFusion, ASP, JSP, PHP)” on page 660
Storing login information about users (ColdFusion, ASP, JSP, PHP)
A registration page requires a database table to store the login information entered by users.
•Make sure your database table contains a user name and a password column. If you want logged-in users to have
different access privileges, include an access privilege column.
September 4, 2007
DREAMWEAVER CS3
User Guide
659
•If you want to set a common password for all users of the site, configure your database application (Microsoft
Access, Microsoft SQL Server, Oracle, and so on) to enter the password in each new user record by default. In most
database applications, you can set a column to a default value each time a new record is created. Set the default
value to the password.
•You can also use the database table to store other useful information about the user.
The next step in creating a registration page is to add an HTML form to the registration page to let users choose a
user name and password (if applicable).
See also
“Store access privileges in the user database (ColdFusion, ASP, JSP, PHP)” on page 664
Add an HTML form for selecting a user name and password (ColdFusion, ASP, JSP, PHP)
You add an HTML form to the registration page to let users select a user name and password (if applicable).
1Create a page (File > New > Blank Page) and lay out your registration page using the Dreamweaver design tools.
2Add an HTML form by placing the insertion point where you want the form to appear and selecting Form from
the Insert menu.
An empty form is created on the page. You may have to enable Invisible Elements (View > Visual Aids > Invisible
Elements) to see the form’s boundaries, which are represented by thin red lines.
3Name the HTML form by clicking the <form> tag at the bottom of the Document window to select the form,
opening the Property inspector (Window > Properties), and entering a name in the Form Name box.
You don’t have to specify an action or method attributefortheformtotellitwhereandhowtosendtherecorddata
when the user clicks the Submit button. The Insert Record server behavior sets these attributes for you.
4Add text fields (Insert > Form > Text Field) to let the user enter a user name and password.
The form can also have more form objects to record other personal data.
You should add labels (either as text or images) beside each form object to tell users what they are. You should also
line up the form objects by placing them inside an HTML table. For more information on form objects, see “Creating
forms” on page 600.
5Add a Submit button to the form (Insert > Form > Button).
You can change the label of the Submit button by selecting the button, opening the Property inspector (Window >
Properties), and entering a new value in the Value box.
The next step in creating a registration page is to add the Insert Record server behavior to insert records in the table
of users in the database.
Update the database table of users (ColdFusion, ASP, JSP, PHP)
YoumustaddanInsertRecordserverbehaviortotheregistrationpagetoupdatethetableofusersinthedatabase.
1In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select Insert Record
from the pop-up menu.
The Insert Record dialog box appears.
2Complete the dialog box, making sure to specify the table of users in the database into which the user data will be
inserted. Click OK.
September 4, 2007
DREAMWEAVER CS3
User Guide
660
The final step in creating a registration page is to make sure the user name is not used by another registered user.
See also
“Build an insert page block by block” on page 633
Add a server behavior to ensure a unique user name (ColdFusion, ASP, JSP, PHP)
You can add a server behavior to a user registration page that verifies that the user name is unique before adding that
user to your database of registered users.
When the user clicks the Submit button on the registration page, the server behavior compares the user name entered
by the user against the user names stored in a database table of registered users. If no matching user name is found
in the database table, the server behavior carries out the insert record operation normally. If a matching user name
is found, the server behavior cancels the insert record operation and opens a new page (usually a page alerting the
user that the user name is already taken).
1In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select User
Authentication > Check New Username from the pop-up menu.
2In the Username Field pop-up menu, select the form text field that your visitors use to enter a user name.
3In the If Already Exists, Go To box, specify a page to open if a matching user name is found in the database table,
and click OK.
The opened page should alert the user that the user name is already taken and let the user try again.
Building a login page (ColdFusion, ASP, JSP, PHP)
About login pages
Your web application can contain a page that lets registered users log in to the site.
A login page is made up of the following building blocks:
•A database table of registered users
•An HTML form to let users enter a user name and password
•A Log In User server behavior to make sure the entered user name and password are valid
A session variable consisting of the user name is created for the user when the user logs in successfully.
The method you use is identical for ColdFusion, ASP, JSP, and PHP pages. Dreamweaver does not have authenti-
cation server behaviors for ASP.NET pages.
See also
“Add an HTML form to let users log in (ColdFusion, ASP, JSP, PHP)” on page 661
“Verify the user name and password (ColdFusion, ASP, JSP, PHP)” on page 661
September 4, 2007
DREAMWEAVER CS3
User Guide
661
Create a database table of registered users (ColdFusion, ASP, JSP, PHP)
You need a database table of registered users to verify that the user name and password entered in the login page are
valid.
❖Use your database application and a registration page to create the table.
The next step in building a login page is to add an HTML form to the page to let users log in.
See also
“Building a login page (ColdFusion, ASP, JSP, PHP)” on page 660
Add an HTML form to let users log in (ColdFusion, ASP, JSP, PHP)
You add an HTML form to the page to let users log in by entering a user name and password.
1Create a page (File > New > Blank Page), and lay out your login page using the Dreamweaver design tools.
2Add an HTML form by placing the insertion point where you want the form to appear and choosing Form from
the Insert menu.
An empty form is created on the page. You may have to enable Invisible Elements (View > Visual Aids > Invisible
Elements) to see the form’s boundaries, which are represented by thin red lines.
3Name the HTML form by clicking the <form> tag at the bottom of the Document window to select the form,
opening the Property inspector (Window > Properties), and entering a name in the Form Name box.
You don’t have to specify an action or method attributefortheformtotellitwhereandhowtosendtherecorddata
when the user clicks the Submit button. The Log In User server behavior sets these attributes for you.
4Add a user name and a password text field (Insert > Form > Text Field) to the form.
Add labels (either as text or images) beside each text field, and line up the text fields by placing them inside an HTML
table and setting the table’s border attribute to 0.
5Add a Submit button to the form (Insert > Form > Button).
You can change the label of the Submit button by selecting the button, opening the Property inspector (Window >
Properties), and entering a new value in the Label box.
The next step in building a login page is to add the Log In User server behavior to verify that the entered user name
and password are valid.
Verify the user name and password (ColdFusion, ASP, JSP, PHP)
You must add a Log In User server behavior to the login page to ensure that the user name and password that a user
enters are valid.
WhenauserclickstheSubmitbuttonontheloginpage,theLogInUserserverbehaviorcomparesthevaluesentered
by the user against the values for registered users. If the values match, the server behavior opens one page (usually
the site’s Welcome screen). If the values do not match, the server behavior opens another page (usually a page alerting
the user that the login attempt failed).
1In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select User
Authentication > Log In User from the pop-up menu.
2Specify the form and the form objects that visitors use to enter their user name and password.
3(ColdFusion) Enter your user name and password if applicable.
September 4, 2007
DREAMWEAVER CS3
User Guide
662
4Specify the database table and columns that contain the user names and passwords of all the registered users.
The server behavior compares the user name and password a visitor enters on the login page against the values in
these columns.
5Specify a page to open if the login process succeeds.
The specified page is usually the site’s Welcome screen.
6Specify a page to open if the login process fails.
The specified page usually alerts the user that the login process failed and lets the user try again.
7Ifyouwantusersforwardedtotheloginpageafterattemptingtoaccessarestrictedpagetoreturntothatrestricted
page after logging in, select the Go To Previous URL option.
If a user tries to access your site by opening a restricted page without first logging in, the restricted page can forward
the user to the login page. After the user logs in successfully, the login page redirects the user to the restricted page
that forwarded them to the login page in the first place.
When you complete the dialog box for the Restrict Access To Page server behavior on these pages, ensure that you
specify your login page in the If Access Denied, Go To box.
8Specify whether to grant access to the page based on user name and password alone, or based on authorization
level too, and click OK.
A server behavior is added to the login page that ensures the user name and password entered by a visitor are valid.
See also
“Redirect unauthorized users (ColdFusion, ASP, JSP, PHP)” on page 663
“Building a page only authorized users can access (ColdFusion, ASP, JSP, PHP)” on page 662
Building a page only authorized users can access
(ColdFusion, ASP, JSP, PHP)
About protected pages
Your web application can contain a protected page that only authorized users can access.
Note: Dreamweaver does not have authentication server behaviors for ASP.NET pages.
For example, if a user attempts to bypass the login page by typing the protected page’s URL in a browser, the user is
redirected to another page. Similarly, if you set the authorization level for a page to Administrator only users with
Administrator access privileges can view the page. If a logged-in user attempts to access the protected page without
the proper access privileges, the user is redirected to another page.
You can also use authorization levels to review newly registered users before granting them full access to the site. For
example, you may want to receive payment before allowing a user access to the member pages of the site. To do so,
you can protect the member pages with a Member authorization level and only grant newly registered users Guest
privileges. After receiving payment from the user, you can upgrade the user’s access privileges to Member (in the
database table of registered users).
September 4, 2007
DREAMWEAVER CS3
User Guide
663
If you do not plan to use authorization levels, you can protect any page on your site simply by adding a Restrict Access
ToPageserverbehaviortothepage.Theserverbehaviorredirectstoanotherpageanyuserwhohasnotsuccessfully
logged in.
If you do plan to use authorization levels, you can protect any page on your site with the following building blocks:
•A Restrict Access To Page server behavior to redirect unauthorized users to another page
•An extra column in your users database table to store each user’s access privileges
Regardless of whether you use authorization levels, you can add a link to the protected page that lets a user log out
and clears any session variables.
The method you use is identical for ColdFusion, ASP, JSP, and PHP pages. Dreamweaver does not have authenti-
cation server behaviors for ASP.NET pages.
See also
“Securing a folder in your application (ColdFusion)” on page 665
Redirect unauthorized users (ColdFusion, ASP, JSP, PHP)
To prevent unauthorized users from accessing a page, add a Restrict Access To Page server behavior to it. The server
behavior redirects the user to another page if the user attempts to bypass the login page by typing the protected page’s
URL in a browser, or if the user is logged in but attempts to access the protected page without the proper access privi-
leges.
Note: TheRestrictAccessToPageserverbehaviorcanonlyprotectHTMLpages.Itdoesnotprotectothersiteresources
such as image files and audio files.
If you want to give many pages on your site the same access rights, you can copy and paste access rights from one
page to another.
Redirect unauthorized users to another page
1Open the page you want to protect.
2In the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button and select User
Authentication > Restrict Access To Page from the pop-up menu.
3Select the level of access for the page. To allow only users with certain access privileges to view the page, select the
Username, Password, and Access Level option and specify the authorization levels for the page.
For example, you can specify that only users with Administrator privileges can view the page by selecting Adminis-
trator in the authorization levels list.
4To add authorization levels to the list, click Define. In the Define Access Levels list that appears, enter a new autho-
rization level, and click the Plus (+) button. The new authorization level is stored for use with other pages.
Ensure that the string for the authorization level matches exactly the string stored in your user database. For example,
if the authorization column in your database contains the value “Administrator”, enter Administrator, not
Admin, in the Name box.
5To set more than one authorization level for a page, Control-click (Windows) or Command-click (Macintosh) the
levels in the list.
For example, you can specify that any user with Guest, Member, or Administrator privileges can view the page.
6Specify the page to open if an unauthorized user attempts to open the protected page.
September 4, 2007
DREAMWEAVER CS3
User Guide
664
Ensure that the page you choose is not protected.
7Click OK.
Copy and paste a page’s access rights to other pages on the site
1Open the protected page and select the Restrict Access To Page server behavior listed in the Server Behaviors
panel (not the one in the Plus (+) pop-up menu).
2Click the arrow button in the upper-right corner of the panel, and select Copy from the pop-up menu.
The Restrict Access To Page server behavior is copied to your system’s Clipboard.
3Open another page you want to protect in the same way.
4In the Server Behaviors panel (Window > Server Behaviors), click the arrow button in the upper-right corner, and
select Paste from the pop-up menu.
5Repeat steps 3 and 4 for each page you want to protect.
Store access privileges in the user database (ColdFusion, ASP, JSP, PHP)
This building block is required only if you want certain logged-in users to have different access privileges. If you
simply require users to log in, you don’t have to store access privileges.
1To provide certain logged-in users with different access privileges, make sure your database table of users contains
a column specifying each user’s access privileges (Guest, User, Administrator, and so on). The access privileges of
each user should be entered in the database by the site administrator.
In most database applications, you can set a column to a default value each time a new record is created. Set the
default value to the most common access privilege on your site (for example, Guest); then manually change the
exceptions (for example, changing Guest to Administrator). The user now has access to all administrator pages.
2Make sure each user in the database has a single access privilege, such as Guest or Administrator, not multiple
privileges like User, Administrator. To set multiple access privileges for your pages (for example, all guests and
administrators can see this page), set those privileges at the page level, not the database level.
Log out users (ColdFusion, ASP, JSP, PHP)
When a user logs in successfully, a session variable is created that consists of the user name. When the user leaves
your site, you can use the Log Out User server behavior to clear the session variable and redirect the user to another
page (usually a goodbye or thank you page).
You can invoke the Log Out User server behavior when the user clicks a link or when a specific page loads.
Add a link to let users log out
1Select text or an image on a page to serve as the link.
2In the Server Behaviors panel (Window > Behaviors), click the Plus (+) button and select User Authentication >
Log Out User.
3Specify a page to open when the user clicks the link, and click OK.
The page is usually a goodbye or thank you page.
Log out users when a specific page loads
1Open the page that will load in Dreamweaver.
September 4, 2007
DREAMWEAVER CS3
User Guide
665
The page is usually a goodbye or thank you page.
2In the Server Behaviors panel, click the Plus (+) button and select User Authentication > Log Out User.
3Select the Log Out When Page Loads option, and click OK.
Securing a folder in your application (ColdFusion)
Secure a folder or site on the server (ColdFusion)
You can use Dreamweaver to password-protect a specific folder in your ColdFusion application, including the appli-
cation’s root folder. When a visitor to your site requests any page in the specified folder, ColdFusion prompts the
visitor for a user name and password. ColdFusion stores the user name and password in session variables so the
visitor doesn’t need to enter them again during the session.
Note: This feature is available only if you have access to a computer running ColdFusion MX 7 or later.
1With a ColdFusion document open in Dreamweaver, select Commands > ColdFusion Login Wizard.
2Complete the ColdFusion Login Wizard.
aSpecify the full path to the folder you want to secure and click Next.
bIn the next screen, select one of the following authentication types:
Simple Authentication Secures your application with a single user name and password for all users.
Windows NT Authentication Secures your application using NT user names and passwords.
LDAP Authentication Secures your application with user names and passwords stored on an LDAP server.
cSpecify whether you want users to log in using a ColdFusion login page or a pop-up menu.
dIn the next screen, specify the following settings:
•If you selected simple authentication, specify the user name and password that each visitor must enter.
•If you selected Windows NT authentication, specify the NT domain to validate against.
•If you selected LDAP authentication, specify the LDAP server to validate against.
3Upload the new files to your remote site. The files are located in your local site folder.
See also
“Enable the ColdFusion enhancements” on page 674
“Building a page only authorized users can access (ColdFusion, ASP, JSP, PHP)” on page 662
“Securing a folder in your application (ColdFusion)” on page 665
Using ColdFusion components (ColdFusion)
About ColdFusion components
ColdFusion component (CFC) files let you encapsulate application and business logic into self-contained, reusable
units. CFCs also provide a fast, easy way to create web services.
September 4, 2007
DREAMWEAVER CS3
User Guide
666
A CFC is a reusable software unit written in ColdFusion markup language (CFML), which makes it easy to reuse and
maintain your code.
You can use Dreamweaver to work with CFCs. For information on CFC tags and syntax, see the ColdFusion
documentation from within Dreamweaver (Help > Using ColdFusion).
Note: You can use CFCs only with ColdFusion MX or later. CFCs are not supported in ColdFusion 5.
CFCs are meant to provide a simple yet powerful way for developers to encapsulate elements of their websites.
Generally, you should use components for application or business logic. Use customs tags for presentation elements
such as customized greetings, dynamic menus, and so on.
As with many other types of construction, dynamic sites can often benefit from interchangeable parts. For example,
adynamicsitemayrunthesamequeryrepeatedly,orcalculatethetotalpriceofshoppingcartpagesandrecalculate
it every time an item is added. These tasks can be handled by components. You can fix, improve, extend, and even
replace a component with minimal impact to the rest of your application.
Suppose an online store calculates shipping charges based on the price of orders. For orders under $20, the shipping
charge is $4; for orders between $20 and $40, the shipping charge is $6, and so on. You could insert the logic for calcu-
lating the shipping charge in both the shopping cart page and the checkout page, but that would mix HTML presen-
tation code and CFML logic code and generally make the code difficult to maintain and reuse.
You decide to create a CFC called Pricing that has, among other things, a function called ShippingCharge. The
function takes a price as an argument and returns a shipping charge. For example, if the value of the argument is
32.80, the function returns 6.
In both the shopping cart page and the checkout page, you insert a special tag to invoke the ShippingCharge
function. When the page is requested, the function is invoked and a shipping charge is returned to the page.
Later, the store announces a special promotion: free shipping for all orders above $100. You make the change to the
shipping rates in one place—the ShippingCharge function of the Pricing component—and all the pages using the
function automatically get accurate shipping charges.
Components panel overview (ColdFusion)
Use the Components panel (Window > Components) to view and edit ColdFusion components, and add code in the
page that invokes the function when the CFM page is requested.
Note: The Components panel is available only when viewing a ColdFusion page in Dreamweaver.
See also
“Build web pages that use CFCs” on page 669
Create or delete a CFC in Dreamweaver
You can use Dreamweaver to visually define a CFC and its functions. Dreamweaver creates a .cfc file and inserts the
necessary CFML tags for you.
Note: Depending on the component, you may have to complete some code by hand.
1Open a ColdFusion page in Dreamweaver.
2In the Components panel (Window > Components), select CF Components from the pop-up menu.
September 4, 2007
DREAMWEAVER CS3
User Guide
667
3Click the Plus (+) button, and complete the Create Components dialog box, and click OK.
aIn the Components section, enter the details about the component. Here is a partial list:
Name Specifies the filename of the component. The name must contain only alphanumeric characters and under-
scores (_). Don’t specify the .cfc file extension when entering the name.
Component Directory Specifies where the component is saved. Select the web application’s root folder (such as
\Inetpub\wwwroot\myapp\) or any of its subfolders.
bTo define one or more functions for the component, select Functions from the Section list, click the Plus (+)
button, and enter the details of the new function.
Ensure that you specify the type of the value returned by the function in the Return Type option.
If you select remote from the Access menu, the function becomes available as a web service.
cTo define one or more arguments for a function, select Arguments from the Section list, select the function from
the pop-up menu, click the Plus (+) button, and enter the details of the new argument on the right.
4If you use a remote development server, upload the CFC file and any dependent files (such as those used to
implement a function or include files) to the remote server.
Uploading the files ensures that Dreamweaver features such as Live Data view and Preview In Browser work
properly.
Dreamweaver writes a CFC file and saves it in the folder you specified. The new component also appears in the
Components panel (after clicking Refresh).
5To remove a component, you must delete the CFC file manually from the server.
See also
“Build web pages that use CFCs” on page 669
“About ColdFusion components” on page 665
View CFCs in Dreamweaver
Dreamweaver provides a way to visually examine the ColdFusion components (CFCs) located in your site folder or
on the server as a whole. Dreamweaver reads the CFC files and displays information about them in an easy-to-
navigate tree view in the Components panel.
Dreamweaver looks for the components on your testing server (see “Connecting to the database in Dreamweaver”
on page 509). If you create CFCs or make changes to existing CFCs, make sure to upload the CFC files to the testing
server so they are accurately reflected in the Components panel.
To view components located on another server, change the testing server settings.
You can view any of the following information about your CF components:
•List all of the ColdFusion components defined on the server.
•If you’re running ColdFusion MX 7 or later, filter the list to show only the CFCs located in your site folder.
•Explore the functions and arguments of each component.
•Inspect the properties of functions that serve as web services.
September 4, 2007
DREAMWEAVER CS3
User Guide
668
To use Dreamweaver to inspect CFCs residing in the server root while also managing your site files in a different
website root, you can define two Dreamweaver sites. Set the first site to point to the server root and the second to
point to the website root. Use the site pop-up menu on the Files panel to switch quickly between the two sites.
To view CFCs in Dreamweaver, follow these steps:
1Open any ColdFusion page in Dreamweaver.
2In the Components panel (Window > Components), select CF Components from the pop-up menu.
3Click the Refresh button in the panel to retrieve the components.
The components package is displayed on the server. A component package is a folder that contains CFC files.
If existing component packages do not appear, click the Refresh button in the panel toolbar.
4To display only the CFCs located in your site folder, click the Show Only Current Site’s CFCs button in the Compo-
nents panel toolbar.
Note: This feature is available only if you’ve defined a computer running ColdFusion MX 6 or later as a testing server
for Dreamweaver.
Note: If the current site is listed in a virtual folder on the remote server, the filtering does not work.
5Click the Plus (+) button beside the package name to view the components stored in the package.
•To list the functions of a component, click the Plus (+) button beside the component name.
•To see the arguments a function takes, as well as the arguments’ type and whether they are required or optional,
open the function’s branch in the tree view.
Functions that take no arguments have no Plus (+) button beside them.
•To quickly view the details of an argument, a function, a component, or a package, select the item in the tree view,
and click the Get Details button in the panel toolbar.
You can also right-click (Windows) or Control-click (Macintosh) the item and select Get Details from the pop-up menu.
Details about the item are displayed in a message box.
See also
“Set up a testing server” on page 48
“Enable the ColdFusion enhancements” on page 674
“Build web pages that use CFCs” on page 669
Edit CFCs in Dreamweaver
Dreamweaver provides a streamlined way of editing the code of the ColdFusion components defined for your site.
For example, you can add, change, or delete any component function without leaving Dreamweaver.
To use this feature, your development environment must be set up as follows:
•ColdFusion must be running locally.
•In the advanced Site Definition dialog box in Dreamweaver, the Access type specified in the Testing Server
category must be Local/Network.
September 4, 2007
DREAMWEAVER CS3
User Guide
669
•IntheadvancedSiteDefinitiondialogbox,thepathofyourlocalrootfoldermustbethesameasthepathofthe
testing server folder (for example, c:\Inetpub\wwwroot\cf_projects\myNewApp\). You can examine and change
these paths by selecting Site > Edit Sites.
•The component must be stored in the local site folder or any of its subfolders on your hard disk.
Open any ColdFusion page in Dreamweaver and display the components in the Components panel. To display the
components, open the Components panel (Window > Components), select CF Components from the panel’s
pop-up menu, and click the Refresh button on the panel.
Because ColdFusion is running locally, Dreamweaver displays component packages on your hard disk.
Use the following procedure to edit a component.
1Open any ColdFusion page in Dreamweaver and display the components in the Components panel (Window >
Components).
2Select CF Components from the panel’s pop-up menu, and click the Refresh button on the panel.
Because ColdFusion is running locally, Dreamweaver displays component packages on your hard disk.
Note: To edit the CFC recordset visually, double-click it in the Bindings panel.
3To edit a component file generally, open the package and double-click the component name in the tree view.
The component’s file opens in Code view.
4To edit a specific function, argument, or property, double-click the item in the tree view.
5Make your changes by hand in Code view.
6Save the file (File > Save).
7To see any new function in the Components panel, refresh the view by clicking the Refresh button on the panel
toolbar.
See also
“View CFCs in Dreamweaver” on page 667
Build web pages that use CFCs
Onewaytouseacomponentfunctioninyourwebpagesistowritecodeinthepagethatinvokesthefunctionwhen
the page is requested. You can use Dreamweaver to help you write this code.
Note: For other ways to use components, see the ColdFusion documentation from within Dreamweaver (Help > Using
ColdFusion).
1In Dreamweaver, open the ColdFusion page that will use the component function.
2Switch to Code view (View > Code).
3
Open the Components panel (Window > Components), and select CF Components from the panel’s pop-up menu.
4Find the component you want and insert it using one of the following techniques:
•Drag a function from the tree view to the page. Code is inserted in the page to invoke the function.
•SelectthefunctioninthepanelandclicktheInsertbuttononthepaneltoolbar(thesecondbuttonontheright).
Dreamweaver inserts the code in the page at the insertion point.
5If you insert a function that has arguments, complete the argument code by hand.
September 4, 2007
DREAMWEAVER CS3
User Guide
670
For more information, see the ColdFusion documentation from within Dreamweaver (Help > Using ColdFusion).
6Save the page (File > Save).
Define a recordset in a CFC
Dreamweaver can help you define a recordset (also known as a ColdFusion query) in a ColdFusion component
(CFC). By defining a recordset in a CFC, you don’t need to define the recordset on each page that uses it. You define
the recordset once in the CFC and use the CFC on different pages.
Note: This feature is available only if you have access to a computer running ColdFusion MX 7 or later. For more infor-
mation, see “Enable the ColdFusion enhancements” on page 674.
1Create or open an existing CFC file in Dreamweaver.
2In the Bindings panel (Window > Bindings), click the Plus (+) button and select Recordset (Query) from the
pop-up menu.
The Recordset dialog box appears. You can work in either the simple or the advanced Recordset dialog boxes.
3To use an existing function in the CFC, select the function from the Function pop-up menu and skip to step 5.
The recordset is defined in the function.
4To define a new function in the CFC, click the New Function button, enter a name for the function in the dialog
box that appears, and then click OK.
The name must contain only alphanumeric characters and underscores (_).
5To define a recordset for the function, complete the Recordset dialog box options.
The new function is inserted into the CFC that defines the recordset.
See also
“Create or delete a CFC in Dreamweaver” on page 666
Use a CFC recordset as a source of dynamic content
You can use a ColdFusion component (CFC) as a source of dynamic content for your pages if the component
contains a function defining a recordset.
Note: This feature is available only if you have access to a computer running ColdFusion MX 7 or later. For more infor-
mation, see Enable the ColdFusion enhancements.
1Open a ColdFusion page in Dreamweaver.
2In the Bindings panel (Window > Bindings), click the Plus (+) button and select Recordset (Query) from the
pop-up menu.
The Recordset dialog box appears. You can work in either the simple or the advanced Recordset dialog box.
3Click the CFC Query button.
4Complete the CFC query dialog box, click OK, and then click OK again to add the CFC recordset to the list of
available content sources in the Bindings panel.
5Use the Bindings panel to bind the recordset to various page elements.
For more information, see “Adding dynamic content to pages” on page 564.
September 4, 2007
DREAMWEAVER CS3
User Guide
671
Define dynamic content by using a CFC
You can define a recordset as a source of dynamic content in Dreamweaver by using a CFC that contains a recordset
definition.
1In the Name box, enter a name for the CFC recordset.
A common practice is to add the prefix rs to recordset names to distinguish them from other object names in the
code, for example: rsPressRelease.
Recordset names must contain only alphanumeric characters and underscores (_). You cannot use special characters
or spaces.
2Select a package from the ones already defined on the server.
If the package does not appear in the pop-up menu, you can refresh the list of packages by clicking the Refresh button
near the pop-up menu.
Make sure you upload your CFCs to the testing server first. Only CFCs on the testing server are displayed.
3Select a component from the ones defined in the currently selected package.
If the Component pop-up menu does not contain any components, or if none of your previously created components
appear in the menu, you should upload the CFC files to the testing server.
4(Optional) To create a component, click the Create New Component button.
aIn the Name box, enter the name for the new CFC. The name must contain only alphanumeric characters and
underscores (_).
bIn the Component Directory box, enter the location for your CFC, or browse to locate the folder.
Note: The folder must be the relative path to the site root folder.
5From the Function pop-up menu, select the function that contains the recordset definition.
The Function pop-up menu contains only the functions defined in the currently selected component. If no function
appears in this pop-up menu, or if your last changes are not reflected in the currently listed functions, check that
your last changes were saved and uploaded to server.
Note: The Connection and SQL boxes are read-only.
6Edit each parameter (type, value, and default value) that must be passed as a function argument by clicking the
Edit button.
aEnter a value for the current parameter by selecting the value type from the Value pop-up menu and entering the
value in the box to the right.
The value type can be a URL parameter, a form variable, a cookie, a session variable, an application variable, or an
entered value.
bEnter a default value for the parameter in the Default Value box.
If no run-time value is returned, the default parameter value is used.
cClick OK.
You cannot modify the database connection and the SQL query for the recordset. These fields are always disabled—
the connection and SQL query are displayed for your information.
7Click Test to connect to the database and create an instance of the recordset.
September 4, 2007
DREAMWEAVER CS3
User Guide
672
If the SQL statement contains page parameters, ensure that the Default Value column of the Parameters box contains
valid test values before clicking Test.
If the query was executed successfully, a table displays the recordset. Each row contains a record and each column
represents a field in that record.
Click OK to clear the CFC Query.
8Click OK.
Using JavaBeans (JSP)
Working with JavaBeans
JavaBeans components are architectural elements of multitier JSP applications. JavaBeans are typically used as part
of a middle business-logic layer meant to separate the presentation logic from data-access logic. In these applications,
the JavaBeans, (also referred to as beans) not the JSP pages, contain the logic that directly accesses the database.
In Dreamweaver, JavaBeans components are treated as sources of dynamic content for JSP pages, and appear in the
Bindings panel. You can double-click JavaBeans in the Bindings panel to view their properties, and then drag the
properties to the page to create dynamic data references.
You can also define a JavaBeans collection (a set of JavaBeans) as a source of dynamic content. However,
Dreamweaver supports only repeating regions and dynamic bindings when using JavaBean collections.
Accessing JavaBean class files
Copies of the bean class (or of the ZIP or JAR file that contains the bean class) must reside in the following locations:
•On the system running Dreamweaver, a copy of the bean class must reside in the Dreamweaver Configu-
ration/classes folder or in the system’s class path. (Dreamweaver uses this copy of the class at design time.)
•On the system running the JSP application server, the bean class must reside in the application server’s class path.
(Your application server uses this copy of the class at runtime.) The application server’s class path varies from
application server to application server, but generally the class path is to a WEB-INF folder with a classes/bean
subfolder.
If Dreamweaver and the application server are both running on the same system, and the application server uses the
system class path (not an internal class path), a single copy of the JavaBeans class can reside on the computer in the
system class path. Both the application server and Dreamweaver use this copy of the class. Otherwise, copies of the
JavaBeans class must reside in two paths on the computer (as described above).
The folder structure must match the JavaBeans’ package. For example, if the JavaBeans’ package is called
com.ardvark.myBean, you must store the package in /com/ardvark/ within the class path or in the Dreamweaver
Configuration/classes folder.
Define a JavaBean for a JSP page
1Select Window > Bindings to display the Bindings panel.
2Click the Plus (+) button, and select JavaBean from the pop-up menu.
3In the JavaBean dialog box, enter the bean’s name.
4Select the bean’s scope.
September 4, 2007
DREAMWEAVER CS3
User Guide
673
5Select the bean’s class. To list the classes in a ZIP or JAR file, click Browse and select the file.
The class is expressed in the following format:
packagename.classname
6To assign a default value to one of the JavaBean’s properties, select the property from the list, and enter a value in
the Default Value box below the list. To set the property’s default value to a dynamic value, click the lightning bolt
icon beside the Default Value box.
7Click OK. The newly defined JavaBean appears in the Bindings panel.
Define a JavaBean collection for a JSP page
1Select Window > Bindings to display the Bindings panel.
2Click the Plus (+) button and select JavaBean Collection from the pop-up menu.
3In the JavaBean Collection dialog box, select the collection’s class from the Collection Class pop-up menu.
The class is expressed in the following format:
packagename.classname
To list the classes in a ZIP or JAR file, click Browse and select the file.
4Select one of the collection’s indexed properties from the Indexed Properties pop-up menu.
5(Optional) Change the default name that appears in the Item Class box.
6Select the bean’s scope from the Scope pop-up menu.
7Click OK. The newly defined JavaBean collection appears in the Bindings panel.
September 4, 2007
674
Chapter 21: Building ASP.NET and
ColdFusion forms
You can build pages that let you search, insert, delete, and update database records, display master/detail infor-
mation,andrestrictaccesstocertainusers.YoucancreatethesekindsofpagesforASP.NETandColdFusionserver
models. Often, you include this information in a form on the web application page. For ASP.NET and ColdFusion
servers, you use server-specific controls on the forms.
Building ColdFusion MX 7 forms
About the ColdFusion enhancements
Dreamweaver provides a number of enhancements for ColdFusion developers who use ColdFusion MX 7 or later as
their development server. These enhancements include more Insert bar buttons, menu items, and Property
inspectors so that you can rapidly build and set the properties of ColdFusion forms. You can also generate code that
validates the information provided by site visitors. For example, you can check that the e-mail address provided by
a user contains the @ symbol, or that a required text field contains a certain type of value.
Note: These enhancements are only available if you have access to a computer running ColdFusion MX 7 or later.
Enable the ColdFusion enhancements
Some of these enhancements require that you define a computer running ColdFusion MX 7 or later as a testing
server for Dreamweaver. For example, the Property inspectors for form controls are available only if you specify the
correct testing server.
You define a testing server only once. Dreamweaver then automatically detects the testing server version and makes
the enhancements available if it detects ColdFusion.
1If you haven’t already done so, define a Dreamweaver site for your ColdFusion project.
2Select Site > Manage Sites, selecting your site from the list in the Advanced Site Definition dialog box, and click Edit.
If the Basic Site Definition dialog box appears, click the Advanced tab to switch to the advanced version.
3Select the Testing Server category and specify a computer running ColdFusion MX 7 or later as the testing server
for your Dreamweaver site. Ensure than you specify a valid URL prefix.
4Open any ColdFusion document.
You won’t see any visible changes to the Dreamweaver work space until you open a ColdFusion document.
See also
“Securing a folder in your application (ColdFusion)” on page 665
“Setting up a Dreamweaver site” on page 40
“Set up a testing server” on page 48
September 4, 2007
DREAMWEAVER CS3
User Guide
675
Create ColdFusion forms
You can use a number of Insert bar buttons, menu items, and Property inspectors to rapidly create ColdFusion forms
and set their properties in Dreamweaver.
Note: These enhancements are available only if you have access to a computer running ColdFusion MX 7 or later.
1Open a ColdFusion page and place the insertion point where you want the ColdFusion form to appear.
2Select Insert > ColdFusion Objects > CFForm > CFForm, or select the CFForm category from the Insert bar and
click the CF Form icon.
Dreamweaver inserts an empty ColdFusion form. In Design view, the form is indicated by a dotted red outline. If you
don’t see this outline, make sure that View > Visual Aids > Invisible Elements is selected.
3Ensure that the form is still selected, and then use the Property inspector to set any of the following form
properties.
CFForm Sets the name of the form.
Action Lets you specify the name of the ColdFusion page to be processed when the form is submitted.
Method Lets you define the method that the browser uses to send the form data to the server:
•POST Sends the data using the HTTP post method; this method sends the data in a separate message to the
server.
•GET Sends the data using the HTTP get method, placing the form field contents in the URL query string.
Target Lets you to modify the value of the target attribute of the cfform tag.
Encoding Type Specifies the encoding method used for transmitting the form data.
Note: Encoding type does not refer to character encoding. This attribute specifies the content type used to submit the form
to the server (when the value of method is post). The default value for this attribute is application/x-www-form-urlen-
coded.
Format Determines what kind of form is created:
•HTML Generates an HTML form and sends it to the client. The cfgrid and cftree child controls can be in Flash or
applet format.
•Flash Generates a Flash form and sends it to the client. All controls are in Flash format.
•XML Generates XForms XML and puts the results in a variable with the ColdFusion form name. Does not send
anything to the client. The cfgrid and cftree child controls can be in Flash or applet format.
Style Lets you specify a style for the form. For more information, see the ColdFusion documentation.
Flash/XML Skin Lets you specify a Macromedia halo color to stylize the output. The theme determines the color used
for highlighted and selected elements.
Preserve Data Determines whether to override the initial control values with submitted values when the form posts
to itself.
•If False, values specified in the control tag attributes are used.
•If True, submitted values are used.
Scripts src Specifies the URL, relative to the web root, of the JavaScript file that contains client-side code used by the
tag and its child tags. This attribute is useful if the file is not in the default location. This attribute may be required
in some hosting environments and configurations that block access to the /CFIDE directory. The default location is
set in the ColdFusion Administrator; by default, it is /CFIDE/scripts/cfform.js.
September 4, 2007
DREAMWEAVER CS3
User Guide
676
Archive Specifies the URL of downloadable Java classes for cfgrid, cfslider, and cftree applet controls. The default
location is /CFIDE/classes/cfapplets.jar.
Height Specifies the height of the form.
Width Specifies the width of the form.
Display Tag Editor Lets you edit properties not listed in the Property inspector.
4Insert ColdFusion form controls.
Place the insertion point where you want the ColdFusion form control to appear in the ColdFusion form, and then
select the control from the Insert menu (Insert > ColdFusion Objects > CFForm), or from the CFForm category in
the Insert bar.
5If required, set the properties of the control with the Property inspector.
Make sure the control is selected in Design view and then set the properties in the Property inspector. For more
information on the properties, click the Help icon in the Property inspector.
6Adjust the layout of the ColdFusion form.
If you’re creating an HTML-based form, you can use line breaks, paragraph breaks, preformatted text, or tables to
format your forms. You cannot insert a ColdFusion form in another ColdFusion form (that is, you cannot overlap
tags), but you can include more than one ColdFusion form in a page.
If you’re creating a Flash-based form, use Cascading Style Sheets (CSS) styles to lay out your form. ColdFusion
ignores any HTML in the form.
Remember to label the ColdFusion form fields with descriptive text to let users know what they are responding to.
For example, create a “Type your name label” to request name information.
See also
“Validate ColdFusion form data” on page 685
“Create an HTML form” on page 602
Insert ColdFusion form controls
Use the Insert bar or Insert menu to quickly insert ColdFusion form controls into a ColdFusion form. You need to
create a blank ColdFusion form before inserting controls in it.
Note: These enhancements are only available if you have access to a computer running ColdFusion MX 7 or later.
1In Design view, place the insertion point inside the form outline.
2Select the control from the Insert menu (Insert > ColdFusion Objects > CFForm), or from the CFForm category
in the Insert bar.
3Click the control on the page to select it and then set its properties in the Property inspector.
For information on the properties of specific controls, see the topics about the controls.
See also
“Modify ColdFusion form controls” on page 685
“Validate ColdFusion form data” on page 685
September 4, 2007
DREAMWEAVER CS3
User Guide
677
Insert ColdFusion text fields
You can visually insert a ColdFusion text field or password field into your form, and then set its options.
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
Visually insert a ColdFusion text field
1In Design view, place the insertion point inside the form outline.
2In the CFForm category of the Insert bar, click the CF Text Field icon or select Insert > ColdFusion Objects >
CFForm > CFtextfield.
A text field appears in the form.
3Select the text field and set its properties in the Property inspector.
4To label the text field on the page, click beside it and enter text for the label.
Visually insert a password field
1Repeat steps 1 and 2 in the previous procedure for inserting a text field.
2Select the inserted text field to display its Property inspector.
3Select the Password value from the Text Mode pop-up menu in the Property inspector.
CFTextField options (ColdFusion)
To set the options of a ColdFusion text or password field, set any of the following options in the CFTextField Property
inspector:
CFtextfield Sets the id attribute of the <cfinput> tag.
Value Lets you specify text to be displayed in the field when the page first opens in a browser. The information can
either be static or dynamic.
To specify a dynamic value, click the lightning bolt icon beside the Value box and select a recordset column in the
Dynamic Data dialog box. The recordset column supplies a value to the text field when you view the form in a
browser.
Text Mode Lets you switch between the standard text input field and the password input field. The attribute
modified by this control is type.
Read Only Lets you make the displayed text read-only.
Max Length Sets the maximum number of characters accepted by the text field.
Mask Lets you specify a mask for your requested text. You use this property to validate the user input. The mask
format is composed of A, 9, X and ? characters.
Note: The mask attribute is ignored for the cfinput type="password" tag.
Validate Specifies the type of validation for the current field.
Validate At Specifies when the field is validated: onSubmit, onBlur or onServer.
Label Lets you specify a label for the text field.
Pattern Lets you specify a JavaScript regular expression pattern to validate input. Omit leading and trailing slashes.
For more information, see the ColdFusion documentation.
Height Lets you specify the height of the control, in pixels.
September 4, 2007
DREAMWEAVER CS3
User Guide
678
Width Lets you specify the width of the control, in pixels.
Size Lets you specify the size of the control.
Required Lets you specify whether the text field must contain data before the form is submitted to the server.
Display Tag Editor Lets you edit properties not listed in the Property inspector.
Insert ColdFusion hidden fields
You can visually insert a ColdFusion hidden field into your form and set its properties. Use hidden fields to store and
submit information that the user does not enter. The information is hidden from the user.
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
1In Design view, place the insertion point inside the form outline.
2In the CFForm category of the Insert bar, click the CF Hidden Field icon.
A marker appears in the ColdFusion form. If you don’t see the marker, select View > Visual Aids > Invisible
Elements.
3Select the hidden field on the page and set any of the following options in the Property inspector:
Cfhiddenfield Lets you specify the unique name for the hidden field.
Value Lets you specify a value for the hidden field. The data can either be static or dynamic.
To specify a dynamic value, click the lightning bolt icon beside the Value box and select a recordset column in the
Dynamic Data dialog box. The recordset column supplies a value to the text field when you view the form in a
browser.
Validate Specifies the type of validation for the current field.
Validate At Specifies when the field is validated: onSubmit, onBlur or onServer.
Label Lets you specify a label for the control. This property is ignored by the ColdFusion server at run time.
Pattern Lets you specify a JavaScript regular expression pattern to validate input. Omit leading and trailing slashes.
For more information, see the ColdFusion documentation.
Height
Lets you specify the height of the control, in pixels. This property is ignored by the ColdFusion server at run time.
Width
Lets you specify the width of the control, in pixels. This property is ignored by the ColdFusion server at run time.
Size Lets you specify the size of the control. This property is ignored by the ColdFusion server at run time.
Required Lets you specify whether the hidden field must contain data before the form is submitted to the server.
Display Tag Editor Lets you edit properties not listed in the Property inspector.
See also
“Modify ColdFusion form controls” on page 685
Insert ColdFusion text areas
You can visually insert a ColdFusion text area into your form and set its properties. A text area is an input element
that consists of multiple lines of text.
September 4, 2007
DREAMWEAVER CS3
User Guide
679
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
1Place the insertion point inside the form outline.
2In the CFForm category of the Insert bar, click the CF Text Area icon.
A text area appears in the ColdFusion form.
3Select the text area on the page and set any of the following options in the Property inspector:
Cftextarea Lets you specify a unique name for the control.
Char Width Lets you set the number of characters per line.
Num Lines Lets you set the number of rows to display in the text area.
Wrap Lets you specify how you want the text entered by users to wrap.
Required Lets you specify whether the user must enter data in the field (checked) or not (unchecked).
Initial Value Lets you specify text to display in the text area when the page is initially opened in a browser.
Validate Specifies the type of validation for the field.
Validate At Specifies when the field is validated: onSubmit, onBlur, or onServer.
Label Lets you specify a label for the control.
Style Lets you specify a style for the control. For more information, see the ColdFusion documentation.
Height Lets you specify the height of the control, in pixels. This property is ignored by the ColdFusion server at run
time.
Width Lets you specify the width of the control, in pixels. This property is ignored by the ColdFusion server at run
time.
Display Tag Editor Lets you edit properties not listed in the Property inspector.
4To label the text area, click beside it and enter text for the label.
See also
“Validate ColdFusion form data” on page 685
“Modify ColdFusion form controls” on page 685
Insert ColdFusion buttons
You can visually insert a ColdFusion button into your form and set its properties. ColdFusion buttons control
ColdFusion form operations. Buttons can be used to submit ColdFusion form data to the server or to reset the
ColdFusion form. Standard ColdFusion buttons are typically labeled Submit, Reset, or Send. You can also assign
other processing tasks that you defined in a script. For example, the button might calculate the total cost of selected
items based on assigned values.
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
1Place the insertion point inside the ColdFusion form outline.
2In the CFForm category of the Insert bar, click the CF Button icon.
A button appears in the ColdFusion form.
September 4, 2007
DREAMWEAVER CS3
User Guide
680
3Select the button on the page and set any of the following options in the Property inspector:
Cfbutton Lets you specify a unique name for the control.
Action Lets you specify the type of button to create.
Display Tag Editor Lets you edit properties not listed in the Property inspector.
The other properties are ignored by the ColdFusion server at run time.
See also
“Modify ColdFusion form controls” on page 685
Insert ColdFusion check boxes
You can visually insert a ColdFusion check box into your form and set its properties. Use check boxes to let users
select more than one option from a set of options.
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
1Place the insertion point inside the form outline.
2In the CFForm category of the Insert bar, click the CF Checkbox icon.
A check box appears in the ColdFusion form.
3Select the check box on the page and set any of the following options in the Property inspector:
Cfcheckbox Lets you specify a unique name for the control.
Checked Value Lets you specify a value to be returned by the check box if the user checks it.
Initial State Lets you specify whether the check box is checked when the page first opens in a browser.
Validate Specifies the type of validation for the check box.
Validate At Specifies when the check box is validated: onSubmit, onBlur, or onServer.
Label Lets you specify a label for the check box.
Pattern Lets you specify a JavaScript regular expression pattern to validate input. Omit leading and trailing slashes.
For more information, see the ColdFusion documentation.
Height
Lets you specify the height of the control, in pixels. This property is ignored by the ColdFusion server at run time.
Width
Lets you specify the width of the control, in pixels. This property is ignored by the ColdFusion server at run time.
Size Lets you specify the size of the control. This property is ignored by the ColdFusion server at run time.
Required Lets you specify whether the checkbox must be checked before the form is submitted to the server.
Display Tag Editor Lets you edit properties not listed in the Property inspector.
4To label the check box, click next to the check box on the page and enter text for the label.
See also
“Modify ColdFusion form controls” on page 685
“Validate ColdFusion form data” on page 685
September 4, 2007
DREAMWEAVER CS3
User Guide
681
Insert ColdFusion radio buttons
You can visually insert a ColdFusion radio button into your form and set its properties. Use radio buttons when you
want users to select only one choice from a set of options. Radio buttons are typically used in groups. All radio
buttons in a group must have the same name.
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
1Place the insertion point inside the form outline.
2Select Insert > ColdFusion Objects > CFForm > CFradiobutton.
A radio button appears in the ColdFusion form.
3Select the radio button on the page and set any of the following options in the Property inspector:
Cfradiobutton Lets you specify a unique name for the control.
Checked Value Lets you specify a value to be returned by the radio button if the user checks it.
Initial State Lets you specify whether the radio button is checked when the page first opens in a browser.
Validate Specifies the type of validation for the radio button.
Validate At Specifies when the radio button is validated: onSubmit, onBlur, or onServer.
Label Lets you specify a label for the radio button.
Pattern Lets you specify a JavaScript regular expression pattern to validate input. Omit leading and trailing slashes.
For more information, see the ColdFusion documentation.
Height
Lets you specify the height of the control, in pixels. This property is ignored by the ColdFusion server at run time.
Width
Lets you specify the width of the control, in pixels. This property is ignored by the ColdFusion server at run time.
Size Lets you specify the size of the control. This property is ignored by the ColdFusion server at run time.
Required Lets you specify whether the radio button must be checked before the form is submitted to the server.
Display Tag Editor Lets you edit properties not listed in the Property inspector.
4To label the radio button, click beside it on the page and enter text for the label.
See also
“Modify ColdFusion form controls” on page 685
“Validate ColdFusion form data” on page 685
Insert ColdFusion select boxes
You can visually insert a ColdFusion select box into your form and set its properties. A select box lets a visitor select
one or more items from a list. Select boxes are useful when you have a limited amount of space, but need to display
many items. They’re also useful when you want to control the values returned to the server. Unlike text fields, where
users can type anything they want, including invalid data, with select boxes, you can set the exact values returned by
a menu.
You can insert two types of select boxes into a form: a menu that “drops down” when the user clicks it, or a menu that
displays a scrollable list of items that the user can select.
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
1Place the insertion point inside the form outline.
September 4, 2007
DREAMWEAVER CS3
User Guide
682
2In the CFForm category of the Insert bar, click the CF Select icon.
A select box appears in the ColdFusion form.
3Select the select box on the page and set any of the following options in the Property inspector:
Cfselect lets you specify a unique name for the control.
Type Letsyouchoosebetweenapop-upmenuoralist.Ifyouselectthelisttype,theListHeightandAllowMultiple
List Selections options become available.
List Height Lets you specify the number of lines to display in the list menu. Available only if you select the list type.
Allow Multiple List Selections Lets you specify whether the user can select more than one option from the list at a
time. Available only if you select the list type.
Edit Values Opens a dialog box that lets you add, edit, or remove options from the select box.
Initially Selected Lets you specify which option is selected by default. You can select more than one option if you
selected the Allow Multiple List Selections option.
Recordset Lets you specify the name of the ColdFusion query you want to use to populate the list or menu.
Display Column Lets you specify the recordset column to supply the display label of each list element. Used with
Recordset property.
Value Column Lets you specify the recordset column to supply the value of each list element. Used with the
Recordset property.
Flash Label Lets you specify a label for the select box.
Flash Height Lets you specify the height of the control, in pixels. This property is ignored by the ColdFusion server
at run time.
Flash Width Lets you specify the width of the control, in pixels. This property is ignored by the ColdFusion server
at run time.
Message Specifies the message to be displayed if the Required property is set to Yes and the user failed to make a
selection before submitting the form.
Required Lets you specify whether a menu item must be selected before the form is submitted to the server.
Display Tag Editor Lets you edit properties not listed in the Property inspector.
See also
“Modify ColdFusion form controls” on page 685
“Validate ColdFusion form data” on page 685
Insert ColdFusion image fields
You can visually insert a ColdFusion image field into your form and set its options. Use image fields to make custom
buttons.
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
1In Design view, place the insertion point inside the form outline.
2In the CFForm category of the Insert bar, click the CF Image Field icon. Browse to select the image to insert, and
click OK. Alternatively, you can enter the path of the image file in the Src box.
September 4, 2007
DREAMWEAVER CS3
User Guide
683
Note: If the image is outside the site root folder, you should copy the image to the root folder. Images outside the root
folder might not be accessible when you publish the site.
3Select the image field on the page and set any of the following options in the Property inspector:
Cfimagefield Lets you specify a unique name for the control.
Src Lets you specify the URL of the inserted image.
Alt Lets you specify a message when the image cannot be displayed.
Align Lets you specify the alignment of the picture.
Border Lets you set the width of the image border.
Edit Image Opens the image in your default image editor.
To define a default image editor, select Edit > Preferences > File Types / Editors. Otherwise, the Edit Image button
does not perform any action.
Validate Specifies the type of validation for the image field.
Validate At Specifies when the field is validated: onSubmit, onBlur, or onServer.
Label Lets you specify a label for the radio button.
Pattern Lets you specify a JavaScript regular expression pattern to validate input. Omit leading and trailing slashes.
For more information, see the ColdFusion documentation.
Height Lets you specify the height of the control, in pixels.
Width Lets you specify the width of the control, in pixels.
Size Lets you specify the size of the control. This property is ignored by the ColdFusion server at run time.
Required Lets you specify whether the control must contain data before the form is submitted to the server.
Display Tag Editor Lets you edit properties not listed in the Property inspector.
See also
“Modify ColdFusion form controls” on page 685
“Validate ColdFusion form data” on page 685
Insert ColdFusion file fields
You can visually insert a ColdFusion file field into your form and set its properties. Use a file field to let users select
a file from their computer, such as a word processing document or a graphics file, and upload it to the server. A
ColdFusion file field looks like other text fields, except it also has a Browse button. Users can manually enter the path
to the file they want to upload, or use the Browse button to locate and select the file.
FilefieldsrequirethatyouusethePOST method to transmit files from the browser to the server. The file is posted to
the address that you specify in the form’s Action box. Contact your server administrator to confirm that anonymous
file uploads are allowed before using a file field in your form.
File fields also require that the form encoding be set to multipart/form. Dreamweaver sets this automatically when
you insert a file field control.
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
1In Design view, select the CFForm to display its Property inspector.
September 4, 2007
DREAMWEAVER CS3
User Guide
684
To quickly select the form, click anywhere in the form outline and click the <cfform> tag in the tag selector at the
bottom of the Document window.
2In the Property inspector, set the form method to POST.
3From the Enctype pop-up menu, select multipart/form-data.
4Position the insertion point inside the form outline where you want to file field to appear.
5Select Insert > ColdFusion Objects > CFForm > CFfilefield.
A file field appears in the document.
6Select the file field on the page and set any of the following properties in the Property inspector:
Cffilefield Lets you specify a unique name for the control.
Max Length Lets you specify the maximum number of characters that the path to the file can have.
Validate Specifies the type of validation for the field.
Validate At Specifies when the field is validated: onSubmit, onBlur, or onServer.
Label Lets you specify a label for the field.
Pattern Lets you specify a JavaScript regular expression pattern to validate input. Omit leading and trailing slashes.
For more information, see the ColdFusion documentation.
Height
Lets you specify the height of the control, in pixels. This property is ignored by the ColdFusion server at run time.
Width
Lets you specify the width of the control, in pixels. This property is ignored by the ColdFusion server at run time.
Size Lets you specify the size of the control.
Required Lets you specify whether the file field must contain data before the form is submitted to the server.
Display Tag Editor Lets you edit properties not listed in the Property inspector.
See also
“Modify ColdFusion form controls” on page 685
“Validate ColdFusion form data” on page 685
Insert ColdFusion date fields
Although you can’t visually insert a ColdFusion date field in Dreamweaver, you can visually set its properties. A
ColdFusion date field is a special type of text field that lets users select a date from a pop-up calendar to insert it in
the text field.
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
1In Design view, select the CFForm to display its Property inspector.
To quickly select the form, click anywhere in the form outline and click the <cfform> tag in the tag selector at the
bottom of the Document window.
2In the Property inspector, set the form’s Format property to Flash.
The date field control can only be rendered in Flash-based ColdFusion forms.
3Switch to Code view (View > Code) and enter the following tag anywhere between the opening and closing
CFForm tags:
September 4, 2007
DREAMWEAVER CS3
User Guide
685
<cfinput name="datefield" type="datefield">
4SwitchtoDesignview,selectthedatefieldonthepage,andthensetanyofthefollowingoptionsintheProperty
inspector:
Cfdatefield Lets you specify a unique name for the control.
Value Lets you specify a date to be displayed in the field when the page first opens in a browser. The date can either
be static or dynamic.
To specify a dynamic value, click the lightning bolt icon beside the Value box and select a recordset column in the
Dynamic Data dialog box. The recordset column supplies a value to the date field when you view the form in a
browser.
Validate Specifies the type of validation for the field.
Validate At Specifies when the field is validated: onSubmit, onBlur, or onServer.
Label Lets you specify a label for the field.
Pattern Lets you specify a JavaScript regular expression pattern to validate input. Omit leading and trailing slashes.
For more information, see the ColdFusion documentation.
Height Lets you specify the height of the control, in pixels.
Width Lets you specify the width of the control, in pixels.
Size Lets you specify the size of the control.
Required Lets you specify whether the date field must contain a value before the form is submitted to the server.
Display Tag Editor Lets you edit properties not listed in the Property inspector.
See also
“Validate ColdFusion form data” on page 685
Modify ColdFusion form controls
You can visually change the properties of ColdFusion form controls whether you’re working in Design view or Code view.
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
1In Design view, select the form control on the page; in Code view, click anywhere inside the control’s tag.
The Property inspector displays properties of the form control.
2Change the control’s properties in the Property inspector.
For more information, click the Help icon in the Property inspector.
3To set more properties, click the Display Tag Editor button in the Property inspector and set the properties in the
Tag editor that appears.
Validate ColdFusion form data
You can build ColdFusion forms in Dreamweaver that check the contents of specified fields to ensure the user
entered the correct data type.
September 4, 2007
DREAMWEAVER CS3
User Guide
686
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
1Create a ColdFusion form that includes at least one input field and one Submit button. Ensure that every
ColdFusion field that you want to validate has a unique name.
2Select a field in the form that you want to validate.
3In the Property inspector, specify how you want to validate the field.
The lower part of each input Property inspector contains controls to help you define the specific validation rule. For
example, you might want to specify that a text field should contain a telephone number. To do this, select Telephone
from the Value pop-up menu in the Property inspector. You can also specify when to validate from the Validate At
pop-up menu.
Building ASP.NET forms
Add ASP.NET form controls to a page
You can use the visual design environment in Dreamweaver to add ASP.NET form controls to your page.
1Open an ASP.NET page in Design view (View > Design).
2Position the insertion point where you want the form control to appear on the page.
Form controls must be inserted inside a form that has an runat='server' attribute in its tag. If your page does not
have a form, Dreamweaver automatically creates one with a runat='server' attribute when you insert the first
ASP.NET form control. If your page contains an HTML form, Dreamweaver automatically adds the
runat='server' attribute to the existing form tag when you insert the first form control.
3Do one of the following:
•Select Insert > ASP.NET Objects; then select the form control from the submenu.
• In the ASP.NET category of the Insert bar, select the form control’s icon.
4Set the form control’s options in the dialog box that appears, and click OK.
For more information on the properties of each control, see the documentation on the Microsoft website at
http://msdn.microsoft.com/library/en-us/cpgenref/html/cpconaspsyntaxforwebcontrols.asp.
For each control, make sure you specify an ID attribute, such as txtCity for a TextBox control or lbxCountry for a
ListBox control.
See also
“Create a dynamic ASP.NET menu” on page 687
“Insert an ASP.NET CheckBoxList control” on page 689
“Insert an ASP.NET RadioButtonList control” on page 690
Modify the properties or events of ASP.NET form controls
1In Design view, select the form control on the page.
2Modify the control’s properties in the Property inspector.
September 4, 2007
DREAMWEAVER CS3
User Guide
687
For more information on the properties of each control, see the documentation on the Microsoft website at
http://msdn.microsoft.com/library/en-us/cpgenref/html/cpconaspsyntaxforwebcontrols.asp.
3To set more properties or events, click the Tag Editor button in the Property inspector, and set the properties in
the tag editor.
Create a dynamic ASP.NET menu
You can dynamically populate an ASP.NET menu control such as DropDownList or ListBox with entries from a
database.
Note: Before you begin, you must define a DataSet or other source of dynamic content for the menu.
1Open the ASP.NET page and position the insertion point where you want the menu to appear.
2Select Insert > ASP.NET Objects; then select asp:DropDownList or asp:ListBox.
3Set the form control’s options, and click OK.
Dreamweaver inserts the form control at the insertion point in your page. If you didn’t insert a form, Dreamweaver
inserts one that includes a runat=”server” attribute.
See also
“Defining sources of dynamic content” on page 547
“Modify the properties or events of ASP.NET form controls” on page 686
“Make an existing ASP.NET menu dynamic” on page 688
ASP.NET DropDownList options
ID Specifies the name you want to give the form control. The ID is required.
DataSet Specifies the data source you want to use to populate the items of the list control. If you don’t specify a
DataSet, you can specify one later or set the list items statically by clicking the List Items button in the Property
inspector.
Get Labels From Specifies the field in the selected DataSet to provide the labels of the list items.
Get Values From Specifies the field in the selected DataSet to provide the values of the list items.
Select Value Equal To Specifies a value the server uses to determine which list item is selected when the
DropDownList is displayed in a browser. The server compares each item’s value to the specified value. If the values
match, the matching item is selected.
Access Key Creates a keyboard shortcut that allows users to quickly navigate to the form control in a browser. For
example, if you enter K, the user can navigate to the control by typing Alt+K. The access key can only consist of a
single character.
Auto Postback Indicates whether a postback to the server automatically occurs when the user changes the list
selection. Select the option to allow postbacks.
For more information on ASP.NET DropDownList properties, see the documentation on the Microsoft website at
http://msdn.microsoft.com/library/en-us/cpgenref/html/cpcondropdownlistwebservercontrol.asp.
ASP.NET ListBox options
ID Specifies the name you want to give the form control. The ID is required.
September 4, 2007
DREAMWEAVER CS3
User Guide
688
DataSet Specifies the data source you want to use to populate the items of the list control. If you don’t specify a
DataSet, you can specify one later or set the list items statically by clicking the List Items button in the Property
inspector.
Get Labels From Specifies the field in the selected DataSet to provide the labels of the list items.
Get Values From Specifies the field in the selected DataSet to provide the values of the list items.
Access Key Creates a keyboard shortcut that allows users to quickly navigate to the form control in a browser. For
example, if you enter K, the user can navigate to the control by typing Alt+K. The access key can only consist of a
single character.
Auto Postback Indicates whether a postback to the server automatically occurs when the user changes the list
selection. Select the option to allow postbacks.
For more information on ASP.NET ListBox properties, see the documentation on the Microsoft website at
http://msdn.microsoft.com/library/en-us/cpgenref/html/cpconlistboxwebservercontrol.asp.
Make an existing ASP.NET menu dynamic
You can make an existing ASP.NET menu object dynamic. ASP.NET menu objects include the DropDownList and
ListBox controls.
1In Design view, select the DropDownList or ListBox object that you want to make dynamic.
2In the Property inspector, click the List Items button.
3Select Manually or From Database, depending on how you plan to populate the list.
4If you select Manually, do the following:
•To add a list item, click the Plus (+) button, and specify a label and value in the Label and Value boxes.
•To delete a list item, select the item in the list and click the Minus (-) button.
•To edit a list item, select the list item, and then specify a new label or value in the Label and Value boxes.
•To specify a default item when the list is displayed the first time, enter the value of the item in the Select Value
Equal To box.
5If you select From Database, do the following:
•Select the DataSet that will populate the list.
•Specify the column in the DataSet that will provide the labels of the list items.
•Specify the column in the DataSet that will provide the values of the list items.
•To specify a default item when the list is displayed the first time, enter the value of the item in the Select Value
Equal To box.
See also
“Defining sources of dynamic content” on page 547
“Create a dynamic ASP.NET menu” on page 687
“Make existing HTML form menus dynamic” on page 609
Display dynamic content in an ASP.NET TextBox control
You can display dynamic content in ASP.NET TextBox form controls when the ASP.NET page is viewed in a browser.
September 4, 2007
DREAMWEAVER CS3
User Guide
689
Before you begin, you must define a DataSet or other source of dynamic content for the TextBox.
1In Design view, select the TextBox on your page.
2In the Property inspector, click the lightning bolt icon beside the Text box.
The Dynamic Data dialog box appears.
3Select the recordset column that will supply a value to the TextBox object, and click OK.
See also
“Display dynamic content in HTML text fields” on page 609
“Defining sources of dynamic content” on page 547
Dynamically preselect ASP.NET CheckBox controls
You can let the server determine whether the CheckBox control is selected. At run time, the server compares a value
you specified to a value in a DataSet. If the values match, the server selects the check box when the ASP.NET page is
loaded in a browser.
Note: Before you begin, you must define a DataSet or other source of dynamic content for the check boxes. Ideally, the
source of content should contain Boolean data, such as Yes/No or true/false.
1Select a CheckBox form control on the ASP.NET page.
2In the Property inspector, select the Dynamic option.
3Complete the Dynamic CheckBox options, and click OK.
For more information on ASP.NET CheckBox properties, see the documentation on the Microsoft website at
http://msdn.microsoft.com/library/en-us/cpgenref/html/cpconcheckboxwebservercontrol.asp.
See also
“Dynamically preselect an HTML check box” on page 610
“Defining sources of dynamic content” on page 547
Insert an ASP.NET CheckBoxList control
1Select Insert > ASP.NET Objects > asp:CheckBoxList.
2In the asp:RadioButtonList dialog box, set the options as follows:
ID specifies the name you want to give the form control. The ID is required.
Tool Tip Specifies the text displayed when the mouse pointer hovers over the form control in a browser.
DataSet Specifies the data source you want to use to populate the items of the list control. If you don’t specify a
DataSet, you can specify one later or set the list items statically by clicking the List Items button in the Property
inspector.
Get Labels From Specifies the field in the selected DataSet to provide the labels of the list items.
Get Values From Specifies the field in the selected DataSet to provide the values of the list items.
Access Key Creates a keyboard shortcut that allows users to quickly navigate to the form control in a browser. For
example, if you enter K, the user can navigate to the control by typing Alt+K. The access key can only consist of a
single character.
September 4, 2007
DREAMWEAVER CS3
User Guide
690
Auto Postback Indicates whether a postback to the server automatically occurs when the user changes the list
selection. Select the option to allow postbacks.
For more information on ASP.NET CheckBoxList properties, see the documentation on the Microsoft website at
http://msdn.microsoft.com/library/en-us/cpgenref/html/cpconcheckboxlistwebservercontrol.asp.
Insert an ASP.NET RadioButtonList control
1Select Insert > ASP.NET Objects > asp:RadioButtonList.
2In the asp:RadioButtonList dialog box, set the options as follows:
ID Specifies the name for the form control. The ID is required.
Tool Tip Specifies the text displayed when the mouse pointer hovers over the form control in a browser.
DataSet Specifies the data source you want to use to populate the items of the list control. If you don’t specify a
DataSet, you can specify one later or set the list items statically by clicking the List Items button in the Property
inspector.
Get Labels From specifies the field in the selected DataSet to provide the labels of the list items.
Get Values From specifies the field in the selected DataSet to provide the values of the list items.
Select Value Equal To specifies a value the server uses to determine which list item is selected when the RadioBut-
tonList is displayed in a browser. The server compares each item’s value to the specified value. If the values match,
the matching item is selected.
Access Key creates a keyboard shortcut that allows users to quickly navigate to the form control in a browser. For
example, if you enter K, the user can navigate to the control by typing Alt+K. The access key can only consist of a
single character.
Auto Postback indicates whether a postback to the server automatically occurs when the user changes the list
selection. Select the option to allow postbacks.
For more information on ASP.NET RadioButtonList properties, see the documentation on the Microsoft website at
http://msdn.microsoft.com/library/en-us/cpgenref/html/cpconradiobuttonlistwebservercontrol.asp.
Preselect an item in an ASP.NET RadioButtonList control
You can let the server decide whether to select a radio button in a RadioButtonList control when the ASP.NET page
is loaded in a browser.
Note: Before you begin, you must insert at least one ASP.NET RadioButtonList control in your page. You must also
define a DataSet or other source of dynamic content for the radio buttons. Ideally, the source of content should contain
Boolean data, such as Yes/No or true/false.
1In Design view, select the RadioButtonList control.
2In the Property inspector, click List Items.
3Select the From Database option, and set any of the following options:
See also
“Dynamically preselect an HTML radio button” on page 610
“Defining sources of dynamic content” on page 547
September 4, 2007
DREAMWEAVER CS3
User Guide
691
Preselect an ASP.NET RadioButton control
You can let the server determine which RadioButton in a group is selected. At run time, the server compares each
checked value you specified to a value in a DataSet. If the values match, the server checks the RadioButton.
For more information on ASP.NET RadioButton properties, see the documentation on the Microsoft website at
http://msdn.microsoft.com/library/en-us/cpgenref/html/cpconradiobuttonwebservercontrol.asp.
❖Select the Dynamic option in the Properties inspector and set the Dynamic Radio Group options.
Creating ASP.NET DataGrid and DataList web controls
Comparing the ASP.NET DataGrid and DataList controls
The ASP.NET DataGrid and DataList controls provide numerous options for displaying different data types
(especially dynamic content from a database), and simplify the process of binding data sources to the controls.
Dreamweaver supports both the DataGrid and DataList controls as server behaviors. The controls provide the
following features:
DataGrid
creates a multi-column, data-bound grid. This control allows you to define various types of columns, both to
lay out the contents of the grid and to add specific functionality (edit button columns, hyperlink columns, and so on).
DataList displays items from a data source using templates. You can customize the appearance of the control by
manipulating the templates that make up its different components.
About the ASP.NET DataGrid web control
The Dreamweaver DataGrid allows you to insert an ASP.NET DataGrid web control. The DataGrid control renders
tables as multi-column grids, and can include different column types (heterogeneous columns) for defining the
layout of cell contents. These include bound, button, and template columns, among others. In addition, the DataGrid
supports interactive functionality such as column sorting, editing, and commands. The following table shows the
column types that are available in the DataGrid:
DataGrid Column Type Description
Simple Data Field Referred to as a “bound column” in ASP.NET, the Simple Data Field column
lets you specify which data source field to display, and the data format the
field will use with a .NET formatting expression.
Free Form Referred to as a “template column” in ASP.NET, the Free Form column type
lets you create combinations of HTML text and server controls to design a
custom layout for a column. The controls within a free-form column can be
data-bound. Free-form columns give you added flexibility in defining the
layout and functionality of the grid contents, because you have complete
control over how the data is displayed and what happens when users
interact with rows in the grid.
September 4, 2007
DREAMWEAVER CS3
User Guide
692
Before using the DataGrid server behavior, you must define a DataSet (referred to as a recordset by other document
types) for the DataGrid.
TolearnmoreabouttheDataGridcontrol,andhowitcanbeusedtoformatdynamicdata,seetheMicrosoftwebsite
at http://msdn.microsoft.com/library/en-us/cpgenref/html/cpcondatagridwebservercontrol.asp.
See also
“About recordsets” on page 543
Add an ASP.NET DataGrid control to a page
DataGrid controls let you format and display dynamic data in multi-column grids that are rendered as tables.
Note: Before inserting the DataGrid server behavior, you must define a DataSet (referred to as a recordset by other
document types) for the DataGrid.
1Open the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button, and select DataGrid.
2Select the ID attribute (or label) of the DataGrid control.
This field is pre-populated with a value. You can change the value of the DataGrid; however, if you set the value of
the field to that of an existing ID, you must enter a new attribute value.
3Select a DataSet to associate with the DataGrid.
This is the DataSet from which the DataGrid retrieves information. Dreamweaver fills the Grid Columns box with
bound columns for all of the fields in the selected DataSet.
4Specify the number of records to be displayed.
5Select the type of page navigation links to implement.
•The Links To Previous And Next Pages item adds Next and Prev links.
•The “Numbered Links To Every Page” item adds page-number links— for example, “1 2 3 4 5 n...”.
6Remove the grid columns you don’t want by selecting them in the Grid Columns box, and clicking the Minus (-)
button.
7YoucanedittheremaininggridcolumnsbyselectingacolumnintheGridColumnsboxandsettingitsproperties.
Hyperlink The Hyperlink column displays information as hypertext links. A typical use
is to display data (such as a customer number or product name) as a hyper-
link that users can click to navigate to a separate page that provides details
about that item.
Edit, Update, Cancel Buttons Referred to as the “edit command” column in ASP.NET, the Edit, Update,
Cancel Buttons column lets users perform in-place editing of information
in DataGrid rows. To do so, create an Edit, Update, Cancel Buttons column.
At run time, this column displays a button labeled Edit. When the user
clicks the Edit button, the row data is displayed in editable controls such as
text boxes, and the Edit button is replaced with Update and Cancel
buttons.
Delete Button The Delete Button lets a user delete a particular row by clicking a button.
DataGrid Column Type Description
September 4, 2007
DREAMWEAVER CS3
User Guide
693
To change the DataGrid column type, click the Edit button and select a column type from the pop-up menu. A dialog
box specific to the chosen column type appears. Specify the content and formatting of the selected DataGrid column.
The following table lists the column types:
8Repeat the previous step for each column you want to change.
9To change the order of the columns in the DataGrid, select a column in the Grid Column box, and click the up or
down arrow to move the column left or right in the DataGrid.
In the Document window, the DataGrid is displayed with a tabbed, gray outline surrounding it. In the Live Data
window (View > Live Data), the gray outline disappears and the object’s placeholder is replaced with the specified
DataGrid.
Add an ASP.NET DataList control to a page
The Dreamweaver DataList server behavior lets you insert an ASP.NET DataList object into a page. This object is
only available with ASP.NET document types.
Note: Before inserting the DataList server behavior, you must define a DataSet (referred to as a recordset by other
document types) for the DataList.
1Open the Server Behaviors panel (Window > Server Behaviors), click the Plus (+) button, and select DataList.
2(Optional) Change the default name of the DataList.
3Associate a DataSet with the DataList.
DataGrid column type Description
Simple Data Field Referred to as a “bound column” in ASP.NET, the Simple Data Field column
lets you specify which data source field to display, and the data format the
field will use with a .NET formatting expression. For more information, see
“Specify and format a data source field in a DataGrid” on page 695.
Free Form Referred to as a “template column” in ASP.NET, the Free Form column lets
you create combinations of HTML text and server controls to design a
custom layout for a column. The controls within a free-form column can be
data-bound. Free-form columns give you great flexibility in defining the
layout and functionality of the grid contents, because you have complete
control over how the data is displayed and what happens when users
interact with rows in the grid. For more information, see “Design a custom
layout for a free-form DataGrid column” on page 695.
Hyperlink The Hyperlink Column displays information as hyperlinks. A typical use is
to display data (such as a customer number or product name) as a hyper-
link that users can click to navigate to a separate page that provides details
about that item. For more information, see “Display data as a hyperlink in
a DataGrid” on page 696.
Edit, Update, Cancel Buttons Referred to as the “edit command” column in ASP.NET, the Edit, Update,
Cancel Buttons column lets users perform in-place editing of information
in DataGrid rows. To do so, create an Edit, Update, Cancel Buttons column.
At run time, this column displays a button labeled Edit. When the user
clicks the Edit button, the row data is displayed in editable controls such as
text fields, and the Edit button is replaced with Update and Cancel buttons.
For more information, see “Allow users to edit in DataGrid rows” on
page 696.
Delete Button The Delete Button lets a user delete a particular row by clicking a button.
For more information, see “Allow users to delete a row in a DataGrid” on
page 697.
September 4, 2007
DREAMWEAVER CS3
User Guide
694
You can select an existing DataSet or enter an arbitrary value. By default, the first DataSet in the list is selected.
4Specify the data to be displayed in the DataList by doing the following in order:
aSelecttheItemtemplatefortheTemplateslist.TheItemtemplaterepresentsalltherowsinthelistotherthanthe
header and footer rows.
bClick the Add Data Field To Contents button.
cIn the Add Data Field dialog box, select a DataSet column and click OK. Dreamweaver adds an appropriate data
binding expression to the Contents box in the DataList Object dialog box.
dFormat the data to be displayed by enclosing the binding expression with HTML tags in the Contents box.
5Adjust the layout of the DataList, as required.
You control the layout of a DataList by selecting from the templates in the Templates list, and then adding HTML
tags in the Contents box. The following table lists the available templates:
6To organize the items in a table, select the Organize Items In A Table option.
If using a table, specify the number of columns in the table. If the number is greater than 1, specify a fill order for the
table cells: select the Wrap Top To Bottom option to wrap the data horizontally or the Wrap Left To Right to wrap
the data vertically.
7Click OK to close the dialog box and create the DataList.
In the Document window, the DataList object is displayed with a tabbed, gray outline surrounding it. In the Live
Data window (View > Live Data), the gray outline disappears and the object’s placeholder is replaced with the
specified DataList.
Modify an ASP.NET DataGrid or DataList control
You can always modify the DataGrid and DataList controls to suit your page design needs.
•In Design view, click the icon on the upper-left corner of the DataGrid or DataList to switch to Edit mode; then
add or modify the content of any of the tabbed regions that appear.
Note: You can also drag sources of dynamic content from the Bindings panel into a tabbed region.
Template Description
Header The text and controls to render at the beginning of the list.
Item The HTML elements and controls to render once for each row in the
data source.
Alternating Item Similar to the Item template element, but rendered for every other row in
the DataList. If you use this template, you typically create a different look
for it, such as a different background color than that of the Item template.
Edit Item The layout of an item when it is in edit mode. This template typically
contains editing controls such as Text Box controls.
Select Item The elements to render when the user selects an item in the DataList.
Typical uses are to visually mark the row using a background or font color.
You can also expand the item by displaying additional fields from the
data source.
Separator The elements to render between each item. A typical example might be a
line (using an <HR> element).
Footer The text and controls to render at the end of the list.
September 4, 2007
DREAMWEAVER CS3
User Guide
695
•In Design view, select the control and use the Property inspector to change any of the options.
•Double-click the object in the Server Behaviors panel and change its properties in the dialog box that opens.
•In Code view, select the DataGrid or DataList on the page, and use its tag dialog box to change its attributes.
Specify and format a data source field in a DataGrid
When creating or editing a DataGrid, use the Simple Data Field column (called a bound column in ASP.NET) to
specify which data source field to display, and the data format the field uses with a .NET formatting expression.
1In the DataGrid dialog box, select the Simple Data Field column in the Columns box.
2In the Simple Data Field dialog box, enter a title for the grid’s header or footer rows. (Displaying a header or footer
row for a DataGrid is controlled by the DataGrid Property inspector.)
3Select a DataSet column with which to populate the DataGrid column from the Data Field pop-up menu.
4Select the Read Only option to specify that the DataGrid does not allow add, update, or delete privileges.
5From the Submit As pop-up menu, select a data type, and click OK.
See also
“Add an ASP.NET DataGrid control to a page” on page 692
“Modify an ASP.NET DataGrid or DataList control” on page 694
Design a custom layout for a free-form DataGrid column
When creating or editing a DataGrid, use the Free Form option (called a template column in ASP.NET) to create
combinations of HTML text and server controls to design a custom layout for a column. The controls within a free-
form column can be data-bound. Free-form columns give you great flexibility in defining the layout and function-
ality of the grid contents, because you have complete control over how the data is displayed and what happens when
users interact with rows in the grid.
1In the DataGrid dialog box, select the Free Form column in the Columns box.
2In the Free Form dialog box, enter a title for the grid’s header or footer rows. (Displaying a header or footer row
for a DataGrid is controlled by the DataGrid Property inspector.)
3Select a template to use with the Free Form DataGrid from the Template pop-up menu.
4Click the Add Data Field button, select a DataSet column to populate the grid column, and click OK.
An appropriate data-binding expression is displayed in the Contents box.
5Format the Free Form column by enclosing the binding expression with HTML tags in the Contents box.
6From the Submit As pop-up menu, select a data type, and click OK.
See also
“Add an ASP.NET DataGrid control to a page” on page 692
“Modify an ASP.NET DataGrid or DataList control” on page 694
September 4, 2007
DREAMWEAVER CS3
User Guide
696
Display data as a hyperlink in a DataGrid
When creating or editing a DataGrid, use the Hyperlink Column to display information as hyperlinks. A typical use
is to display data (such as a customer number or product name) as a hyperlink that users can click to navigate to a
separate page that provides details about that item.
1In the DataGrid dialog box, select the Hyperlink column in the Columns box.
2In the Hyperlink Column dialog box, enter a title for the column.
3From the Hyperlink Text section, select the Static Text or Data Field option:
• If you select Static Text, enter the text of the hyperlink.
•If you select Data Field, select a DataSet column to provide the hyperlink text.
4From the Linked Page section, select the Static URL or Data Field option:
•If you select Static URL, enter the URL of the destination page or browse to select the destination page.
• If you select Data Field, select a DataSet column to provide the URL.
5If you are creating the hyperlink using the Data Field options, specify a formatting expression for the hyperlink
text in the Format String box. For more information about format expressions, see the appropriate ASP.NET
documentation for the String.Format Method for DataGrids.
6Click OK.
See also
“Add an ASP.NET DataGrid control to a page” on page 692
“Modify an ASP.NET DataGrid or DataList control” on page 694
Allow users to edit in DataGrid rows
When creating or editing a DataGrid, use the Edit, Update, Cancel Button column (called the Edit Command
Column in ASP.NET) to let users perform in-place editing of information in DataGrid rows. At run time, this
column displays a button labeled Edit. When the user clicks the Edit button, the row data is displayed in editable
controls such as boxes, and the Edit button is replaced with Update and Cancel buttons.
1In the DataGrid dialog box, select the Edit, Update, Cancel Buttons column in the Columns box.
2In the Edit, Update, Cancel Buttons dialog box, enter a title for the column.
3From the Button Type pop-up menu, select link or push buttons.
At run time, this column displays a button labeled “Edit.” Link buttons use text links for the buttons, and push
buttons use images.
4From the Update Table pop-up menu, select the database table whose data the user will modify.
5From the Primary Key pop-up menu, select a primary key associated with the table.
6Select a data type from the Submit As pop-up menu, and click OK.
See also
“Add an ASP.NET DataGrid control to a page” on page 692
“Modify an ASP.NET DataGrid or DataList control” on page 694
September 4, 2007
DREAMWEAVER CS3
User Guide
697
Allow users to delete a row in a DataGrid
When creating or editing a DataGrid, use the Delete Button (called aButton Columnin ASP.NET) to let a user delete
a particular row by clicking a button.
1In the DataGrid dialog box, select the Delete Button column in the Columns box.
2In the Delete Button dialog box, enter a name for the column.
3From the Button Type pop-up menu, select either link or push buttons.
At run time, this column displays a button labeled Delete. Link buttons use text links for the buttons, and push
buttons use images.
4From the Delete From pop-up menu, select the database table whose data the user will delete.
5From the Primary Key pop-up menu, select a primary key associated with the table.
6From the Submit As pop-up menu, select a data type, and click OK.
See also
“Add an ASP.NET DataGrid control to a page” on page 692
“Modify an ASP.NET DataGrid or DataList control” on page 694
September 4, 2007
698
Chapter 22: Automating tasks
You can automate tasks by repeating steps recorded in the History panel or saving a series of steps as a command.
Automating frequently performed tasks saves time and effort.
Automating tasks
Task automation
The History panel records the steps you take when you complete a task. Automate a frequently performed task by
replaying those steps from the History panel or creating a new command that performs the steps automatically.
Certain mouse movements, such as selecting by clicking in the Document window, can’t be played back or saved.
Whenyoumakesuchamovement,ablacklineappearsintheHistorypanel(thelinedoesnotbecomeobviousuntil
you perform another action). To avoid this, use the arrow keys instead of the mouse to move the insertion point
within the Document window
Some other steps also aren’t repeatable, such as dragging a page element to somewhere else on the page. When you
perform such a step, an icon with a small red X appears in the History panel.
Saved commands are retained permanently (unless you delete them), while recorded commands are discarded when
you exit from Adobe® Dreamweaver® CS3, and copied sequences of steps are discarded when you copy something else
Use the History panel
TheHistorypanel(Window>History)showsalistofthestepsyou’veperformedintheactivedocumentsinceyou
created or opened that document (but not steps you’ve performed in other frames, in other Document windows, or
in the Site panel). Use the History panel to undo multiple steps at once and to automate tasks.
A. Slider (thumb) B. Steps C. Replay button D. Copy Steps button E. Save As Command button
The slider, or thumb, in the History panel initially points to the last step that you performed.
Note: Youcan’trearrangetheorderofstepsintheHistorypanel.Don’tthinkoftheHistorypanelasanarbitrarycollection
of commands; think of it as a way to view the steps you’ve performed, in the order in which you performed them.
Undo the last step
❖Do one of the following:
•Select Edit > Undo.
•Drag the History panel slider up one step in the list.
B
A
CDE
September 4, 2007
DREAMWEAVER CS3
User Guide
699
Note: To scroll automatically to a particular step, you must click to the left of the step; clicking the step itself selects the
step. Selecting a step is different from going back to that step in your undo history.
Undo multiple steps at once
❖Drag the slider to point to any step, or click to the left of a step along the path of the slider.
The slider scrolls automatically to that step, undoing steps as it scrolls.
Note: As with undoing a single step, if you undo a series of steps and then do something new in the document, you can
no longer redo the undone steps; they disappear from the History panel.
Set the number of steps that the History panel retains and shows
The default number of steps is sufficient for most users’ needs. The higher the number, the more memory the History
panel requires, which can affect performance and slow your computer significantly.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2Select General from the Category list on the left.
3Enter a number for Maximum Number Of History Steps.
When the History panel reaches this maximum number of steps, the earliest steps are discarded.
Erase the history list for the current document:
❖In the History panel’s context menu, select Clear History.
This command also clears all undo information for the current document; after choosing Clear History, you can’t
undo the steps that are cleared. Clear History does not undo steps; it merely removes the record of those steps from
memory.
Repeat steps
Use the History panel to repeat the last step you performed, repeat a series of adjacent steps, or repeat a series of
nonadjacent steps. Replay the steps directly from the History panel.
Repeat one step
❖Do one of the following:
•Select Edit > Redo.
•In the History panel, select a step and click the Replay button. The step is replayed and a copy of it appears in the
History panel.
Repeat a series of steps
1Select steps in the History panel:
•To select adjacent steps, drag from one step to another (don’t drag the slider; just drag from the text label of one
step to the text label of another step), or select the first step, and then Shift-click the last step.
•To select nonadjacent steps, select a step, and then Control-click (Windows) or Command-click (Macintosh) to
select or deselect other steps.
The steps played are the selected (highlighted) steps, not necessarily the step the slider currently points to.
Note: Although you can select a series of steps that includes a black line indicating a step that can’t be recorded, that step
is skipped when you replay the steps.
September 4, 2007
DREAMWEAVER CS3
User Guide
700
2Click Replay.
The steps are replayed in order, and a new step, Replay Steps, appears in the History panel.
Make or extend a selection
❖Hold down the Shift key while pressing an arrow key.
Ifablackmouse-movementindicatorlineappearswhileyou’reperformingataskyouwanttorepeatlater,youcan
undo back to before that step and try another approach, perhaps using the arrow keys.
Apply steps in the history to objects
You can apply a set of steps from the History panel to any object in the Document window.
If you select multiple objects and then apply steps to them from the History panel, the objects are treated as a single
selection and Dreamweaver attempts to apply the steps to that combined selection; however, you can apply a set of
steps only to a single object at a time.
To apply the steps to each object in a set of objects, you must make the last step in the series select the next object in
the set. The second procedure demonstrates this principle in a specific scenario: setting the vertical and horizontal
spacing of a series of images.
Apply steps to one other object
1Select the object.
2Select the relevant steps in the History panel, and click Replay.
Apply steps to multiple objects
1Startwithadocumentinwhicheachlineconsistsofasmallimage(suchasagraphicalbulletoranicon)followed
by text.
The goal is to set the images off from the text and from the other images above and below them.
2Open the Property inspector (Window > Properties), if it isn’t already open.
3Select the first image.
4In the Property inspector, enter numbers in the V Space and H Space boxes to set the image’s spacing.
5Click the image again to make the Document window active without moving the insertion point.
6Press the Left Arrow key to move the insertion point to the left of the image.
7Press the Down Arrow key to move the insertion point down one line, leaving it just to the left of the second image
in the series.
8Press Shift+Right Arrow to select the second image.
Note: Do not select the image by clicking it, or you won’t be able to replay all the steps.
September 4, 2007
DREAMWEAVER CS3
User Guide
701
9In the History panel, select the steps that correspond to changing the image’s spacing and selecting the next image.
Click Replay to replay those steps.
The current image’s spacing changes, and the next image is selected.
10 Continue to click Replay until all the images are spaced correctly.
Copy and paste steps between documents
Each open document has its own history of steps. You can copy steps from one document and paste them into
another.
Closing a document clears its history. If you know you will want to use steps from a document later, copy or save the
steps before you close the document.
1In the document containing the steps you want to reuse, select the steps in the History panel.
2Click Copy Steps in the History panel .
Note: The Copy Steps button in the History panel is different from the Copy command in the Edit menu. You can’t use
Edit > Copy to copy steps, although you do use Edit > Paste to paste them.
Be careful when you copy steps that include a Copy or a Paste command:
•
Don’tuseCopyStepsifoneofthestepsisaCopycommand;youmaynotbeabletopastesuchstepsthewayyouwant.
•If your steps include a Paste command, you can’t paste those steps, unless the steps also include a Copy command
before the Paste command.
3Open the other document.
4Place the insertion point where you want it, or select an object to apply the steps to.
5Select Edit > Paste.
The steps are played back as they’re pasted into the document’s History panel. The History panel shows them as only
one step, called Paste Steps.
If you pasted steps into a text editor or into Code view or the Code inspector, they appear as JavaScript code. This
can be useful for learning to write your own scripts.
See also
“Writing and editing code” on page 313
September 4, 2007
DREAMWEAVER CS3
User Guide
702
Create and use commands from history steps
Save a set of history steps as a named command, which then becomes available in the Commands menu. Create and
save a new command if you might use a set of steps again, especially the next time you start Dreamweaver.
Create a command
1Select a step or set of steps in the History panel.
2Click the Save As Command button, or select Save As Command from the History panel’s context menu.
3Enter a name for the command and click OK.
The command appears in the Commands menu.
Note: The command is saved as a JavaScript file (or sometimes an HTML file) in your Dreamweaver/Configu-
ration/Commands folder. If you are using Dreamweaver on a multiuser operating system, the file is saved in the specific
user’s Commands folder.
Use a saved command
1Select an object to apply the command to, or place the insertion point where you want to apply the command.
2Select the command from the Commands menu.
Edit a command name
1Select Commands > Edit Command List.
2Select a command to rename, enter a new name for it, and then click Close.
Delete a name from the Commands menu
1Select Commands > Edit Command List.
2Select a command.
3Click Delete, and then click Close.
Record and save commands
Record a temporary command for short-term use, or record and save a command to use later. Dreamweaver retains
only one recorded command at a time; as soon as you start recording a new command, the old command is lost,
unless you save it before recording the new command.
Temporarily record a series of steps
1Select Commands > Start Recording, or press Control+Shift+X (Windows) or Command+Shift+X (Macintosh).
The pointer changes to indicate that you’re recording a command.
2When you finish recording, select Commands > Stop Recording, or press Control+Shift+X (Windows) or
Command+Shift+X (Macintosh).
Play back a recorded command
❖Select Commands > Play Recorded Command, or press Control+Shift+R (Windows) or Command+Shift+R
(Macintosh).
Save a recorded command
1Select Commands > Play Recorded Command.
2SelecttheRunCommandstepthatappearsintheHistorypanel’ssteplist,andthenclicktheSaveAsCommand
button.
September 4, 2007
DREAMWEAVER CS3
User Guide
703
3Enter a name for the command, and click OK.
The command appears in the Commands menu.
September 4, 2007
704
Chapter 23: Accessibility
Adobe® Dreamweaver® CS3 includes a number of features that let you design and develop accessible web pages.
Additionally, the application itself is accessible to people with disabilities.
Dreamweaver and accessibility
Accessible content
Accessibility refers to making websites and web products usable for people with visual, auditory, motor, and other
disabilities. Examples of accessibility features for software products and websites include screen reader support, text
equivalents for graphics, keyboard shortcuts, change of display colors to high contrast, and so on. Dreamweaver
provides tools that make it accessible to use and tools that help you author accessible content.
For Dreamweaver developers who need to use accessibility features, the application offers screen reader support,
keyboard navigation, and operating system accessibility support.
For web designers who need to create accessible content, Dreamweaver assists you in creating accessible pages that
contain useful content for screen readers and comply with federal government guidelines. For example, dialog boxes
prompt you to enter accessibility attributes—such as text equivalents for an image—when you insert page elements.
Then, when the image appears on a page for a user with visual disabilities, the screen reader reads the description.
Dreamweaveralsoprovidessamplewebpagesthatweredesignedforaccessibilityandanaccessibilityreportthatyou
can run to test your page or site against the Section 508 accessibility guidelines.
Note: For more information about two significant accessibility initiatives, see the World Wide Web Consortium Web
Accessibility Initiative (www.w3.org/wai) and Section 508 of the U.S. Federal Rehabilitation Act (www.section508.gov).
No authoring tool can automate the development process. Designing accessible websites requires you to understand
accessibility requirements and make ongoing decisions about how users with disabilities interact with web pages.
The best way to ensure that a website is accessible is through deliberate planning, development, testing, and evalu-
ation.
Dreamweaver accessibility validation feature
The accessibility validation feature in Dreamweaver uses technology from UsableNet. UsableNet is an industry
leader in developing easy-to-use software to automate usability and accessibility testing and repair. For additional
assistance with accessibility testing, try the UsableNet LIFT for Macromedia Dreamweaver, a solution for developing
usable and accessible websites. UsableNet LIFT for Macromedia Dreamweaver includes fix wizards for complex
tables, forms, and images; a global ALT text editor; customizable reporting; and a new active monitoring mode that
ensures content is accessible as pages are being built. Request a demo of LIFT for Macromedia Dreamweaver at
www.usablenet.com.
September 4, 2007
DREAMWEAVER CS3
User Guide
705
Dreamweaver accessibility features
Using screen readers with Dreamweaver
A screen reader recites text that appears on the computer screen. It also reads non-textual information, such as
button labels or image descriptions in the application, provided in accessibility tags or attributes during authoring.
As a Dreamweaver designer, you can use a screen reader to assist you in creating your web pages. The screen reader
starts reading from the upper-left corner of the Document window.
Dreamweaver supports JAWS for Windows, from Freedom Scientific (www.freedomscientific.com), and Window-
Eyes screen readers, from GW Micro (www.gwmicro.com).
Support for operating system accessibility features
Dreamweaver supports accessibility features in both the Windows and Macintosh operating systems. For example,
on the Macintosh you set the visual preferences in the Universal Access Preferences dialog box (Apple > System
Preferences). Your settings are reflected in the Dreamweaver work space.
The Windows operating system’s high contrast setting is also supported. You activate this option through the
Windows Control Panel and it affects Dreamweaver as follows:
•Dialog boxes and panels use system color settings. For example, if you set the color to White on Black, all
Dreamweaver dialog boxes and panels appear with a white foreground color and black background.
•Codeviewusesthesystemandwindowtextcolor.Forexample,ifyousetthesystemcolortoWhiteonBlack,and
then change text colors in Edit > Preferences > Code Coloring, Dreamweaver ignores those color settings and
displays the code text with a white foreground color and black background.
•Design view uses the background and text colors you set in Modify > Page Properties so that pages you design
render colors as a browser will.
Navigate Dreamweaver using the keyboard
You can use the keyboard to navigate panels, inspectors, dialog boxes, frames, and tables without a mouse.
Note: Tabbing and the use of arrow keys are supported for Windows only.
Navigate panels
1In the Document window, press Control+F6 to shift focus to a panel.
A dotted line around the panel title indicates that focus is on that panel. The screen reader reads the panel title bar
that has focus.
2Press Control+F6 again to shift focus until you have focus on the panel you want to work in. (Press
Control+Shift+F6 to shift focus to the previous panel.)
3If the panel you want to work in is not open, use the keyboard shortcuts in the Windows menu to display the
appropriate panel; then press Control+F6.
If the panel you want to work in is open, but not expanded, place focus on the panel title bar, and then press the
Spacebar. Press the Spacebar again to collapse the panel.
4Press the Tab key to move through the options in the panel.
September 4, 2007
DREAMWEAVER CS3
User Guide
706
5Use the arrow keys as appropriate:
•If an option has choices, use the arrow keys to scroll through the choices, and then press the Spacebar to make a
selection.
•If there are tabs in the panel group to open other panels, place focus on the open tab, and then use the left or right
arrowkeytoopenanothertabs.Onceyouopenanewtab,presstheTabkeytomovethroughtheoptionsinthat
panel.
Navigate the Property inspector
1Press Control+F3 (Windows only) to display the Property inspector, if it is not visible.
2Press Control+Alt+Tab until you shift focus to the Property inspector.
3Press the Tab key to move through the Property inspector options.
4Use the arrow keys as appropriate to move through option choices.
5PressControl+TabtoopenandclosetheexpandedsectionofthePropertyinspector,asnecessary,or,withfocus
on the expander arrow in the lower-right corner, press the Spacebar.
Navigate a dialog box
1Press the Tab key to move through the options in a dialog box.
2Use the arrow keys to move through choices for an option.
3If the dialog box has a Category list, press Control+Tab (Windows) to shift focus to the category list, and then use
the arrow keys to move up or down the list.
4Press Control+Tab again to shift to the options for a category.
5Press Enter to exit the dialog box.
Navigate frames
❖If your document contains frames, you can use the arrow keys to shift focus to a frame.
Select a frame
1Press Alt+Down Arrow to place the insertion point in the Document window.
2Press Alt+Up Arrow to select the frame that currently has focus.
3Continue pressing Alt+Up Arrow to shift focus to the frameset, and then to the parent framesets, if there are
nested framesets.
4Press Alt+Down Arrow to shift focus to a child frameset or a single frame within the frameset.
5With focus on a single frame, press Alt+Left or Right Arrow to move between frames.
Navigate a table
1Use the arrow keys or press Tab to move to other cells in a table as necessary.
Pressing Tab in a right-most cell adds another row to the table.
2To select a cell, press Control+A (Windows only) while the insertion point is in the cell.
3To select the entire table, press Control+A twice if the insertion point is in a cell, or once if a cell is selected.
September 4, 2007
DREAMWEAVER CS3
User Guide
707
4To exit the table, press Control+A three times if the insertion point is in a cell, twice if the cell is selected, or once
if the table is selected, and then press the Up, Left, or Right Arrow key.
Designing pages for accessibility
Optimize the work space for accessible page design
When you create accessible pages, you need to associate information, such as labels and descriptions, with your page
objects to make your content accessible to all users.
To do this, activate the Accessibility dialog box for each object, so that Dreamweaver prompts you for accessibility
information when you insert objects. You can activate a dialog box for any of the objects in the Accessibility category
in Preferences.
1Select Edit > Preferences (Windows) or Dreamweaver > Preferences (Macintosh).
2
Select Accessibility from the Category list on the left, select an object, set any of the following options, and click OK.
Show Attributes When Inserting Select the objects for which you want to activate accessibility dialog boxes. For
example, form objects, frames, media, and images.
Keep Focus In The Panel Maintains focus on the panel, which makes it accessible to the screen reader. (If you don’t
select this option, the focus remains in Design or Code view when a user opens a panel.)
Offscreen Rendering Select this option when using a screen reader.
Note: Accessibility attributes appear in the Insert Table dialog box when you insert a new table.
See also
“Insert an image” on page 244
“Inserting Flash content” on page 255
“Validate HTML form data” on page 611
“Create frames and framesets” on page 205
“Insert a table and add content” on page 178
September 4, 2007
708
Chapter 24: Shortcuts and extensions
You can customize keyboard shortcuts (including shortcuts for code snippets) and define shortcut sets to use for
different projects. You can also add and manage new features (extensions) that let you reformat tables, connect to
back-end databases, or help you write scripts for browsers.
Keyboard shortcuts
Create a reference sheet for the current shortcut set
A reference sheet is a record of the current shortcut set. The information is stored in HTML table format. You can
view the reference sheet in a web browser or print it.
1Select Edit > Keyboard Shortcuts (Windows) or Dreamweaver > Keyboard Shortcuts (Macintosh).
2Click the Export Set As HTML button, which is the third button in the set of four at the top of the dialog box.
3In the Save dialog box that appears, enter the name for the reference sheet, and select the appropriate location for
saving the file.
Customize keyboard shortcuts
Use the Keyboard Shortcut Editor to create your own shortcut keys, including keyboard shortcuts for code snippets.
You can also remove shortcuts, edit existing shortcuts, and select a predetermined set of shortcuts in the Keyboard
Shortcut Editor.
See also
“Work with code snippets” on page 315
Create a keyboard shortcut
Create your own shortcut keys, edit existing shortcuts, or select a predetermined set of shortcuts.
1Select Edit > Keyboard Shortcuts (Windows) or Dreamweaver > Keyboard Shortcuts (Macintosh).
2Set any of the following options and click OK:
Current Set
Allows you to choose a set of predetermined shortcuts included with Dreamweaver, or any custom set
you’ve defined. The predetermined sets are listed at the top of the menu. For example, if you are familiar with the
shortcuts found in HomeSite or BBEdit, you can use those shortcuts by choosing the corresponding predetermined set.
Commands Allows you to select a category of commands to edit. For example, you can edit menu commands, such
as the Open command, or code editing commands, such as Balance Braces.
Toaddoreditakeyboardshortcutforacodesnippet,selectSnippetfromtheCommandspop-upmenu.
The command list Displays the commands associated with the category you selected from the Commands pop-up
menu, along with the assigned shortcuts. The Menu Commands category displays this list as a tree view that repli-
cates the structure of the menus. The other categories list the commands by name (such as Quit Application), in a
flat list.
September 4, 2007
DREAMWEAVER CS3
User Guide
709
Shortcuts Displays all shortcuts assigned to the selected command.
Add Item (+) Adds a new shortcut to the current command. Click this button to add a new blank line to the
Shortcuts. Enter a new key combination and click Change to add a new keyboard shortcut for this command. You
can assign two different keyboard shortcuts for each command; if there are already two shortcuts assigned to a
command, the Add Item button does nothing.
Remove Item (-) Removes the selected shortcut from the list of shortcuts.
Press Key Displays the key combination you enter when you’re adding or changing a shortcut.
Change Adds the key combination shown in the Press Key to the list of shortcuts, or changes the selected shortcut
to the specified key combination.
Duplicate Set Duplicates the current set. Give the new set a name; the default name is the current set’s name with
the word copy appended.
Rename Set Renames the current set.
Export as HTML File Saves the current set in an HTML table format for easy viewing and printing. You can open the
HTML file in your browser and print the shortcuts for easy reference.
Delete Set Deletes a set. (You cannot delete the active set.)
Remove a shortcut from a command
1Select Edit > Keyboard Shortcuts (Windows) or Dreamweaver > Keyboard Shortcuts (Macintosh).
2From the Commands pop-up menu, select a command category.
3In the Commands list, select a command and then select a shortcut.
4Click the Remove Item (-) button.
Add a shortcut to a command
1Select Edit > Keyboard Shortcuts (Windows) or Dreamweaver > Keyboard Shortcuts (Macintosh).
2From the Commands pop-up menu, select a command category.
3In the Commands list, select a command.
To add a keyboard shortcut for a code snippet, select Snippet from the Commands pop-up menu.
The shortcuts assigned to the command appear in the Shortcuts.
4Prepare to add a shortcut by doing one of the following:
•If there are fewer than two shortcuts already assigned to the command, click the Add Item (+) button. A new blank
line appears in the Shortcuts and the insertion point moves to the Press Key.
•If there are already two shortcuts assigned to the command, select one of them (that one will be replaced by the
new shortcut). Then click in the Press Key.
5Press a key combination. The key combination appears in the Press Key.
Note: If there is a problem with the key combination (for example, if the key combination is already assigned to another
command), an explanatory message appears just below the Shortcuts and you may be unable to add or edit the shortcut.
6Click Change. The new key combination is assigned to the command.
Edit an existing shortcut
1Select Edit > Keyboard Shortcuts (Windows) or Dreamweaver > Keyboard Shortcuts (Macintosh).
2From the Commands pop-up menu, select a command category.
September 4, 2007
DREAMWEAVER CS3
User Guide
710
3In the Commands list, select a command and then select a shortcut to change.
4Click in the Press Key and enter a new key combination.
5Click the Change button to change the shortcut.
Note: If there is a problem with the key combination (for example, if the key combination is already assigned to another
command), an explanatory message appears just below the Shortcuts field and you may be unable to add or edit the
shortcut.
About keyboard shortcuts and non-U.S. keyboards
The default Dreamweaver keyboard shortcuts work primarily on U.S.-standardized keyboards. Keyboards from
other countries (including those produced in the United Kingdom), may not provide the functionality necessary for
utilizing these shortcuts. If your keyboard does not support certain Dreamweaver-enabled shortcuts, Dreamweaver
disables their functionality.
To customize keyboard shortcuts that work with non-U.S.-standardized keyboards, see “Changing keyboard
shortcut mappings” in Extending Dreamweaver.
Extensions
Add and manage extensions in Dreamweaver
Extensions are new features that you can add easily to Dreamweaver. You can use many types of extensions; for
example, there are extensions that let you reformat tables, connect to back-end databases, or help you write scripts
for browsers.
Note: To install extensions that all users have access to in a multiuser operating system, you must be logged in as Admin-
istrator (Windows) or root (Mac OS X).
To find the latest extensions for Dreamweaver, use the Adobe Exchange website at
www.adobe.com/go/dreamweaver_exchange/.Oncethere,youcanloginanddownloadextensions(manyofwhich
are free), join discussion groups, view user ratings and reviews, and install and use the Extension Manager. You must
install the Extension Manager before you can install extensions.
The Extension Manager is a separate application that lets you install and manage extensions in Adobe applications.
Start the Extension Manager from Dreamweaver by choosing Commands > Manage Extensions.
1On the Adobe Exchange website, click the download link for an extension.
Your browser might let you choose to open and install it directly from the site or save it to disk.
•If you are opening the extension directly from the site, the Extension Manager handles the installation automati-
cally.
•If you are saving the extension to disk, a good place to save the extension package file (.mxp) is the Downloaded
Extensions folder within the Dreamweaver application folder on your computer.
2Double-click the extension package file, or open the Extension Manager and select File > Install Extension. (Some
extensions aren’t accessible until you restart the application.
Note: Use the Extension Manager to remove extensions or to see more information about an extension.
See also
“About customizing Dreamweaver in multiuser systems” on page 36
September 4, 2007
711
Index
Symbols
? in field names 529
Numerics
127.0.0.1 IP number 499
A
absolute paths 280
access options, transferring files
using
FTP 44, 65, 66
Local/Network 44, 65, 66
SourceSafe Database 44, 65, 66
WebDAV 44, 65, 66
access privileges
adding to pages 663
storing in a database 664
Access. See Microsoft Access
accessibility
activating 707
attributes, editing 271
entering image tag values 245
frames 206, 209
images 247
keyboard-only navigation 705
media objects 270
objects, inserting 612
of Help 3
operating system features 705
screen readers 705
validation utility 704
Accordion widget
See also Spry
about 451
adding panels to 451
changing order of panels 452
customizing 452
deleting panels from 452
inserting 451
opening panels for editing 452
accounts, troubleshooting account
logon 528
actions
See also names of individual actions
about 347
browser compatibility 350
changing in behaviors 349
choosing in Behaviors panel 349
included with Dreamweaver 350
activation of software 1
active content
converting 215
troubleshooting 299
workaround for restricted 299
Active Links color option (Page
Properties) 239
Active Server Pages. See ASP
ActiveX controls 275
ActiveX objects 567
Adobe Bridge
about 383
integration 366
placing files into
Dreamweaver 384, 385
starting Dreamweaver in 385
starting from Dreamweaver 384
Adobe ColdFusion. See ColdFusion
Adobe Contribute. See Contribute
Adobe CSS Advisor 141
Adobe Design Center 9
Adobe Device Central
integration 366
Adobe Dreamweaver
integration with Contribute 56
integration with Fireworks 367
integration with Flash 382
integration with Photoshop 374
optimizing Dreamweaver content
for mobile devices 386
testing mobile content created
in 300
using with Device Central 385
Adobe Fireworks
Design Notes in 102
integration with Dreamweaver 367
integration with Flash and
Photoshop 366
pop-up menus 361, 369, 370
preferences, launch and edit 371
Adobe Fireworks integration
copying Fireworks HTML 371
creating web photo albums 372
editing Fireworks images 367
launch-and-edit preferences 371
optimizing images from
Dreamweaver 368
updating Fireworks HTML 372
Adobe Flash
See also entries beginning with
“Flash.”
integration with Dreamweaver 382
Adobe Flash Video
editing and deleting 268
Flash Player detection 268
inserting 264, 266
options for delivery 265
options for progressive
download 266
options for streaming video 266
Adobe Flash Video detection, adding
and removing 268
Adobe FlashPaper documents,
inserting 264
Adobe Help 2
Adobe InDesign
integration 366
Adobe Photoshop
copying and merging images 375
copying and pasting slices in 375
editing files 376
Image Preview options 378
inserting PSD images 375
integration with
Dreamweaver 374, 377
integration with Flash and
Fireworks 366
optimizing images for
Dreamweaver 378
recopying images 378
reinserting images 377
Adobe Video Workshop 5
Advanced Recordset dialog box
Database Items tree 555
entering SQL 553, 554
September 4, 2007
INDEX 712
aligning
AP elements 160
images 240
options 249
page elements 249
text 240
tracing images 176
All Info tab (Design Notes) 103
alternative (Alt) text 245
Anchor object (Insert bar) 285
Anchor Points For Aligned Elements
option 221
Anchor Points For Layers option 221
anchors, named 285
animation 168
animations
along complex path 168
applying to objects 171
copying and pasting 170
creating 168
improving 171
timelines 166
AP elements
about 151
aligning 160
anchor points 220
changing stacking order of 158
changing visibility with AP
Elements panel 158
changing visibility with
behaviors 360
converting to tables 161
defined by styles 133
draggable 354
in table design 161
moving 160
nested 153, 154
positioning 155
positioning with CSS styles 133
preferences 162
preventing overlap 161
properties for multiple 156
properties for single 155
properties, setting 155
resizing 159
selecting multiple 156, 157
showing and hiding borders 153
snapping to grid 175
view and set preferences 154
visibility, changing 158
working with 152, 153
AP Elements panel 157
Apache web server on Mac OS X 501
AppleTalk servers 44, 65, 66
applets. See Java applets
application integration, with other
Adobe software 366
application servers
about 493
setting up 502
application variables 558
Apply Source Formatting option 77
Apply Template To Page
command 414
ASP
application servers 505
command objects, using 651
connecting to ISP 514
connection without DSN 513
database connections 510
DSN connections 512
editing scripts 336
insert pages, building 633
login pages 660
master and detail pages 622
OLE DB connections 510
search pages, building 624
stored procedures 657
ASP.NET
CheckBox controls 689
database connections 518
DataGrid column types 691
DataGrid control 691, 692
DataGrid Delete Buttons 691
DataGrid web control 691
DataList control 691
dynamic 687
form controls, adding 686
form controls, modifying 686
importing tags 346
insert pages, building 633
installing the .NET
Framework 506
languages used with 496
ListBox control 687
radio button, preselecting 690
search pages, building 629
stored procedures 655
TextBox control 688
writing SQL for 544
assets
categories 110
colors, creating 114
copying and pasting 113
editing 113
Favorites folder, creating 115
Favorites list 110, 114
inserting 111
managing 109
reusing in another site 113
selecting multiple 112
Site list 110, 111
URLs, creating 114
using the Assets panel 110
viewing 109
working with 109
Assets panel
opening 109
Templates category 396
using 110
Attach Style Sheet icon 139
attributes
See also code
editing with the Tag inspector 331
encoding values 312
making dynamic 566
searching for 320
audio. See sound
authorization levels 662
automating tasks 698
auto-number fields,
troubleshooting 529
Autoplay option (Timelines
panel) 167
autostretch (Layout mode) 193
B
background
background image and color,
setting 130
CSS style settings 130
image and color, setting 130, 217
properties 130
transparency in 217
Background File Activity dialog
box 90
background file transfers 87
balancing braces 327
September 4, 2007
INDEX 713
Base properties 339
baseline alignment 249
Basic Info tab (Design Notes) 103
behaviors
about 347
compatibility with browsers 350
forms, attaching behaviors to 612
frames, using with 213
images 255
JavaScript 347
library items and 119
links, attaching to 282
media, adding 277
third-party, installing 350
working with 349
Behaviors panel 347
Bindings panel
adding dynamic text 565
creating a record counter 577
deleting data sources 563
displaying Spry built-in
elements 483, 485
Format column 578
making forms dynamic 608
making HTML attributes
dynamic 566
bitmap images
See also images
resizing 250
Block category (CSS style) 131
block properties, defining 131
blockquote tag, applying 240
bold text, setting 241
BOM 74
Border options (CSS Rule
Definition) 132
border properties 132
Box options (CSS Rule
Definition) 132
braces, balancing 327
Bridge Home 8
broken links 295
Browser Compatibility Check
feature 141
browsers
colors, web-safe 222
compatibility, with frames 212
previewing in 298
primary, defining 299
versions, checking 351
Bullet Image option 133
buttons
Go buttons 356
inserting 601
C
C# language 496
caching data sources 563
Call JavaScript action 350
cascading documents 25
Cascading Style Sheets (CSS)
code formatting with CSS rules 140
converting in-line CSS 138
creating new rules 129
cross-browser style rendering 141
CSS Styles panel 23, 124
layouts, about 145
layouts, creating 69, 149
moving rules 137
overview of 120
removing style from a
selection 137
setting background properties 130
setting preferences 128
setting type properties 130
shorthand properties 123
shorthand rules 128
updating rules in a Contribute
site 144
using (class) rules 136
Case option (CSS Rule
Definition) 130
case, changing 309, 321
case-sensitive links 43
catalogs, database 540
categories, assets 110
cells. See layout cells
CFForm 675
CFML (ColdFusion Markup
Language) 495
CFML. See ColdFusion Markup
Language
Change Link Sitewide command 289
Change Link Sitewide dialog box 289
Change Property action 351
characters, valid in account
names 528
Check Browser action 351
Check In/Check Out system
about 91
checking files in and out 93
dependent files 85
finding checked out files 82
setting up 91
undoing a file check-out 94
Check Links Sitewide command 296
Check Plugin action 352
Check Spelling command 128, 233
CheckBox control 689
child tags, selecting 330
Clean Up Word HTML command 76
clearing column widths 186
client-side image maps. See image
maps
Clip option 133
cloaking, site
enabling and disabling 100
files 100
uncloaking all 101
Close tags 314
code
case, changing 309
cleaning up 326
coding environment,
customizing 307
coding guidelines 599
collapsing 324
coloring preferences 312
comments 319
comparing files 96
copying and pasting 319
editing in templates 389
external editors 313
in external files 335
formatting preferences 309
head section of a document 337
indenting 309, 319, 322, 344
invalid 301
languages, supported 301
line numbers 309
navigation 320
preferences, setting 309
printing 323
Reference panel 323
rewriting automatically 302
searching 320
selecting in Contribute 569
September 4, 2007
INDEX 714
server behaviors 306
snippets 315
tag editors 319
tag libraries 343
tag, closing 314
validation preferences, setting 326
viewing options 309
viewing source 307
word wrap 309
wrapping selection using the
Quick Tag Editor 333
writing and editing 313
XHTML 302
code blocks
coding guidelines 599
parameter markers 597
positioning 593
writing 590
code collapse 324, 325
Code Coloring preferences for
templates 418
code hints
about 313
preferences 311
Quick Tag Editor 334
tag libraries 343
Code inspector 307
setting default fonts 38
Code Navigation button 320
code tag 38
Code view
combined with Design view 17
displaying 307
opening non-HTML files 308
toggling to Design view 25
viewing template-based
documents 394
viewing templates 393
writing and editing code 313
code, editing with
Property inspector 331
Quick Tag Editor 333
Tag inspector 331
code, inserting
in Design view 335
with the Insert bar 318
with the Quick Tag Editor 333
with the Tag Chooser 318
coding guidelines 599
Coding toolbar 20, 316
coding workflow 14
ColdFusion
buttons 679
check boxes 680
client variables 545
components 665
Components panel 669
components, defining a
recordset 670
components, recordset as data
source 670
components, using 667, 670
data sources, creating 509
database connections 508
delete pages 643
form controls, modifying 685
forms 674
hidden fields 678
insert pages, building 633
inserting fields 682, 684
installing 502
languages used with 496
login pages 660, 665
master and detail pages
(ColdFusion, ASP, JSP,
PHP) 622
pages that use components 669
pages, debugging 329
password fields 677
radio buttons 681
search pages, building 624
select boxes 681
stored procedures 654
text areas 678
update pages 637
validating form data 685
ColdFusion Markup Language
(CFML) 495
debugging 187, 329
editing CFML tags 331
ColdFusion MX 7 enhancements 674
Collapsible Panel widget
See also Spry
about 458
customizing 460
enabling animation for 459
inserting 459
opening and closing 459
setting default state of 459
Color option (CSS Rule
Definition) 130
color picker
Continuous Tone option 223
Dreamweaver 223
Grayscale option 223
Mac OS 223
system 223
using 223
Windows OS option 223
colors
adding to assets 114
as assets. See assets
choosing 223
code, preferences 312
default for page text 239
eyedropper, using 223
frame background 210
page background 217
swatches 223
text, changing 240
web-safe 222
column header menu
about 176
changing spacing 199, 200
column width, setting 199
displaying 186, 192
inserting columns 187
remove a spacer image 200
Select Column 180
column widths, clearing 186
columns, rows, and cells
adding and removing 187
background color, adding 183
command objects, ASP 651
commands
accessing from context menu 30
creating, from history steps 702
recording 702
comments
adding and removing comment
tags 321
inserting and editing 319
Comments option 221
components
ColdFusion 665
Components panel 669
connecting to databases 501
connection keys, exporting 60
September 4, 2007
INDEX 715
connection parameters, JDBC 521
connection scripts, removing 530
Connection Speed option 26
connection strings
OLE DB 520
setting 511
connections to Contribute sites,
troubleshooting 61
content, adding to tables 178
context menus 30
Contribute
administrative settings,
changing 60
compatibility, enabling 59
CSS styles 144
dynamic content 569
event logging 59
files, managing 57, 61
integration with Dreamweaver 56
permissions on servers 58
roles, changing 60
rolling back files 99
site definitions, exporting 60
site root URL, setting 59
site structure, creating 57
sites, managing with
Dreamweaver 56, 57, 60
special files, working with 58
templates 396, 411
Contribute Publishing Server
(CPS) 56, 59
Control Shockwave or Flash
action 352
converting AP elements to tables 161
copying and pasting
assets 113
code collapse 325
from Photoshop to
Dreamweaver 375
recordsets 563
table cells 189
CPS (Contribute Publishing
Server) 59
Create Image In Fireworks
command 368
Create Web Photo Album
command 372
CSS Styles panel 23, 128
about 124
Cursor (pointer) option 134
CSS layout blocks. See layout blocks
custom tags, importing 345
customizing, coding
environment 307
D
data formats
predefined 578
using preset styles 578
Data Link Properties 519
data objects
Record Update Form 640
Data Source Name. See DSN
data sources
about 543
application variables 558
caching 563
defining in Dreamweaver 509
deleting 563
form parameters, about 532
JavaBeans 672
JSP variables 561
recordsets, about 543
recordsets, creating (simple) 547
session variables 535, 558
submitted by users 532
URL parameters, about 533
data types, mismatched 528, 529
database connections
ASP 510
ASP.NET 518
ColdFusion 508
connection strings 511
for web applications 501
JDBC 521
MySQL 517
OLE DB 510, 518
OLE DB parameters 520
PHP 517
Database Items tree 554, 555
Database Items tree, defining SQL
variables 552
database management systems 497
databases
about 497
choosing 495
connections 501
content storage 531
displaying data 494
drivers for 494, 497
file-based 495
insert pages 633
locked 527
login pages 660
modifying with stored
procedures 654
MySQL 495, 517
permissions, changing 526
queries 494
recordsets for 494
relational 498
results pages 624
results pages, building 629
schemas and catalogs 540
search pages, building 624
server-based 495
stored procedures 654, 655
tables 494
update pages, building 637
using with web applications 491
dates
inserting 243
troubleshooting 528
DBMS. See database management
systems
debugging ColdFusion pages 329
Decoration option (CSS Rule
Definition) 130
Default Document Type (DTD) 328
defining CSS Type properties 130
delete pages, building
ColdFusion 643
deleting
data sources 563
dynamic content 568
files and folders 81
files in a Contribute site 61
library items 118
recordsets 563
rows and columns 187
unused files 83
dependent files 54, 85, 87
description properties, setting
search 338
Design Center 9
design files 73, 74
design frames 203
Design Notes
about 102
adding status choices 104
September 4, 2007
INDEX 716
All Info tab 103
Basic Info tab 103
deleting unassociated 104
enabling and disabling 102
for Fireworks or Flash files 102
for Fireworks, Flash, and
Photoshop files 366
for media objects 273
for Photoshop files 375, 376
opening 104
saving file information 103
setting up 102
design schemes, to format tables 181,
184
Design view
displaying with Code view 307
JavaScript, inserting 335
refreshing 307
selecting child tags 330
toggling to Code view 25
VBScript, inserting 335
viewing template-based
documents 393
viewing templates 392
design-time feeds, used with
Spry 480, 482
Design-Time style sheets, using 143
desktop, accessing files on 84
destroying temporary files,
permissions for 527
detaching
documents from templates 414
library items to make editable 119
detail regions in Spry 479, 482
detecting Flash Player for Flash
Video 268
Device Central integration
Dreamweaver 385
Device Central. See Adobe Device
Central
diff tools 96
Director, creating Shockwave movies
with 273
disabling
Design Notes 102
site cloaking 100
Display Dependent Files option 55
display options
fonts 38
displaying
AP elements 158
code hints 313
FTP log 89
multiple records 574
table and column widths 186
tracing images 176
div tag, inserting 162
Document toolbar 16, 17
Document Type Definition (DTD)
files 345
Document window
basics 17, 24
magnification 224
page size and download time 19
playing Navigator plug-ins 275
resizing 25
searching for text 229
selecting elements 219
status bar 18
tag selector 19
title bar 17
viewing code 25
Window Size pop-up menu 19
zooming 223
document-relative paths
about 280
setting 284
documents
applying a template 413
cascading 25
checking links 295
cleaning up Word HTML 76
creating 69, 73
creating a blank template 70
creating, based on a design file 74
creating, based on a template 72
Design Notes, using with 102
detaching a template 414
displaying in tabs (Macintosh) 34
download size, time 225
opening other types 75
previewing in browsers 298
saving as a template 395
searching 229
setting a default type for new 74
setting properties 216
tiling 25
downloading
behaviors 350
files 88
size, time estimates 19, 225
downloads
updates, plug-ins, and tryouts 10
Drag Layer action 353
drawing
AP elements 152
nested AP elements 154
Dreamweaver Exchange 590, 710
Dreamweaver site. See sites 41
Dreamweaver. See Adobe
Dreamweaver
drivers for databases 494, 497
drivers, not specified 527
drop-down menu form objects 602
DropDownList control 687
DSN
connections without DSN 513
creating a connection 512
troubleshooting 527
DTD files 345
dynamic content
about 543, 608
adding to pages 564
advanced recordset, creating 550
attributes 566
binding HTML attributes 566
form check boxes 610
form menus 608, 609
form text fields 609
images 565
objects 567
radio buttons 610
recordset, creating 547
recordsets, about 543
removing 568
replacing 567
selecting in Contribute 569
text 565
workflow for 14
dynamic pages
about 497
working with 493, 495
dynamic Spry tables
about 479
creating 484
September 4, 2007
INDEX 717
E
editable regions (templates)
changing the name of 399
controlling in nested templates 407
creating 398
working with 399
editable tag attributes (templates)
making uneditable 405
modifying in template-based
documents 415
setting 404
editing 563
ASP.NET form controls 686
assets 113
code 313
CSS style sheets 140
data formats 578
data sources 563
files in a Dreamweaver site 84
files on a server 84
Flash button objects 258
font lists 242
keyboard shortcuts 708
library items 117
media object attributes 271
no-frames content 212
Photoshop PSD files 376
recordsets 563
server behaviors 598
sites 41
style sheets, external 135
templates 409
websites, existing local 42
websites, existing remote 50
editing in Photoshop from
Dreamweaver 376
editors. See external editors
effects, with Spry 486
elements
anchor points 220
snapping to grid 175
elements, aligning 249
e-mail files 76
Email Link dialog box 286
e-mail links
changing 289
creating 286
inserting 286
Embedded Styles option 221
empty tags, removing 326
enabling
cloaking 100
Design Notes 102
encoding
entity encoding 74, 219
types 38
error messages
See also troubleshooting
file already in use 527
Microsoft, troubleshooting 526
event handlers. See events
events
about 347
available for different browsers
and objects 348
changing in behaviors 349
logging 59
triggering actions 349
examples of web applications 491
Excel. See Microsoft Excel files
Expanded Tables mode 183
Export Table command 179
exporting
connection keys for Contribute 60
saving optimized Photoshop
images 379
sites 51
table data 178
Expression Object Model
(templates) 391
extensibility, third-party
behaviors 350
Extension Manager 710
extensions
creating 590
installing 590
managing 710
external editors
HTML 313
images 253
media 271
preferences 313
setting Photoshop for JPEG, GIF,
and PNG files 377
setting Photoshop for PSD
files 377
text 313
external links 295
external style sheets
creating 139
editing 135
linking to 139
extracting data from databases 494
Extras 7
eyedropper 223
F
Favorites folder 115
Favorites list (Assets panel)
about 110
adding a color 114
adding a URL 114
adding and removing assets 114
creating a Favorites folder 115
creating nicknames for 115
viewing 110
"file already in use" error message 527
file comparison 96
file formats, image 243
file server-side includes 341
file transfer preferences 85
file transfers, logging 91
file types
about 68
external editor preferences
and 313
Flash files 255
File Types/Editors preferences 272
File View Columns category 86
files
accessing on a local drive or
desktop 84
accessing on Dreamweaver sites 84
accessing on servers 84
background transfers 90
cloaking and uncloaking 100
comparing 96
deleting 81
dependent 85
Design Notes, using with 102
diffs 96
downloading 88
editors, preferences 313
extension, setting 75
locating 82, 83
managing in Contribute sites 57
moving 81
September 4, 2007
INDEX 718
opening 75, 81
opening in Code view 308
putting 89
renaming 81
rolling back 99
searching 229
synchronizing local and remote
sites 94
temporary 527
text 76
transferring 44, 65, 66
transferring with WebDAV 44, 65,
66
unlocking in Contribute sites 61
unused, finding 83
uploading 89
working during transfer 87
Files panel
changing column display and
order 86
changing the view 80
collapsing and expanding 79
Log button 91
moving files and folders 81
opening and closing 79
opening files 81
preferences 85
refreshing 81
searching for files 82
Site Files view 78
site maps 52
toolbar options 77
viewing files in 79
working with files and folders 81
file-upload fields 605
Filter, recordset 548
filters
setting CSS style 134
Find In options 229
finding and replacing. See searching
finding unused files 83
firewalls
defining host and port 85
options 45, 63
Fireworks. See Adobe Fireworks
Fixed Font option 38
Flash button objects
modifying 258
properties 258
Flash components
editing properties 261
working with 260, 261
Flash content
about 255
Design Notes in 102
Flash objects, making dynamic 567
Flash SWF files
See also Adobe Flash
as assets. See assets
controlling 352
inserting 256
properties 257
Flash text objects
inserting and previewing 260
properties 258
Flash Video. See Adobe Flash Video
Flash. See Adobe Flash
FlashPaper documents, inserting 264
Float option, CSS style 132
floating panels, combining 31
folders 100
cloaking and uncloaking 100
Favorites, for assets 115
searching 229
working with 81
fonts
basic settings 130
changing combinations 242
changing styles 241
encoding preferences 38
encodings, setting fonts for 38
preferences, setting 38
form controls
ASP.NET 686
formatting
code, setting preferences for 308
tables and cells 181, 184
text, with CSS and HTML 237
forms
about 600
about dynamic objects 608
accessibility 612
adding to a document 602
ASP.NET 686
buttons 601
client-side scripting 612
ColdFusion 674
controls, ColdFusion 676
creating 602
delimiting element borders 221
dynamic check boxes 610
dynamic menus 608, 609
dynamic radio buttons 610
dynamic text fields 609
fields, validating 364
file fields 602, 605
hidden fields 601
image fields 605
insert or change dynamic
objects 608
JavaScript, using with 612
jump menus, creating 290
list menus 602
radio buttons 602
renaming form items when
pasting 312
server-side scripting 601
text fields 601
using to gather data 625, 629
validating ColdFusion forms 685
validating HTML 611
frames
about 201
adding accessibility attributes 206
adding to a timeline 169
browser compatibility 212
changing background color 210
changing content with links 212
creating 205
deleting 206
editing accessibility attributes 209
Frames panel 207
nested 204
planning content with 203
properties, setting 209
resizing 207
saving 208
selecting 207
targeting 212
using with behaviors 213
Frames panel 207
framesets
See also frames
about 202
naming 209
nested 204
properties 210
September 4, 2007
INDEX 719
saving 208
selecting 207
targeting links in 281
FTP
getting and putting files 87
log 88, 89
preferences 85
troubleshooting 47
Use Passive FTP option 45
functions, viewing 320
G
gathering data from users 625, 629
General preferences 36
Generator objects, making
dynamic 567
Get More Behaviors command 350
getting and putting files 88
GIF images
as tracing image 175
uses for 243
glossary of common web-application
terms 497
Go button, associating with a jump
menu 356
Go To URL action 355
GoLive
migrating sites 24
graphics. See images
Grayscale option 223
grids
as visual guides 24
showing and hiding 175
snapping elements to 175
guides
using layout 173
using with templates 174
H
Hand tool 19, 224
head section, viewing and editing 337
header cell, formatting 183
heading tag 239
Help
about 2
hidden characters 309
hidden files, showing and hiding 54
hidden form fields 221, 601
hiding and showing
invisible elements 219
pop-up menus 363
Highlighting preferences
content blocks 164
layout cells 195
library items 118
tables 181
template regions 419
hints menus for code 313
History panel
commands, creating from history
steps 702
history list, clearing 699
maximum steps, setting 699
overview 698
steps, copying and pasting 701
home page, setting for site map 52
horizontal rules, inserting and
modifying 241
hotspots
applying behaviors to 255
in image maps 293
resizing 295
selecting multiple in an image
map 294
HTML
See also code
attribute reports 106
attributes, making dynamic 566
converting to XHTML 328
embedded programming
languages 495
formatting and inserting 226
non-breaking space 227
roundtrip editing 302
setting file extension 75
source code, searching 229
HTML attrbutes, binding to data 566
HTML forms. See forms
HTML head tags
setting links to same target 283
HTML tags, cleaning up 77
HTML, generated by Word 76
HTTP servers 499
HTTP servers. See also servers
Hyperlink Column (ASP.NET)
dialog box 696
Hyperlink dialog box 284
I
illegal characters in account
names 528
image buttons 605
image maps
creating client-side 293
hotspots 293
overview 293
selecting multiple hotspots 294
viewing in document 221
image placeholder properties 248
image placeholders, modifying in
Fireworks 368
Image Preview options, optimizing
Photoshop images 375, 376, 379
images
about 243
aligning 240
applying behaviors to 255
as assets. See assets
brightness and contrast 251
changing source files with
timelines 169
cropping 251
editing with external editor 253
formats, supported 243
image maps 293
inserting 244
inserting from Fireworks 367
inserting from Photoshop 375
inserting in Layout mode 196
making dynamic 565
optimizing in Fireworks 251, 368
optimizing Photoshop images 375,
376, 378
preloading (behavior) 357
properties 245
resampling 251
scalability 250
sharpening 252
swapping and restoring swapped
(behavior) 363
Import Table command 179
importing
ASP.NET tags 346
custom tags 345
external CSS style sheet 139
JRun tags 346
JSP tags 346
Microsoft Word files 76
September 4, 2007
INDEX 720
sites 51
tabular data 179, 234
text from other documents 234
includes, server-side 341
indenting code 309, 319, 322, 344
InDesign. See Adobe InDesign
Insert bar
about 16
categories 19
inserting code 318
showing categories as tabs 28
using 28
inserting
ActiveX controls 275
assets 111
comments 319
dates 243
div tags 162
e-mail links 286
Fireworks images 367
Flash SWF files 256
Flash text objects 260
HTML head tags 283
image placeholders 247
images 244
library items 116
media elements 270
nested AP elements 154
pages 633
Photoshop images 375
rollover images 252
server-side includes 342
Shockwave movies 256, 273
special characters 227
inspectors
Property inspector 30
Tag inspector 331
installing, IIS (Internet Information
Services) 500
Internet Explorer
active content 215
content restricted 299
Internet Information Services (IIS),
installing 500
Internet Protocol, version 6 (IPv6) 44
invalid tags, displaying 302
invisible elements
comments 319
preferences 220
scripts 335
selecting and viewing 219
showing and hiding 219
IP addresses and number
(127.0.0.1) 499
ISP 514
italics, setting text in 241
J
Jakarta Tomcat application server
(JSP) 506
JAR files 346
Java applets
inserting 270, 276
making dynamic 567
properties 276
Java, and JSP 496
JavaScript 496
actions 348
alerts 357
attaching to form objects 612
behaviors 347
executing 350
files 76
inserting code in Design view 335
pop-up menu behavior 361
processing form data 612
JavaServer Pages. See JSP
JDBC
connection parameters 521
drivers 522
JPEG images
as tracing image 175
uses for 243
JRun 346, 506
JRun application server 506
JRun tags 346
JSP (JavaServer Pages)
application servers 506
Callable server behavior 657
importing tags 346
insert pages, building 633
JavaBeans 672
JDBC drivers 522
JSP variables 561
login pages, building 660
master and detail pages,
building 622
ODBC connections 523
prepared statements 653
resultsets, about 543
search pages, building 624
server technology 496
stored procedures 657
jump menus
about 602
changing menu items 291
creating a selection prompt for 290
editing 355
Go buttons 290, 356
inserting 290
K
keyboard shortcuts
and non-U.S. keyboards 710
editing and viewing 708
in Help 3
keyframes
creating 168
keywords
specifying 338
L
languages
reference 323
server-side 495, 496
supported in Dreamweaver 301
layers
copying from Photoshop 375
layout blocks
and design-time style sheets 165
highlighting preference 164
inserting 162
viewing 164
working with div tags 163
layout cells
about 191
background color 198
clearing heights 196
formatting 198
highlighting preference 195
No Wrap option 198
preferences 201
Layout mode
about layout cells and tables 191
adding content to 196
autostretch 193
cell spacing 198
clearing cell heights 196
September 4, 2007
INDEX 721
column header menu 199
fixed width 193
make cell widths consistent 198
nested layout tables 194
preferences 201
removing nesting 198
removing spacer images 198
resizing and moving layout cells
and tables 198
resizing and moving layout cells
and tables, working with 197
setting width 193
spacer images, preferences 193
switching to and from Standard
mode 193
layout tables
about 191
nested 194
preferences 201
layout, planning. See Layout mode
leading (line height) 130
Legacy folder, for code snippets 315
library items
about 108
adding to pages 116
as assets. See assets
changing highlight color 118
creating 116
deleting 118
editing 117
editing behaviors in 119
making editable in documents 119
preferences 118
properties 118
recreating 118
renaming 117
line breaks, invisible elements
preference 221
line height 130
line numbers in code 309
lines, wrapping in Code view 309
Link Checker panel 296
link href tag 139
linked documents, opening 289
linking
anchors 285
documents using Point-to-File
icon 283
documents 281
to external CSS style sheet 139
to named anchor using Point-to-
File icon 286
navigation and 279
to external style sheets 139
to Microsoft Word or Excel
documents 235
links
to anchors 285
broken, finding 295
cache file 287
case-sensitive 43
changing frames with 212
changing sitewide 289
checking 295
creating null links 287
files in site map 54
fixing broken 296
opening source 288
properties 340
Relative to Document option 282
Relative to Site Root option 282
removing 288
to script files 335
setting relative paths 284
site map 288
to style sheets 139
targeting 281
updating 287
links, setting color (Page
Properties) 239
list menus 602
list properties 133, 228
ListBox control 687
lists
creating 228
defining styles 133
Live Data Settings dialog box 582
Live Data window
about 568
Auto Refresh 582
missing files 581
providing expected
parameters 582
URL parameters on toolbar 568,
582
viewing 580
live objects
recordset counters 576
recordset navigation links 571
LiveDocs 2
local drive, accessing files on 84
local folder, structure 41
local sites. See sites 42
localhost 499
locked
database files 527
files, warning when opening 36
locked regions, clicking in 415
logging
file transfers 91
network activity 59
logging out users 664
login pages
building 660
ColdFusion 665
logon failures, SQL Server 528
looping timelines 169
M
Mac OS color options 223
Macintosh
accessibility 705
servers 501
tabbed documents 34
macros, creating commands 702
map tag 293
Margin option (CSS Rule
Definition) 132
Mark of the Web, code 299
markers for invisible elements 219
markup. See code
master and detail pages, building
(ColdFusion, ASP, JSP, and
PHP) 622
master and detail regions in Spry 479
Match Whole Word option 230
MDAC (Microsoft Data Access
Components) 518
media elements
inserting 270
parameters 277
media object attributes
editing 271
Menu Bar widget
See also Spry
about 453
adding and deleting menus and
submenus 454
assigning target attributes for 455
changing orientation of 456
September 4, 2007
INDEX 722
changing text of menu items 455
changing the order of menu
items 455
creating tool tips for 455
customizing 457
inserting 454
linking menu items 455
turning off styles for 456
Merge Cells command 187
META properties 337
Microsoft Access
file-based database 495
locked database files 527
Microsoft error messages,
troubleshooting 526
Microsoft Excel files, importing 179
Microsoft IIS 505
Microsoft Knowledge Base
articles 527
Microsoft OLE DB providers 518
Microsoft Personal Web Server
(PWS) 498
Microsoft SQL Server 495
Microsoft technical support 527
Microsoft Word documents
cleaning up HTML 76
importing 76
pasting 226, 233
migrating GoLive sites 24
mobile devices
optimizing Dreamweaver content
for 386
modes
Expanded Tables mode 183
Layout mode 191
Standard mode 176
modifying
databases, using stored
procedures 655
monitor size, resizing pages to fit 25
Move to Record behavior 572
movies, inserting 270
moving
code fragments 325
files and folders 81
MPEG movies, as assets. See assets
multimedia. See media elements
multiuser systems 36
MySQL
database for PHP 517
server-based database 495
N
named anchors
creating 285
displaying 221
navigating code 320
navigation bar
about 291
inserting 292
modifying elements 293
navigation links for records,
setting 571
navigation shortcuts, in Adobe
Help 3
Nest When Created Within an AP
Div option 162
nested
AP elements 153
AP elements, preferences for 154,
162
framesets, about 204
tables 190
templates, about 405
templates, creating 407
templates, working with 407
Netscape Enterprise Server 498
Netscape Navigator 4
AP element compatibility 162
compatibility with AP
elements 154
Netscape Navigator plug-ins
playing in Document window 275
properties 274
troubleshooting 275
network activity, logging 59
new document default type,
setting 74
New Document preferences 74
NFS servers 44, 65, 66
non-breaking space, inserting 227
non-HTML files, opening 308
null links
changing 289
creating 287
numbering lines of code 309
numeric network addresses 499
O
objects
adding to a library 116
adding to a timeline 168
display dialog box when
inserting 36
inserting with Insert bar 28
making dynamic 567
ODBC errors 529
OLE DB
connections 510
obtaining a provider 518
onBlur event 364
online resources 7
Open and Edit preferences in
Fireworks 371
Open Attached Template
command 409
Open Browser Window action 356
Open Linked Page command 289
opening
Assets panel 109
Dreamweaver site 84
existing documents 75
files 81
linked documents 289
non-HTML files 308
text files 76
operating systems, multiuser 36
optimizing images
in Fireworks 368
in Photoshop 379
Photoshop images for the web 375,
376, 378
previewing 378
settings for Photoshop images 378
optional regions (templates)
inserting 402
modifying 403
setting options 403
Options menu, for panel groups 32
Oracle 9i database 495
Oracle OLE DB providers 519
Oracle Thin driver 521
orphaned files 83, 295
Overflow option 133
overlapping tags, in code 302
September 4, 2007
INDEX 723
P
Padding option (CSS Rule
Definition) 132
page breaks, setting 134
page layout. See Layout mode
page titles 338
Pagebreak option 134
pages
adding content, workflow for 13
background image or color,
setting 217
default text colors 239
Design Notes, using with 102
displaying database data 494
displaying XML data in 431
download time and size
preferences, setting 225
dynamic 491, 493, 495
dynamic, workflow for creating 14
insert, building 633
laying them out, workflow for 13
previewing in browsers 298
resizing to fit monitor 25
restricting access to 662
static 492
update record, building 637
user registration 658
XHTML, creating 328
palettes, color 223
panels
Assets 110
Assets, Templates category 396
Behaviors 347
Files 77
Frames 207
panel groups 16
saving custom layout 34, 35
paragraph tag 239
paragraphs
adding a line break 240
formatting 239
parameters
defining in an SQL statement 555
making dynamic 567
markers 597
templates 390
to control media elements 277
too few (SQL error) 528
Passive FTP option 45
passwords
checking during login 661
incorrect 528
letting users choose 659
storing 658
pasting
form items 312
history steps 701
paths
absolute 280
document-relative 280
physical 514
root-relative 281
Perl, supported features 301
permissions
creating and destroying temporary
files 527
folder containing database 528
roles in Contribute 60
security 526
on servers 58
troubleshooting 525
write permissions on servers 58
photo albums, creating for web 372
photographs 243
Photoshop. See Adobe Photoshop
PHP
database connections 517
insert pages 633
installing PHP 503
login pages 660
Mac OS X 503
master and detail pages 622
search pages 624
server technology 496
troubleshooting (Macintosh) 505
troubleshooting (Windows) 504
pixels, transparent, in
background 217
placeholder image 248
Placement option 133
planning frames 203
Play Sound action 356
playing Flash objects 260
plug-ins 7
checking 352
in Adobe Store 10
making dynamic 567
Netscape Navigator 274
playing in Document window 275
troubleshooting 275
PNG images
as tracing image 175
uses for 243
pointer, changing the image 134
pop-up menus
Fireworks 361, 369, 370
HTML forms 602
JavaScript behavior 361
positioning 363
Popup Message action 357
positioning
code blocks 593
defining styles 133
list items 133
pre tag 38
preferences
AP elements 154, 162
changing highlighting 164
code 309, 311, 312
Code view 309
CSS Styles 128
dictionary for spell checking 128,
233
external editors 272
File Types/Editors 272, 313
Fonts/Encoding 38
General 36
Highlighting, layout blocks 164
Highlighting, layout cells 195
Highlighting, libraries 118
Highlighting, tables 181
Highlighting, template regions 419
invisible elements 220
Layout mode 201
New Document 74
Site 85
Status Bar 26
template 419
updating links 287
Validator 326
Preload Images action 357
prepared statements, JSP 653
Prevent AP Elements Overlaps
command 161
Preview in Browser command 298
Preview in Browser preferences 225
previewing in browsers 298
September 4, 2007
INDEX 724
printing code 323
properties
ActiveX control 275
changing with behaviors 351
displaying 30
document, setting 216
Flash 257
frame and frameset 209, 210
image 245
image placeholder 248
Java applet 276
layout cells and tables 198
library item 118
multiple AP elements 156
Shockwave 257
single AP element 155
table 181, 184
template-based document 415
Property inspector
ActiveX control properties 275
displaying 30
editing a recordset 567, 568
editing code 331
fixing broken links 296
Flash properties 257
image placeholder 248
Java applet properties 276
library item properties 118
making HTML attributes
dynamic 566
Netscape Navigator plug-in
properties 274
setting image properties 245
Shockwave movie properties 257
proportion, maintaining 250
PSD source files
editing from Dreamweaver 376
Put command 89
putting and getting files
dependent files 85
on a remote server 87, 89
putting files 89
PWS (Microsoft Personal Web
Server) 498
Q
queries
database 494
troubleshooting SQL 528
question marks, in database
fields 529
Quick Tag Editor
hints menus 334
opening 332
QuickTime movies
as assets. See assets
inserting 274, 275
R
radio buttons 602
RadioButton control 690
RadioButtonList control 690
read permissions on servers 58
read-only file warning 36
record counter, building 576
record navigation bar
creating 571
Record Path of AP element
command 168
Record Update Form data object 640
recording commands 702
records
building a counter 576
displaying more than one 574
inserting 633
navigation links 571
updating 637
Recordset dialog box
advanced 550
simple 548
Recordset Navigation Bar live
object 571
Recordset Navigation Status live
object 576
recordsets
See also databases
about 543
caching 563
copying and pasting 563
Database Items tree 555
defining without SQL 547
editing or deleting 563
empty, troubleshooting 530
example 497
limiting the number of records 548
simple, creating 547
SQL, writing custom
statements 550
Reference panel 323
Refresh properties 339
refreshing
Design view 307
Files panel 81
Site list (Assets panel) 111
regions
clicking in locked 415
registration of software 1
registration page 658
regular expressions 304
relational databases 498
relative links, setting to the same
target 283
relative paths 284
remote folder
setting up 42
structure 41
troubleshooting 47
Remote Info category 43
Remove Timeline command 170
removing
design-time connection scripts 530
empty HTML tags 326
frames from a timeline 168, 169
HTML code generated by Word 76
renaming
files and folders 81
library items 117
panel groups 33
Reopen Documents on Startup
option 36
Repeat option 130
Repeat Region behavior 574
Repeat Region XSLT object 432, 433
repeating regions (templates)
alternating colors 401
creating 400
defined 388
displaying 425
repeating table 400
in template-based documents 416
repeating tables (templates)
alternating colors 401
inserting 400
replacing an image placeholder 249
reports
running 106
saving 107
for sites 106
September 4, 2007
INDEX 725
validating code 328
viewing 107
requirements, system 1
requirements, web applications 501
Reset Origin command 175
resizing
AP elements 159
elements, using handles 250
frames 207
layout cells and tables 197
table cells 185
restricting site access 658
restricting tables 540
results pages 624
Results panel group
Validation panel 328
resultset, JSP 543
return, adding a paragraph 240
reusing
assets 113
code 315
library items 116
searches 321
Revert command 226
reverting to last saved version 226
rewriting code 302, 312
rolling back files 99
rollovers
about 252
creating 252
root-relative paths
about 281
setting 284
roundtrip editing 366
Roundtrip HTML 302
rows and columns, adding and
removing 187
rulers
about 175
in Design view 173
S
Save All command 226
Save As command 226
saving
frame and frameset files 208
reports 107
reverting to last saved version 226
searches 321
site maps 55
saving and reverting web pages 226
schemas 345, 540
screen readers, Window-Eyes and
JAWS for Windows 705
Script dialog box options 335
script links
changing 289
creating 287
scripts
as assets. See assets
balanced braces, checking for 327
creating script links 287
editing 335
inserting 335
linking external files 335
showing in Document 220
viewing functions 320
Scripts option 221
scripts, server-side 494
scrolling, background image 131
Search For options 230
search pages, building
ASP 624
ASP.NET 629
ColdFusion 624
JSP 624
PHP 624
searching
code 320
for files 229
finding and replacing 229
regular expressions 304
saving search patterns 321
tags and attributes 320
text within files 229
security
password-protecting a folder 665
setting database permissions
for 526
Select Newer Remote command 95
selecting
AP elements 157
frames and framesets 207
layout cells and tables 197
multiple assets 112
objects in the Document
window 219
table elements 180
tags 334
Sequel (SQL) 494
Server Behavior Builder 590
server behaviors
code for 306
coding guidelines 599
creating 590
creating dialog boxes for 597
editing custom behaviors 599
installing more 590
moving to records 572
repeating regions 574
testing 600
Update Record 640
server models. See server
technologies
server objects
application variables 558
ColdFusion variables 545
session variables 558
server scripts, in templates 389
server technologies
defined 498
supported 496
servers
See also web servers, application
servers
about 498
AppleTalk 44, 65, 66
application servers 493
HTTP 498
IP addresses 499
NFS 44, 65, 66
opening an existing connection 84
testing 500
troubleshooting 500
troubleshooting remote folder 47
uploading pages 605
web servers, defined 498
server-side image maps 293
server-side includes
about 341
changing type (Virtual or File) 342
changing types 342
inserting and editing 342
server-side scripting languages 496
September 4, 2007
INDEX 726
session variables
about 535
data, retrieving 536
data, storing 536
defining 558
form parameters and URL
parameters 536
Set as Home Page command 52
Set Background Color option 77
Set Nav Bar Image action 357
Set Text of Frame action 358
Set Text of Layer action 359
Set Text of Status Bar action 359
Set Text of Text Field action 360
setting
code coloring 418
default new document type 74
document properties 216
fonts and changing
characteristics 241
image placeholder properties 248
image properties 245
list properties 228
shared settings files in Contribute
sites 58
Shockwave movies
as assets. See assets
controlling 352
inserting 256, 273
properties 257
Shockwave objects, making
dynamic 567
shortcut menus. See context menus
Show Dialog When Inserting Objects
option 36
Show Log on Completion option 77
Show Pop-Up Menu behavior 361
Show-Hide Layers action 360
Site Definition dialog box
Design Notes category 102
File View Columns category 86
Remote Info category 43
Site Map Layout category 55
Testing Server category 48
Site Files view 78
Site list (Assets panel)
about 110
refreshing 111
viewing 110
Site Map Layout category 55
site maps
adding files to a site 54
changing links in 288
defined 52
hiding files 54
Link to New File command 54
links, working with 288
modifying layout of 53
saving as an image file 55
setting home page for 52
showing dependent files in 55
showing files 54
Site Map Layout category 55
viewing 53
working with 288
working with pages in 52
Site Root URL option 59
site root-relative paths. See root-
relative paths
site views in Files panel, changing 80
Site window, searching for text 229
sites
assets, reusing 113
broken links, fixing 296
cache file 287
cloaking 99, 100
creating new, Site Definition
wizard 42
Design Notes, using with 102
editing existing websites 42, 50
Files panel display, changing 86
files, working with 80
folder structure 41
importing and exporting 51
large, assets in 114
links, changing sitewide 289
links, checking 295
links, working with 279
local versus remote 40
locating files in 82
managing your files, workflow
for 13
migrating GoLive sites 24
opening for viewing 84
planning 13
previewing in browsers 298
remote folder, troubleshooting
remote folder 47
Remote Info category options 43
removing from site list 51
reports 106
searching for files in 229
security 658
site map, working with 52
synchronizing local and remote 94
testing guidelines 104
Testing Server category options 48
viewing in Files panel 79
slices
copying from Photoshop 375
slider controls, creating 353
smart collapse feature 324
Snap to Web Safe color palette 223
snippets
creating keyboard shortcuts 316
Legacy folder 315
Snippets panel 315
Snippets panel 315
SOAP and web services 585
software
activation 1
downloads 10
registration 1
sound
adding to a page 269
embedding 270
linking to an audio file 270
playing 356
source code
See also code
copying and pasting from
Fireworks to Dreamweaver 371
selecting in the Document
window 219
updating Fireworks HTML placed
in Dreamweaver 372
source control 91
SourceSafe Database access
option 44, 65, 66
spaces
converting to tabs 321
inserting non-breaking 227
special characters
inserting 227
line break 240
question marks in field names 529
in SQL account names 528
spelling dictionaries 233
spelling options, setting 233
September 4, 2007
INDEX 727
spelling, checking with Check
Spelling command 128, 233
Spry
children regions 485
data sets, about 478
data sets, defining 480
design-time feeds 480, 482
detail regions, about 479, 482
displaying built-in elements in
Bindings panel 483, 485
dynamic tables, about 479
effects, about 486
framework, about 449
master-detail regions 479
regions, creating 482
repeat list regions 486
repeat regions 485
tables, creating 484
widgets, about 449
Spry effects
adding additional 489
appear/fade 487
blind up/down 487
deleting 490
grow/shrink 488
highlight 488
shake 489
slide up/down 489
squish 489
SQL
ASP.NET 544
Database Items tree 555
defining recordset SQL
variables 552
recordset, defining with SQL 550
using variables 554, 555
variables 552, 553
SQL (Structured Query
Language) 494
SQL Server connection, creating 519
SQL Server, troubleshooting
dynamic pages 528
stacking order
AP elements 158
changing with timelines 169
Standard mode
about 176
in Property inspector 566
Standard toolbar 16, 18
static pages 492
See also pages
status bar
about 18
preferences 26
resizing the Document window 19
setting text (behavior) 359
stored procedures
about 654
ASP 657
ASP.NET 655
ColdFusion 654
JSP 657
modifying databases 654, 655
Strikethrough (Default Color)
button 223
Structured Query Language
(SQL) 494
style definitions (CSS)
element borders 132
element placement 132
extensions 134
lists 133
positioning 133
tags and properties 131
type 130
Style Rendering toolbar 21
style sheets
Design-Time, using 143
Edit Style Sheet dialog box 140
editing 135
external 139
Style submenu 241
styles
See also style sheets
alignment options 131
applying, removing, and renaming
custom CSS styles 136
converting inline CSS 138
CSS (Cascading Style Sheets) 129
defining borders 132
element placement 132
moving CSS rules 137
spacing options 131
submit buttons 601
Sun JDBC-ODBC Bridge driver 523
Sun ONE Web Server 498
supported languages 301
Swap Image action 363
Swap Image Restore action 363
swatches, color 223
SWF files
editing in Flash from
Dreamweaver 382
updating links 383
synchronizing local and remote
sites 94
syntax errors in insert statements 529
system color picker 223
system requirements 1
T
Tabbed Panels widget
See also Spry
about 461
adding panels to 461
changing order of panels 462
customizing 462
deleting panels from 462
inserting 461
opening panels for editing 462
setting default open panel 462
table cells
See also layout cells, layout tables
background color and image,
adding 183
cutting, copying, and pasting 189
header cells, designating 183
highlighting preference 181
merging and splitting 177
table header menu
about 176
clearing heights and widths 186
displaying 186, 192
Make Widths Consistent 186, 201
Remove All Spacer Images 200
select table elements 180
tables
See also columns, rows, and cells
about 176
AP elements, converting from 161
cells, clearing widths and
heights 186
cells, highlighting 180, 191
cells, merging and splitting 188
column widths, adjusting 186, 201
creating and adding content 178
data, exporting 178
database 494
editing 181, 183, 184
September 4, 2007
INDEX 728
elements, selecting 180
Expanded Tables mode 183
formatting 181, 184
highlighting preference 181
importing 179
nesting 190
preset designs for 181, 184
properties 181, 184
resizing 185
restricting 540
rows and columns, adding and
removing 187
sorting 190
tabular data, importing 234
widths and heights 186
tabs, converting to spaces 321
tabular data, importing 179, 234
Tag Chooser
inserting tags 318
Tag editors 319
Tag inspector 331
Tag Library Editor 343
tag selector 16, 334
tag syntax template 417, 418
Tag Validator 328
tags
See also code
adding to a tag library 343
ASP 336
ASP.NET, importing 346
CFML (ColdFusion markup) 331
closing 312, 314
code 38
custom, importing 345
editing with a Tag editor 319
editing with the Quick Tag
Editor 332
empty, removing 326
invalid 302
JRun, importing 346
JSP, importing 346
libraries 343
nested, combining 326
nested, invalid 312
overlapping 302
pre 38
removing 321, 334
searching for 320
selecting 219, 334
server-side 494
tt 38
targeting
frames 212
links 283
technical support for servers 498
template expressions 390
template parameters
modifying in template-based
documents 415
overview 390
Template Properties dialog box 416
template-based documents
attaching templates 413
in Code view 394
in Design view 393
detaching templates 414
modifying 415, 416
templates
about 387
applying to existing document 413
as assets. See assets
Assets panel 396
changing region highlight
colors 419
checking syntax 418
clicking in locked regions 415
in Code view 393
creating 395
creating for Contribute sites 396
deleting 411
in Design view 392
detaching document from 414
editable regions 398, 399
editable tag attributes 404, 405
editing 409
editing code in 389
editing server scripts 389
expressions 390
finding editable regions 399
making region noneditable 399
modifying properties in template-
based documents 415
nested 405, 407
optional region 402, 403
parameters 390
preferences 418, 419
renaming 410
repeating region 388, 400, 416
repeating table 400, 401
tag syntax 417
types of regions 387
undoing application 414
updating Contribute sites 411
updating documents 410
XML content 412
temporary files, permissions
restrictions 527
terminology for web applications 497
testing a site 104, 106
Testing Server category 48
testing servers
about 500
behaviors 600
setting up 502
text
adding to a document 226
aligning on a page 240
aligning with an image 250
changing color 112, 240
changing font combinations 242
default color in pages 239
fields 601
fields, setting text with
behaviors 360
files, opening 76
formatting 226, 235, 241
formatting (with Property
inspector) 236
importing from other
documents 234
importing tabular data 234
indenting 240
inserting 226
making dynamic 564
non-breaking space 227
outdenting 240
pasting 226, 233
pasting preferences 232
searching within documents 229
underlining 130
Text Color option 239
text editors
See also external editors
files created by 76
specifying 313
text-based HTML editors. See
external editors
TextBox controls 688
tiling documents 25
September 4, 2007
INDEX 729
timelines
adding and removing frames 169
adding objects to 168
animation tips 171
changing AP element
properties 169
changing image source file 169
complex paths 168
creating 168
keyframes 168
looping 169
modifying 169
multiple 170
playing automatically 169
renaming 171
titles, of pages 338
tld files 346
toolbars
Coding 20, 316
displaying 27
Document 17
Standard 18
Style Rendering 21
top alignment 249
tracing images
adjusting position 176
as guides 175
showing 176
transferring files 87
transferring files to and from
Contribute sites 57
transparent pixels in background 217
troubleshooting
about 505
BOF error 529
checking in and out of Contribute
sites 61
clicking in locked regions 415
Contribute 61
Contribute compatibility,
enabling 59
COUNT field incorrect 529
data type mismatch 528
DSN error 527
EOF error 529
file in use 527
links, broken, in Contribute 61
locked files in Contribute sites 61
logon failed 528
Microsoft error messages 526
Netscape Navigator plug-ins 275
ODBC errors 529
pages not displaying 504
parameters, too few 528
permissions 525
PHP (Macintosh) 505
PHP (Windows) 504
servers 498, 500
syntax errors 529
updateable queries 528
tryouts 10
tt tag 38
U
UDDI
public directories 584
site list, editing 587
uncloaking
all folders and files 101
file types 100
site folders 100
underline 241
underscores in SQL account
names 528
undoing
Crop commands 251
file checkouts 94
Sharpen commands 252
Unicode Normalization Form 74
Universal Access 705
Unmark Editable Region
command 399
Update Current Page command 117,
411
Update HTML command in
Fireworks 372
Update Links When Moving Files
option 36
Update Pages command 411
update pages, building
ColdFusion 637
Update Record behavior 640
updates 10
updating templates 410
uploading files 89, 605
URL prefix 49
URLs
See also paths
applying to selection 112
as assets. See assets
creating URL assets 114
Use Firewall option 63
Use Passive FTP option 63
Use Regular Expressions option 230
usemap attribute 293
user names
checking during login 661
checking for uniqueness 660
letting users select 659
storing 658
UTF-8 74
V
Validate Form action 364
validating forms
ColdFusion 685
HTML 611
Validation Checkbox widget
See also Spry
about 475
customizing 477
displaying states in Design
view 477
inserting 476
specifying minimum and
maximum number of
selections 477
specifying validation
occurrence 477
Validation Select widget
See also Spry
about 472
allowing or prohibiting blank
values 474
customizing 474
displaying states in Design
view 474
inserting 473
specifying invalid values 474
specifying validation
occurrence 474
Validation Text Area widget
See also Spry
about 469
adding character counter to 470
blocking extra characters 471
changing required status of 471
creating hints for 471
customizing 471
September 4, 2007
INDEX 730
displaying states in Design
view 470
inserting 470
specifying minimum and
maximum number of
characters 470
specifying validation
occurrence 470
Validation Text Field widget
See also Spry
about 464
blocking invalid characters 467
changing required status 467
creating hints 467
customizing 467
displaying states in Design
view 467
inserting 465
specifying minimum and
maximum number
characters 466
specifying minimum and
maximum values 467
specifying validation
occurrence 466
specifying validation type and
format 465
Validator
preferences 326
using 328
variables in CFML 496
Variant option (CSS Rule
Definition) 130
VBScript 496
VBScript, inserting code in Design
view 335
Video Workshop 5
video, adding Flash and non-flash
media objects 270
viewing
assets 109
code 307
files on a Dreamweaver site 84
files on a drive or desktop 84
files on a server 84
head section code 337
invisible elements 219
templates in Code view 393
templates in Design view 392
virtual directory 49
virtual path 514
virtual server-side includes 341
Visibility option 133
Visited Links color option 239
Visual Basic 496
visual guides
about 24
rulers 175
tracing images 175
W
Warn When Opening Read-Only
Files option 36
web
hosting services 514
server, setting up 499
web applications
common uses 491
creating a root folder 506
database connections 501
defined 498
defining a Dreamweaver site 507
requirements 501
setting up a web server and
application server 499
workflow for setting up 14
web pages. See pages
web photo albums, creating 372
web servers 498
See also servers, application servers
web services
about 583
adding to a page 588
AXIS proxy generator 585
proxy generators, additional 585
proxy generators, configuring 586
proxy generators, installing 585
SOAP 585
UDDI directories 584
UDDI site list, editing 587
workflow 584
web-application terms, defined 497
WebDAV access option 44, 65, 66
WebDAV access, configuring a site
for 92
WebDAV source control 92
web-ready images
about 380
editing in Photoshop 376
Weight option (CSS Rule
Definition) 130
Whitespace option 131
Window Sizes option 26
word processors, files created by 76
Word Spacing option 131
word wrapping 309
Word-specific HTML
removing 76
workflow reports 106
workflow, for dynamic pages 541
workflow, overview 13
working environments, Live Data
window 579
workspace
about 14
floating layout 14
layout 34
saving custom layout 34, 35
wrapping lines in Code view 309
write permissions on servers 58
writing code 313, 590
X
XHTML
code 302
converting from HTML to
XHTML 328
creating pages 328
XML (Extensible Markup Language)
about 420
and repeating elements 425
displaying on dynamic pages 422
displaying on web pages 420
DTD files 345
in templates 412
XML caching Spry option 482
XML Spry data sets 478
XPath
used with Spry 481
XSL (Extensible Stylesheet Language)
See also XSLT
about 420
comments, inserting 440
XSL Transformation server
behavior 422, 434
XSL transformations
client-side 423, 444
editing 435
server-side 421
using parameters with 436
September 4, 2007
INDEX 731
XSLT (Extensible Stylesheet
Language Transformations)
about 421
and client-side
transformations 423, 444
and server-side
transformations 421
creating conditional regions
with 437
dynamic links 435
fragments 421, 434, 435
page, linking to XML files 446
pages 421, 423, 429, 430, 435
Repeat Region XSLT object 425,
432, 433
using with dynamic pages 422
Z
Z-Index option (for AP elements)
changing stacking order 158
style definition 133
Zoom tool 223
September 4, 2007