SwiftでXLFormのテキスト入力を使用する。

この記事は2018年11月07日に投稿しました。

f:id:paveway:20190914064630j:plain

1. はじめに

こんにちは、iOSのエディタアプリPWEditorの開発者の二俣です。
今回はPWEditorで使用しているXLFormライブラリのテキスト入力の使用方法です。

目次へ

2. 前提

この記事を参考にXLFormを使用できるようにしておいてください。

paveway.hatenablog.com

目次へ

3. XLFormのテキスト入力を使用する

この記事を参考にViewControllerを実装してください。

paveway.hatenablog.com

ボタンセル(row)の部分を、今回のテキスト入力のセルに差し替えてください。

/**
 テキスト入力のセルを作成します。
 */
func createTextRow() -> XLFormRowDescriptor {
    // タグを設定します。
    // 設定値は任意の文字列でかまいませんが、一意の文字列にしてください。
    let tag = "text"

    // XLFormRowDescriptorTypeをテキスト入力とします。
    let type = XLFormRowDescriptorTypeText

    // タイトルを設定します。
    let title = "テキスト"

    // テキスト入力のセルを作成します。
    let row = XLFormRowDescriptor(tag: tag, rowType: type, title: title)

    // 必須入力とします。
    // 必須入力とした場合、未入力だとformValidationErrors()が設定されます。
    row.isRequired = true

    // 入力文字列の位置はデフォルト左寄せになります。
    // 右寄せにしたい場合、以下の設定を行います。
　　 //row.cellConfigAtConfigure["textField.textAlignment"] =  NSTextAlignment.right.rawValue

    return row
}

/**
 テキストが入力されたチェックします。
 テキスト入力終了時の確定ボタン押下等で呼び出してください。
 */
func checkText() {
    // エラーがあるかチェックします。
    guard let array = formValidationErrors() else {
        return
    }

    // 必須入力のテキスト入力が複数あれば、エラーも複数設定されます。
    let errorCount = array.count
    if 0 < errorCount {
        //  エラーがある場合
        for errorItem in array {
            // エラー数分繰り返します。
            if let error = errorItem as? NSError {
                if let validationStatus = error.userInfo[XLValidationStatusErrorKey] as? XLFormValidationStatus, let row = validationStatus.rowDescriptor, row.tag == "text" {
                    // 対象のテキスト入力セルの場合
                    // 対象のテキスト入力セルかどうかはタグで判断します。
                    // オレンジ色でフラッシュ表示します。
                    if let rowDescriptor = validationStatus.rowDescriptor, let indexPath = form.indexPath(ofFormRow: rowDescriptor), let cell = tableView.cellForRow(at: indexPath) {
                        cell.backgroundColor = UIColor.orange
                        UIView.animate(withDuration: 0.3, animations: { () -> Void in
                            cell.backgroundColor = UIColor.white
                        })
                    }
                }
            }
        }
        return
    }
        
    // エラーがない場合、入力した値を取得します。
    let text: String
    // フォーム上の値はform.formValues()で取得します。
    let values = form.formValues() as NSDictionary
    if let textObj = values.object(forKey: "text")  {
        // 対象のテキストの値の場合(タグで識別します)
        if (textObj as AnyObject).isKind(of: NSNull.self) {
            // nilチェックし、nilの場合は空文字列とします(念のための処理)
            text = ""

        } else {
            // nilではない場合
            if let textString = textObj as? String {
                // 入力値がある場合
                text = textString

            } else {
                // 入力値がない場合(未入力チェック済みのため、念のための処理)
                text = ""
            }
        }

    } else {
        // 対象のテキストセルがない場合(年のための処理)
        text = ""
    }
}

目次へ

3. おわりに

未入力チェック後に入力された文字列を取得方法がわからず、いろいろ調べた記憶があります。

未入力エラーの場合、テキスト入力セルをオレンジでフラッシュ表示する処理は、XLFormのサンプルを参考にしています。
こういう処理はなかなか自分で思いつかないので、勉強になります。

お仕事決まれば全額キャッシュバック！転職特化型Ruby実践研修【ポテパンキャンプ】

たった2日でマスターできるiPhoneアプリ開発集中講座 Xcode 10 Swift 4.2対応

作者: 藤治仁,小林加奈子,小林由憲
出版社/メーカー: ソシム
発売日: 2018/10/22
メディア: 単行本
この商品を含むブログを見る

紹介している一部の記事のコードはGitlabで公開しています。
興味のある方は覗いてみてください。

目次へ

私が勤務しているニューラルでは、主に組み込み系ソフトの開発を行っております。
弊社製品のハイブリッドOS Bi-OSは高い技術力を評価されており、特に制御系や通信系を得意としています。
私自身はiOSモバイルアプリやウィンドウズアプリを得意としております。
ソフトウェア開発に関して相談などございましたら、お気軽にご連絡ください。

また一緒に働きたい技術者の方も随時募集中です。
興味がありましたらご連絡ください。

EMAIL : info-nr@newral.co.jp / m-futamata@newral.co.jp
TEL : 042-523-3663
FAX : 042-540-1688

目次へ