|
|
|
|---|
|
|
|---|
#### Callbacks清单
* **onChange()**
当row的`value`改变时调用。你可以在这里调整一些参数，甚至显示或隐藏其他row。
* **onCellSelection()**
当用户点击row并且被选中的时候调用。
* **cellSetup()**
当cell第一次配置的时候调用，并且仅调用一次。可以在这做一些永久性的设置。
* **cellUpdate()**
当cell每次在屏幕上显示的时候调用。可以在里个更新外观。
* **onCellHighlightChanged()**
当cell或者里面的subview 成为或者辞去第一响应者 时调用。
* **onRowValidationChanged()**
当与row关联的验证错误改变时调用。
* **onExpandInlineRow()**
内联row展开前调用。适用于遵循`InlineRowType`协议的rows。
* **onCollapseInlineRow()**
内联row折叠前调用。适用于遵循`InlineRowType`协议的rows。
* **onPresent()**
在显示另外一个view controller之前调用。适用于遵循`PresenterRowType`的rows。可以在这里设置被显示的view controller。
### Section Header和Footer
你可以将`String`的title或者自定义的`View`作为`Section`的header或者footer。
#### String title
```swift
Section("Title")
Section(header: "Title", footer: "Footer Title")
Section(footer: "Footer Title")
```
#### 自定义View
你可以使用一个`.xib`作为自定义View：
```swift
Section() { section in
var header = HeaderFooterView
在这个例子里，我们隐藏或显示整个sections。
为了达到这个效果，每个row有一个`Condition`的可选类型的变量`hidden`，`Condition`可以通过`function`或者`NSPredicate`来设置。
#### 使用function condition来隐藏
使用`Condition`的`function` case:
```swift
Condition.function([String], (Form)->Bool)
```
`function`需要一个`Form`参数，并返回`Bool`，决定当前row是否需要隐藏。这是一个非常强大的设置`hidden`的方式，因为它没有明显的限制。
```swift
form +++ Section()
<<< SwitchRow("switchRowTag"){
$0.title = "Show message"
}
<<< LabelRow(){
$0.hidden = Condition.function(["switchRowTag"], { form in
return !((form.rowBy(tag: "switchRowTag") as? SwitchRow)?.value ?? false)
})
$0.title = "Switch is on!"
}
```
```swift
public enum Condition {
case function([String], (Form)->Bool)
case predicate(NSPredicate)
}
```
#### 使用NSPredicate隐藏
`hidden`也可以用NSPredicate来设置。在predicate string里面，你可以引用其他row的tags，然后决定一个row是否需要隐藏。
但是使用NSPredicate来设置`hidden`的方式只适用于其他rows的value继承自NSObject（String 和 Int 也适用，因为它们被桥接到OjbC对应的类型，但是enums不适用）
使用NSPredicate限制这么多，我们为什么要使用它呢？
因为它比function更简单、更短而且更易读。例如下面这个例子：
```swift
$0.hidden = Condition.predicate(NSPredicate(format: "$switchTag == false"))
```
我们还可以写的更简单，因为`Condition`遵循`ExpressibleByStringLiteral`：
```swift
$0.hidden = "$switchTag == false"
```
*注意：我们会在执行的时候把'$switchTag'替换成tag为switchTag的row的value。*
所以的rows都必须有一个tag，我们会用这个tag去找到对应的row，这样才能达到我们想要的效果。
我们也可以直接隐藏一个row：
```swift
$0.hidden = true
```
因为`Condition`遵循`ExpressibleByBooleanLiteral`.
如果不设置`hidden`变量，那么对应的rows就会一直显示。
##### Sections
对于section来说，也是一样的。我们也可以通过设置`hidden`属性来控制显示或隐藏。
##### 禁用rows
为了禁用rows，每个row有一个`disable`变量，也是`Condition`的可选类型。使用的方式跟`hidden`一样，所以要求每个row有一个tag。
Note that if you want to disable a row permanently you can also set `disabled` variable to `true`.
注意：如果你想永久的禁用一个row，可以把`disabled`设置为`true`.
### 列表类型的sections
为了显示一个列表选项，Eukera有一个特殊的section，叫做`SelectableSection`。
当创建`SelectableSection`的时候，你需要传入在选项中使用的row的类型和`selectionTyle`。`selectionTyle`是一个枚举，`multipleSelection` 或者 `singleSelection(enableDeselection: Bool)`（`enableDeselection`决定选中的rows是否可以取消选中）。
```swift
form +++ SelectableSection
#### 如何创建多值section
为了创建一个多值section，我们要使用`MultivaluedSection` ，而不是常规的`Section`。`MultivaluedSection`继承自`Section`，拥有一些额外的属性来设置多值section的行为。
让我们来看一个例子：
```swift
form +++
MultivaluedSection(multivaluedOptions: [.Reorder, .Insert, .Delete],
header: "Multivalued TextField",
footer: ".Insert adds a 'Add Item' (Add New Tag) button row as last cell.") {
$0.addButtonProvider = { section in
return ButtonRow(){
$0.title = "Add New Tag"
}
}
$0.multivaluedRowToInsertAt = { index in
return NameRow() {
$0.placeholder = "Tag Name"
}
}
$0 <<< NameRow() {
$0.placeholder = "Tag Name"
}
}
```
上面的代码演示了如何创建一个多值的section。在上面我们把insert, delete 和 reorder传给了`multivaluedOptions`。
`addButtonProvider`允许我们自定义button row，当点击这个button row并且`multivaluedOptions`包含`.Insert`的时候，就会添加一行。
`multivaluedRowToInsertAt`闭包在Eureka每次需要新的row插入的时候调用。为了提供一个row来插入到多值的section中，我们就要设置这个属性。Eureka传index作为闭包的参数。需要注意的是，我们可以返回任何类型的row，甚至自定义的row，即使在多数情况下多值section的rows都是同一类型的。
当我们创建多值section的时候，Eureka会自动添加button row。我们刚刚说到我们可以自定义button row的外观。默认情况下button row的左边有一个加号按钮，我们可以通过设置`showInsertIconInAddButton`属性来决定是否要显示加号按钮。
当创建一个可以插入的sections时，我们还需要更多的考虑。所以被添加到可插入的多值section的rows都应该放在Eureka通过点击按钮来插入的rows上面。我们可以在初始化section的时候，在最后一个闭包参数里添加额外的row，这样在点击button row的时候就会自动把要插入的rows放在最后面。
#### 编辑模式
默认情况下，Eureka只会在当表格中有含有MultivaluedSection的时候把tableView的`isEditing`设置为`true`，而且会在表格第一次显示时的`viewWillAppear`完成。
要了解更多如何使用多值section的相关信息，可以看下Eureka的示例程序，里面包含了多种用法。
### 验证
Eureka 2.0.0 内置了很多验证特性。
一个row有很多规则和一个用于决定rules是否需要验证的特定配置。
有很多规则是默认提供的，但是你也可以自己创建自己的规则。
默认提供的规则:
* RuleRequired
* RuleEmail
* RuleURL
* RuleGreaterThan, RuleGreaterOrEqualThan, RuleSmallerThan, RuleSmallerOrEqualThan
* RuleMinLength, RuleMaxLength
* RuleClosure
让我们看看如何设置验证规则。
```swift
override func viewDidLoad() {
super.viewDidLoad()
form
+++ Section(header: "Required Rule", footer: "Options: Validates on change")
<<< TextRow() {
$0.title = "Required Rule"
$0.add(rule: RuleRequired())
// 这也可以通过一个闭包来实现：如果验证通过，返回nil，否则返回一个ValidationError。
/*
let ruleRequiredViaClosure = RuleClosure
|
|
|
|
|
|
|
|
TextRow NameRow URLRow IntRow PhoneRow PasswordRow EmailRow DecimalRow TwitterRow AccountRow ZipCodeRow |
Picker在键盘上显示 |
row展开 |
picker一直显示 |
通过Alert的方式显示。 |
通过action sheet的方式显示。 |
push到一个新的controller。 |
像PushRow一样，但是允许多选。 |
|
|
通过picker view来显示通用类型选项 (也有Picker内联Row) |
## 安装
#### CocoaPods
[CocoaPods](https://cocoapods.org/) 是一个管理Cocoa项目的依赖。
在项目中的`Podfile`文件指定Eureka:
```ruby
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
use_frameworks!
pod 'Eureka'
```
然后运行下面的命令:
```bash
$ pod install
```
#### Carthage
[Carthage](https://github.com/Carthage/Carthage) 是一个简单的、分散的Cocoa依赖管理器。
在项目中的`Cartfile`文件文件指定Eureka:
```ogdl
github "xmartlabs/Eureka" ~> 4.0
```
#### 手动集成框架
* 在项目的根目录运行下列代码克隆Eureka，作为一个git [submodule](http://git-scm.com/docs/git-submodule)。
```bash
$ git submodule add https://github.com/xmartlabs/Eureka.git
```
* 克隆完成后，打开Eureka文件夹，然后把`Eureka.xcodeproj`拖动到Xcode项目的Project Navigator中
* 在Project Navigator选中`Eureka.xcodeproj`，检查deployment target是否跟应用的匹配
* 在Project Navigator选中你自己的项目，选择自己应用的target，然后选择在"General"选项卡，在`Embedded Binaries`点击加号
* 选择`Eureka.framework`，大功告成。
## 参与其中
* 如果你想贡献，请随时提交pull request。
* 如果你有新功能要求，请开一个issue。
* 如果你找到了一个bug，在提交新的issue之前，请先查看旧的issues。
* 如果你需要帮助，或者询问常见的问题，使用[StackOverflow]。（Tag `eureka-forms`）
**在贡献之前，请先查看[CONTRIBUTING](../CONTRIBUTING.md)文件了解更多信息。**
如果你在你的项目中使用了**Eureka**，我们很想听到这个消息。可以在[twitter]给我发消息。
## 作者
* [Martin Barreto](https://github.com/mtnBarreto) ([@mtnBarreto](https://twitter.com/mtnBarreto))
* [Mathias Claassen](https://github.com/mats-claassen) ([@mClaassen26](https://twitter.com/mClaassen26))
## 常见问题解答
#### 如果通过tag获取Row
我们可以通过调用`Form`暴露的下列方法来获取特定的row：
```swift
public func rowBy
](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=HRMAH7WZ4QQ8E)
# 更改日志
可以在[CHANGELOG.md](../CHANGELOG.md)文件中查看。