Eingabe- und Ausgabe-HTML auf OneNote-SeitenInput and output HTML in OneNote pages

Der HTML-Code, der den Seiteninhalt und die Seitenstruktur definiert, wenn Sie eine OneNote-Seite erstellen oder aktualisieren, wird Eingabe-HTML genannt.The HTML that defines the page content and structure when you create or update a OneNote page is called input HTML.

Der HTML-Code, der beim Abrufen von Seiteninhalt zurückgegeben wird, heißt Ausgabe-HTML.The HTML that's returned when you get page content is called output HTML. Der Ausgabe-HTML-Code entspricht nicht dem Eingabe-HTML-Code.Output HTML won't be the same as input HTML.

Die OneNote-APIs in Microsoft Graph behalten den semantischen Inhalt und die grundlegende Struktur des Eingabe-HTML-Codes bei, konvertieren diese jedoch in unterstützte HTML-Elemente und CSS-Eigenschaften.The OneNote APIs in Microsoft Graph preserve the semantic content and basic structure of the input HTML, but convert it to a set of supported HTML elements and CSS properties. Die APIs fügen zudem benutzerdefinierte Attribute hinzu, die OneNote-Funktionen unterstützen.The APIs also add custom attributes that support OneNote features.

Dieser Artikel beschreibt die wichtigsten Elemente und Attribute von Eingabe- und Ausgabe-HTML-Codes.This article describes the principal elements and attributes of input and output HTML. Es kann hilfreich sein, Eingabe-HTML-Codes zu verstehen, wenn Sie Seiteninhalte erstellen oder aktualisieren. Mit Ausgabe- HTML-Codes sollten Sie sich auskennen, wenn Sie zurückgegebene Seiteninhalte analysieren möchten.It can be helpful to understand input HTML when you're creating or updating page content, and output HTML when you're parsing returned page content.

Textkörperelementbody element

Der HTML-Inhalt im Textkörper der Seite repräsentiert den Seiteninhalt und die Seitenstruktur, einschließlich der Bild- und Dateiressourcen.The HTML content in the page body represents the page content and structure, including image and file resources. Das body-Element kann die folgenden Attribute in der Eingabe- und Ausgabe-HTML enthalten.The body element can contain the following attributes in the input and output HTML.

EingabeattributeInput attributes

EingabeattributInput attribute BeschreibungDescription
data-absolute-enableddata-absolute-enabled Gibt an, ob der Eingabe-Textkörper absolute positioned-Elemente unterstützt.Indicates whether the input body supports absolute positioned elements.
Formatvorlagestyle

Die CSS-style-Eigenschaften des Textkörpers.The CSS style properties of the body. In der Ausgabe-HTML können Eingabeeinstellungen eingebettet in die entsprechenden untergeordneten Elemente zurückgegeben werden.In the output HTML, input settings might be returned inline on appropriate child elements.

Hintergrundfarbe wird derzeit nicht für das body-Element unterstützt.Background color is not currently supported for the body element.

AusgabeattributeOutput attributes

AusgabeattributOutput attribute BeschreibungDescription
data-absolute-enableddata-absolute-enabled Gibt an, ob der Textkörper absolute positioned-Elemente unterstützt.Indicates whether the body supports absolute positioned elements. Immer true in der HTML-Ausgabe.Always true in output HTML.
Formatvorlagestyle Die Eigenschaften font-family und font-size des Textkörpers.The font-family and font-size properties of the body.

Div-Elementediv elements

Div-Elemente enthalten Text, Bilder und andere Inhalte.Div elements contain text, images, and other content. Das div-Element kann die folgenden Attribute in der Eingabe- und Ausgabe-HTML enthalten.A div element can contain the following attributes in the input and output HTML.

EingabeattributeInput attributes

EingabeattributInput attribute BeschreibungDescription
data-iddata-id Ein Verweis für das Element.A reference for the element.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
data-render-fallbackdata-render-fallback Die Ausweichaktion bei einem Fehler der Extraktion: render (Standard) oder none.The fallback action if the extraction fails: render (default) or none
data-render-methoddata-render-method Die auszuführende Extraktionsmethode, z. B.:The extraction method to perform, for example:
extract.businesscard oder extract.recipeextract.businesscard or extract.recipe
data-render-srcdata-render-src Die Inhaltsquelle für die Extraktion.The content source for the extraction.
Formatvorlagestyle Die Position, Größe, Schriftart und Farbe von Eigenschaften für div:The position, size, font, and color properties for the div:
  • Position (nur absolut), links, oben und Breite (Höhe wird für div-Tags automatisch konfiguriert)position (absolute only), left, top, and width (height is auto-configured for divs)

    Wird verwendet, um ein absolut positioniertes-Div-Element zu erstellen, wenn das Div-Element ein direktes untergeordnetes Element des Textkörpers und für den Textkörper data-absolute-enabled="true" angegeben ist.Used to create an absolute positioned div, only if the div is a direct child of the body when the body sets data-absolute-enabled="true".

    Beispiel: <div style="position:absolute;width:360px;top:350px;left:300px" ... />Example: <div style="position:absolute;width:360px;top:350px;left:300px" ... />
  • Die CSS-style-Eigenschaften des Elements. In der Ausgabe-HTML werden diese Werte inline in entsprechenden untergeordneten Elementen zurückgegeben.The CSS style properties of the element. In the output HTML, these values are returned inline on appropriate child elements.

