Utilisation des balises de note dans les pages OneNoteUse note tags in OneNote pages

S’applique à Blocs-notes grand public sur OneDrive | Blocs-notes d’entreprise sur Microsoft 365Applies to Consumer notebooks on OneDrive | Enterprise notebooks on Microsoft 365

Utilisez l’attribut data-tag pour ajouter et mettre à jour des cases à cocher, des étoiles et d’autres balises de note intégrées sur une page OneNote, comme illustré dans l’image suivante.Use the data-tag attribute to add and update check boxes, stars, and other built-in note tags on a OneNote page, as shown in the following image.

Trois balises de note affichées sur une page OneNote

Attributs de balise de noteNote tag attributes

Dans le code HTML d’une page OneNote, une balise de note est représentée par l’attribut data-tag.In the HTML of a OneNote page, a note tag is represented by the data-tag attribute. Par exemple :For example:

  • Une case décochée : <p data-tag="to-do">An unchecked to-do box: <p data-tag="to-do">

  • Une case cochée : <p data-tag="to-do:completed">A checked to-do box: <p data-tag="to-do:completed">

  • Une étoile : <h2 data-tag="important">A star: <h2 data-tag="important">

Une valeur data-tag se compose d’une forme et, parfois, d’un état (consultez toutes les valeurs prises en charges).A data-tag value is composed of a shape, and sometimes a status (see all supported values).

PropriétéProperty DescriptionDescription
shapeshape Identificateur de la balise de note (exemple : to-do ou important).The identifier of the note tag (example: to-do or important).
statusstatus État des balises de note à cocher.The status of check box note tags. Sert uniquement à définir des cases à cocher comme étant terminées.This is used only to set check boxes as completed.

Ajout ou modification des balises de noteAdd or update note tags

Pour ajouter ou mettre à jour une balise de note intégrée, utilisez simplement l’attribut data-tag sur un élément pris en charge.To add or update a built-in note tag, just use the data-tag attribute on a supported element. Par exemple, voici un paragraphe marqué comme important :For example, here's a paragraph marked as important:

<p data-tag="important">...</p>

Séparez les balises de note à l’aide de virgules :Separate multiple note tags with commas:

<p data-tag="important, critical">...</p>

Vous pouvez définir un attribut data-tag sur les éléments suivants :You can define a data-tag on the following elements:

Consultez la section Balises de note intégrées pour obtenir la liste des balises de note que vous pouvez utiliser avec Microsoft Graph.See Built-in note tags for a list of note tags that you can use with Microsoft Graph. Il n’est pas possible d’ajouter ni de mettre à jour des balises personnalisées avec Microsoft Graph.Adding or updating custom tags using Microsoft Graph is not supported.

ExemplesExamples

Voici une liste simple d’actions. Le premier élément est terminé.Here's a simple to-do list with the first item completed.

<p data-tag="to-do:completed" data-id="prep">Till garden bed</p>
<p data-tag="to-do" data-id="spring">Plant peas and spinach</p>
<p data-tag="to-do" data-id="summer">Plant tomatoes and peppers</p>

Notez que les balises <p> ci-dessus représentent un attribut data-id.Note that the <p> tags above each include a data-id attribute. Ainsi, il est plus facile de mettre à jour les balises de note à cocher.This makes it easier to update the check box note tags. Par exemple, la requête suivante marque la tâche « Plant peas and spinach » comme étant terminée.For example, the following request marks the spring planting to-do item as completed.

PATCH https://graph.microsoft.com/v1.0/me/onenote/notebooks/pages/{page-id}/content

Content-Type: application/json
Authorization: Bearer {token}

[
   {
    'target':'#spring',
    'action':'replace',
    'content':'<p data-tag="to-do:completed"  data-id="spring">Plant peas and spinach</p>'
  }
]

La requête suivante crée une page qui contient toutes les balises de note intégrées.The following request creates a page that contains all built-in note tags.

POST https://graph.microsoft.com/v1.0/me/onenote/notebooks/pages

Content-Type: text/html
Authorization: Bearer {token}


