组件:轮播图片框
轮播图片框组件用于图片轮播展示,支持添加项目、开始/停止轮播、设置间隔时间等特性,常用于图片轮播、广告展示、幻灯片播放等场景。
典型使用场景:
- 首页轮播(网站首页焦点图、产品展示、品牌宣传)
- 广告展示(广告轮播、促销活动、产品推广)
- 产品展示(产品图片轮播、商品详情、相册展示)
- 新闻轮播(新闻图片、头条资讯、重要信息)
- 活动展示(活动海报、专题页面、节日庆典)
📌 继承自视图的成员速查
本组件继承自 视图 类,可直接使用以下属性和方法:
属性: ID、左边、顶边、右边、底边、宽度、高度、背景、背景颜色、背景图像、文本、文本颜色、字体、字体大小、字体粗细、行高、边框、边框圆角、边框宽度、光标样式、显示模式、透明度、外边距、外边距底、外边距左、外边距右、外边距顶、最大高度、最大宽度、最小高度、最小宽度、内边距、内边距底、内边距左、内边距右、内边距顶、定位、CLASS、InnerHTML、OuterHTML、内容水平对齐方式、首行缩进、可视、显示层级、内联样式、禁用
方法: 追加内联样式(样式文本)、置内联样式(名称,值)、取内联样式值(名称)、取Style对象()、添加事件(事件名称, 回调函数)、删除事件(事件名称, 回调函数)、获取焦点()、清除焦点()、添加样式类(类名称)、移除样式类(类名称)、取样式类列表()、取样式类()、执行单击()、取属性值(属性名)、取属性节点(属性名)、取布局参数()、取渲染宽度()、取渲染高度()、取渲染顶边()、取渲染左边()、左侧对齐到(目标组件,偏移量)、右侧对齐到(目标组件,偏移量)、顶边对齐到(目标组件,偏移量)、底边对齐到(目标组件,偏移量)、右侧对齐到左(目标组件, 偏移量)、左侧对齐到右(目标组件, 偏移量)、底边对齐到顶(目标组件, 偏移量)、顶边对齐到底(目标组件, 偏移量)、有指定属性(属性名)、有属性()、内容可编辑()、包含CSS类(类名)、取命名空间()、取下个节点()、取下个元素()、取节点名称()、取节点类型()、取父节点()、取父元素()、取上个节点()、取上个元素()、销毁()、删除属性(属性名)、删除属性节点(属性名)、置属性值(属性名, 属性值)、置属性节点(属性节点)、取标签名()、移动(左边 顶边, 宽度, 高度)、取原生对象()、置被单击回调(回调函数)、置被双击回调(回调函数)、置鼠标被进入回调(回调函数)、置鼠标被移出回调(回调函数)、置鼠标被移动回调(回调函数)、置鼠标被按下回调(回调函数)、置鼠标被抬起回调(回调函数)、置鼠标滚轮被滚动回调(回调函数)、置键盘被按下回调(回调函数)、置按键被抬起回调(回调函数)、置按键被压下回调(回调函数)、置被失去焦点回调(回调函数)、置被获得焦点回调(回调函数)
事件: 被单击(源对象,事件源)、被双击(源对象,事件源)、鼠标被进入(源对象,事件源)、鼠标被移出(源对象,事件源)、鼠标被移动(源对象,事件源)、鼠标被按下(源对象,事件源)、鼠标被抬起(源对象,事件源)、鼠标滚轮被滚动(源对象,事件源)、键盘被按下(源对象,事件源)、按键被抬起(源对象,事件源)、按键被压下(源对象,事件源)、被失去焦点(源对象,事件源)、被获得焦点(源对象,事件源)
💡 完整成员列表及详细说明请参考:
视图类
常用操作速查
| 操作 | 属性/方法 | 示例 |
|---|---|---|
| 添加轮播项目 | 添加项目(标题, 图片路径, 键) | 轮播图片框1.添加项目("第一张", "static/1.jpg", "k1") |
| 开始轮播 | 开始() | 轮播图片框1.开始() |
| 停止轮播 | 停止() | 轮播图片框1.停止() |
| 设置间隔时间 | 间隔时间 | 轮播图片框1.间隔时间 = 3000 |
| 设置当前索引 | 当前索引 | 轮播图片框1.当前索引 = 0 |
| 设置自动播放 | 自动播放 | 轮播图片框1.自动播放 = 真 |
| 设置循环播放 | 循环播放 | 轮播图片框1.循环播放 = 真 |
| 设置轮播回调 | 置轮播被切换回调(回调) | 轮播图片框1.置轮播被切换回调((源对象, 当前索引) => { ... }) |
样式美化参考
轮播样式变体:
- 全屏轮播:
宽度 = "100%",高度 = 500,边框 = "none",边框圆角 = "0" - 卡片轮播:
宽度 = 800,高度 = 400,边框 = "none",边框圆角 = "12px",阴影 = "0 4px 12px rgba(0,0,0,0.15)" - 缩略图轮播:
宽度 = 600,高度 = 300,边框 = "1px solid #e8e8e8",边框圆角 = "8px"
指示器样式:
- 圆点指示器:
指示器类型 = "圆点",指示器位置 = "底部",指示器颜色 = "#1890ff",`指示器大小 = 8 - 数字指示器:
指示器类型 = "数字",指示器位置 = "底部",指示器颜色 = "#ffffff",`指示器大小 = 14 - 分页指示器:
指示器类型 = "分页",指示器位置 = "底部",指示器颜色 = "#1890ff",`指示器大小 = 12
导航按钮样式:
- 默认导航:
导航按钮 = "显示",导航按钮颜色 = "#ffffff",导航按钮背景 = "rgba(0,0,0,0.3)",`导航按钮大小 = 32 - 箭头导航:
导航按钮 = "箭头",导航按钮颜色 = "#ffffff",导航按钮背景 = "rgba(0,0,0,0.5)",`导航按钮大小 = 40 - 圆形导航:
导航按钮 = "圆形",导航按钮颜色 = "#ffffff",导航按钮背景 = "rgba(0,0,0,0.3)",`导航按钮大小 = 36
过渡效果样式:
- 淡入淡出:
过渡效果 = "淡入淡出",过渡时间 = 500,缓动函数 = "ease" - 左右滑动:
过渡效果 = "左右滑动",过渡时间 = 300,缓动函数 = "ease-out" - 上下滑动:
过渡效果 = "上下滑动",过渡时间 = 300,缓动函数 = "ease-out" - 缩放效果:
过渡效果 = "缩放",过渡时间 = 400,缓动函数 = "ease-in-out"
状态样式:
- 播放状态:
背景颜色 = "#000000",边框 = "none",`透明度 = 1 - 暂停状态:
背景颜色 = "#000000",边框 = "none",`透明度 = 1 - 悬停状态:
背景颜色 = "#000000",边框 = "none",`透明度 = 0.9 - 选中状态:
指示器颜色 = "#1890ff",`指示器大小 = 12
响应式样式:
- 移动端适配:
宽度 = "100%",高度 = 200,指示器大小 = 6,`导航按钮大小 = 24 - 平板端适配:
宽度 = "100%",高度 = 300,指示器大小 = 8,`导航按钮大小 = 32 - 桌面端适配:
宽度 = 800,高度 = 400,指示器大小 = 10,`导航按钮大小 = 40
示例代码
变量 轮播图片框1 = 创建 轮播图片框()
轮播图片框1.左边 = 100
轮播图片框1.顶边 = 100
轮播图片框1.宽度 = 600
轮播图片框1.高度 = 300
轮播图片框1.添加项目("第一张", "static/1.jpg", "k1")
轮播图片框1.添加项目("第二张", "static/2.jpg", "k2")
轮播图片框1.添加项目("第三张", "static/3.jpg", "k3")
轮播图片框1.开始轮播(3000)
轮播图片框1.切换到下一项()
函数:添加项目(标题, 图片地址, 标记值)
向轮播图中添加一个图片项目。
函数:开始轮播(间隔时间)
开始自动轮播,参数为轮播间隔时间(毫秒)。
函数:停止轮播()
停止自动轮播。
函数:取当前项目()
返回当前显示的图片项目。
函数:切换到下一项()
手动切换到下一张图片。
函数:置图片被单击回调(回调函数)
设置图片被单击时的回调函数,参数为图片的标记值。
事件:图片被单击(源对象,图片对象)
图片被单击时触发,参数为源对象和图片对象。