Die OneNote-APIs in Microsoft Graph umschließen alle Textkörper mit mindestens einem Div.The OneNote APIs in Microsoft Graph wrap all body content in at least one div. Die API erstellt ein standardmäßiges Div (mit data-id="_default"-Attributen), die den Textkörper enthalten, wenn:The API creates a default div (attributed with data-id="_default") to contain the body content if:

  • Das data-absolute-enabled-Attribut des Eingabe-Textkörper-Elements ausgelassen oder auf false gesetzt wird.The input body element's data-absolute-enabled attribute is omitted or set to false. In diesem Fall werden alle Inhalte des Textkörpers im standardmäßigen Div abgelegt.In this case, all body content is put in the default div.

  • Das data-absolute-enabled-Attribut des Eingabe-Textkörper-Elements auf true gesetzt wird, die Eingabe HTML jedoch direkt untergeordnete Elemente enthält, die absolute positioned div, img oder object-Elemente sind.The input body element's data-absolute-enabled attribute is true, but the input HTML contains direct children that aren't absolute positioned div, img, or object elements. In diesem Fall werden untergeordnete Elemente, die keine absolute positioned div, img oder object-Elemente sind, im standardmäßigen Div abgelegt.In this case, direct children that aren't absolute positioned div, img, or object elements are put in the default div.

AusgabeattributeOutput attributes

AusgabeattributOutput attribute BeschreibungDescription
data-iddata-id Ein Verweis für das Element.A reference for the element.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
idid Eine eindeutige generierte ID für das Element.A unique, generated ID for the element. Zurückgegeben von einem GET requests to a page's -content-Endpunkt , wenn die includeIDs=true-Abfrageoption verwendet wird.Returned by GET requests to a page's content endpoint when the includeIDs=true query option is used.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
Formatvorlagestyle Die Positions- und Größeneigenschaften des div-Elements.The position and size properties of the div.

Nicht beitragende DivsNon-contributing divs

Wenn ein div-Element in der Eingabe-HTML nichts zur Seitenstruktur beiträgt und keine von OneNote verwendeten Informationen enthält, verschiebt die API den Inhalt des div-Elements in das übergeordnete oder standardmäßige div-Element.When a div element in the input HTML does not contribute to the page structure or carry information that OneNote uses, the API moves the div's content into the parent or default div. Dieser Vorgang wird in den folgenden Beispielen dargestellt.This is illustrated in the following examples.

Eingabe-HTMLInput HTML

Enthält ein nicht beitragendes, geschachteltes div-Element.Contains a non-contributing, nested div.

<html>
    <head>
        <title>Page Title</title>
    </head>
    <body>
        <div>
            <p>Some text</p>
            <div>
                <p>More text inside a div that doesn't define page structure</p>
            </div>
        </div>
    </body>
</html>

Ausgabe-HTMLOutput HTML

Hinweis: Der DIV-Inhalt wurde in die übergeordnete Div verschoben, und die geschachtelten <div>-Tags wurden entfernt.Note: The div's content was moved to the parent div and the nested <div> tags have been removed. Die Div wäre erhalten geblieben, wenn sie semantische Informationen definiert hätte, z. B. eine Daten-Id (Beispiel: <div data-id="keep-me">).The div would have been preserved if it defined any semantic information, such as a data-id (example: <div data-id="keep-me">).

<html htmlns="https://www.w3.org/1999/xhtml" lang="en-US">
    <head>
        <title>Page Title</title>
    </head>
    <body data-absolute-enabled="true" style="font-family:Calibri;font-size:11px">
        <div data-id="_default" style="position:absolute;left:48px;top:120px;width:624px">
            <p>Some text</p>
            <p>More text inside a nested div</p>
        </div>
    </body>
</html>

img-Elementeimg elements

Bilder auf OneNote-Seiten werden durch img-Elemente dargestellt.Images on OneNote pages are represented by img elements. Das img-Element kann die folgenden Attribute in der Eingabe- und Ausgabe-HTML enthalten.An img element can contain the following attributes in the input and output HTML.

EingabeattributeInput attributes

EingabeattributInput attribute BeschreibungDescription
altalt Der angegebene Alternativtext für das Bild.The supplied alt text for the image.
data-iddata-id Ein Verweis für das Element.A reference for the element.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
data-render-srcdata-render-src Es ist entweder data-render-src oder src erforderlich ist.Either data-render-src or src is required.

Die Webseite, die als Bitmapbild auf der OneNote-Seite gerendert werden soll:The webpage to render as a bit-mapped image on the OneNote page:

- data-render-src="https://..." für eine öffentliche URL.- data-render-src="https://..." for a public URL.

- data-render-src="name:BlockName" für ein Bild-Bestandteil im Block "Präsentation" einer mehrteiligen Anforderung.- data-render-src="name:BlockName" for an image part in the "Presentation" block of a multipart request.

Diese Methode ist nützlich, wenn die Webseite so komplex ist, dass sie nicht zuverlässig von OneNote analysiert werden kann, oder wenn für die Seite eine Anmeldung erforderlich ist.This method is useful when the webpage is more complex than the OneNote page can faithfully render, or when the page requires login credentials.
data-tagdata-tag Ein Notiztag für das Element.A note tag on the element.
Formatvorlagestyle Die Position- und Größen-Eigenschaften für das Bild: Position (nur absolute), links, oben, Breite und Höhe.The position and size properties for the image: position (absolute only), left, top, width, and height.

