OctoberCMS-8-組件

scq000 發(fā)布于2019-07-01 10:08 / 1798人閱讀

摘要：組件是可以配置的構(gòu)建元素。可以附加到頁面布局部件中。組件是的核心特性。每個組件都可以對網(wǎng)站的功能進行擴展。組件可以在頁面上輸出代碼，但是這不是主要的，組件的一個重要功能是處理請求處理表單提交回調(diào)，處理頁面執(zhí)行周期。

Components

Components這里我們稱之為組件。

組件是可以配置的構(gòu)建元素。可以附加到Pages（頁面）、Layouts（布局）、Partials（部件）中。組件是October的核心特性。每個組件都可以對網(wǎng)站的功能進行擴展。組件可以在頁面上輸出HTML代碼，但是這不是主要的，組件的一個重要功能是處理Ajax請求、處理表單提交回調(diào)，處理頁面執(zhí)行周期。允許向頁面注入變量或者實現(xiàn)網(wǎng)站安全性。

介紹

啟用組件，如果是后端管理系統(tǒng)中，可以選擇組件面板，將組件拖動添加到頁面、部件和布局中。如果是采用文本編輯模式，則可以將組件的對應(yīng)模板的名稱添加到對應(yīng)的模板的配置部分。比如：下面的例子演示了如何將todolist組件添加到頁面中。

title = "Components demonstration"
url = "/components"

[demoTodo]
maxItems = 20
==
...

當您引用Components時，它會自動創(chuàng)建一個與Components名稱匹配的Page變量（在前面的示例中為demoTodo）。提供HTML標記的Components可以使用標記在Page上呈現(xiàn){% component %}，如下所示：

{% component "demoTodo" %}

如果具有相同名稱的兩個組件分配給Page和Layout，Page中的組件將覆蓋布局中的組件。

組件的別名

如果有兩個注冊Components的名稱相同，則可以使用完全限定的名稱引用組件，并為其指定一個別名：

[OctoberDemoComponentsTodo demoTodoAlias]
maxItems = 20

第一個參數(shù)是類名，第二個參數(shù)是注入到Page時使用的組件的別名。如果您指定了組件的別名，那么在引用組件時，可以頁面代碼中的任何地方使用。下一個示例引用Components別名：

{% component "demoTodoAlias" %}

允許給同一個組件定義多個別名，以實現(xiàn)在同一個頁面上使用一個組件的多個實例。

[demoTodo todoA]
maxItems = 10
[demoTodo todoB]
maxItems = 20

組件使用外部屬性值

默認情況下，屬性值在定義組件的配置部分會進行初始化，這時候?qū)傩灾凳庆o態(tài)的，如下所示：

[demoTodo]
maxItems = 20
==
...

不過有一個辦法可以使用外部的參數(shù)為組件屬性進行初始化。可以是URL參數(shù)，Partial部件參數(shù)。使用{{ paramName }}從外部變量加載的值的語法：

[demoTodo]
maxItems = {{ maxItems }}
==
...

假設(shè)在上面的示例中，組件 demoTodo 在部件中使用，則部件的變量maxItems**將為組件的變量進行初始化：

{% partial "my-todo-partial" maxItems="10" %}

如果是URL參數(shù)，則使用的方式略有不同：使用{{ :paramName }}名稱以冒號（:）開頭的語法

[demoTodo]
maxItems = {{ :maxItems }}
==
...

組件對應(yīng)的頁面在配置部分，應(yīng)該具有相應(yīng)的URL參數(shù)定義：

url = "/todo/:maxItems"

在October的后端，您可以使用Inspector工具將外部值分配給Components屬性。在Inspector中，您不需要使用大括號輸入?yún)?shù)名稱。Inspector中的每個字段在右側(cè)都有一個圖標，用于打開外部參數(shù)名稱編輯器。輸入paramName部分變量或:paramNameURL參數(shù)的參數(shù)名稱。

自定義默認標記

http://octobercms.com/docs/cm...

后續(xù)補充