跳到主要内容

WeappTailwindcssPostcssPluginOptions

weapp-tailwindcss PostCSS 插件配置。

属性

generator?

可选 | generator: import("./generator").WeappTailwindcssGeneratorOptions

生成器配置,用于控制目标端、Tailwind 配置路径和 v4 兼容层。

target?

可选 | target: WeappTailwindcssGeneratorTarget

生成目标。小程序构建默认使用 weapp,H5/Web 与普通 uni-app App WebView 默认使用 web

备注

target 表示 CSS 输出形态,不是平台枚举。uni-app x Android/iOS 这类原生 App 目标继续使用 weapp 输出族, 并通过 uniAppXplatform 与单位转换配置处理 App 差异。

config?

可选 | config: string

Tailwind 配置文件路径,兼容原 Tailwind PostCSS 插件的 config 选项。

styleOptions?

可选 | styleOptions: Partial<IStyleHandlerOptions>

传给小程序 CSS 兼容转换器的额外配置。

importFallback?

可选 | importFallback: boolean

@import "weapp-tailwindcss" 作为 Tailwind CSS v4 生成入口的兜底别名。

适用于框架无法把 @import "tailwindcss" 改写到 weapp-tailwindcss 包入口的场景,默认开启。

tailwindcssV3Compatibility?

可选 | tailwindcssV3Compatibility: boolean

Tailwind CSS v4 小程序生成模式默认注入 v3 默认值兼容层,保持升级前的视觉行为。

设为 false 时,完全使用 Tailwind CSS v4 原生默认值。


version?

可选 | version: 3 | 4

显式指定 Tailwind CSS 主版本。未传入时会从 CSS 与依赖环境推断。


config?

可选 | config: string

Tailwind 配置文件路径。


postcssPlugin?

可选 | postcssPlugin: string

Tailwind PostCSS 插件名称。


candidates?

可选 | candidates: Iterable<string>

额外传入的候选类名。


scanSources?

可选 | scanSources: boolean | import("tailwindcss-patch").TailwindV4SourcePattern[]

是否扫描 Tailwind v4 源码入口中的候选类名。


sources?

可选 | sources: TailwindV4CandidateSource[]

额外传入的 Tailwind v4 内联候选来源。


styleOptions?

可选 | styleOptions: Partial<IStyleHandlerOptions>

传给小程序 CSS 兼容转换器的额外配置。

isMainChunk?

可选 | isMainChunk: boolean

cssPreflight?

可选 | cssPreflight: CssPreflightOptions

cssInjectPreflight()?

可选 | cssInjectPreflight(): InjectPreflight

escapeMap?

可选 | escapeMap: Record<string, string>

ctx?

可选 | ctx: { variablesScopeWeakMap: WeakMap<object, any>; isVariablesScope: (rule: WeakKey) => boolean; markVariablesScope: (rule: WeakKey) => void; }

platform?

可选 | platform: string

postcssOptions?

可选 | postcssOptions: Partial<Omit<Result, "file">>

cssRemoveProperty?

可选 | cssRemoveProperty: boolean

cssRemoveHoverPseudoClass?

可选 | cssRemoveHoverPseudoClass: boolean

cssPresetEnv?

可选 | cssPresetEnv: PresetEnvOptions

autoprefixer?

可选 | autoprefixer: WeappAutoprefixerOptions

cssCalc?

可选 | cssCalc: boolean | CssCalcOptions | (string | RegExp)[]

atRules?

可选 | atRules: { property?: boolean | undefined; supports?: boolean | undefined; media?: boolean | undefined; }

uniAppX?

可选 | uniAppX: boolean

uniAppXCssTarget?

可选 | uniAppXCssTarget: "uvue"

uniAppXUnsupported?

可选 | uniAppXUnsupported: UniAppXUnsupportedMode

majorVersion?

可选 | majorVersion: number

cssPreflightRange?

可选 | cssPreflightRange: "all"

cssChildCombinatorReplaceValue?

可选 | cssChildCombinatorReplaceValue: string | string[]

injectAdditionalCssVarScope?

可选 | injectAdditionalCssVarScope: boolean

cssSelectorReplacement?

可选 | cssSelectorReplacement: { root?: string | string[] | false | undefined; universal?: string | string[] | false | undefined; }

rem2rpx?

可选 | rem2rpx: boolean | Rem2rpxOptions

px2rpx?

可选 | px2rpx: boolean | Px2rpxOptions

unitsToPx?

可选 | unitsToPx: boolean | UnitsToPxOptions

unitConversion?

可选 | unitConversion: UnitConversionOptions


projectRoot?

可选 | projectRoot: string


cwd?

可选 | cwd: string


base?

可选 | base: string


baseFallbacks?

可选 | baseFallbacks: string[]


css?

可选 | css: string


cssSources?

可选 | cssSources: TailwindV4CssSource[]


cssEntries?

可选 | cssEntries: string[]


packageName?

可选 | packageName: string