Die Größe kann für jedes Bild festgelegt werden.Size can be set on any image.

Positionseigenschaften werden verwendet, um ein absolute positioned-Bild zu erstellen, wenn das Bild ein direktes untergeordnetes Element des Textkörpers und für den Textkörper data-absolute-enabled="true" angegeben ist.Position properties are used to create an absolute positioned image, only if the image is a direct child of the body when the body sets data-absolute-enabled="true".

Beispiel: <img style="position:absolute;width:360px;top:350px;left:300px" ... />Example: <img style="position:absolute;width:360px;top:350px;left:300px" ... />

In der Ausgabe-HTML wird die Bildgröße separat in width- und height-Attributen zurückgegeben.In the output HTML, the image size is returned separately in width and height attributes.
srcsrc Es ist entweder src oder data-render-src erforderlich ist.Either src or data-render-src is required.

Das Bild, das auf der OneNote-Seite gerendert werden soll:The image to render on the OneNote page:

- src="https://..." für eine URL zu einem öffentlich verfügbaren Bild im Internet.- src="https://..." for a URL to a publicly available image on the Internet.

- src="name:BlockName" für einen benannten Teil in einer mehrteiligen Anforderung, die das Bild darstellt.- src="name:BlockName" for a named part in a multipart request that represents the image.
Breite, Höhewidth, height Die Breite oder Höhe des Bilds, in Pixel, aber ohne px.The width or height of the image, in pixels but without the px. Beispiel: width="400"Example: width="400"

Hinweis: Die OneNote-APIs erkennt automatisch den Eingabe-Bildtyp und gibt ihn als data-fullres-src-type an die Ausgabe-HTML zurück.Note: The OneNote APIs automatically detect the input image type, and return it as the data-fullres-src-type in the output HTML. Daneben gibt die API auch den Bildtyp des optimierten Bilds zurück, in data-src-type.The API also returns the image type of the optimized image in data-src-type.

AusgabeattributeOutput attributes

AusgabeattributOutput attribute BeschreibungDescription
altalt Der angegebene Alternativtext für das Bild.The supplied alt text for the image.
data-iddata-id Ein Verweis für das Element.A reference for the element.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
data-indexdata-index Die Position des Bilds. Für die Unterstützung von geteilten Bildern.The position of the image. For split image support.
data-fullres-srcdata-fullres-src Der Endpunkt für die Version der Bildressource, die ursprünglich in die Seite eingebettet war.The endpoint for the version of the image resource that was originally embedded in the page.
data-fullres-src-typedata-fullres-src-type Der Medientyp der data-fullres-src-Ressource. Beispiel: image/png oder image/jpeg.The media type of the data-fullres-src resource, for example: image/png or image/jpeg.
data-optionsdata-options Der Quelltyp: printout für PDF-Dateien oder splitimage für alle anderen. Gilt nur für geteilte Bilder, die mit dem data-render-src-Attribut erstellt wurden.The source type: printout for PDF files or splitimage for all others. Applies only to split images created with the data-render-src attribute.
data-render-original-srcdata-render-original-src Die ursprüngliche URL des Bilds, wenn das Quellbild aus dem öffentlichen Internet stammt und mit dem data-render-src-Attribut erstellt wurde.The original source URL of the image, if the source image is from the public internet and was created with the data-render-src attribute.
data-src-typedata-src-type Der Medientyp der src-Ressource. Beispiel: image/png oder image/jpeg.The media type of the src resource, for example: image/png or image/jpeg.
data-tagdata-tag Ein Notiztag für das Element.A note tag on the element.
idid Eine eindeutige generierte ID für das Element.A unique, generated ID for the element. Zurückgegeben von einem GET requests to a page's -content-Endpunkt , wenn die includeIDs=true-Abfrageoption verwendet wird.Returned by GET requests to a page's content endpoint when the includeIDs=true query option is used.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
srcsrc Der Endpunkt für die Version der Bildressource, die für Webbrowser sowie mobile Geräte und Tablets optimiert wurde.The endpoint for the version of the image resource that has been optimized for web browsers and mobile and tablet form factors.
Formatvorlagestyle Die Positionseigenschaften des Bilds.The position properties of the image.
width, heightwidth, height Die Breite oder Höhe des Bilds in Pixel.The width or height of the image, in pixels.

Beispiele für die Ausgabe-HTML für BilderOutput HTML examples for images

Ausgabe-img-Elemente enthalten die Endpunkte für Bilddateiressourcen und den Bildtyp (siehe unten).Output img elements contain endpoints for image file resources and the image type, as shown below. Sie können separate GET-Anforderung zu Bildressourcen-Endpunkten durchführen, um die binäre Inhalt abzurufen.You can make separate GET requests to image resource endpoints to retrieve their binary contents.

<img 
    src="https://graph.microsoft.com/v1.0/me/onenote/resources/{image-id}/$value"  
    data-src-type="image/png"
    data-fullres-src="https://graph.microsoft.com/v1.0/me/onenote/resources/{image-id}/$value"  
    data-fullres-src-type="image/png" ... />

Die folgenden Beispiele zeigen, welche Informationen ein img-Element in der Ausgabe-HTML enthalten kann.The following examples show the information an img element might contain in the output HTML.

