blob: ace05b231486115c6c4ca5ffeea87fc3d29a5b25 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<meta name="copyright" content="Copyright (c) 2000, 2006 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: IBM Corporation - initial API and implementation" />
<meta name="DC.rights.owner" content="(C) Copyright 2000, 2006" />
<meta content="public" name="security" />
<meta content="index,follow" name="Robots" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta content="task" name="DC.Type" />
<meta name="DC.Title" content="Editing in the Design view" />
<meta name="abstract" content="The XML editor has a Design view, which represents the XML file simultaneously as a table and a tree. This helps make navigation and editing easier. Content and attribute values can be edited directly in the table cells, while pop-up menus on the tree elements give alternatives that are valid for that particular element." />
<meta name="description" content="The XML editor has a Design view, which represents the XML file simultaneously as a table and a tree. This helps make navigation and editing easier. Content and attribute values can be edited directly in the table cells, while pop-up menus on the tree elements give alternatives that are valid for that particular element." />
<meta content="XML editor, editing, in the Design view" name="DC.subject" />
<meta content="XML editor, editing, in the Design view" name="keywords" />
<meta scheme="URI" name="DC.Relation" content="../topics/cwxmledt.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/txedtsrc.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/cxmlcat.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/tedtdoc.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/tedtsch.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/tedtproc.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/rxmlbicons.html" />
<meta content="XHTML" name="DC.Format" />
<meta content="txedtdes" name="DC.Identifier" />
<meta content="en-us" name="DC.Language" />
<link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
<title>Editing in the Design view</title>
</head>
<body id="txedtdes"><a name="txedtdes"><!-- --></a>
<h1 class="topictitle1">Editing in the Design view</h1>
<div><p>The XML editor has a Design view, which represents the XML file
simultaneously as a table and a tree. This helps make navigation and editing
easier. Content and attribute values can be edited directly in the table cells,
while pop-up menus on the tree elements give alternatives that are valid for
that particular element.</p>
<div class="section"><p> For example, the <span class="uicontrol">Add child</span> menu item will
list only those elements from a DTD or XML schema which would be valid children
at that point.</p>
<p>When you have an XML file associated with an XML schema
or DTD file, certain tags and rules for that file have already been established,
which is why the Design view can provide prompts (via a pop-up menu) for those
tags. When you create an XML file that is not associated with an XML schema
or DTD file, it has no tags or rules associated with it, so the Design view
cannot provide prompts for specific tags, but it can provide prompts to create
new elements and attributes.</p>
<p>For any XML file associated with an XML
schema or DTD file, you can use the Design view to add any items defined in
the XML schema or DTD (such as elements and attributes) to the XML file. You
can also use it to add processing instructions and comments to all XML files.</p>
<p>For
more information on the icons used in the Design view, refer to the related
reference.</p>
<p>The following instructions were written for the Resource
perspective, but they will also work in many other perspectives.</p>
<p>To
edit an XML file in the Design view, follow these steps:</p>
</div>
<ol>
<li class="stepexpand"><span>Open the XML file that you want to work with in the XML editor
(right-click the file in the Navigator view and click <span class="uicontrol">Open With
&gt; XML Editor</span>). If necessary, click the <span class="uicontrol">Design</span> tab.</span>
</li>
<li class="stepexpand"><span>To expand all the items in your XML file, click the <span class="uicontrol">Expand
All</span> toolbar button <img src="../images/expand_all.gif" alt="This&#10;graphic is the Expand All toolbar button" />.</span></li>
<li class="stepexpand"><span>To collapse them, click the <span class="uicontrol">Collapse All</span> toolbar
button <img src="../images/collapse_all.gif" alt="This graphic is the&#10;Collapse All toolbar button" />.</span></li>
<li class="stepexpand"><span>Right-click the item that you want to work with.</span> Some
or all of the following options (as applicable) will be available from the
pop-up menu that appears:<ul>
<li> <span class="uicontrol">Add DTD Information</span> - Click this if you want to
associate the XML file with a DTD.</li>
<li> <span class="uicontrol">Edit DOCTYPE</span> - Click this if you want to edit
the DOCTYPE declaration. Refer to the related task for more details.</li>
<li> <span class="uicontrol">Edit Namespaces</span> - Click this if you want to edit
the existing namespace information or create a new association with a namespace.
Refer to the related task for more details.</li>
<li> <span class="uicontrol">Edit Processing Instruction</span> - Click this if you
want to edit the processing instruction. Refer to the related task for more
details.</li>
<li> <span class="uicontrol">Remove</span> - Click this if you want to remove the
item that you have selected from the XML file. This option will not be available
if the item you want to remove must exist (for example, in your DTD, you have
declared that "One or more" of the item must always exist in your XML file,
and the item you have selected is the only one that exists in your XML file).</li>
<li> <span class="uicontrol">Add Attribute</span> - Click this if you want to add
an attribute to the element that you selected. Any attributes you are allowed
to add to the element will be listed. After you have added the attribute to
the XML file, you can click in the right-hand column to change the value of
the attribute. If the attribute has set values, they will appear in a list.</li>
<li> <span class="uicontrol">Add Child</span> - Click this to add another element,
a comment, or a processing instruction as a child of the parent element.</li>
<li> <span class="uicontrol">Add Before</span> - Click this to add a child element,
comment, or processing instruction that can go before the item you have selected.
For example, if you have a parent element called "CD Collections" that can
contain an unlimited amount of children called "CD", you could click a CD
element and click <span class="menucascade"><span class="uicontrol">Add Before</span> &gt; <span class="uicontrol"> CD</span>
</span> , as a CD element can go before another CD element.</li>
<li> <span class="uicontrol">Add After</span> - Click this to add a child element,
comment, or processing instruction that can go after the item you have selected.
For example, if you have a parent element called "CD Collections" that can
contain an unlimited amount of children called "CD", you could click a CD
element and click <span class="menucascade"><span class="uicontrol">Add After</span> &gt; <span class="uicontrol"> CD</span>
</span>, as a CD element can go after another CD element.</li>
<li> <span class="uicontrol">Replace With</span> - Click this if you want to replace
one item with another. This option is not available if you turn grammar constraints
off or if there are no valid alternatives for you to replace the item with.</li>
</ul>
</li>
<li class="stepexpand"><span>Click the appropriate option.</span></li>
</ol>
<div class="section"><p>Any changes you make in the Design view are also reflected in the
Source view and the Outline view.</p>
</div>
</div>
<div><div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="../topics/cwxmledt.html" title="The XML editor is a tool for creating and viewing XML files.">XML editor</a></div>
<div><a href="../topics/cxmlcat.html" title="When an XML file is associated with a DTD or XML schema, it is bound by any structural rules contained in the DTD or XML schema. To be considered a valid XML file, a document must be accompanied by a DTD or an XML schema, and conform to all of the declarations in the DTD or the XML schema.">XML file associations with DTDs and XML schemas</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="../topics/txedtsrc.html" title="You can use the Source view to view and work with a file's source code directly.">Editing in the Source view</a></div>
<div><a href="../topics/tedtdoc.html" title="The DOCTYPE declaration in an XML file is used at the beginning of it to associate it with a DTD file. You can edit your DOCTYPE declaration to change the DTD file your XML file is associated with.">Editing DOCTYPE declarations</a></div>
<div><a href="../topics/tedtsch.html" title="Your namespace information is used to provide various information about the XML file, such as the XML schema and namespace it is associated with. If desired, you can change the schema and namespace your XML file is associated with or add a new association. Modifying any associations can impact what content is allowed in the XML file.">Editing namespace information</a></div>
<div><a href="../topics/tedtproc.html" title="If you have instructions you want to pass along to an application using an XML document, you can use a processing instruction.">Editing XML processing instructions</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="../topics/rxmlbicons.html" title="The following XML editor icons appear in the Outline and Design view.">Icons used in the XML editor</a></div>
</div>
</div>
</body>
</html>