所有文章

RxSwift 探索之旅 · 13

雙向綁定與 Driver

用 RxSwiftUtilities 的 TwoWayBinding 處理表單雙向綁定,以及專為 UI 設計的 Driver。

本篇目錄 · 6 個章節

Two Way Binding

這裡介紹一個在RxSwiftUtilities下的功能(或稱作擴充),很有機會用到,就是RxSwiftUtilities/TwoWayBinding.swift。

情境

試想一下,現在要做一個表單,有一個給使用者輸入的textField,跟存放TextField的資料的relay

今天是新增的表單,所以要把textField的資料帶入relay,你會這樣寫

let relay = BehaviorRelay<String?>(value: "")
textfield.rx.text.bind(to: viewModel.relay).disposed(by: disposeBag)

那如果今天是把一預設值帶入textField,你會這樣寫

let relay = BehaviorRelay<String?>(value: "Default value")
textField.rx.text.bind(to: relay).disposed(by: disposeBag)

又或是說,今天表單是建立在UITableView的Cell上,Cell會在滑動時進行reuse,所以,你需要同時符合上面兩個狀況,帶入預設值,使用者輸入時儲存在relay,在滑開時進行reuse會被清除,再次滑動到該Cell的時候再把值帶入,所以這方向會是雙向的。

TwoWayBinding

使用TwoWayBinding後,可以很輕易地達到雙向綁定的效果

let relay = BehaviorRelay<String?>(value: "Default value")
(textfield.rx.text <-> viewModel.relay).disposed(by: disposeBag)

同樣在UISwitch也能有一樣效果

let relay = BehaviorRelay<Bool>(value: true)
(uiswitch.rx.isOn <-> viewModel.relay).disposed(by: disposeBag)

自己常用到的情境是在UITableViewCell+UITextField的時候,覺得很好用。

接著講講Observable的變化型Driver。在Top mistakes in RxSwift you want to avoid - Code in a suit這篇文章中,新手常見錯誤之一就是『Not using drivers on UI』,加上前面研究過Scheduler,Driver其實滿重要的。

Driver

特色

Driver有幾個特色

  1. 只執行在MainScheduler
  2. 不處理.error
  3. 有shareReplay(1)的作用

看完這特性就知道Driver是用在UI上的,上面那篇文章的大大也提出一個準則

只要給ViewController或是UIView訂閱的Observable都應該使用Driver

使用

如果是將原本Observable改成Driver,基本上改兩個地方,比如說表示indicator是否在loading的isLoading

第一 把Observable改為Driver,並使用asDriver()轉成Driver

ViewModel.swift
let isLoading: Driver<Bool>
let indicator = ActivityIndicator()
isLoading = indicator.asDriver()

並不是每個都能直接使用轉換的,若是原先就有處理.error事件的,像是Subject,那再轉換成Driver時,就要定義當發生.error要如何進行處理,最簡單就是onErrorJustReturn

let subject = BehaviorSubject<String>(value: "A")
let driver = subject.asDriver(onErrorJustReturn: "B")

除此之外,像是Relay就能直接轉成Driver

第二 變成Driver就不是在使用bind(to: )了,需要把原本的bind(to: )改為drive()

ViewController.swift
viewModel.isLoading.drive(refreshControl.rx.isRefreshing).disposed(by: disposeBag)

不管是Operator還是Observable類型的選擇,個人覺得還是月精確越好,在閱讀上,一看就知道Driver基本上就提供UI訂閱的,除此之外也免去寫一些語法,減少人為犯錯機會。