Bild mit webfähigen Ressourcen in hoher AuflösungImage with web-ready and high resolution resources

<img
    src="{web-ready-image-resource-url}/$value"
    data-src-type="image/{type}"
    data-fullres-src="{high-resolution-image-resource-url}/$value"
    data-fullres-src-type="image/{type}"
    [data-render-original-src="{original-source-url-or-named-part}"]
    [data-id="{image-id}"]
    [alt="supplied alt text"]
    [width="345"] [height="180"]
    [style="..."] />

Mit dem data-render-src-Attribut erstelltes BildImage created by using the data-render-src attribute

<img
    src="{web-ready-image-resource-url}/$value"
    data-src-type="image/{type}"
    data-fullres-src="{high-resolution-image-resource-url}/$value"
    data-fullres-src-type="image/{type}"
    data-render-original-src="{original-source-url-or-named-part}"
    [data-id="{image-id}"]
    [data-index="{index-of-split-image}"]
    [data-options="{printout-or-splitimage}"]
    [alt="supplied alt text"]
    [width="1024"] [height="1900"]
    [style="..."] />

Aufteilen von BildernSplit images

Bilder, die mit dem data-render-src-Attribut (aus einer Webseiten-URL oder einem benannten Teil) erstellt werden, werden für eine bessere Leistung und ein besseres Rendering möglicherweise in aus mehreren Komponenten bestehende Bilder aufgeteilt.Images that are created using the data-render-src attribute (from a webpage URL or a named part) might be split into multiple component images for performance and rendering reasons. Komponenten-Bildern wird allen der gleiche data-id-Wert zugewiesen.Component images are all assigned the same data-id value. Jedes Komponenten-Bild verfügt über ein nullbasiertes data-index-Attribut, welches das ursprüngliche vertikale Layout definiert.Each component image has a zero-based data-index attribute that defines the original vertical layout.

Aufgeteiltes Bild mit drei KomponentenbildernSplit image with three component images

<div data-id="multi-component-image" style="position:absolute;left:48px;top:120px;width:624px">
    <img
        src="{image-resource0-url}/$value"
        data-src-type="image/{type}"
        data-fullres-src="{image-resource0-url}/$value" 
        data-fullres-src-type="image/{type}" 
        data-index="0" 
        data-render-original-src="{original-source-url-or-named-part}"
        data-id="{same-image-id}" ... />
    <img 
        src="{image-resource1-url}/$value" 
        data-src-type="image/{type}" 
        data-fullres-src="{image-resource1-url}/$value" 
        data-fullres-src-type="image/{type}" 
        data-index="1" 
        data-render-original-src="{original-source-url-or-named-part}"
        data-id="{same-image-id}" ... />
    <img 
        src="{image-resource2-url}/$value" 
        data-src-type="image/{type}" 
        data-fullres-src="{image-resource2-url}/$value" 
        data-fullres-src-type="image/{type}" 
        data-index="2" 
        data-render-original-src=""{original-source-url-or-named-part}"
        data-id="{same-image-id}" ... />
</div>

Da Benutzer die Bilder auf der Seite verschieben können, werden die Indizes möglicherweise in falscher Reihenfolge zurückgegebenen.Because users can move the images on the page, the returned indexes might be out of order. Die Sortierung erfolgt normalerweise von oben nach unten auf der Y-Achse und von links nach rechts auf der X-Achse, wenn es Konflikte mit der Y-Sortierung gibt.Ordering should be in top to bottom y-order, and then left to right x-order if there are y-order conflicts.

iframe-Elementeiframe elements

OneNote-Seiten können eingebettete Videos enthalten, die durch iframe-Elemente dargestellt werden.OneNote pages can contain embedded videos represented by iframe elements.

Hinweis: Sie können auch eine Videodatei mithilfe eines object-Elements anfügen.Note: You can also attach a video file using an object element.

EingabeattributeInput attributes

EingabeattributInput attribute BeschreibungDescription
data-original-srcdata-original-src Erforderlich.Required. Die URL der Videoquelle.The URL of the video source. Siehe Liste der unterstützten Videoquellen.See the list of supported video sources.

Beispiel: data-original-src="https://www.youtube.com/watch?v=3Ztr44aKmQ8"Example: data-original-src="https://www.youtube.com/watch?v=3Ztr44aKmQ8"
Breite, Höhewidth, height Die Breite oder Höhe des iframe in Pixel.The width or height of the iframe, in pixels. Beispiel: width=300Example: width=300

AusgabeattributeOutput attributes

AusgabeattributOutput attribute BeschreibungDescription
data-original-srcdata-original-src Die URL der Videoquelle.The URL of the video source.
srcsrc Ein Link zu dem Video, das in die OneNote-Seite eingebettet ist.A link to the video that is embedded in the OneNote page.
Breite, Höhewidth, height Die Breite oder Höhe des iframe in Pixel.The width or height of the iframe, in pixels.

Beispiel: width=300Example: width=300

Beispiel für eine Ausgabe-HTML eines VideosOutput HTML example for videos

Ausgabe-iframe-Elemente enthalten Endpunkte, die wie dargestellt auf die Quellseite und das Video verweisen.Output iframe elements contain endpoints that link to the source page and video, as shown.

<iframe 
    width="340" height="280" 
    data-original-src="https://www.youtube.com/watch?v=3Ztr44aKmQ8" 
    src="https://www.youtube.com/embed/3Ztr44aKmQ8?feature=oembed&autoplay=true" />

