Class StringFilterBuilder
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
فیلتر ساز رشته سازنده ای برای کنترل های فیلتر رشته ای.
فیلتر رشته ای یک فیلد ورودی متن ساده است که به کاربر اجازه می دهد داده ها را از طریق تطبیق رشته ها فیلتر کند. با توجه به ستونی از نوع رشته و گزینه های تطبیق، این کنترل ردیف هایی را که با عبارت موجود در فیلد ورودی مطابقت ندارند، فیلتر می کند.
برای جزئیات بیشتر، به مستندات Gviz مراجعه کنید.
مستندات دقیق
set Case Sensitive(caseSensitive)
تعیین می کند که آیا مطابقت باید به حروف بزرگ و کوچک حساس باشد یا خیر.
// Builds a case insensitive string filter to filter column "Col1".
const stringFilter = Charts.newStringFilter()
.setFilterColumnLabel('Col1')
.setCaseSensitive(false)
.build();
پارامترها
نام | تایپ کنید | توضیحات |
---|
case Sensitive | Boolean | اگر true ، حساسیت به حروف کوچک و بزرگ مطابق با رشته را فعال می کند. |
بازگشت
String Filter Builder
- این سازنده، برای زنجیر کردن مفید است.
set Match Type(matchType)
تنظیم میکند که آیا کنترل فقط با مقادیر دقیق مطابقت داشته باشد ( Match Type.EXACT
)، پیشوندهایی که از ابتدای مقدار شروع میشوند ( Match Type.PREFIX
)، یا هر رشته فرعی ( Match Type.ANY
).
// Builds a string filter to filter column "Col1" matching the prefix.
const stringFilter = Charts.newStringFilter()
.setFilterColumnLabel('Col1')
.setMatchType(Charts.MatchType.PREFIX)
.build();
پارامترها
نام | تایپ کنید | توضیحات |
---|
match Type | Match Type | نوع تطبیق رشته. |
بازگشت
String Filter Builder
- این سازنده، برای زنجیر کردن مفید است.
همچنین ببینید
set Realtime Trigger(realtimeTrigger)
تنظیم میکند که هر زمانی که یک کلید فشار داده میشود یا فقط زمانی که فیلد ورودی «تغییر میکند» (از دست دادن فوکوس یا فشار دادن کلید Enter)، کنترل باید مطابقت داشته باشد.
// Builds a string filter to filter column "Col1" that checks the match any time
// a key is pressed.
const stringFilter = Charts.newStringFilter()
.setFilterColumnLabel('Col1')
.setRealtimeTrigger(true)
.build();
پارامترها
نام | تایپ کنید | توضیحات |
---|
realtime Trigger | Boolean | اگر true ، رویدادها را تنظیم می کند که در زمان واقعی (هنگامی که یک کلید فشار داده می شود) فعال شوند. |
بازگشت
String Filter Builder
- این سازنده، برای زنجیر کردن مفید است.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eStringFilterBuilder helps create string filter controls for filtering data in Google Charts.\u003c/p\u003e\n"],["\u003cp\u003eIt offers options to control matching behavior, including case sensitivity, match type (exact, prefix, or any substring), and real-time triggering.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can customize the filter by setting properties like \u003ccode\u003ecaseSensitive\u003c/code\u003e, \u003ccode\u003ematchType\u003c/code\u003e, and \u003ccode\u003erealtimeTrigger\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe builder pattern allows for chaining methods for convenient and readable filter configuration.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the Gviz documentation for more in-depth information and examples.\u003c/p\u003e\n"]]],[],null,["# Class StringFilterBuilder\n\nStringFilterBuilder\n\nA builder for string filter controls.\n\nA string filter is a simple text input field that lets the user filter data via string\nmatching. Given a column of type string and matching options, this control filters out the rows\nthat don't match the term that's in the input field.\n\nFor more details, see the Gviz [documentation](https://developers.google.com/chart/interactive/docs/gallery/controls#stringfilter). \n\n### Methods\n\n| Method | Return type | Brief description |\n|---------------------------------------------------------------------|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [setCaseSensitive(caseSensitive)](#setCaseSensitive(Boolean)) | [StringFilterBuilder](#) | Sets whether matching should be case sensitive or not. |\n| [setMatchType(matchType)](#setMatchType(MatchType)) | [StringFilterBuilder](#) | Sets whether the control should match exact values only ([MatchType.EXACT](/apps-script/reference/charts/match-type#EXACT)), prefixes starting from the beginning of the value ([MatchType.PREFIX](/apps-script/reference/charts/match-type#PREFIX)), or any substring ([MatchType.ANY](/apps-script/reference/charts/match-type#ANY)). |\n| [setRealtimeTrigger(realtimeTrigger)](#setRealtimeTrigger(Boolean)) | [StringFilterBuilder](#) | Sets whether the control should match any time a key is pressed or only when the input field 'changes' (loss of focus or pressing the Enter key). |\n\nDetailed documentation\n----------------------\n\n### `set``Case``Sensitive(caseSensitive)`\n\nSets whether matching should be case sensitive or not.\n\n```javascript\n// Builds a case insensitive string filter to filter column \"Col1\".\nconst stringFilter = Charts.newStringFilter()\n .setFilterColumnLabel('Col1')\n .setCaseSensitive(false)\n .build();\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|-------------------|-----------|------------------------------------------------------|\n| `case``Sensitive` | `Boolean` | If `true`, enables string matching case sensitivity. |\n\n#### Return\n\n\n[StringFilterBuilder](#) --- This builder, useful for chaining.\n\n*** ** * ** ***\n\n### `set``Match``Type(matchType)`\n\nSets whether the control should match exact values only ([MatchType.EXACT](/apps-script/reference/charts/match-type#EXACT)), prefixes\nstarting from the beginning of the value ([MatchType.PREFIX](/apps-script/reference/charts/match-type#PREFIX)), or any substring\n([MatchType.ANY](/apps-script/reference/charts/match-type#ANY)).\n\n```javascript\n// Builds a string filter to filter column \"Col1\" matching the prefix.\nconst stringFilter = Charts.newStringFilter()\n .setFilterColumnLabel('Col1')\n .setMatchType(Charts.MatchType.PREFIX)\n .build();\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|---------------|-------------------------------------------------------|---------------------------|\n| `match``Type` | [MatchType](/apps-script/reference/charts/match-type) | The string matching type. |\n\n#### Return\n\n\n[StringFilterBuilder](#) --- This builder, useful for chaining.\n\n#### See also\n\n- [MatchType](/apps-script/reference/charts/match-type)\n\n*** ** * ** ***\n\n### `set``Realtime``Trigger(realtimeTrigger)`\n\nSets whether the control should match any time a key is pressed or only when the input field\n'changes' (loss of focus or pressing the Enter key).\n\n```javascript\n// Builds a string filter to filter column \"Col1\" that checks the match any time\n// a key is pressed.\nconst stringFilter = Charts.newStringFilter()\n .setFilterColumnLabel('Col1')\n .setRealtimeTrigger(true)\n .build();\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|---------------------|-----------|------------------------------------------------------------------------------|\n| `realtime``Trigger` | `Boolean` | If `true`, sets events to be triggered at real time (when a key is pressed). |\n\n#### Return\n\n\n[StringFilterBuilder](#) --- This builder, useful for chaining."]]