iOSDropDown

Раскрывающийся список iOS

Выпадающий список с поиском для iOS

Это библиотека Swift для поддержки раскрывающегося меню в iOS.

Смотрите видео на:

Поддержка поиска и возврата правильного индекса

Настройка

Пример

Чтобы запустить пример проекта, клонируйте репозиторий и сначала запустите pod install из каталога примера.

Функции

1. Простое расширение UITextField и простое в использовании. Мы можем получить доступ ко всем свойствам UITextField.
2. DropDown Search можно включить или отключить.
3. Измените цвет фона списка, а также выбранный цвет.
4. Измените максимальную высоту списка и высоту каждой строки.

Установка

Менеджер пакетов Swift

Менеджер пакетов Swift — это инструмент для автоматизации распространения кода Swift, интегрированный в компилятор swift .

После настройки пакета Swift добавить iOSDropDown в качестве зависимости так же просто, как добавить его к значению dependencies вашего Package.swift .

dependencies: [
    . package ( url : " https://github.com/jriosdev/iOSDropDown.git " , . upToNextMajor ( from : " 0.4.0 " ) )
]

Какао-стручки

Используйте CocoaPods. iOSDropDown доступен через CocoaPods. Чтобы установить его, просто добавьте следующую строку в свой подфайл:

1. Добавьте pod 'iOSDropDown' в свой Podfile .
2. Установите модули, запустив pod install .
3. Добавьте iOSDropDown.framework на этапах сборки > Связывание двоичного файла с библиотеками
4. Добавьте import iOSDropDown в файлы .swift, где вы хотите его использовать.

Карфаген

Используйте Карфаген.

1. Создайте файл с именем Cartfile .
2. Добавьте строку github "jriosdev/iOSDropDown" .
3. Запустите carthage update .
4. Перетащите встроенный iOSDropDown.framework в свой проект Xcode.

Руководство

Просто клонируйте и добавьте в свой проект следующие файлы Swift:

• iOSDropDown.swfit

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

Метод раскадровки

Просто добавьте UITextField в свой ViewCONtroller и подключите @IBOutlet — класс DropDown.

 @ IBOutlet weak var dropDown : DropDown !

// The list of array to display. Can be changed dynamically
dropDown . optionArray = [ " Option 1 " , " Option 2 " , " Option 3 " ]
//Its Id Values and its optional
dropDown . optionIds = [ 1 , 23 , 54 , 22 ] 

// Image Array its optional
dropDown . ImageArray = [ ??‍? , ? , ? ]
// The the Closure returns Selected Index and String 
dropDown . didSelect { ( selectedText , index , id ) in
self . valueLabel . text = " Selected String: ( selectedText ) n index: ( index ) "
}

ИЛИ

Кодовый метод

 let  dropDown = DropDown ( frame : CGRect ( x : 110 , y : 140 , width : 200 , height : 30 ) ) // set frame

// The list of array to display. Can be changed dynamically
dropDown . optionArray = [ " Option 1 " , " Option 2 " , " Option 3 " ]
// Its Id Values and its optional
dropDown . optionIds = [ 1 , 23 , 54 , 22 ] 
// Image Array its optional
dropDown . ImageArray = [ ??‍? , ? , ? ]

// The the Closure returns Selected Index and String 
dropDown . didSelect { ( selectedText , index , id ) in
self . valueLabel . text = " Selected String: ( selectedText ) n index: ( index ) "
    }
}

Другие варианты

Действия

 dropDown . showList ( )  // To show the Drop Down Menu
 dropDown . hideList ( ) // To hide the Drop Down Menu

Замыкания

 listWillAppear ( ) {
  //You can Do anything when iOS DropDown willAppear 
 }

listDidAppear ( ) {
    //You can Do anything when iOS DropDown listDidAppear
}

listWillDisappear ( ) {
  //You can Do anything when iOS DropDown listWillDisappear 
}

 listDidDisappear ( ) {
  //You can Do anything when iOS DropDown listDidDisappear
}

Пользовательская функция фильтра

 // overridable function for filter action

   func searchFilter ( text : String , searchText : String ) -> Bool {
       // you can add custom filter fuctions as your need, like other than english ..etc
   } 

Настраивает iOSDropDown?

Вы можете настроить следующие свойства раскрывающегося списка:

• isSearchEnabled : вы можете включить или отключить раскрывающийся список. Значение по умолчанию — true
• hideOptionsWhenSelect : эта опция позволяет скрыть список при выборе первого элемента. Значение по умолчанию — true
• selectedRowColor : цвет выбранного элемента строки в раскрывающемся списке. Значение по умолчанию — .cyan
• rowBackgroundColor : цвет раскрывающегося списка. Значение по умолчанию — .white
• listHeight : максимальная высота списка. Значение по умолчанию — 150
• rowHeight : высота списка в списке. Значение по умолчанию — 30
• selectedIndex : для предварительного выбора любого элемента в списке.
• arrowSize : Размер стрелки. Значение по умолчанию — 15
• arrowColor : Цвет стрелки. Значение по умолчанию: .black
• checkMarkEnabled : флажок «Включено» для выбора строки. Значение по умолчанию — true
• textColor : вы можете изменить выбранный в раскрывающемся списке цвет текста.
• semanticContentAttribute : семантический атрибут для RTL или LTR.
• All Other TextField Properties are available with DropDown например alignment , font , textColor , semanticContentAttribute ... и т. д.

Примечание :

 1.After Update the pod just do clean your buld folder 
      Product > Clean Build Folder . 

Автор

Если вам понравился мой проект, пожалуйста, поставьте мне ЗВЕЗДУ на Github.

Если этот проект поможет вам сократить время разработки, не могли бы вы предложить чашечку кофе :)

Джишну Радж Т, [email protected]

Лицензия

iOSDropDown доступен по лицензии MIT. Дополнительную информацию смотрите в файле ЛИЦЕНЗИИ.