sails.config.views
應用程式伺服器端視圖的設定。 選項通常在 config/views.js
設定檔中指定。
屬性 | 類型 | 預設值 | 詳細資訊 |
---|---|---|---|
layout |
"layout" |
透過從您的視圖資料夾 (即 views/ ) 指定所需版面配置檔案的相對路徑,為您的應用程式設定預設的版面配置,或使用 false 完全停用版面配置支援。 內建的版面配置支援僅在使用 ejs 時相關 (請參閱下文)。 |
|
extension |
"ejs" | 視圖檔案的副檔名。 | |
getRenderFn |
無 | Sails 將呼叫此函式以取得您所需視圖引擎的呈現函式。 有關指定 getRenderFn 值的更多資訊,請參閱視圖引擎文件。 如果此設定未定義,Sails 將使用內建的 EJS 渲染器。 |
|
locals |
{} |
作為視圖區域變數包含的預設資料,每次在此應用程式中的任何位置編譯伺服器端視圖時都會包含。 如果透過 res.view() 直接傳入選用的 locals 引數,則當兩個字典合併並提供給視圖時,其屬性優先 (稍後會詳細說明)。 |
- 如果您的應用程式未使用
ejs
(預設視圖引擎),Sails 的功能將如同layout
選項設定為false
。 若要在使用自訂視圖引擎 (如 Jade 或 Handlebars) 時利用版面配置,請查看該視圖引擎的文件以尋找適當的語法。- 從 Sails 0.12.0 開始,來自
sails.config.views.locals
的應用程式範圍區域變數會與您搭配res.view()
使用的任何一次性區域變數結合,並使用淺層合併策略。 也就是說,如果您的應用程式範圍區域變數設定為{foo: 3, bar: { baz: 'beep' } }
,然後您使用res.view({bar: 'boop'})
,則您的視圖將可以存取foo
(3
) 和bar
('boop'
)。