Mixedbread
在 Fumadocs UI 中使用 Mixedbread。
設定
Mixedbread 搜尋會在請求時於您的伺服器上執行,因此不適用於靜態網站。
Fumadocs CLI 可以幫您完成設定,它會建立搜尋對話方塊、搜尋路由、static.json 路由,以及一個在每次建置後同步儲存區的指令碼:
npx @fumadocs/cli feature search --provider mixedbread-
建立搜尋對話方塊元件。
components/search.tsx 'use client'; import { SearchDialog, SearchDialogClose, SearchDialogContent, SearchDialogFooter, SearchDialogHeader, SearchDialogIcon, SearchDialogInput, SearchDialogList, SearchDialogOverlay, type SharedProps, } from 'fumadocs-ui/components/dialog/search'; import { useFetchSearch } from 'fumadocs-core/search/client'; import { useI18n } from 'fumadocs-ui/contexts/i18n'; export default function CustomSearchDialog(props: SharedProps) { const { locale } = useI18n(); // (optional) for i18n const search = useFetchSearch({ api: '/api/search', locale, // every search is a request to Mixedbread delayMs: 300, }); return ( <SearchDialog {...search} {...props}> <SearchDialogOverlay /> <SearchDialogContent> <SearchDialogHeader> <SearchDialogIcon /> <SearchDialogInput /> <SearchDialogClose /> </SearchDialogHeader> <SearchDialogList /> <SearchDialogFooter> <a href="https://mixedbread.com" rel="noreferrer noopener" className="ms-auto text-xs text-fd-muted-foreground" > Search powered by Mixedbread </a> </SearchDialogFooter> </SearchDialogContent> </SearchDialog> ); }
替換搜尋對話方塊
請在根路由中,將您的搜尋對話方塊傳入 <RootProvider />:
import { createRootRoute, HeadContent, Outlet, Scripts } from '@tanstack/react-router';
import { RootProvider } from 'fumadocs-ui/provider/tanstack';
import SearchDialog from '@/components/search';
export const Route = createRootRoute({
component: RootComponent,
});
function RootComponent() {
return (
<html suppressHydrationWarning>
<head>
<HeadContent />
</head>
<body className="flex flex-col min-h-screen">
<RootProvider search={{ SearchDialog }}>
<Outlet />
</RootProvider>
<Scripts />
</body>
</html>
);
}標籤篩選
您也可以視需要加入依標籤篩選結果的 UI。請在搜尋伺服器上設定標籤篩選,並加入以下內容:
'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) {
const [tag, setTag] = useState<string | undefined>();
const search = useFetchSearch({
tag,
});
return (
<SearchDialog {...search} {...props}>
<SearchDialogOverlay />
<SearchDialogContent>
...
<SearchDialogFooter className="flex flex-row">
<TagsList tag={tag} onTagChange={setTag}>
<TagsListItem value="my-value">My Value</TagsListItem>
</TagsList>
</SearchDialogFooter>
</SearchDialogContent>
</SearchDialog>
);
}How is this guide?
最後更新於
