## **AutoParagraph** 該指令打開自動分段功能，在這種情況下，盡可能將雙換行符轉換為段落。自動分段： * 始終應用于根節點中的**內聯元素或文本**， * 適用于內聯元素或帶有雙換行符的文本（在允許段落標記的節點中）， * 適用于段落標記中的雙換行符 `p`必須被允許標記，此指令才能生效。我們不會`br`在段落中使用標簽，因為這在語義上是不正確的。 為防止自動段落作為內容的產生者，請避免使用雙換行符，除非指定新段落或在具有特殊含義的上下文中使用（空白空間通常沒有含義，除了諸如`pre`這樣的標記之外，因此不應該很困難）。為防止在塊元素附近插入內聯文本，將它們包裹在`div`標簽中（行為在根節點之外略有不同）。 ``` $config->set('HTML.Allowed','p'); $config->set('AutoFormat.AutoParagraph',true); ``` ## **Custom** 此偽指令可用于添加自定義自動格式化注入器。指定一個注射器名稱數組（類名稱減去前綴）或具體實現。注射器類必須存在。本例用系統的注入器類代替自定義的 ``` $config->set('AutoFormat.Custom',['AutoParagraph']); ``` ## **DisplayLinkURI** 此偽指令打開標記中URI的文本顯示，并禁用這些鏈接。 ``` //顯示a連接的地址 <a href="www.baidu.com">百度一下會死</a> 變為 <a>百度一下會死</a> (www.baidu.com) $config->set('AutoFormat.DisplayLinkURI', true); ``` ## **Linkify** 該指令打開鏈接化，自動鏈接http，ftp和https URL。`a`具有`href`屬性的標簽必須允許。 將http、https和ftp文本url轉換為實際鏈接 ``` // <p>http://www.baidu.com</p> 轉為 <p><a href="http://www.baidu.com">http://www.baidu.com</a></p> $config->set('AutoFormat.Linkify', true); ``` ## **PurifierLinkify.DocURL** 要鏈接到的配置文檔的位置，讓％s替換為配置的名稱空間，指令名稱不帶百分號。 ## **PurifierLinkify** 內部自動格式化程序，可將語法％Namespace.Directive中的配置指令轉換為鏈接。`a`具有`href`屬性的標簽必須允許。 ## **RemoveEmpty.Predicate** 給定一個元素沒有內容，默認情況下它將被刪除，除非該謂詞另有規定。謂詞可以是從標記名到屬性列表的關聯映射，必須將這些屬性存在才能視為要保留的元素：因此，默認值始終保留`colgroup`，`th`和`td`，`iframe`如果它具有，則也是如此`src`。 ## **RemoveEmpty.RemoveNbsp.Exceptions** 當[％AutoFormat.RemoveEmpty](http://htmlpurifier.org/live/configdoc/plain.html#AutoFormat.RemoveEmpty)和[％AutoFormat.RemoveEmpty](http://htmlpurifier.org/live/configdoc/plain.html#AutoFormat.RemoveEmpty).RemoveNbsp被啟用，該指令定義了哪些HTML元素不應該removede如果他們只有在他們非換空間。 ## **RemoveEmpty.RemoveNbsp** 啟用后，HTML Purifier會將僅包含不間斷空格和常規空格的任何元素都視為空白，并在啟用[％AutoForamt.RemoveEmpty](http://htmlpurifier.org/live/configdoc/plain.html#AutoForamt.RemoveEmpty)時將其刪除。 請參閱[％AutoFormat.RemoveEmpty](http://htmlpurifier.org/live/configdoc/plain.html#AutoFormat.RemoveEmpty).RemoveNbsp.Exceptions，以了解沒有對此行為應用的元素的列表。 ## **RemoveEmpty** 啟用后，HTML Purifier將嘗試刪除對文檔沒有任何語義信息的空元素。以下類型的節點將被刪除： * 沒有屬性，沒有內容且不是空元素的標簽（刪除`<a></a>`但不是`<br />`），以及 * 沒有內容的標簽，除了： * 的`colgroup`元素，或 * 具有`id`或`name`屬性的元素（如果在這些元素上允許使用那些屬性）。 使用此功能時請格外小心；盡管看起來空白元素似乎沒有包含有用的信息，但是如果使用適當的樣式，它們可以更改文檔的布局。當處理機器生成的HTML時，此指令最有用，請避免在常規用戶HTML上使用它。 僅包含空格的元素將被視為空。但是，不間斷空格不算作空格。請參閱[％AutoFormat.RemoveEmpty](http://htmlpurifier.org/live/configdoc/plain.html#AutoFormat.RemoveEmpty).RemoveNbsp以了解其他行為。 該算法并不完美；您可能仍然會注意到一些空標簽，尤其是在節點中包含元素的情況下，但是后來又刪除了這些元素，因為這些元素在該上下文中是不允許的，或者被另一個標簽自動關閉后又為空的標簽被刪除。出于安全原因，這可以防止聰明的代碼破壞驗證。一般的經驗法則：如果標簽在進入過程中看起來是空的，它將被刪除；如果HTML Purifier使其為空，它將保持不變。 ## **RemoveSpansWithoutAttributes** 此偽指令將導致`span`刪除沒有任何屬性的標記。它還將刪除在處理期間已刪除所有屬性的跨度。