编辑区

下面是一个海报轮播图的编辑区的例子:

• example:home_top_banner：编辑区的编码，要保证唯一，规范为：主题名称:编码区英文编码，每一个编码表示一个编辑区
• title：编辑区的名字
• category：编辑区所属的主题
• templateName：编辑区需要使用到的模板文件，这是一个相对路径，/theme-name 的真实路径为主题的根路径
• items：该编辑区所拥有的元素集合，这是一个对象，是为了方便在模板里面调用
  • title：每一个 item 的标题
  • desc： 描述
  • type： item 的类型
  • default：item 的默认值

• poster：海报类型的轮播图，比一般的 imglink 类型的 item 设置丰富
  • mode：编辑模式，有 img 和 html 两种编辑模式，img 为图片模式，只需上传图片即可， html 为自定义 html 模式，可以自定义 html
  • layout：图片的布局模式，有 limitWide 和 tile 两种， limitWide 为限宽居中，tile 为平铺居中
  • status：是否显示此图片，1 显示，0 不显示
  • src：图片的相对路径，如果是 html 模式，此参数就会被忽略
  • alt：图片的 alt 属性，如果是 html 模式，此参数就会被忽略
  • ：背景色，如果是 html 模式，此参数就会被忽略
  • href：图片链接地址，如果是 html 模式，此参数就会被忽略
• img：图片标签
  • alt：图片描述
• imglink：带链接图片标签
  • src：图片的相对路径
  • alt：图片描述
  • target：target 属性
  • href：链接地址
• text：文本标签
  • value：文本
• link：文本标签
  • value：文本
  • href：链接地址

@theme/example/block/carousel.template.html.twig，开发者可以直接访问 block.json 的 items 下的属性。比如 变量，这些数据是被网站运营者编辑过并重新保存到数据库里，开发者只需写相应的 HTML 代码即可。