<!DOCTYPE html>
<html>
  <head>
    <title data-tag="to-do:completed">All built-in note tags</title>
  </head>
  <body>
    <h1 data-tag="important">Paragraphs with built-in note tags</h1>
    <p data-tag="to-do">to-do</p>
    <p data-tag="important">important</p>
    <p data-tag="question">question</p>
    <p data-tag="definition">definition</p>
    <p data-tag="highlight">highlight</p>
    <p data-tag="contact">contact</p>
    <p data-tag="address">address</p>
    <p data-tag="phone-number">phone-number</p>
    <p data-tag="web-site-to-visit">web-site-to-visit</p>
    <p data-tag="idea">idea</p>
    <p data-tag="password">password</p>
    <p data-tag="critical">critical</p>
    <p data-tag="project-a">project-a</p>
    <p data-tag="project-b">project-b</p>
    <p data-tag="remember-for-later">remember-for-later</p>
    <p data-tag="movie-to-see">movie-to-see</p>
    <p data-tag="book-to-read">book-to-read</p>
    <p data-tag="music-to-listen-to">music-to-listen-to</p>
    <p data-tag="source-for-article">source-for-article</p>
    <p data-tag="remember-for-blog">remember-for-blog</p>
    <p data-tag="discuss-with-person-a">discuss-with-person-a</p>
    <p data-tag="discuss-with-person-b">discuss-with-person-b</p>
    <p data-tag="discuss-with-manager">discuss-with-manager</p>
    <p data-tag="send-in-email">send-in-email</p>
    <p data-tag="schedule-meeting">schedule-meeting</p>
    <p data-tag="call-back">call-back</p>
    <p data-tag="to-do-priority-1">to-do-priority-1</p>
    <p data-tag="to-do-priority-2">to-do-priority-2</p>
    <p data-tag="client-request">client-request</p>
    <h1 data-tag="important">Paragraphs with check boxes marked with "completed" status</h1>
    <p data-tag="to-do:completed">to-do:completed</p>
    <p data-tag="discuss-with-person-a:completed">discuss-with-person-a:completed</p>
    <p data-tag="discuss-with-person-b:completed">discuss-with-person-b:completed</p>
    <p data-tag="discuss-with-manager:completed">discuss-with-manager:completed</p>
    <p data-tag="schedule-meeting:completed">schedule-meeting:completed</p>
    <p data-tag="call-back:completed">call-back:completed</p>
    <p data-tag="to-do-priority-1:completed">to-do-priority-1:completed</p>
    <p data-tag="to-do-priority-2:completed">to-do-priority-2:completed</p>
    <p data-tag="client-request:completed">client-request:completed</p>
    <h1 data-tag="important">Multiple note tags</h1>
    <p data-tag="project-a,  client-request:completed">Two note tags:  project-a, client-request:completed</p>
    <p data-tag="idea, send-in-email, question">Three note tags:  idea, send-in-email, question</p>
    <h1 data-tag="important">Using note tags with other elements</h1>
    <p><b>Note tag on a list item:</b></p>
    <ul>
      <li data-tag="to-do-priority-1:completed">Make a to-do list</li>
    </ul>
    <p><b>Note tag on an image:</b></p>
    <img data-tag="source-for-article" src="https://placecorgi.com/200" />
    <p><b>Note tag with embedded style:</b></p>
    <p data-tag="important">Next time, <b>don't</b> forget to invite <span style="background-color:yellow">Dan</span>.</p>
  </body>
</html>

Pour en savoir plus sur la création de pages, consultez l’article relatif à la création de pages OneNote.For more information about creating pages, see Create OneNote pages. Pour en savoir plus sur la mise à jour de pages, consultez l’article relatif à la mise à jour des pages OneNote.For more about updating pages, see Update OneNote pages.

Balises de note sur des listesNote tags on lists

