DropdownSearch 1.0.1

DropdownSearch 1.0.1

Isabella Noriega维护。



  • Isabella Noriega

DropdownSearch

DropdownSearch 是一个下拉菜单,允许您通过点击菜单选项或输入您自己的字符串在 UITextfield 中来选择一个字符串。通过选择输入字符串,您将过滤下菜单显示的选项,为用户提供简便的搜索机制。这是一个针对 SwiftUI 设计的组件。

观看这个演示! 观看视频

安装

手动

  1. 将 UIElement.swift 和 DropdownSearch.swift 拷贝粘贴到您的 Xcode 项目中。

CocoaPods

  1. 安装CocoaPods的最新版本
gem install cocoapods
  1. 在终端中导航到您的Xcode项目的根目录并创建一个Podfile。您可以这样做
pod init
  1. 使用文本编辑器打开Podfile并指定您想要使用的pods。这里有一个例子
target 'YourProjectName' do

  # Pods for YourProjectName
  pod 'DropdownSearch', :git => 'https://github.com/isabellanoriega99/DropdownSearch.git', :tag => '1.0.0'
  # The 'tag' refers to the version wanted
end
  1. 运行以下行
pod install
  1. 现在可以开始使用Pod了!

使用方法

DropdownSearch是一个UI组件,应根据需要使用。以下提供了如何实现和使用它的结构。

DropdownSearch(stringToCollect: Binding<String>, placeholderText: String, options: [String],
               dropdownWidth: CGFloat, dropdownColor: Color, textfieldWidthPercentage: CGFloat,
               UIElementHeightPercentage: CGFloat)

变量定义

  • stringToCollect:与UITextfield的用途一样,DropdownSearch的设计也是为了传递输入的字符串。用户必须提供一个 @State/@Published var String 来引用来自菜单的 stringToCollect。
  • placeholderText:在Textfield中显示的占位符文本。
  • options:创建一个包含您想在菜单中显示的选项的字符串数组。
  • dropdownWidth:建议的值是 ~ 0.1-1.0 ~。这属于下拉菜单将要占据的屏幕宽度百分比。
  • dropdownColor:从Swift UI提供的颜色中选择或自定义颜色,为下拉菜单添加颜色。
  • textfieldWidthPercetage:建议的值是 ~ 0.1-1.0 ~。这属于Textfield将要占据的屏幕宽度百分比。
  • UIElementHeightPercentage:建议的值是 ~ 0.1-1.0 ~。这属于DropdownSearch组件将要占据的屏幕高度百分比。此值直接控制菜单在不滚动的情况下显示的项目数量。

更多内容,请参阅提供的示例。

许可

此代码在MIT许可的条款和条件下分发。