可用列類型 · October Cms 筆記

# 可用列類型 ### [](https://octobercms.com/docs/backend/lists#column-types)可用的列類型有多種列類型可用于**類型**設置，這些列類型控制列表列的顯示方式。除了下面指定的本機列類型之外，您還可以[定義自定義列類型](https://octobercms.com/docs/backend/lists#custom-column-types)。 * [文本](https://octobercms.com/docs/backend/lists#column-text) * [圖片](https://octobercms.com/docs/backend/lists#column-image) * [數](https://octobercms.com/docs/backend/lists#column-number) * [開關](https://octobercms.com/docs/backend/lists#column-switch) * [約會時間](https://octobercms.com/docs/backend/lists#column-datetime) * [日期](https://octobercms.com/docs/backend/lists#column-date) * [時間](https://octobercms.com/docs/backend/lists#column-time) * [自此以來的時間](https://octobercms.com/docs/backend/lists#column-timesince) * [時間緊張](https://octobercms.com/docs/backend/lists#column-timetense) * [選擇](https://octobercms.com/docs/backend/lists#column-select) * [關系](https://octobercms.com/docs/backend/lists#column-relation) * [部分的](https://octobercms.com/docs/backend/lists#column-partial) * [顏色選擇器](https://octobercms.com/docs/backend/lists#column-colorpicker) ### [](https://octobercms.com/docs/backend/lists#column-text)文本 `text`\-顯示一個文本列，左對齊 ~~~ full_name: label: Full Name type: text ~~~ 您還可以指定自定義文本格式，例如**Admin：Full Name（活動）** ~~~ full_name: label: Full Name type: text format: Admin:%s (active) ~~~ ### [](https://octobercms.com/docs/backend/lists#column-image)圖片 `image`\-使用內置的[圖像調整大小功能](https://octobercms.com/docs/services/image-resizing#resize-sources)顯示圖像。 ~~~ avatar: label: Avatar type: image sortable: false width: 150 height: 150 options: quality: 80 ~~~ 查看[影像縮放文檔](https://octobercms.com/docs/services/image-resizing#resize-sources)的詳細信息，什么圖像源的支持和什么[選項](https://octobercms.com/docs/services/image-resizing#resize-parameters)支持 ### [](https://octobercms.com/docs/backend/lists#column-number)數 `number`\-顯示一個數字列，右對齊 ~~~ age: label: Age type: number ~~~ 您還可以指定自定義數字格式，例如幣種**$ 99.00** ~~~ price: label: Price type: number format: $ %.2f ~~~ > **注：**這兩個`text`和`number`圓柱支撐的`format`屬性，該屬性遵循的格式規則的[PHP的sprintf（）函數](https://secure.php.net/manual/en/function.sprintf.php)。值必須是字符串。 ### [](https://octobercms.com/docs/backend/lists#column-switch)開關 `switch`\-顯示布爾列的打開或關閉狀態。 ~~~ enabled: label: Enabled type: switch ~~~ ### [](https://octobercms.com/docs/backend/lists#column-datetime)約會時間 `datetime`\-將列值顯示為格式化的日期和時間。下一個示例將日期顯示為**1975年12月25日，星期四，下午2：15**。 ~~~ created_at: label: Date type: datetime ~~~ 您還可以指定自定義日期格式，例如**1975年12月25日，星期四02:15:16 PM**： ~~~ created_at: label: Date type: datetime format: l jS \of F Y h:i:s A ~~~ 您可能還希望進行設置，`ignoreTimezone: true`以防止在顯示的日期和數據庫中存儲的日期之間進行時區轉換，因為默認情況下，后端時區首選項應用于顯示值。 ~~~ created_at: label: Date type: datetime ignoreTimezone: true ~~~ > **注：**該`ignoreTimezone`選項也適用于其他日期和時間相關的字段類型，包括`date`，`time`，`timesince`和`timetense`。 ### [](https://octobercms.com/docs/backend/lists#column-date)日期 `date`\-將列值顯示為日期格式**M j，Y** ~~~ created_at: label: Date type: date ~~~ ### [](https://octobercms.com/docs/backend/lists#column-time)時間 `time`\-將列值顯示為時間格式**g：i A** ~~~ created_at: label: Date type: time ~~~ ### [](https://octobercms.com/docs/backend/lists#column-timesince)自此以來的時間 `timesince`\-顯示從值到當前時間的人類可讀時間差。例如：**10分鐘前** ~~~ created_at: label: Date type: timesince ~~~ ### [](https://octobercms.com/docs/backend/lists#column-timetense)時間緊張 `timetense`\-使用當前日期的語法時態顯示24小時時間和日期。例如：**今天在12:49**，**昨天在4:00**或**2015年9月18日在14:33**。 ~~~ created_at: label: Date type: timetense ~~~ ### [](https://octobercms.com/docs/backend/lists#column-select)選擇 `select`\-允許使用自定義的select語句創建列。任何有效的SQL SELECT語句均可在此處使用。 ~~~ full_name: label: Full Name select: concat(first_name, ' ', last_name) ~~~ ### [](https://octobercms.com/docs/backend/lists#column-relation)關系 `relation`\-允許顯示相關的列，可以提供一個關系選項。此選項的值必須是模型上Active Record[關系](https://octobercms.com/docs/database/relations)的名稱。在下一個示例中，**名稱**值將轉換為在相關模型中找到的名稱屬性（例如：）`$model->name`。 ~~~ group: label: Group relation: groups select: name ~~~ 要顯示顯示相關記錄數的列，請使用該`useRelationCount`選項。 ~~~ users_count: label: Users relation: users useRelationCount: true ~~~ > **注意：**`relation`在列上使用該選項會將`select`ed列中的值加載到該列指定的屬性中。建議您為顯示關系數據的列命名，而不與現有模型屬性沖突，如以下示例所示： **最佳實踐：** ~~~ group_name: label: Group relation: group select: name ~~~ **不良實踐：** ~~~ # This will overwrite the value of $record->group_id which will break accessing relations from the list view group_id: label: Group relation: group select: name ~~~ ### [](https://octobercms.com/docs/backend/lists#column-partial)部分的 `partial`\-渲染部分，該`path`值可以引用部分視圖文件，否則將列名用作部分名。在部分變量中，這些變量可用：`$value`是默認單元格值，`$record`是用于該單元格的模型，并且`$column`是配置的類對象`Backend\Classes\ListColumn`。 ~~~ content: type: partial path: ~/plugins/acme/blog/models/comments/_content_column.htm ~~~ ### [](https://octobercms.com/docs/backend/lists#column-colorpicker)顏色選擇器 `colorpicker`\-顯示顏色選擇器列中的顏色 ~~~ color: label: Background type: colorpicker ~~~