苹果CMS演员搜索页面表单制作与结果列表模板开发教程

一、演员搜索页面基础配置参数

苹果CMS演员模块内置独立搜索功能，支持关键词匹配演员数据，拥有专属模板文件、页面标识与搜索路由，可快速在模板中搭建演员检索入口与结果页面。

• 搜索页面模板路径：html/actor/show.html

• 页面唯一ID：83，模板中可通过 {$maccms.aid} 动态获取

• 搜索路由生成标签：{:mac_url_search(['wd'=>'刘德华'],'actor')}，支持自定义默认关键词生成演员搜索链接

二、演员搜索表单完整开发代码

以下为适配演员模块的标准搜索表单代码，采用GET提交方式，绑定演员专属搜索路由，自带关键词回显与提交校验功能，可直接嵌入头部、侧边栏、搜索页等任意位置。

<form name="search" method="get" action="{:mac_url('actor/search')}" onSubmit="return qrsearch();">
    <input type="text" name="wd" class="mac_wd" value="{$param.wd}" placeholder="演员名称" />
    <input type="submit" class="mac_search" value="搜索演员" />
</form>

表单通过 {$param.wd} 自动读取回填用户已输入的搜索关键词，避免刷新页面后内容丢失，同时通过前端校验函数拦截空关键词提交请求，优化页面交互体验。

三、演员搜索结果列表调用代码

演员搜索页面可通过专属循环标签自动根据关键词匹配对应数据，支持自定义展示条数、分页功能与排序方式，完美适配搜索结果页面的数据渲染需求。

{maccms:actor num="10" paging="yes" pageurl="actor/search" order="desc" by="time"}
    <li><a class="play-img" href="{:mac_url_actor_detail($vo)}">
        <img src="{:mac_url_img($vo.actor_pic)}" alt="{$vo.actor_name}" /></a>
        <h2><a href="{:mac_url_actor_detail($vo)}">{$vo.actor_name}</a></h2>
        <dl><dt>主演：</dt><dd>{$vo.actor_actor}</dd></dl>
    </li>
{/maccms:actor}

四、列表参数与字段功能说明

• num参数：控制单页展示的演员数据数量，可根据页面布局自由调整数值。

• paging参数：设置为yes即可开启分页功能，满足大批量搜索结果的分页浏览需求。

• pageurl参数：绑定演员搜索专属路由地址，确保分页跳转路径准确，避免页面跳转异常。

• 排序规则：默认按照数据添加时间倒序排列，优先展示最新录入的演员资料。

• 循环字段：支持调取演员头像、姓名、参演信息等基础字段，搭配系统自带详情链接函数，自动生成标准化演员详情跳转地址。