用户游览对于 Web 应用程序来说是一项非常宝贵的可用性功能。它们可以让您有效地吸引新用户,并提供分步指南来帮助他们了解软件。导览还可以作为重复任务或高级功能的快速参考。
目标:跨页面游览解决方案
我们的目标是创建一个解决方案,让您能够在 React 应用程序中创建跨多个页面的入门体验。这是它的样子:
Ant Design Tour:本地解决方案
Ant Design 提供了 Tour 组件来创建交互式指南。但是,它有一些限制:
- 它在单个组件中本地工作。
- 它严重依赖 React refs,这使得跨多个页面的应用程序不太灵活。
这是官方文档中的一个示例,演示了基本的本地实现:
import React, { useRef, useState } from 'react'; import { EllipsisOutlined } from '@ant-design/icons'; import { Button, Divider, Space, Tour } from 'antd'; const App = () => { const ref1 = useRef(null); const ref2 = useRef(null); const ref3 = useRef(null); const [open, setOpen] = useState(false); const steps = [ { title: 'Upload File', description: 'Put your files here.', target: () => ref1.current }, { title: 'Save', description: 'Save your changes.', target: () => ref2.current }, { title: 'Other Actions', description: 'Click to see other actions.', target: () => ref3.current }, ]; return ( <button type="primary" onclick="{()"> setOpen(true)}>Begin Tour</button> <divider></divider> <space> <button ref="{ref1}">Upload</button> <button ref="{ref2}" type="primary">Save</button> <button ref="{ref3}" icon="{<EllipsisOutlined"></button>} /> </space> <tour open="{open}" onclose="{()"> setOpen(false)} steps={steps} /> > ); }; export default App; </tour>
虽然此实现对于单页面效果很好,但在 React 应用程序中跨页面游览的场景中却表现不佳。
我们的实现方式如下:
前置步骤,app.jsx,routes.jsx,routesNames.js :
import { RouterProvider } from "react-router-dom"; import AppRouter from "./routes"; export default function App() { return <routerprovider router="{AppRouter}"></routerprovider>; }
export const ROUTE_NAMES = { HOME: "/", ABOUT: "/about", };
import AppLayout from "./AppLayout"; import { createBrowserRouter } from "react-router-dom"; import { ROUTE_NAMES } from "./routeNames"; import { Home } from "./components/Home"; import { About } from "./components/About"; import { Result } from "antd"; import {TourProvider} from "./TourContext"; const GetItem = (label, key, icon, to, children = [], type) => { return !to ? { key, icon, children, label, type, } : { key, icon, to, label, }; }; const GetRoute = (path, element, params = null) => { return { path, element, }; }; const WithAppLayout = (Component) => <tourprovider><applayout>{Component}</applayout></tourprovider>; export const routeItems = [ GetItem("Home", "home", null, ROUTE_NAMES.HOME), GetItem("About", "about", null, ROUTE_NAMES.ABOUT), ]; const AppRouter = createBrowserRouter([ GetRoute(ROUTE_NAMES.HOME, WithAppLayout(<home></home>)), GetRoute(ROUTE_NAMES.ABOUT, WithAppLayout(<about></about>)), GetRoute( "*", <result status="404" title="404" subtitle="Sorry, the page you visited does not exist."></result> ), ]); export default AppRouter;
第 1 步:设置全球巡演环境
我们使用 React Context 来管理游览的全局状态,包括活动的游览步骤。
import React, { createContext, useState, useEffect } from "react"; import { useNavigate } from "react-router-dom"; import { APP_TOURS } from "./steps"; const TourContext = createContext(); export const TourProvider = ({ children }) => { const [isTourActive, setTourActive] = useState(false); const navigate = useNavigate(); useEffect(() => { if (isTourActive) { navigate("/home"); // Redirect to the starting point of the tour } }, [isTourActive, navigate]); return ( <tourcontext.provider value="{{" istouractive settouractive steps: app_tours> {children} </tourcontext.provider> ); }; export default TourContext;
第 2 步:定义全球巡演步骤
我们使用 querySelector 通过自定义 data-tour-id 属性动态获取元素,而不是 React refs。
const getTourStepElement = (id) => document.querySelector(`[data-tour-id="${id}"]`); export const APP_TOURS = { "/home": [ { title: "Upload File", description: "Put your files here.", target: () => getTourStepElement("upload") }, { title: "Save", description: "Save your changes.", target: () => getTourStepElement("save") }, { type: "navigate", to: "/about", title: "About Us", description: "Learn more about us." }, ], "/about": [ { title: "About Us", description: "Here's what we are all about.", target: () => getTourStepElement("about") }, ], };
第 3 步:创建全球游览组件
该组件动态处理跨页面的导航和步骤。
import React, { useContext } from "react"; import { Tour } from "antd"; import { useNavigate } from "react-router-dom"; import TourContext from "./TourContext"; export const GlobalTour = () => { const { isTourActive, steps, setTourActive } = useContext(TourContext); const navigate = useNavigate(); return ( <tour open="{isTourActive}" onclose="{()"> setTourActive(false)} steps={steps} onChange={(current) => { const step = steps[current]; if (step.type === "navigate") { navigate(step.to); } }} /> ); }; </tour>
第 4 步:集成到应用程序布局中
游览无缝集成到布局中,可从任何页面访问。
import React, { useContext } from "react"; import { Layout, Button } from "antd"; import { Link } from "react-router-dom"; import TourContext from "./TourContext"; import { GlobalTour } from "./GlobalTour"; const { Header, Content, Footer } = Layout; const AppLayout = ({ children }) => { const { setTourActive } = useContext(TourContext); return ( <layout> <header> <link to="/home">Home <link to="/about">About <button onclick="{()"> setTourActive(true)}>Start Tour</button> </header> <content>{children}</content> <footer>© {new Date().getFullYear()} My App</footer> <globaltour></globaltour> </layout> ); }; export default AppLayout;
第 5 步:添加步骤游览 ID
由于我们的游览跨越多个页面,我们将为我们想要在步骤中突出显示的每个组件分配 data-tour-id
import { Button, Space } from "antd"; import { EllipsisOutlined } from "@ant-design/icons"; export const Home = () => { return ( <button data-tour-id="upload">Upload</button> <button data-tour-id="save" type="primary"> Save </button> <button data-tour-id="actions" icon="{<EllipsisOutlined"></button>} /> > ); };
export const About = () => { return <div data-tour-id="about">About</div>; };
以上是设计和实现 React 应用程序的 Ant Design 全球应用程序之旅。的详细内容。更多信息请关注PHP中文网其他相关文章!

JavaScript字符串替换方法详解及常见问题解答 本文将探讨两种在JavaScript中替换字符串字符的方法:在JavaScript代码内部替换和在网页HTML内部替换。 在JavaScript代码内部替换字符串 最直接的方法是使用replace()方法: str = str.replace("find","replace"); 该方法仅替换第一个匹配项。要替换所有匹配项,需使用正则表达式并添加全局标志g: str = str.replace(/fi

利用轻松的网页布局:8个基本插件 jQuery大大简化了网页布局。 本文重点介绍了简化该过程的八个功能强大的JQuery插件,对于手动网站创建特别有用

因此,在这里,您准备好了解所有称为Ajax的东西。但是,到底是什么? AJAX一词是指用于创建动态,交互式Web内容的一系列宽松的技术。 Ajax一词,最初由Jesse J创造

本教程演示了创建通过Ajax加载的动态页面框,从而可以即时刷新,而无需全页重新加载。 它利用jQuery和JavaScript。将其视为自定义的Facebook式内容框加载程序。 关键概念: Ajax和JQuery

10款趣味横生的jQuery游戏插件,让您的网站更具吸引力,提升用户粘性!虽然Flash仍然是开发休闲网页游戏的最佳软件,但jQuery也能创造出令人惊喜的效果,虽然无法与纯动作Flash游戏媲美,但在某些情况下,您也能在浏览器中获得意想不到的乐趣。 jQuery井字棋游戏 游戏编程的“Hello world”,现在有了jQuery版本。 源码 jQuery疯狂填词游戏 这是一个填空游戏,由于不知道单词的上下文,可能会产生一些古怪的结果。 源码 jQuery扫雷游戏

此JavaScript库利用窗口。名称属性可以管理会话数据,而无需依赖cookie。 它为浏览器中存储和检索会话变量提供了强大的解决方案。 库提供了三种核心方法:会话

本教程演示了如何使用jQuery创建迷人的视差背景效果。 我们将构建一个带有分层图像的标题横幅,从而创造出令人惊叹的视觉深度。 更新的插件可与JQuery 1.6.4及更高版本一起使用。 下载


热AI工具

Undresser.AI Undress
人工智能驱动的应用程序,用于创建逼真的裸体照片

AI Clothes Remover
用于从照片中去除衣服的在线人工智能工具。

Undress AI Tool
免费脱衣服图片

Clothoff.io
AI脱衣机

AI Hentai Generator
免费生成ai无尽的。

热门文章

热工具

mPDF
mPDF是一个PHP库,可以从UTF-8编码的HTML生成PDF文件。原作者Ian Back编写mPDF以从他的网站上“即时”输出PDF文件,并处理不同的语言。与原始脚本如HTML2FPDF相比,它的速度较慢,并且在使用Unicode字体时生成的文件较大,但支持CSS样式等,并进行了大量增强。支持几乎所有语言,包括RTL(阿拉伯语和希伯来语)和CJK(中日韩)。支持嵌套的块级元素(如P、DIV),

Dreamweaver CS6
视觉化网页开发工具

SublimeText3 Mac版
神级代码编辑软件(SublimeText3)

SublimeText3 Linux新版
SublimeText3 Linux最新版

SublimeText3 英文版
推荐:为Win版本,支持代码提示!