Banner展示功能开发
最后更新: | 浏览次数: 283|功能开发
介绍
我们的 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
方法实现灵活配置,支持自定义和扩展开发。