v2.0.3

文字插值

最後更新


RJS 如何解析文字節點中的 {{ }},以及可用的取值輔助函式。

解析流程


#FIT_TEXT(頂層)/#FIT_TEXT_IN_ARRAY/#FIT_TEXT_IN_OBJECT(:for 內部)會掃描文字節點中的 {{ ... }},並透過 #GET_VALUE 解析每個符合項,支援:

輔助函式


輔助函式行為
{{ key.path }}逐層 dot-path 查找 data,透過 #GET_VALUE_FROM_LAYERS 走訪
{{ CALC(key + n) }}算術運算:+ - * / %,n 以 parseInt 讀取,透過 #CALC 執行
{{ LENGTH(key) }}純物件為 Object.keys(value).length,其餘為 value.length
{{ UPPER(key) }} / {{ LOWER(key) }}.toUpperCase() / .toLowerCase()
{{ DATE(key, format) }}將 key 解析為 Unix timestamp 並格式化(見 Date 與 Number 擴充 的 Number.$format)

  1. <div id="app">
  2. <p>Name: {{ user.name }}</p>
  3. <p>Upper: {{ UPPER(user.name) }} / Lower: {{ LOWER(user.role) }}</p>
  4. <p>Next year: {{ CALC(user.age + 1) }}</p>
  5. <p>Tags: {{ LENGTH(tags) }}</p>
  6. <p>Joined: {{ DATE(joined, YYYY-MM-DD) }}</p>
  7. </div>
  8. <script>
  9. "#app".RJS({
  10. data: {
  11. user: { name: "Pardn", role: "ADMIN", age: 30 },
  12. tags: ["dom", "template", "zero-dependency"],
  13. joined: 1704110400
  14. }
  15. });
  16. </script>
即時預覽 · @pardnchiu/renderjs@2.0.3

根元素的第一個子節點


當根元素的第一個子節點是元素(前面沒有任何文字,空白也算)時,該元素自身的 {{ }} 會保持原樣;其後的子元素與更深層的後代照常渲染。像上方範例那樣在開始標籤後換行撰寫的模板,第一個子節點必定是文字節點:
  1. <div id="a"><p>{{ msg }}</p><p>{{ msg }}</p></div>
  2. <div id="b">
  3. <p>{{ msg }}</p>
  4. </div>
  5. <script>
  6. "#a".RJS({ data: { msg: "rendered" } });
  7. "#b".RJS({ data: { msg: "rendered" } });
  8. console.log("a:", "a".$.textContent);
  9. console.log("b:", "b".$.textContent.trim());
  10. </script>
即時預覽 · @pardnchiu/renderjs@2.0.3

嵌入前後文字


REGEX_TEXT 也支援值嵌入周圍字面文字中的情況(prefix {{ key }} suffix),代換時會保留前後綴。
EN