Commit: 80 - nova.ext (svn)

PHPのフレームワークです。オートローディング、ルーティング、ORマッパ、フォームバリデータ、その他ユーティリティがセットになっています。

Commit MetaInfo

• Révision: 80 (tree)
• l'heure: 2021-01-14 15:30:17
• Auteur: tantancode

Message de Log

HTML出力周りをちょっと見直した

Change Summary

• modified: lib/ViewUtil.php
• modified: lib/extension/form/NovaForm.php

Modification

--- lib/ViewUtil.php	(revision 79)
+++ lib/ViewUtil.php	(revision 80)
@@ -274,6 +274,7 @@
      * @param   属性名をキー、値を値とする配列。ViewUtil::attributes() に指定できる値。
      * @param   タグで挟みたい内容がある場合は指定する。この場合、終了タグも一緒に返される。
      *          省略した場合、返されるタグは閉じタグが省略されたもの( <xxxx /> の形式)になる。
+     *          配列を指定した場合は \n で連結された文字列に変換される。
      * @param   第三引数がすでにHTMLエンコード済みの場合は true を指定する。
      *          falseの場合はエンコードされる。
      * @return  作成したHTML。
@@ -285,6 +286,9 @@
         if( is_null($content) )
             return $tag . ' />';
 
+        if( is_array($content) )
+            $content = "\n" . implode("\n", $content) . "\n";
+
         if(!$encoded)
             $content = self::encode($content);
 
