wikiboss/OmniCard
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态

refactor: 确立独立子工程架构 (backend, admin, mpuniapp) 并同步更新 AGENTS.md 规范

浏览代码
这个提交包含在：
wikiboss
2026-09-20 17:05:22 +08:00
父节点 de3cf8b870
当前提交 9fa1d1fbd0
共有 1679 个文件被更改，包括 204798 次插入 和 16817 次删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件

84
mpuniapp/pages/CSS/variable/custom_variable.test.js 普通文件
查看文件

@@ -0,0 +1,84 @@
const platformInfo = process.env.uniTestPlatformInfo.toLocaleLowerCase()
const isMP = platformInfo.startsWith('mp')
let page
describe("css-custom-variable", () => {
if (isMP) {
it('skip', () => {
expect(1).toBe(1)
})
return
}
it("screenshot", async () => {
page = await program.reLaunch("/pages/CSS/variable/custom_variable")
await page.waitFor("view")
const image = await program.screenshot({
fullPage: true,
})
expect(image).toSaveImageSnapshot()
})
// 点击 .test-v-if-button 按钮，查询 .test-v-if 元素高度
it("test-v-if", async () => {
await page.waitFor("view")
const element = await page.$(".test-v-if")
const {
height: height1
} = await element.size()
expect(height1).toBe(0)
const button = await page.$(".test-v-if-button")
await button.tap()
await page.waitFor(500)
const {
height: height2
} = await element.size()
expect(height2).toBe(30)
})
// 先查询 #chanageVarBox 的高度并记录
// 点击 #changeVarButton，查询 #chanageVarBox 的高度，和之前高度应当不一样
it("test-change-var", async () => {
const element = await page.$("#chanageVarBox")
const {
height: height1
} = await element.size()
expect(height1 > 0).toBe(true)
const button = await page.$("#changeVarButton")
await button.tap()
await page.waitFor(500)
const {
height: height2
} = await element.size()
expect(height2 == height1).toBe(false)
})
// 嵌套括号 fallback 测试 - 场景1：应用后是否生效
// 场景1 区域 --main-color 已定义(#ff0000)，应显示红色
// 场景3 区域 --main-color 未定义，应 fallback 到 rgba(64,158,255,0.8) 蓝色半透明
it("test-nested-paren-apply", async () => {
await page.waitFor("view")
const image = await program.screenshot({ fullPage: true })
expect(image).toSaveImageSnapshot()
})
// 嵌套括号 fallback 测试 - 场景2：修改后是否生效
// 点击 #changeNestedParenButton 通过 setProperty 修改 --main-color 为 #00ff00
it("test-nested-paren-change", async () => {
const button = await page.$("#changeNestedParenButton")
await button.tap()
await page.waitFor(500)
const image = await program.screenshot({ fullPage: true })
expect(image).toSaveImageSnapshot()
})
// 嵌套括号 fallback 测试 - 场景3：fallback 是否生效
// 点击 #toggleNestedParenFallbackButton 设置 --main-color 为 #ff0000，应显示红色
// 再点击清空 --main-color，应恢复 fallback 到 rgba(64,158,255,0.8) 蓝色半透明
it("test-nested-paren-fallback", async () => {
const button = await page.$("#toggleNestedParenFallbackButton")
await button.tap()
await page.waitFor(500)
const image1 = await program.screenshot({ fullPage: true })
expect(image1).toSaveImageSnapshot()
await button.tap()
await page.waitFor(500)
const image2 = await program.screenshot({ fullPage: true })
expect(image2).toSaveImageSnapshot()
})
})

354
mpuniapp/pages/CSS/variable/custom_variable.uvue 普通文件
查看文件

