新闻详情

新闻详情

首页 / 资讯中心 / 详情

Ariakit Animated Disclosure:用纯 CSS 过渡动画实现 Disclosure 内容高度展开与折叠

发布时间:2026/11/17 13:10:16来源:尧图网络
Ariakit Animated Disclosure:用纯 CSS 过渡动画实现 Disclosure 内容高度展开与折叠
UI组件前端【免费下载链接】ariakitToolkit with accessible components, styles, and examples for your next web app项目地址https://gitcode.com/gh_mirrors/ar/ariakit点击查看免费下载本篇指南围绕 Ariakit 仓库中的 Animated Disclosure 示例examples/disclosure-animated展开演示如何在不依赖任何 JS 动画库的前提下通过grid-template-rows过渡实现DisclosureContent高度从0到auto的展开/折叠动画。读完本文你将掌握Disclosure 内容的三层嵌套标记结构为何是必须的、[data-enter]选择器背后的状态机原理、以及aria-expanded驱动的图标旋转动画的完整落地方式。示例总览与完整代码该示例readme的目标非常明确给 Disclosure 组件加上纯 CSS 过渡让内容展开/折叠时高度平滑变化。它基于 WAI-ARIA Disclosure Pattern 构建完整 API 构成如下见 components/disclosure.mduseDisclosureStore() useDisclosureContext() DisclosureProvider Disclosure / DisclosureContent / /DisclosureProvider示例的完整实现见 index.react.tsx核心结构如下import * as Ariakit from ariakit/react; import ./style.css; export default function Example() { return ( div classNamewrapper Ariakit.DisclosureProvider Ariakit.Disclosure classNamebutton What are vegetables? {chevronIcon} /Ariakit.Disclosure Ariakit.DisclosureContent classNamecontent-wrapper div div classNamecontent p Vegetables are parts of plants that are consumed by humans or other animals as food. ... /p /div /div /Ariakit.DisclosureContent /Ariakit.DisclosureProvider /div ); }要点拆解DisclosureProvider创建一个 store把Disclosure触发按钮与DisclosureContent被控制的内容关联起来Disclosure默认渲染为button点击即调用 store 的toggle()切换open状态disclosure.tsxDisclosureContent默认渲染为div由 Ariakit 自动管理其hidden、data-open、data-enter、data-leave等属性。内容标记结构为什么需要两层中间 divCSS 至今不支持对auto值做过渡height: 0 → auto无法插值因此示例采用了一个变通方案用grid-template-rows的可插值特性间接动画高度。为此内容树的组织方式必须遵循特定格式摘自 readmeDisclosureContent classNamecontent-wrapper div div classNamecontent ...三层结构的职责划分层级元素职责外层DisclosureContent.content-wrapper承担 grid 布局与grid-template-rows过渡中间层匿名divgrid 的直接子元素必须overflow: hidden且不能有任何 padding用于裁切折叠时的溢出内容内层.content真正承载内容的 padding因为 padding 放在中间层会导致0fr折叠时仍残留内边距高度readme 特别强调中间div是必需的The intermediatedivis essential因为 grid 的直接子元素不能有 padding——把 padding 移到.content上才能做到真正折叠到 0 高度。用 grid-template-rows 动画内容高度在结构就位后readme给出的核心 CSSSCSS 嵌套写法为.content-wrapper { display: grid; transition: grid-template-rows 150ms; grid-template-rows: 0fr; /* 等价于 height 从 0 过渡到 auto */ [data-enter] { grid-template-rows: 1fr; } /* grid 的直接子元素必须隐藏溢出且无 padding */ * { overflow: hidden; padding: 0; } }原理0fr与1fr是两个可插值的数值grid-template-rows从0fr过渡到1fr时grid 轨道的高度会随内容高度连续变化视觉上完全等效于height: 0 → auto的过渡。仓库中该示例的真实实现使用了 Tailwind 原子类style.css两者完全等价.content-wrapper { apply grid grid-rows-[0fr] transition-[grid-template-rows] duration-200 >props { data-open: open || undefined, data-enter: transition enter || undefined, data-leave: transition leave || undefined, hidden, ...props, };其背后的状态机值得理解DisclosureContent渲染后store 的animated状态被置为truedisclosure-content.tsx组件通过双重requestAnimationFrameafterPaint等待元素真正落屏后再根据open/mounted判定把内部 transition 状态设为enter或leave从而挂载data-enter/data-leave属性disclosure-content.tsx。双重 rAF 是为了避免属性在元素完成渲染前被加上导致过渡不触发动画结束后组件通过读取getComputedStyle中的transition-duration、animation-duration等计算最长结束时间getElementEndTime用超时器清除动画状态如果检测到超时为 0没有定义任何过渡会直接把animated置回false元素在关闭时立即卸载、跳过离场动画disclosure-content.tsx内容不可见时mounted false等组件会给元素加上display: none内联样式与hidden属性保证动画结束后内容从可访问性树和布局中彻底移除disclosure-content.tsx。这也解释了为什么样式只需写在[data-enter]一个选择器上进入时 Ariakit 加上data-enter使grid-template-rows变为1fr当open变为false后属性被移除过渡自动反向回落到0fr完成折叠。浏览器支持grid-template-rows的可动画性已获所有现代浏览器支持。在旧浏览器中内容会直接出现/消失而不播放动画——这是 readme 中明确说明的优雅降级行为不会导致功能损坏。旋转 Disclosure 箭头图标展开/折叠的第二个视觉反馈是按钮上箭头图标的旋转。示例使用 CSS 的rotate属性配合aria-expanded选择器实现摘自 readme.button svg { transition: rotate 150ms; [aria-expandedtrue] { rotate: 180deg; } }对应的 Tailwind 写法见 style.css.button { apply ... [svg]:transition-[rotate] [svg]:aria-expanded:[rotate:180deg] }aria-expanded属性由 Ariakit 自动维护从 disclosure.tsx 可以看到Disclosure会合并出aria-expanded: expanded与aria-controls: contentElement?.id其中expanded由 store 的open状态驱动。因此图标动画不需要任何 JS 状态——只要open变化aria-expanded变化CSS 过渡即自动触发。这正是 WAI-ARIA Disclosure Pattern 要求触发器携带aria-expanded的可访问性收益在视觉层的一次复用样式指南另见 guide/200-styling/readme.md。小结与相关示例该方案的价值在于动画完全由 CSS 声明式驱动Ariakit 只负责在正确的时机挂载data-enter/data-leave与aria-expanded等语义属性且内置了动画时长探测与降级逻辑——没有动画的浏览器环境下内容直接显隐功能不受影响。同一套思路在仓库中还有多组变体可以参考动画 Dialogexamples/dialog-animated/index.react.tsx动画 Selectexamples/select-animated/index.react.tsx动画 Comboboxexamples/combobox-animated/index.react.tsx动画 Tab Panelexamples/tab-panel-animated/index.react.tsx基于 Framer Motion 的 Menuexamples/menu-framer-motion/index.react.tsx基于 Framer Motion 的 Tooltipexamples/tooltip-framer-motion/index.react.tsx需要说明的适用前提本示例代码文件标注为 Ariakit Plus 许可见 index.react.tsx 头部注释但其中演示的grid-template-rowsdata-enter技术方案与组件本身的用法同样适用于ariakit/react的Disclosure/DisclosureContent组件。赞分享UI组件前端【免费下载链接】ariakitToolkit with accessible components, styles, and examples for your next web app项目地址https://gitcode.com/gh_mirrors/ar/ariakit点击查看免费下载相关推荐OpenFoodFacts-androidapp架构深度剖析现代Android应用的多变体设计实践OpenFoodFacts androidapp架构深度剖析现代Android应用的多变体设计实践 OpenFoodFacts androidapp是一个基于HP-Socket开源项目合作伙伴权益与义务清单明确责任边界HP Socket开源项目合作伙伴权益与义务清单明确责任边界 HP Socket作为高性能TCP/UDP/HTTP通信组件已经成为众多企业和开发者构建高并发后端网络通信Ariakit Combobox 动画实战用 CSS Transitions 实现优雅过渡的下拉框Ariakit Combobox 动画实战用 CSS Transitions 实现优雅过渡的下拉框 本篇以 Ariakit 仓库中的 combobox aniUI组件前端上一篇OpenSwiftUI跨平台的SwiftUI开源实现下一篇终极指南如何用HunterPie v2提升你的怪物猎人游戏体验创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/17 7:04:08

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/17 5:42:44

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/17 19:43:34

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/17 6:55:04

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/17 5:57:47

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/17 19:43:32

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