Filigrane
Les filigranes sont des superpositions de texte ou d'image sur une page Web ou une application qui empêchent l'utilisation ou la transmission de contenu sans permission. Ils sont générés dynamiquement et offrent un certain nombre d'options de configuration.
Utilisez le Générateur de filigrane pour prévisualiser les styles de filigrane et télécharger la configuration du plugin sous JSON.
Mode plugin
Installation
pnpm add @univerjs/watermarknpm install @univerjs/watermarkyarn add @univerjs/watermarkbun add @univerjs/watermarkUtilisation
import { UniverWatermarkPlugin } from '@univerjs/watermark'import '@univerjs/watermark/facade'const univer = new Univer({ // ...})univer.registerPlugin(UniverWatermarkPlugin, { textWatermarkSettings: { content: 'Hello, Univer!', fontSize: 36, }, })Configuration des plugins
Passez l'un des objets ci-dessous à UniverWatermarkPlugin. Si plus d'un objet est passé, l'information utilisateur a priorité sur le texte et le texte a priorité sur l'image. Les valeurs par défaut prennent effet une fois l'objet correspondant passé.
userWatermarkSettingsobjectFiligrane avec les informations de l’utilisateur actuel.namebooleanValeur par défaut:trueAffiche le nom de l’utilisateur actuel.emailbooleanValeur par défaut:falseAffiche l’adresse e-mail de l’utilisateur actuel.phonebooleanValeur par défaut:falseAffiche le numéro de téléphone de l’utilisateur actuel.uidbooleanValeur par défaut:falseAffiche l’identifiant de l’utilisateur actuel.fontSizenumberValeur par défaut:16Taille de police en pixels.colorstringValeur par défaut:'rgb(0,0,0)'Couleur du texte au format CSS.boldbooleanValeur par défaut:falseAffiche le texte en gras.italicbooleanValeur par défaut:falseAffiche le texte en italique.direction'ltr' | 'rtl' | 'inherit'Valeur par défaut:'ltr'Définit le sens du texte.xnumberValeur par défaut:60Décalage horizontal du premier filigrane en pixels.ynumberValeur par défaut:60Décalage vertical du premier filigrane en pixels.repeatbooleanValeur par défaut:trueRépète le filigrane sur la zone d’édition.spacingXnumberValeur par défaut:200Espacement horizontal entre répétitions en pixels.spacingYnumberValeur par défaut:100Espacement vertical entre répétitions en pixels.rotatenumberValeur par défaut:-30Angle de rotation en degrés.opacitynumberValeur par défaut:0.15Opacité de 0 à 1.
textWatermarkSettingsobjectFiligrane de texte.contentstringValeur par défaut:''Texte à afficher.fontSizenumberValeur par défaut:16Taille de police en pixels.colorstringValeur par défaut:'rgb(0,0,0)'Couleur du texte au format CSS.boldbooleanValeur par défaut:falseAffiche le texte en gras.italicbooleanValeur par défaut:falseAffiche le texte en italique.direction'ltr' | 'rtl' | 'inherit'Valeur par défaut:'ltr'Définit le sens du texte.xnumberValeur par défaut:60Décalage horizontal du premier filigrane en pixels.ynumberValeur par défaut:36Décalage vertical du premier filigrane en pixels.repeatbooleanValeur par défaut:trueRépète le filigrane sur la zone d’édition.spacingXnumberValeur par défaut:200Espacement horizontal entre répétitions en pixels.spacingYnumberValeur par défaut:100Espacement vertical entre répétitions en pixels.rotatenumberValeur par défaut:0Angle de rotation en degrés.opacitynumberValeur par défaut:0.15Opacité de 0 à 1.
imageWatermarkSettingsobjectFiligrane d’image.urlstringValeur par défaut:''URL de l’image du filigrane.widthnumberValeur par défaut:100Largeur de l’image en pixels.heightnumberValeur par défaut:100Hauteur de l’image en pixels quand les proportions ne sont pas verrouillées.maintainAspectRatiobooleanValeur par défaut:trueCalcule la hauteur à partir de la largeur et deoriginRatio.originRationumberValeur par défaut:1Largeur de l’image d’origine divisée par sa hauteur.xnumberValeur par défaut:60Décalage horizontal du premier filigrane en pixels.ynumberValeur par défaut:36Décalage vertical du premier filigrane en pixels.repeatbooleanValeur par défaut:trueRépète le filigrane sur la zone d’édition.spacingXnumberValeur par défaut:200Espacement horizontal entre répétitions en pixels.spacingYnumberValeur par défaut:100Espacement vertical entre répétitions en pixels.rotatenumberValeur par défaut:0Angle de rotation en degrés.opacitynumberValeur par défaut:0.15Opacité de 0 à 1.
Mode prédéfini
Aucun préréglage de filigrane n'existe, mais le plugin peut être enregistré à côté de vos presets.
Installation
pnpm add @univerjs/watermarknpm install @univerjs/watermarkyarn add @univerjs/watermarkbun add @univerjs/watermarkUtilisation
import { UniverWatermarkPlugin } from '@univerjs/watermark'import '@univerjs/watermark/facade'const { univerAPI } = createUniver({ // ... presets: [ UniverDocsCorePreset(), ], plugins: [ [UniverWatermarkPlugin, { textWatermarkSettings: { content: 'Hello, Univer!', fontSize: 36, }, }], ],})API Facade
Importation
Note du mode greffon
Seul le mode plugin nécessite une importation manuelle de Facade. Le mode Preset regroupe déjà le paquet Facade, donc aucune importation supplémentaire n'est nécessaire.
import '@univerjs/watermark/facade'Ajouter un filigrane
univerAPI.addWatermark('text', { content: 'hello', repeat: true })Supprimer le filigrane
univerAPI.deleteWatermark()Que pensez-vous de ce guide ?