Pressto 设计系统集成:把主题元数据安全带入 worklet 的终极方案
Pressto 设计系统集成把主题元数据安全带入 worklet 的终极方案【免费下载链接】presstoYour React Native app deserves better tap interactions.项目地址: https://gitcode.com/gh_mirrors/pre/presstoPressto 是一个面向 React Native 的主线程动画可按压组件库它让你用一个metadata字段就能把设计系统主题元数据安全地带入 Reanimated 的worklet并全程保持类型安全。下面这份指南手把手带你打通这条链路。为什么主题元数据难进 worklet在 Reanimated 里动画函数worklet运行在UI 线程而普通 JS 变量、主题对象活在JS 线程——两个线程天然隔离。这就是痛点你明明定义了漂亮的设计系统主题却无法在 worklet 里直接theme.colors.primary否则要么拿到undefined要么触发跨线程报错。Pressto 的答案非常克制一个类型化的metadata字段把主题对象整体穿墙送进 worklet且在 TypeScript 层给你完整的自动补全。核心原理一字段贯穿主题与 worklet整个机制由三层协作完成源码见 src/pressables/base.tsx类型层——createAnimatedPressableTMetadata()用泛型把你定义的主题类型注入 worklet配置层——PressablesConfig的metadata属性作为全局默认主题下发消费层—— worklet 的options.metadata直接读取onPress/globalHandlers也能拿到同一份数据。第一步定义一个类型安全主题先用 TypeScript 把你的设计系统写成类型完整示例见 example/app/metadata-example.tsxtype AppTheme { colors: { primary: string; primaryDark: string; background: string }; spacing: { medium: number; large: number }; borderRadius: { medium: number; large: number }; }; const theme: AppTheme { colors: { primary: #6366F1, primaryDark: #4F46E5, background: #0F172A }, spacing: { medium: 16, large: 24 }, borderRadius: { medium: 12, large: 16 }, };第二步用一行 metadata 注入全局主题import { PressablesConfig, PressableScale } from pressto; export default function App() { return ( PressablesConfig metadata{theme} PressableScale onPress{() {}} Text主题按钮/Text /PressableScale /PressablesConfig ); }配置类型定义位于 src/provider/index.tsx其中metadata?: TMetadata就是主题的传送门。第三步在 worklet 里安全消费const ThemedButton createAnimatedPressableAppTheme((progress, { metadata }) { worklet; // 必写告诉 Reanimated 这段要跑到 UI 线程 return { backgroundColor: metadata.colors.primary, padding: metadata.spacing.medium, borderRadius: metadata.borderRadius.medium, }; });注意开头那句worklet;—— 这是把函数搬进 UI 线程的护照漏了它主题读取和动画都会静默失效。metadata 的三级流转Pressto 对metadata的合并策略清晰且可预测见 src/pressables/base.tsx 的解析逻辑全局默认PressablesConfig metadata{theme}作用范围内所有 pressable 继承单组件覆盖PressableScale metadata{{ ...theme, name: checkout }} /它会替换而非合并全局值想保留主题就自行展开事件回传globalHandlers.onPress({ metadata })与组件自身的onPress都能拿到同一份 metadata方便做埋点识别。PressablesConfig globalHandlers{{ onPress: ({ metadata }) track(tap, metadata?.name), }} metadata{theme} PressableScale metadata{{ ...theme, name: checkout }} / /PressablesConfig这套行为的回归保障可参考测试用例 src/tests/metadata.test.tsx。避坑指南别让 worklet 指令失踪新手最常踩的坑动画写了、主题也传了就是不动。九成原因是漏了worklet;指令。好消息是 Pressto 自带了一把哨兵——eslint-plugin-pressto。它的规则 require-worklet-directive.js 会在编码阶段就揪出漏写worklet的createAnimatedPressable回调把线上隐患挡在开发期。 建议把eslint-plugin-pressto的 recommended 配置开起来和类型检查一起构成主题元数据安全的双保险。上手清单✅ 用类型定义设计系统主题而非散落的魔法值✅ 在根节点用PressablesConfig的metadata一次性下发主题✅createAnimatedPressableAppTheme泛型绑定类型✅ 每个 worklet 首行写worklet;✅ 需要单按钮差异化时用组件级metadata覆盖小结Pressto 把主题进 worklet这件在 React Native 里历来棘手的事收敛成一个类型化字段 一个泛型 一条 eslint 规则。你无需理解线程隔离的细节就能让设计系统稳稳地驱动 60fps 的按压动画。更多 API 细节可回到仓库根目录的 README.md 查阅完整文档。【免费下载链接】presstoYour React Native app deserves better tap interactions.项目地址: https://gitcode.com/gh_mirrors/pre/pressto创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

React定时器开发常见8个坑与解决方案:如何用react-timer-hook构建可靠不掉拍的计时器

React定时器开发常见8个坑与解决方案:如何用react-timer-hook构建可靠不掉拍的计时器

React定时器开发常见8个坑与解决方案:如何用react-timer-hook构建可靠不掉拍的计时器 【免费下载链接】react-timer-hook React timer hook 项目地址: https://gitcode.com/gh_mirrors/re/react-timer-hook 在 React 定时器开发中,倒计时、秒表和…

2026/11/8 12:56:35 阅读更多 →
让你的论文代码可复现且易读:awesome-thesis代码规范、文档化与GitHub高级搜索完整指南

让你的论文代码可复现且易读:awesome-thesis代码规范、文档化与GitHub高级搜索完整指南

让你的论文代码可复现且易读:awesome-thesis代码规范、文档化与GitHub高级搜索完整指南 【免费下载链接】awesome-thesis A curated list of practical tips and tricks to help you achieve an awesome CS master thesis [WIP] - contributions are welcome 项目…

2026/11/3 10:50:50 阅读更多 →
PDF补丁丁完整教程:3 步解除 PDF 复制和打印限制

PDF补丁丁完整教程:3 步解除 PDF 复制和打印限制

PDF补丁丁完整教程:3 步解除 PDF 复制和打印限制 【免费下载链接】PDFPatcher PDF补丁丁——PDF工具箱,可以编辑书签、剪裁旋转页面、解除限制、提取或合并文档,探查文档结构,提取图片、转成图片等等 项目地址: https://gitcode…

2026/11/10 14:39:26 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