開発者向け機能:サーバスクリプト:columns
## 概要
[サーバスクリプト](/ja/manual/table-management-server-script)で[項目](/ja/manual/table-management-column)の設定を取得、編集します。 [一覧画面](/ja/manual/table-grid)の[セルCSS](/ja/manual/table-management-extended-cell-css)の設定や[エディタ](/ja/manual/table-editor)の[フィールドCSS](/ja/manual/table-management-extended-field-css)、[拡張HTML](/ja/manual/table-management-extended-html)の設定などが可能です。
## プロパティ
|No|Name|Get|Set|Type|Description|
|:----|:----|:----|:----|:----|:----|
|1|ExtendedCellCss|○|○|string|[セルCSS](/ja/manual/table-management-extended-cell-css)|
|2|ExtendedFieldCss|○|○|string|[フィールドCSS](/ja/manual/table-management-extended-field-css)|
|3|ExtendedControlCss|○|○|string|[コントロールCSS](/ja/manual/table-management-extended-control-css)|
|4|ExtendedHtmlBeforeField|○|○|string|[拡張HTML](/ja/manual/table-management-extended-html)のフィールドの前|
|5|ExtendedHtmlBeforeLabel|○|○|string|[拡張HTML](/ja/manual/table-management-extended-html)のラベルの前|
|6|ExtendedHtmlBetweenLabelAndControl|○|○|string|[拡張HTML](/ja/manual/table-management-extended-html)のラベルとコントロールの間|
|7|ExtendedHtmlAfterControl|○|○|string|[拡張HTML](/ja/manual/table-management-extended-html)のコントロールの後|
|8|ExtendedHtmlAfterField|○|○|string|[拡張HTML](/ja/manual/table-management-extended-html)のフィールド後|
|9|Hide|○|○|bool|[非表示](/ja/manual/table-management-hide)、一覧画面では値が表示されない他、ExtendedCellCssおよびRawTextが無視されます。|
|10|SoftHide|○|○|bool|[非表示](/ja/manual/table-management-hide)、一覧画面では値が表示されませんが、ExtendedCellCssおよびRawTextは有効です。|
|11|ValidateRequired|○|○|bool|[入力必須](/ja/manual/table-management-required)|
|12|RawText|○|○|string|一覧画面の項目の値を置換|
|13|ReadOnly|○|○|bool|[読取専用](/ja/manual/table-management-readonly)|
## メソッド
|No|Name|Description|
|:----|:----|:----|
|1|[AddChoiceHash](/manual/server-script-columns-add-choice-hash)|[項目](/ja/manual/table-management-column)の[選択肢一覧](/ja/manual/table-management-choices-text)を動的に設定します。|
|2|[ClearChoiceHash](/manual/server-script-columns-clear-choice-hash)|[項目](/ja/manual/table-management-column)の[選択肢一覧](/ja/manual/table-management-choices-text)をクリアします。|
## 使用例①
以下の例では、ClassA(分類A)を非表示にします。
##### JavaScript(サーバスクリプト)
```
columns.ClassA.Hide = true;
```
## 使用例②
以下の例では、DescriptionA(説明A)を読取専用にします。
##### JavaScript(サーバスクリプト)
```
columns.DescriptionA.ReadOnly = true;
```
## 使用例③
以下の例では[一覧画面](/ja/manual/table-grid)の分類Aのセルに赤字でABCと出力します。条件に行表示の前を指定する必要があります。HTMLのタグを挿入可能です。
##### JavaScript(サーバスクリプト)
```
columns.ClassA.RawText = '<font color="red">ABC</font>';
```
## HideとSoftHideについて
どちらも項目を[非表示](/ja/manual/table-management-hide)にするプロパティですが、以下のような違いがあります。
### 編集画面で利用する場合(条件「画面表示の前」で実行)
HideとSoftHideに動作上の違いはありません。
|プロパティ|結果|備考|
|---|---|---|
|Hide|指定した項目は非表示|HTML上にはデータあり|
|SoftHide|指定した項目は非表示|HTML上にはデータあり|
#### 実行例
##### JavaScript(サーバスクリプト)
```
columns.ClassA.Hide = true;
columns.ClassB.SoftHide = true;
```
#### 結果

### 一覧画面で利用する場合(条件「行表示の前」で実行)
Hideは非表示になるのと合わせてExtendedCellCss、RawTextの設定が無視されますが、SoftHideの場合はExtendedCellCss、RawTextの設定内容は反映されます。
|プロパティ|結果|備考|
|---|---|---|
|Hide|指定した項目は非表示|HTML上にはデータあり|
|SoftHide|指定した項目は非表示|HTML上にはデータあり|
#### 実行例
##### JavaScript(サーバスクリプト)
```
//分類AはHide
columns.ClassA.Hide = true;
columns.ClassA.ExtendedCellCss = 'extended-cell-css';
columns.ClassA.RawText = 'raw-text';
//分類BはSoftHide
columns.ClassB.SoftHide = true;
columns.ClassB.ExtendedCellCss = 'extended-cell-css';
columns.ClassB.RawText = 'raw-text';
```
##### CSS
```
.grid-row > td.extended-cell-css {
background-color: pink;
}
```
#### 結果

