docs/org.eclipse.wst.xsdeditor.doc.user/topics/taddelm.html - sourceediting/webtools.sourceediting - Git at Google

 <?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, 2009 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, 2009" />
 <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="Adding elements" />
 <meta name="abstract" content="Elements are fundamental building blocks in XML. Element declarations provide value constraints, provide a description that can be used for validation, establish constraining relationships between related elements and attributes, and control the substitution of elements." />
 <meta name="description" content="Elements are fundamental building blocks in XML. Element declarations provide value constraints, provide a description that can be used for validation, establish constraining relationships between related elements and attributes, and control the substitution of elements." />
 <meta content="XML schema editor, elements, XML schema files" name="DC.subject" />
 <meta content="XML schema editor, elements, XML schema files" name="keywords" />
 <meta scheme="URI" name="DC.Relation" content="../topics/taddcmod.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/taddelmr.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/taddanye.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/taddglba.html" />
 <meta content="XHTML" name="DC.Format" />
 <meta content="taddelm" 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>Adding elements</title>
 </head>
 <body id="taddelm"><a name="taddelm"><!-- --></a>


 <h1 class="topictitle1">Adding elements</h1>


 <div><p>Elements are fundamental building blocks in XML. Element
 declarations provide value constraints, provide a description that
 can be used for validation, establish constraining relationships between
 related elements and attributes, and control the substitution of elements.</p>

 <div class="section"><p>The following instructions were written for the Resource
 perspective, but they will also work in many other perspectives.</p>
 <p>To
 add an element, complete the following steps:</p>
 </div>

 <ol>
 <li class="stepexpand"><span>To add an element, in the Design view, right-click the
 content model (sequence, choice, or all element) you want to work
 with and click <span class="uicontrol">Add Element</span>.</span> The
 element appears attached to the content model in the Design view.
 <ol type="a">
 <li class="substepexpand"><span>In the Design view, select the element, and click the
 current (default) name of the element, which puts you in direct editing
 mode, then type the new <span class="uicontrol">Name</span> and press enter.</span>
 </li>

 <li class="substepexpand"><span>In the Design view, click the current (default) element
 type and select a type from the menu. Alternately, you can select
 browse to invoke the Set Type dialog for more options.</span> The
 Set Type dialog lists all built-in and user-defined types currently
 available. You can change the <span class="uicontrol">Scope</span> of the
 list by selecting one of the following options:<ul>
 <li><span class="uicontrol">Workspace</span>: lists all of the types available
 in your workspace.</li>

 <li><span class="uicontrol">Enclosing Project</span>: lists all of the types
 available in the project that contains your file.</li>

 <li>(Default) <span class="uicontrol">Current Resource</span>: list all of
 the types available in your current file.</li>

 <li><span class="uicontrol">Working Sets</span>: list all the types available
 within the selected working set.</li>

 </ul>
 </li>

 </ol>

 </li>

 <li class="stepexpand"><span>(Optional) In the Properties view, select the appropriate
 value in the <span class="uicontrol">Minimum Occurrence</span> field. </span>
  This is the number of times the element can appear in an instance
 document. If you want the element to be optional, select <span class="uicontrol">0</span>.
 Otherwise, select <span class="uicontrol">1</span>. </li>

 <li class="stepexpand"><span>(Optional) Select the appropriate value in the <span class="uicontrol">Maximum
 Occurrence</span> field. </span> This is the maximum number
 of times the element can appear in an instance document. Select <span class="uicontrol">unbounded</span> to
 indicate there is no maximum number of occurrences.</li>

 <li class="stepexpand"><span>Click the <span class="uicontrol">Documentation</span> tab if you
 want to provide any information about this element. </span> The <span class="uicontrol">Documentation</span> page
 is used for human readable material, such as a description.
 </li>

 <li class="stepexpand"><span>Click the <span class="uicontrol">Extensions</span> tab if you
 want to add application information elements to your annotations of
 schema components. </span> The <span class="uicontrol">Extensions</span> page
 allows you to specify the schema and add XML content to your annotations.
 </li>

 </ol>

 <div class="section">You can add a content model to an element, which is the representation
 of any data that can be contained inside the element. For more information
 about working with content models, refer to the related tasks.</div>

 </div>

 <div><div class="reltasks"><strong>Related tasks</strong><br />
 <div><a href="../topics/taddcmod.html" title="A content model is the representation of any data that can be contained inside an element, global element, complex type, or group. It is a formal description of the structure and permissible content of an element, global element, complex type, or group, which may be used to validate a document instance.">Adding content models</a></div>
 <div><a href="../topics/taddelmr.html" title="An element reference provides a reference to a global element. A declaration that references a global element enables the referenced global element to appear in the instance document in the context of the referencing declaration.">Adding element references</a></div>
 <div><a href="../topics/taddanye.html" title="You can use the any element in a similar way as a DTD's ANY content model, however, it must be done in conjunction with namespaces. This enables you to include any well-formed XML content, such as an HTML Web page that conforms to XHTML 1.0 syntax.">Adding an any element</a></div>
 <div><a href="../topics/taddglba.html" title="A global attribute is an attribute that can be recognized anywhere in a document. Once declared, a global attribute can be referenced in one or more declarations using an attribute reference.">Adding global attributes</a></div>
 </div>
 </div>

 </body>
 </html>
	<?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, 2009 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, 2009" />
	<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="Adding elements" />
	<meta name="abstract" content="Elements are fundamental building blocks in XML. Element declarations provide value constraints, provide a description that can be used for validation, establish constraining relationships between related elements and attributes, and control the substitution of elements." />
	<meta name="description" content="Elements are fundamental building blocks in XML. Element declarations provide value constraints, provide a description that can be used for validation, establish constraining relationships between related elements and attributes, and control the substitution of elements." />
	<meta content="XML schema editor, elements, XML schema files" name="DC.subject" />
	<meta content="XML schema editor, elements, XML schema files" name="keywords" />
	<meta scheme="URI" name="DC.Relation" content="../topics/taddcmod.html" />
	<meta scheme="URI" name="DC.Relation" content="../topics/taddelmr.html" />
	<meta scheme="URI" name="DC.Relation" content="../topics/taddanye.html" />
	<meta scheme="URI" name="DC.Relation" content="../topics/taddglba.html" />
	<meta content="XHTML" name="DC.Format" />
	<meta content="taddelm" 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>Adding elements</title>
	</head>
	<body id="taddelm"><a name="taddelm"><!-- --></a>


	<h1 class="topictitle1">Adding elements</h1>




	<div><p>Elements are fundamental building blocks in XML. Element
	declarations provide value constraints, provide a description that
	can be used for validation, establish constraining relationships between
	related elements and attributes, and control the substitution of elements.</p>

	<div class="section"><p>The following instructions were written for the Resource
	perspective, but they will also work in many other perspectives.</p>
	<p>To
	add an element, complete the following steps:</p>
	</div>

	<ol>
	<li class="stepexpand"><span>To add an element, in the Design view, right-click the
	content model (sequence, choice, or all element) you want to work
	with and click <span class="uicontrol">Add Element</span>.</span> The
	element appears attached to the content model in the Design view.
	<ol type="a">
	<li class="substepexpand"><span>In the Design view, select the element, and click the
	current (default) name of the element, which puts you in direct editing
	mode, then type the new <span class="uicontrol">Name</span> and press enter.</span>
	</li>

	<li class="substepexpand"><span>In the Design view, click the current (default) element
	type and select a type from the menu. Alternately, you can select
	browse to invoke the Set Type dialog for more options.</span> The
	Set Type dialog lists all built-in and user-defined types currently
	available. You can change the <span class="uicontrol">Scope</span> of the
	list by selecting one of the following options:<ul>
	<li><span class="uicontrol">Workspace</span>: lists all of the types available
	in your workspace.</li>

	<li><span class="uicontrol">Enclosing Project</span>: lists all of the types
	available in the project that contains your file.</li>

	<li>(Default) <span class="uicontrol">Current Resource</span>: list all of
	the types available in your current file.</li>

	<li><span class="uicontrol">Working Sets</span>: list all the types available
	within the selected working set.</li>

	</ul>
	</li>

	</ol>

	</li>

	<li class="stepexpand"><span>(Optional) In the Properties view, select the appropriate
	value in the <span class="uicontrol">Minimum Occurrence</span> field. </span>
	This is the number of times the element can appear in an instance
	document. If you want the element to be optional, select <span class="uicontrol">0</span>.
	Otherwise, select <span class="uicontrol">1</span>. </li>

	<li class="stepexpand"><span>(Optional) Select the appropriate value in the <span class="uicontrol">Maximum
	Occurrence</span> field. </span> This is the maximum number
	of times the element can appear in an instance document. Select <span class="uicontrol">unbounded</span> to
	indicate there is no maximum number of occurrences.</li>

	<li class="stepexpand"><span>Click the <span class="uicontrol">Documentation</span> tab if you
	want to provide any information about this element. </span> The <span class="uicontrol">Documentation</span> page
	is used for human readable material, such as a description.
	</li>

	<li class="stepexpand"><span>Click the <span class="uicontrol">Extensions</span> tab if you
	want to add application information elements to your annotations of
	schema components. </span> The <span class="uicontrol">Extensions</span> page
	allows you to specify the schema and add XML content to your annotations.
	</li>

	</ol>

	<div class="section">You can add a content model to an element, which is the representation
	of any data that can be contained inside the element. For more information
	about working with content models, refer to the related tasks.</div>

	</div>

	<div><div class="reltasks"><strong>Related tasks</strong><br />
	<div><a href="../topics/taddcmod.html" title="A content model is the representation of any data that can be contained inside an element, global element, complex type, or group. It is a formal description of the structure and permissible content of an element, global element, complex type, or group, which may be used to validate a document instance.">Adding content models</a></div>
	<div><a href="../topics/taddelmr.html" title="An element reference provides a reference to a global element. A declaration that references a global element enables the referenced global element to appear in the instance document in the context of the referencing declaration.">Adding element references</a></div>
	<div><a href="../topics/taddanye.html" title="You can use the any element in a similar way as a DTD's ANY content model, however, it must be done in conjunction with namespaces. This enables you to include any well-formed XML content, such as an HTML Web page that conforms to XHTML 1.0 syntax.">Adding an any element</a></div>
	<div><a href="../topics/taddglba.html" title="A global attribute is an attribute that can be recognized anywhere in a document. Once declared, a global attribute can be referenced in one or more declarations using an attribute reference.">Adding global attributes</a></div>
	</div>
	</div>

	</body>
	</html>