編集テーブル

使い方

表形式でデータを編集可能なテーブルを表示します。罫線は行のみにつけられます。

「列になるアイテム」として「データ入力」カテゴリーのアイテムをセットしてください。

設定するパラメーター

タイトル

タイトル部分に置くアイテムを指定します。

ここには1つのアイテムしか置けません。タイトルが不要な場合は何もアイテムを置かなくても構いません。

特に設定しない場合、他より大きめの文字で表示されます。

説明文

説明文部分に置くアイテムを指定します。

ここには1つのアイテムしか置けません。説明文が不要な場合は何もアイテムを置かなくても構いません。

特に設定しない場合、他より小さめの文字で表示されます。

列になるアイテム

表の列になるアイテムを、列の数だけセットします。例えば3つのアイテムをセットすると、3列+行操作ボタン表示用の列で合計4列の表ができます。

アイテムは各セルに描画されます。

列になるアイテムのアイテム名は、テーブルのヘッダー名になります。

「文字列入力（１行）」のような、アイテム名をラベルとして表示するアイテムの場合、そのままだとヘッダーと各セルの両方にアイテム名が表示されてしまいます。それを避けるには、そのアイテムの「アイテム名を表示しない」パラメーターをオンにします。「アイテム名を表示しない」をオンにしても、ヘッダー側にはアイテム名が表示されます。

アイテムにレコードのフィールド値をセットする

このアイテムのパラメーターに、式で「表示するレコード」のフィールドを指定することができます。

例えばアイテムが「文字列入力（１行）」で、その初期値パラメーターに、式で　= タイトル と指定すると、レコードの「タイトル」フィールドの値がそのセルの入力初期値になります。

この時、式の書き方は = $1.タイトル のようにアクション番号経由でなく、単にフィールドだけを指定するようにしてください。

表示するレコード

表の行データになるレコードを指定します。

このレコードを指定する場合、ページ生成処理内でレコードを取得しておく必要があります。ページ生成処理でテーブルが完成し、サイト訪問者がページを表示する際には生成済みのテーブルを表示するので、サイト訪問者を待たせることはありません。

このパラメーターは省略することができます。その場合、ページ生成時点ではテーブルは空になります。 行追加ボタンを表示する設定であれば、空にしていてもユーザーが画面操作で行を追加することができます。 ページ内処理で「テーブルの表示内容をセットする」を実行することでテーブルデータをセットすることもできます。

ボタンの表示位置

「行追加」「行コピー」「行削除」をテーブルの右側に表示するか、左側に表示するかを選択します。

行追加ボタンを表示しない

行コピーボタンを表示しない

行削除ボタンを表示しない

「行追加」「行コピー」「行削除」を表示するかどうかを設定します。

チェックボックスをオン（チェック）にすると、そのボタンは表示されません。 表示したい場合はチェックボックスをオフ（チェックしない）にしてください。

「表示しない」設定にした場合、後からページ内処理で表示させることはできません。

3つともオフにしてもエラーにはなりませんが、その場合は見た目も機能も「シンプルテーブル」とほぼ同じになります。

列幅

幅を指定したい列がある場合に指定します。

マッピング形式で入力します。指定したい列の分だけ設定すればよく、指定がない列は自動的に幅が決まります。

「幅（単位付き）」には幅の値を式で指定します。ここでは単位指定も可能です。例えば 10 文字分であれば、"10" ではなく、"10rem" と入力します。単位をつけず数値だけ指定した場合は "px" とみなされます。

「アイテムID」には幅をセットする列のアイテムIDを指定します。

制限事項

• 以下の入力アイテムには対応していません。

  • 「ラジオボタン」
  • 「複数選択チェックボックス」

• 行追加ボタンで行を追加した場合、新しく追加された行の各入力アイテムの入力値は空になります。アイテムの初期値設定があってもその値は入りません。