内容搜索功能

最后更新: | 浏览次数: 595|功能开发

功能介绍

内容搜索功能通过 HTML 自定义属性（Data Attributes） 进行配置与控制，无需侵入或改造前端界面结构，即可完成搜索能力的集成与扩展。

重要说明：

自 4.7.1217（含）版本起，搜索功能的使用方式进行了破坏性修改。
若旧版本代码出现无法正常搜索的情况，请务必按照本文档所述方式进行调整。

Input自定义属性说明

属性 默认值 必须 描述
id searchKey 是 搜索输入框的唯一标识，用于区分并操作不同搜索框
data-type product 是 指定搜索类型，可选值： product /article / category
data-pagesize 12 是 每页返回的搜索结果数量，最大值为 120

Button自定义属性说明

属性 默认值 必需 描述
data-input 与input的id一致 是 用于建立按钮与对应搜索输入框之间的关联
data-provider search 是 指定按钮的行为类型，用于标识搜索触发器

方法说明

方法 描述
cms.search(event) 处理输入框的键盘事件，实现实时搜索。event 参数包含当前触发事件的上下文信息

使用示例

<input
    type="search"
    id="searchKey"
    class="form-control"
    data-type="product"
    data-pagesize="12"
    placeholder="Keywords"
    onkeyup="cms.search(event)" />

<button
    type="button"
    class="btn"
    data-input="searchKey"
    data-provider="search">
    搜索
</button>

说明与注意事项

  • 搜索按钮无需手动绑定事件
    只需正确配置 data-input 与 data-provider 属性，系统将自动识别并处理。

  • 搜索内容类型由 data-type 决定

    • 搜索产品：data-type="product"

    • 搜索文章：data-type="article"

  • 分类搜索限制说明

    • 如需搜索当前分类内容，请使用：data-type="category"

    • 仅允许在分类列表页使用，其他页面调用将被忽略或返回空结果。