Class TextArea
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
منطقة النص
يحتوي على معلومات منطقة النص للإعداد. وتحدّد خصائصه كيفية عرض الإدخال النصي
في "مركز البيانات".
الاستخدام:
const cc = DataStudioApp.createCommunityConnector();
const config = cc.getConfig();
const textArea1 = config.newTextArea()
.setId('textArea1')
.setName('Search')
.setHelpText('for example, Coldplay')
.setAllowOverride(true)
.setPlaceholder('Search for an artist for all songs.');
مستندات تفصيلية
setAllowOverride(allowOverride)
يتيح هذا الخيار إلغاء إدخال الإعدادات هذا. في حال ضبط القيمة على true
، يكون لصنّاع مصادر البيانات
الخيار لتفعيل هذه الميزة لمحرّري التقارير.
المعلمات
الاسم | النوع | الوصف |
allowOverride | Boolean | ما إذا كان يمكن إلغاء إدخال الإعدادات هذا في التقارير أم لا |
الإرجاع
TextArea
: هذا المُنشئ، لتسلسل العناصر.
setHelpText(helpText)
تُستخدَم لضبط نص المساعدة الخاص بإدخال الإعدادات هذا.
المعلمات
الاسم | النوع | الوصف |
helpText | String | نص المساعدة المطلوب ضبطه. |
الإرجاع
TextArea
: هذا المُنشئ، لتسلسل العناصر.
setId(id)
لضبط المعرّف الفريد لإدخال الإعدادات هذا.
المعلمات
الاسم | النوع | الوصف |
id | String | رقم التعريف المطلوب ضبطه. |
الإرجاع
TextArea
: هذا المُنشئ، لتسلسل العناصر.
setIsDynamic(isDynamic)
لضبط الحالة الديناميكية لإدخال الإعداد هذا.
في حال تعديل إدخال الإعدادات الديناميكي، يتم محو إدخالات الإعدادات اللاحقة.
المعلمات
الاسم | النوع | الوصف |
isDynamic | Boolean | الحالة الديناميكية المطلوب ضبطها |
الإرجاع
TextArea
: هذا المُنشئ، لتسلسل العناصر.
setName(name)
لضبط الاسم المعروض لإدخال الإعدادات هذا.
المعلمات
الاسم | النوع | الوصف |
name | String | الاسم المطلوب ضبطه. |
الإرجاع
TextArea
: هذا المُنشئ، لتسلسل العناصر.
setPlaceholder(placeholder)
تُستخدَم لضبط نص العنصر النائب لإدخال الإعدادات هذا.
المعلمات
الاسم | النوع | الوصف |
placeholder | String | نص العنصر النائب المطلوب ضبطه |
الإرجاع
TextArea
: هذا المُنشئ، لتسلسل العناصر.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eTextArea defines how text input is displayed in Data Studio, and its properties can be customized using various methods.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use methods like \u003ccode\u003esetAllowOverride\u003c/code\u003e, \u003ccode\u003esetHelpText\u003c/code\u003e, \u003ccode\u003esetId\u003c/code\u003e, \u003ccode\u003esetIsDynamic\u003c/code\u003e, \u003ccode\u003esetName\u003c/code\u003e, and \u003ccode\u003esetPlaceholder\u003c/code\u003e to configure the TextArea.\u003c/p\u003e\n"],["\u003cp\u003eEach method allows for customization, like enabling overrides, setting help text, defining IDs, setting dynamic status, naming the field, and adding placeholder text.\u003c/p\u003e\n"],["\u003cp\u003eAll configuration methods return the TextArea builder, allowing for chained configurations in a fluent manner.\u003c/p\u003e\n"],["\u003cp\u003eUsing \u003ccode\u003eTextArea\u003c/code\u003e, developers can create interactive text input fields in Data Studio for users to input data.\u003c/p\u003e\n"]]],[],null,["# Class TextArea\n\nTextArea\n\nContains text area information for the config. Its properties determine how the text input is\ndisplayed in Data Studio.\n\nUsage:\n\n```javascript\nconst cc = DataStudioApp.createCommunityConnector();\nconst config = cc.getConfig();\n\nconst textArea1 = config.newTextArea()\n .setId('textArea1')\n .setName('Search')\n .setHelpText('for example, Coldplay')\n .setAllowOverride(true)\n .setPlaceholder('Search for an artist for all songs.');\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|---------------------------------------------------------------|---------------|---------------------------------------------------------|\n| [setAllowOverride(allowOverride)](#setAllowOverride(Boolean)) | [TextArea](#) | Enables overriding for this config entry. |\n| [setHelpText(helpText)](#setHelpText(String)) | [TextArea](#) | Sets the help text for this configuration entry. |\n| [setId(id)](#setId(String)) | [TextArea](#) | Sets the unique ID for this configuration entry. |\n| [setIsDynamic(isDynamic)](#setIsDynamic(Boolean)) | [TextArea](#) | Sets the dynamic status for this configuration entry. |\n| [setName(name)](#setName(String)) | [TextArea](#) | Sets the display name for this configuration entry. |\n| [setPlaceholder(placeholder)](#setPlaceholder(String)) | [TextArea](#) | Sets the placeholder text for this configuration entry. |\n\nDetailed documentation\n----------------------\n\n### `set``Allow``Override(allowOverride)`\n\nEnables overriding for this config entry. If set to `true`, data source creators have the\noption to enable this for report editors.\n\n#### Parameters\n\n| Name | Type | Description |\n|-------------------|-----------|----------------------------------------------------------------|\n| `allow``Override` | `Boolean` | Whether or not this config entry can be overridden in reports. |\n\n#### Return\n\n\n[TextArea](#) --- This builder, for chaining.\n\n*** ** * ** ***\n\n### `set``Help``Text(helpText)`\n\nSets the help text for this configuration entry.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------|----------|----------------------|\n| `help``Text` | `String` | The helpText to set. |\n\n#### Return\n\n\n[TextArea](#) --- This builder, for chaining.\n\n*** ** * ** ***\n\n### `set``Id(id)`\n\nSets the unique ID for this configuration entry.\n\n#### Parameters\n\n| Name | Type | Description |\n|------|----------|----------------|\n| `id` | `String` | The ID to set. |\n\n#### Return\n\n\n[TextArea](#) --- This builder, for chaining.\n\n*** ** * ** ***\n\n### `set``Is``Dynamic(isDynamic)`\n\nSets the dynamic status for this configuration entry.\n\nIf a dynamic configuration entry is modified, subsequent configuration entries are cleared.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------------|-----------|----------------------------|\n| `is``Dynamic` | `Boolean` | The dynamic status to set. |\n\n#### Return\n\n\n[TextArea](#) --- This builder, for chaining.\n\n*** ** * ** ***\n\n### `set``Name(name)`\n\nSets the display name for this configuration entry.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|------------------|\n| `name` | `String` | The name to set. |\n\n#### Return\n\n\n[TextArea](#) --- This builder, for chaining.\n\n*** ** * ** ***\n\n### `set``Placeholder(placeholder)`\n\nSets the placeholder text for this configuration entry.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------------|----------|------------------------------|\n| `placeholder` | `String` | The placeholder text to set. |\n\n#### Return\n\n\n[TextArea](#) --- This builder, for chaining."]]