Foundation Joyride

Foundation Joyride(页面引导游)详解(超级完整版,一次讲透)
我们继续你的 Foundation 系列,今天把 Joyride 讲得明明白白!Joyride 是 ZURB 为 Foundation 开发的页面引导插件,用于创建新手引导、功能游览(feature tour),通过气泡提示一步步引导用户熟悉界面。支持自动启动、Cookie 记住、暴露高亮、模态模式等。

重要提醒:Joyride 在 Foundation 5 中内置,在 Foundation 6+ 中已分离为独立插件(GitHub: zurb/joyride),需单独引入(兼容 Foundation 6)。它依赖 Tooltip 组件。

1. 基本结构(Foundation 6+ 独立版)

<ol data-joyride id="myJoyride">
  <li data-target="#element1">
    <h5>第一步</h5>
    <p>这里解释第一个功能</p>
  </li>
  <li data-target="#element2" data-position="bottom">
    <h5>第二步</h5>
    <p>支持指定位置:top/bottom/left/right</p>
  </li>
  <li>  <!-- 无 target 时为模态提示 -->
    <h5>结束</h5>
    <p>谢谢体验!</p>
    <button class="button" data-joyride-close>完成</button>
  </li>
</ol>

<!-- 触发按钮 -->
<button data-joyride-start="#myJoyride">开始引导</button>

2. 自动启动 + Cookie 记住

data-autostart="true" 自动开始,支持 localStorage/Cookie 只显示一次。

3. 高级选项

  • data-position:提示位置
  • data-closable="false":不可关闭
  • data-next-text / data-prev-text:自定义按钮文字
  • 暴露高亮(expose):自动加遮罩高亮目标元素

4. 今天直接给你抄的完整代码(Foundation 6 + Joyride 独立版,复制就能跑)

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/foundation-sites@6.8.1/dist/css/foundation.min.css">
  <!-- Joyride CSS(独立版) -->
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/foundation-joyride@3.0.0/dist/foundation.joyride.min.css">
</head>
<body>

<button class="button large" data-joyride-start="#tour">开始新手引导</button>

<div id="element1" style="margin:50px; padding:20px; background:#eee;">
  <h4>这是第一个目标元素</h4>
</div>

<div id="element2" style="margin:100px; padding:20px; background:#ddd;">
  <h4>这是第二个目标元素</h4>
</div>

<ol data-joyride id="tour" data-autostart="false">
  <li data-target="#element1">
    <h5>欢迎!第一步</h5>
    <p>这里是你的仪表盘概览</p>
  </li>
  <li data-target="#element2" data-position="top">
    <h5>第二步</h5>
    <p>点击这里添加新项目</p>
  </li>
  <li>
    <h5>引导结束 🎉</h5>
    <p>现在你可以自由探索了!</p>
    <button class="button success" data-joyride-close>知道了</button>
  </li>
</ol>

<script src="https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/foundation-sites@6.8.1/dist/js/foundation.min.js"></script>
<!-- Joyride JS(独立版) -->
<script src="https://cdn.jsdelivr.net/npm/foundation-joyride@3.0.0/dist/foundation.joyride.min.js"></script>
<script>$(document).foundation();</script>
</body>
</html>

下面给你看真实效果(Joyride 引导游的经典演示截图):

官方仓库 & 文档:

  • GitHub(最新版):https://github.com/zurb/joyride
  • 老版(Foundation 5):https://get.foundation/sites/docs-v5/components/joyride.html

你现在想干嘛?
→ 明天终于讲 Foundation 表格(Table)?
→ 帮我做一个 5 步的新手引导(带高亮和 Cookie 只显示一次)?
→ 给我一个结合 Off-Canvas 的后台引导代码?

直接回复下一句:
“明天讲 table”
“帮我做新手引导”
“给我后台 Joyride”

我立刻给你写好!

文章已创建 3216

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

相关文章

开始在上面输入您的搜索词,然后按回车进行搜索。按ESC取消。

返回顶部