---
title: "Widget - Visionneur de document"
slug: "widget-visionneur-de-document"
updated: 2026-01-20T14:44:27Z
published: 2026-01-20T14:44:27Z
canonical: "help.tuleap.com/widget-visionneur-de-document"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.tuleap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Widget - Visionneur de document

Le widget **Visionneur de document** permet de visualiser le contenu d'un document directement sur le tableau de bord personnel.

![](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Screen Shot 2026-01-09 at 17.19.01.png)

> [!WARNING]
> Note d’installation
> 
> Ce widget est utilisable sur le **Tableau de bord personnel** et sur le **Tableau de bord projet**. Pour le moment, seuls les **fichiers embarqués** sont pleinement supportés pour l'aperçu.

## Installation

Une configuration du widget est nécessaire au moment de l’ajouter sur votre tableau de bord :

- **Item_id** : Vous devez saisir l'identifiant du document que vous souhaitez afficher. Cet identifiant peut être récupéré depuis l'URL affichée lorsque vous visionnez le document depuis Tuleap (nombre affiché en fin d’URL).

## Contenu

L'affichage du widget varie selon la nature du document ciblé :

1. **Pour un fichier embarqué** : le contenu du document est affiché directement à l'intérieur du widget.
2. **Pour les autres types de fichiers** : si le document n'est pas supporté pour l'affichage embarqué, la zone de contenu restera vide.

Dans tous les cas, un lien **[Go to document]** est affiché en bas du widget, vous permettant d'ouvrir le document directement dans l'interface du gestionnaire de documents.

### Configuration

Dans la fenêtre d’édition du widget, deux champs modifiables vous permettent de configurer le contenu affiché :

- **Titre** : ce champ est pré-rempli avec le nom du fichier **configuré lors de la création du widget**. Il permet de personnaliser le titre affiché dans l'en-tête du widget.
- **Item_id** : ce champ obligatoire attend l'identifiant du document. En modifiant cette valeur, vous changez le fichier affiché dans le widget.