前端 uni-app 重写: 9页面 H5

This commit is contained in:
zhiqui
2026-11-15 15:09:37 +08:00
parent 513b53672e
commit ea7c2529e9
24104 changed files with 3667749 additions and 0 deletions
@@ -0,0 +1,181 @@
"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;