jdoc 語句包含在每個 Joomla 模板中,用于指示 Joomla 或其擴展的其他部分輸出內容在整個網頁中的位置。本文將簡單的介紹一下Joomla模板開發中常用到的<jdoc>標簽語法,并且介紹不同類型的<jdoc>標簽元素的功能。
JDoc語句
一個典型的 jdoc 語句如下所示:
<jdoc:include type="component" />
<jdoc:include /> 語句是 Joomla! 模板用來顯示與所查看頁面特定內容的方法。有多種 <jdoc:include /> 語句,每種返回 Joomla! 頁面的不同部分。 可以簡單的理解為占位符。實際的替換過程在 JDocumentHTML::_renderTemplate 方法中完成
type 屬性
type屬性是必須的。type 屬性指定了在 <jdoc:include /> 元素位置渲染的內容類型。例如,語句 <jdoc:include type="head" /> 使用了 head 類型(type="head")。(注意:jdoc 表達式要求屬性使用雙引號,單引號無效。結尾 /> 前的空格也是必需的。)
- <jdoc:include type="component" /> 該元素在模板的 <body> 元素中應僅出現一次,用于渲染與當前查看頁面相關的主要內容。
- <jdoc:include type="head" />該元素在模板的 <head> 元素中應僅出現一次,用于渲染與當前頁面關聯的樣式 (style)、腳本 (script) 和元數據 (meta) 元素的內容。
- <jdoc:include type="installation" />該元素僅在 Joomla! 安裝程序的模板中使用(適用于 Joomla! 1.5 及以下版本),在前端或后端模板中沒有特定用途。它大致相當于 'component' 類型,用于渲染安裝步驟的主要內容。
- <jdoc:include type="message" />該元素在模板的 <body> 元素中應僅出現一次,用于渲染請求過程中發生的系統和錯誤消息。系統消息的 CSS 樣式可在 templates\system\css\system.css 中找到。
- <jdoc:include type="module" name="breadcrumbs" title="Breadcrumbs" />
<jdoc:include type="module" name="mainmenu" title="Main Menu" />該元素渲染由 name 和 title 屬性指定的單個模塊:name 應匹配模塊類型(如上面示例中的 mod_breadcrumbs 和 mod_menu),而 title 應是所需模塊的名稱。所涉及的模塊必須已發布且當前用戶可以訪問才能顯示。如果支持,可以提供額外的屬性來控制模塊的布局和外觀。 - <jdoc:include type="modules" name="[position_name]" />頁面上的模塊使用以下代碼示例之一進行渲染。模塊使用在 templatedetails.xml 文件中設定的模板位置 (template positions)?分隔在模板的不同區域。通過 jdoc:include 的 name="[模板位置名稱]" 屬性,可以分別調用、渲染和設置位于各自位置的模塊樣式。如果支持,可以提供額外的屬性來控制模塊的布局和外觀。
style 屬性
style屬性是可選的 ,style屬性可用于 <jdoc:include /> 語句的 type="module" 和 type="modules" 類型。該屬性值指的是用于包裝模塊生成輸出的裝飾樣式 (chrome style)。如果未提供樣式,則默認使用 "none"。模板設計師可以添加額外的裝飾名稱,具體如何操作,請關注joomla中文網的相關教程文章。https://www.joomlachina.cn