Class StringFilterBuilder
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
StringFilterBuilder
Un generatore per i controlli filtro stringa.
Un filtro di stringhe è un semplice campo di immissione di testo che consente all'utente di filtrare i dati tramite la corrispondenza di stringhe. Dato un campo di tipo stringa e le opzioni di corrispondenza, questo controllo filtra le righe
che non corrispondono al termine nel campo di immissione.
Per ulteriori dettagli, consulta la
documentazione di Gviz.
Documentazione dettagliata
setCaseSensitive(caseSensitive)
Imposta se la corrispondenza deve essere sensibile alle maiuscole o meno.
// Builds a case insensitive string filter to filter column "Col1".
const stringFilter = Charts.newStringFilter()
.setFilterColumnLabel('Col1')
.setCaseSensitive(false)
.build();
Parametri
| Nome | Tipo | Descrizione |
caseSensitive | Boolean | Se true, attiva la sensibilità alle maiuscole per la corrispondenza delle stringhe. |
Invio
StringFilterBuilder: questo builder è utile per l'accodamento.
setMatchType(matchType)
Imposta se il controllo deve corrispondere solo a valori esatti (MatchType.EXACT), prefissi
che iniziano dall'inizio del valore (MatchType.PREFIX) o a qualsiasi sottostringa
(MatchType.ANY).
// Builds a string filter to filter column "Col1" matching the prefix.
const stringFilter = Charts.newStringFilter()
.setFilterColumnLabel('Col1')
.setMatchType(Charts.MatchType.PREFIX)
.build();
Parametri
| Nome | Tipo | Descrizione |
matchType | MatchType | Il tipo di corrispondenza delle stringhe. |
Invio
StringFilterBuilder: questo builder è utile per l'accodamento.
Vedi anche
setRealtimeTrigger(realtimeTrigger)
Imposta se il controllo deve corrispondere ogni volta che viene premuto un tasto o solo quando il campo di immissione "cambia" (perdita di attenzione o pressione del tasto Invio).
// 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();
Parametri
| Nome | Tipo | Descrizione |
realtimeTrigger | Boolean | Se true, imposta gli eventi da attivare in tempo reale (quando viene premuto un tasto). |
Invio
StringFilterBuilder: questo builder è utile per l'accodamento.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 2025-07-26 UTC."],[[["\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."]]
