article-list-json

发表于 2026-07-17

最后修改 2026-08-15

阅读量 —

ArticleList 组件（docs/.vitepress/theme/components/articleList/ArticleList.vue）的文章清单数据目录。

每个 JSON 文件是一份人工维护的文章清单，由页面通过 file-base-name 属性指定：

<ArticleList file-base-name="featured-articles" />

文件格式

json

{
  "description": "清单用途说明，仅供维护者阅读",
  "featured": ["/work-visas/stem-opt/stem-opt-101"],
  "articles": ["/work-visas/employee-or-contractor"]
}

articles：站内路径数组，约定为根路径、无 .md 后缀（与 articleListMeta.data.ts 的 key 对齐）
featured：可选的精选子集，仅 <ArticleList featured /> 会读；按数组顺序渲染、不排序、至多 6 条，缺省时回退到 articles 的前 6 条
标题、描述、封面图（image，图床外链）、日期、作者等元数据不在此维护 —— 构建期 loader 会从目标页 frontmatter 自动解析

落地页内嵌用 featured 模式（隐去筛选/排序与分页），全量清单放在独立页面：

<ArticleList file-base-name="stem-opt-related-articles" featured />

文件	用途
`featured-articles.json`	精选文章页 `docs/zhHans/cruise/article-list.md` 的清单
`pre-contact-reading.json`	联系前请阅读清单（`ContactChannelWizard.vue` 底部）
`cpt-related-articles.json`	CPT 轻量工作着陆页「更多方案与资料」清单（`CptSolutionLanding.vue`），全量列表在 `docs/zhHans/cruise/cpt-article-list.md`
`opt-related-articles.json`	OPT 轻量工作着陆页「更多方案与资料」清单（`OptSolutionLanding.vue`），全量列表在 `docs/zhHans/cruise/opt-article-list.md`
`stem-opt-related-articles.json`	STEM OPT 轻量工作着陆页「更多方案与资料」清单（`StemOptSolutionLanding.vue`），全量列表在 `docs/zhHans/cruise/stem-opt-article-list.md`
`h1b-transfer-in-related-articles.json`	H1b Transfer In 着陆页「更多方案与资料」清单（`H1bTransferInSolutionLanding.vue`）
`h1b-file-related-articles.json`	H1b File 着陆页「更多方案与资料」清单（`H1bFileSolutionLanding.vue`）
`maintain-opt-related.json`	OPT 维持在职落地页「更多方案与资料」清单（`MaintainOptSolutionLanding.vue`）
`maintain-h1b-related.json`	H1b 维持在职落地页「更多方案与资料」清单（`MaintainH1bSolutionLanding.vue`）
`maintain-stem-opt-related.json`	STEM OPT 维持在职落地页「更多方案与资料」清单（`MaintainStemOptSolutionLanding.vue`）