SHSearchBar

SHSearchBar

A barra de pesquisa limpa e brilhante que faz o que o UISearchBar faz apenas com hacks sujos. Esta visualização foi projetada para lidar com os limites de personalização do UISearchBar. A diferença aqui é que esta classe não herda UISearchBar mas compõe um novo objeto UIView usando um UITextField que é muito mais fácil de usar. Estes são os limites do UISearchBar:

• nenhuma maneira limpa de alinhar à esquerda o espaço reservado
• o botão cancelar é difícil de adaptar às suas necessidades
• geralmente a aparência não é personalizável (por exemplo, a fonte do texto)
• existem alguns comportamentos estranhos quando você define uma imagem de fundo personalizada

Como eu uso um UITextField, essas restrições não se aplicam.

Instalação

Gerenciador de pacotes Swift

No Xcode abra sua lista de alvos e selecione seu projeto. Clique na aba Swift Packages e lá no pequeno ícone + . Digite a URL deste repositório, selecione a versão que deseja instalar – geralmente a predefinição está correta – e confirme.

CocoaPods

Como o SHSearchBar usa recursos localizados, abandonei o suporte do CocoaPods em favor do SPM da versão 2.0.0 . Por favor, integre o pacote via SPM (veja acima).

Cartago

Como o SHSearchBar usa recursos localizados, abandonei o suporte ao Carthage em favor do SPM da versão 2.0.0 . Por favor, integre o pacote via SPM (veja acima).

Exemplos

O repositório inclui um projeto de exemplo. Ele mostra diferentes casos de uso da barra de pesquisa. Para executá-lo, basta abrir e executar ./Example/SHSearchBarExample.xcodeproj . As imagens a seguir mostram alguns casos de uso:

Você pode mostrar um espaço reservado personalizado como em campos de texto normais:

E você pode até digitar texto nessa barra de pesquisa:

Uau, também existem visualizações de acessórios personalizáveis:

Personalize facilmente o texto e o botão cancelar como desejar:

Você pode personalizar cada raio de canto do campo de texto para que layouts como este se tornem mais fáceis:

O campo de texto interno suporta o novo ‘textContentMode’ do iOS 10:
(Reutiliza o endereço pesquisado anteriormente no Apple Maps)

Você pode usar a barra de pesquisa dentro de um UINavigationBar:

Documentação de código

A documentação do código é gerada e hospedada pelo Swift Package Index (desenvolvido por DocC)

Liberar

Para lançar este pacote Swift, as seguintes etapas devem ser executadas:

• Crie uma nova ramificação release-xyz
• Execute bash <(curl -H -s https://raw.githubusercontent.com/Blackjacx/Scripts/master/frameworks/bootstrap.sh) para atualizar para os arquivos de desenvolvimento compartilhados mais recentes
• Execute bundle update para atualizar todas as gems Ruby
• Confirme todas as alterações, faça um PR e mescle-o para desenvolver
• Execute bundle exec fastlane release framework:"SHSearchBar" version:"xyz" para lançar a nova versão
• Poste o seguinte no Twitter

 SHSearchBar release x.y.z ?

▸   SHSearchBar (x.y.z) successfully published
▸ ?  September 2nd
▸ ?  https://swiftpackageindex.com/Blackjacx/SHSearchBar
▸ ?  https://github.com/Blackjacx/SHSearchBar/releases/latest
▸ ?  Tell your friends!

#spm #search #ios #apple #xcode #uisearchbar #swiftpackagemanager

Contribuição

• Se você encontrou um bug , abra um problema .
• Se você tiver uma solicitação de recurso , abra um problema .
• Se você quiser contribuir , envie uma solicitação pull .

Autor

Stefan Herold • ? @Blackjacxxx

Colaboradores

Obrigado a todos vocês que fazem parte disso:

Licença

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