cfmodule

Вызывает пользовательский тег для использования на страницах приложения CFML. Этот тег обрабатывает конфликты имён пользовательских тегов.

<cfmodule>

cfmodule(template="nameoftemplate.cfm",attributeCollection={});

CF3+

Lucee

BL 1.0.0+

Справочник по атрибутам

template string

Не может использоваться одновременно с атрибутом name. Путь к странице, реализующей тег. Относительный путь: разрешается относительно текущей страницы. Абсолютный путь: разрешается с использованием сопоставления CFML. Физический путь недопустим.

name string

Не может использоваться одновременно с атрибутом template. Имя пользовательского тега в формате "Name.Name.Name..." Указывает подкаталог в корневом каталоге тегов CFML, содержащий страницу пользовательского тега. Например (формат Windows): cfmodule name = "superduper.Forums40.GetUserOptions" Это указывает на страницу GetUserOptions.cfm в каталоге CustomTags\superduper\Forums40 в корневом каталоге CFML.

attributecollection struct

Набор пар «ключ-значение», представляющих имена и значения атрибутов. Можно указать несколько пар «ключ-значение». Этот атрибут можно указать только один раз.

Совместимость

ColdFusion:

Версия 3+ ColdFusion поддерживает синтаксис cfmodule() в скриптах

Lucee:

Lucee поддерживает синтаксис в скриптах module template="file.cfm"

BoxLang:

Версия 1.0.0+ <bx:module> в BoxLang

Примеры
Пример кода с использованием тега cfmodule

Использование атрибута template с абсолютным путём к шаблону

<cfmodule template="\layout\default\mainheader.cfm">

Использование атрибута template с относительным путём к шаблону

<cfmodule template="..\..\..\layout\register\sectionheader.cfm">

Использование атрибута name

<cfmodule name="layout.corp.copyright">

Передача двух произвольных атрибутов в теле тега

<cfmodule template="\layout\default\mainheader.cfm" theme="default" pageTitle="Welcome!">

Передача двух произвольных атрибутов с помощью атрибута attributeCollection

<cfset attrs = {theme = "default", pageTitle = "Welcome!"}>
<cfmodule template="\layout\default\mainheader.cfm" attributecollection="#attrs#">

Передача содержимого между открывающим и закрывающим тегами

В этом примере тег <p> и его содержимое будут доступны файлу super-duper-formatter.cfm, который обработает их согласно заданной логике форматирования.

<cfmodule template="\layout\super-duper-formater.cfm">
   <p>Some content the module will format</p>
</cfmodule>

Использование cfscript с коллекцией атрибутов

В этом примере показан вызов с использованием cfscript.

<cfscript>attrs = {theme = "default", pageTitle = "Welcome!"}>
cfmodule(template="myTemplate.cfm",attributeCollection="#attrCollection1#")</cfscript>

© 2012–present Foundeo, Inc. and the CFDocs contributors.
Licensed under the MIT License.
ColdFusion is a trademark of Adobe Systems Incorporated.
https://cfdocs.org/cfmodule