# 可用列类型
### [](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
~~~
- 基本说明
- 基本操作
- October cms 安装
- 后台控制器路径
- 图标
- 获取安装网上的插件/主题
- 插件构造器使用
- 定时任务
- October后台控制器
- vscode编辑器
- ajax操作
- 使用
- ajax更新组件
- ajax属性API
- JavaScript API
- ajax综合使用
- 主题
- 多语言主题
- 安装市场主题
- 主题程序处理
- 主题
- 页面
- 部件
- 布局
- 内容
- 组件
- 媒体
- 主题表单操作
- 表单使用
- 表单后端程序处理
- 插件
- 自定义插件
- 插件说明
- 插件导航条
- 插件数据库设置
- 插件的设置管理
- 插件的配置文件config
- 组件
- app服务
- app容器
- 扩展行为
- 缓存
- Collection类
- Lazy Collections
- Collection方法
- 助手函数
- 数组助手函数
- 路径助手函数
- 玄乐助手函数
- 其他助手函数
- 错误与记录
- 事件处理
- HTML页面
- 文件与目录操作
- 散列和加密
- 邮件
- 邮件内容
- 邮件发送
- 分页
- 模板解析器
- 动态解析器语法
- 队列消息
- 请求与输入
- 响应
- 视图
- 路由器
- 配置
- 验证操作
- 处理错误消息
- 错误消息与视图
- 可用的验证规则
- 有条件的验证规则
- 验证数组
- 错误消息
- 自定义验证规则
- 模型操作
- 定义模型与其属性
- 检索模型
- 插入与更新
- 删除模型
- 查询范围
- 事件操作
- 关联操作
- 定义关系
- 关系类型
- 多肽关系
- 关系查询
- 渴望加载
- 插入模型
- 数据库操作
- 基本用法
- 数据表结构
- 查询连贯操作
- 结果检索
- select子句
- 插入更新
- where子句
- 排序，分组，限制和偏移
- 文件附件
- Collection操作
- 属性操作
- 系列化json
- 数据库属性
- 数据库行为
- 控制器
- 后台控制器定义
- 后台页面
- 后台组件
- 后台表单
- 表单组件
- 表单视图
- 表单行为
- 后台列表
- 列表行为
- 列表过滤器
- 可用列类型
- 关系行为
- 关系行为类型
- 扩展关系行为
- 列表排序操作
- 导入导出操作
- 用于与权限
- corlate模板修改
- 修改顶部导航
- laravel问题
- 控制器不存在
- 控制器
- 路由组
- laravel笔记
- laravel 安装
- 伪静态配置
- 依赖注入 & 控制器
- 中间件
- 路由文件
- 视图