## 対応バージョン
|対応バージョン|内容|
|:--|:--|
|1.1.38.0 以降|ExtendedHtmlBeforeLabelの追加<br>ExtendedHtmlBetweenLabelAndControlの追加<br>ExtendedHtmlAfterFieldの追加|
|1.2.15.0 以降|ValidateRequiredの追加|
|1.4.20.0 以降|SoftHideの追加|
## 関連情報
<div id="ManualList"><ul><li><a href="/ja/manual/table-grid">テーブル機能:レコードの一覧画面</a><span>2025/09/09 up</span></li>
<li><a href="/ja/manual/table-editor">テーブル機能:レコードのエディタ画面</a><span>2023/04/12 up</span></li></ul></article>
<ul><li><a href="/ja/manual/table-management-column">テーブルの管理:項目</a><span>2025/09/09 up</span></li></ul></article>
<ul><li><a href="/ja/manual/table-management-editor">テーブルの管理:エディタ</a><span>2024/04/09 up</span></li>
<li><a href="/ja/manual/table-management-editor-columns">テーブルの管理:エディタ:エディタの項目の設定</a><span>2024/12/19 up</span></li>
<li><a href="/ja/manual/table-management-required">テーブルの管理:エディタ:項目の詳細設定:入力必須</a><span>2024/12/19 up</span></li>
<li><a href="/ja/manual/table-management-readonly">テーブルの管理:エディタ:項目の詳細設定:読取専用</a><span>2023/04/25 up</span></li>
<li><a href="/ja/manual/table-management-choices-text">テーブルの管理:エディタ:項目の詳細設定:選択肢一覧</a><span>2023/10/12 up</span></li>
<li><a href="/ja/manual/table-management-choices-text-depts">テーブルの管理:エディタ:項目の詳細設定:選択肢一覧:組織</a><span>2023/04/25 up</span></li>
<li><a href="/ja/manual/table-management-choices-text-groups">テーブルの管理:エディタ:項目の詳細設定:選択肢一覧:グループ</a><span>2023/04/25 up</span></li>
<li><a href="/ja/manual/table-management-choices-text-users">テーブルの管理:エディタ:項目の詳細設定:選択肢一覧:ユーザ</a><span>2023/04/25 up</span></li>
<li><a href="/ja/manual/table-management-hide">テーブルの管理:エディタ:項目の詳細設定:非表示</a><span>2023/04/25 up</span></li>
<li><a href="/ja/manual/table-management-extended-field-css">テーブルの管理:エディタ:項目の詳細設定:フィールドCSS</a><span>2024/04/09 up</span></li>
<li><a href="/ja/manual/table-management-extended-control-css">テーブルの管理:エディタ:項目の詳細設定:コントロールCSS</a><span>2024/04/09 up</span></li>
<li><a href="/ja/manual/table-management-extended-html">テーブルの管理:エディタ:項目の詳細設定:拡張HTML</a><span>2024/05/30 up</span></li></ul></article>
<ul><li><a href="/ja/manual/table-management-extended-cell-css">テーブルの管理:一覧画面:項目の詳細設定:セルCSS</a><span>2024/12/19 up</span></li></ul></article>
<ul><li><a href="/ja/manual/table-management-server-script">テーブルの管理:サーバスクリプト</a><span>2025/05/13 up</span></li></ul></article>
<ul><li><a href="/ja/manual/dev-column-name">項目名とデータベース上のカラム名の対応</a><span>2024/12/19 up</span></li></ul></article>
<ul><li><a href="/ja/manual/server-script">開発者向け機能:サーバスクリプト</a><span>2023/06/01 up</span></li>
<li><a href="/ja/manual/server-script-columns-add-choice-hash">開発者向け機能:サーバスクリプト:columns.AddChoiceHash</a><span>2024/12/19 up</span></li>
<li><a href="/ja/manual/server-script-columns-clear-choice-hash">開発者向け機能:サーバスクリプト:columns.ClearChoiceHash</a><span>2023/06/21 up</span></li></ul></article>
<ul><li><a href="/ja/manual/faq-grid-cell-color-by-num-range">FAQ:一覧画面で数値の範囲によってセルの色を変えたい</a><span>2024/07/12 up</span></li></ul></article>
<ul><li><a href="/ja/manual/faq-server-script-log">FAQ:サーバスクリプトのエラーログを出力したい</a><span>2024/04/29 up</span></li></ul></article></div><input id="SearchTextHidden" type="hidden" value="" />