Attributify JSX transformer

รองรับ valueless attributify ใน JSX/TSX: @unocss/transformer-attributify-jsx

การแนะนำ

export function Component() {
  return (
    <div text-red text-center text-5xl animate-bounce>
      unocss
    </div>
  )
}

จะถูกแปลงเป็น:

export function Component() {
  return (
    <div text-red="" text-center="" text-5xl="" animate-bounce="">
      unocss
    </div>
  )
}

หากไม่มี transformer นี้ JSX จะถือว่า valueless attributes เป็น boolean attributes

export function Component() {
  return (
    <div text-red={true} text-center={true} text-5xl={true} animate-bounce={true}>
      unocss
    </div>
  )
}

การติดตั้ง

pnpm

pnpm add -D @unocss/transformer-attributify-jsx

yarn

yarn add -D @unocss/transformer-attributify-jsx

npm

npm install -D @unocss/transformer-attributify-jsx

bun

bun add -D @unocss/transformer-attributify-jsx

import { defineConfig, presetAttributify } from 'unocss'
import transformerAttributifyJsx from '@unocss/transformer-attributify-jsx'

export default defineConfig({
  // ...
  presets: [
    // ...
    presetAttributify(),
  ],
  transformers: [
    transformerAttributifyJsx(), // <--
  ],
})

TIP

preset นี้รวมอยู่ในแพ็กเกจ unocss คุณสามารถ import จากที่นั่นได้เช่นกัน:

import { transformerAttributifyJsx } from 'unocss'

ข้อควรระวัง

WARNING

กฎเกณฑ์เกือบจะเหมือนกับ Attributify preset แต่มีข้อควรระวังหลายประการ

<div translate-x-100% />
<!-- ไม่สามารถลงท้ายด้วย `%` -->

<div translate-x-[100px] />
<!-- ไม่สามารถมี `[` หรือ `]` -->

แทนที่จะเป็นเช่นนั้น คุณอาจต้องการใช้ valued attributes แทน:

<div translate="x-100%" />

<div translate="x-[100px]" />

Blocklist

transformer นี้จะแปลงเฉพาะ attributes ที่เป็น UnoCSS utilities ที่ถูกต้อง คุณยังสามารถใช้ blocklist เพื่อข้าม attributes บางตัวจากการถูกแปลง

transformerAttributifyJsx({
  blocklist: [/text-[a-zA-Z]*/, 'text-5xl']
})

<div text-red text-center text-5xl animate-bounce>
  unocss
</div>

จะถูกคอมไพล์เป็น:

<div text-red text-center text-5xl animate-bounce="">unocss</div>