差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| astro [2026/10/14 11:42] – 创建 张叶安 | astro [2026/10/14 11:45] (当前版本) – 为 astro 页面添加落地页设计思维导图 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== Astro 使用与落地页(Landing Page)设计 ====== |
| + | |||
| + | Astro 是一个**内容优先**的 Web 框架:默认输出静态 HTML、**默认零 JavaScript**,只在真正需要交互的局部" | ||
| + | |||
| + | ===== 一、为什么落地页适合用 Astro ===== | ||
| + | |||
| + | * **默认零 JS**:页面就是 HTML + CSS,LCP 快、CLS 小,移动端体验直接受益。 | ||
| + | * **岛屿架构(Islands)**:整页静态,只有轮播、表单、定价切换这类部件按需加载 JS。 | ||
| + | * **写 HTML 就是写组件**:'' | ||
| + | * **样式自动隔离**:组件里的样式块默认 scoped,不用起类名前缀也不会串样式。 | ||
| + | * **内容与数据分离**:'' | ||
| + | * **部署简单**:'' | ||
| + | |||
| + | ===== 二、快速开始 ===== | ||
| + | |||
| + | <code bash> | ||
| + | # 创建项目(官方脚手架,会引导你选模板与依赖) | ||
| + | npm create astro@latest my-landing | ||
| + | |||
| + | cd my-landing | ||
| + | npm install | ||
| + | |||
| + | npm run dev # 开发服务器,默认 http:// | ||
| + | npm run build # 产出静态站点到 dist/ | ||
| + | npm run preview | ||
| + | </ | ||
| + | |||
| + | 配置文件通常只写必要的几行: | ||
| + | |||
| + | <code js> | ||
| + | // astro.config.mjs | ||
| + | import { defineConfig } from ' | ||
| + | import sitemap from ' | ||
| + | |||
| + | export default defineConfig({ | ||
| + | site: ' | ||
| + | integrations: | ||
| + | }); | ||
| + | </ | ||
| + | |||
| + | ===== 三、目录结构 ===== | ||
| + | |||
| + | ^ 路径 ^ 作用 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | ===== 四、.astro 组件基础 ===== | ||
| + | |||
| + | 文件顶部用三条短横线包起来的区域是 **frontmatter**(构建时运行的 JS/TS 代码),下面就是模板: | ||
| + | |||
| + | < | ||
| + | // src/ | ||
| + | |||
| + | const { title, subtitle, ctaText = ' | ||
| + | |||
| + | <section class=" | ||
| + | < | ||
| + | < | ||
| + | <a class=" | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | 其中 '' | ||
| + | |||
| + | <code css> | ||
| + | .hero { padding: 6rem 1.5rem; text-align: center; } | ||
| + | .hero h1 { font-size: clamp(2rem, 5vw, 3.5rem); line-height: | ||
| + | .btn { | ||
| + | display: inline-block; | ||
| + | background: #4f46e5; color: #fff; text-decoration: | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | 在页面里引用它,并传入文案: | ||
| + | |||
| + | < | ||
| + | // src/ | ||
| + | |||
| + | import Layout from ' | ||
| + | import Hero from ' | ||
| + | |||
| + | <Layout title=" | ||
| + | <Hero | ||
| + | title=" | ||
| + | subtitle=" | ||
| + | ctaText=" | ||
| + | ctaHref="/ | ||
| + | /> | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | **要点**:文案通过 props 传入,组件只管排版。这样同一个 Hero 可以复用到不同活动的落地页,只换数据。 | ||
| + | |||
| + | ===== 五、岛屿:按需加水合 ===== | ||
| + | |||
| + | 只有需要状态和事件的组件才需要引入框架(React / Vue / Svelte / Solid / Preact),并加上客户端指令: | ||
| + | |||
| + | < | ||
| + | import PricingToggle from ' | ||
| + | import LeadForm from ' | ||
| + | import ChatWidget from ' | ||
| + | |||
| + | <!-- 首屏可见且需要立刻响应 --> | ||
| + | < | ||
| + | |||
| + | <!-- 滚到可视区域才加载:省首屏开销,落地页最常用 --> | ||
| + | < | ||
| + | |||
| + | <!-- 主线程空闲时加载 --> | ||
| + | < | ||
| + | </ | ||
| + | |||
| + | ^ 指令 ^ 何时水合 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | 落地页的经验法则:**能静态就静态**。表单校验、定价切换、评价轮播、聊天挂件各做成一个岛;导航、Hero、功能列表全部保持静态。 | ||
| + | |||
| + | ===== 六、数据驱动的内容 ===== | ||
| + | |||
| + | 把反复出现的营销数据放进 '' | ||
| + | |||
| + | <code ts> | ||
| + | // src/ | ||
| + | export const features = [ | ||
| + | { icon: ' | ||
| + | { icon: ' | ||
| + | { icon: ' | ||
| + | ]; | ||
| + | </ | ||
| + | |||
| + | < | ||
| + | import { features } from ' | ||
| + | |||
| + | <section class=" | ||
| + | {features.map((f) => ( | ||
| + | <article class=" | ||
| + | <div class=" | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | ))} | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | 需要 Markdown / MDX 内容时(博客、案例页),用 Content Collections。Astro 5 的写法是在 '' | ||
| + | |||
| + | <code ts> | ||
| + | import { defineCollection, | ||
| + | import { glob } from ' | ||
| + | |||
| + | const cases = defineCollection({ | ||
| + | loader: glob({ pattern: ' | ||
| + | schema: z.object({ | ||
| + | title: z.string(), | ||
| + | customer: z.string(), | ||
| + | logo: z.string().optional(), | ||
| + | date: z.coerce.date(), | ||
| + | }), | ||
| + | }); | ||
| + | |||
| + | export const collections = { cases }; | ||
| + | </ | ||
| + | |||
| + | 这样 frontmatter 字段写错会在构建时直接报错,而不是上线后才发现页面缺图。 | ||
| + | |||
| + | ===== 七、样式与图片 ===== | ||
| + | |||
| + | **样式**:组件里的样式块默认只作用于当前组件。品牌色、正文字色、容器宽度、圆角这类**设计令牌**建议集中放在全局 CSS 里('' | ||
| + | |||
| + | <code css> | ||
| + | /* 全局设计令牌集中在这里:品牌色 / 正文字色 / 辅助文字色 / 容器最大宽 / 圆角 */ | ||
| + | .container { max-width: 1120px; margin-inline: | ||
| + | .section { padding-block: | ||
| + | </ | ||
| + | |||
| + | 用 Tailwind 也可以。Tailwind v4 的推荐方式是走 Vite 插件: | ||
| + | |||
| + | <code js> | ||
| + | import { defineConfig } from ' | ||
| + | import tailwindcss from ' | ||
| + | |||
| + | export default defineConfig({ | ||
| + | vite: { plugins: [tailwindcss()] }, | ||
| + | }); | ||
| + | </ | ||
| + | |||
| + | **图片**:放在 '' | ||
| + | |||
| + | < | ||
| + | import { Image } from ' | ||
| + | import screenshot from ' | ||
| + | |||
| + | <Image src={screenshot} alt=" | ||
| + | </ | ||
| + | |||
| + | ===== 八、落地页的信息架构 ===== | ||
| + | |||
| + | 一个能被验证有效的落地页,结构基本是固定的。建议就按这个顺序拆组件: | ||
| + | |||
| + | ^ 区块 ^ 目的 ^ 组件 ^ | ||
| + | | 导航 | 减少迷失,露出主 CTA | '' | ||
| + | | Hero | 3 秒讲清" | ||
| + | | 社会证明 | 客户 logo、数据、媒体背书 | '' | ||
| + | | 问题—方案 | 制造共鸣,指出旧做法为什么不行 | '' | ||
| + | | 功能卖点 | 3—6 个,配截图或动图 | '' | ||
| + | | 演示 | 真实界面或视频,降低想象成本 | '' | ||
| + | | 用户评价 | 信任转移 | '' | ||
| + | | 定价 | 给出选择,标出推荐项 | '' | ||
| + | | FAQ | 打消最后疑虑 | '' | ||
| + | | 结尾 CTA | 再要一次转化 | '' | ||
| + | | 页脚 | 合规、导航、联系方式 | '' | ||
| + | |||
| + | ===== 九、设计要点(比框架更重要) ===== | ||
| + | |||
| + | * **一个页面一个目标**。落地页只服务一个转化动作(注册 / 试用 / 预约 / 下载),其他链接都算干扰。 | ||
| + | * **首屏讲价值,不讲功能**。标题公式:为【目标用户】解决【痛点】,无需【旧做法的代价】。副标题补一句机制或证据。 | ||
| + | * **标题层级只有 3 级**。H1 一个,区块用 H2,卡片标题用 H3。用语义层级表达结构,不只是用字号。 | ||
| + | * **留白是最便宜的高级感**。区块上下间距 6rem 左右,容器最大宽 1100—1200px,正文行宽 60—75 字符。 | ||
| + | * **CTA 全页重复 3 次以上**:Hero、中部、结尾。同一个动作、同一套文案,颜色全程一致。 | ||
| + | * **用具体数字代替形容词**。" | ||
| + | * **移动优先**。先做 375px 宽度的排版,再用 '' | ||
| + | * **可访问性就是可用性**:对比度不低于 4.5: | ||
| + | |||
| + | ===== 十、性能与 SEO 清单 ===== | ||
| + | |||
| + | * '' | ||
| + | * '' | ||
| + | * 首屏图片不要懒加载:'' | ||
| + | * 字体用 '' | ||
| + | * 埋点脚本加 '' | ||
| + | * 上线前跑一次 Lighthouse / PageSpeed,重点看 **LCP、CLS、INP** 三项。 | ||
| + | * 需要 OG 图时,可以手写静态图,或用 '' | ||
| + | |||
| + | ===== 十一、常见坑 ===== | ||
| + | |||
| + | * **在 .astro 里直接写内联事件**:没有框架运行时,内联事件属性不会生效,要么加原生 script 块,要么把它做成岛。 | ||
| + | * **把整页做成一个 React 组件**:等于放弃 Astro 的优势,退回 SPA 的体积。 | ||
| + | * **图片全塞 public/ | ||
| + | * **frontmatter 区域没闭合**:文件会直接构建失败。 | ||
| + | * **在静态输出下用服务端能力**:需要请求期渲染时才引入 adapter,并给页面显式声明 '' | ||
| + | |||
| + | ===== 十二、参考 ===== | ||
| + | |||
| + | * Astro 官方文档:[[https:// | ||
| + | * Astro 主题与模板:[[https:// | ||
| + | |||
| + | ```mdk height=520 color=# | ||
| + | # Astro 落地页 | ||
| + | |||
| + | ## 为什么用 Astro | ||
| + | ### 默认零 JS | ||
| + | ### 岛屿架构,按需水合 | ||
| + | ### 文件路由 + 组件化 | ||
| + | ### 静态产物,随处部署 | ||
| + | |||
| + | ## 项目骨架 | ||
| + | - src/pages 文件路由 | ||
| + | - src/layouts 页面外壳 | ||
| + | - src/ | ||
| + | - src/data 与 content 数据驱动 | ||
| + | - src/assets 待优化图片 | ||
| + | - public 原样拷贝 | ||
| + | - astro.config.mjs 站点与集成 | ||
| + | |||
| + | ## 岛屿策略 | ||
| + | - 能静态就静态 | ||
| + | - client:load 立刻交互 | ||
| + | - client: | ||
| + | - client:idle 空闲加载 | ||
| + | - 只有表单/ | ||
| + | |||
| + | ## 落地页结构 | ||
| + | ### Hero 价值主张 + 主 CTA | ||
| + | ### 社会证明 logos 与数据 | ||
| + | ### 问题到方案 | ||
| + | ### 功能卖点 3 到 6 个 | ||
| + | ### 演示与截图 | ||
| + | ### 用户评价 | ||
| + | ### 定价与推荐项 | ||
| + | ### FAQ | ||
| + | ### 结尾 CTA 与页脚 | ||
| + | |||
| + | ## 设计要点 | ||
| + | - 一页一个转化目标 | ||
| + | - 标题写为谁解决什么 | ||
| + | - 语义层级 H1 到 H3 | ||
| + | - 留白与容器宽度 | ||
| + | - CTA 重复三次 | ||
| + | - 用数字替代形容词 | ||
| + | - 移动优先 | ||
| + | |||
| + | ## 性能与 SEO | ||
| + | - site 配置与 canonical | ||
| + | - sitemap 集成 | ||
| + | - 首屏图片 eager | ||
| + | - 字体 swap 与预加载 | ||
| + | - 看 LCP CLS INP | ||
| + | |||
| + | ## 常见坑 | ||
| + | - 内联事件不生效 | ||
| + | - 整页塞进一个框架组件 | ||
| + | - 图片放 public 不优化 | ||
| + | - frontmatter 未闭合 | ||
| + | - 静态模式误用服务端能力 | ||
| + | ``` | ||