內容輔助

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

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

以下各節說明 HTML 內容輔助、JavaScript™ 內容輔助和 JSP 內容輔助的特性。

HTML 內容輔助

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>)。

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

標籤提案按字母順序列出。如果您在提示內容輔助之前輸入 <(開始新的標籤),然後開始輸入要新增之標籤的前一兩個字母,則提案清單會自動重新整理,以反映符合您所輸入之型樣的提案。 如果您在提示內容輔助之前沒有輸入 <,您可以在提案清單內按一下,然後輸入標籤的起始字母,以(稍微)減少尋找所要標籤的捲動量。

當您輸入要加到標籤中的屬性名稱或列舉屬性值的前一兩個字母時,清單會自動重新整理,以反映符合您所輸入之型樣的提案。

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

JSP 內容輔助

當使用內容輔助時,有許多選項可供您將 Java 和 HTML 程式碼內嵌在 JSP 頁面中。

所有 JSP 標籤同時包含在範本清單和 XML 格式中(例如 <jsp:expression>)。舉例來說,如果要新增 JSP Scriptlet 標籤,請將游標移至檔案中的適當位置,然後按 Ctrl+空白鍵,來使用內容輔助。從提案清單中選取 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 標籤可讓您建立 String 類型、稱為 aString 的 Bean。之後,當您使用內容輔助時,會將此項識別為宣告變數。比方說,如果您依照下列方式,在 aString 後面使用內容輔助:

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