docs: rename eject-only tag to theme-only (#3169)

SoonIter · web-flow · commit 3207806c771e · 2026-02-28T15:50:54.000+08:00
diff --git a/website/docs/en/ui/_meta.json b/website/docs/en/ui/_meta.json
@@ -34,7 +34,7 @@
     "type": "dir",
     "label": "Layout Components",
     "name": "layout-components",
-    "tag": "eject-only"
+    "tag": "theme-only"
   },
   {
     "type": "section-header",
diff --git a/website/docs/en/ui/icons/index.mdx b/website/docs/en/ui/icons/index.mdx
@@ -1,6 +1,6 @@
 ---
 description: List of Rspress built-in icons and how to replace them via custom theme.
-tag: eject-only
+tag: theme-only
 ---
 
 # Built-in icons
diff --git a/website/docs/en/ui/layout-components/tag.mdx b/website/docs/en/ui/layout-components/tag.mdx
@@ -81,7 +81,7 @@ The component has built-in common tags that display with `<Badge />`. All common
 
 The Tag component is ejectable. When you want to extend common tags, you can use wrap/eject to modify the Tag component. The tag value is passed as props to the Tag component.
 
-Here's an example from this site adding a custom `eject-only` tag through wrap:
+Here's an example from this site adding a custom `theme-only` tag through wrap:
 
 ```tsx title="theme/components/Tag/index.tsx"
 import {
@@ -90,16 +90,16 @@ import {
 } from '@rspress/core/theme-original';
 
 export const Tag = ({ tag }: { tag: string }) => {
-  if (tag === 'eject-only') {
-    return <BasicBadge text="eject-only" type="warning" />;
+  if (tag === 'theme-only') {
+    return <BasicBadge text="theme-only" type="warning" />;
   }
   return <BasicTag tag={tag} />;
 };
 ```
 
 ```mdx title="index.mdx"
 ---
-tag: new, eject-only
+tag: new, theme-only
 ---
 ```
 
diff --git a/website/docs/zh/ui/_meta.json b/website/docs/zh/ui/_meta.json
@@ -34,7 +34,7 @@
     "type": "dir",
     "label": "布局组件",
     "name": "layout-components",
-    "tag": "eject-only"
+    "tag": "theme-only"
   },
   {
     "type": "section-header",
diff --git a/website/docs/zh/ui/icons/index.mdx b/website/docs/zh/ui/icons/index.mdx
@@ -1,6 +1,6 @@
 ---
 description: Rspress 内置图标列表，以及如何通过自定义主题替换图标。
-tag: eject-only
+tag: theme-only
 ---
 
 # 内置图标
diff --git a/website/docs/zh/ui/layout-components/tag.mdx b/website/docs/zh/ui/layout-components/tag.mdx
@@ -81,7 +81,7 @@ tag: new, experimental
 
 Tag 组件是 ejectable 的，当你想扩充常用标签时，可使用 wrap/eject 来对 Tag 组件进行修改，tag 的值会作为 props 传递给 Tag 组件。
 
-以下是一个本站通过 wrap 增加 `eject-only` 自定义标签的使用示例：
+以下是一个本站通过 wrap 增加 `theme-only` 自定义标签的使用示例：
 
 ```tsx title="theme/components/Tag/index.tsx"
 import {
@@ -90,16 +90,16 @@ import {
 } from '@rspress/core/theme-original';
 
 export const Tag = ({ tag }: { tag: string }) => {
-  if (tag === 'eject-only') {
-    return <BasicBadge text="eject-only" type="warning" />;
+  if (tag === 'theme-only') {
+    return <BasicBadge text="theme-only" type="warning" />;
   }
   return <BasicTag tag={tag} />;
 };
 ```
 
 ```mdx title="index.mdx"
 ---
-tag: new, eject-only
+tag: new, theme-only
 ---
 ```
 
diff --git a/website/theme/components/Tag/index.tsx b/website/theme/components/Tag/index.tsx
@@ -8,8 +8,8 @@ export const Tag = ({ tag }: { tag?: string }) => {
     return null;
   }
 
-  if (tag === 'eject-only') {
-    return <BasicBadge text="eject-only" type="warning" />;
+  if (tag === 'theme-only') {
+    return <BasicBadge text="theme-only" type="warning" />;
   }
   if (tag === 'non-ejectable') {
     return <BasicBadge text="non-ejectable" type="danger" />;

Original file line number	Diff line number	Diff line change
`@@ -34,7 +34,7 @@`
`34`	`34`	`"type": "dir",`
`35`	`35`	`"label": "Layout Components",`
`36`	`36`	`"name": "layout-components",`
`37`		`- "tag": "eject-only"`
	`37`	`+ "tag": "theme-only"`
`38`	`38`	`},`
`39`	`39`	`{`
`40`	`40`	`"type": "section-header",`
Original file line number	Diff line number	Diff line change
`@@ -8,8 +8,8 @@ export const Tag = ({ tag }: { tag?: string }) => {`
`8`	`8`	`return null;`
`9`	`9`	`}`
`10`	`10`
`11`		`- if (tag === 'eject-only') {`
`12`		`- return <BasicBadge text="eject-only" type="warning" />;`
	`11`	`+ if (tag === 'theme-only') {`
	`12`	`+ return <BasicBadge text="theme-only" type="warning" />;`
`13`	`13`	`}`
`14`	`14`	`if (tag === 'non-ejectable') {`
`15`	`15`	`return <BasicBadge text="non-ejectable" type="danger" />;`