CalendarKit

Richard Topchii en Telegram

Calendario

Calendarkit es una biblioteca de interfaz de usuario de calendario rápido para iOS y Mac Catalyst. Se parece a la aplicación Apple Calendar fuera de la caja, al tiempo que permite la personalización cuando es necesario. Calendarkit está compuesto por múltiples módulos que se pueden usar juntos o de forma independiente.

Tutoriales

• Crear aplicación de calendario iOS en Swift con Calendarkit

¿Necesitar ayuda?

Si tiene una pregunta de programación sobre cómo usar Calendarkit en su aplicación, cree un nuevo problema de GitHub con la etiqueta de preguntas.

Consulte la aplicación de muestra como referencia.

Cree un nuevo problema de la plantilla para informar un error o solicitar una nueva función.

Ejemplos

Video

Aplicación de muestra

Instalación

Calendarkit se puede instalar con Swift Package Manager o con Cocoapods.

Swift Package Manager (Xcode 12 o superior)

La forma preferida de instalar Calendarkit es a través del Swift Package Manager.

1. En XCode, abra su proyecto y navegue al archivo → paquetes Swift → Agregar dependencia del paquete ...
2. Pegue la URL del repositorio ( https://github.com/richardtop/CalendarKit.git ) y haga clic en Siguiente .
3. Para las reglas , seleccione la versión (hasta el siguiente mayor) y haga clic en Siguiente .
4. Haga clic en Finalizar .

Agregar dependencias de paquetes a su aplicación

Cocoapods

️ ADVERTENCIA: El soporte de Cocoapods está en desuso y se eliminará en una fecha posterior. Se recomienda migrar su instalación de Calendarkit para usar Swift Package Manager.

Para instalarlo, agregue la siguiente línea a su podfile:

 pod 'CalendarKit'

Agregar vainas a un proyecto XCode

Uso

1. Subclase DayViewController
2. Implemente el protocolo EventDataSource para mostrar eventos.

Calendarkit requiere que EventDataSource devuelva una variedad de objetos que se ajusten al protocolo EventDescriptor , especificando toda la información necesaria para mostrar un evento en particular. Usted es libre de usar una clase Event predeterminada como modelo o crear su propia clase que se ajuste al 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
}

Después de recibir una variedad de eventos para un día en particular, Calendarkit manejará el diseño y la visualización de la vista.

Uso

Para responder a la entrada del usuario, anule Mehtods de DayViewDelegate , por ejemplo:

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

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

Localización

Calendarkit admite la localización y utiliza la configuración nacional predeterminada de iOS para mostrar los nombres de los meses y del día. El primer día de la semana también se selecciona de acuerdo con la ubicación de iOS.

Estilos

Por defecto, Calendarkit se parece a la aplicación Apple Calendar y admite totalmente el modo oscuro. Si es necesario, el aspecto de Calendarkit se puede personalizar fácilmente. Los pasos para aplicar un estilo personalizado son los siguientes:

1. Cree un nuevo objeto CalendarStyle (o copie uno existente)
2. Cambie el estilo actualizando las propiedades.
3. Invocar el método updateStyle con el nuevo CalendarStyle .

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

Requisitos

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

Que contribuye

La lista de características actualmente en desarrollo se puede ver en la página de problemas.

Antes de contribuir, revise las pautas y el estilo de código.

Autor

Richard Topchii

Licencia

Calendarkit está disponible bajo la licencia MIT. Consulte el archivo de licencia para obtener más información.