Object-Elementeobject elements

OneNote-Seiten können Dateianlagen enthalten, die durch object-Elemente dargestellt werden.OneNote pages can contain file attachments represented by object elements. Das object-Element kann die folgenden Attribute in der Eingabe- und Ausgabe-HTML enthalten.An object element can contain the following attributes in the input and output HTML.

Hinweis: OneNote-APIs können auch Dateiinhalte als Bilder auf einer Seite rendern, wenn die Datei als Bild gesendet und das Attribut data-render-src verwendet wird.Note: The OneNote APIs can also render file content as images in a page when the file is sent as an image and uses the data-render-src attribute. Beispiel: <img data-render-src="name:part-name" ... />Example: <img data-render-src="name:part-name" ... />

EingabeattributeInput attributes

EingabeattributInput attribute BeschreibungDescription
datadata Erforderlich.Required. Der Name des Teils, der die Datei in der mehrteiligen Anforderung darstellt.The name of the part that represents the file in the multipart request.
data-attachmentdata-attachment Erforderlich. Der Dateiname.Required. The file name.
data-iddata-id Ein Verweis für das Element.A reference for the element.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
Formatvorlagestyle Die Position- und Größen-Eigenschaften für das Objekt: Position (nur absolute), links, oben und Breite.The position and size properties for the object: position (absolute only), left, top, and width.

Wird verwendet, um ein absolut positioniertes-Object-Element zu erstellen, wenn das Object-Element ein direktes untergeordnetes Element des Textkörpers und für den Textkörper data-absolute-enabled="true" angegeben ist.Used to create an absolute positioned object, only if the object is a direct child of the body when the body sets data-absolute-enabled="true".

Beispiel: <object style="position:absolute;top:350px;left:300px" ... />Example: <object style="position:absolute;top:350px;left:300px" ... />
typetype Erforderlich.Required.

Der standardmäßige Mediendateityp.The standard media file type. Bei bekannten Dateitypen wird das dem Dateityp zugeordnete Symbol auf der OneNote-Seite angezeigt.Known file types display the icon associated with the file type on the OneNote page. Bei unbekannten Dateitypen wird ein generisches Symbol angezeigt.Unknown file types display a generic file icon.

AusgabeattributeOutput attributes

AusgabeattributOutput attribute BeschreibungDescription
datadata Der Endpunkt für die Dateiressource.The endpoint for the file resource.
data-attachmentdata-attachment Der Dateiname.The file name.
data-iddata-id Ein Verweis für das Element.A reference for the element.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
idid Eine eindeutige generierte ID für das Element.A unique, generated ID for the element. Zurückgegeben von einem GET requests to a page's -content-Endpunkt , wenn die includeIDs=true-Abfrageoption verwendet wird.Returned by GET requests to a page's content endpoint when the includeIDs=true query option is used.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
Formatvorlagestyle Die Positionseigenschaften des Objekts.The position properties of the object.
typetype Der standardmäßige Mediendateityp.The standard media file type.

Beispiel für Ausgabe-HTML für ObjekteOutput HTML example for objects

Ausgabe-object-Elemente enthalten Endpunkte, die wie dargestellt auf Dateiressourcen auf der Seite verweisen.Output object elements contain endpoints that link to the file resources in the page, as shown. Sie können separate GET-Anforderung zu Dateiressourcen-Endpunkten durchführen, um die binäre Inhalt abzurufen.You can make separate GET requests to file resource endpoints to retrieve their binary contents.

<object
    data="https://graph.microsoft.com/v1.0/me/onenote/resources/{file-id}/$value"
    data-attachment="fileName.pdf" 
    type="application/pdf" 
    [style="..."] />

Absätze und ÜberschriftenParagraphs and headings

Absätze, Überschriften und andere Textcontainer können die folgenden Attribute in der Eingabe- und Ausgabe-HTML enthalten.Paragraphs, headings, and other text containers can contain the following attributes in the input and output HTML.

EingabeattributeInput attributes

EingabeattributInput attribute BeschreibungDescription
data-iddata-id Ein Verweis für das Element.A reference for the element.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
data-tagdata-tag Ein Notiztag für ein p- oder h1 - h6-Element.A note tag on a p or h1 - h6 element.
Formatvorlagestyle Die CSS-style-Eigenschaften des Elements.The CSS style properties of the element.

AusgabeattributeOutput attributes

AusgabeattributOutput attribute BeschreibungDescription
data-iddata-id Ein Verweis für das Element.A reference for the element.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
data-tagdata-tag Ein Notiztag für ein p- oder h1 - h6-Element.A note tag on a p or h1 - h6 element.
idid Eine eindeutige generierte ID für das Element.A unique, generated ID for the element. Zurückgegeben von einem GET requests to a page's -content-Endpunkt , wenn die includeIDs=true-Abfrageoption verwendet wird.Returned by GET requests to a page's content endpoint when the includeIDs=true query option is used.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
Formatvorlagestyle Die CSS-style-Eigenschaften des Elements.The CSS style properties of the element. In der Ausgabe-HTML können diese Werte eingebettet in die entsprechenden untergeordneten Elemente oder in span-Elementen zurückgegeben.In the output HTML, these values may be returned inline on appropriate child elements or on span elements.

