1.1.2 • Published 4 months ago

commit-calendar v1.1.2

Weekly downloads
-
License
ISC
Repository
github
Last release
4 months ago

commit-calendar

Introduce

A calendar which is like github commit calendar, but the data to be displayed is decided by yourself.

Quick Start

install

npm install commit-calendar

example

You can use this in your react project like this:

const Page = () => {
  const data = [
    { date: '2023-01-01', count: 2 },
    { date: '2023-01-02', count: 2 },
    { date: '2023-02-03', count: 1 },
    { date: '2023-05-11', count: 5 },
    { date: '2023-07-20', count: 10 },
    { date: '2023-09-10', count: 4 },
    { date: '2023-11-27', count: 3 },
  ]
  return (
    <>
      <!-- other codes -->
      <CommitCalendar dataSource={data} />
      <!-- other codes -->
    </>
  )
}

Then you will see the calendar: image

Props List

namemeaningtype
dataSourceArray containing date and countArray<{ date: any, count:number }>
optionsconfiguration of calendar stylesObject (see next part: Options)
yearwhich year to be displayednumber or string or Date

Options

range

Required. Including three segments:

  • bgColor: Array;
  • borderColor: Array;
  • minCount: Array;

weekLabelStyles

Optional. Including two segments:

  • color?: string;
  • fontSize?: string;

monthLabelStyles

Optional. Same with weekLabelStyles.

itemStyles

Optional. Including three segments:

  • bgColor?: string;
  • borderColor?: string;
  • borderRadius?: string;

footer

Optional. Including five segments:

  • bottomTip?: React.ReactNode;
  • lessText?: string;
  • moreText?: string;
  • lessTextColor?: string;
  • moreTextColor?: string;

Todo

  • enable choosing year
  • enable customizing color
  • supporting different locale

Change Log

v1.0.0 2023-12-25

  • :guitar: Finish basic commit-calendar component and publish to npmjs.com

v1.1.0 2023-12-29

  • :guitar: Support changing year
  • :bug: Fix cols displayed wrong

v1.1.1 2023-01-02

  • :guitar: Support custom styles

v1.1.2 2023-01-02

  • :pencil2: Update docs and publish homepage with git pages
1.1.1

4 months ago

1.1.2

4 months ago

1.1.0

4 months ago

1.0.0

5 months ago