# CalendarView

**Repository Path**: archermind-ti/calendarview

## Basic Information

- **Project Name**: CalendarView
- **Description**: 一款OHOS的自定义日历控件
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-06-10
- **Last Updated**: 2021-09-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CalendarView

### 介绍

OHOS的自定义日历控件。

### 功能

* 1、支持农历、节气、常用节假日
* 2、日期范围设置，默认支持的最大日期范围[1900.1~2049.12]
* 3、禁用日期范围设置
* 4、初始化选中单个或多个日期
* 5、单选、多选操作
* 6、跳转到指定日期
* 7、替换农历为指定文字
* 8、通过自定义属性定制日期外观，以及简单的日期item布局配置
* 9、......

### 效果图：
|![](screenshot/1.gif)|![](screenshot/2.gif)|![](screenshot/3.gif)|
|---|---|---|

### 集成和使用：
**Step 1. 添加mavenCentral仓库**
在当前项目等根目录下的 `build.gradle` 文件中添加如下内容:

``` gradle
allprojects {
    repositories {
        ...
        mavenCentral()
    }
}
```
**Step 2. 添加项目依赖**
``` gradle
dependencies {
        implementation 'com.gitee.archermind-ti:calendarView:1.0.0'
}
```
**Step 3. 在布局文件中添加WeekView、CalendarView**

```xml
    <com.othershe.calendarview.weiget.WeekView
        ohos:height="35vp"
        ohos:width="match_parent"/>

    <com.othershe.calendarview.weiget.CalendarView
        ohos:id="$+id:calendar"
        ohos:height="220vp"
        ohos:width="match_parent"/>
```
**Step 4. 相关初始化**
```java
CalendarView calendarView = (CalendarView) findComponentById(ResourceTable.Id_calendar);
//日历init，年月日之间用点号隔开
calendarView
        .setStartEndDate("2016.1", "2028.12")
        .setInitDate("2021.6")
        .setSingleDate("2017.6.9")
        .init();

//月份切换回调
calendarView.setOnPagerChangeListener(new OnPagerChangeListener() {
            @Override
            public void onPagerChanged(int[] date) {

            }
        });
        
//单选回调
calendarView.setOnSingleChooseListener(new OnSingleChooseListener() {
            @Override
            public void onSingleChoose(Component view, DateBean date) {
                
            }
        });

```
### CalendarView相关方法
|方法名|描述
|---|---|
|setInitDate(String date)|设置日历的初始显示年月
|setStartEndDate(String startDate, String endDate)|设置日历开始、结束年月
|setDisableStartEndDate(String startDate, String endDate)|设置日历的禁用日期范围（小于startDate、大于endDate禁用）
|setSpecifyMap(HashMap<String, String> map)|将显示农历的区域替换成指定文字
|setSingleDate(String date)|设置单选时初始选中的日期（不设置则不默认选中）
|getSingleDate()|得到单选时选中的日期
|setMultiDate(List<String> dates)|设置多选时默认选中的日期集合
|getMultiDate()|得到多选时选中的全部日期
|toSpecifyDate(int year, int month, int day)|单选时跳转到指定年月日
|setOnCalendarViewAdapter(int layoutId, CalendarViewAdapter adapter)|设置自定义日期item样式
|init()|日期初始化（以上属性配置完后调用）
|setOnPagerChangeListener(OnPagerChangeListener listener)|设置月份切换回调
|setOnSingleChooseListener(OnSingleChooseListener listener)|设置单选回调
|setOnMultiChooseListener(OnMultiChooseListener listener)|设置多选回调
|today()| 单选时跳转到今天
|nextMonth()|跳转到下个月
|lastMonth()|跳转到上个月
|nextYear()|跳转到下一年的当前月
|lastYear()|跳转到上一年的当前月
|toStart()|跳转到日历的开始年月
|toEnd()|跳转到日历的结束年月

### CalendarView的自定义属性
namespace：xmlns:calendarview="http://schemas.huawei.com/res/ohos-auto"

|属性名|格式|描述|默认值
|---|---|---|---|
|choose_type|int|设置单选（0）、多选(1)|0
|show_lunar|boolean|是否显示农历|true
|show_last_next|boolean|是否在MonthView显示上月和下月日期|true
|show_holiday|boolean|是否显示节假日|true
|show_term|boolean|是否显示节气|true
|switch_choose|boolean|单选时切换月份，是否选中上次的日期|true
|solar_color|color|阳历日期的颜色
|solar_size|integer|阳历的日期尺寸|14
|lunar_color|color|农历的日期颜色
|lunar_size|integer|农历的日期尺寸|8
|holiday_color|color|节假日、节气的颜色
|choose_color|color|选中的日期颜色
|day_bg|element|选中的日期背景(图片)

### WeekView的自定义属性
namespace：xmlns:weekview="http://schemas.huawei.com/res/ohos-auto"

|属性名|格式|描述|默认值
|---|---|---|---|
|week_str|String|周的表示形式，用点隔开（例如：日.一.二.三.四.五.六）
|week_color|color|周的颜色
|week_size|integer|周的尺寸|12



### 编译说明

1. 将项目通过git clone至本地
2. 使用DevEco Studio 打开该项目，然后等待Gradle 构建完成
3. 点击`Run`运行即可（真机运行可能需要配置签名）

### LICENSE

[Apache-2.0 License](LICENSE)