# @ankhorage/surface 中文文档 规范地址：https://npmcn.com/package/%40ankhorage/surface/ 版本：9\.4\.15 npm 元数据更新时间：2026-11-04T23:33:33.868Z 中文译文更新时间：2026-11-06T05:09:38.931Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40ankhorage/surface 原文对照：https://npmcn.com/package/%40ankhorage/surface/?lang=original 项目主页：https://github.com/ankhorage/surface#readme 源码仓库：https://github.com/ankhorage/surface ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.3 MB，1068 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：4 个 - peer 依赖：react 19\.2\.3 \|\| 19\.3\.0，react-native 0\.86\.x \|\| 0\.87\.x，react-native-svg 15\.15\.4 \|\| 15\.15\.5，react-native-web ~0\.21\.0，react-native-worklets 0\.10\.1 \|\| 0\.13\.0，react-native-reanimated 4\.5\.1 \|\| 4\.7\.0 \|\| 4\.7，react-native-gesture-handler ~2\.32\.0 \|\| ~3\.3\.0，react-native-safe-area-context ~5\.7\.0 \|\| ~5\.10\.0，@react-native-vector-icons/ionicons ^13\.1\.3，@react-native-vector-icons/fontawesome ^13\.1\.4，@react-native-vector-icons/fontawesome5 ^13\.1\.3，@react-native-vector-icons/fontawesome6 ^13\.1\.3，@react-native-vector-icons/material-design-icons ^13\.1\.3 - 首次发布：2026-04-03T23:29:48.935Z - 最新版本发布：2026-11-04T23:33:33.521Z - 近 30 天下载量：18758（2026-10-06 至 2026-11-04，npm 官方下载统计） - 已发布版本数：216（近 12 个月 216 个） ## 中文简介 稳定地UI基金会 React土著和React土著网络. ## 安装 ```sh npm install @ankhorage/surface ``` 也可以使用：`pnpm add @ankhorage/surface`、`yarn add @ankhorage/surface`、`bun add @ankhorage/surface` ## README # @ankhorage/地表图 ![license: MIT](https://npmcn.com/package/%40ankhorage/surface/paradox/badges/license.svg) ![npm: v9.4.15](https://npmcn.com/package/%40ankhorage/surface/paradox/badges/npm.svg) ![runtime: bun](https://npmcn.com/package/%40ankhorage/surface/paradox/badges/runtime.svg) ![typescript: strict](https://npmcn.com/package/%40ankhorage/surface/paradox/badges/typescript.svg) ![eslint: checked](https://npmcn.com/package/%40ankhorage/surface/paradox/badges/eslint.svg) ![prettier: checked](https://npmcn.com/package/%40ankhorage/surface/paradox/badges/prettier.svg) ![build: checked](https://npmcn.com/package/%40ankhorage/surface/paradox/badges/build.svg) ![tests: checked](https://npmcn.com/package/%40ankhorage/surface/paradox/badges/tests.svg) ![paradox: warnings](https://npmcn.com/package/%40ankhorage/surface/paradox/badges/docs.svg) 跨平台的UI基金会用于回放原生和回放原生网络. 为现代应用提供主题,布局原始,核心构件. ## 生成的文件 - [交互式文件应用](https://npmcn.com/package/%40ankhorage/surface/paradox/index.html) - [公共 API 参考](https://npmcn.com/package/%40ankhorage/surface/paradox/exports.md) - [构成部分登记册](https://npmcn.com/package/%40ankhorage/surface/paradox/components.md) - [结构概览](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/architecture-overview.mmd) - [模块关系](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/module-relationships.mmd) - [导出图](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/export-graph.mmd) - [动脉序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/accordion.mmd) - [Appbar 序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/app-bar.mmd) - [徽章顺序](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/badge.mmd) - [按钮序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/button.mmd) - [卡片序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/card.mmd) - [复选框序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/checkbox.mmd) - [实地序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/field.mmd) - [字体提供序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/font-provider.mmd) - [图标序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/icon.mmd) - [图标按钮序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/icon-button.mmd) - [列表项目序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/list-item.mmd) - [模块序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/modal.mmd) - [弹出式序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/popover.mmd) - [Popover 梅努 序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/popover-menu.mmd) - [无线电序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/radio.mmd) - [解析响应序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/resolve-responsive.mmd) - [响应序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/responsive-provider.mmd) - [显示序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/show.mmd) - [表面序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/surface.mmd) - [切换序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/switch.mmd) - [标签列表序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/tab-list.mmd) - [分页序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/tab-panel.mmd) - [标签序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/tabs.mmd) - [文本序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/text.mmd) - [主题提供序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/theme-provider.mmd) - [主题范围序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/theme-scope.mmd) - [土司顺序](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/toast.mmd) - [托斯特提供序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/toast-provider.mmd) - [工具提示序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/tooltip.mmd) - [使用断点序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/use-breakpoint.mmd) - [反应运行时序](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/use-responsive-runtime.mmd) - [使用主题序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/use-theme.mmd) - [使用图示序列](https://npmcn.com/package/%40ankhorage/surface/paradox/diagrams/sequences/use-toast.mmd) ## 常见问题 ### @ankhorage/surface 是什么？ 稳定地UI基金会 React土著和React土著网络\. ### 如何安装 @ankhorage/surface？ 在项目目录运行 npm install @ankhorage/surface，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（19\.2\.3 \|\| 19\.3\.0）、react-native（0\.86\.x \|\| 0\.87\.x）、react-native-svg（15\.15\.4 \|\| 15\.15\.5）、react-native-web（~0\.21\.0）、react-native-worklets（0\.10\.1 \|\| 0\.13\.0）、react-native-reanimated（4\.5\.1 \|\| 4\.7\.0 \|\| 4\.7）、react-native-gesture-handler（~2\.32\.0 \|\| ~3\.3\.0）、react-native-safe-area-context（~5\.7\.0 \|\| ~5\.10\.0）、@react-native-vector-icons/ionicons（^13\.1\.3）、@react-native-vector-icons/fontawesome（^13\.1\.4）、@react-native-vector-icons/fontawesome5（^13\.1\.3）、@react-native-vector-icons/fontawesome6（^13\.1\.3）、@react-native-vector-icons/material-design-icons（^13\.1\.3）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @ankhorage/surface 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @ankhorage/surface 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @ankhorage/surface 可以商用吗？ @ankhorage/surface 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @ankhorage/surface 的下载量有多少？ 根据 npm 官方下载统计，@ankhorage/surface 在 2026/10/06 – 2026/11/04 这 30 天内被下载 18,758 次，日均约 625 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @ankhorage/surface 还在维护吗？ 最新版本 9\.4\.15 发布于 2026/11/05（1 天前）；至今共发布 216 个版本，其中过去 12 个月发布了 216 个；首次发布于 2026/04/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。