# CarouselView

**Repository Path**: hihopeorg/CarouselView

## Basic Information

- **Project Name**: CarouselView
- **Description**: 3D旋转木马效果
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-09-02
- **Last Updated**: 2021-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CarouselView

**本项目是基于开源项目CarouselView进行ohos化的移植和开发的，可以通过项目标签以及github地址（https://github.com/binaryroot/CarouselView ）追踪到原项目版本**

#### 项目介绍

- 项目名称：3D旋转木马
- 所属系列：ohos的第三方组件适配移植
- 功能：3D旋转木马效果
- 项目移植状态：完成
- 调用差异：无
- 项目作者和维护人：hihope
- 联系方式：hihope@hoperun.com
- 原项目Doc地址：https://github.com/binaryroot/CarouselView
- 原项目基线版本：master , sha1:d51427b131b833d645501639984fb3ac12478130
- 编程语言：Java 
- 外部库依赖：无

#### 效果展示

<img src="preview/preview.gif"/>

#### 安装教程

方法1.

1. 编译har包CarouselView.har。
2. 启动 DevEco Studio，将编译的har包，导入工程目录“entry->libs”下。
3. 在moudle级别下的build.gradle文件中添加依赖，在dependences标签中增加对libs目录下har包的引用。

```
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])
	……
}
```

4. 在导入的har包上点击右键，选择“Add as Library”对包进行引用，选择需要引用的模块，并点击“OK”即引用成功。

方法2.

1. 在工程的build.gradle的allprojects中，添加HAR所在的Maven仓地址

```
repositories {
    maven {
        url 'http://106.15.92.248:8081/repository/Releases/' 
    }
}
```

2. 在应用模块的build.gradle的dependencies闭包中，添加如下代码:

```
dependencies {
    implementation 'com.carousel.ohos:CarouselView:1.0.0'
}
```

#### 使用说明

##### 1. 添加布局:
```xml
<com.carousel.CarouselComponent
        ohos:id="$+id:carouselView"
        ohos:height="350vp"
        ohos:width="match_parent"
        ohos:alignment="center"/>
```

##### 2. 获取控件:
```
 CarouselComponent mCarouselView = (CarouselComponent) findComponentById(ResourceTable.Id_carouselView);
```

##### 3. 添加子Component:
```
for (Component stubItem : initStubItems()) {
            mCarouselView.addComponent(stubItem);
        }

private List<Component> initStubItems() {
        List<Component> result = new ArrayList<>();

        ImagePanel imagePanel = new ImagePanel(this);
        imagePanel.setImageResId(ResourceTable.Media_iron_man);
        result.add(imagePanel);

        imagePanel = new ImagePanel(this);
        imagePanel.setImageResId(ResourceTable.Media_natasha);
        result.add(imagePanel);

        imagePanel = new ImagePanel(this);
        imagePanel.setImageResId(ResourceTable.Media_tor);
        result.add(imagePanel);

        LayoutPanel layoutPanel = new LayoutPanel(this);
        result.add(layoutPanel);

        ListLayoutPanel listLayoutPanel = new ListLayoutPanel(this);
        listLayoutPanel.setOnScrollListener(this);
        result.add(listLayoutPanel);

        return result;
    }
```

#### 版本迭代
- v1.0.0
- 已实现功能
    1. 3D旋转木马效果