Die folgenden Beispiele zeigen Eingabe-HTML, die verschiedene Möglichkeiten zum Definieren von Formatvorlagen für Textcontainer verwendet, und die zurückgegebene Ausgabe-HTML.The following examples show input HTML that uses different ways to define styles on text containers and the output HTML that's returned.

Eingabe-HTML, in der Formatvorlagen mit Inlinezeichenformaten, im Starttag und in einem span-Element definiert sind.Input HTML with styles defined using inline character styles, in the start tag, and within a span element.

<h1>Heading <i>One</i> text</h1>
<p style="font-size:8pt;color:green;font-family:Courier;text-align:center">Some text</p>
<p>Some <span  style="font-size:16px;color:#ff0000;font-family:Segoe UI Black">more</span> text</p>

Ausgabe-HTML, in der das <i>-Zeichenformat und die Schriftarteinstellungen im <p>-Starttag als Inline-CSS-Formate in span-Elementen zurückgegeben werden.Output HTML with the <i> character style and the font settings in the <p> start tag returned as inline CSS styles on span elements.

<h1 style="font-size:16pt;color:#1e4e79;margin-top:11pt;margin-bottom:11pt">Heading <span style="font-style:italic">One</span> text</h1>
<p style="text-align:center"><span style="font-family:Courier;font-size:8pt;color:green">Some text</span></p>
<p>Some <span style="font-family:Segoe UI Black;font-size:12pt;color:red">more</span> text</p>

ListenLists

Listen werden als ol- oder ul-Elemente dargestellt, die li-Elemente enthalten.Lists are represented as ol or ul elements that contain list items represented as li elements.

Listen und Listenelemente können die folgenden Attribute in der Eingabe- und Ausgabe-HTML enthalten.Lists and list items can contain the following attributes in the input and output HTML.

EingabeattributeInput attributes

EingabeattributInput attribute BeschreibungDescription
data-iddata-id Ein Verweis für das Element.A reference for the element.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
data-tagdata-tag Ein Notiztag für ein ul-, ol- oder li-Element.A note tag on a ul, ol, or li element.
Formatvorlagestyle Die list-style-type- und die CSS-style-Eigenschaften für die Liste oder das Listenelement.The list-style-type and the CSS style properties for the list or list item.

AusgabeattributeOutput attributes

AusgabeattributOutput attribute BeschreibungDescription
data-iddata-id Ein Verweis für das Element.A reference for the element.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
data-tagdata-tag Ein Notiztag für ein span-Objekt in einem li-Element.A note tag on a span in an li element.
idid Eine eindeutige generierte ID für das Element.A unique, generated ID for the element. Zurückgegeben von einem GET requests to a page's -content-Endpunkt , wenn die includeIDs=true-Abfrageoption verwendet wird.Returned by GET requests to a page's content endpoint when the includeIDs=true query option is used.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
Formatvorlagestyle Die list-style-type- und CSS-style-Eigenschaften des Elements.The list-style-type and CSS style properties of the element. In der Ausgabe HTML werden die Listenebene-Einstellungen an die Listenelemente zurückgegeben.In the output HTML, list-level settings are returned on list items. Standard-Eigenschaften werden nicht zurückgegeben.Default properties are not returned.

ListenformatvorlagenList styles

Die OneNote-APIs in Microsoft Graph unterstützen die folgenden Listentypen:The OneNote APIs in Microsoft Graph support the following list styles:

Sortierte ListeOrdered list Unsortierte ListeUnordered list
keinenone Keinenone
decimal (Standard)decimal (default)
disc (Standard)disc (default)
lower-alphalower-alpha circlecircle
lower-romanlower-roman

squaresquare | | upper-alphaupper-alpha |   | | upper-romanupper-roman |   |

Sie können globale Formatvorlagen für eine Liste im ol- oder ul-Element in der Eingabe-HTML anwenden, aber Formatvorlagen werden in den li-Elementen zurückgegeben.You can apply global styles for a list on the ol or ul element in the input HTML, but styles are returned on the li elements.

Homogene ListenformatvorlageHomogenous list style

Dieses Beispiel zeigt Eingabe-HTML, die den Listenformattyp im ol-Element und CSS-Formatvorlagen in einzelnen Listenelementen festlegt.This example shows input HTML that sets the list style type on the ol element and CSS styles on individual list items.

<ol style="list-style-type:upper-roman;color:blue">
    <li style="font-weight:bold">Jacksonville</li>
    <li style="text-decoration:line-through">Orlando</li>
    <li style="font-family:Courier">Naples</li>
</ol>

Dies ist die Ausgabe-HTML. Beachten Sie, dass Formatvorlagen inline in den einzelnen li- oder span-Elementen zurückgegeben werden.This is the output HTML. Notice that styles are returned inline on the individual li or span elements.

<ol>
    <li style="list-style-type:upper-roman"><span style="color:blue;font-weight:bold">Jacksonville</span></li>
    <li style="list-style-type:upper-roman"><span style="color:blue;text-decoration:line-through">Orlando</span></li>
    <li style="list-style-type:upper-roman"><span style="font-family:Courier;color:blue">Naples</span></li>
</ol>

Variable ListenelementvorlagenVariable list styles

Dieses Beispiel zeigt Eingabe-HTML, die verschiedene Listenformattypen in den li-Elementen festlegt.This example shows input HTML that sets different list style types on the li elements.

