打盡)
closure-templates Print指令完整清單截斷、Bidi排版與輸出后處理技巧一網(wǎng)打盡【免費下載鏈接】closure-templatesA client- and server-side templating system that helps you dynamically build reusable HTML and UI elements項目地址: https://gitcode.com/gh_mirrors/clo/closure-templatesclosure-templates原 Soy是一個開源的客戶端 服務端模板系統(tǒng)幫助你在 Java、JavaScript 等多端動態(tài)構(gòu)建可復用的 HTML 與 UI 元素。本文聚焦它的Print 指令print directives對{print}輸出結(jié)果做后處理的|directive語法一次講清截斷|truncate、Bidi 雙向排版|bidiSpanWrap/|bidiUnicodeWrap、HTML 清洗|cleanHtml與 URI 過濾等全部內(nèi)置指令幫你安全地渲染用戶內(nèi)容。Print 指令是什么print 輸出的后處理鉤子在 closure-templates 中print 命令 是最常用的命令語法為{表達式}或{print 表達式|指令1|指令2|...}。Print 指令就是管道|后面的后處理鉤子{$userComment|cleanHtml} {$title|truncate:20}指令按順序?qū)敵鲋鹨惶幚磉€能像|cleanHtml:ul,li這樣傳參。全部內(nèi)置指令的參考文檔見 print-directives.md。下圖是一個真實的Bidi 雙向排版演示頁面同時出現(xiàn) LTR 與 RTL 內(nèi)容dropdown 中的 RTL 文本被正確包裹截斷指令 |truncate參數(shù)寫法與避坑指南|truncate把字符串截斷到最大長度默認在末尾加省略號{Lorem Ipsum|truncate:8}→Lorem...{Lorem Ipsum|truncate:8,false}→Lorem Ip第二個參數(shù)false關(guān)閉省略號官方文檔明確提示截斷并不總是最佳選擇。原因是它按字符數(shù)而非視覺寬度計算中文寬度約為拉丁字符的 2 倍且不感知 Unicode截斷 emoji 等多碼點字符時可能產(chǎn)生亂碼。更穩(wěn)妥的做法是用 CSS 的text-overflow: ellipsis做視覺截斷。指令實現(xiàn)位于 TruncateDirective.java支持 1~2 個參數(shù)最大長度、是否加省略號并適配 Java 字節(jié)碼、JS 與 Python 多后端輸出。Bidi 排版指令讓 RTL 語言正確顯示面向希伯來語、阿拉伯語等 RTL從右到左內(nèi)容時兩條指令是關(guān)鍵指令作用適用場景\|bidiSpanWrap當輸出方向與全局方向不一致時自動包上span dirltr/rtl常規(guī) HTML 上下文\|bidiUnicodeWrap用 Unicode 控制字符LRE/RLE PDF包裹輸出不能出現(xiàn) HTML 標簽處如option內(nèi)兩者目的相同區(qū)別在于 HTML 標簽是否可用。編譯器在求值|bidiSpanWrap之前先做自動轉(zhuǎn)義能正確處理已轉(zhuǎn)義的 HTML 文本因此是安全的。源碼見 BidiDirectives.java。HTML 清洗與換行指令安全渲染用戶內(nèi)容|cleanHtml只保留一個小型安全標簽集合默認b、br、em、i、s、strong、sub、sup、u把text類內(nèi)容安全地轉(zhuǎn)成html可防 XSS。參數(shù)可追加白名單標簽但只允許ul、ol、li、hr、span例如|cleanHtml:ul,li。除dir外所有屬性都會被移除。|changeNewlineToBr把\n、\r、\r\n統(tǒng)一替換為br適合渲染多行用戶文本。|insertWordBreaks:NNN在超過 NNN 個字符的詞中插入wbr。已棄用請改用 CSSword-wrap: break-word。URI 過濾指令filterTelUri、filterSipUri 與 filterImageDataUri這類指令是白名單守衛(wèi)只放行指定協(xié)議的 URI|filterTelUri只接受tel://電話鏈接依據(jù) RFC 3966|filterSipUri只接受sip:語音協(xié)議鏈接依據(jù) RFC 3261|filterImageDataUri只接受包含圖片的 data URI確保img不會發(fā)起任何 HTTP 請求實現(xiàn)分別在 FilterTelUriDirective.java、FilterSipUriDirective.java 與 FilterImageDataUriDirective.java。自動轉(zhuǎn)義體系escapeUri、normalizeUri 等隱藏指令closure-templates 的自動轉(zhuǎn)義器內(nèi)部使用大量上下文感知指令你在正確上下文打印變量即可自動觸發(fā)如hr {$attributes}。少數(shù)對用戶可見的主要有|escapeUri轉(zhuǎn)義為可安全嵌入href等 URI 的值|normalizeUri歸一化 URI 分隔符轉(zhuǎn)義 HTML/CSS/JS 邊界字符注意它不做 URI 轉(zhuǎn)義|filterCspNonceValue校驗nonce屬性值為 base64CSP3 規(guī)范配合 Content-Security-Policy 使用完整的轉(zhuǎn)義類指令清單定義在 BasicDirectives.java含 CSS/JS/HTML 轉(zhuǎn)義族核心指令|escapeHtml定義在 EscapeHtmlDirective.java。安全模型詳見 security.md。完整速查表所有內(nèi)置 Print 指令一覽指令功能狀態(tài)|truncate:N[,false]截斷字符串可選省略號?? 視覺寬度不一致慎用|cleanHtml[:ul,...]白名單式 HTML 清洗? 推薦|bidiSpanWrapspan 包裹 RTL/LTR 內(nèi)容? 推薦|bidiUnicodeWrapUnicode 控制字符包裹? 推薦|changeNewlineToBr換行符轉(zhuǎn)br? 推薦|filterTelUri/|filterSipUri/|filterImageDataUriURI 協(xié)議白名單? 推薦|escapeUri/|normalizeUriURI 轉(zhuǎn)義 / 歸一化多由自動轉(zhuǎn)義器觸發(fā)|filterCspNonceValueCSP nonce 校驗編譯器內(nèi)部使用|insertWordBreaks:NNN長詞插wbr? 已棄用總結(jié)如何選擇合適的 Print 指令用戶文本→ 依賴自動轉(zhuǎn)義 |changeNewlineToBr保留部分格式時加|cleanHtml標題摘要→ 優(yōu)先 CSS 截斷確需模板層截斷再用|truncate多語言 UI→ RTL 內(nèi)容用|bidiSpanWrapoption內(nèi)用|bidiUnicodeWrap鏈接輸出→|filterTelUri/|filterSipUri/|filterImageDataUri守住協(xié)議白名單所有指令均為純函數(shù)式后處理可自由鏈式組合如需擴展自定義指令可參考 插件文檔。【免費下載鏈接】closure-templatesA client- and server-side templating system that helps you dynamically build reusable HTML and UI elements項目地址: https://gitcode.com/gh_mirrors/clo/closure-templates創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 closure-templates Print指令完整清單：截斷、Bidi排版與輸出后處理技巧一網(wǎng)打盡
closure-templates Print指令完整清單截斷、Bidi排版與輸出后處理技巧一網(wǎng)打盡【免費下載鏈接】closure-templatesA client- and server-side templating system that helps you dynamically build reusable HTML and UI elements項目地址: https://gitcode.com/gh_mirrors/clo/closure-templatesclosure-templates原 Soy是一個開源的客戶端 服務端模板系統(tǒng)幫助你在 Java、JavaScript 等多端動態(tài)構(gòu)建可復用的 HTML 與 UI 元素。本文聚焦它的Print 指令print directives對{print}輸出結(jié)果做后處理的|directive語法一次講清截斷|truncate、Bidi 雙向排版|bidiSpanWrap/|bidiUnicodeWrap、HTML 清洗|cleanHtml與 URI 過濾等全部內(nèi)置指令幫你安全地渲染用戶內(nèi)容。Print 指令是什么print 輸出的后處理鉤子在 closure-templates 中print 命令 是最常用的命令語法為{表達式}或{print 表達式|指令1|指令2|...}。Print 指令就是管道|后面的后處理鉤子{$userComment|cleanHtml} {$title|truncate:20}指令按順序?qū)敵鲋鹨惶幚磉€能像|cleanHtml:ul,li這樣傳參。全部內(nèi)置指令的參考文檔見 print-directives.md。下圖是一個真實的Bidi 雙向排版演示頁面同時出現(xiàn) LTR 與 RTL 內(nèi)容dropdown 中的 RTL 文本被正確包裹截斷指令 |truncate參數(shù)寫法與避坑指南|truncate把字符串截斷到最大長度默認在末尾加省略號{Lorem Ipsum|truncate:8}→Lorem...{Lorem Ipsum|truncate:8,false}→Lorem Ip第二個參數(shù)false關(guān)閉省略號官方文檔明確提示截斷并不總是最佳選擇。原因是它按字符數(shù)而非視覺寬度計算中文寬度約為拉丁字符的 2 倍且不感知 Unicode截斷 emoji 等多碼點字符時可能產(chǎn)生亂碼。更穩(wěn)妥的做法是用 CSS 的text-overflow: ellipsis做視覺截斷。指令實現(xiàn)位于 TruncateDirective.java支持 1~2 個參數(shù)最大長度、是否加省略號并適配 Java 字節(jié)碼、JS 與 Python 多后端輸出。Bidi 排版指令讓 RTL 語言正確顯示面向希伯來語、阿拉伯語等 RTL從右到左內(nèi)容時兩條指令是關(guān)鍵指令作用適用場景\|bidiSpanWrap當輸出方向與全局方向不一致時自動包上span dirltr/rtl常規(guī) HTML 上下文\|bidiUnicodeWrap用 Unicode 控制字符LRE/RLE PDF包裹輸出不能出現(xiàn) HTML 標簽處如option內(nèi)兩者目的相同區(qū)別在于 HTML 標簽是否可用。編譯器在求值|bidiSpanWrap之前先做自動轉(zhuǎn)義能正確處理已轉(zhuǎn)義的 HTML 文本因此是安全的。源碼見 BidiDirectives.java。HTML 清洗與換行指令安全渲染用戶內(nèi)容|cleanHtml只保留一個小型安全標簽集合默認b、br、em、i、s、strong、sub、sup、u把text類內(nèi)容安全地轉(zhuǎn)成html可防 XSS。參數(shù)可追加白名單標簽但只允許ul、ol、li、hr、span例如|cleanHtml:ul,li。除dir外所有屬性都會被移除。|changeNewlineToBr把\n、\r、\r\n統(tǒng)一替換為br適合渲染多行用戶文本。|insertWordBreaks:NNN在超過 NNN 個字符的詞中插入wbr。已棄用請改用 CSSword-wrap: break-word。URI 過濾指令filterTelUri、filterSipUri 與 filterImageDataUri這類指令是白名單守衛(wèi)只放行指定協(xié)議的 URI|filterTelUri只接受tel://電話鏈接依據(jù) RFC 3966|filterSipUri只接受sip:語音協(xié)議鏈接依據(jù) RFC 3261|filterImageDataUri只接受包含圖片的 data URI確保img不會發(fā)起任何 HTTP 請求實現(xiàn)分別在 FilterTelUriDirective.java、FilterSipUriDirective.java 與 FilterImageDataUriDirective.java。自動轉(zhuǎn)義體系escapeUri、normalizeUri 等隱藏指令closure-templates 的自動轉(zhuǎn)義器內(nèi)部使用大量上下文感知指令你在正確上下文打印變量即可自動觸發(fā)如hr {$attributes}。少數(shù)對用戶可見的主要有|escapeUri轉(zhuǎn)義為可安全嵌入href等 URI 的值|normalizeUri歸一化 URI 分隔符轉(zhuǎn)義 HTML/CSS/JS 邊界字符注意它不做 URI 轉(zhuǎn)義|filterCspNonceValue校驗nonce屬性值為 base64CSP3 規(guī)范配合 Content-Security-Policy 使用完整的轉(zhuǎn)義類指令清單定義在 BasicDirectives.java含 CSS/JS/HTML 轉(zhuǎn)義族核心指令|escapeHtml定義在 EscapeHtmlDirective.java。安全模型詳見 security.md。完整速查表所有內(nèi)置 Print 指令一覽指令功能狀態(tài)|truncate:N[,false]截斷字符串可選省略號?? 視覺寬度不一致慎用|cleanHtml[:ul,...]白名單式 HTML 清洗? 推薦|bidiSpanWrapspan 包裹 RTL/LTR 內(nèi)容? 推薦|bidiUnicodeWrapUnicode 控制字符包裹? 推薦|changeNewlineToBr換行符轉(zhuǎn)br? 推薦|filterTelUri/|filterSipUri/|filterImageDataUriURI 協(xié)議白名單? 推薦|escapeUri/|normalizeUriURI 轉(zhuǎn)義 / 歸一化多由自動轉(zhuǎn)義器觸發(fā)|filterCspNonceValueCSP nonce 校驗編譯器內(nèi)部使用|insertWordBreaks:NNN長詞插wbr? 已棄用總結(jié)如何選擇合適的 Print 指令用戶文本→ 依賴自動轉(zhuǎn)義 |changeNewlineToBr保留部分格式時加|cleanHtml標題摘要→ 優(yōu)先 CSS 截斷確需模板層截斷再用|truncate多語言 UI→ RTL 內(nèi)容用|bidiSpanWrapoption內(nèi)用|bidiUnicodeWrap鏈接輸出→|filterTelUri/|filterSipUri/|filterImageDataUri守住協(xié)議白名單所有指令均為純函數(shù)式后處理可自由鏈式組合如需擴展自定義指令可參考 插件文檔。【免費下載鏈接】closure-templatesA client- and server-side templating system that helps you dynamically build reusable HTML and UI elements項目地址: https://gitcode.com/gh_mirrors/clo/closure-templates創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考