@@ -0,0 +1,354 @@
<template>
<!-- #ifdef APP && !VUE3-VAPOR -->
<scroll-view style="flex: 1">
<!-- #endif -->
<view style="flex-grow: 1;">
<view id="var_1" style="flex:1;--var_margin: 2px;" class="var_1" :class="var_bind">
<view>
<view class="var_1_1_1">
<text class="firstParagraph">此段落应有蓝色背景和绿色文本。</text>
</view>
<text class="secondParagraph">此段落应有黑色半透明背景和黄色文本。</text>
</view>
<text style="width: var(--var_width_invalid, 375rpx);background-color:yellowgreen;">无效值width应为375rpx</text>
<view id="chanageVarBox" :class="text_style_var_def">
<text class="text_style"
v-if="text_style_var_1_on">font-size:26px;style:normal;color:#ccc;background-color:#488cff</text>
<text class="text_style" v-else>font-size:16px;style:italic;color:#803390;background-color:#48ff32</text>
</view>
<view class="view_layout_style_container" id="view_container">
<view class="view_layout_style"></view>
<view class="view_layout_style" style="background-color: blue;--var_align_self: flex-start;"></view>
</view>
<button id="changeVarButton" @tap="do_change_var()">修改自定义变量</button>
<view class="test-v-if">
<view v-if="var_v_if" style="height:var(--var_height);background-color: var(--var_backgroundColor);">
</view>
</view>
<button class="test-v-if-button" @tap="do_vif()">v-if测试</button>
</view>
<view class="shorthand_var_suite" :class="shorthand_var_state_class">
<text class="shorthand_var_title">简写交叉测试</text>
<text id="shorthandVarStateText" class="shorthand_var_desc">{{ shorthand_var_state_text }}</text>
<text class="shorthand_var_desc">
预期：默认 state-1 时，红色2px实线边框，宽度120px，margin为10px，padding为8px，横排，蓝色子项 flex-basis 为 50px。
</text>
<text class="shorthand_var_desc">
点击切换后变为 state-2：蓝色4px实线边框，宽度240px，margin为20px，padding为16px，竖排，蓝色子项 flex-basis 为 100px。
</text>
<button id="toggleShorthandVarButton" @tap="toggle_shorthand_var_suite()">切换简写变量状态</button>
<text class="shorthand_var_case_title">复合场景：padding + margin + border + flex + flex-flow</text>
<view class="shorthand_composite_stage">
<view id="shorthandCompositeContainer" class="shorthand_composite_container">
<view id="shorthandCompositeItemMain" class="shorthand_composite_item shorthand_composite_item_main"></view>
<view class="shorthand_composite_item shorthand_composite_item_side"></view>
<view class="shorthand_composite_item shorthand_composite_item_tail"></view>
</view>
</view>
</view>
<view class="nested_paren_suite">
<text class="nested_paren_title">嵌套括号 fallback 测试</text>
<text class="nested_paren_desc">测试 var(--main-color, rgba(64,158,255,0.8)) 多层括号嵌套解析</text>
<text class="nested_paren_case_title">场景1：变量已定义，应用后应显示红色</text>
<view class="nested_paren_stage nested_paren_defined">
<view class="nested_paren_box" style="background-color: var(--main-color, rgba(64,158,255,0.8));"></view>
</view>
<text class="nested_paren_case_title">场景2：点击修改后应从红色变为绿色，再点击恢复红色</text>
<view id="nestedParenChangeStage" class="nested_paren_stage nested_paren_defined">
<view class="nested_paren_box" style="background-color: var(--main-color, rgba(64,158,255,0.8));"></view>
</view>
<button id="changeNestedParenButton" @tap="do_change_nested_paren()">修改嵌套括号变量</button>
<text class="nested_paren_case_title">场景3：变量未定义应 fallback 到 rgba(64,158,255,0.8) 蓝色半透明；点击设置后变红，再点击清空后恢复 fallback</text>
<view id="nestedParenFallbackStage" class="nested_paren_stage">
<view class="nested_paren_box" style="background-color: var(--main-color, rgba(64,158,255,0.8));"></view>
</view>
<button id="toggleNestedParenFallbackButton" @tap="do_toggle_nested_paren_fallback()">切换 fallback 状态（当前：{{ nested_paren_fallback_state_text }}）</button>
</view>
</view>
<!-- #ifdef APP && !VUE3-VAPOR -->
</scroll-view>
<!-- #endif -->
</template>
<script setup lang="uts">
const var_bind = ref("var_1_bind_1")
const var_v_if = ref(false)
const text_style_var_def = ref("text_style_var_1")
const text_style_var_1_on = ref(true)
const shorthand_var_state_class = ref("shorthand_var_state_1")
const shorthand_var_state_text = ref("state-1")
const do_change_var = () => {
const view_container = uni.getElementById("view_container")
if (text_style_var_1_on.value) {
text_style_var_def.value = "text_style_var_2"
text_style_var_1_on.value = false
view_container?.style?.setProperty("--var_flex_direction", "row")
view_container?.style?.setProperty("--var_justify_content", "flex-end")
// 与 style 中的写法表现不一致，且可能与非简写属性存在冲突
// view_container?.style?.setProperty("border", "var(--var_border)")
view_container?.style?.setProperty("background-color", "var(--background-color)")
} else {
text_style_var_def.value = "text_style_var_1"
text_style_var_1_on.value = true
view_container?.style?.setProperty("--var_margin", "10px")
view_container?.style?.setProperty("--var_flex_direction", "column")
view_container?.style?.setProperty("--var_justify_content", "center")
view_container?.style?.setProperty("background-color", "#FFF")
}
var_bind.value = (var_bind.value == "var_1_bind_2") ? "var_1_bind_1" : "var_1_bind_2"
}
const do_vif = () => {
var_v_if.value = !var_v_if.value
}
const toggle_shorthand_var_suite = () => {
if (shorthand_var_state_class.value == "shorthand_var_state_1") {
shorthand_var_state_class.value = "shorthand_var_state_2"
shorthand_var_state_text.value = "state-2"
} else {
shorthand_var_state_class.value = "shorthand_var_state_1"
shorthand_var_state_text.value = "state-1"
}
}
const nested_paren_change_on = ref(false)
const nested_paren_fallback_on = ref(false)
const nested_paren_fallback_state_text = ref("fallback 生效")
const do_change_nested_paren = () => {
const stage = uni.getElementById("nestedParenChangeStage")
if (nested_paren_change_on.value) {
stage?.style?.setProperty("--main-color", "#ff0000")
nested_paren_change_on.value = false
} else {
stage?.style?.setProperty("--main-color", "#00ff00")
nested_paren_change_on.value = true
}
}
const do_toggle_nested_paren_fallback = () => {
const stage = uni.getElementById("nestedParenFallbackStage")
if (nested_paren_fallback_on.value) {
stage?.style?.setProperty("--main-color", "")
nested_paren_fallback_on.value = false
nested_paren_fallback_state_text.value = "fallback 生效：蓝色"
} else {
stage?.style?.setProperty("--main-color", "#ff0000")
nested_paren_fallback_on.value = true
nested_paren_fallback_state_text.value = "变量生效：红色"
}
}
</script>
<style>
.var_1 {
padding-left: env(safe-area-inset-left);
padding-right: env(safe-area-inset-right);
--font-color: #00ff00;
--var_width: 375rpx;
--var_backgroundColor: rgba(0, 0, 0, .5);
}
.var_1_bind_1 {
--var_height: 30px;
}
.var_1_bind_2 {
--var_height: 60px;
}
.var_1_1_1 {
--var_backgroundColor: #0000ff;
}
.content {
flex: 1;
}
.firstParagraph {
background-color: var(--var_backgroundColor);
color: var(--font-color);
}
.secondParagraph {
--font-color: yellow;
background-color: var(--var_backgroundColor);
color: var(--font-color);
}
.text_style_var_1 {
--text-font-size: 26px;
--text-font-style: normal;
--text-color: #ccc;
--text-background-color: #488cff;
}
.text_style_var_2 {
--text-font-size: 16px;
--text-font-style: italic;
--text-color: #803390;
--text-background-color: #48ff32;
}
.text_style {
font-family: var(--swiper-item-font-family);
font-size: var(--text-font-size);
font-style: var(--text-font-style);
color: var(--text-color);
background-color: var(--text-background-color);
}
.view_layout_style_container {
--var_flex_direction: column;
--var_align_self: center;
--var_justify_content: center;
--var_border: 2px red solid;
--var_border2: 2px green solid;
--background-color: #CCC;
--var_height: 110px;
--var_margin: 10px;
height: var(--var_height);
flex-direction: var(--var_flex_direction);
justify-content: var(--var_justify_content);
margin: var(--var_margin);
}
.view_layout_style {
width: 50px;
height: 50px;
background-color: brown;
align-self: var(--var_align_self);
}
.shorthand_var_suite {
margin-top: 24px;
padding: 12px;
border: 1px solid #d0d7de;
background-color: #f6f8fa;
}
.shorthand_var_state_1 {
--composite-width: 120px;
--composite-margin: 10px;
--composite-padding: 8px;
--composite-border: 2px solid #f00;
--composite-flex: 1 0 50px;
--composite-flow: row;
}
.shorthand_var_state_2 {
--composite-width: 240px;
--composite-margin: 20px;
--composite-padding: 16px;
--composite-border: 4px solid #00f;
--composite-flex: 2 0 100px;
--composite-flow: column;
}
.shorthand_var_title {
font-size: 16px;
font-weight: bold;
}
.shorthand_var_desc {
margin-top: 6px;
margin-bottom: 8px;
color: #57606a;
font-size: 13px;
}
.shorthand_var_case_title {
margin-top: 12px;
margin-bottom: 4px;
font-size: 13px;
color: #24292f;
}
.shorthand_composite_stage {
padding: 8px;
background-color: #fff;
}
.shorthand_composite_container {
width: var(--composite-width);
margin: var(--composite-margin);
padding: var(--composite-padding);
border: var(--composite-border);
display: flex;
flex-flow: var(--composite-flow);
align-content: flex-start;
background-color: #eef6ff;
}
.shorthand_composite_item {
height: 24px;
margin: 2px;
}
.shorthand_composite_item_main {
flex: var(--composite-flex);
background-color: #93c5fd;
}
.shorthand_composite_item_side {
width: 40px;
background-color: #fca5a5;
}
.shorthand_composite_item_tail {
width: 40px;
background-color: #c4b5fd;
}
.nested_paren_suite {
margin-top: 24px;
padding: 12px;
border: 1px solid #d0d7de;
background-color: #f6f8fa;
}
.nested_paren_title {
font-size: 16px;
font-weight: bold;
}
.nested_paren_desc {
margin-top: 6px;
margin-bottom: 8px;
color: #57606a;
font-size: 13px;
}
.nested_paren_case_title {
margin-top: 12px;
margin-bottom: 4px;
font-size: 13px;
color: #24292f;
}
.nested_paren_stage {
height: 60px;
padding: 8px;
background-color: #fff;
display: flex;
flex-direction: row;
align-items: center;
}
.nested_paren_defined {
--main-color: #ff0000;
}
.nested_paren_box {
width: 100px;
height: 40px;
}
</style>

