CalendarKit

Richard Topchii no Telegram

Calendarkit

O CalENDARKIT é uma biblioteca de interface do usuário do calendário rápida para o catalisador iOS e Mac. Parece semelhante ao aplicativo Apple Calendário pronto para uso, permitindo a personalização quando necessário. O calendário é composto por vários módulos que podem ser usados ​​juntos ou de forma independente.

Tutoriais

• Crie o aplicativo do calendário iOS em Swift com CalENDARKIT

Precisar de ajuda?

Se você tiver uma pergunta de programação sobre como usar o CalENDARKIT em seu aplicativo, crie um novo problema no GitHub com a tag de pergunta.

Confira o aplicativo de amostra para referência.

Crie um novo problema a partir do modelo para relatar um bug ou solicitar um novo recurso.

Exemplos

Vídeo

App de amostra

Instalação

O CalENDARKIT pode ser instalado com o Swift Package Manager ou com Cocoapods.

Swift Package Manager (Xcode 12 ou superior)

A maneira preferida de instalar o CalENDARKIT é através do Swift Package Manager.

1. No Xcode, abra seu projeto e navegue para arquivo → Pacotes Swift → Adicione dependência do pacote ...
2. Cole o URL do repositório ( https://github.com/richardtop/CalendarKit.git ) e clique em Avançar .
3. Para regras , selecione a versão (até a próxima principal) e clique em Avançar .
4. Clique em Concluir .

Adicionando dependências de pacotes ao seu aplicativo

Cocoapods

️ AVISO: O suporte dos Cocoapods é descontinuado e será removido posteriormente. É recomendável migrar sua instalação do CalENDARKIT para usar o Swift Package Manager.

Para instalá -lo, adicione a seguinte linha ao seu PODFILE:

 pod 'CalendarKit'

Adicionando pods a um projeto Xcode

Uso

1. Subclasse DayViewController
2. Implementar o protocolo EventDataSource para mostrar eventos.

O CalENDARKIT exige que EventDataSource retorne uma variedade de objetos em conformidade com o protocolo EventDescriptor , especificando todas as informações necessárias para exibir um evento específico. Você é livre para usar uma classe Event padrão como modelo ou criar sua própria classe em conformidade com o protocolo EventDescriptor .

// Return an array of EventDescriptors for particular date
override func eventsForDate ( _ date : Date ) -> [ EventDescriptor ] {
  var models = myAppEventStore . getEventsForDate ( date ) // Get events (models) from the storage / API

  var events = [ Event ] ( )

  for model in models {
      // Create new EventView
      let event = Event ( )
      // Specify DateInterval
      event . dateInterval = DateInterval ( start : model . startDate , end : model . endDate )
      // Add info: event title, subtitle, location to the array of Strings
      var info = [ model . title , model . location ]
      info . append ( " ( datePeriod . beginning! . format ( with : " HH:mm " ) ) - ( datePeriod . end! . format ( with : " HH:mm " ) ) " )
      // Set "text" value of event by formatting all the information needed for display
      event . text = info . reduce ( " " , { $0 + $1 + " n " } )
      events . append ( event )
  }
  return events
}

Depois de receber uma variedade de eventos para um dia específico, o CalENDARKIT lidará com o layout e a exibição da exibição.

Uso

Para responder à entrada do usuário, substitua os mehtods do DayViewDelegate , por exemplo:

 override func dayViewDidSelectEventView ( _ eventView : EventView ) {
  print ( " Event has been selected: ( eventview . data ) " )
}

override func dayViewDidLongPressEventView ( _ eventView : EventView ) {
  print ( " Event has been longPressed: ( eventView . data ) " )
} 

Localização

O CalENDARKIT suporta localização e usa o localidade padrão do iOS para exibir nomes de mês e diurno. O primeiro dia da semana também é selecionado de acordo com o iOS Locale.

Estilos

Por padrão, o CalENDARKIT se parece com o aplicativo Apple Calendar e suporta totalmente o Modo Dark. Se necessário, a aparência do calendário pode ser facilmente personalizada. As etapas para aplicar um estilo personalizado são as seguintes:

1. Crie um novo objeto CalendarStyle (ou copie um existente)
2. Mude o estilo, atualizando as propriedades.
3. Invoque o método updateStyle com o novo CalendarStyle .

 let style = CalendarStyle ( )
style . backgroundColor = UIColor . black
dayView . updateStyle ( style ) 

Requisitos

• iOS 11.0+, macOS (catalisador) 10.15+
• Swift 5.7+

Contribuindo

A lista de recursos atualmente em desenvolvimento pode ser visualizada na página de questões.

Antes de contribuir, revise as diretrizes e o estilo de código.

Autor

Richard Topchii

Licença

O CalENDARKIT está disponível sob a licença do MIT. Consulte o arquivo de licença para obter mais informações.