"use strict"; var __importDefault = (this && this.__importDefault) || function (mod) { return (mod && mod.__esModule) ? mod : { "default": mod }; }; Object.defineProperty(exports, "__esModule", { value: true }); const postcss_selector_parser_1 = __importDefault(require("postcss-selector-parser")); const pages_1 = require("../../json/pages"); const externalClasses_1 = require("../../mp/externalClasses"); const utils_1 = require("../../utils"); /** * 基于页面 externalClasses 使用情况提升页面样式优先级 * * 小程序平台(mp-*): * - 页面没有使用 externalClasses:不做转换 * - 页面存在动态 externalClasses:选择器最后一个 class 追加 [class] * .a -> .a[class] * - 页面只有静态 externalClasses:仅命中静态 class 的选择器追加 [class] * .foo -> .foo[class](foo 在 staticClasses 中) * .bar -> .bar(bar 不在 staticClasses 中) * * 追加 [class] 可以提升 class 选择器优先级,同时避免原先插入 page 带来的结构影响。 */ const externalPlugin = () => { return { postcssPlugin: 'uni-external', prepare() { const processedRules = new WeakSet(); return { OnceExit(root) { // 只有小程序平台需要处理 externalClasses 的样式优先级 const platform = process.env.UNI_PLATFORM || ''; if (!platform.startsWith('mp-')) { return; } // 支付宝 ACSS 不支持 [class],隔离 2.0 使用来源前缀完成样式命中控制。 if ((0, externalClasses_1.isAlipayXStyleIsolation)()) { processAlipayStyleIsolation(root); return; } // 从 postcss source 中获取当前样式所属文件 const filePath = root.source?.input?.file; if (!filePath) { return; } // 只处理页面文件,组件文件保持原样 if (!(0, pages_1.isUniPageFile)(filePath)) { return; } // 获取页面中收集到的 externalClasses 使用信息 const externalClassesInfo = (0, externalClasses_1.findPageExternalClasses)(filePath); let staticClasses = new Set(); let hasDynamic = false; if (process.env.NODE_ENV === 'development') { hasDynamic = true; } else if (externalClassesInfo) { staticClasses = externalClassesInfo.staticClasses; if (externalClassesInfo.hasDynamic || externalClassesInfo.hasAppAndPageStyle) { hasDynamic = true; } } // 没有静态 class,也没有动态绑定时,直接跳过,避免无意义遍历 if (staticClasses.size === 0 && !hasDynamic) { return; } root.walkRules((rule) => { processRule(rule, processedRules, staticClasses, hasDynamic); }); }, }; }, }; }; /** * 单 class 选择器按 App、页面、组件来源改写为不同前缀;页面额外补 page 提权, * 从而在同名 class 下保持“页面 > 组件 > App”。复杂选择器继续遵循支付宝原生行为。 */ function processAlipayStyleIsolation(root) { const filePath = root.source?.input?.file; if (!filePath) { return; } const prefix = (0, utils_1.isAppVue)(filePath) ? '-a-' : (0, pages_1.isUniPageFile)(filePath) ? '-p-' : '-c-'; const isPage = prefix === '-p-'; root.walkRules((rule) => { if (rule.parent?.type === 'atrule' && /-?keyframes$/.test(rule.parent.name)) { return; } rule.selector = (0, postcss_selector_parser_1.default)((selectorRoot) => { selectorRoot.each((selector) => { // 所有静态 CSS class 都要校验,防止用户 class 与内部隔离键冲突。 selector.walkClasses((classNode) => { if ((0, externalClasses_1.isAlipayStyleIsolationClass)(classNode.value)) { throw rule.error(`支付宝小程序样式隔离不允许 class 使用保留前缀:${classNode.value}`); } }); if (selector.nodes.length === 0 || selector.nodes[0].type !== 'class' || selector.nodes.slice(1).some((node) => node.type !== 'pseudo')) { return; } selector.nodes[0].value = prefix + selector.nodes[0].value; if (isPage) { selector.prepend(postcss_selector_parser_1.default.combinator({ value: ' ' })); selector.prepend(postcss_selector_parser_1.default.tag({ value: 'page' })); } }); }).processSync(rule.selector); }); } function processRule(rule, processedRules, staticClasses, hasDynamic) { // 同一个 Rule 只处理一次,避免被重复追加 [class] if (processedRules.has(rule)) { return; } // keyframes 内部的 from/to 不是普通选择器,不能处理 if (rule.parent && rule.parent.type === 'atrule' && /-?keyframes$/.test(rule.parent.name)) { return; } processedRules.add(rule); // 根据 externalClasses 情况处理选择器 rule.selector = (0, postcss_selector_parser_1.default)((selectorRoot) => { selectorRoot.each((selector) => { let classNode; if (hasDynamic) { // 动态绑定无法提前知道具体 class,所有包含 class 的选择器都提升优先级 classNode = findLastClassNode(selector); } else { // 静态绑定只处理命中 staticClasses 的选择器,减少无关 CSS 变更 classNode = findLastClassNode(selector, staticClasses); } if (classNode) { appendClassAttribute(selector, classNode); } }); }).processSync(rule.selector); } /** * 找到选择器最右侧的 class 节点。 * 传入 classes 时,仅在选择器包含目标 class 后才返回最右侧 class, * 这样 .a .b 在命中 .a 时也能输出 .a .b[class],符合整体提权预期。 */ function findLastClassNode(selector, classes) { let lastClassNode; for (let i = selector.nodes.length - 1; i >= 0; i--) { const node = selector.nodes[i]; if (node.type !== 'class') { continue; } if (!lastClassNode) { lastClassNode = node; } if (!classes || classes.has(node.value)) { return lastClassNode; } } } /** * 在 class 后追加 [class] 提升优先级。 * .a -> .a[class] * .a[class] -> .a[class][class] * .a .b -> .a .b[class] */ function appendClassAttribute(selector, classNode) { selector.insertAfter(classNode, postcss_selector_parser_1.default.attribute({ attribute: 'class', value: undefined, raws: {}, })); } externalPlugin.postcss = true; exports.default = externalPlugin;