README.md

@attributech/nuxt-drupal-image

A Nuxt module for handling Drupal image styles.

Features

• Compatible with Nuxt 2 (with Bridge) and Nuxt 3
• TypeScript support
• Auto-imports for the useImageUrl composable
• Simplifies working with Drupal image styles

Installation

npm install @attributech/nuxt-drupal-image

Setup

Add the module to your nuxt.config.ts:

Nuxt 3

export default defineNuxtConfig({
  modules: [
    '@attributech/nuxt-drupal-image'
  ]
})

Nuxt 2 with Bridge

import { defineNuxtConfig } from '@nuxt/bridge'

export default defineNuxtConfig({
  buildModules: [
    '@attributech/nuxt-drupal-image'
  ]
})

Usage

useImageUrl

A composable for building Drupal image style URLs.

const imageUrl = useImageUrl(imageUri, style)

Parameters

• imageUri: The Drupal image URI (e.g., 'public://image.jpg')
• style: The Drupal image style name (e.g., 'thumbnail', 'large')

Returns

• A string containing the complete URL to the styled image

Example

<template>
  <img :src="imageUrl" alt="My image" />
</template>

<script setup>
const imageUri = 'public://my-image.jpg'
const imageUrl = useImageUrl(imageUri, 'large')
</script>

Configuration

The composable uses the serverUrl from your Nuxt runtime config. Make sure to set this in your nuxt.config.ts:

// Nuxt 3
export default defineNuxtConfig({
  runtimeConfig: {
    public: {
      serverUrl: process.env.SERVER_URL || 'https://example.com'
    }
  }
})

// Nuxt 2 with Bridge
export default defineNuxtConfig({
  publicRuntimeConfig: {
    serverUrl: process.env.SERVER_URL || 'https://example.com'
  }
})

Migration from existing code

Migrating from util/imageUrl.js

If you're currently using the utility function from util/imageUrl.js, you can migrate to the composable as follows:

Before:

import imageUrl from '@/util/imageUrl'

const url = imageUrl(imageUri, style, apiUrl)

After:

import { useImageUrl } from '@attributech/nuxt-drupal-image'

// The apiUrl is now taken from the Nuxt runtime config
const url = useImageUrl(imageUri, style)

License

MIT