WebFuture 模板技术中心WebFuture 模板技术中心
首页
  • WebFuture

    • 概述
    • 网站部署
  • 帮助

    • 本站指南
  • 概述
  • 模板组成和目录
  • 模板编辑与管理
  • 模板相关功能清单
  • 模板命名规范
  • 标准模板库
  • 模板制作流程
  • 模板方案打包

    • 模板方案打包要求
    • 模板打包工具使用说明
    • 模板方案导入与站点应用
  • 附件

    • 规范命名对照表
  • 概述
  • 视图与组件
  • 组件使用示例
  • 内容模块常用组件

    • 文章模型
    • 图片模型
    • 视频模型
    • 内容模型
    • 公开信息模型
    • 档案模型
  • 功能模块常用组件

    • 站点类
    • 节点类
    • 广告类
    • 便民咨询类
    • 信访类
    • 问卷投票类
    • 值班管理
    • 扩展字段
  • 进阶应用

    • 应用:字段在列表页筛选
    • 应用:引导页后渐隐显示首页
  • 通用对象
  • 通用URL生成对象
  • 通用字符处理对象
  • 请求上下文对象
  • 数据传递对象
  • 一般URL生成对象
数据结构
  • 概述
  • 从WebFuture系统升级
  • 从SiteAzure系统迁移
常见问题
×
首页
  • WebFuture

    • 概述
    • 网站部署
  • 帮助

    • 本站指南
  • 概述
  • 模板组成和目录
  • 模板编辑与管理
  • 模板相关功能清单
  • 模板命名规范
  • 标准模板库
  • 模板制作流程
  • 模板方案打包

    • 模板方案打包要求
    • 模板打包工具使用说明
    • 模板方案导入与站点应用
  • 附件

    • 规范命名对照表
  • 概述
  • 视图与组件
  • 组件使用示例
  • 内容模块常用组件

    • 文章模型
    • 图片模型
    • 视频模型
    • 内容模型
    • 公开信息模型
    • 档案模型
  • 功能模块常用组件

    • 站点类
    • 节点类
    • 广告类
    • 便民咨询类
    • 信访类
    • 问卷投票类
    • 值班管理
    • 扩展字段
  • 进阶应用

    • 应用:字段在列表页筛选
    • 应用:引导页后渐隐显示首页
  • 通用对象
  • 通用URL生成对象
  • 通用字符处理对象
  • 请求上下文对象
  • 数据传递对象
  • 一般URL生成对象
数据结构
  • 概述
  • 从WebFuture系统升级
  • 从SiteAzure系统迁移
常见问题
  • 系统组件

    • 概述
    • 视图与组件
    • 组件使用示例
  • 内容模块常用组件

    • 文章模型
    • 图片模型
    • 视频模型
    • 内容模型
    • 公开信息模型
    • 档案模型
  • 功能模块常用组件

    • 站点类
    • 节点类
    • 广告类
    • 便民咨询类
    • 信访类
    • 问卷投票类
    • 扩展字段
  • 进阶应用

    • 字段在列表页筛选
    • 引导页后渐隐显示首页

图片模型

@Power.PhotoList() 是一个用于调用 “图片” 类型内容列表的常用组件。它广泛应用于展示图片类内容,能够支持按不同的筛选条件(如节点、数量、标题长度、日期格式等)展示图片列表。该模型适用于新闻图片集、专题图文、图片展示等多种场景,能够通过设置不同的参数来满足各种展示需求。

图片列表.cshtml

组件路径

/Views/_Common/Shared/图片列表.cshtml

数据参数

