Procédure : personnaliser le sélecteur d'éléments

Le sélecteur d'éléments est un outil qui permet aux créateurs d'insérer facilement une URL ou une image à partir d'une bibliothèque SharePoint ou d'une liste dans la collection de sites actuelle. Vous pouvez l'utiliser pour insérer un contenu sans taper l'URL qui pointe vers ce contenu. Cet outil est disponible dans de nombreux contrôles de champs dans les sites de publication, par exemple :

• Le contrôle de champ Éditeur HTML

• Le contrôle de champ Image

• Le composant WebPart Liens de synthèse

Le volet Rechercher dans situé à gauche dans la fenêtre du sélecteur contient des raccourcis vers des bibliothèques SharePoint prédéfinies. Ces raccourcis sont conçus pour aider les créateurs à localiser rapidement et facilement un contenu sans avoir à parcourir les dossiers dans la collection de sites. Dans les sélecteurs d'images, ces raccourcis pointent sur :

• La bibliothèque d'images du site actuel

• La bibliothèque d'images de la collection de sites actuelle

Dans les sélecteurs d'URL, ils pointent sur :

• La bibliothèque de pages du site actuel

• La bibliothèque de documents du site actuel

• La bibliothèque de documents de la collection de sites actuelle

Si vos créateurs ont souvent besoin d'insérer des documents qui ne se trouvent pas à ces emplacements par défaut, vous pouvez définir un autre raccourci pointant vers un autre emplacement de votre collection de sites. Vous pouvez définir un raccourci personnalisé vers des sélecteurs d'images et un autre vers des sélecteurs d'URL. Une fois qu'ils ont été définis, ces raccourcis s'affichent dans le volet Rechercher dans à côté des raccourcis par défaut. Vous pouvez définir des raccourcis personnalisés vers des sélecteurs uniquement dans l'étendue d'un contrôle : une fois que vous avez modifié le balisage d'un contrôle dans un fichier de modèle, seuls les sélecteurs d'éléments démarrés à partir de ce contrôle affichent les raccourcis personnalisés spécifiés.

Personnalisation du sélecteur d'éléments au niveau de la mise en page

Vous pouvez définir un raccourci de sélecteur personnalisé pour un contrôle RichHtmlField ou RichImageField à l'intérieur d'une mise en page :

1. Accédez à \Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES\PublishingLayouts\PageLayouts et ouvrez un fichier .aspx de mise en page.

2. Recherchez le contrôle de champ de publication associé au contrôle qui utilise le sélecteur d'éléments. Par exemple, <PublishingWebControls:RichHtmlField> représente le contrôle de champ Éditeur HTML.

3. Ajoutez un des attributs suivants, ou les deux, à cette balise :

   • DefaultAssetLocation : définit l'URL du raccourci personnalisé dans un sélecteur d'URL.

   • DefaultAssetImageLocation : définit l'URL du raccourci personnalisé dans un sélecteur d'images.

     Ces adresses URL doivent être liées à une collection de sites, pointant sur une bibliothèque, une liste ou un autre emplacement dans votre collection de sites, tel que "/ReusableContent".

     Par exemple, le contrôle <PublishingWebControls:RichHtmlField> suivant définit les raccourcis personnalisés /URLpicker et /imagepicker respectivement pour les sélecteurs d'URL et d'images.

     <PublishingWebControls:RichHtmlField id="Content" FieldName="PublishingPageContent" DefaultAssetLocation="/URLpicker" DefaultAssetImageLocation= "/imagepicker" runat="server"/>
     

     De la même façon, le contrôle <PublishingWebControls:RichHtmlField> suivant définit un raccourci personnalisé pour son sélecteur d'images.

     <PublishingWebControls:RichImageField id="Content" FieldName="PublishingPageImage" DefaultAssetImageLocation= "/imagepicker" runat="server"/>
     

4. Enregistrez les modifications et fermez le fichier .aspx de mise en page.

Ajoutez un contrôle AssetUrlSelector à toutes les pages .aspx de votre application

Vous pouvez ajouter un contrôle serveur <cms:AssetUrlSelector> à n'importe quelle page .aspx de votre application. Ce contrôle serveur affiche un élément TextBox qui indique l'URL actuellement sélectionnée et un élément LinkButton qui, quand l'utilisateur clique sur celui-ci, exécute le code JavaScript approprié pour lancer l'interface utilisateur du sélecteur d'éléments.

Vous pouvez utiliser les attributs suivants du contrôle <cms:AssetUrlSelector> pour personnaliser la boîte de dialogue du sélecteur d'éléments.

Exemple

Cet exemple de contrôle <cms:AssetUrlSelector> utilise plusieurs de ces attributs.

<CMS:AssetUrlSelector
    DefaultOpenLocationUrl="~SiteCollection/"
    DefaultToLastUsedLocation="false"
    DisplayLookInSection="true"
    OverrideDialogFeatures="resizable: no; status: yes; scroll: yes; help: no; dialogWidth:500px; dialogHeight:500px;"
    OverrideDialogTitle="Custom Picker Title"
    OverrideDialogDescription="Custom Picker Description"
    OverrideDialogImageUrl="~Site/PublishingImages/AssetPickerLogo.jpg"
    AssetTextClientID="testAssetTextClientIDCust"
    ClientCallback="function(returnedUrl) { window.alert('ClientCallback[AssetTextClientID]: ' + returnedUrl); }"
    id="assetSelectedImageCustomLauncher" 
    UseImageAssetPicker=true 
    runat="server" />