CalendarKit

Ричард Топчий на телеграмме

Календарькит

Calendarkit - это библиотека пользовательского интерфейса Swift Calendar для iOS и Mac Catalyst. Он выглядит похоже на приложение Apple Calendar из коробки, одновременно позволяя настройку при необходимости. Calendarkit состоит из нескольких модулей, которые можно использовать вместе или независимо.

Учебные пособия

• Создать приложение календаря iOS в Swift с Calendarkit

Нужна помощь?

Если у вас есть вопрос о программировании о том, как использовать Calendarkit в вашем приложении, создайте новую проблему GitHub с тегом вопроса.

Ознакомьтесь с примером примера для справки.

Создайте новую проблему из шаблона, чтобы сообщить об ошибке или запросить новую функцию.

Примеры

Видео

Пример приложения

Установка

Calendarkit может быть установлен с помощью Swift Package Manager или с кокоподами.

Swift Package Manager (xcode 12 или выше)

Предпочтительный способ установки Calendarkit - через диспетчер пакетов Swift.

1. В Xcode откройте свой проект и перейдите к файлу → Swift Packages → «Добавить зависимость от пакета ...
2. Вставьте URL -адрес репозитория ( https://github.com/richardtop/CalendarKit.git ) и нажмите «Далее» .
3. Для правил выберите версию (до следующего майора) и нажмите «Далее» .
4. Нажмите на отдел .

Добавление зависимостей пакета в ваше приложение

Кокопод

️ Предупреждение: поддержка кокопод устарела и будет удалена позднее. Рекомендуется перенести вашу установку Calendarkit на использование Swift Package Manager.

Чтобы установить его, добавьте следующую строку в свой Podfile:

 pod 'CalendarKit'

Добавление стручков в проект Xcode

Использование

1. Подкласс DayViewController
2. Реализовать протокол EventDataSource , чтобы показать события.

Calendarkit требует, чтобы EventDataSource вернул множество объектов, соответствующих протоколу EventDescriptor , указывая всю информацию, необходимую для отображения конкретного события. Вы можете использовать класс Event по умолчанию в качестве модели или создать свой собственный класс, соответствующий протоколу 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
}

После получения множества событий в течение определенного дня Calendarkit будет обрабатывать макет и отображение просмотра.

Использование

Чтобы ответить на ввод пользователя, переопределите Mehtods of DayViewDelegate , например:

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

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

Локализация

Calendarkit поддерживает локализацию и использует Locale iOS по умолчанию для отображения месяцев и дневных имен. Первый день недели также выбран в соответствии с местом iOS.

Стили

По умолчанию Calendarkit выглядит похоже на приложение Apple Calendar и полностью поддерживает Dark Mode. При необходимости внешний вид Calendarkit может быть легко настроен. Шаги для применения пользовательского стиля следующие:

1. Создайте новый объект CalendarStyle (или скопируйте существующий)
2. Изменить стиль, обновляя свойства.
3. Вызове метод updateStyle с новым CalendarStyle .

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

Требования

• iOS 11,0+, macOS (катализатор) 10.15+
• Свифт 5,7+

Внося

Список функций, находящихся в настоящее время в разработке, можно просмотреть на странице «Проблемы».

Прежде чем внести свой вклад, пожалуйста, просмотрите руководящие принципы и стиль кода.

Автор

Ричард Топчий

Лицензия

Calendarkit доступен по лицензии MIT. Смотрите файл лицензии для получения дополнительной информации.