视频模型
使用 @Power.VideoList()
方法,可调用模型类别为 “视频” 的内容列表。该模型适用于需要展示视频内容的场景,支持通过数据参数筛选视频,并通过显示参数自定义前端展示样式。通过灵活的配置,可以实现视频封面、标题、简介等信息的展示,适用于新闻视频、宣传视频、教学视频等多种场景的视频列表展示需求。
视频列表.cshtml
组件路径
/Views/_Common/Shared/视频列表.cshtml
数据参数
参数名 | 中文名 | 类型 | 控件类型 | 默认值 | 详细说明 |
---|---|---|---|---|---|
Count | 显示条数 | Int32 | Integer | 10 | 列表显示的内容数量。若启用分页(Paging=true ),此参数表示每页条数 |
Node | 节点筛选 | String | Text | Null | 支持传递节点标识符(如 "news" )、节点实体或节点ID(如 "[1,2]" ),多值用逗号分隔。示例:Node = "tpxw,spxw" 表示同时获取“图片新闻”和“视频新闻”节点下内容。 |
Paging | 分页开关 | Boolean | Boolean | false | 启用后需配合通用分页 组件生成页码 |
Tag | 标签筛选 | String | Text | Null | 按标签筛选,多值用逗号分隔(如 "热门,推荐" ) |
keyword | 关键词搜索 | String | Text | Null | 按关键词模糊匹配标题内容。 |
DateRange | 日期范围 | String | Text | Null | 动态时间筛选,支持 1d (1天)、1w (1周)、1m (1月)、1y (1年)。示例:DateRange = "2w" 表示最近两周内的内容。 |
IncludeChildNodes | 包含子节点 | Boolean | Boolean | true | 是否包含当前节点的子节点内容。例如,若 Node = "news",启用后会同时筛选“news”及其所有子节点(如“news/domestic”)。 |
Illustrated | 封面过滤 | Boolean | Boolean | false | 仅筛选带封面图片的内容 |
RefNode | 引用节点 | Boolean | Boolean | false | 是否包含通过“引用节点”关联的内容 |
ActualContentOnly | 实内容过滤 | Boolean | Boolean | false | 是否排除虚内容,仅显示实内容。 |
ExtendField | 扩展字段 | Boolean | Boolean | false | 是否注入扩展字段数据 |
Sort | 排序字段 | String | Text | "Priority,PublishTime" | 排序字段,支持多字段逗号分隔。常用字段:Priority (优先级)、PublishTime (发布时间)、Hits (点击数)。需与 SortOrder 一一对应。 |
SortOrder | 排序类型 | String | Text | "Desc,Desc" | 排序方向,支持多字段逗号分隔。Asc 为升序,Desc 为降序,与 Sort 一一对应 |
Interval | 间隔行数 | Int32 | Integer | 0 | 每隔指定行数插入分隔符(如间隔2行,则第3、6、9...行显示分隔样式)。 |
HighRank | 高排名行数 | Int32 | Integer | 0 | 高亮显示前N行(如置顶),通常配合CSS样式实现。 |
Split | 分隔行数 | Int32 | Integer | 0 | 将列表按指定行数分组(如每5行为一组,用于分栏布局)。 |
显示参数
参数名 | 中文名 | 类型 | 控件类型 | 默认值 | 详细说明 |
---|---|---|---|---|---|
TitleLength | 标题长度 | Int32 | Integer | 50 | 控制标题显示的最大字符数,超长部分会被截断并加上省略号(...)。 |
ImageWidth | 图片宽度 | Int32 | Integer | 320 | 控制封面图片的宽度(像素)。 |
ImageHeight | 图片高度 | Int32 | Integer | 240 | 控制封面图片的高度(像素)。 |
ShowDate | 是否显示发布时间 | Boolean | Boolean | false | 控制是否显示内容的发布时间。 |
DateFormat | 发布时间日期格式 | String | ComboBox | yyyy-MM-dd | 设置发布时间的显示格式,支持多种标准日期格式(如 "MM/dd" )。 |
ShowLinkTip | 是否显示链接提示 | Boolean | Boolean | true | 控制是否显示链接的悬浮提示。 |
LinkBlankTarget | 是否新窗口打开 | Boolean | Boolean | false | 控制链接是否在新窗口中打开(target="_blank" )。 |
调用示例
- 代码:
<ul class="videoList">
@Power.VideoList("视频列表", new { Node = "spxs", Count = 3, TitleLength = 50, ImageWidth = 400, ImageHeight = 225, RefNode = true })
</ul>
说明: 该代码调用
视频列表
组件,从标识符为spxs
的节点中获取3条视频内容,标题长度设置为50字符,封面图宽度为400像素,高度为225像素,同时包含通过引用节点关联的内容(RefNode=true
)。适用于展示视频内容列表,特别是在包含关联视频或多媒体资源的页面中。效果图:
视频标题列表.cshtml
组件路径
/Views/_Common/Shared/视频标题列表.cshtml
数据参数
参数名 | 中文名 | 类型 | 控件类型 | 默认值 | 详细说明 |
---|---|---|---|---|---|
Count | 显示条数 | Int32 | Integer | 10 | 列表显示的内容数量。若启用分页(Paging=true ),此参数表示每页条数 |
Node | 节点筛选 | String | Text | Null | 支持传递节点标识符(如 "news" )、节点实体或节点ID(如 "[1,2]" ),多值用逗号分隔。示例:Node = "tpxw,spxw" 表示同时获取“图片新闻”和“视频新闻”节点下内容。 |
Paging | 分页开关 | Boolean | Boolean | false | 启用后需配合通用分页 组件生成页码 |
Tag | 标签筛选 | String | Text | Null | 按标签筛选,多值用逗号分隔(如 "热门,推荐" ) |
keyword | 关键词搜索 | String | Text | Null | 按关键词模糊匹配标题内容。 |
DateRange | 日期范围 | String | Text | Null | 动态时间筛选,支持 1d (1天)、1w (1周)、1m (1月)、1y (1年)。示例:DateRange = "2w" 表示最近两周内的内容。 |
IncludeChildNodes | 包含子节点 | Boolean | Boolean | true | 是否包含当前节点的子节点内容。例如,若 Node = "news",启用后会同时筛选“news”及其所有子节点(如“news/domestic”)。 |
Illustrated | 封面过滤 | Boolean | Boolean | false | 仅筛选带封面图片的内容 |
RefNode | 引用节点 | Boolean | Boolean | false | 是否包含通过“引用节点”关联的内容 |
ActualContentOnly | 实内容过滤 | Boolean | Boolean | false | 是否排除虚内容,仅显示实内容。 |
ExtendField | 扩展字段 | Boolean | Boolean | false | 是否注入扩展字段数据 |
Sort | 排序字段 | String | Text | "Priority,PublishTime" | 排序字段,支持多字段逗号分隔。常用字段:Priority (优先级)、PublishTime (发布时间)、Hits (点击数)。需与 SortOrder 一一对应。 |
SortOrder | 排序类型 | String | Text | "Desc,Desc" | 排序方向,支持多字段逗号分隔。Asc 为升序,Desc 为降序,与 Sort 一一对应 |
Interval | 间隔行数 | Int32 | Integer | 0 | 每隔指定行数插入分隔符(如间隔2行,则第3、6、9...行显示分隔样式)。 |
HighRank | 高排名行数 | Int32 | Integer | 0 | 高亮显示前N行(如置顶),通常配合CSS样式实现。 |
Split | 分隔行数 | Int32 | Integer | 0 | 将列表按指定行数分组(如每5行为一组,用于分栏布局)。 |
显示参数
参数名 | 中文名 | 类型 | 控件类型 | 默认值 | 详细说明 |
---|---|---|---|---|---|
TitleLength | 标题长度 | Int32 | Integer | 50 | 控制标题显示的最大字符数,超长部分会被截断并加上省略号(...)。 |
ShowNumber | 是否显示序号 | Boolean | Boolean | false | 控制是否为每个条目添加序号(如“01”)。 |
NumberFormat | 序号的数字格式 | String | Text | "00" | 设置序号的格式,支持数字格式化字符串(如“00”显示为“01”,“000”显示为“001”)。 |
ShowNode | 是否显示所属节点 | Boolean | Boolean | false | 控制是否在标题旁显示所属节点名称(如 “[新闻] 文章标题”)。 |
NodePrefix | 所属节点前插入字符 | String | ComboBox | [ | 控制节点名称前插入的字符(如改为 <新闻> 需设置 NodePrefix="<" )。 |
NodeSuffix | 所属节点后插入字符 | String | ComboBox | ] | 控制节点名称后插入的字符(如改为 <新闻> 需设置 NodeSuffix=">" )。 |
ShowDate | 是否显示发布时间 | Boolean | Boolean | true | 控制是否显示内容的发布日期。 |
DateFormat | 发布时间日期格式 | String | ComboBox | yyyy-MM-dd | 设置发布日期的显示格式,支持标准日期格式(如 "MM/dd" )。 |
ShowRelation | 是否显示相关内容 | Boolean | Boolean | false | 控制是否显示关联内容的链接。 |
ShowHits | 是否显示点击数 | Boolean | Boolean | false | 控制是否显示文章的点击次数。 |
HitsSuffix | 点击数后插入字符 | String | ComboBox | 空 | 点击数后追加的文本(如设置为“次”,则显示为“1000次”)。 |
ShowLinkTip | 是否显示链接提示 | Boolean | Boolean | true | 控制是否在鼠标悬浮时显示链接提示。 |
LinkBlankTarget | 是否新窗口打开 | Boolean | Boolean | false | 控制链接是否在新窗口中打开(target="_blank" )。 |
调用示例
- 代码:
<ul class="infoList">
@Power.VideoList("视频标题列表", new { Count = 7, Node = "spxw", TitleLength = 54, DateFormat = "MM-dd" })
</ul>
说明: 该代码调用
视频标题列表
组件,从标识符为spxw
的节点中获取7条内容,标题长度设置为54字符,发布日期格式为MM-dd
。生成的视频标题列表将展示这些内容,适用于展示视频类信息的列表页面。效果图:
视频图文列表.cshtml
组件路径
/Views/_Common/Shared/视频图文列表.cshtml
数据参数
参数名 | 中文名 | 类型 | 控件类型 | 默认值 | 详细说明 |
---|---|---|---|---|---|
Count | 显示条数 | Int32 | Integer | 10 | 列表显示的内容数量。若启用分页(Paging=true ),此参数表示每页条数 |
Node | 节点筛选 | String | Text | Null | 支持传递节点标识符(如 "news" )、节点实体或节点ID(如 "[1,2]" ),多值用逗号分隔。示例:Node = "tpxw,spxw" 表示同时获取“图片新闻”和“视频新闻”节点下内容。 |
Paging | 分页开关 | Boolean | Boolean | false | 启用后需配合通用分页 组件生成页码 |
Tag | 标签筛选 | String | Text | Null | 按标签筛选,多值用逗号分隔(如 "热门,推荐" ) |
keyword | 关键词搜索 | String | Text | Null | 按关键词模糊匹配标题内容。 |
DateRange | 日期范围 | String | Text | Null | 动态时间筛选,支持 1d (1天)、1w (1周)、1m (1月)、1y (1年)。示例:DateRange = "2w" 表示最近两周内的内容。 |
IncludeChildNodes | 包含子节点 | Boolean | Boolean | true | 是否包含当前节点的子节点内容。例如,若 Node = "news",启用后会同时筛选“news”及其所有子节点(如“news/domestic”)。 |
Illustrated | 封面过滤 | Boolean | Boolean | false | 仅筛选带封面图片的内容 |
RefNode | 引用节点 | Boolean | Boolean | false | 是否包含通过“引用节点”关联的内容 |
ActualContentOnly | 实内容过滤 | Boolean | Boolean | false | 是否排除虚内容,仅显示实内容。 |
ExtendField | 扩展字段 | Boolean | Boolean | false | 是否注入扩展字段数据 |
Sort | 排序字段 | String | Text | "Priority,PublishTime" | 排序字段,支持多字段逗号分隔。常用字段:Priority (优先级)、PublishTime (发布时间)、Hits (点击数)。需与 SortOrder 一一对应。 |
SortOrder | 排序类型 | String | Text | "Desc,Desc" | 排序方向,支持多字段逗号分隔。Asc 为升序,Desc 为降序,与 Sort 一一对应 |
Interval | 间隔行数 | Int32 | Integer | 0 | 每隔指定行数插入分隔符(如间隔2行,则第3、6、9...行显示分隔样式)。 |
HighRank | 高排名行数 | Int32 | Integer | 0 | 高亮显示前N行(如置顶),通常配合CSS样式实现。 |
Split | 分隔行数 | Int32 | Integer | 0 | 将列表按指定行数分组(如每5行为一组,用于分栏布局)。 |
显示参数
参数名 | 中文名 | 类型 | 控件类型 | 默认值 | 详细说明 |
---|---|---|---|---|---|
TitleLength | 标题长度 | Int32 | Integer | 50 | 控制标题显示的最大字符数(中文按2字符计算),超长部分自动截断并添加省略号(...)。 |
ContentLength | 内容长度 | Int32 | Integer | 200 | 控制正文/简介的截断长度(按字符计算)。 |
DisplayNodeName | 显示节点名称 | Boolean | Boolean | False | 在标题前显示所属节点名称,格式为 [节点名] 标题 。 |
ImageWidth | 图片宽度 | Int32 | Integer | 200 | 封面图渲染宽度(像素单位),设置为 0 时按原始比例自适应。 |
ImageHeight | 图片高度 | Int32 | Integer | 150 | 封面图渲染高度(像素单位),建议与 ImageWidth 组合使用保持比例(如 300x200 )。 |
DisplayDateTime | 显示日期格式 | String | ComboBox | 空 | 自定义日期显示格式(如 "yyyy-MM-dd HH:mm" )。支持标准格式符(MM 月, dd 日, HH 24小时制等)。 |
LinkBlankTarget | 是否新窗口打开 | Boolean | Boolean | False | 统一控制所有文章链接的 target 属性,true 时强制 target="_blank" (覆盖节点设置)。 |
调用示例
- 代码:
<ul class="twList">
@Power.VideoList("视频图文列表", new { Node = "spxw", Count = 3, TitleLength = 100, DisplayDateTime = "yyyy-MM-dd", ImageWidth = 200, ImageHeight = 150 })
</ul>
说明: 该代码调用视频模型组件生成“视频图文列表”布局,从标识符为
spxw
的节点中筛选3条视频内容,配置参数包括:标题截断至100字符、日期格式化为yyyy-MM-dd
、封面图固定尺寸为200x150像素。适用于需要展示视频封面、标题及发布时间的场景,如视频新闻列表页。效果图: