iOSDropDown

Menu suspenso do iOS

Menu suspenso com pesquisa para iOS

É uma biblioteca Swift para oferecer suporte ao menu suspenso no iOS

Assista ao vídeo em:

Suporte para pesquisa e retorno do índice correto

Personalização

Exemplo

Para executar o projeto de exemplo, clone o repositório e execute pod install primeiro no diretório de exemplo.

Características

1. Extensão UITextField simples e fácil de usar, podemos acessar todas as propriedades do UITextField
2. A pesquisa suspensa pode ser ativada ou desativada
3. Altere a cor de fundo da lista e também a cor selecionada
4. Altere a altura máxima da Lista e a altura de cada Linha

Instalação

Gerenciador de pacotes Swift

O Swift Package Manager é uma ferramenta para automatizar a distribuição de código Swift e está integrado ao compilador swift .

Depois de configurar seu pacote Swift, adicionar iOSDropDown como uma dependência é tão fácil quanto adicioná-lo ao valor de dependencies de seu Package.swift .

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

CocoaPods

Utilize CocoaPods. iOSDropDown está disponível através do CocoaPods. Para instalá-lo, basta adicionar a seguinte linha ao seu Podfile:

1. Adicione pod 'iOSDropDown' ao seu Podfile .
2. Instale o(s) pod(s) executando pod install .
3. Adicione iOSDropDown.framework em Build Phases > Vincular binário com bibliotecas
4. Adicione import iOSDropDown nos arquivos .swift onde você deseja usá-lo

Cartago

Use Cartago.

1. Crie um arquivo com o nome Cartfile .
2. Adicione a linha github "jriosdev/iOSDropDown" .
3. Execute carthage update .
4. Arraste o iOSDropDown.framework criado para o seu projeto Xcode.

Manual

Basta clonar e adicionar os seguintes arquivos Swift ao seu projeto:

• iOSDropDown.swfit

Uso básico

Método StoryBoard

Basta adicionar UITextField ao seu ViewCOntroller e conectar @IBOutlet - classe 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 ) "
}

OU

Método de código

 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 ) "
    }
}

Outras opções

Ações

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

Fechamentos

 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
}

Função de filtro personalizado

 // 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
   } 

Personaliza iOSDropDown?

Você pode personalizar estas propriedades do menu suspenso:

• isSearchEnabled : você pode ativar ou desativar no DropDown. O valor padrão é true
• hideOptionsWhenSelect : Esta opção para ocultar a lista ao clicar na opção um item. O valor padrão é true
• selectedRowColor : cor do item da linha selecionada no menu suspenso. O valor padrão é .cyan
• rowBackgroundColor : Cor do DropDown O valor padrão é .white
• listHeight : a altura máxima da lista. O valor padrão é 150
• rowHeight : a altura da lista na lista. O valor padrão é 30
• selectedIndex : Para pré-seleção de qualquer item da lista
• arrowSize : O tamanho da seta. O valor padrão é 15
• arrowColor : A cor da seta. O valor padrão é .black
• checkMarkEnabled : A marca de seleção habilitada para seleção da linha. O valor padrão é true
• textColor : você pode alterar a cor do texto selecionada no menu suspenso
• semanticContentAttribute : atributo semântico para RTL ou LTR
• All Other TextField Properties are available with DropDown como alignment , font , textColor , semanticContentAttribute ... etc.

Observação :

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

Autor

Se você gosta do meu projeto, por favor me dê uma ESTRELA no Github

Se este projeto te ajudar a reduzir o tempo de desenvolvimento, você pode oferecer uma xícara de café :)

Jishnu Raj T, [email protected]

Licença

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