<ul style="font-style:italic">
    <li style="list-style-type:square">square style</li>
    <li style="list-style-type:circle">circle style</li>
    <li style="list-style-type:disc">disc style (default)</li>
</ul>

Dies ist die Ausgabe-HTML. Beachten Sie, dass Formatvorlagen inline in den einzelnen li- oder span-Elementen zurückgegeben werden.This is the output HTML. Notice that styles are returned inline on the individual li or span elements.

<ul>
    <li style="list-style-type:square"><span style="font-style:italic">square style</span></li>
    <li style="list-style-type:circle"><span style="font-style:italic">circle style</span></li>
    <li><span style="font-style:italic">disc style (default)</span></li>
</ul>

TabellenTables

Tabellen werden als table-Elemente dargestellt, die tr- und td-Elemente enthalten können. Geschachtelte Tabellen werden unterstützt.Tables are represented as table elements that can contain tr and td elements. Nested tables are supported.

Tabellen können die folgenden Attribute in der Eingabe- und Ausgabe-HTML enthalten.Tables can contain the following attributes in the input and output HTML. Die OneNote-APIs unterstützen keine rowspan- oder colspan-Attribute.The OneNote APIs do not support rowspan or colspan attributes.

EingabeattributeInput attributes

EingabeattributInput attribute BeschreibungDescription
data-iddata-id Ein Verweis für das Element.A reference for the element.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
Formatvorlagestyle Die CSS-style-Eigenschaften des Elements und:The CSS style properties of the element, and also:
- width.- width. width. Unterstützt von table und td als Pixel oder Prozentsatz der Seitenbreite.Supported by table and td as pixels or percentage of page width.

Beispiele: width="100px" oder width="60%"Example: width="100px" or width="60%"
borderborder Fügt einer Tabelle einen Rahmen mit der angegebenen Breite hinzuAdds border to table with specified width
widthwidth Breite der TabelleWidth of the table
bgcolorbgcolor Hintergrundfarbe der TabelleThe background color of the table

Hinweis: Die Verwendung der border-Eigenschaft im style-Attribut einer Tabelle wird in Eingabe-HTML nicht unterstützt.Note: The use of the border property in the style attribute of a table is not supported in input html.

AusgabeattributeOutput attributes

AusgabeattributOutput attribute BeschreibungDescription
data-iddata-id Ein Verweis für das Element.A reference for the element.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
idid Eine eindeutige generierte ID für das Element.A unique, generated ID for the element. Zurückgegeben von einem GET requests to a page's -content-Endpunkt , wenn die includeIDs=true-Abfrageoption verwendet wird.Returned by GET requests to a page's content endpoint when the includeIDs=true query option is used.

Wird verwendet, um Seiteninhalt zu aktualisieren.Used to update page content.
Formatvorlagestyle Die CSS-style-Eigenschaften des Elements.The CSS style properties of the element.

Die folgenden Beispiele zeigen Eingabe-HTML, die verschiedene Möglichkeiten zum Definieren von Formatvorlagen für Tabellen verwendet, und die zurückgegebene Ausgabe-HTML.The following examples show input HTML that uses different ways to define styles on tables and the output HTML that's returned.

Eingabe HTML mit optionalen Einstellungen auf verschiedenen EbenenInput HTML with optional settings at different levels

<table border="1"; Width="500"; bgcolor = "green">
    <tr> 
        <td>Cell 1</td> 
        <td>Cell 2</td> 
        <td>Cell 3</td> 
    </tr> 
    <tr style="background-color:blue"> 
        <td style="text-align:right;background-color:red">Left</td> 
        <td style="text-align:center">Middle</td> 
        <td>Right</td> 
    </tr> 
</table>

Ausgabe-HTML mit inline in td-Elementen zurückgegebenen CSS-FormatvorlagenOutput HTML with CSS styles returned inline on the td elements

<table style="border:0px">
    <tr>
        <td style="background-color:green;width:166;border:0px">Cell 1</td>
        <td style="background-color:green;width:166;border:0px">Cell 2</td>
        <td style="background-color:green;width:166;border:0px">Cell 3</td>
    </tr>
    <tr>
        <td style="background-color:red;width:166;border:0px;text-align:right">Left</td>
        <td style="background-color:blue;width:166;border:0px;text-align:center">Middle</td>
        <td style="background-color:blue;width:166;border:0px">Right</td>
    </tr>
</table>

FormatvorlagenStyles

OneNote APIs in Microsoft Graph unterstützt die folgenden Inline-CSS-style-Eigenschaften für Elemente im Seitentextkörper, wie body, div, p, li und span.OneNote APIs in Microsoft Graph support the following inline CSS style properties for elements in the page body, such as body, div, p, li, and span.

EigenschaftProperty BeispielExample
background-colorbackground-color style="background-color:#66cc66" (Standardwert ist Weiß)style="background-color:#66cc66" (defaults to white)

Das hexadezimale Format und benannte Farben werden unterstützt.Both hexadecimal format and named colors are supported.
colorcolor style="color:#ffffff" (Standardwert ist Schwarz)style="color:#ffffff" (defaults to black)
font-familyfont-family style="font-family:Courier" (Standardwert ist Calibri)style="font-family:Courier" (defaults to Calibri)
font-sizefont-size style="font-size:10pt" (Standardwert ist 11pt)style="font-size:10pt" (defaults to 11pt)