参数名中文名类型控件类型默认值详细说明
Count显示条数Int32Integer10列表显示的内容数量。若启用分页(Paging=true),此参数表示每页条数
Node节点筛选StringTextNull支持传递节点标识符(如 "news")、节点实体或节点ID(如 "[1,2]"),多值用逗号分隔。示例:Node = "tpxw,spxw" 表示同时获取“图片新闻”和“视频新闻”节点下内容。
Paging分页开关BooleanBooleanfalse启用后需配合通用分页组件生成页码
Tag标签筛选StringTextNull按标签筛选,多值用逗号分隔(如 "热门,推荐")
keyword关键词搜索StringTextNull按关键词模糊匹配标题内容。
DateRange日期范围StringTextNull动态时间筛选,支持 1d(1天)、1w(1周)、1m(1月)、1y(1年)。示例:DateRange = "2w" 表示最近两周内的内容。
IncludeChildNodes包含子节点BooleanBooleantrue是否包含当前节点的子节点内容。例如,若 Node = "news",启用后会同时筛选“news”及其所有子节点(如“news/domestic”)。
Illustrated封面过滤BooleanBooleanfalse仅筛选带封面图片的内容
RefNode引用节点BooleanBooleanfalse是否包含通过“引用节点”关联的内容
ActualContentOnly实内容过滤BooleanBooleanfalse是否排除虚内容,仅显示实内容。
ExtendField扩展字段BooleanBooleanfalse是否注入扩展字段数据
Sort排序字段StringText"Priority,PublishTime"排序字段,支持多字段逗号分隔。常用字段:Priority(优先级)、PublishTime(发布时间)、Hits(点击数)。需与 SortOrder 一一对应。
SortOrder排序类型StringText"Desc,Desc"排序方向,支持多字段逗号分隔。Asc 为升序,Desc 为降序,与 Sort 一一对应
Interval间隔行数Int32Integer0每隔指定行数插入分隔符(如间隔2行,则第3、6、9...行显示分隔样式)。
HighRank高排名行数Int32Integer0高亮显示前N行(如置顶),通常配合CSS样式实现。
Split分隔行数Int32Integer0将列表按指定行数分组(如每5行为一组,用于分栏布局)。

显示参数

参数名中文名类型控件类型默认值详细说明
TitleLength标题长度Int32Integer50控制标题显示的最大字符数(中文按2字符计算),超长部分自动截断并添加省略号(...)
ImageWidth图片宽度Int32Integer320封面图渲染宽度(像素单位),设置为 0 时按原始比例自适应,建议与高度组合使用保持比例
ImageHeight图片高度Int32Integer240封面图渲染高度(像素单位),设置为 0 时按原始比例自适应
ShowLinkTip是否显示链接提示BooleanBooleanTrue控制鼠标悬停链接时是否显示悬浮提示(通常显示标题或自定义提示内容)
LinkBlankTarget是否新窗口打开BooleanBooleanFalse统一控制所有文章链接的打开方式,True 时强制在新标签页打开(target="_blank")

调用示例

  • 代码:
<ul class="picList">
    @Power.PhotoList("图片列表", new { Count = 6, Node = "xwtp", TitleLength = 90, ImageWidth = 320, ImageHeight = 240 })
</ul>
  • 说明: 通过图片模型组件生成图片列表,取"xwtp"栏目6条数据,标题截断长度扩展为90字符,图片尺寸固定为320x240像素,需配套CSS样式且栏目代码需替换为实际值。

  • 效果图:

图片标题列表.cshtml

组件路径

/Views/_Common/Shared/图片标题列表.cshtml

数据参数

