1.0.4 • Published 4 years ago

simple-date-calendar v1.0.4

Weekly downloads
-
License
MIT
Repository
github
Last release
4 years ago

SimpleCalendar

SimpleCalendar, biblioteca simples de calendario para sua aplicação Web React/JS.

Funcionalidades!

  • Seleção de dias, mese e anos
  • Selecione ranges de datas
  • Suporte de idiomas (Inglês - en, Português - pt)
  • Nomes dos dias da semana (Full, Abrev. e Custom).
  • Symbolos HTML Code nos dias
  • Customização styles (Background, Font)

Instalação

instação utilizando npm ou yarn

$ yarn add simple-calendar
or
$ npm install simple-calendar

Importação:

import SimpleCalendar from "SimpleCalendar";

Uso

import React, { Component } from "react";
import SimpleCalendar from "simple-date-calendar";

class MyApp extends Component {
  states = {
    dates: [
      "2020-01-01",
      "2020-01-02",
      { date: "2020-01-21", bgColor: "#fff" },
      { date: "2020-01-12", bgColor: "#f5ff" }
    ]
  };

  render() {
    return (
      <div className="container">
        <SimpleCalendar
          locale="pt"
          dates={[this.state.dates]}
          initDate={"2020-12-31"}
          weekNamesAbrv
          enableSelectDays
          enableSelectDateNow
          customWeekNames={["A", "B", "C", "D", "E", "F", "G"]}
          onClickPrev={data => console.log(data)}
          onClickNext={data => console.log(data)}
          onClickDay={data => console.log(data)}
        />
      </div>
    );
  }
}

Importação Symbols

import Symbols, { getAll } from "simple-date-calendar/utils/Symbols";

Uso dos Symbolos

Para a utilização dos Symbolos HTML Code é preciso montar um objeto para as datas nas quais sera apresentado o symbolo.

Ex:

const dates = [
  { date: `2020-03-01`, icon: `Symbols.SNOWFLAKE` },
  { date: `2020-03-01`, icon: `<>&#9829;</>` }
];

HTML Codes W3Schools

Props

NomeDescriçãoPadrãoTipoRequiredRetorno
localeIdioma para os nomes de dias da semana e meses do ano não configura o UTCptstringnovoid
datesLista de datas para selecão inicial no calendário tipo "YYYY-MM-DD"[]arraynovoid
initDateData inicial para apresentação do Calendário, data atual como valor padrão"YYYY-MM-DD"Stringnovoid
enableSelectDaysHabilita a opção de selecionar os dias no calendário e remover os selecionadosfalsebooleannovoid
enableSelectDateNowHabilita se o dia atual inicia selecionadotruebooleannovoid
customWeekNamesCustomização nos nome dos dias das semana, obrigatório 7 items (string)[]arraynovoid
weekNamesAbrvAbrevia os nomes das Semana para 3 caracterefalsebooleannovoid
onClickPrevCallback para para o botão de Anterior <nullfunctionnoobject
onClickNextCallback para para o botão de Próximo >nullfunctionnoobject
onClickDayCallback para para o Click nos dias dos diasnullfunctionnoobject

Objeto de retorno para as funções de callback.

Obs: para os o callback das Arrows de Mes e Ano sempre retornará o dia 01, no caso do onClickDay retorna o dia selecionado.

    {
        date: "2020-04-14",
        day: 14,
        month: "Abril",
        year: 2020,
        cntDays: 30, 
        selects: [
            { date: "2020-03-01", ...props}
            { date: "2020-03-02", ...props}
            { date: "2020-03-03", ...props}
            "2020-02-15"
            "2020-03-24"
            "2020-04-14"
        ]
    }

Desenvolvimento

Licença

The MIT License. Free Software, Hell Yeah!

Autor

  • Alexanre H / @ayusuke7

Contribuções

  • Contribui ai mestre (y) !!!
1.0.4

4 years ago

1.0.3

4 years ago

1.0.2

4 years ago

1.0.1

4 years ago

1.0.0

4 years ago