From ab5089da3a6a99d7c654343ff008e79cb58ac03a Mon Sep 17 00:00:00 2001
From: zhenyuWang <13641039885@163.com>
Date: Mon, 25 Dec 2023 15:09:34 +0800
Subject: [PATCH] =?UTF-8?q?docs(getElementById):=20=E8=A1=A5=E5=85=85?=
 =?UTF-8?q?=E6=B3=A8=E6=84=8F=E4=BA=8B=E9=A1=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/api/get-element.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/api/get-element.md b/docs/api/get-element.md
index f3d45056..04403329 100644
--- a/docs/api/get-element.md
+++ b/docs/api/get-element.md
@@ -7,6 +7,31 @@
 `3.93+` 支持泛型，可通过 `uni.getElementById<ElementType>(id)` 获取指定类型的元素。对于组件有自带方法的情况，通过泛型指定具体的元素类型，就可以调用该类型组件的专用方法，比如unicloud-db组件。\
 具体的组件元素类型，可查阅`组件文档/组件类型`获取。
 
+**注意：** 该方法只能获取当前页面的元素（查询时，会首先获取当前页面，即：`getCurrentPages()` 获取的页面栈数组的最后一个页面），如果需要获取其他页面的元素，可通过`ref`获取指定页面的元素。
+
+```html
+	<template>
+		<view>
+			<text id='text' ref='textRef'>test text</text>
+		</view>
+	</template>
+	<script>
+		export default {
+      onReady(){
+        uni.navigateTo({
+          url: '/pages/test/test'
+          success() {
+            // 通过 ref 获取指定页面的元素
+            const textRef = this.$refs['textRef']
+            // 通过 getElementById 获取指定页面的元素，此时当前页面为 test 页面，所以获取不到 #text 元素
+            const textNode = uni.getElementById('text')
+          }
+        })
+      }
+		}
+	</script>
+```
+
 <!-- UTSAPIJSON.getElementById.returnValue -->
 
 <!-- UTSAPIJSON.getElementById.example -->
-- 
GitLab