参数名中文名类型控件类型默认值详细说明
Count显示条数Int32Integer10列表显示的内容数量。若启用分页(Paging=true),此参数表示每页条数
Node节点筛选StringTextNull支持传递节点标识符(如 "news")、节点实体或节点ID(如 "[1,2]"),多值用逗号分隔。示例:Node = "tpxw,spxw" 表示同时获取“图片新闻”和“视频新闻”节点下内容。
Paging分页开关BooleanBooleanfalse启用后需配合通用分页组件生成页码
Tag标签筛选StringTextNull按标签筛选,多值用逗号分隔(如 "热门,推荐")
keyword关键词搜索StringTextNull按关键词模糊匹配标题内容。
DateRange日期范围StringTextNull动态时间筛选,支持 1d(1天)、1w(1周)、1m(1月)、1y(1年)。示例:DateRange = "2w" 表示最近两周内的内容。
IncludeChildNodes包含子节点BooleanBooleantrue是否包含当前节点的子节点内容。例如,若 Node = "news",启用后会同时筛选“news”及其所有子节点(如“news/domestic”)。
Illustrated封面过滤BooleanBooleanfalse仅筛选带封面图片的内容
RefNode引用节点BooleanBooleanfalse是否包含通过“引用节点”关联的内容
ActualContentOnly实内容过滤BooleanBooleanfalse是否排除虚内容,仅显示实内容。
ExtendField扩展字段BooleanBooleanfalse是否注入扩展字段数据
Sort排序字段StringText"Priority,PublishTime"排序字段,支持多字段逗号分隔。常用字段:Priority(优先级)、PublishTime(发布时间)、Hits(点击数)。需与 SortOrder 一一对应。
SortOrder排序类型StringText"Desc,Desc"排序方向,支持多字段逗号分隔。Asc 为升序,Desc 为降序,与 Sort 一一对应
Interval间隔行数Int32Integer0每隔指定行数插入分隔符(如间隔2行,则第3、6、9...行显示分隔样式)。
HighRank高排名行数Int32Integer0高亮显示前N行(如置顶),通常配合CSS样式实现。
Split分隔行数Int32Integer0将列表按指定行数分组(如每5行为一组,用于分栏布局)。

显示参数

参数名中文名类型控件类型默认值详细说明
TitleLength标题长度Int32Integer50标题截断长度(按字符计算),超长部分显示为省略号(...)。
ShowNumber是否显示序号BooleanBooleanfalse为标题添加序号(如“01”)。
NumberFormat序号格式StringText"00"序号格式,支持数字格式化字符串(如“00”显示为“01”,“000”显示为“001”)。
ShowNode是否显示所属节点BooleanBooleanfalse在标题旁显示所属节点名称(如“[新闻] 文章标题”)。
NodePrefix所属节点前插入字符StringComboBox[节点名称前缀,可自定义符号(如改为 <新闻> 需设置 NodePrefix="<")。
NodeSuffix所属节点后插入字符StringComboBox]节点名称后缀,可自定义符号(如改为 <新闻> 需设置 NodeSuffix=">")。
ShowDate是否显示发布时间BooleanBooleantrue控制是否显示发布日期。
DateFormat发布时间日期格式StringComboBoxyyyy-MM-dd标准日期格式(如 "MM/dd")。
ShowRelation是否显示相关内容BooleanBooleanfalse是否显示关联内容链接。
RelationTagName相关内容标题StringText"相关内容"自定义关联内容区块标题。
ShowHits是否显示点击数BooleanBooleanfalse显示文章访问量。
HitsSuffix点击数后插入字符StringComboBox空点击数后追加文本(如设置为“次”,则显示为“1000次”)。
ShowLinkTip是否显示链接提示BooleanBooleantrue控制是否显示链接悬浮提示。
HighlightDays高亮天数Int32Integer0高亮最近N天内的文章(如 HighlightDays=3 会为3天内发布的文章添加高亮样式)。
HighlightMinutes高亮分钟数Int32Integer0高亮最近N分钟内发布的文章(如 HighlightMinutes=3 会为3分钟内发布的文章添加高亮样式)。
LinkBlankTarget是否新窗口打开BooleanBooleanfalse控制链接是否在新窗口打开(target="_blank")。

调用示例

  • 代码:
<ul class="infoList">
    @Power.PhotoList("图片标题列表", new { Count = 7, Node = "tpxw", TitleLength = 54, DateFormat = "MM-dd" })
</ul>
  • 说明: 该代码调用 图片标题列表 组件,获取7条来自标识符为 tpxw 的节点内容,标题长度设置为54字符,发布日期格式化为 MM-dd。生成的列表将按此配置显示图片标题,适用于展示新闻类图片列表。

  • 效果图:

图片图文列表.cshtml

组件路径

/Views/_Common/Shared/图片图文列表.cshtml

数据参数

