內容輔助

內容輔助可協助您在結構化文字編輯器中插入或完成標示或函數, 或完成一行程式碼。游標在程式檔中的位置會提供環境定義,供內容輔助提出完成的建議。

大部分結構化文字編輯器都有內容輔助。如果需要具備內容輔助的編輯器清單, 請參閱用於標記語言的結構化文字編輯器。如需如何取得內容輔助的相關資訊, 請參閱在結構化文字編輯器中取得內容輔助

下列各節說明 HTML 內容輔助、JavaScript™ 內容輔助和 JSP 內容輔助的專屬功能。

HTML 內容輔助

HTML 很有彈性,某些 HTML 元素允許選擇性地省略結束標示,如:PDTDDLITHEADTRTDTH 等等。其他定義成沒有內容的 HTML 元素可能需要一律省略結束標示, 如:BRHRLINKMETAIMG。這種彈性使得 HTML 程式碼頁面編輯器內的內容輔助功能與較嚴格限制的標記語言相比,會比較不精確。

當您需要完成標示名稱、在起始標示內新增屬性名稱/值配對,或是從屬性值的列舉清單中選取時, HTML 內容輔助會很有幫助。

雖然內容輔助只顯示尚未指定在起始標示中的屬性名稱, 但它不會考量標示的文法限制。 比方說,HTML中的 HEAD 元素只允許在其內容中出現零或一次 TITLE 標示。如果您在已包含 TITLE 標示的 HEAD 內容內要求內容輔助,內容輔助仍會在其提議清單中顯示 TITLE

不過,如果根據 DTD/綱目需要某個屬性, 該屬性會顯示在清單的最上方,並於其圖示顯示一個黃色的圓形指標。

如果游標位於可使用內容輔助的位置,就會顯示可用選項的蹦現式清單。 該清單是以環境定義為基礎。比方說,如果您在開啟段落標示 (<p>) 後立即使用內容輔助, 內容輔助清單中的第一個項目會是對應的結束段落 (</p>) 標示。

內容輔助清單會顯示現行游標位置所有可用的標示,包括範本。下圖顯示段落標示範例的預設內容輔助清單:

HTML 內容輔助

標示提議會按字母順序列出。如果您先輸入 <(開始新的標示)再要求內容輔助, 然後開始輸入您要加入之標示的第一或第二個字母, 則提議清單會自動更新,以反映符合您輸入之型樣的提議。如果您未輸入 < 就要求內容輔助, 您可以在提議清單內按一下,然後輸入標示開頭的字母, 來減少(部分)捲動以找到所需標示的程度。

當您輸入您要加入標示之屬性名稱或列舉屬性值的第一或第二個字母時, 清單會自動更新,以反映符合您輸入之型樣的提議。

限制: Linux。 當您使用 Linux(Motif 或 GTK)和 DBCS 語言環境時,按兩下內容輔助清單有時候會導致 Java™ VM 終止。請不要按兩下清單,改用箭頭和 Enter 鍵從清單中選擇。

JavaScript 內容輔助

JavaScript 內容輔助清單中的項目前會有 Internet Explorer 圖示、Netscape 圖示(或兩者皆有),指出特定的 JavaScript 物件、方法或函數是否受其中一或兩個瀏覽器所支援。如果呈現 Internet Explorer 圖示, 表示該物件、方法或函數受 Internet Explorer 5.0 版或更新的版本所支援。如果呈現 Netscape 圖示, 表示該物件、方法或函數受 Netscape Navigator 4.7 或更新的版本所支援。如果顯示問號圖示 (「問號」圖示) 而非其中一個瀏覽器圖示,表示不知道瀏覽器是否支援該物件、方法或函數。

下圖顯示 JavaScript 檔內的預設內容輔助清單:

JavaScript 內容輔助

程式碼提議會按字母順序列出。如果您先輸入 . (包括空格)再要求內容輔助,然後開始輸入您要加入之程式碼的第一或第二個字母, 則提議清單會自動更新來反映符合您輸入之型樣的提議, 以減少(部分)捲動以找到所需程式碼的程度。

JSP 內容輔助

您有許多方式來利用內容輔助在 JSP 頁面中嵌入 Java 和 HTML 程式碼。

所有 JSP 標示都包含在範本清單中,並以 XML格式呈現(例如:<jsp:expression>)。 比方說,如果要新增 JSP Scriptlet 標示,請將游標移至檔案中適當的位置, 然後按 Alt + / 來使用內容輔助。從提議清單中選取 JSP Scriptlet 內容輔助,將 <% %> 插入文件中。

Scriptlet 會插入 <% %> 標示中。 例如:
<% System.currentTimeMillis() %>

本例會評估 Java 陳述式,以取得目前的時間(以毫秒為單位)。

如果要將陳述式的結果插入檔案中,請在陳述式前面放一個等號 (=)。例如:
<b>This is the time : <%= System.currentTimeMillis()%></b>
當位於 Scriptlet 內時,您會撰寫純 Java 程式碼。 因此,內容輔助的運作會和 Java 編輯器中的內容輔助完全一樣。 比方說,如果您在 System 之後要求內容輔助, 內容輔助會顯示方法的清單。
註: Java 內容輔助只能在 Web 專案中運作,因為其需要建置路徑來尋找適當的 Java 類別。
其中也有一些特殊的標示,如:useBean。例如:
<jsp:useBean id="useBean" class="java.lang.String"/>

useBean 標示可讓您建立一個名稱為 aString 且類型為 String 的 Bean。接著當您使用內容輔助時,這會被視為已宣告的變數。比方說,如果您在 aString 之後使用內容輔助,如下所示:

<% aString. %> 
內容輔助清單會顯示可用的方法。這是因為 aString 已宣告成類型為 String 的 Bean。
如果您在 a 之後使用內容輔助,如下所示:
<% a %> 
內容輔助知道 aString 已存在,且會將它顯示在內容輔助清單中。
相關概念
標記語言用的結構化文字編輯器
相關工作
在結構化的文字編輯器取得內容輔助
新增和移除 HTML 範本