通过为Visual Studio代码用户提供高级功能,例如自动完成,语法突出显示和覆盖,Tailwind CSS Intellisense通过为Visual Studio Code用户提供了尾风的开发体验。
安装
通过Visual Studio代码市场安装→
为了使扩展激活要激活,您必须安装尾windcs,其中之一是:
- 对于V4及以后,导入尾风CSS样式表的.CSS文件(例如@Import“ TailWindCSS”)
- 对于V3及更早,您的工作空间中的Tailwind CSS配置文件名为TailWind.Config。{JS,CJS,MJS,TS,CTS,MTS}。
- 对于V3和更早,通过@Config指向配置文件的样式表
特征
自动完成
班级名称以及CSS功能和指令的智能建议。
覆盖
突出显示您的CSS和标记中的错误和潜在错误。
悬停预览
通过徘徊在上面,请参见完整的CSS,以获取尾风级别的名称。
尾风CSS语言模式
VS Code内置CSS语言模式的替代方案,即使使用特定于tailwind特定的在插曲时,它也可以维护完整的CSS Intellisense支持。还提供了语法定义,以便在所有CSS上下文中正确突出显示尾风特异性语法。
推荐的VS代码设置
文件。交往
使用files.sasociations设置来告诉VS代码以始终以尾风CSS模式打开.css文件:
"files.associations" : {
"*.css" : " tailwindcss "
}editor.quicksuggestions
默认情况下,在编辑“字符串”内容时,例如在JSX属性值中,不会触发完成。更新编辑器。QuickSuggestions设置可能会改善您的经验:
"editor.quickSuggestions" : {
"strings" : " on "
}扩展命令
尾风CSS:显示输出
显示语言服务器日志面板。此命令仅在有活动语言服务器实例时可用。
Tailwind CSS:排序选择(预释放)
当选择CSS类的列表时,该命令可用于按照与CSS中的顺序订购它们的顺序对其进行排序。仅当当前文档属于活动的尾风项目时,此命令才可用,而tailwindcss版本为3.0.0或更高。
扩展设置
tailwindcss.includelanguages
此设置使您可以添加其他语言支持。每个条目的关键是新的语言ID,值是内置语言的任何一种扩展语言,具体取决于您希望对新语言进行处理(例如HTML,CSS或JavaScript):
{
"tailwindCSS.includeLanguages" : {
"plaintext" : " html "
}
}tailwindcss.files.exclude
配置球模式以排除所有IntelliSense功能。从files.exclude设置继承所有球模式。默认值:[“ **/。git/**”,“ **/node_modules/**”,“ **/。hg/**”,“ **/。svn/**”]
parwindcss.emmetCompletions
在使用Emmet式语法时,启用完成,例如Div.BG-RED-500.uppercase。默认值:false
tailwindcss.classattributes
提供类完整,悬停预览,绒毛等的HTML属性等
parwindcss.classfunctions
提供完成,悬停预览,绒毛等的功能。当前,这对javascript / tyspript中的功能调用和标记的模板文字都起作用。
每个条目都被视为在函数名称上匹配的正则格式。您无法在功能名称之前或之后的内容上匹配 - 匹配仅限于功能名称。
例子:
{
"tailwindCSS.classFunctions" : [ " tw " , " clsx " , " tw \ .[a-z-]+ " ]
} let classes = tw `flex bg-red-500`
let classes2 = clsx ( [
"flex bg-red-500" ,
{ "text-red-500" : true }
] )
let element = tw . div `flex bg-red-500`parwindcss.colordecorators
控制编辑器是否应为尾风CSS课程和辅助功能提供内联颜色装饰器。默认值:true
请注意,必须启用编辑器,以显示颜色装饰器。
tailwindcss.showpixelequalents
在完成和悬停中显示REM CSS值的PX当量。默认值:true
tailwindcss.rootfontsize
根字体大小以像素为单位。用于将REM CSS值转换为其PX当量。请参阅tailwindcss.showpixelequalents。默认值:16
tailwindcss.hovers
启用悬停。默认值:true
tailwindcss.suggestions
启用自动完成建议。默认值:true
tailwindcss.sodeyections
启用代码操作。默认值:true
tailwindcss.validate
启用绒毛。可以使用tailWindCS.lint设置分别配置规则:
- 忽略:完全禁用棉绒规则
- 警告:违反规则的行为将被视为“警告”,通常由黄色下划线表示
- 错误:违反规则的行为将被视为“错误”,通常由红色下划线表示
parwindcss.lint.invalidscreen
@Screen指令使用的未知屏幕名称。默认值:错误
tailwindcss.lint.invalidvariant
@Variants指令使用的未知变体名称。默认值:错误
tailwindcss.lint.invalidtailwinddirective
@TailWind指令使用的未知值。默认值:错误
tailwindcss.lint.invalidapply
@Apply指令的不支持使用。默认值:错误
tailwindcss.lint.invalidconfigpath
主题助手使用的未知或无效路径。默认值:错误
tailwindcss.lint.cssconflict
应用相同CSS属性或属性的同一HTML元素上的类名称。默认值:警告
tailwindcss.lint.RecommendedVariantOrder
类变体不在建议的顺序中(仅适用于JIT模式)。默认值:警告
tailwindcss.lint.usedblocklistedclass
通过@source而不是内联(…)的班级名称的使用。默认值:警告
partwindcss.inspectport
启用语言服务器的Node.js Inspector代理,并在指定的端口上侦听。默认值:null
实验扩展设置
实验设置可以随时更改或删除。
tailwindcss.expermentiment.configfile
默认值:null
此设置允许您手动指定CSS入口点(对于V4项目)或尾风配置文件(对于V3项目)。默认情况下,扩展程序尝试自动检测项目设置:
- 对于Tailwind CSS V4 :扩展程序将您的项目扫描到CSS文件,并确定“ root” CSS文件。
- 对于Tailwind CSS V3(及以前) :扩展程序会自动使用第一个tailwind.config。{JS,CJS,MJS,TS,CTS,CTS,MTS}文件。
如果IntelliSense无法检测您的项目,则可以使用此设置手动定义配置文件。
尾风CSS v4.x(CSS入口点)
对于V4项目,请指定用作您的尾风入口点的CSS文件。
如果您的项目包含一个CSS入口点,请将此选项设置为字符串:
"tailwindCSS.experimental.configFile" : " src/styles/app.css "对于具有多个CSS入口点的项目,请使用一个对象,其中每个密钥是一个文件路径,每个值是代表其适用的文件的glot模式(或模式数组):
"tailwindCSS.experimental.configFile" : {
"packages/a/src/app.css" : " packages/a/src/** " ,
"packages/b/src/app.css" : " packages/b/src/** "
}Tailwind CSS v3.x和更早的(配置文件)
对于V3项目及以下,请改为指定尾风配置文件。
如果您的项目包含单个尾风配置,请将此选项设置为字符串:
"tailwindCSS.experimental.configFile" : " .config/tailwind.config.js "对于具有多个配置文件的项目,请使用一个对象,其中每个键是一个配置文件路径,每个值是代表其应用的文件的glot模式(或模式数组):
"tailwindCSS.experimental.configFile" : {
"themes/simple/tailwind.config.js" : " themes/simple/** " ,
"themes/neon/tailwind.config.js" : " themes/neon/** "
}故障排除
如果您有问题要激活Intellisense功能,则可以检查一些事情:
- 您必须通过NPM,PNPM或纱线在工作区中安装了parwindcss。然后,扩展名将尝试检测您的尾风CSS配置,该配置可以位于以下内容之一:
- 对于Tailwind CSS V4项目,使用@Import“ TailWindCSS”之类的指令直接在您的主CSS文件中定义的配置;和@theme {...}。不支持少,Sass或手写笔之类的预处理器文件。 Intellisense函数需要一个.css文件。
- 对于Tailwind CSS V3及更早,在您的工作区中的tailwind CSS配置文件的名称匹配(TailWind.Config。{JS,CJS,MJS,MJS,TS,CTS,MTS,MTS}),或者通过@Config指向配置文件的样式图。
- 确保您的VS代码设置不会导致您的样式表或尾风CSS配置文件被隐藏/忽略,例如通过files.exclude,files.watchere.watchere.watcherexclude或tailwindcss.filess.files.files.exclude.Exclude设置。
- 通过运行命令调色板的Tailwind CSS:Show Outper命令来查看语言服务器输出。这可能显示出阻止扩展激活的错误。
- 对于具有多个安装尾风CSS的项目,多个配置文件或带有@Import“ partwindcss”的几个样式表,我们建议使用tailwindcss.s.experiment.configfile设置来明确说明您的样式图或配置路径。
通过命令行克隆项目: