Class ListStyle
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Style de liste
Style de liste pour une plage de texte.
Méthodes
| Méthode | Type renvoyé | Brève description |
applyListPreset(listPreset) | ListStyle | Applique l'ListPreset spécifié à tous les paragraphes qui chevauchent le texte. |
getGlyph() | String | Renvoie le glyphe affiché pour le texte. |
getList() | List | Renvoie la List dans laquelle se trouve le texte, ou null si aucun texte ne se trouve dans une liste, ou si une partie du texte se trouve dans une liste, ou si le texte se trouve dans plusieurs listes. |
getNestingLevel() | Integer | Renvoie le niveau d'imbrication du texte, basé sur 0. |
isInList() | Boolean | Renvoie true si le texte figure dans exactement une liste, false si aucun texte ne figure dans une liste et null si seulement une partie du texte figure dans une liste ou si le texte figure dans plusieurs listes. |
removeFromList() | ListStyle | Supprime les paragraphes qui chevauchent le texte de toutes les listes. |
Documentation détaillée
applyListPreset(listPreset)
Applique l'ListPreset spécifié à tous les paragraphes qui chevauchent le texte.
Le niveau d'imbrication de chaque paragraphe est déterminé en comptant les tabulations avant chaque paragraphe. Pour éviter un espace excessif entre les glyphes et le paragraphe correspondant, ces tabulations initiales sont supprimées par cette méthode.
Si le paragraphe immédiatement avant les paragraphes mis à jour se trouve dans un List avec un préréglage de liste correspondant et que les paragraphes mis à jour ne figurent pas déjà dans une autre liste, ils sont ajoutés à cette liste précédente.
Paramètres
Renvois
ListStyle
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getGlyph()
Renvoie le glyphe affiché pour le texte. Renvoie null si le texte s'étend sur plusieurs paragraphes ou s'il ne figure pas dans une liste.
Renvois
String
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getList()
Renvoie la List dans laquelle se trouve le texte, ou null si aucun texte ne se trouve dans une liste, ou si une partie du texte se trouve dans une liste, ou si le texte se trouve dans plusieurs listes. Appelez isInList() pour déterminer si le texte figure dans une liste.
Renvois
List
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getNestingLevel()
Renvoie le niveau d'imbrication du texte, basé sur 0. Renvoie null si le texte ne figure pas dans une liste ou si des valeurs sont mélangées.
Renvois
Integer
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isInList()
Renvoie true si le texte figure dans exactement une liste, false si aucun texte ne figure dans une liste et null si seulement une partie du texte figure dans une liste ou si le texte figure dans plusieurs listes.
Renvois
Boolean
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeFromList()
Supprime les paragraphes qui chevauchent le texte de toutes les listes.
Le niveau d'imbrication de chaque paragraphe est conservé visuellement en ajoutant un retrait au début du paragraphe correspondant.
Renvois
ListStyle
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003e\u003ccode\u003eListStyle\u003c/code\u003e encompasses methods to manipulate the styling and structure of lists within text ranges in Google Slides.\u003c/p\u003e\n"],["\u003cp\u003eIt provides functionalities to apply list presets, determine nesting levels, and check if text resides within a list.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the rendered glyph or the associated \u003ccode\u003eList\u003c/code\u003e object for further manipulation.\u003c/p\u003e\n"],["\u003cp\u003eMethods are available to remove text from lists while preserving visual indentation.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with specific scopes is required to utilize these methods in your scripts.\u003c/p\u003e\n"]]],["The `ListStyle` object manages text list formatting. Key actions include: applying a `ListPreset` to paragraphs, which also adjusts nesting levels by removing leading tabs; retrieving the rendered glyph, the associated `List` object, or the nesting level. It can also check if the text is within a list, and remove text from any existing list. Additionally, removing text from a list visually preserves nesting through indenting. Each method requires specific authorization scopes.\n"],null,["# Class ListStyle\n\nListStyle\n\nThe list styling for a range of text. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------------------|--------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [applyListPreset(listPreset)](#applyListPreset(ListPreset)) | [ListStyle](#) | Applies the specified [ListPreset](/apps-script/reference/slides/list-preset) to all of the paragraphs that overlap with the text. |\n| [getGlyph()](#getGlyph()) | `String` | Returns the rendered glyph for the text. |\n| [getList()](#getList()) | [List](/apps-script/reference/slides/list) | Returns the [List](/apps-script/reference/slides/list) the text is in, or `null` if none of the text is in a list, or part of the text is in a list, or the text is in multiple lists. |\n| [getNestingLevel()](#getNestingLevel()) | `Integer` | Returns the 0-based nesting level of the text. |\n| [isInList()](#isInList()) | `Boolean` | Returns `true` if the text is in exactly one list, `false` if none of the text is in a list, and `null` if only some of the text is in a list or if the text is in multiple lists. |\n| [removeFromList()](#removeFromList()) | [ListStyle](#) | Removes the paragraphs that overlap with the text from any lists. |\n\nDetailed documentation\n----------------------\n\n### `apply``List``Preset(listPreset)`\n\nApplies the specified [ListPreset](/apps-script/reference/slides/list-preset) to all of the paragraphs that overlap with the text.\n\nThe nesting level of each paragraph is determined by counting leading tabs in front of each\nparagraph. To avoid excess space between the glyphs and the corresponding paragraph, these\nleading tabs are removed by this method.\n\nIf the paragraph immediately before paragraphs being updated is in a [List](/apps-script/reference/slides/list) with a\nmatching list preset and the paragraphs being updated are not already in a different list, the\nparagraphs being updated are added to that preceding list.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------------|---------------------------------------------------------|-------------|\n| `list``Preset` | [ListPreset](/apps-script/reference/slides/list-preset) | |\n\n#### Return\n\n\n[ListStyle](#)\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Glyph()`\n\nReturns the rendered glyph for the text. Returns `null` if the text spans more than one\nparagraph or the text is not in a list.\n\n#### Return\n\n\n`String`\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``List()`\n\nReturns the [List](/apps-script/reference/slides/list) the text is in, or `null` if none of the text is in a list, or\npart of the text is in a list, or the text is in multiple lists. Call [isInList()](#isInList()) to\ndetermine whether the text is in a list.\n\n#### Return\n\n\n[List](/apps-script/reference/slides/list)\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Nesting``Level()`\n\nReturns the 0-based nesting level of the text. Returns `null` if the text is not in a\nlist or there are mixed values.\n\n#### Return\n\n\n`Integer`\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `is``In``List()`\n\nReturns `true` if the text is in exactly one list, `false` if none of the text is\nin a list, and `null` if only some of the text is in a list or if the text is in multiple\nlists.\n\n#### Return\n\n\n`Boolean`\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `remove``From``List()`\n\nRemoves the paragraphs that overlap with the text from any lists.\n\nThe nesting level of each paragraph is visually preserved by adding indent to the start of\nthe corresponding paragraph.\n\n#### Return\n\n\n[ListStyle](#)\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`"]]
