# TicketView

**Repository Path**: hihopeorg/TicketView

## Basic Information

- **Project Name**: TicketView
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-03-10
- **Last Updated**: 2021-10-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#  TicketView

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

#### 项目介绍

- 项目名称：提供卡片视图TicketView
- 所属系列：ohos的第三方组件适配移植
- 功能：用于在ohos中实现ticketview，具有普通、圆形和扇形角。
- 项目移植状态：完成
- 调用差异：无
- 项目作者和维护人：hihope
- 联系方式：hihope@hoperun.com
- 原项目Doc地址：https://github.com/vipulasri/TicketView
- 原项目基线版本：v1.1.2
- 编程语言：Java
- 外部库依赖：无

#### 效果展示

<img src="art/demo.gif"/>

#### 安装教程

方法一.

1. 下载TicketView的har包TicketView.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”即引用成功。。

方法二.

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

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

1. 在应用模块的build.gradle的dependencies标签中，添加如下代码:

```
dependencies {
    implementation 'com.vipulasri.ohos:ticketview:1.0.1'
}
```

#### 使用说明

1. xml布局

   ```xml
   <com.vipulasri.ticketview.TicketView
       ohos:id="$+id:ticketView"
       ohos:width="match_parent"
       ohos:height="160vp"
       ohos:left_margin="20vp"
       ohos:top_margin="40vp"
       ohos:right_margin="20vp"
       app:ticketDividerPadding="0vp"
       app:ticketDividerType="$string:DividerType_dash"
       app:ticketElevation="12vp"
       app:ticketOrientation="$string:vertical"
       app:ticketScallopPositionPercent="50"
       app:ticketScallopRadius="10vp"
       app:ticketShowBorder="false"
       app:ticketShowDivider="true" />
   ```

2. 使用xml或者代码配置属性:

   | 属性名称                                          | 默认值     | 说明                             |
   | :------------------------------------------------ | ---------- | -------------------------------- |
   | app:ticketOrientation="$string:vertical"          | horizontal | 设置扇形角和分隔线的方向         |
   | app:ticketBackgroundColor="$color:material_red"   | 0xffffffff | 设置背景颜色                     |
   | app:ticketScallopRadius="10vp"                    | 20vp       | 设置扇形半径                     |
   | app:ticketScallopPositionPercent="50"             | 50         | 设置扇形角和分隔线的位置         |
   | app:ticketShowBorder="false"                      | false      | 如果为true，则显示边框           |
   | app:ticketBorderWidth="4vp"                       | 2vp        | 设置边框宽度                     |
   | app:ticketBorderColor="$color:material_grey"      | 0xff000000 | 设置边框颜色                     |
   | app:ticketShowDivider="true"                      | false      | 如果为true，则显示分隔线         |
   | app:ticketDividerType="$string:DividerType_dash"  | normal     | 设置分隔线类型：实线或虚线       |
   | app:ticketDividerColor="$color:material_grey"     | 0xffcccccc | 设置分隔线颜色                   |
   | app:ticketDividerWidth="2vp"                      | 2vp        | 设置分隔线宽度                   |
   | app:ticketDividerPadding="0vp"                    | 10vp       | 设置分隔线距离视图间距           |
   | app:ticketDividerDashGap="4vp"                    | 4vp        | 设置分隔线虚线间距               |
   | app:ticketDividerDashLength="8vp"                 | 8vp        | 设置分隔线虚线长度               |
   | app:ticketCornerType="$string:CornerType_rounded" | normal     | 设置边角类型：正常，圆角或扇形角 |
   | app:ticketCornerRadius="15vp"                     | 4vp        | 如果是圆角或扇形角，设置圆角半径 |
   | app:ticketElevation="14vp"                        | 0vp        | 设置ticketview的高度             |
   | app:ticketBackgroundBeforeDivider                 | none       | 设置ticketview分隔线前的背景色   |
   | app:ticketBackgroundAfterDivider                  | none       | 设置ticketview分隔线后的背景色   |
   | app:ticketShadowColor                             | 0xff000000 | 设置阴影背景色                   |

#### 版本迭代

- V1.0.1

#### 版权和许可信息

- Apache Licence