# Fumadocs (Framework Mode, React Router): ZBSearch（預設）
URL: /zh-TW/docs/react-router/search/orama
Source: https://raw.githubusercontent.com/fuma-nama/fumadocs/refs/heads/main/apps/docs/content/docs/(framework)/[framework]/search/orama.zh-TW.mdx
以 ZBSearch 為基礎的預設搜尋引擎。
## 概覽 [#overview]
Fumadocs 預設已設定好 [ZBSearch 搜尋引擎](/docs/headless/search/orama)，開箱即用。
搜尋會透過伺服器上執行的 API 端點進行；若是靜態網站，則改用靜態快取的 JSON 檔案。
## 設定 [#setup]
建立搜尋對話方塊。
預設的搜尋對話方塊即使用此用戶端。若要自訂搜尋對話方塊，請重新建立它：
```tsx title="components/search.tsx"
'use client';
import { useFetchSearch } from 'fumadocs-core/search/client';
import {
SearchDialog,
SearchDialogClose,
SearchDialogContent,
SearchDialogHeader,
SearchDialogIcon,
SearchDialogInput,
SearchDialogList,
SearchDialogOverlay,
type SharedProps,
} from 'fumadocs-ui/components/dialog/search';
import { useI18n } from 'fumadocs-ui/contexts/i18n';
export default function DefaultSearchDialog(props: SharedProps) {
const { locale } = useI18n(); // (optional) for i18n
const search = useFetchSearch({
locale,
});
return (
);
}
```
若為靜態網站，請在搜尋伺服器上設定[靜態模式](/docs/headless/search/orama#static-export)，並使用 `static` 用戶端：
```tsx title="components/search.tsx"
'use client';
import {
SearchDialog,
SearchDialogClose,
SearchDialogContent,
SearchDialogHeader,
SearchDialogIcon,
SearchDialogInput,
SearchDialogList,
SearchDialogOverlay,
type SharedProps,
} from 'fumadocs-ui/components/dialog/search';
import { useStaticSearch } from 'fumadocs-core/search/client';
import { useI18n } from 'fumadocs-ui/contexts/i18n';
export default function DefaultSearchDialog(props: SharedProps) {
const { locale } = useI18n(); // (optional) for i18n
const search = useStaticSearch({
locale,
});
return (
);
}
```
### 替換搜尋對話方塊 [#replace-search-dialog]
請在根版面配置中，將您的搜尋對話方塊傳入 [``](/docs/ui/layouts/root-provider)：
```tsx title="app/root.tsx"
import { Links, Meta, Scripts, ScrollRestoration } from 'react-router';
import { RootProvider } from 'fumadocs-ui/provider/react-router';
// [!code ++]
import SearchDialog from '@/components/search';
export function Layout({ children }: { children: React.ReactNode }) {
return (
{/* [!code highlight] */}
{children}
);
}
```
### 標籤篩選 [#tag-filter]
您也可以視需要加入依標籤篩選結果的 UI。請在搜尋伺服器上設定[標籤篩選](/docs/headless/search/orama#tag-filter)，並加入以下內容：
```tsx
'use client';
import {
SearchDialog,
SearchDialogContent,
SearchDialogFooter,
SearchDialogOverlay,
type SharedProps,
TagsList,
TagsListItem,
} from 'fumadocs-ui/components/dialog/search';
import { useState } from 'react';
import { useFetchSearch } from 'fumadocs-core/search/client';
export default function CustomSearchDialog(props: SharedProps) {
// [!code ++]
const [tag, setTag] = useState();
const search = useFetchSearch({
tag, // [!code ++]
});
return (
...
{/* [!code ++:3] */}
My Value
);
}
```