DropdownSearch
DropdownSearch 是一个下拉菜单,允许您通过点击菜单选项或输入您自己的字符串在 UITextfield 中来选择一个字符串。通过选择输入字符串,您将过滤下菜单显示的选项,为用户提供简便的搜索机制。这是一个针对 SwiftUI 设计的组件。
安装
手动
- 将 UIElement.swift 和 DropdownSearch.swift 拷贝粘贴到您的 Xcode 项目中。
CocoaPods
- 安装CocoaPods的最新版本
gem install cocoapods
- 在终端中导航到您的Xcode项目的根目录并创建一个Podfile。您可以这样做
pod init
- 使用文本编辑器打开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
- 运行以下行
pod install
- 现在可以开始使用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许可的条款和条件下分发。