Die APIs akzeptieren den Schriftgrad in pt oder px, px wird jedoch zu pt konvertiert.The APIs accept font size in pt or px, but converts px to pt. Dezimalwerte werden auf die nächste n.0pt oder n.5pt gerundet.Decimal values are rounded to the nearest n.0pt or n.5pt.
font-stylefont-style style="font-style:italic"(nur normal oder kursiv)style="font-style:italic" (normal or italic only)
font-weightfont-weight style="font-weight:bold"(nur normal oder fett)style="font-weight:bold" (normal or bold only)
strike-throughstrike-through style="text-decoration:line-through"
text-aligntext-align style="text-align:center"(nur für Blockelementen)style="text-align:center" (for block elements only)
text-decorationtext-decoration style="text-decoration:underline"(nur keine oder unterstrichen)style="text-decoration:underline" (none or underline only)

Die folgenden Inlinezeichenformate werden ebenfalls unterstützt:The following inline character styles are also supported:

   

Beispiel für Eingabe- und Ausgabe-HTMLInput and output HTML example

Die folgende Abbildung zeigt eine einfache Seite, die mit der Microsoft Graph erstellt wurde.The following image shows a simple page that was created with Microsoft Graph.

Bild einer OneNote-Seite mit Lernnotizen aus Inhalten von Wikipedia

Dabei handelt es sich um die Eingabe-HTML, die im Nachrichtentextkörper gesendet wurde, um die Seite zu erstellen.This is the input HTML sent in the message body to create the page.

<html lang="en-US">
    <head>
        <title>Sample Study Notes</title>
        <meta name="created" content="2015-01-01T01:01"/>
    </head>
    <body>
        <h1>Aurora Borealis</h1>
        <p>Dancing lights in the sky. Also called <i>Northern Lights</i>. Caused by solar radiation.</p>
        <br />
        <p><b>Intersting facts</b></p>
        <table>
            <tr>
                <td>Neil Armstrong</td>
                <td>Commander</td>
            </tr>
            <tr>
                <td>Buzz Aldrin</td>
                <td>LM Pilot</td>
            </tr>
            <tr>
                <td>Michael Collins</td>
                <td>Command Module Pilot</td>
            </tr>
        </table>
        <img alt="Apollo 11 commemorative stamp." src="https://upload.wikimedia.org/wikipedia/commons/a/a4/First_Man_on_Moon_1969_Issue-10c.jpg"  width="400"/>
        <p>References:</p>
        <p><a href="https://en.wikipedia.org/wiki/Apollo_11">https://en.wikipedia.org/wiki/Apollo_11</a></p>
        <p><a href="https://www.nasa.gov/mission_pages/apollo/missions/apollo11.html">https://www.nasa.gov/mission_pages/apollo/missions/apollo11.html</a></p>
    </body>
</html>

Im Folgenden sehen Sie die Ausgabe-HTML, die die Microsoft Graph zurückgibt, wenn Sie den Seiteninhalt abrufen.This is the output HTML that Microsoft Graph returns when you get page content.

Hinweis: Wenn Sie eine Seite erstellen oder die Metadaten einer Seite abrufen, gibt die API die Inhalte-Endpunkt-URL der Seite in der contentUrlEigenschaft zurück.Note: When you create a page or get page metadata, the API returns the content endpoint URL of the page in the contentUrl property.

<html htmlns="https://www.w3.org/1999/xhtml" lang="en-US">
    <head>
        <title>Sample Study Notes</title>
    </head>
    <body data-absolute-enabled="true" style="font-family:Calibri;font-size:11pt">
        <div data-id="_default" style="position:absolute;left:48px;top:120px;width:624px">
            <h1 style="font-size:16pt;color:#1e4e79;margin-top:11pt;margin-bottom:11pt">American History 101: Moon Landing</h1>
            <p>First moon landing - July 20, 1969 with Apollo 11 (Eagle)</p>
            <br />
            <p><span style="font-weight:bold">Apollo 11 Astronauts</span></p>
            <table style="border:0px">
                <tr>
                    <td style="border:0px">Neil Armstrong</td>
                    <td style="border:0px">Commander</td>
                </tr>
                <tr>
                    <td style="border:0px">Buzz Aldrin</td>
                    <td style="border:0px">LM Pilot</td>
                </tr>
                <tr>
                    <td style="border:0px">Michael Collins</td>
                    <td style="border:0px">Command Module Pilot</td>
                </tr>
            </table>
            <br />
            <img alt="Apollo 11 commemorative stamp." width="400" height="248" src="https://graph.microsoft.com/v1.0/me/onenote/resources/0-f717b5fa5eaa454da7ecdf72a8c137fe!1-73DBAF9B7E5C4B4C!10456/$value"
                 data-src-type="image/jpeg" data-fullres-src="https://graph.microsoft.com/v1.0/me/onenote/resources/0-f717b5fa5eaa454da7ecdf72a8c137fe!1-73DBAF9B7E5C4B4C!10456/$value" data-fullres-src-type="image/jpeg" />
            <p>References:</p>
            <p><a href="https://en.wikipedia.org/wiki/Apollo_11">https://en.wikipedia.org/wiki/Apollo_11</a></p>
            <p><a href="https://www.nasa.gov/mission_pages/apollo/missions/apollo11.html">https://www.nasa.gov/mission_pages/apollo/missions/apollo11.html</a></p>
        </div>
    </body>
</html>

Siehe auchSee also