Skip to content

Preset Tagify

Ceci active le mode tagify pour d'autres presets.

Code Source

Installation

bash
pnpm add -D @unocss/preset-tagify
bash
yarn add -D @unocss/preset-tagify
bash
npm install -D @unocss/preset-tagify
bash
bun add -D @unocss/preset-tagify
ts
import presetTagify from '@unocss/preset-tagify'
import { defineConfig } from 'unocss'

export default defineConfig({
  presets: [
    presetTagify({ /* options */ }),
    // ...autres presets
  ],
})

Mode Tagify

Ce preset peut être utile quand vous n'avez besoin d'appliquer qu'une seule règle unocss à un élément.

html
<span class="text-red"> texte rouge </span>
<div class="flex">flexbox</div>
Je me sens <span class="i-line-md-emoji-grin"></span> aujourd'hui !

Avec le mode tagify, vous pouvez intégrer les styles CSS dans les balises HTML :

html
<text-red> texte rouge </text-red>
<flex> flexbox </flex>
Je me sens <i-line-md-emoji-grin /> aujourd'hui !

Le HTML ci-dessus fonctionne exactement comme vous l'attendez.

Avec préfixe

js
presetTagify({
  prefix: 'un-'
})
html
<!-- ceci sera reconnu -->
<un-flex> </un-flex>
<!-- ceci ne sera pas reconnu -->
<flex> </flex>

Propriétés supplémentaires

Vous pouvez injecter des propriétés supplémentaires aux règles reconnues :

js
presetTagify({
  // ajoute display: inline-block aux icônes reconnues
  extraProperties: matched => matched.startsWith('i-')
    ? { display: 'inline-block' }
    : { }
})
js
presetTagify({
  // extraProperties peut aussi être un objet simple
  extraProperties: { display: 'block' }
})

Options

prefix

  • Type: string

Le préfixe à utiliser pour la variante tagify.

excludedTags

  • Type: string[] | RegExp[]
  • Défaut: ['b', /^h\d+$/, 'table']

Balises exclues du traitement.

extraProperties

  • Type: Record<string, string> | ((matched: string) => Partial<Record<string, string>>)

Propriétés CSS supplémentaires à appliquer aux règles reconnues.

defaultExtractor

  • Type: boolean
  • Défaut: true

Active l'extracteur par défaut.

Released under the MIT License.