# carouselview

**Repository Path**: chinasoft5_ohos/carouselview

## Basic Information

- **Project Name**: carouselview
- **Description**: 自定义轮播图组件
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/chinasoft5_ohos/carouselview
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-07-26
- **Last Updated**: 2021-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# carouselview

## 项目介绍
项目名称：carouselview

所属系列：openharmony的第三方组件适配移植

功能：自定义轮播图组件

项目移植状态：主功能完成 

调用差异：1.FLOW 实现Y轴旋转    2.SLIDE_OVER 实现PageSlider子控件的自定义层级绘制

开发版本：sdk6，DevEco Studio2.2 Beta1

基线版本：Maven 0.1.5

## 效果演示
![输入图片说明](./printscreen/depth.gif)
![输入图片说明](./printscreen/flow.gif)

![输入图片说明](./printscreen/slide_over.gif)
![输入图片说明](./printscreen/zoom.gif)

## 安装教程
1.在项目根目录下的build.gradle文件中，

 ```

allprojects {

    repositories {

        maven {

            url 'https://s01.oss.sonatype.org/content/repositories/releases/'
        }
    }
}

 ```

2.在entry模块的build.gradle文件中，

 ```

 dependencies {

    implementation('com.gitee.chinasoft_ohos:carouselview:1.0.1')

    ......  

 }

 ```
在sdk6，DevEco Studio2.2 Beta1下项目可直接运行 如无法运行，删除项目.gradle,.idea,build,gradle,build.gradle文件， 并依据自己的版本创建新项目，将新项目的对应文件复制到根目录下

## 使用说明

1.将仓库导入到本地仓库中

2.在布局文件中加入CarouselView控件,代码实例如下:
```
  <com.synnapps.carouselview.CarouselView
        ohos:id="$+id:carouselView"
        ohos:height="200vp"
        ohos:width="match_parent"
        ohos:background_element="#444"  
        hap:animateOnBoundary="true" // 是否平滑滚动
        hap:autoPlay="true" // 是否自动播放
        hap:fillColor="#ffffff"  // 指示器选中颜色
        hap:indicatorVisibility="2" // 是否显示指示器
        hap:pageColor="#00000000" //指示器背景颜色
        hap:pageTransformInterval="1500" // 设置页面切换时间
        hap:pageTransformer="1" // 设置切换动画类型 -1为默认  0为FLOW  1为SLIDE_OVER  2为DEPTH  3为ZOOM
        hap:radius="18"  // 指示器圆点半径
        hap:slideInterval="3000" // 自动轮播时间
        hap:strokeColor="#777777"  // 指示器边框颜色
        hap:strokeWidth="3"/> // 指示器边框宽度
```

3.使用CarouselView控件

```
使用默认图片布局
public class SampleCarouselViewAbility extends Ability {
    CarouselView carouselView;

    int[] sampleImages = {ResourceTable.Media_image_1, ResourceTable.Media_image_2
            , ResourceTable.Media_image_3, ResourceTable.Media_image_4,ResourceTable.Media_image_5};

    @Override
    public void onStart(Intent intent) {
        super.setUIContent(ResourceTable.Layout_ability_sample_carousel_view);
        carouselView = (CarouselView) findComponentById(ResourceTable.Id_carouselView);
        carouselView.setPageCount(sampleImages.length);
        carouselView.setImageListener(imageListener);
    }

    ImageListener imageListener = new ImageListener() {
        @Override
        public void setImageForPosition(int position, Image image) {
            imageView.setPixelMap(sampleImages[position]);
        }
    };

}
```

使用自定义布局, implement ```ViewListener```.
```

public class SampleCarouselViewAbility extends Ability {

    CarouselView customCarouselView;
    int NUMBER_OF_PAGES = 5;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.setUIContent(ResourceTable.Layout_ability_sample_carousel_view);
        customCarouselView = (CarouselView) findComponentById(ResourceTable.Id_customCarouselView);
        customCarouselView.setPageCount(NUMBER_OF_PAGES);
        // set ViewListener for custom view 
        customCarouselView.setViewListener(viewListener);
    }

    ViewListener viewListener = new ViewListener() {
        @Override
        public View setViewForPosition(int position) {
            Component customView = LayoutScatter.getInstance(getContext())
                .parse(ResourceTable.Layout_view_custom, null, true);
            //set view attributes here
            return customView;
        }
    };

```

图片点击事件
```
customCarouselView.setImageClickListener(new ImageClickListener() {
            @Override
            public void onClick(int position) {
                new ToastDialog(getContext()).setText("Clicked item: " + position).show();
            }
        });
```

混淆
```
-keep class com.synnapps.carouselview.** { *; }
```

## 测试信息

CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

当前版本demo功能与原组件基本无差异


## 版本迭代
- 1.0.1
- 1.0.0
- 0.0.1-SNAPSHOT

## 版权和许可信息

    Copyright 2016 Sayyam.

    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and 
    limitations under the License.