常见问题Q&A

Q:控制台报websocket错误? 关闭自动连接客户端?

// 入口文件 main.js
import { disAutoConnect  } from 'sv-print';  //或者 @sv-print/hiprint
disAutoConnect();
// 或者
globalThis.autoConnect = false;

Q: 样式冲突? 项目依赖tailwindcss 3.x. 引入组件样式提示 `@layer utilities is used but no matching @tailwind utilities directive is present.`

自sv-print@0.2.15起, 组件使用 tailwindcss 4.x. 导致兼容性问题.

解决方案:

升级项目的 tailwindcss 到 4.x
复制组件样式到 public 目录. 直接在 index.html 中引入组件样式.(不参与工程化项目打包,可手动微调冲突样式).

<!-- 可改成相对路径 -->
<link rel="stylesheet" type="text/css" href="https://unpkg.com/sv-print@0.2.18/dist/style.css" />

Q: 客户端端无法正常连接?

由于 edge,chrome 内核更新. 可能导致本地 websocket 无法正常连接. 这是浏览器处于安全考虑的限制.

如图所示，首先看看页面权限是否可用，如果不行则禁用浏览器设置。

禁用: local networdk access checks。也就是禁用本地网络检测功能。

edge 设置路径 edge://flags/#local-network-access-check 改为 Disabled
chrome 设置路径 chrome://flags/#local-network-access-check 改为 Disabled