Voici quelques recommandations pour travailler avec des balises de note sur des listes :Here are some guidelines for working with note tags on lists:

  • Utilisez les éléments p pour les listes de tâches.Use p elements for to-do lists. Elles ne présentent pas de puce ni de numéro et sont plus faciles à mettre à jour.They don't display a bullet or number, and they're easier to update.

  • Pour créer ou mettre à jour des listes qui présentent la même balise de note pour tous les éléments de la liste, définissez data-tag sur ul ou ol.To create or update lists that display the same note tag for all list items, define data-tag on the ul or ol. Pour mettre à jour l’intégralité de la liste, vous devrez redéfinir data-tag sur l’élément ul ou ol.To update the entire list, you'll need to redefine data-tag on the ul or ol.

  • Pour créer ou mettre à jour des listes qui affichent une balise de note unique pour certains ou tous les éléments de liste, définissez data-tag sur les éléments li et n’imbriquez pas les éléments li dans un ul ou ol.To create or update lists that display a unique note tag for some or all list items, define data-tag on li elements, and don't nest the li elements in a ul or ol. Pour mettre à jour l’intégralité de la liste, supprimez l’élément ul renvoyé dans le code HTML de sortie et indiquez uniquement les éléments li non imbriqués.To update the entire list, you'll need to remove the ul that's returned in the output HTML and provide only the unnested li elements.

  • Pour mettre à jour des éléments li, ciblez individuellement les éléments li et définissez l’attribut data-tag sur l’élément li.To update specific li elements, target the li elements individually and define the data-tag on the li element. Les éléments li traités individuellement peuvent être mis à jour pour afficher une balise de note unique, quelle que soit la manière dont la liste a été définie initialement.Any individually addressed li element can be updated to display a unique note tag, no matter how the list was originally defined.

    Ces recommandations reposent sur les règles suivantes, appliquées par Microsoft Graph :The guidelines are based on the following rules that are applied by Microsoft Graph:

    • Le paramètre data-tag pour un élément ul ou ol remplace tous les paramètres appliqués aux éléments li enfants.The data-tag setting for a ul or ol overrides all settings on child li elements. Cela s’applique même si ce n’est pas l’élément ul ou ol qui spécifie un attribut data-tag, mais ses éléments li enfants.This applies even when the ul or ol doesn't specify a data-tag but its child li elements do.

      Par exemple, si vous créez un élément ul ou ol qui définit data-tag="project-a", tous ses éléments de liste affichent la balise de note Project A.For example, if you create a ul or ol that defines data-tag="project-a", all its list items will display the Project A note tag. Ou si l’élément ul ou ol ne définit pas un attribut data-tag, aucun de ses éléments n’affichera de balise de note.Or if the ul or ol doesn't define a data-tag, none of its items will display a note tag. Ce remplacement se produit quels que soient les paramètres explicites appliqués aux éléments li enfants.This override happens regardless of any explicit settings on child li elements.

  • Des paramètres data-tag uniques sont pris en charge pour les éléments de liste dans les conditions suivantes :Unique data-tag settings are honored for list items under the following conditions:

    • Les éléments li ne sont pas imbriqués dans un élémentul ou ol dans une demande de création ou de mise à jour.The li elements are not nested in a ul or ol in a create or update request.

    • Un élément li est traité individuellement dans une demande de mise à jour.An li element is individually addressed in an update request.

  • Les éléments li non imbriqués envoyés dans le code HTML d’entrée sont renvoyés dans un élément ul dans le code HTML de sortie.Unnested li elements sent in input HTML are returned in a ul in the output HTML.

  • Dans le code HTML de sortie, tous les paramètres de liste data-tag sont définis sur des éléments span sur les éléments de liste.In output HTML, all data-tag list settings are defined on span elements on the list items.

Le code suivant montre comment certaines de ces règles sont appliquées.The following code shows how some of these rules are applied. Le code HTML d’entrée crée deux listes avec des balises de note.The input HTML creates two lists with note tags. Le code HTML de sortie est renvoyé pour les listes quand vous récupérez le contenu d’une page.The output HTML is what's returned for the lists when you retrieve page content.

Code HTML d’entréeInput HTML

<!--To display the same note tag on all list items, define note tags on the ul or ol.-->
<ul data-tag="project-a" data-id="agenda">
  <li>An item with a Project A note tag</li>
  <li>An item with a Project A note tag</li>
</ul>

<!--To display unique note tags on list items, don't nest li elements in a ul or ol.-->
<li data-tag="idea" data-id="my-idea">An item with an Idea note tag</li>
<li data-tag="question" data-id="my-question">An item with a Question note tag</li>

Code HTML de sortieOutput HTML

<ul>
  <li><span data-tag="project-a">An item with a Project A note tag</span></li>
  <li><span data-tag="project-a">An item with a Project A note tag</span></li>
</ul>
<br />
<ul>
  <li style="..."><span data-tag="idea">An item with an Idea note tag</span></li>
  <li style="..."><span data-tag="question">An item with a Question note tag</span></li>
</ul>

Récupération des balises de noteRetrieve note tags

Les balises de note sont incluses dans le code HTML de sortie quand vous récupérez le contenu d’une page :Built-in note tags are included in the output HTML when you get page content:

GET ../api/v1.0/pages/{page-id}/content

Un attribut data-tag dans le code HTML de sortie inclut toujours une valeur de forme et inclut un état uniquement s’il représente une balise de note à cocher définie comme étant terminée.A data-tag attribute in the output HTML always includes a shape value, and it only includes a status if it represents a check box note tag that's set to completed. Les exemples suivants illustrent le code HTML d’entrée utilisé pour créer des balises de note et le code HTML de sortie renvoyé.The following examples show the input HTML used to create some note tags and the output HTML that's returned.

Code HTML d’entréeInput HTML

