Class Text
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
Text
تمثيل لعقدة Text في XML
مستندات تفصيلية
append(text)
إلحاق النص المحدّد بأي محتوى متوفّر حاليًا في العقدة
المعلَمات
| الاسم | النوع | الوصف |
text | String | النص المطلوب إلحاقه بالعقدة |
الإرجاع
Text: عقدة Text لإنشاء سلاسل
detach()
تؤدي هذه العملية إلى فصل العقدة عن العقدة الرئيسية Element. إذا لم تكن للعقدة عنصر رئيسي، لن يكون لهذه الطريقة أي تأثير.
الإرجاع
Content - العقدة المنفصلة
getParentElement()
تحصل على العقدة الرئيسية Element للعقدة. إذا لم تكن للعقدة عنصر رئيسي، تعرِض هذه الطريقةnull.
الإرجاع
Element: العقدة الرئيسية Element
getText()
تحصل على القيمة النصية لعقدة Text.
الإرجاع
String: القيمة النصية لعقدة Text
getValue()
تحصل على القيمة النصية لجميع العقد التي تكون عناصر فرعية مباشرة أو غير مباشرة للعقدة، بالترتيب الذي
تظهر به في المستند.
الإرجاع
String: القيمة النصية لجميع العقد التي تكون عناصر ثانوية مباشرة أو غير مباشرة للعقدة
setText(text)
لضبط القيمة النصية لعقدة Text
المعلَمات
| الاسم | النوع | الوصف |
text | String | قيمة النص المطلوب ضبطها |
الإرجاع
Text: عقدة Text لإنشاء سلاسل
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003eText\u003c/code\u003e object represents a text node within an XML document and provides methods for manipulating its content.\u003c/p\u003e\n"],["\u003cp\u003eYou can use methods like \u003ccode\u003eappend()\u003c/code\u003e, \u003ccode\u003esetText()\u003c/code\u003e, and \u003ccode\u003egetText()\u003c/code\u003e to modify and retrieve the text content of the node.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003edetach()\u003c/code\u003e removes the node from its parent element, while \u003ccode\u003egetParentElement()\u003c/code\u003e allows access to the parent element.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetValue()\u003c/code\u003e retrieves the text value of all child nodes, offering a way to access nested content within the text node.\u003c/p\u003e\n"]]],["The `Text` node represents XML text content. Key actions include: appending text to the node via `append(text)`, detaching the node from its parent using `detach()`, and retrieving the parent element with `getParentElement()`. Text content can be obtained using `getText()` for the node's text or `getValue()` for text of child nodes. Finally, `setText(text)` sets the text value of the node. These methods allow manipulation and reading of text in an XML structure.\n"],null,["# Class Text\n\nText\n\nA representation of an XML `Text` node. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------|-------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|\n| [append(text)](#append(String)) | [Text](#) | Appends the given text to any content that already exists in the node. |\n| [detach()](#detach()) | [Content](/apps-script/reference/xml-service/content) | Detaches the node from its parent [Element](/apps-script/reference/xml-service/element) node. |\n| [getParentElement()](#getParentElement()) | [Element](/apps-script/reference/xml-service/element) | Gets the node's parent [Element](/apps-script/reference/xml-service/element) node. |\n| [getText()](#getText()) | `String` | Gets the text value of the `Text` node. |\n| [getValue()](#getValue()) | `String` | Gets the text value of all nodes that are direct or indirect children of the node, in the order they appear in the document. |\n| [setText(text)](#setText(String)) | [Text](#) | Sets the text value of the `Text` node. |\n\nDetailed documentation\n----------------------\n\n### `append(text)`\n\nAppends the given text to any content that already exists in the node.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|--------------------------------|\n| `text` | `String` | the text to append to the node |\n\n#### Return\n\n\n[Text](#) --- the `Text` node, for chaining\n\n*** ** * ** ***\n\n### `detach()`\n\nDetaches the node from its parent [Element](/apps-script/reference/xml-service/element) node. If the node does not have a parent,\nthis method has no effect.\n\n#### Return\n\n\n[Content](/apps-script/reference/xml-service/content) --- the detached node\n\n*** ** * ** ***\n\n### `get``Parent``Element()`\n\nGets the node's parent [Element](/apps-script/reference/xml-service/element) node. If the node does not have a parent, this method\nreturns `null`.\n\n#### Return\n\n\n[Element](/apps-script/reference/xml-service/element) --- the parent `Element` node\n\n*** ** * ** ***\n\n### `get``Text()`\n\nGets the text value of the `Text` node.\n\n#### Return\n\n\n`String` --- the text value of the `Text` node\n\n*** ** * ** ***\n\n### `get``Value()`\n\nGets the text value of all nodes that are direct or indirect children of the node, in the order\nthey appear in the document.\n\n#### Return\n\n\n`String` --- the text value of all nodes that are direct or indirect children of the node\n\n*** ** * ** ***\n\n### `set``Text(text)`\n\nSets the text value of the `Text` node.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|-----------------------|\n| `text` | `String` | the text value to set |\n\n#### Return\n\n\n[Text](#) --- the `Text` node, for chaining"]]