46
mpuniapp/pages/CSS/variable/variable.test.js 普通文件
查看文件

@@ -0,0 +1,46 @@
const isAppWebView = process.env.UNI_AUTOMATOR_APP_WEBVIEW == 'true'
const platformInfo = process.env.uniTestPlatformInfo.toLocaleLowerCase()
const isMP = platformInfo.startsWith('mp')
const isAndroid = platformInfo.startsWith('android')
const isIOS = platformInfo.startsWith('ios')
const isWeb = platformInfo.startsWith('web')
const isHarmony = platformInfo.startsWith('harmony')
const isApp = isAndroid || isIOS || isHarmony
describe('css-variable', () => {
if (isMP) {
it('skip', () => {
expect(1).toBe(1)
})
return
}
if (isAppWebView) {
it('app 与 web 存在差异, webview 不进行截图', () => {
expect(1).toBe(1)
})
return
}
if (isApp) {
it('css test', async () => {
const page = await program.reLaunch('/pages/CSS/variable/variable');
await page.waitFor('view');
const element = await page.$('.status-bar-height')
const size1 = await element.size()
expect(size1.height > 0).toBe(true)
})
}
it('screenshot', async () => {
const page = await program.reLaunch('/pages/CSS/variable/variable');
await page.waitFor('view');
const image = await program.screenshot({
fullPage: true
})
expect(image).toSaveImageSnapshot()
});
});

