如何在WordPress网站添加带动态推荐功能的侧边栏搜索框？
如图：
一、部署步骤
1. 登录WordPress后台，进入「外观 → 小工具」页面
2. 添加一个「自定义HTML」小工具到侧边栏
3. 将下方代码完整复制粘贴进去
4. 修改代码中的网站域名配置项
5. 保存即可生效
二、完整代码
推荐关键词会按照「标签 → 分类 → 暂无推荐」的优先级从网站真实内容中动态获取。
<style>
/* ========== 1. CSS变量定义 - 实现日夜模式自动适配 ========== */
:root {
--search-card-bg: #ffffff;
--search-card-shadow: 0 2px 12px rgba(0, 0, 0, 0.05);
--search-input-bg: #f9fafb;
--search-input-border: #e5e7eb;
--search-input-color: #374151;
--search-input-focus-bg: #ffffff;
--search-input-focus-border: #3b82f6;
--search-input-focus-shadow: 0 0 0 3px rgba(59, 130, 246, 0.08);
--search-btn-bg: #3b82f6;
--search-btn-hover-bg: #2563eb;
--suggest-dropdown-bg: #ffffff;
--suggest-dropdown-shadow: 0 4px 20px rgba(0, 0, 0, 0.12);
--suggest-item-color: #374151;
--suggest-item-hover-bg: #f3f4f6;
--suggest-item-hover-color: #3b82f6;
--suggest-arrow-color: #ffffff;
}
/* 深色模式 - 兼容多种主题切换方式 */
body.dark .xmosai-search-card,
body.dark-mode .xmosai-search-card,
body.night-mode .xmosai-search-card,
html[data-theme="dark"] .xmosai-search-card {
--search-card-bg: #1f2937;
--search-card-shadow: 0 2px 12px rgba(0, 0, 0, 0.15);
--search-input-bg: #111827;
--search-input-border: #374151;
--search-input-color: #f3f4f6;
--search-input-focus-bg: #0f172a;
--search-input-focus-border: #3b82f6;
--search-input-focus-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
--search-btn-bg: #3b82f6;
--search-btn-hover-bg: #2563eb;
--suggest-dropdown-bg: #1e293b;
--suggest-dropdown-shadow: 0 4px 20px rgba(0, 0, 0, 0.3);
--suggest-item-color: #e2e8f0;
--suggest-item-hover-bg: #334155;
--suggest-item-hover-color: #60a5fa;
--suggest-arrow-color: #1e293b;
}
/* 系统级深色模式 - 跟随操作系统设置 */
@media (prefers-color-scheme: dark) {
:root {
--search-card-bg: #1f2937;
--search-card-shadow: 0 2px 12px rgba(0, 0, 0, 0.15);
--search-input-bg: #111827;
--search-input-border: #374151;
--search-input-color: #f3f4f6;
--search-input-focus-bg: #0f172a;
--search-input-focus-border: #3b82f6;
--search-input-focus-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
--search-btn-bg: #3b82f6;
--search-btn-hover-bg: #2563eb;
--suggest-dropdown-bg: #1e293b;
--suggest-dropdown-shadow: 0 4px 20px rgba(0, 0, 0, 0.3);
--suggest-item-color: #e2e8f0;
--suggest-item-hover-bg: #334155;
--suggest-item-hover-color: #60a5fa;
--suggest-arrow-color: #1e293b;
}
}
/* ========== 2. 搜索框容器样式 ========== */
.xmosai-search-card {
width: 100%;
box-sizing: border-box;
background: var(--search-card-bg);
border-radius: 12px;
padding: 16px;
margin-bottom: 20px;
box-shadow: var(--search-card-shadow);
transition: all 0.2s ease;
position: relative;
z-index: 999;
}
/* ========== 3. 表单布局 - flex实现输入框与按钮并排 ========== */
.xmosai-search-form {
width: 100%;
display: flex;
gap: 10px;
box-sizing: border-box;
position: relative;
}
/* ========== 4. 输入框样式 ========== */
.xmosai-search-input {
flex: 1;
min-width: 0;
padding: 10px 14px;
font-size: 14px;
line-height: 1.5;
color: var(--search-input-color);
background: var(--search-input-bg);
border: 1px solid var(--search-input-border);
border-radius: 8px;
outline: none;
box-sizing: border-box;
font-family: inherit;
transition: all 0.2s ease;
}
.xmosai-search-input:focus {
background: var(--search-input-focus-bg);
border-color: var(--search-input-focus-border);
box-shadow: var(--search-input-focus-shadow);
}
/* ========== 5. 搜索按钮样式 ========== */
.xmosai-search-btn {
flex-shrink: 0;
width: 40px;
height: 40px;
padding: 0;
border: none;
border-radius: 8px;
background: var(--search-btn-bg);
color: #ffffff;
cursor: pointer;
display: flex;
align-items: center;
justify-content: center;
transition: all 0.2s ease;
}
.xmosai-search-btn:hover {
background: var(--search-btn-hover-bg);
transform: scale(1.02);
}
.xmosai-search-btn:active {
transform: scale(0.98);
}
.xmosai-search-btn svg {
width: 18px;
height: 18px;
flex-shrink: 0;
}
/* ========== 6. 下拉框样式 - 绝对定位实现悬浮效果 ========== */
.xmosai-suggest-dropdown {
position: absolute;
top: calc(100% + 8px);
left: 0;
width: 100%;
background: var(--suggest-dropdown-bg);
border-radius: 10px;
box-shadow: var(--suggest-dropdown-shadow);
overflow: hidden;
opacity: 0;
visibility: hidden;
transform: translateY(-6px);
transition: all 0.2s ease;
z-index: 1000;
}
/* 下拉框顶部小三角箭头 */
.xmosai-suggest-dropdown::before {
content: '';
position: absolute;
top: -6px;
left: 18px;
width: 0;
height: 0;
border-left: 8px solid transparent;
border-right: 8px solid transparent;
border-bottom: 8px solid var(--suggest-arrow-color);
z-index: 1001;
}
/* 输入框聚焦时显示下拉框 */
.xmosai-search-form:focus-within .xmosai-suggest-dropdown {
opacity: 1;
visibility: visible;
transform: translateY(0);
}
/* ========== 7. 推荐项样式 ========== */
.xmosai-suggest-item {
padding: 10px 16px;
font-size: 14px;
color: var(--suggest-item-color);
cursor: pointer;
transition: all 0.15s ease;
box-sizing: border-box;
}
.xmosai-suggest-item:hover {
background: var(--suggest-item-hover-bg);
color: var(--suggest-item-hover-color);
padding-left: 20px;
}
.xmosai-suggest-tip {
padding: 12px 16px;
font-size: 14px;
color: var(--suggest-item-color);
opacity: 0.7;
}
/* ========== 8. 移动端响应式适配 ========== */
@media (max-width: 768px) {
.xmosai-search-card {
padding: 12px;
margin-bottom: 16px;
}
.xmosai-search-form {
gap: 8px;
}
.xmosai-search-input {
padding: 9px 12px;
font-size: 13px;
}
.xmosai-search-btn {
width: 38px;
height: 38px;
}
.xmosai-search-btn svg {
width: 16px;
height: 16px;
}
.xmosai-suggest-item {
padding: 9px 14px;
font-size: 13px;
}
.xmosai-suggest-tip {
padding: 10px 14px;
font-size: 13px;
}
}
</style>
<!-- 搜索框HTML结构 -->
<div class="xmosai-search-card">
<form class="xmosai-search-form" role="search" method="get" action="https://xmosai.com/" autocomplete="off">
<input
type="text"
class="xmosai-search-input"
placeholder="你想找点什么？"
name="s"
id="xmosai-search-input"
autocomplete="off"
autocorrect="off"
autocapitalize="off"
spellcheck="false"
required
>
<div class="xmosai-suggest-dropdown" id="xmosai-suggest-box">
<div class="xmosai-suggest-tip">加载中...</div>
</div>
<button type="submit" class="xmosai-search-btn">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
</button>
</form>
</div>
<script>
/* ========== 配置项 ========== */
const SUGGEST_COUNT = 6; // 显示的推荐词数量
const WP_API_BASE = "https://xmosai.com/wp-json/wp/v2"; // 修改为你的网站域名
const TIMEOUT_MS = 3000; // 接口超时时间(毫秒)
document.addEventListener('DOMContentLoaded', function() {
const searchInput = document.getElementById('xmosai-search-input');
const suggestBox = document.getElementById('xmosai-suggest-box');
if (!searchInput || !suggestBox) return;
/* 渲染推荐词到下拉框 */
function renderSuggest(keywords) {
try {
// 数组随机打乱后截取指定数量
const randomKeywords = [...keywords].sort(() => 0.5 - Math.random()).slice(0, SUGGEST_COUNT);
suggestBox.innerHTML = randomKeywords.map(keyword => `
<div class="xmosai-suggest-item" data-keyword="${keyword}">${keyword}</div>
`).join('');
bindSuggestClick();
} catch (err) {
suggestBox.innerHTML = '<div class="xmosai-suggest-tip">加载失败</div>';
console.error('推荐词渲染失败', err);
}
}
/* 绑定点击事件 - 点击推荐词填充到输入框 */
function bindSuggestClick() {
try {
const items = suggestBox.querySelectorAll('.xmosai-suggest-item');
items.forEach(item => {
item.addEventListener('click', function() {
searchInput.value = this.getAttribute('data-keyword');
searchInput.focus();
});
});
} catch (err) {
console.error('点击事件绑定失败', err);
}
}
/* 带超时控制的fetch请求 */
async function fetchWithTimeout(url) {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
const response = await fetch(url, { signal: controller.signal });
clearTimeout(timeoutId);
if (!response.ok) throw new Error('HTTP ' + response.status);
return response.json();
}
/* 多数据源获取关键词：标签优先，分类备用 */
async function fetchKeywords() {
let keywords = [];
// 优先尝试获取标签
try {
const tags = await fetchWithTimeout(`${WP_API_BASE}/tags?per_page=100&orderby=count&order=desc`);
if (Array.isArray(tags)) {
keywords = tags.filter(t => t.count > 0).map(t => t.name);
}
} catch (err) {
console.warn('标签获取失败:', err.message);
}
if (keywords.length > 0) {
renderSuggest(keywords);
return;
}
// 标签为空时，尝试获取分类
try {
const categories = await fetchWithTimeout(`${WP_API_BASE}/categories?per_page=100&orderby=count&order=desc`);
if (Array.isArray(categories)) {
keywords = categories.filter(c => c.count > 0).map(c => c.name);
}
} catch (err) {
console.warn('分类获取失败:', err.message);
}
if (keywords.length > 0) {
renderSuggest(keywords);
return;
}
// 两个数据源都为空时显示提示
suggestBox.innerHTML = '<div class="xmosai-suggest-tip">暂无推荐</div>';
}
/* 阻止浏览器自动填充 */
searchInput.addEventListener('focus', function() {
this.setAttribute('autocomplete', 'off');
});
fetchKeywords();
});
</script>三、配置说明
需要修改的配置项：
| 配置项 | 说明 | 位置 |
|--------|------|------|
| action="https://xmosai.com/" | 表单提交地址，改为你的网站域名 | HTML部分 |
| WP_API_BASE | WordPress REST API地址 | JS配置区 |
| SUGGEST_COUNT | 显示的推荐词数量，默认6个 | JS配置区 |
| TIMEOUT_MS | 接口超时时间，默认3000毫秒 | JS配置区 |
四、功能特点
- 动态推荐：从网站真实标签/分类中获取，无硬编码关键词
- 日夜模式：自动适配网站深色/浅色主题
- 响应式设计：PC端和移动端均可正常显示
- 样式隔离：所有类名使用xmosai-前缀，避免冲突
- 无依赖：纯原生HTML+CSS+JS实现
