博客或站点放个"在线客服"按钮,读者有问题能一键找到你。做成胶囊形状——圆角拉满、带个小图标,浮在左下角不挡正文。
这套代码纯 HTML + CSS,不依赖任何建站程序。下面每块都能点「预览效果」直接看。
原版 · 实际效果
<style>
.ft5{position:fixed;left:20px;bottom:24px;background:#409eff;color:#fff;
padding:11px 20px;border-radius:30px;font-size:13px;
box-shadow:0 4px 14px #409eff55;cursor:pointer;z-index:99;transition:.3s;
display:flex;align-items:center;gap:6px}
.ft5:hover{transform:translateY(-3px)}
</style>
<div class="ft5" onclick="alert('演示:在线客服')">💬 在线客服</div>
<p style="font:14px/1.8 sans-serif;padding:20px">蓝 左下角客服胶囊示例。</p>原版代码的问题:外观是好看的,hover 上浮的动效也对。但它有三个实打实的问题——点不动、键盘到不了、对比度不达标。
① onclick 在加了安全策略的站点上会被整体拦截
这个最隐蔽。我做了对照实验——同一段代码,只差一条 CSP 响应头:
| 点击后 | |
|---|---|
| 无 CSP | 弹窗出现 ✓ |
| 加了 CSP | 毫无反应 ✗ |
浏览器控制台报的是:
```
Executing inline event handler violates the following
Content Security Policy directive
```
函数明明写对了却完全不执行。这类"本地能跑、上线失效"最难查,而很多安全插件、CDN 防护、云 WAF 都会给站点加 CSP。
写在 HTML 里的脚本——不管是 <script> 块还是 onclick 属性——都中招。正确做法是单独存 .js 文件引入。
② 用 div 当按钮,键盘完全到不了
| 检查项 | 结果 |
|---|---|
| 元素 | div |
| Tab 聚焦 | 不能(focus 后 activeElement 还是 BODY) |
| 回车/空格触发 | 无 |
role |
无 |
cursor:pointer 只是把光标换成小手,看着能点,实际键盘用户根本过不去。而且 div 在语义上不是控件,读屏也不会播报"按钮"。
③ 蓝底白字对比度 2.78
#409eff 是很常见的亮蓝,配白字只有 2.78,远低于 4.5。压深到 #1d4ed8 就有 6.70,蓝色调基本没变。
④ 另外三处小问题
alert()做演示可以,别用在生产:它会阻塞整个页面(弹窗不关,页面就卡住),体验很差。真实场景应该跳转到客服页面、唤起聊天窗口,或者打开邮件链接。z-index:99偏低:容易被别的悬浮元素盖住。- 示例段落漏了颜色:
<p>只写了font,没写color,实测是纯黑#000——放在深色背景上会看不见。
修复版 · 真链接 + 真按钮
<style>
.wxz-kf{position:fixed;left:20px;bottom:24px;z-index:9999;
display:inline-flex;align-items:center;gap:6px;
background:#1d4ed8;color:#fff; /* 6.70 ✓ */
padding:11px 20px;border-radius:30px;font-size:13px;
font-family:system-ui,-apple-system,"PingFang SC",sans-serif;
text-decoration:none;line-height:1;
box-shadow:0 4px 14px rgba(29,78,216,.35);
transition:transform .22s,box-shadow .22s}
.wxz-kf:hover{transform:translateY(-3px);box-shadow:0 7px 18px rgba(29,78,216,.42)}
.wxz-kf:focus-visible{outline:2px solid #1e40af;outline-offset:3px}
.wxz-kf:active{transform:translateY(-1px)}
/* 触屏:触控目标不小于 44px */
@media (hover:none){.wxz-kf{min-height:44px;padding:11px 22px}}
@media (prefers-reduced-motion:reduce){.wxz-kf{transition:none}}
</style>
<a class="wxz-kf" href="https://wxzcw.com/">
💬 在线客服
</a>这版改了这些:
| 改动 | 作用 | 实测 |
|---|---|---|
div + onclick → <a href> |
可点击、可 Tab 聚焦、不被 CSP 拦 | 键盘可达 ✓ |
蓝底 #409eff → #1d4ed8 |
对比度达标 | 2.78 → 6.70 ✓ |
alert() → 真链接 |
不阻塞页面,跳转客服页 | — |
加 :focus-visible |
键盘聚焦有可见轮廓 | — |
加 :active |
点击有反馈 | — |
z-index 99 → 9999 |
不被盖住 | — |
加 @media (hover:none) |
触屏下按钮高度到 44px | — |
加 prefers-reduced-motion |
尊重减弱动效 | — |
transition 写具体属性 |
不用 all |
— |
补 font-family / line-height |
不继承站点字体时会跑版 | — |
核心改动就一个:把 div 换成 <a href>。
客服按钮的本质是"点了要去某个地方"——那它就是个链接,用 <a> 最合适:
- 天然可 Tab 聚焦、回车触发
- 右键可以"在新标签页打开"
- 搜索引擎能抓到
- 搜索引擎能抓到、不写 JS,也就不存在 CSP 拦截
href 里换成你自己的客服页、QQ 临时会话链接、邮件地址(mailto:)都行。
关于 text-decoration:none:<a> 默认带下划线,胶囊按钮上不需要,所以显式去掉了。但记得保留 :focus-visible,否则键盘用户没有任何反馈。
需要弹窗?用 button 版
<style>
.wxz-kf2{position:fixed;left:20px;bottom:24px;z-index:9999;
display:inline-flex;align-items:center;gap:6px;
background:#1d4ed8;color:#fff;padding:11px 20px;border-radius:30px;
font-size:13px;line-height:1;border:none;cursor:pointer;
font-family:system-ui,-apple-system,"PingFang SC",sans-serif;
box-shadow:0 4px 14px rgba(29,78,216,.35);
transition:transform .22s,box-shadow .22s}
.wxz-kf2:hover{transform:translateY(-3px)}
.wxz-kf2:focus-visible{outline:2px solid #1e40af;outline-offset:3px}
@media (hover:none){.wxz-kf2{min-height:44px}}
@media (prefers-reduced-motion:reduce){.wxz-kf2{transition:none}}
/* 弹出的客服面板 */
.wxz-kfp{position:fixed;left:20px;bottom:82px;z-index:9999;width:230px;
background:#fff;border-radius:14px;padding:16px;
box-shadow:0 10px 34px rgba(0,0,0,.16);
font:13px/1.8 system-ui,-apple-system,"PingFang SC",sans-serif;color:#3f4a5a;
opacity:0;visibility:hidden;transform:translateY(8px);transition:.26s}
.wxz-kfp.on{opacity:1;visibility:visible;transform:none}
.wxz-kfp h4{margin:0 0 8px;font-size:14px;color:#1f2937}
.wxz-kfp a{display:block;padding:7px 0;color:#1d4ed8;text-decoration:none} /* 6.70 ✓ */
.wxz-kfp a:hover{text-decoration:underline}
@media (prefers-reduced-motion:reduce){.wxz-kfp{transition:none}}
</style>
<button class="wxz-kf2" type="button" id="kfbtn" aria-expanded="false" aria-controls="kfpanel">
💬 在线客服
</button>
<div class="wxz-kfp" id="kfpanel" role="dialog" aria-label="联系方式">
<h4>联系<a href="https://wxzcw.com/">维形筑网</a></h4>
<a href="mailto:hi@wxzcw.com">📧 邮件:hi@wxzcw.com</a>
<a href="https://wxzcw.com/">🌐 站点:www.wxzcw.com</a>
</div>
<script>
// 单独存成 .js 引入,不要写在 HTML 里 —— 内联脚本会被 CSP 拦截
(function () {
var btn = document.getElementById('kfbtn');
var pnl = document.getElementById('kfpanel');
if (!btn || !pnl) return;
btn.addEventListener('click', function () {
var open = pnl.classList.toggle('on');
btn.setAttribute('aria-expanded', open ? 'true' : 'false');
});
// 点面板外面自动收起
document.addEventListener('click', function (e) {
if (!pnl.contains(e.target) && e.target !== btn) {
pnl.classList.remove('on');
btn.setAttribute('aria-expanded', 'false');
}
});
// Esc 关闭
document.addEventListener('keydown', function (e) {
if (e.key === 'Escape') {
pnl.classList.remove('on');
btn.setAttribute('aria-expanded', 'false');
}
});
})();
</script>想点击弹出一个小面板(而不是跳转),用这个版本。要点:
<button type="button">:真按钮,可 Tab 聚焦、回车/空格触发。type="button"防止放进表单时误提交。- JS 单独存文件引入:别内联,否则 CSP 站点上失效。
aria-expanded同步状态:读屏能知道面板是开是关。- 点外面和 Esc 都能关:悬浮面板不这么做会一直挡着。
深色款 · 配暗色主题
<style>
.wxz-kfd{position:fixed;left:20px;bottom:24px;z-index:9999;
display:inline-flex;align-items:center;gap:6px;
background:#60a5fa;color:#0f172a; /* 6.42 ✓ */
padding:11px 20px;border-radius:30px;font-size:13px;line-height:1;
font-family:system-ui,-apple-system,"PingFang SC",sans-serif;
text-decoration:none;
box-shadow:0 4px 14px rgba(0,0,0,.45);
transition:transform .22s,box-shadow .22s}
.wxz-kfd:hover{transform:translateY(-3px);box-shadow:0 7px 18px rgba(0,0,0,.55)}
.wxz-kfd:focus-visible{outline:2px solid #93c5fd;outline-offset:3px}
@media (hover:none){.wxz-kfd{min-height:44px}}
@media (prefers-reduced-motion:reduce){.wxz-kfd{transition:none}}
</style>
<a class="wxz-kfd" href="https://wxzcw.com/">💬 在线客服</a>深色款用亮蓝底配深字(#60a5fa on #0f172a 文字),对比度 6.42。深色背景下反过来比白字清晰得多。
为什么类名都带 wxz- 前缀
CSS 是全局生效的,没有作用域概念。只要把 <style> 加进页面,里面的规则就会作用于整个站点,而不只是你粘贴的那一块。
这个组件用的类名如果不加前缀,写成 .kf、.btn、.float 这类短名,主题或插件里极可能已经有同名的类——.btn 是重灾区,几乎所有主题都有。一旦撞名,后加载的 CSS 会覆盖先加载的,站上所有按钮就莫名其妙变了。我实测过一组对照——把没加前缀的 CSS 注入一个已有同类名的站点:
| 站点原本的样式 | 被改成 |
|---|---|
.title 40px |
13px |
.meta 红色 |
#64748b |
.item 无边框、红底 |
多了边框、变白底 |
加上 wxz- 前缀后再测,污染为 0。
所以:
- 照抄时保留
wxz-前缀,别图省事改回短名字。 - 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效。
- 另外提醒:放进主题的自定义样式区是全站加载的。
改的时候注意这几点
- 客服按钮用
<a href>:它本质是"去某个地方"。要弹面板才用<button>。 - 别写
onclick:内联 JS 在加了 CSP 的站点上会被整体拦截,且不报错、难排查。单独存.js引入。 - 别用
div+cursor:pointer:看着能点,键盘根本到不了。 - 亮蓝要压深:
#409eff配白字只有 2.78。 - 别用
alert()做正式交互:它阻塞页面。跳转链接、唤起聊天窗口、打开mailto:都更合适。 z-index给足:9999 比较稳,避免被返回顶部之类的盖住。- 触屏放大到 44px:
@media (hover:none){min-height:44px}。 transition写具体属性:别用all。
怎么用
链接版:CSS 放进自定义样式区,HTML 放在 footer.php(或主题的页脚模板)里,把 href 换成你的客服地址。
button 版:CSS 同上,JS 单独存成 kf.js 放进主题目录,用 <script src="..."></script> 引入(注意别内联)。
这段代码是纯 HTML + CSS + 少量原生 JS,不依赖任何建站程序,WordPress、Typecho、Hexo、Hugo 都能直接用。
href 可以换成:
- 客服页面:
https://wxzcw.com/service - 邮件:
mailto:hi@wxzcw.com - QQ 临时会话:
https://wpa.qq.com/msgrd?v=3&uin=你的QQ&site=qq&menu=yes
兼容性
position:fixed、:focus-visible、@media (hover:none)、prefers-reduced-motion 在现代浏览器全系支持,微信内置浏览器也没问题。transition 全系支持。
代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。
作者:Flechazo
如若转载,请注明出处:维形筑网 https://wxzcw.com