# MaterialRatingBar-ohos

**Repository Path**: hou-peidong/material-rating-bar-ohos

## Basic Information

- **Project Name**: MaterialRatingBar-ohos
- **Description**: 星星打分条
- **Primary Language**: Android
- **License**: Apache-2.0
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2021-05-26
- **Last Updated**: 2021-05-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MaterialRatingBar-ohos

#### 介绍
本项目是基于开源项目 MaterialRatingBar-Android 与 Google 系应用设计相同、支持拉伸、修正原生实现诸多问题的星级评分条,可直接替换 RatingBar。通过项目标签以及github地址（ https://github.com/DreaminginCodeZH/MaterialRatingBar ）追踪到原安卓项目版本

#### 项目介绍
- 项目名称：MaterialRatingBar
- 编程语言：java
- 所属系列：鸿蒙的第三方组件适配移植
- 功能：星星打分条
- 项目移植状态：完成
- 调用差异：无差异
- 开发版本：sdk5，DevEco Studio2.1 beta3
- 项目作者和维护人：王凯
- 邮箱：kai2.wang@archermind.com
- 原项目Doc地址:https://github.com/DreaminginCodeZH/MaterialRatingBar
- DO SOME CHANGES

#### 安装教程

方式一

1. 下载har包[MaterialRatingBar_ohos.har](https://gitee.com/archermind-ti/material-rating-bar-ohos/releases/1.0.0)
2. 启动 DevEco Studio，将下载的har包，导入工程目录“entry->libs”下。
3. 在moudle级别下的build.gradle文件中添加依赖，在dependences标签中增加对libs目录下jar包的引用。

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


方式二

在project的build.gradle中添加mavenCentral()的引用

```
 repositories {   
 	...   
 	mavenCentral()   
	...           
 }
```

在entry的build.gradle中添加依赖


```
 dependencies { 
        ... 
        implementation 'com.gitee.archermind-ti:material_rating_bar:1.0.0' 
        ... 
 }
```

#### 使用说明

1.xml中直接使用

```
    <com.wang.material_rating_bar.MaterialRatingBar
        ohos:height="48vp"
        ohos:width="match_content"
        ohos:start_margin="10vp"
        ohos:top_margin="10vp"
        app:rating="3.5"
        app:starElement="$graphic:icon_star_bg_solid"
        app:starFillElement="$graphic:icon_star_fill_solid"
        app:starHalfFillElement="$graphic:icon_star_half_solid"
        app:starStep="0.5"/>
```
2.代码中使用修改星星的样式


```
        ratingBar.setUnfilledElement(getElement(ResourceTable.Graphic_icon_star_bg_stroke));
        ratingBar.setFilledElement(getElement(ResourceTable.Graphic_icon_star_fill_stroke));
        ratingBar.setHalfFilledElement(getElement(ResourceTable.Graphic_icon_star_half_stroke));

        private VectorElement getElement(int resourceId) {
             VectorElement element = new VectorElement(getApplicationContext(), resourceId);
             element.setAntiAlias(true);
             return element;
        }
```


#### 版本迭代
- v1.0.0

#### 版权和许可信息
- Apache Lisence 2.0