SuperAPI AI 工具集

tailwind-syntax-modern-utilities

前端与建站

查看项目

更新于 10-15 22:18

技能介绍

用途:本技能面向 Tailwind CSS v4 独有的现代工具类,帮助在 v3 中缺失或需大量自定义代码才能实现的现代 CSS 特性落地。使用前必须确认项目为 v4,不可回移到 v3,否则会静默失效。

主要能力:共七类工具族。transition-discrete 让 display、visibility 等离散属性参与过渡(transition-behavior: allow-discrete);starting: 变体为进入动画设置初始值(@starting-style);field-sizing-content 让表单控件按内容自动调整尺寸;scheme-* 声明原生表单控件的配色方案;font-stretch-* 控制可变字体宽度轴;inset-shadow-* 与 inset-ring-* 提供内阴影与内描边,可与外阴影、外描边叠加组合。

必要用法:动画 popover、dialog、details 等可见性变化的元素时,必须将 starting: 与 transition-discrete 配对,否则 display 变化是瞬时的,起始样式不会播放。textarea 与单行 input 自动增高应使用 field-sizing-content,并搭配 min-h-、max-h- 限定范围,替代 JS 自适应钩子。设置配色方案必须使用 v4 类名 scheme-light、scheme-dark、scheme-light-dark 等,不存在 color-scheme-* 形式;同时支持明暗主题时应搭配 dark:scheme-dark。font-stretch-* 仅在字体为带宽度轴的可变字体时生效。多层阴影应使用 shadow-、inset-shadow-、ring-、inset-ring- 组合,不要手写多层 box-shadow。

适用场景:纯 CSS 的弹窗与对话框进出场动画、details 展开动画、自动增高输入框、深色主题下的原生日期/颜色/下拉控件、可变字体宽度排版、按钮内高光与多层阴影描边、内描边焦点指示等。

限制:仅适用于 Tailwind CSS v4;浏览器支持基线以官方文档为准;font-stretch-* 对单宽度字体无效;transition-discrete 对连续属性无作用;内描边焦点指示在几何受限时使用,一般焦点仍优先外描边。具体类清单、示例与反模式见技能内 references 文件。