<h1>Status meeting</h1>
<p data-tag="important">Next week's meeting has been moved to <b>Wednesday</b>.</p>
<p data-tag="question">What are the exact dates for the conference?</p>
<p>Upcoming training opportunities. See Katie for more info.</p>
<p data-tag="project-a">Around the room updates.</p>
<ul data-tag="critical">
  <li>Design handouts</li>
  <li>Plan keynote</li>
</ul>

Code HTML de sortieOutput HTML

<h1 style="...">Status meeting</h1>
<p data-tag="important">Next week's meeting has been moved to <span style="font-weight:bold">Wednesday</span>.</p>
<p data-tag="question">What are the exact dates for the conference?</p>
<p>Upcoming training opportunities. See Katie for more info.</p>
<p data-tag="project-a">Around the room updates.</p>
<ul>
  <li><span data-tag="critical">Design handouts</span></li>
  <li><span data-tag="critical">Plan keynote</span></li>
</ul>

Notez que l’attribut data-tag défini au niveau de la liste est transmis à ses éléments de liste.Note that the data-tag attribute defined at the list level is pushed to its list items. Pour en savoir plus sur l’utilisation des balises de note avec des listes, consultez la section Balises de note sur des listes.For more information about using note tags with lists, see Note tags on lists.

Remarque : dans le code HTML de sortie, les balises de note de définition et de rappel ultérieur sont toutes deux renvoyées de la manière suivante : data-tag="remember-for-later".Note: In the output HTML, the definition and remember-for-later note tags are both returned as data-tag="remember-for-later". L’élément title ne renvoie aucune information de balise de note.The title element doesn't return any note tag information.

Balises de note intégrées pour OneNoteBuilt-in note tags for OneNote

OneNote comprend les balises de note intégrées suivantes :OneNote includes the following built-in note tags:

Toutes les balises de note intégrées.

Les valeurs que vous pouvez attribuer à l' data-tag attribut sont indiquées dans la liste suivante.The values you can assign to the data-tag attribute are shown in the following list. Les balises personnalisées ne sont pas prises en charge.Custom tags are not supported.

  • shape[:status]
  • to-do
  • to-do:completed
  • important
  • question
  • definition
  • highlight
  • contact
  • address
  • phone-number
  • web-site-to-visit
  • idea
  • password
  • critical
  • project-a
  • project-b
  • remember-for-later
  • movie-to-see
  • book-to-read
  • music-to-listen-to
  • source-for-article
  • remember-for-blog
  • discuss-with-person-a
  • discuss-with-person-a:completed
  • discuss-with-person-b
  • discuss-with-person-b:completed
  • discuss-with-manager
  • discuss-with-manager:completed
  • send-in-email
  • schedule-meeting
  • schedule-meeting:completed
  • call-back
  • call-back:completed
  • to-do-priority-1
  • to-do-priority-1:completed
  • to-do-priority-2
  • to-do-priority-2:completed
  • client-request
  • client-request:completed

Informations de la réponseResponse information

Microsoft Graph renvoie les informations suivantes dans la réponse.Microsoft Graph returns the following information in the response.

Données de réponseResponse data DescriptionDescription
Code de succèsSuccess code Code d’état HTTP 201 pour une requête POST réussie et code d’état HTTP 204 pour une requête PATCH réussie.A 201 HTTP status code for a successful POST request, and a 204 HTTP status code for a successful PATCH request.
ErreursErrors Consultez l’article Codes d’erreur pour les API OneNote dans Microsoft Graph pour en savoir plus sur les erreurs OneNote renvoyées par Microsoft Graph.Read Error codes for OneNote APIs in Microsoft Graph to learn about OneNote errors that Microsoft Graph can return.

AutorisationsPermissions

Pour créer ou mettre à jour des pages OneNote, demandez les autorisations appropriées.To create or update OneNote pages, you'll need to request appropriate permissions. Choisissez le niveau d’autorisation le plus faible requis par votre application pour faire son travail.Choose the lowest level of permissions that your app needs to do its work.

Autorisations pour les pages POSTPermissions for POST pages

  • Notes.CreateNotes.Create
  • Notes.ReadWriteNotes.ReadWrite
  • Notes.ReadWrite.AllNotes.ReadWrite.All

Autorisations pour les pages PATCHPermissions for PATCH pages

  • Notes.ReadWriteNotes.ReadWrite
  • Notes.ReadWrite.AllNotes.ReadWrite.All

Pour en savoir plus sur les étendues d’autorisation et leur fonctionnement, consultez la section relative aux étendues d’autorisation dans OneNote.For more information about permission scopes and how they work, see OneNote permission scopes.

Voir aussiSee also