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

    • 概述
    • 网站部署
  • 帮助

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

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

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

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

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

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

    • 概述
    • 网站部署
  • 帮助

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

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

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

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

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

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

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

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

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

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

文章模型

@Power.ArticleList() 是用于渲染文章类内容的动态列表组件,支持通过数据参数筛选内容,并通过显示参数自定义前端展示样式。适用于新闻列表、聚合页等场景。

文章标题列表.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")
DateFollowTitle时间位置BooleanBooleanfalse控制发布日期显示位置:true时日期紧跟标题后面,false时则在标题前面
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.ArticleList("文章标题列表", new {
        Count = 7, // 数量 7
        Node = "xwdt", // 节点标识符 xwdt
        TitleLength = 54, // 标题长度
        DateFormat = "MM-dd"
    })
</ul>
  • 说明: 用数量 7,节点标识符 xwdt ,标题长度 54字符,发布时间日期格式 月-日的文章标题列表效果。

  • 效果图:

文章头条列表.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行为一组,用于分栏布局)。

显示参数

参数名中文名类型控件类型默认值详细说明
TopicNum头条数Int32Integer1控制显示的头条文章数量(需与内容模型配合使用)。若设置为3,则前3篇文章会应用头条样式
TopicTitleLength头条标题长度Int32Integer200头条文章标题截断长度(按字符计算),超长部分显示为省略号(...)
TopicContentLength头条简介长度Int32Integer200头条文章正文摘要截取长度(按字符计算)
TopicDisplayDateTime头条日期格式StringComboBox空头条文章发布日期格式,如 "MM/dd HH:mm"
TopicDateFollowTitle日期在标题后BooleanBooleanfalse控制头条日期显示位置:true 时日期显示在标题后面,false 时显示在标题前面
TopicDisplayPic头条显示图片BooleanBooleanfalse是否显示头条文章的封面图片
Rank序号BooleanBooleanfalse控制头条文章序号显示
RankUpNum序号条数Int32Integer3配合 Rank=true 使用,控制显示序号头条文章数量
TitleLength普通标题长度Int32Integer50非头条文章标题截断长度(按字符计算),与 TopicTitleLength 独立配置
DisplayDateTime普通日期格式StringComboBox空非头条文章日期格式,如 "yyyy.MM.dd"
ImageWidth图片宽度Int32Integer200封面图片渲染宽度(像素单位),设置为0时按原始比例显示
ImageHeight图片高度Int32Integer200封面图片渲染高度(像素单位),建议与 ImageWidth 组合使用保持比例
IntroClearSpacesDemand清除简介空格BooleanBooleanfalse截取文章简介时是否移除首尾空格及连续空格(改善排版整洁度)
LinkBlankTarget新窗口打开BooleanBooleanfalse统一控制所有文章链接是否在新标签页打开(覆盖节点设置)

调用示例

  • 代码:
<ul class="topicList topicHasPic">
    @Power.ArticleList("文章头条列表", new {
        Count = 7, // 调用数量
        Node = "jyky", // 调用的节点标识符
        TitleLength = 66, // 非头条文章的标题字数
        TopicNum = 1, // 头条文章数量
        TopicTitleLength = 70, // 头条文章的标题字数
        TopicContentLength = 126, // 头条文章的简介字数
        TopicDisplayPic = true, // 头条文章显示图片
        DisplayDateTime = "yyyy-MM-dd",
        ImageWidth = 150,
        ImageHeight = 100
    })
</ul>
  • 说明: 从标识符为 jyky 的节点获取7篇文章(1篇头条+6篇普通),头条文章显示封面图(150x100像素)、标题截断至70字符并附加126字符的简介,普通文章标题截断至66字符,日期格式化为 yyyy-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在标题前显示所属节点名称,格式为 [节点名] 标题,可通过 NodePrefix/NodeSuffix 自定义前后缀
ImageWidth图片宽度Int32Integer200封面图渲染宽度(像素单位),设置为 0 时按原始比例自适应。
ImageHeight图片高度Int32Integer150封面图渲染高度(像素单位),建议与 ImageWidth 组合使用保持比例(如 300x200)
DisplayDateTime日期格式StringComboBox空自定义日期显示格式(如 "yyyy-MM-dd HH:mm")。支持标准格式符(MM 月, dd 日, HH 24小时制等)
LinkBlankTarget新窗口打开BooleanBooleanfalse统一控制所有文章链接的 target 属性,true 时强制 target="_blank"(覆盖节点设置)
IntroNewLine简介换行BooleanBooleanfalse控制简介内容中的换行符(\n)是否生效。