参数名中文名类型控件类型默认值详细说明
Count显示条数Int32Integer10列表显示的内容数量。若启用分页(Paging=true),此参数表示每页条数
Node节点筛选StringTextNull支持传递节点标识符(如 "news")、节点实体或节点ID(如 "[1,2]"),多值用逗号分隔。示例:Node = "tpxw,spxw" 表示同时获取“图片新闻”和“视频新闻”节点下内容。
Paging分页开关BooleanBooleanfalse启用后需配合通用分页组件生成页码
Tag标签筛选StringTextNull按标签筛选,多值用逗号分隔(如 "热门,推荐")
keyword关键词搜索StringTextNull按关键词模糊匹配标题内容。
DateRange日期范围StringTextNull动态时间筛选,支持 1d(1天)、1w(1周)、1m(1月)、1y(1年)。示例:DateRange = "2w" 表示最近两周内的内容。
IncludeChildNodes包含子节点BooleanBooleantrue是否包含当前节点的子节点内容。例如,若 Node = "news",启用后会同时筛选“news”及其所有子节点(如“news/domestic”)。
Illustrated封面过滤BooleanBooleanfalse仅筛选带封面图片的内容
RefNode引用节点BooleanBooleanfalse是否包含通过“引用节点”关联的内容
ActualContentOnly实内容过滤BooleanBooleanfalse是否排除虚内容,仅显示实内容。
ExtendField扩展字段BooleanBooleanfalse是否注入扩展字段数据
Sort排序字段StringText"Priority,PublishTime"排序字段,支持多字段逗号分隔。常用字段:Priority(优先级)、PublishTime(发布时间)、Hits(点击数)。需与 SortOrder 一一对应。
SortOrder排序类型StringText"Desc,Desc"排序方向,支持多字段逗号分隔。Asc 为升序,Desc 为降序,与 Sort 一一对应
Interval间隔行数Int32Integer0每隔指定行数插入分隔符(如间隔2行,则第3、6、9...行显示分隔样式)。
HighRank高排名行数Int32Integer0高亮显示前N行(如置顶),通常配合CSS样式实现。
Split分隔行数Int32Integer0将列表按指定行数分组(如每5行为一组,用于分栏布局)。

显示参数

参数名中文名类型控件类型默认值详细说明
TitleLength标题长度Int32Integer50控制标题显示的最大字符数(中文按2字符计算),超长部分自动截断并添加省略号(...)。
ContentLength内容长度Int32Integer200控制正文/简介的截断长度(按字符计算)。
DisplayNodeName显示节点名称BooleanBooleanfalse在标题前显示所属节点名称,格式为 [节点名] 标题。
ImageWidth图片宽度Int32Integer200封面图渲染宽度(像素单位),设置为 0 时按原始比例自适应。
ImageHeight图片高度Int32Integer150封面图渲染高度(像素单位),建议与 ImageWidth 组合使用保持比例(如 300x200)。
DisplayDateTime显示日期格式StringComboBox空自定义日期显示格式(如 "yyyy-MM-dd HH:mm")。支持标准格式符(MM 月, dd 日, HH 24小时制等)。
LinkBlankTarget是否新窗口打开BooleanBooleanfalse控制链接是否在新窗口打开(target="_blank")。
IntroNewLine支持简介换行BooleanBooleanfalse控制简介内容中的换行符(\n)是否生效。

调用示例

  • 代码
<ul class="twList">
    @Power.PhotoList("图片图文列表", new { Node = "tpxw", Count = 3, TitleLength = 100, DisplayDateTime = "yyyy-MM-dd", ImageWidth = 200, ImageHeight = 150 })
</ul>
  • 说明: 该代码调用 图片图文列表 组件,从标识符为 tpxw 的节点中获取3条内容,标题长度设置为100字符,发布日期格式为 yyyy-MM-dd,封面图宽度为200像素,高度为150像素。生成的图片图文列表将展示这些内容,适用于新闻或图片集类型的图文展示。

  • 效果图:

帮助我们改善此页面!
最近更新: 2025/3/12 16:20
贡献者: Zen.Wu, zenkinwin, 吴国良, 邹宏达
Prev
文章模型
Next
视频模型