| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 1 | <?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"> |
| 2 | <html lang="en-us" xml:lang="en-us"> |
| syeshin | befd53e | 2005-07-27 18:16:40 +0000 | [diff] [blame] | 3 | <head> |
| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 4 | <meta content="text/html; charset=utf-8" http-equiv="Content-Type" /> |
| kprice | 888ac55 | 2010-05-11 21:19:48 +0000 | [diff] [blame] | 5 | <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" /> |
| 6 | <meta name="DC.rights.owner" content="(C) Copyright 2000, 2009" /> |
| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 7 | <meta content="public" name="security" /> |
| 8 | <meta content="index,follow" name="Robots" /> |
| 9 | <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))' /> |
| 10 | <meta content="task" name="DC.Type" /> |
| 11 | <meta name="DC.Title" content="Using XML content assist" /> |
| 12 | <meta name="abstract" content="You can use content assist to help you finish a tag or line of code in the Source view of the XML editor. You can also use content assist to insert templates into your XML code." /> |
| 13 | <meta name="description" content="You can use content assist to help you finish a tag or line of code in the Source view of the XML editor. You can also use content assist to insert templates into your XML code." /> |
| kprice | b59c9f6 | 2008-04-02 21:24:37 +0000 | [diff] [blame] | 14 | <meta content="XML editor, content assist, XML files" name="DC.subject" /> |
| 15 | <meta content="XML editor, content assist, XML files" name="keywords" /> |
| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 16 | <meta scheme="URI" name="DC.Relation" content="../topics/txedtsrc.html" /> |
| 17 | <meta scheme="URI" name="DC.Relation" content="../topics/twmacro.html" /> |
| 18 | <meta scheme="URI" name="DC.Relation" content="../topics/tsugstrat.html" /> |
| 19 | <meta content="XHTML" name="DC.Format" /> |
| 20 | <meta content="twcdast" name="DC.Identifier" /> |
| 21 | <meta content="en-us" name="DC.Language" /> |
| 22 | <link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" /> |
| syeshin | befd53e | 2005-07-27 18:16:40 +0000 | [diff] [blame] | 23 | <title>Using XML content assist</title> |
| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 24 | </head> |
| syeshin | befd53e | 2005-07-27 18:16:40 +0000 | [diff] [blame] | 25 | <body id="twcdast"><a name="twcdast"><!-- --></a> |
| 26 | |
| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 27 | |
| syeshin | befd53e | 2005-07-27 18:16:40 +0000 | [diff] [blame] | 28 | <h1 class="topictitle1">Using XML content assist</h1> |
| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 29 | |
| 30 | |
| 31 | |
| 32 | |
| kprice | 888ac55 | 2010-05-11 21:19:48 +0000 | [diff] [blame] | 33 | <div><p>You can use content assist to help you finish a tag or |
| 34 | line of code in the Source view of the XML editor. You can also use |
| 35 | content assist to insert templates into your XML code.</p> |
| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 36 | |
| kprice | 888ac55 | 2010-05-11 21:19:48 +0000 | [diff] [blame] | 37 | <div class="section"><p>The placement of the cursor in your source file provides |
| 38 | the context for the content assist to offer suggestions for completion.</p> |
| 39 | <p>You |
| 40 | can launch content assist in either of the following ways:</p> |
| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 41 | <ul> |
| kprice | 888ac55 | 2010-05-11 21:19:48 +0000 | [diff] [blame] | 42 | <li>From the <span class="uicontrol">Edit</span> menu, click <span class="uicontrol">Content |
| 43 | Assist</span>, or</li> |
| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 44 | |
| 45 | <li>Press Ctrl+Space</li> |
| 46 | |
| syeshin | befd53e | 2005-07-27 18:16:40 +0000 | [diff] [blame] | 47 | </ul> |
| kprice | 888ac55 | 2010-05-11 21:19:48 +0000 | [diff] [blame] | 48 | <p>In addition, you can set up an option that causes content |
| 49 | assist to pop up automatically when certain characters are typed. |
| 50 | To set up this option, click <span class="menucascade"><span class="uicontrol">Window</span> |
| 51 | > <span class="uicontrol"> Preferences</span></span> to open the Preferences |
| 52 | window, then select <span class="menucascade"><span class="uicontrol">XML</span> > <span class="uicontrol">XML |
| 53 | Files </span> > <span class="uicontrol">Editor</span> > <span class="uicontrol">Content |
| 54 | assist</span></span> . Select the <span class="uicontrol">Automatically |
| 55 | make suggestions</span> check box, and supply any additional |
| 56 | characters that should trigger content assist.</p> |
| 57 | <p>If your cursor |
| 58 | is in a position where content assist is available, a pop-up list |
| 59 | of available choices is displayed when you launch content assist. |
| 60 | The list is based on the context and whether a DTD or XML schema is |
| 61 | associated with the XML file being edited. For example, if you have |
| 62 | an Address element that can contain any of the following children |
| 63 | elements: Name, Street, City, Zip Code, Country, and Province, and |
| 64 | you place your cursor after any of them and launch content assist, |
| 65 | all of the child elements will be listed in the content assist list.</p> |
| 66 | <p>Content |
| 67 | assist cycling is available in the XML editor, offering multiple pages |
| 68 | of content assist. You can set preferences for the proposal categories |
| 69 | and the cycle order when repeatedly invoking content assist </p> |
| 70 | <p>The content assist list displays all valid tags for the |
| 71 | current cursor position, including templates. If your grammar constraints |
| 72 | are turned off, all available tags, not just valid ones, are displayed. </p> |
| 73 | <p>As |
| 74 | you type the first one or two letters of the tag that you want, the |
| 75 | list automatically refreshes with alphabetized choices that match |
| 76 | your input. Scroll down and select the tag that you want to use by |
| 77 | double-clicking on it.</p> |
| 78 | <div class="note"><span class="notetitle">Note:</span> The list only refreshes as described |
| 79 | if you first type <kbd class="userinput"><</kbd> before prompting for |
| kprice | b59c9f6 | 2008-04-02 21:24:37 +0000 | [diff] [blame] | 80 | content assist.</div> |
| syeshin | befd53e | 2005-07-27 18:16:40 +0000 | [diff] [blame] | 81 | </div> |
| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 82 | |
| syeshin | befd53e | 2005-07-27 18:16:40 +0000 | [diff] [blame] | 83 | </div> |
| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 84 | |
| syeshin | d0bdb8e | 2005-10-27 17:44:14 +0000 | [diff] [blame] | 85 | <div><div class="reltasks"><strong>Related tasks</strong><br /> |
| 86 | <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> |
| kprice | b59c9f6 | 2008-04-02 21:24:37 +0000 | [diff] [blame] | 87 | <div><a href="../topics/twmacro.html" title="XML content assist provides a comment template, a section of predefined code that you can insert into a file. You may find a template useful when you have a certain piece of code you want to reuse several times, and you do not want to write it out every time.">Working with XML templates</a></div> |
| 88 | <div><a href="../topics/tsugstrat.html" title="You can customize the formatting of the suggestions given by content assist by choosing a suggestion strategy preference. When the suggestion strategy is set to Strict, suggestions that are grammatically valid will be displayed first in the list of options and highlighted by bold icons. Other suggestions that are applicable to this element's scope but are not grammatically valid will be displayed lower in the list with de-emphasized icons. When the suggestion strategy is set to Lax, all suggestions will displayed in the list with de-emphasized icons.">Setting the XML source suggestion strategy used by content assist</a></div> |
| syeshin | d0bdb8e | 2005-10-27 17:44:14 +0000 | [diff] [blame] | 89 | </div> |
| kprice | ef16068 | 2006-08-29 18:08:31 +0000 | [diff] [blame] | 90 | </div> |
| 91 | |
| 92 | </body> |
| syeshin | befd53e | 2005-07-27 18:16:40 +0000 | [diff] [blame] | 93 | </html> |