调用示例

  • 代码:
<ul class="pageTPList">
    @Power.ArticleList("文章图文列表", new {
        Node = "xwdt",
        Count = 10,
        DisplayNodeName = true,
        TitleLength = 200,
        ContentLength = 256,
        DisplayDateTime = "发表时间:yyyy-MM-dd",
        ImageWidth = 180,
        ImageHeight = 110
    })
</ul>
  • 说明: 从标识符为 xwdt 的节点(如"新闻动态")获取10条数据,每项显示节点名称(默认格式 [节点名])、标题截断至200字符、正文摘要截取256字符,日期格式化为带前缀的 发表时间:2025-02-21,封面图按180x110像素固定尺寸渲染。此配置专为 文章-列表页-图文式.cshtml 模板设计,结合 通用分页 组件可实现数据分页加载,适用于需同时展示图文、长标题及详细摘要的内容聚合场景(如新闻中心、政策解读页)。

  • 效果图:

文章图文列表-先图后文.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在标题前显示所属节点名称,格式为 [节点名] 标题,可通过 NodePrefix/NodeSuffix 自定义前后缀
ImageWidth图片宽度Int32Integer200封面图渲染宽度(像素单位),设置为 0 时按原始比例自适应。
ImageHeight图片高度Int32Integer150封面图渲染高度(像素单位),建议与 ImageWidth 组合使用保持比例(如 300x200)
DisplayDateTime日期格式StringComboBox空自定义日期显示格式(如 "yyyy-MM-dd HH:mm")。支持标准格式符(MM 月, dd 日, HH 24小时制等)
LinkBlankTarget新窗口打开BooleanBooleanfalse统一控制所有文章链接的 target 属性,true 时强制 target="_blank"(覆盖节点设置)
IntroNewLine简介换行BooleanBooleanfalse控制简介内容中的换行符(\n)是否生效。

调用示例

  • 代码:
<ul class="pageTPList">
    @Power.ArticleList("文章图文列表-先图后文", new { Count = 5, Node = "xwdt", TitleLength = 200, ContentLength = 200, ImageWidth = 180, ImageHeight = 110 })
</ul>
  • 说明: 调用文章模型组件生成"先图后文"布局的图文列表,从标识符为xwdt的节点中筛选5条内容,配置参数包括:标题和内容均截断至200字符(自动添加省略号)、封面图片固定为180×110像素(强制等比例缩放), 适用于需要图文混排且图片优先展示的新闻动态类页面布局。

  • 效果图:

文章图片列表.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图片宽度Int32Integer200封面图渲染宽度(像素单位),设置为 0 时按原始比例自适应。
ImageHeight图片高度Int32Integer150封面图渲染高度(像素单位),建议与 ImageWidth 组合使用保持比例(如 300x200)
ShowDate显示时间BooleanBooleantrue控制是否显示发布日期
DateFormat时间格式StringComboBoxyyyy-MM-dd标准日期格式(如 "MM/dd")
LinkBlankTarget新窗口打开BooleanBooleanfalse统一控制所有文章链接的 target 属性,true 时强制 target="_blank"(覆盖节点设置)

调用示例

  • 代码:
<ul class="picList">
    @Power.ArticleList("文章图片列表", new { Count = 4, Node = "jyxw", Illustrated = true, TitleLength = 38, ImageWidth = 285, ImageHeight = 180 })
</ul>
  • 说明: 调用文章模型组件生成"文章图片列表"布局,从标识符为jyxw的节点中筛选4条带封面图的内容,配置参数包括:标题截断至38字符(自动添加省略号)、封面图片固定尺寸为285×180像素(强制等比例缩放)、通过Illustrated = true过滤仅显示含封面图的内容、生成的图片列表自带picList样式类,适用于新闻聚合页中需要突出显示封面图的图文混排区块(如教学新闻的焦点图展示)。

  • 效果图:

文章焦点图.cshtml

组件路径

