内容辅助帮助您在结构化文本编辑器中插入或完成标记、函数或代码行。光标在源文件中的位置提供内容辅助的上下文来为完成提供建议。
大多数结构化文本编辑器具有内容辅助。要获取具有内容辅助的编辑器的列表,请参阅标记语言的结构化文本编辑器。有关如何获取内容辅助的信息,请参阅在结构化文本编辑器中获取内容辅助。
下面的各节描述了 HTML 内容辅助、JavaScript™ 内容辅助和 JSP 内容辅助的特点。
HTML 十分灵活,它可以选择省略某些 HTML 元素结束标记,例如 P、DT、DD、LI、THEAD、TR、TD 和 TH 等等。定义为没有内容的其他 HTML 元素可能要求始终省略结束标记,例如,BR、HR、LINK、META 和 IMG。这种灵活性使 HTML 源代码页编辑器中的内容辅助功能与约束性更严格的标记语言的内容辅助功能相比没那么精确。
当需要完成标记名、在开始标记中添加属性“名称 - 值”对或从属性值的枚举列表中进行选择时,HTML 内容辅助的用处最大。
尽管内容辅助只显示开始标记中尚未指定的属性名,但它不考虑标记的语法约束。例如,HTML 中的 HEAD 元素只允许在它的内容中包含零个或一个 TITLE 标记。即使在已包含 TITLE 标记的 HEAD 内容中请求内容辅助,内容辅助在它的建议列表中仍然显示 TITLE。
但是,如果按照“DTD/模式”必须要有属性,则该属性将出现在列表的顶部,它的图标上带有黄色圆形指示符。
如果光标处于内容辅助可用的位置,则会显示可用选项的弹出列表。该列表是基于上下文的。例如,如果在开始段标记(<p>)后直接使用内容辅助,则内容辅助列表中的第一项将是对应的结束段标记(</p>)。
内容辅助列表显示当前光标位置处可用的所有标记,包括模板。下图显示段标记的缺省内容辅助列表示例:
按字母顺序列示标记建议。如果输入 <(以开始新标记),然后请求内容辅助并开始输入要添加的标记的前一两个字母,则建议列表将自动刷新,以反映与您输入的模式相匹配的建议。如果不输入 < 而直接请求内容辅助,则可在建议列表内单击,然后输入标记的首字母,从而在一定程度上减少查找所期望的标记需要进行的滚动。
当输入要添加至标记的属性名或枚举属性值的前一两个字母时,列表将自动刷新,以反映与已输入的模式相匹配的建议。
JavaScript 内容辅助列表中各个项的前面都有一个
Internet Explorer 图标和/或一个 Netscape 图标以指示是一个浏览器还是两个浏览器都支持特定 JavaScript 对象、方法或函数。如果显示 Internet Explorer 图标,则它指示
Internet Explorer V5.0 或更高版本支持对象、方法或函数。如果显示
Netscape 图标,则它指示 Netscape Navigator V4.7 或更高版本支持对象、方法或函数。位于其中一个浏览器图标处的“问号”图标 指示不知道该浏览器是否支持对象、方法或函数。
下图显示了 JavaScript 文件中的缺省内容辅助列表:
代码建议按字母顺序来列示。如果在请求内容辅助之前输入“. ”(包括空格)并开始输入需要添加的代码的前一两个字母,则建议列表将自动刷新以反映与已输入的模式匹配的建议,从而在一定程度上减少查找期望的代码需要进行的滚动。
使用内容辅助来在 JSP 页中嵌入 Java 和 HTML 代码的方法有多种。
所有 JSP 标记都同时包括在模板列表和 XML 格式中(例如,<jsp:expression>)。例如,要添加
JSP scriptlet 标记,将光标移至文件中适当的位置并按 Alt+/ 以使用内容辅助。从建议列表中选择 以在文档中插入 <% %>。
<% System.currentTimeMillis() %>
此示例将对 Java 语句进行求值以获取当前时间(以毫秒计)。
<b>This is the time : <%= System.currentTimeMillis()%></b>
<jsp:useBean id="useBean" class="java.lang.String"/>
useBean 标记使您能创建类型为 String 且名称为 aString 的 bean。因此,当使用内容辅助时,会将它识别为已声明的变量。例如,如果在 aString 后使用内容辅助,如下所示:
<% aString. %>则内容辅助列表会显示可用的方法。这是因为 aString 已声明为类型为 String 的 bean。
<% a %>则内容辅助知道存在 aString 并且将它显示在内容辅助列表中。