跳转到主要内容
2024年10月04日 摘自 Manage displays

此文档是为显示套件 7.x-2.x 版本编写的。

显示套件允许您管理网站上实体(如节点、视图、评论、用户等)的显示。

管理实体的显示

  • 前往 管理 > 结构 > 显示套件 (admin/structure/ds)
  • 点击想要更改显示的实体的“管理显示”(例如“用户”)

注意:您也可以通过实体的“管理显示”访问相同的界面。例如: 管理 > 结构 > 内容类型 > 基本页面 > 管理显示 (admin/structure/types/manage/page/display)

  • 在“默认布局的...”垂直标签中选择所需的布局模板(例如“两列堆叠”)并点击“应用”

注意:显示套件添加了额外的字段,如“阅读更多”和“用户图片”。

  • 通过将字段拖到区域(“页眉”、“左侧”等)来开始布局排列。
  • 保存更改

Display Suite screenshot

配置字段和标签的输出

对于每个字段,您可以更改输出的格式化方式。通过“格式”列中的选择字段,您可以更改日期格式(如“长格式”、“中格式”),或移除标签中的链接。在某些情况下(例如图像字段),点击齿轮图标可以访问更高级的输出设置,如图像样式(如“缩略图”)。对于具有多个值的字段,您可以通过将井号替换为数字来设置显示的值数量。

对于每个字段,您可以编辑标签并选择标签的显示方式(与字段内联、置顶或隐藏)。

要自定义标签的值和字段的精确 HTML 输出,您需要启用 Extras 模块

为区域添加 CSS 类

定义区域后,您可以为它们定义自定义 CSS 类。

  • 前往 管理 > 结构 > Display Suite > CSS 类 (admin/structure/ds/classes)
  • 在“区域的 CSS 类”字段中输入自定义类名(一行一个)。您可以通过使用管道符号 ("|") 提供一个易于理解的类名,例如:
class_name_1
class_name_2|Class two
extravagant|Extravagant
subtle_emphasis|Subtle emphasis
  • 点击“保存”
  • 前往 管理 > 结构 > 显示套件 (admin/structure/ds/layout),为所需实体选择“管理显示”。
  • 选择“自定义类”选项卡,将类分配给区域。
  • 点击“区域的额外类”选项卡,将定义的类分配给区域。
  • 点击“保存”

您可以检查网页的源代码,查看新添加的类并在您的 CSS 中开始为其设置样式。
注意:要为字段创建并使用自定义 CSS 类,您需要启用Extras 模块

创建自定义布局

显示套件默认提供了十几种布局(如“两列”或“流动三列堆叠 25/50/25”),您可以用它们来管理实体的显示。

如果您需要自定义布局,可以在您的主题或自定义模块中定义一个。您可以使用 drush 命令 ds-build 生成必要的文件:

drush ds-build "Four columns stacked" --regions="Header, Left, Middle left, Middle right, Right, Footer"

将生成的文件夹(如“four-columns-stacked”)放置在主题或模块内名为“ds_layouts”的子文件夹中。

前往 管理 > 结构 > 显示套件 (admin/structure/ds/layout),为所需实体选择“管理显示”。

现在,您可以在“默认布局的...”垂直标签中使用自定义布局。

手动创建自定义布局文件

有关更多信息,请查阅显示套件模块文件夹中的 ds.api.php 文件。