/Views/_Common/Shared/文章焦点图.cshtml

组件参数

参数名中文名类型控件类型默认值详细说明
NodeIdentifier节点标识符StringText不支持多值传递
Count输出数量Int32Integer5显示内容条数。
TitleLength标题长度Int32Integer50标题截断长度(单位:字符),超长自动添加...。
ContentLength内容长度Int32Integer0正文摘要截断长度(单位:字符)
DisplayDateTime日期格式StringComboBox空自定义日期显示格式(如 "yyyy-MM-dd HH:mm")。支持标准格式符(MM 月, dd 日, HH 24小时制等)
ImageWidth图片宽度Int32Integer400封面图裁剪宽度(单位:像素),0表示自动按原图比例缩放
ImageHeight图片高度Int32Integer300封面图裁剪高度,0表示自动按原图比例缩放
PicTitle使用图片切换BooleanBooleanfalse开启后允许通过封面图进行内容切换(常用于焦点图轮播)
IncludeChildNodes包含子节点内容BooleanBooleantrue自动包含当前节点的所有子节点内容,如NodeIdentifier="news"会包含news/sub内容
Sort排序StringTextPriority DESC,PublishTime DESC多字段排序规则,格式:字段1 排序,字段2 排序。示例:Hits ASC
LinkBlankTarget新窗口打开BooleanBooleanfalse统一控制所有文章链接的 target 属性,true 时强制 target="_blank"(覆盖节点设置)
TagName标记名称StringTextNull用于过滤带特定标记的内容,支持多值逗号分隔。示例:"推荐,热门"
DispatchDepartment部门标识符StringTextNull按发布部门筛选内容,需与部门管理系统的标识符一致。示例:"hbj"
IntroNewLine简介换行BooleanBooleanfalse控制简介内容中的换行符(\n)是否生效。
PadColor图片裁剪填充颜色值StringTextNull生成缩略图时空白部分的背景填充色,设置后会完整显示缩略图,支持十六进制(#FFFFFF)或RGB(255,255,255)

调用示例

  • 代码:
<div id="focusNews" class="focusBox">
    @Power.Partial("文章焦点图", new { Count = 5, NodeIdentifier = "xwdt", TitleLength = 60, PicTitle = false, ImageWidth = 403, ImageHeight = 260 })
</div>
<script>
    $("#focusNews").slide({ mainCell: ".bd ul", effect: "leftLoop", autoPlay: true, vis: "auto", interTime: 3500 });
</script>
  • **说明: 该代码调用公共组件生成"文章焦点图"布局,从标识符为xwdt的节点中筛选5条内容,配置参数包括:标题截断至60字符(自动添加省略号)、禁用图片标题切换功能(PicTitle=false)、封面图固定尺寸为403×260像素(强制等比例缩放)、通过jQuery轮播插件实现自动播放效果(3.5秒间隔),适用于新闻频道页顶部的焦点图轮播展示场景,需配合focusBox样式容器使用。

  • 效果图:

领导图文列表.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简介长度Int32Integer50控制简介显示的最大字符数(中文按2字符计算),超长部分自动截断并添加省略号(...)。
ShowPic头条显示图片BooleanBooleanfalse是否显示头条文章的封面图片
ImageWidth图片宽度Int32Integer200封面图渲染宽度(像素单位),设置为 0 时按原始比例自适应。
ImageHeight图片高度Int32Integer150封面图渲染高度(像素单位),建议与 ImageWidth 组合使用保持比例(如 300x200)

调用示例

  • 代码:
<ul class="leaderList">
    @Power.ArticleList("领导图文列表", new { Node = "ldzc", Count = 3, ShowPic = true, ImageWidth = 150, ImageHeight = 200, ContentLength = 320, ExtendField = true })
</ul>
  • 说明: 该代码调用文章模型组件生成"领导图文列表"布局,从标识符为ldzc的节点中筛选3条图文内容,关键配置包括:显示封面图片(尺寸固定为150×200像素)、正文摘要截断至320字符(自动去除HTML标签)、启用扩展字段数据加载(ExtendField=true)、通过leaderList样式类实现领导信息特有的图文混排效果,适用于领导班子介绍、领导动态等需要突出人物形象与详细简介的官方页面场景。

  • 效果图:

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