Merge branch 'fix/script-load-error' into cosmo-dev

Author: huangchenbj

Contact.md

@@ -1,6 +1,19 @@
 
 欢迎小伙伴们加入micro-app微信群交流^ ^
-![image](https://github.com/user-attachments/assets/46ff4638-1c25-4458-b0f5-e547da16b162)
+![0291aea2443d8ef10404880c8b64593a](https://github.com/user-attachments/assets/0cb4d5d4-d18b-4131-910c-87ccfc1628e8)
+
+
+欢迎小伙伴们加入micro-app-DevTools开发交流群^ ^
+![d57424c8597f124d03510e0cb023a020](https://github.com/user-attachments/assets/b9725704-46a4-4cf1-99fd-79596c027128)
+
+
+
+
+
+
+
+
+
 
 
 

docs/zh-cn/advanced.md

@@ -72,23 +72,34 @@ microApp.start({
 })
 ```
 
-// 配置所有子应用 a 标签的 href 自动补齐方式
-  aHrefResolver: (hrefValue: string, appName: string, appUrl: string) => {
-    return 'https://www.abc.com/'+ hrefValue
-  }
-
-
-
 ## 4、aHrefResolver: 自定义处理所有子应用 a 标签的 href 拼接方式
-
 ```js
 import microApp from '@micro-zoe/micro-app'
 
 microApp.start({
+  // 配置所有子应用 a 标签的 href 自动补齐方式
   aHrefResolver: (hrefValue: string, appName: string, appUrl: string) => {
     return 'https://www.abc.com/'+ hrefValue
   }
 })
 ```
 
+## 5、escapeIframeWindowEvents : iframe 模式 逃逸沙盒的window事件
+```js
+import microApp from '@micro-zoe/micro-app'
+
+microApp.start({
+  // 配置所有iframe子应用 逃逸沙盒的window事件
+  escapeIframeWindowEvents: ['message']
+})
+```
+## 6、disableIframeRootDocument : iframe模式禁用沙箱Document 默认为false
+```js
+import microApp from '@micro-zoe/micro-app'
+
+microApp.start({
+  // iframe模式禁用沙箱Document，避免一些ui组件库Modal 或tooltip 偏移
+  disableIframeRootDocument: true
+})
+```
 

docs/zh-cn/changelog.md

@@ -7,8 +7,19 @@
 - 修订版本号：每周末会进行日常 bugfix 更新。（如果有紧急的 bugfix，则任何时候都可发布）
 
 ---
+### 1.0.0-rc.26
 
+`2025-05-25`
+- **Feature**
+  - 支持 disableIframeRootDocument : iframe模式禁用沙箱Document，默认为false。
+### 1.0.0-rc.25
 
+`2025-05-23`
+- **Feature**
+  - 支持escapeIframeWindowEvents : iframe 模式 逃逸沙盒的window事件， Array<string>。
+- **Bug Fix**
+  - 🐞 修复 子应用样式加载异常，[issue 1553](https://github.com/jd-opensource/micro-app/issues/1553)。
+  - 🐞 修复 当开启样式隔离时子应用属性选择器样式错误，[issue 1573](https://github.com/jd-opensource/micro-app/issues/1573)。
 ### 1.0.0-rc.24
 
 `2025-03-19`

docs/zh-cn/micro-app-devtools.md

@@ -1,10 +1,9 @@
 # 📖简介
 `Micro-App-DevTools`是基于京东零售推出的一款为`micro-app`框架而开发的`chrome`插件，旨在方便开发者对微前端进行数据查看以及调试,提升工作效率。
-Github 地址为：[https://github.com/micro-zoe/micro-app-chrome-plugin](https://github.com/micro-zoe/micro-app-chrome-plugin)，欢迎 Star 一下
 
 # 如何使用
 
-在chrome中输入`chrome://extensions`打开扩展程序，打开[插件下载地址](https://github.com/micro-zoe/micro-app-chrome-plugin/releases)，选择最新Release包的`micro-app-chrome-plugin.zip`
+在chrome中输入`chrome://extensions`打开扩展程序，打开[插件下载地址](https://github.com/jd-opensource/micro-app-chrome-plugin/releases)，选择最新Release包的`micro-app-chrome-plugin.zip`
 文件下载，无需解压，将已下载的插件拖入。
 
 ![扩展程序](https://img12.360buyimg.com/imagetools/jfs/t1/119438/16/38287/53001/646b50e3F9012f2e8/3bba9844bbb1431b.png)
@@ -49,7 +48,7 @@ Github 地址为：[https://github.com/micro-zoe/micro-app-chrome-plugin](https:
 #### 快捷打开方式二
 点击鼠标右键，选择micro-app下，二级菜单点子应用开发环境模拟
 
-![快捷方式](https://github.com/micro-zoe/micro-app-chrome-plugin/assets/14011130/91b40f7c-a826-4ffe-8c20-0b43a5c3bc6f)
+![快捷方式](https://github.com/jd-opensource/micro-app-chrome-plugin/assets/14011130/91b40f7c-a826-4ffe-8c20-0b43a5c3bc6f)
 
 
 ## 常见问题
@@ -61,8 +60,7 @@ Github 地址为：[https://github.com/micro-zoe/micro-app-chrome-plugin](https:
 
 ## 🤝 参与共建
 
-如果您对这个项目感兴趣，欢迎提[pull request](https://github.com/micro-zoe/micro-app-chrome-plugin/pulls)参与贡献，也欢迎 [Star](https://github.com/micro-zoe/micro-app-chrome-plugin) 支持一下 ^_^
-欢迎小伙伴们加入`Micro-App-DevTools`微信群交流^ ^   
+如果您对这个项目感兴趣，欢迎提[pull request](https://github.com/jd-opensource/micro-app-chrome-plugin/pulls)参与贡献，也欢迎 [Star](https://github.com/jd-opensource/micro-app-chrome-plugin) 支持一下 ^_^
 
-![image](https://img12.360buyimg.com/imagetools/jfs/t1/29962/13/20207/70265/646c9851Fe104e7c1/fed2ab97e2cf5f29.png)
+[欢迎小伙伴们加入Micro-App微信群交流^ ^](https://github.com/jd-opensource/micro-app/blob/master/Contact.md)
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@micro-zoe/micro-app",
-  "version": "1.0.0-rc.24",
+  "version": "1.0.0-rc.26",
   "description": "A lightweight, efficient and powerful micro front-end framework",
   "private": false,
   "main": "lib/index.min.js",

src/create_app.ts

@@ -79,6 +79,7 @@ export default class CreateApp implements AppInterface {
   public isPrefetch: boolean
   public isPrerender: boolean
   public prefetchLevel?: number
+  public mountIdentifier?: symbol
   public fiber = false
   public routerMode: string
   public attrs?: Record<string, string>
@@ -288,6 +289,7 @@ export default class CreateApp implements AppInterface {
         this.routerMode = routerMode
 
         const dispatchBeforeMount = () => {
+          this.mountIdentifier = Symbol('mountIdentifier')
           dispatchLifecyclesEvent(
             this.container,
             this.name,
@@ -494,6 +496,8 @@ export default class CreateApp implements AppInterface {
     unmountcb?: CallableFunction,
     umdHookUnmountResult?: unknown,
   ): void {
+    this.mountIdentifier = undefined
+
     // dispatch state event to micro app
     dispatchCustomEventToMicroApp(this, 'statechange', {
       appState: appStates.UNMOUNT

src/sandbox/adapter.ts

@@ -250,7 +250,14 @@ export function getIframeParentNodeDesc (
        *  e.g. target.parentNode.remove(target)
        */
       if (isMicroAppBody(result) && appInstanceMap.get(appName)?.container) {
-        return microApp.options.getRootElementParentNode?.(this, appName) || globalEnv.rawDocument.body
+        const customParent = microApp.options.getRootElementParentNode?.(this, appName)
+        if (customParent) {
+          return customParent
+        }
+        if (microApp?.options?.inheritBaseBody !== true) {
+          return appInstanceMap.get(appName)?.container?.querySelector('micro-app-body') || globalEnv.rawDocument.body
+        }
+        return globalEnv.rawDocument.body
       }
       return result
     }

src/sandbox/iframe/document.ts

@@ -54,6 +54,12 @@ export function patchDocument (
 
   return patchDocumentEffect(appName, microAppWindow)
 }
+function getElementDocument(microDocument: Document, rawDocument: Document): Document {
+  if (microApp?.options?.disableIframeRootDocument) {
+    return rawDocument
+  }
+  return microDocument
+}
 
 function patchDocumentPrototype (appName: string, microAppWindow: microAppWindowType): void {
   const rawDocument = globalEnv.rawDocument
@@ -88,7 +94,7 @@ function patchDocumentPrototype (appName: string, microAppWindow: microAppWindow
     tagName: string,
     options?: ElementCreationOptions,
   ): HTMLElement {
-    let element = rawMicroCreateElement.call(this, tagName, options)
+    let element = rawMicroCreateElement.call(getElementDocument(this, rawDocument), tagName, options)
     if (isWebComponentElement(element)) {
       element = rawMicroCreateElement.call(rawDocument, tagName, options)
     }
@@ -100,22 +106,22 @@ function patchDocumentPrototype (appName: string, microAppWindow: microAppWindow
     name: string,
     options?: string | ElementCreationOptions,
   ): HTMLElement {
-    const element = rawMicroCreateElementNS.call(this, namespaceURI, name, options)
+    const element = rawMicroCreateElementNS.call(getElementDocument(this, rawDocument), namespaceURI, name, options)
     return updateElementInfo(element, appName)
   }
 
   microRootDocument.prototype.createTextNode = function createTextNode (data: string): Text {
-    const element = rawMicroCreateTextNode.call(this, data)
+    const element = rawMicroCreateTextNode.call(getElementDocument(this, rawDocument), data)
     return updateElementInfo<Text>(element, appName)
   }
 
   microRootDocument.prototype.createDocumentFragment = function createDocumentFragment (): DocumentFragment {
-    const element = rawMicroCreateDocumentFragment.call(this)
+    const element = rawMicroCreateDocumentFragment.call(getElementDocument(this, rawDocument))
     return updateElementInfo(element, appName)
   }
 
   microRootDocument.prototype.createComment = function createComment (data: string): Comment {
-    const element = rawMicroCreateComment.call(this, data)
+    const element = rawMicroCreateComment.call(getElementDocument(this, rawDocument), data)
     return updateElementInfo<Comment>(element, appName)
   }
 
@@ -184,7 +190,7 @@ function patchDocumentPrototype (appName: string, microAppWindow: microAppWindow
     }
 
     try {
-      return querySelector.call(this, `#${key}`)
+      return querySelector.call(getElementDocument(this, rawDocument), `#${key}`)
     } catch {
       return rawMicroGetElementById.call(_this, key)
     }
@@ -197,14 +203,14 @@ function patchDocumentPrototype (appName: string, microAppWindow: microAppWindow
     }
 
     try {
-      return querySelectorAll.call(this, `.${key}`)
+      return querySelectorAll.call(getElementDocument(this, rawDocument), `.${key}`)
     } catch {
       return rawMicroGetElementsByClassName.call(_this, key)
     }
   }
 
   microRootDocument.prototype.getElementsByTagName = function getElementsByTagName (key: string): HTMLCollectionOf<Element> {
-    const _this = getBindTarget(this)
+    const _this = getBindTarget(getElementDocument(this, rawDocument))
     if (
       isUniqueElement(key) ||
       isInvalidQuerySelectorKey(key)
@@ -216,20 +222,20 @@ function patchDocumentPrototype (appName: string, microAppWindow: microAppWindow
     }
 
     try {
-      return querySelectorAll.call(this, key)
+      return querySelectorAll.call(getElementDocument(this, rawDocument), key)
     } catch {
       return rawMicroGetElementsByTagName.call(_this, key)
     }
   }
 
   microRootDocument.prototype.getElementsByName = function getElementsByName (key: string): NodeListOf<HTMLElement> {
-    const _this = getBindTarget(this)
+    const _this = getBindTarget(getElementDocument(this, rawDocument))
     if (isInvalidQuerySelectorKey(key)) {
       return rawMicroGetElementsByName.call(_this, key)
     }
 
     try {
-      return querySelectorAll.call(this, `[name=${key}]`)
+      return querySelectorAll.call(getElementDocument(this, rawDocument), `[name=${key}]`)
     } catch {
       return rawMicroGetElementsByName.call(_this, key)
     }

src/sandbox/iframe/window.ts

@@ -25,6 +25,7 @@ import {
   escape2RawWindowRegExpKeys,
 } from './special_key'
 import WorkerProxy from '../../proxies/worker'
+import microApp from '../../micro_app'
 
 /**
  * patch window of child app
@@ -234,7 +235,12 @@ function patchWindowEffect (microAppWindow: microAppWindowType): CommonEffectHoo
      * TODO: SCOPE_WINDOW_EVENT_OF_IFRAME的事件非常少，有可能导致问题
      *  1、一些未知的需要绑定到iframe的事件被错误的绑定到原生window上
      */
-    return SCOPE_WINDOW_EVENT_OF_IFRAME.includes(type) ? microAppWindow : rawWindow
+    let escapeSandboxEvent: Array<string> = []
+    if (Array.isArray(microApp?.options?.escapeIframeWindowEvents)) {
+      escapeSandboxEvent = microApp.options.escapeIframeWindowEvents
+    }
+    const scopeWindowEvent = SCOPE_WINDOW_EVENT_OF_IFRAME.filter(item => !escapeSandboxEvent.includes(item))
+    return scopeWindowEvent.includes(type) ? microAppWindow : rawWindow
   }
 
   // TODO: listener 是否需要绑定microAppWindow，否则函数中的this指向原生window

src/sandbox/scoped_css.ts

@@ -108,8 +108,8 @@ class CSSParser {
      *    should be ==> micro-app[name=xxx] :where(.a, .b, .c) a {}
      */
     const attributeValues: {[key: string]: any} = {}
-    const matchRes = m[0].replace(/\[([^\]=]+)(?:=([^\]]+))?\]/g, (match, p1, p2) => {
-      const mock = `__mock_${p1}Value__`
+    const matchRes = m[0].replace(/\[([^\]=]+)(?:=([^\]]+))?\]/g, (match, p1, p2, offset) => {
+      const mock = `__mock_${p1}_${offset}Value__`
       attributeValues[mock] = p2
       return match.replace(p2, mock)
     })