@@ -360,8 +364,8 @@
 
     //-----------------------------------------------------------------------------------------------------
     /**
-     * 引数に指定された情報で入力フォームの一項目を表すHTML文字列を作成する。<input> や <textarea> を始め、
-     * <option>を含む <select>、ラジオボタン・チェックボックスのグループにも対応する。
+     * 引数に指定された情報で入力フォームの一項目を表すHTML文字列を作成する。<input> や <textarea> を始め、ViewUtil::select() で説明されている
+     * 選択肢グループにも対応する。
      *
      * @param   基本的にはHTML要素の属性だが、以下のキーは特別に処理される。
      *              type            <input> の type 属性だが、次のいずれかの場合は特別に処理される。省略時は "text"。
@@ -381,7 +385,7 @@
      *              options         choice を指定するならそちらから生成できるので省略できる。
      *                              typeの値が select の場合、一つの <option> HTML文字列を1要素とした配列。
      *                              radios, checks の場合は、一つの <input> HTML文字列を1要素とした配列。
-     *              glue            typeの値が radios, checks の場合に、各選択肢をつなげるHTML。
+     *              glue            typeの値が radios, checks の場合に、各選択肢をつなげるHTML。省略時は "\n"。
      *              placeholder     普通に <input> の placeholder 属性だが、type=select の場合は一番先頭に位置
      *                              する value="" の <option> の見出し文字列となる。
      * @return  作成したHTML。
@@ -389,68 +393,15 @@
     public static function input($attributes) {
 
         // 種別を取り出す。
-        $type = @ArrayUtil::eject($attributes, 'type') ?: 'text';
+        $origtype = @ArrayUtil::eject($attributes, 'type') ?: 'text';
+        $type = strtolower($origtype);
 
-        // 選択肢から選ぶ項目の場合は...
-        if( in_array(strtolower($type), ['select', 'radios', 'checks']) ) {
+        // 種別 select, radios, checks はこちらで処理する。
+        if( in_array($type, ['select', 'radios', 'checks']) )
+            return static::select($type, $attributes);
 
-            // 引数に指定されている glue を取り出しておく。先に取り出さないと生成するHTMLに反映されてしまうので…
-            $glue = @ArrayUtil::eject($attributes, 'glue') ?? "\n";
-
-            // 引数の options が必要になるので取り出す。指定されていない場合は...
-            $options = @ArrayUtil::eject($attributes, 'options');
-            if( !isset($options) ) {
-
-                // 引数に指定されている value, choice を取り出す。
-                $value = @ArrayUtil::eject($attributes, 'value');
-                $choices = @ArrayUtil::eject($attributes, 'choice');
-                $format = @ArrayUtil::eject($attributes, 'label-format') ?? '%1$s';
-
-                // 種別によって分岐。options の値を作成する。
-                switch( strtolower($type) ) {
-
-                    case 'select':
-                        foreach($choices as $key => $label) {
-                            $pars = array('type'=>'option', 'value'=>$key, 'label'=>sprintf($format, $label, $key), 'selected'=>$key==$value);
-                            $options[] = self::choice($pars);
-                        }
-                        break;
-
-                    case 'radios':
-
-                        // 引数に指定されている属性を生かす形で選択肢を生成していく。
-                        $attributes['type'] = 'radio';
-                        foreach($choices as $key => $label) {
-                            $attributes['value'] = $key;
-                            $attributes['label'] = sprintf($format, $label, $key);
-                            $attributes['checked'] = $key == $value;
-                            $options[] = self::choice($attributes);
-                        }
-
-                        break;
-
-                    case 'checks':
-
-                        // name を少し加工して、フォーム送信時にPHPが配列として処理するようにする。
-                        if(@$attributes['name'])
-                            $attributes['name'] .= '[]';
-
-                        // 引数に指定されている属性を生かす形で選択肢を生成していく。
-                        $attributes['type'] = 'check';
-                        foreach($choices as $key => $label) {
-                            $attributes['value'] = $key;
-                            $attributes['label'] = sprintf($format, $label, $key);
-                            $attributes['checked'] = in_array($key, (array)$value);
-                            $options[] = self::choice($attributes);
-                        }
-
-                        break;
-                }
-            }
-        }
-
         // 日時系のコントロールを使うときに、valueをいつもの形式で指定できるように少し面倒を見てやる。
-        switch( strtolower($type) ) {
+        switch( $type ) {
 
             // "datetime-local" を使うときは、valueの日付と時刻の区切り文字を "T" にする必要がある。
             case 'datetime-local':  $attributes['value'] = preg_replace('/(?<=\d)\s+(?=\d)/', 'T', $attributes['value']);       break;
@@ -463,24 +414,8 @@
         }
 
         // 種別によって処理する。
-        switch( strtolower($type) ) {
+        switch($type) {
 
-            // <option>を含む <select>。
-            case 'select':
-
-                // 引数に指定されている placeholder を取り出して、指定されている場合は最初の選択肢として反映する。
-                $placeholder = @ArrayUtil::eject($attributes, 'placeholder');
-                if( isset($placeholder) )
-                    array_unshift( $options, self::choice(array('type'=>'option', 'value'=>'', 'label'=>$placeholder)) );
-
-                // <option>を改行でつなげて、<select> で囲む。
-                return ViewUtil::tag('select', $attributes, "\n".implode("\n", $options)."\n", true);
-
-            // ラジオボタン・チェックボックスのグループ。
-            case 'radios':
-            case 'checks':
-                return implode($glue, $options);
-
             // 単体チェックボックスを作成する場合。
             case 'check':
             case 'checkbox':
@@ -490,11 +425,11 @@
             // <textarea> を作成する場合。
             case 'textarea':
                 $value = @ArrayUtil::eject($attributes, 'value');
-                return ViewUtil::tag('textarea', $attributes, (string)$value);    // stringキャストしているのは、null の場合に閉じタグが出ないから。
+                return ViewUtil::tag('textarea', $attributes, (string)$value);    // stringキャストしているのは、null だったら閉じタグなしになってしまうため。
 
             // それ以外では <input> を生成する。
             default:
-                $attributes['type'] = $type;
+                $attributes['type'] = $origtype;
                 return ViewUtil::tag('input', $attributes);
         }
     }
@@ -501,9 +436,103 @@
 
     //-----------------------------------------------------------------------------------------------------
     /**
-     * 引数に指定された情報でセレクトボックスの <option> やチェックボックス・ラジオボタンなどの、選択肢を
-     * 示すHTML文字列を作成する。チェック・ラジオでは <label> も設定される。
+     * 引数に指定された情報で、セレクトボックスやラジオボタンのような選択肢グループを表すHTML文字列を作成する。
      *
+     * @param   種別。select, radios, checks のいずれか。
+     * @param   select の場合は<select>タグの属性、radios, checks では各<input>タグの属性だが、以下のキーは特別に処理される。
+     *              choice          選択肢の配列。options を指定した場合はそちらが優先される。
+     *                              キーでvalueを、値で選択肢名を指定する。選択肢名は次のキーで操作することも出来る。
+     *              label-format    choice の選択肢名を生成するときの sprintf フォーマット文字列。%1$ が値、%2$ がキーとなる。
+     *                              省略した場合は "%1$s"。
+     *              value           最初に選択状態になっている選択肢のキー。
+     *              options         choice を指定するならそちらから生成されるので省略できる。
+     *                              select の場合は一つの <option> HTML文字列を1要素とした配列。
+     *                              radios, checks の場合は一つの <input> HTML文字列を1要素とした配列。
+     *              glue            radios, checks の場合に、各選択肢をつなげるHTML。省略時は "\n"。
+     *              placeholder     select の場合は、一番先頭に位置する value="" の <option> の見出し文字列。
+     * @return  作成したHTML。
+     */
+    public static function select($type, $attributes) {
+
+        // 引数に指定されている choice, label-format, value, options, glue を取り出す。
+        $value = @ArrayUtil::eject($attributes, 'value');
+        $choices = @ArrayUtil::eject($attributes, 'choice');
+        $format = @ArrayUtil::eject($attributes, 'label-format') ?? '%1$s';
+        $options = @ArrayUtil::eject($attributes, 'options');
+        $glue = @ArrayUtil::eject($attributes, 'glue') ?? "\n";
+
+        // 種別によって分岐。
+        switch( strtolower($type) ) {
+
+            case 'select':
+
+                // options がない場合は choice や label-format などを見て生成する。
+                if( !isset($options) ) {
+
+                    foreach($choices as $key => $label) {
+                        $pars = array('type'=>'option', 'value'=>$key, 'label'=>sprintf($format, $label, $key), 'checkif'=>$value);
+                        $options[] = self::choice($pars);
+                    }
+
+                    // 引数に指定されている placeholder を取り出して、指定されている場合は最初の選択肢として追加する。
+                    $placeholder = @ArrayUtil::eject($attributes, 'placeholder');
+                    if( isset($placeholder) )
+                        array_unshift( $options, self::choice(array('type'=>'option', 'value'=>'', 'label'=>$placeholder)) );
+                }
+
+                // options を <select> で囲んでリターン。
+                return ViewUtil::tag('select', $attributes, $options, true);
+
+            case 'radios':
+
+                // options がない場合は choice や label-format などを見て生成する。
+                if( !isset($options) ) {
+
+                    // 引数に指定されている属性を生かす形で選択肢を生成していく。
+                    $attributes['type'] = 'radio';
+                    foreach($choices as $key => $label) {
+                        $attributes['value'] = $key;
+                        $attributes['label'] = sprintf($format, $label, $key);
+                        $attributes['checkif'] = $value;
+                        $options[] = self::choice($attributes);
+                    }
+                }
+
+                // glue で接続してリターン。
+                return implode($glue, $options);
+
+            case 'checks':
+
+                // options がない場合は choice や label-format などを見て生成する。
+                if( !isset($options) ) {
+
+                    // name を少し加工して、フォーム送信時にPHPが配列として処理するようにする。
+                    if(@$attributes['name'])
+                        $attributes['name'] .= '[]';
+
+                    // 引数に指定されている属性を生かす形で選択肢を生成していく。
+                    $attributes['type'] = 'check';
+                    foreach($choices as $key => $label) {
+                        $attributes['value'] = $key;
+                        $attributes['label'] = sprintf($format, $label, $key);
+                        $attributes['checkif'] = (array)$value;
+                        $options[] = self::choice($attributes);
+                    }
+                }
+
+                // glue で接続してリターン。
+                return implode($glue, $options);
+
+            default:
+                throw new ErrorException("定義されていない引数値 '{$type}' です。");
+        }
+    }
+
+    //-----------------------------------------------------------------------------------------------------
+    /**
+     * 引数に指定された情報でセレクトボックスの <option> やチェックボックス・ラジオボタンなどの、選択肢の一つを表すHTML文字列を作成する。
+     * チェック・ラジオでは <label> も設定される。
+     *
      * @param   HTML要素の属性だが、以下のキーは特別に処理される。
      *              type        以下のいずれか。省略時はラジオボタン
      *                              radio       ラジオボタン。デフォルト。
@@ -526,9 +555,9 @@
         // 選択肢名を取り出す。
         $label = @ArrayUtil::eject($attributes, 'label');
 
-        // checkif の処理。
+        // value属性の値が checkif の指定に含まれるなら選択状態にする。
         $checkif = @ArrayUtil::eject($attributes, 'checkif');
-        $selected = isset($checkif) && in_array(@$attributes['value'], (array)$checkif);
+        $checked = in_array(@$attributes['value'], (array)$checkif);
 
         // 種別に従って出力。
         switch( strtolower($type) ) {
@@ -544,17 +573,17 @@
                         $attributes['id'] = uniqid();
                 }
 
-                // value属性の値が checkif の指定に含まれるなら選択状態にする。
-                if( !isset($attributes['checked']) )  $attributes['checked'] = $selected;
+                // 選択状態にするかどうかを決定。
+                if( !isset($attributes['checked']) )  $attributes['checked'] = $checked;
 
                 // <input> タグを作成。
                 $attributes['type'] = $type;
                 $result = ViewUtil::tag('input', $attributes);
 
-                // 選択肢名があるならそれも続けて、<label> で囲む。
+                // 選択肢名があるなら <label> で囲む。
                 if(strlen($label) > 0) {
 
-                    // 同様に、<label> の for 属性も補う。
+                    // <label> の for 属性も補う。
                     // ただ、明示的に for 属性が指定されているならそちらを使う。jsでクローンするためにidやforを出したくないときなどに需要がある。
                     $for = $attributes['for'] ?? $attributes['id'];
                     $pair = $result . ViewUtil::encode($label);
@@ -565,8 +594,7 @@
 
             case 'option':
 
-                // value属性の値が checkif の指定に含まれるなら選択状態にする。
-                if( !isset($attributes['selected']) )  $attributes['selected'] = $selected;
+                if( !isset($attributes['selected']) )  $attributes['selected'] = $checked;
 
                 return ViewUtil::tag($type, $attributes, $label);
 

--- lib/extension/form/NovaForm.php	(revision 79)
+++ lib/extension/form/NovaForm.php	(revision 80)
@@ -749,8 +749,7 @@
 
     //-----------------------------------------------------------------------------------------------------
     /**
-     * 引数に指定されたFormItemインスタンスの getInputHtml(), getChoiceHtml() を見ながら、フォームでの項目
-     * を表すHTML文字列を作成する。
+     * 引数に指定されたFormItemインスタンスの getInputHtml(), getChoiceHtml() を見ながら、フォームでの項目を表すHTML文字列を作成する。
      *
      * @param   FormItemインスタンス
      * @param   ViewUtil::input() の引数と同じだが、基本的には type を指定するだけで良い。出力されるHTML要素に属性を設定したい場合はそれらを追加する
@@ -845,14 +844,14 @@
         foreach($this['items'] as $item) {
             $th = ViewUtil::tag('th', array(), $item['caption']);
             $td = ViewUtil::tag('td', array(), $item->scaffold(), true);
-            $rows[] = ViewUtil::tag('tr', array(), $th . "\n" . $td, true);
+            $rows[] = ViewUtil::tag('tr', array(), [$th, $td], true);
         }
 
-        return ViewUtil::tag('table', $params, implode("\n", $rows), true);
+        return ViewUtil::tag('table', $params, $rows, true);
     }
 
 
-    // 派生クラス向けユーティリティ。一応publicにしてあるが需要はないだろう。
+    // 一部のルールの処理を切り出したユーティリティメソッド。
     //=====================================================================================================
 
     //-----------------------------------------------------------------------------------------------------