Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
SectionEn-têteÉlément
Élément de mise en page qui indique visuellement le début d'une section. Vous pouvez accéder aux éléments ou en créer à partir d'un Form.
// Open a form by ID and add a new section header.constform=FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');constitem=form.addSectionHeaderItem();item.setTitle('Title of new section');
Récupère le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems, PageBreakItems et SectionHeaderItems).
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/forms.currentonly
https://www.googleapis.com/auth/forms
getHelpText()
Récupère le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems, PageBreakItems et SectionHeaderItems).
Renvois
String : texte d'aide ou de description de l'élément
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/forms.currentonly
https://www.googleapis.com/auth/forms
getId()
Récupère l'identifiant unique de l'élément.
Renvois
Integer : ID de l'article
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/forms.currentonly
https://www.googleapis.com/auth/forms
getIndex()
Récupère l'index de l'élément parmi tous les éléments du formulaire.
Renvois
Integer : index de l'élément
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/forms.currentonly
https://www.googleapis.com/auth/forms
getTitle()
Récupère le titre de l'élément (parfois appelé "texte d'en-tête", dans le cas d'un SectionHeaderItem).
Renvois
String : titre ou texte d'en-tête de l'élément
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/forms.currentonly
https://www.googleapis.com/auth/forms
getType()
Récupère le type de l'élément, représenté par un ItemType.
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/forms.currentonly
https://www.googleapis.com/auth/forms
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).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eA \u003ccode\u003eSectionHeaderItem\u003c/code\u003e visually separates sections within a Google Form, enhancing organization and readability for respondents.\u003c/p\u003e\n"],["\u003cp\u003eYou can programmatically add, duplicate, and modify \u003ccode\u003eSectionHeaderItems\u003c/code\u003e using Apps Script methods like \u003ccode\u003esetTitle()\u003c/code\u003e, \u003ccode\u003esetHelpText()\u003c/code\u003e, and \u003ccode\u003eduplicate()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eSectionHeaderItems\u003c/code\u003e provide methods to retrieve their properties, such as \u003ccode\u003egetTitle()\u003c/code\u003e, \u003ccode\u003egetHelpText()\u003c/code\u003e, \u003ccode\u003egetId()\u003c/code\u003e, \u003ccode\u003egetIndex()\u003c/code\u003e, and \u003ccode\u003egetType()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with specific scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/forms\u003c/code\u003e is necessary when using Apps Script to interact with \u003ccode\u003eSectionHeaderItems\u003c/code\u003e and other form elements.\u003c/p\u003e\n"]]],[],null,["# Class SectionHeaderItem\n\nSectionHeaderItem\n\nA layout item that visually indicates the start of a section. Items can be accessed or created\nfrom a [Form](/apps-script/reference/forms/form).\n\n```javascript\n// Open a form by ID and add a new section header.\nconst form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');\nconst item = form.addSectionHeaderItem();\nitem.setTitle('Title of new section');\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------|----------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [duplicate()](#duplicate()) | [SectionHeaderItem](#) | Creates a copy of this item and appends it to the end of the form. |\n| [getHelpText()](#getHelpText()) | `String` | Gets the item's help text (sometimes called description text for layout items like [ImageItems](/apps-script/reference/forms/image-item), [PageBreakItems](/apps-script/reference/forms/page-break-item), and [SectionHeaderItems](#)). |\n| [getId()](#getId()) | `Integer` | Gets the item's unique identifier. |\n| [getIndex()](#getIndex()) | `Integer` | Gets the index of the item among all the items in the form. |\n| [getTitle()](#getTitle()) | `String` | Gets the item's title (sometimes called header text, in the case of a [SectionHeaderItem](#)). |\n| [getType()](#getType()) | [ItemType](/apps-script/reference/forms/item-type) | Gets the item's type, represented as an [ItemType](/apps-script/reference/forms/item-type). |\n| [setHelpText(text)](#setHelpText(String)) | [SectionHeaderItem](#) | Sets the item's help text (sometimes called description text for layout items like [ImageItems](/apps-script/reference/forms/image-item), [PageBreakItems](/apps-script/reference/forms/page-break-item), and [SectionHeaderItems](#)). |\n| [setTitle(title)](#setTitle(String)) | [SectionHeaderItem](#) | Sets the item's title (sometimes called header text, in the case of a [SectionHeaderItem](#)). |\n\nDetailed documentation\n----------------------\n\n### `duplicate()`\n\nCreates a copy of this item and appends it to the end of the form.\n\n#### Return\n\n\n[SectionHeaderItem](#) --- a duplicate of this [SectionHeaderItem](#), for chaining\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/forms.currentonly`\n- `https://www.googleapis.com/auth/forms`\n\n*** ** * ** ***\n\n### `get``Help``Text()`\n\nGets the item's help text (sometimes called description text for layout items like [ImageItems](/apps-script/reference/forms/image-item), [PageBreakItems](/apps-script/reference/forms/page-break-item), and [SectionHeaderItems](#)).\n\n#### Return\n\n\n`String` --- the item's help text or description text\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/forms.currentonly`\n- `https://www.googleapis.com/auth/forms`\n\n*** ** * ** ***\n\n### `get``Id()`\n\nGets the item's unique identifier.\n\n#### Return\n\n\n`Integer` --- the item's ID\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/forms.currentonly`\n- `https://www.googleapis.com/auth/forms`\n\n*** ** * ** ***\n\n### `get``Index()`\n\nGets the index of the item among all the items in the form.\n\n#### Return\n\n\n`Integer` --- the index of the item\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/forms.currentonly`\n- `https://www.googleapis.com/auth/forms`\n\n*** ** * ** ***\n\n### `get``Title()`\n\nGets the item's title (sometimes called header text, in the case of a [SectionHeaderItem](#)).\n\n#### Return\n\n\n`String` --- the item's title or header text\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/forms.currentonly`\n- `https://www.googleapis.com/auth/forms`\n\n*** ** * ** ***\n\n### `get``Type()`\n\nGets the item's type, represented as an [ItemType](/apps-script/reference/forms/item-type).\n\n#### Return\n\n\n[ItemType](/apps-script/reference/forms/item-type) --- the item's type\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/forms.currentonly`\n- `https://www.googleapis.com/auth/forms`\n\n*** ** * ** ***\n\n### `set``Help``Text(text)`\n\nSets the item's help text (sometimes called description text for layout items like [ImageItems](/apps-script/reference/forms/image-item), [PageBreakItems](/apps-script/reference/forms/page-break-item), and [SectionHeaderItems](#)).\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|-------------------|\n| `text` | `String` | the new help text |\n\n#### Return\n\n\n[SectionHeaderItem](#) --- this [SectionHeaderItem](#), for chaining\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/forms.currentonly`\n- `https://www.googleapis.com/auth/forms`\n\n*** ** * ** ***\n\n### `set``Title(title)`\n\nSets the item's title (sometimes called header text, in the case of a [SectionHeaderItem](#)).\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|------------------------------|\n| `title` | `String` | the new title or header text |\n\n#### Return\n\n\n[SectionHeaderItem](#) --- this [SectionHeaderItem](#), for chaining\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/forms.currentonly`\n- `https://www.googleapis.com/auth/forms`"]]