diff --git a/packages/vant/docs/markdown/faq.en-US.md b/packages/vant/docs/markdown/faq.en-US.md index e830711590c..b0e328be33c 100644 --- a/packages/vant/docs/markdown/faq.en-US.md +++ b/packages/vant/docs/markdown/faq.en-US.md @@ -81,3 +81,7 @@ See [Adapt to PC Browsers](#/en-US/advanced-usage#adapt-to-pc-browsers). ### How do I implement mobile responsive adaptation? See [Browser Adaptation](#/en-US/advanced-usage#browser-adaptation). + +### Why are some components not compatible with Server-Side Rendering (SSR)? + +See [SSR Compatibility Issues](#/en-US/ssr-issue#intro). diff --git a/packages/vant/docs/markdown/faq.zh-CN.md b/packages/vant/docs/markdown/faq.zh-CN.md index 6c8a79c9cce..4a24392b31a 100644 --- a/packages/vant/docs/markdown/faq.zh-CN.md +++ b/packages/vant/docs/markdown/faq.zh-CN.md @@ -81,3 +81,7 @@ Vant 所有组件都是基于 Vue 框架实现的,没有针对 uni-app 进行 ### 如何进行移动端响应式适配? 参见[浏览器适配](#/zh-CN/advanced-usage#liu-lan-qi-gua-pei)。 + +### 部分组件无法兼容服务端渲染(SSR)场景? + +参见[SSR兼容问题](#/zh-CN/ssr-issue#jie-shao)。 diff --git a/packages/vant/docs/markdown/ssr-issue.en-US.md b/packages/vant/docs/markdown/ssr-issue.en-US.md new file mode 100644 index 00000000000..c8623cdbd46 --- /dev/null +++ b/packages/vant/docs/markdown/ssr-issue.en-US.md @@ -0,0 +1,11 @@ +# Server-Side Rendering (SSR) Compatibility + +### Intro + +Some components rely on DOM operations or browser APIs, which leads to compatibility issues in SSR scenarios, causing components to function incorrectly. + +### Components + +#### Tab + +The Tab component does not render in SSR scenarios. See [Tab title cannot be SSR](https://github.com/youzan/vant/issues/5278). diff --git a/packages/vant/docs/markdown/ssr-issue.zh-CN.md b/packages/vant/docs/markdown/ssr-issue.zh-CN.md new file mode 100644 index 00000000000..3a5696108a5 --- /dev/null +++ b/packages/vant/docs/markdown/ssr-issue.zh-CN.md @@ -0,0 +1,11 @@ +# 服务端渲染(SSR)兼容性问题 + +### 介绍 + +某些组件实现依赖于 DOM 操作或浏览器的API,SSR 场景下会存在兼容性问题,导致组件无法正常工作。 + +### 组件 + +#### Tab + +Tab组件在SSR场景下不会渲染,见[tab 组件的title无法ssr](https://github.com/youzan/vant/issues/5278)。 diff --git a/packages/vant/src/tab/README.md b/packages/vant/src/tab/README.md index 2063c787c6f..d59269d4214 100644 --- a/packages/vant/src/tab/README.md +++ b/packages/vant/src/tab/README.md @@ -4,6 +4,8 @@ Used to switch between different content areas. +> ⚠️ **Attention**: The Tab component has compatibility issues in SSR (Server-Side Rendering) scenarios. For details, see [SSR Compatibility Issues](#/en-US/ssr-issue#tab). + ### Install Register component globally via `app.use`, refer to [Component Registration](#/en-US/advanced-usage#zu-jian-zhu-ce) for more registration ways. diff --git a/packages/vant/src/tab/README.zh-CN.md b/packages/vant/src/tab/README.zh-CN.md index d9e01052b26..248d168eb21 100644 --- a/packages/vant/src/tab/README.zh-CN.md +++ b/packages/vant/src/tab/README.zh-CN.md @@ -4,6 +4,8 @@ 选项卡组件,用于在不同的内容区域之间进行切换。 +> ⚠️ **注意**:Tab组件在SSR(服务端渲染)场景存在兼容性问题,详见[SSR兼容性问题](#/zh-CN/ssr-issue#tab)。 + ### 引入 通过以下方式来全局注册组件,更多注册方式请参考[组件注册](#/zh-CN/advanced-usage#zu-jian-zhu-ce)。 diff --git a/packages/vant/vant.config.mjs b/packages/vant/vant.config.mjs index 571896a700f..5b4312ca2ef 100644 --- a/packages/vant/vant.config.mjs +++ b/packages/vant/vant.config.mjs @@ -108,6 +108,10 @@ location.href = location.href.replace('youzan.github.io', 'vant-ui.github.io'); path: 'locale', title: '国际化', }, + { + path: 'ssr-issue', + title: 'SSR兼容问题', + }, ], }, { @@ -580,6 +584,10 @@ location.href = location.href.replace('youzan.github.io', 'vant-ui.github.io'); path: 'locale', title: 'Internationalization', }, + { + path: 'ssr-issue', + title: 'SSR Issues', + }, ], }, {