# Carbon

**Repository Path**: ts_ohos/Carbon

## Basic Information

- **Project Name**: Carbon
- **Description**: 一个适用于鸿蒙的自定义组件框架，帮助快速实现各种需要的效果
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2021-07-06
- **Last Updated**: 2022-09-16

## Categories & Tags

**Categories**: harmonyos-advanced

**Tags**: None

## README

# Carbon

## 项目介绍
本项目是基于开源项目[Carbon](https://github.com/ZieIony/Carbon) 进行harmonyos化的移植和开发的。  

移植版本：Branches/master

这不是单纯只是API和基本功能展示demo，它是最有用的自定义控件的实现，如设计规范中所示。  
Carbon试图：
- 让事情变得更简单（指定cornerRadius='dp' 而不是创建一个xml 和/或一个ViewOutlineProvider）
- 使其全部工作并在所有 API 上看起来都相同（例如 CheckBox 的左填充）
- 真正向后移植功能（不要对阴影使用渐变！）

#### 项目名称：Carbon
#### 所属系列：harmonyos的第三方组件适配移植

#### 功能：一个适用于鸿蒙的自定义组件框架，帮助快速实现各种需要的效果
#### 项目移植状态：大部分移植
#### 调用差异：基本没有使用差异，可以参照单元测试或原项目api进行使用
#### 原项目GitHub地址：https://github.com/ZieIony/Carbon

## 支持功能
* 支持自定义progressBar功能
* 支持自定义RoundProgressBar功能
* 支持Button不同点击效果功能
* 支持自定义SeekBar滑动功能
* 支持各种动画效果展示
* 支持添加收藏组件，快速查找
* 支持各种列表展示(包含头像，文字等)功能
* 支持展示控件代码功能
* 支持不同Dialog效果展示
* 以及其它自定义效果/控件

## 安装教程

#### 方案一  
 
可以先下载项目，将项目中的carbon库提取出来放在所需项目中通过build配置
```Java
dependencies {
     implementation project(":carbon")
}
```

#### 方案二

- 1.项目根目录的build.gradle中的repositories添加：
```groovy
    buildscript {
       repositories {
           ...
           mavenCentral()
       }
       ...
   }
   
   allprojects {
       repositories {
           ...
           mavenCentral()
       }
   }
```
- 2.开发者在自己的项目中添加依赖
```groovy
dependencies {
    implementation 'com.gitee.ts_ohos:carbon:1.0.0'
}
```

## 使用说明

#### 1.权限  
需要网络权限:  
"name": "ohos.permission.INTERNET"

#### 2.代码使用  
````
            打开不同的设置页面：  
            often_text.setClickedListener(component -> {
                Intent intent = new Intent();
                if (often_text.getText().equals("Widget animations")) {
                    present(new WidgetAnimationsSlice(), intent);
                } else if (often_text.getText().equals("Image fade")) {
                    present(new ImageFadeSlice(), intent);
                } else if (often_text.getText().equals("Touch ripple")) {
                    present(new TouchRippleSlice(), intent);
                } else if (often_text.getText().equals("Path animation")) {
                    present(new PathAnimationSlice(), intent);
                }
...

        // BORDERLESS 触摸事件监听器(按下/抬起)（three）
        btnBorderless.setTouchEventListener(new Component.TouchEventListener() {
            @Override
            public boolean onTouchEvent(Component component, TouchEvent touchEvent) {
                int action = touchEvent.getAction();
                switch (action) {
                    case TouchEvent.PRIMARY_POINT_DOWN:
                        imageView.setVisibility(Component.VISIBLE);
                        break;
                    case TouchEvent.CANCEL:
                    case TouchEvent.PRIMARY_POINT_UP:
                        imageView.setVisibility(Component.HIDE);
                        break;
                }
                return true;
            }
        });

        //对每个条目判断是否收藏：
        mList.add(new DataBean(null, "The most popular problem solutions and other fun ideas implemented with Carbon's widgets and features", null, null));
        mList.add(new DataBean(power, "Power Menu", null, preferences.getBoolean("Power Menu", false) ? starFavour : favour));
        mList.add(new DataBean(null, "Auto Complete", element, preferences.getBoolean("Auto Complete", false) ? starFavour : favour));
        mList.add(new DataBean(null, "Quick Return", null, preferences.getBoolean("Quick Return", false) ? starFavour : favour));
        mList.add(new DataBean(search, "Search Toolbar", null, preferences.getBoolean("Search Toolbar", false) ? starFavour : favour));
        mList.add(new DataBean(parse1, "Share toolbar", element, preferences.getBoolean("Share toolbar", false) ? starFavour : favour));
        mList.add(new DataBean(person, "Profile", null, preferences.getBoolean("Profile", false) ? starFavour : favour));
        mList.add(new DataBean(player, "Music player", element, preferences.getBoolean("Music player", false) ? starFavour : favour));
        mList.add(new DataBean(null, "Collapsing toolbar", null, preferences.getBoolean("Collapsing toolbar", false) ? starFavour : favour));

````
## 效果演示
demo部分组件运行效果如下：
* 主页展示效果
* What's new界面展示效果
* 收藏页面展示
* Line chart页面运行效果
* Theme页面运行效果
* Backdrop及展开页面运行效果
* Profiles页面运行效果
* Circular_progress页面运行效果
* Meuns页面运行效果
* Music_player页面运行效果
* Settings页面运行效果

![主页运行效果](screenshoot/main_page.png)![what_new展开页面运行效果](screenshoot/what_new.png)

![favourties展开页面运行效果](screenshoot/favourties.png)

![line chart页面运行效果](screenshoot/line_chart.png)![theme运行效果](screenshoot/theme.png)

![backdrop运行效果](screenshoot/backdrop.png)![backdrop展开页面运行效果](screenshoot/backdrop_ex.png)

![profiles运行效果](screenshoot/profiles.png)

![circular_progress运行效果](screenshoot/circular_progress.png)![meuns运行效果](screenshoot/meuns.png)

![music_player展开页面运行效果](screenshoot/music_player.png)

![settings展开页面运行效果](screenshoot/settings.png)


## License

Copyright 2015 Marcin Korniluk 'Zielony'

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.