From cf0870e2516eeb113f8c5e397c4b8e709dc0a927 Mon Sep 17 00:00:00 2001
From: wanganxp <wanganxp@gmail.com>
Date: Thu, 28 Dec 2023 06:05:13 +0800
Subject: [PATCH] =?UTF-8?q?=E6=8F=90=E7=A4=BAuni=E4=B8=8D=E4=B8=8E?=
 =?UTF-8?q?=E8=B0=83=E7=94=A8=E9=A1=B5=E9=9D=A2=E7=BB=91=E5=AE=9A=E5=B8=A6?=
 =?UTF-8?q?=E6=9D=A5=E7=9A=84=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/api/get-element.md | 10 ++++++++--
 docs/tutorial/idref.md  |  8 +++++++-
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/docs/api/get-element.md b/docs/api/get-element.md
index 04403329..5a1bbe47 100644
--- a/docs/api/get-element.md
+++ b/docs/api/get-element.md
@@ -2,13 +2,19 @@
 
 <!-- UTSAPIJSON.getElementById.description -->
 
+**注意：** \
+本方法获取的元素，是页面栈栈顶的页面的元素，而不是执行本方法代码所在的页面的元素。\
+因为uni是全局api，只有`this.$refs`才能和页面绑定。\
+如果A页面被栈顶的B页面盖住，在A页面执行`uni.getElementById`会访问到B页面的元素。\
+除非您确认清楚这个逻辑，否则不建议使用本方法。\
+
+与页面绑定的获取元素的方式是`this.$refs`获取的对象再进一步as为element。[详见](../tutorial/idref.md#ref方式)
+
 <!-- UTSAPIJSON.getElementById.param -->
 
 `3.93+` 支持泛型，可通过 `uni.getElementById<ElementType>(id)` 获取指定类型的元素。对于组件有自带方法的情况，通过泛型指定具体的元素类型，就可以调用该类型组件的专用方法，比如unicloud-db组件。\
 具体的组件元素类型，可查阅`组件文档/组件类型`获取。
 
-**注意：** 该方法只能获取当前页面的元素（查询时，会首先获取当前页面，即：`getCurrentPages()` 获取的页面栈数组的最后一个页面），如果需要获取其他页面的元素，可通过`ref`获取指定页面的元素。
-
 ```html
 	<template>
 		<view>
diff --git a/docs/tutorial/idref.md b/docs/tutorial/idref.md
index ce60cb7d..a0cdade7 100644
--- a/docs/tutorial/idref.md
+++ b/docs/tutorial/idref.md
@@ -79,6 +79,8 @@ uni-app x提供了[uni.getElementById](../api/get-element.md)方法，返回的
 
 通用的元素操作方法，比如getAttribute、setStyle，在Element上就可以操作。
 
+但是由于本方法不与页面绑定，获取的是栈顶页面的element，所以可能发生预期外的情况，[详见](../api/get-element.md)
+
 UniVideoElement 继承自 Element，拥有video专用的一批方法。
 
 template区：
@@ -101,7 +103,11 @@ uni.createVideoContext("vid")!.play()
 uni-app x 虽然支持 `uni.createSelectorQuery()` API，传入选择器，可以拿到返回的NodesRef。但无法继续获取.context子对象。无法通过这种方式拿到context。
 
 #### ref方式
-其实this.$refs获取到的内置组件，通过as也可以转换为Element。但一般ref用于vue自定义组件。
+
+其实`this.$refs`获取到的内置组件，通过as也可以转换为Element。
+
+与`uni.getElementById`相比，`this.$refs`方式与调用页面绑定，日常更推荐使用。
+
 script区：
 ```js
 (this.$refs['vid'] as UniVideoElement).play(); //但一般ref用于vue自定义组件
-- 
GitLab