126
mpuniapp/pages/CSS/variable/variable.uvue 普通文件
查看文件

@@ -0,0 +1,126 @@
<template>
<view class="page">
<view class="status-bar-height">
<text>通过var(--status-bar-height)获取状态栏高度</text>
</view>
<view class="status-bar-window" :style="{ height: statusBarHeight + 'px' }">
<text>通过uni.getWindowInfo获取状态栏高度</text>
</view>
<view class="status-bar-unipage" :style="{ height: statusBarHeight2 + 'px' }">
<text>通过this.$page.statusBarHeight获取状态栏高度</text>
</view>
<view class="window-top">
<text>window top</text>
</view>
<view class="window-bottom">
<text>window bottom</text>
</view>
<view class="uni-safe-area-inset-top">
<text>height:var(--uni-safe-area-inset-top)</text>
</view>
<view class="uni-safe-area-inset-left">
<text>height:var(--uni-safe-area-inset-left)</text>
</view>
<view class="uni-safe-area-inset-right">
<text>height:var(--uni-safe-area-inset-right)</text>
</view>
<view class="uni-safe-area-inset-bottom">
<text>height:var(--uni-safe-area-inset-bottom)</text>
</view>
<view class="uni-fixed-bottom">
<text>此区域应显示在安全区域内</text>
</view>
</view>
</template>
<script setup lang="uts">
const statusBarHeight = ref(0)
const statusBarHeight2 = ref(0)
const instance = getCurrentInstance()
onReady(() => {
statusBarHeight.value = uni.getWindowInfo().statusBarHeight
// #ifndef MP-WEIXIN
statusBarHeight2.value = instance?.proxy?.$page?.statusBarHeight ?? 0
// #endif
})
</script>
<style>
.page {
flex: 1;
}
.status-bar-height {
height: var(--status-bar-height);
align-items: center;
justify-content: center;
background-color: red;
}
.status-bar-window {
background-color: yellow;
align-items: center;
justify-content: center;
}
.status-bar-unipage {
align-items: center;
justify-content: center;
background-color: greenyellow;
}
.window-top {
height: var(--window-top);
align-items: center;
background-color: green;
margin: 2px 0px;
}
.window-bottom {
height: var(--window-bottom);
align-items: center;
background-color: blue;
margin: 2px 0px;
}
.uni-safe-area-inset-top {
height: var(--uni-safe-area-inset-top);
align-items: center;
background-color: yellow;
margin: 2px 0px;
}
.uni-safe-area-inset-left {
height: var(--uni-safe-area-inset-left);
align-items: center;
background-color: greenyellow;
margin: 2px 0px;
}
.uni-safe-area-inset-right {
height: var(--uni-safe-area-inset-right, 60px);
align-items: center;
background-color: saddlebrown;
margin: 2px 0px;
}
.uni-safe-area-inset-bottom {
height: var(--uni-safe-area-inset-bottom);
align-items: center;
background-color: salmon;
margin: 2px 0px;
}
.uni-fixed-bottom {
position: fixed;
left: var(--uni-safe-area-inset-left);
right: var(--uni-safe-area-inset-right);
bottom: var(--uni-safe-area-inset-bottom);
align-items: center;
background-color: blueviolet;
}
</style>