创建占位符标记

使用占位符标记来显示元素或组件设计中的元数据。

关于此任务

这是占位符标记的格式:

[placeholder tag=" " htmlencode=" " start=" " end=" " ]

要创建占位符标记:

过程

  1. 从演示模板或元素设计字段中单击插入标记。将打开标记助手对话框。
  2. 占位符选为标记类型。
  3. 选择占位符标记类型。这将作为 tag=" " 参数添加到占位符标记:
    Name
    这用于显示菜单或导航器中检索的站点区域或内容项的名称。此参数也可以在创建用户名组件时使用,这时您可以在设计中添加占位符标记并指定 tag="name" 以呈示用户名。
    Title
    这用于显示菜单或导航器中检索的站点区域或内容项的标题。
    dn
    在创建用户名组件时使用。您可以在设计中添加占位符标记,并指定 tag="dn" 以呈示用户的专有名称。
    HREF
    这用于将链接插入菜单或导航器中检索的站点区域或内容项的页面中。
    noprefixhref
    通过门户网站查看时,“HREF”参数生成的 URL 将是标准 URL。要生成没有前缀的 URL,请使用“noprefixhref”参数而不是“HREF”参数。
    NameLink
    Name 和 HREF 标记的组合。它根据返回项的名称集合成一个完整链接。
    noprefixnameLink
    通过门户网站查看时,“nameLink”参数生成的 URL 将是标准 URL。要生成没有前缀的 URL,请使用“noprefixhref”参数而不是“nameLink”参数。
    TitleLink
    Title 和 HREF 标记的组合。它根据返回项的标题集合成一个完整链接。
    noprefixtitleLink
    通过门户网站查看时,“titleLink”参数生成的 URL 将是标准 URL。要生成没有前缀的 URL,请使用“noprefixhref”参数而不是“titleLink”参数。
    sitepath
    这类似于 HREF 占位符,不同处在于它只显示项的 URL 的站点路径。

    例如,显示内容项的 HREF 占位符标记可能给出:

    • /ILWWCM/connect/metaorg/intranet/press+releases

    而站点路径则给出:

    • /metaorg/intranet/press+releases

    例如,显示站点区域的 HREF 占位符标记可能给出:

    • /ILWWCM/connect/metaorg/intranet/

    而站点路径则给出:

    • /metaorg/intranet
    请注意,为站点区域显示站点路径时不包括末尾的斜杠(/)。
    Idnum
    它返回项的十六进制标识值。可以使用此参数创建菜单和导航器中的静态 URL。您可以将站点区域路径硬编码到菜单或导航器元素设计中,并对显示的每个内容项使用 Idnum。使用此方法以使用不同的演示模板(例如,打印机友好演示模板)显示内容或使用不同的安全性设置。
    Listnum
    列表中的项的索引。
    Treenum
    显示一个分层编号列表:
    1.0
    1.1
    1.2
    2.0
    2.1
    2.2
    Paddedtreenum
    类似于 Treenum,但数字是加长的:
    0001
    00010001
    00010002
    000100020001
    000100020002
    Depth
    将(导航器或菜单中)当前处理接点的深度显示为数字。 顶级节点深度为 1。
  4. 如果将占位符标记用于 JSR 286 Web 内容查看器呈现的编写工具元素,请指定 format 属性来控制执行编写任务的位置。
    format="tag"
    占位符呈示为 URL,此 URL 在新窗口中打开编写 portlet。如果未指定值,那么缺省情况下使用此行为。
    format="url"
    占位符呈现为 URL,它将用户重定向到 JSR 286 Web 内容查看器使用的隐藏门户网站页面以进行直接插入编辑。
  5. 选择占位符的编码类型:
    对标记输出进行编码
    如果选中,那么源中保留的 HTML 字符将转换为字符实体。例如,“<”转换为“&lt;”。如果要防止用户添加恶意代码或使用 HTML 更改其文本外观,那么此方法很有用。
    不对标记输出进行编码
    如果选中,将不会对占位符标记呈现的 HTML 应用任何编码。
    缺省编码
    如果选中,将使用 WCM WCMConfigService 服务中的 cmpnt.htmlEncodeDefault 属性指定的缺省设置。 缺省情况下,该属性设置为 true
  6. 单击确定以将标记添加到您的导航器设计中。

下一步做什么

将标记添加到设计之后,您还可以向该标记添加下列参数:
表 1. 其他标记参数
标记参数 详细信息
start=" "

end=" "

start 和 end 属性用于将标记返回的数据合并到 HTML 之类的其他标记中。它们不是必需的属性。
使用 URLCmpnt 标记:

URLCmpnt 标记用于生成指向站点区域或内容项的 URL,并且可以在生成 URL 时用作占位符的替代项。当创建指向呈示 portlet 中显示的 Web 内容的链接时,此方法很有用。