Banner展示功能开发

最后更新: | 浏览次数: 414|功能开发

介绍

我们的 Banner 展示模块的详细介绍见于网站banner编辑，所有调用属性均基于 AdvertModel 进行设计，这是一个包含广告数据的自定义模型类型。

Banner的调用

使用@Cms.Banner()可以在任意地方调用Banner图片，@Model.Banner 只能在相对应的分类或子类或其所属内容上调用。

方法

方法 描述
@Cms.Banner(string identName, string viewPath = null) 调用广告图片
@Model.Banner(string viewPath) 调分分类广告图片

参数说明

  • identName：广告标识名称
  • viewPath(可选)：广告组件地址 ，如果为空则默认调用Views/_AdSlide文件

异同

相同点：两个方法均会返回一个advertmodel对象

差异点：

  • Model.Banner只能在相对应的分类或子类或其所属内容上调用。
  • Cms.Banner可以在任何位置调用

AdvertModel 属性

属性名称 返回类型 说明
Items ThumbList 返回广告模型中的多个 PhotoItemModel 对象的列表
Ident string 唯一标识符，通常用于为 HTML 元素生成唯一的 ID，以便于 JavaScript 或 CSS 的操作
Lazy bool 用于确定是否启用懒加载功能。
Effect SlideEffect 定义了轮播图的过渡效果
Direction SlideDirection 表示横幅的滚动方向
Speed int 表示横幅切换的速度，通常以ms为单位
AutoPlay int 用于设置 data-delay 属性，以控制自动播放的延迟
Parallax bool 是否启用视差效果。
Loop bool 是否启用轮播的循环模式
Fixed bool 是否启用背景固定
EnablePagination bool 是否启用分页控件
EnableNavigation bool 是否启用前进和后退导航按钮
EnableCustomNavigation bool 是否启用自定义导航

AdvertModel.ThumbList 属性

AdvertModel.ThumbList 为数组类型。

属性名称 返回类型 说明
Url string 获取图片的Url地址
Width string 获取图片的宽度
Height string 获取图片的高度
Link string 获取图片的指向链接
Caption string 获取图片的说明
Summary IHtmlString 获取图片的摘要

调用示例：@Model.Thumbs[0].Url

自定义组件

在 Views/ 目录下，我们提供了一系列默认组件，以帮助您快速开发。这些组件会随着系统的更新而不断演进。如果您需要自定义组件，可以在 module/ 目录下创建对应的文件，并通过 @Cms.Load 引用这些文件。

在 module/ 目录下，我们预设了一个名为 _banner-with-bread 的组件。这个组件主要用于分类页的面包屑导航默认的 Banner，您可以利用它来加速开发。如果这些组件无法满足您的需求，请参考我们的文档进行进一步的自定义开发。

总结

Banner 展示模块允许在网站的任意位置调用广告图片，通过 @Cms.Banner 和 @Model.Banner 方法实现灵活配置，支持自定义和扩展开发。