Transloadit であらゆるデバイス向けの壁紙を簡単に作成
デバイス用に新しい壁紙を選ぶのは、いつも悩ましいものです。しかも、完璧だと思った壁紙に出会っても、あと少し 合わないことがあります。そんな経験があるなら、この記事が役に立ちます。Transloadit を使って、任意の壁紙をリサイズし、どのデバイスにもぴったり合うようにする方法を見ていきましょう。

Template
ことわざにもあるように、「魚を与えるのではなく、釣り方を教える」のが大切です。そこで今回は、どんな壁紙でもあらゆる画面サイズに自動で合わせてリサイズする Web サイトの作り方を紹介します 🎣
この Web サイト作成の最初の作業は、Transloadit の Templateを作成することです。Templateは一連の Assembly Instructionsで構成され、Transloadit が後から
fillcrop の リサイズ戦略を使って、壁紙を適切な寸法にリサイズするために利用します。以下が今回使う Templateです。
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"crop_thumbed": {
"use": ":original",
"robot": "/image/resize",
"height": "${fields.height}",
"width": "${fields.width}",
"imagemagick_stack": "v3.0.2",
"resize_strategy": "fillcrop"
},
"exported": {
"use": ["crop_thumbed"],
"robot": "/s3/store",
"credentials": "S3_CREDENTIALS",
"result": true
}
}
}
${fields.height} と ${fields.width} を使っていることに気づくかもしれません。これらは Templateに動的に渡せるフィールドで、実行時に挙動を調整できます。より一般的には、これらは Assembly Variableと呼ばれ、Assemblyではさまざまな種類を利用できます。Assembly Variableのさまざまな使い方は、こちらを参照してください。
公開前には、サーバー生成署名を使用し、要求された寸法をサーバー側で検証してください。Auth Secret はブラウザーのコードに含めないでください。以下のブラウザー例では、自身の Template と Auth Key を使ったアップロードとプレビューの動作を示しています。S3_CREDENTIALS は保存済みの Template の認証情報の名前に置き換えてください。S3 のシークレットはサンプルに貼り付けないでください。
HTML と CSS
今回は、普段ほど HTML と CSS を深く掘り下げませんが、自分のプロジェクトにコピー&ペーストしたい場合は、以下を確認してみてください。
<head>
<link href="https://releases.transloadit.com/uppy/v3.7.0/uppy.min.css" rel="stylesheet" />
</head>
<div class="content">
<h1>Wallpaper Resizer</h1>
<div class="button-list" id="preview-buttons"></div>
<label>Choose a photo <input id="photo-input" type="file" accept="image/*" /></label>
<p>You can also drop a photo over the frame</p>
<div id="preview-box"><img id="preview-image" alt="Resized wallpaper preview" hidden /></div>
<div id="progress-bar"></div>
<div class="button-list">
<a id="download" hidden>View wallpaper</a>
<button id="clear">Clear</button>
</div>
</div>
#preview-box {
border: 1px solid black;
border-radius: 10px;
display: flex;
align-items: center;
justify-content: center;
width: 384px;
max-width: 100%;
aspect-ratio: 16 / 9;
overflow: clip;
position: relative;
}
#preview-image {
position: absolute;
inset: 0;
height: 100%;
width: 100%;
object-fit: cover;
}
.content {
display: flex;
flex-direction: column;
align-items: center;
gap: 10px;
font-family: Helvetica;
}
.button-list {
display: flex;
flex-wrap: wrap;
justify-content: center;
gap: 10px;
}
JavaScript
ここからは、毎回のブログで私がいちばん気に入っている部分、統合コードを見ていきます。
このスクリプトは、HTML の後ろ、<script type="module"> タグ内に配置してください。Auth Key と Template ID のプレースホルダーは、自分の値に置き換えます。
import {
Uppy,
DropTarget,
Informer,
ProgressBar,
Transloadit,
} from 'https://releases.transloadit.com/uppy/v3.7.0/uppy.min.mjs'
const uppy = new Uppy({
restrictions: {
allowedFileTypes: ['image/*'],
maxNumberOfFiles: 1,
},
autoProceed: true,
})
.use(DropTarget, {
target: '#preview-box',
})
.use(Informer, {
target: 'body',
})
.use(ProgressBar, {
target: '#progress-bar',
fixed: true,
})
.use(Transloadit, {
waitForEncoding: true,
assemblyOptions: () => ({
params: {
auth: { key: 'YOUR_AUTH_KEY' },
template_id: 'YOUR_TEMPLATE_ID',
},
fields: { height: cropHeight, width: cropWidth },
}),
})
.on('transloadit:complete', setPreviewImage)
const previewBox = document.getElementById('preview-box')
const previewImage = document.getElementById('preview-image')
let cropHeight = 1080
let cropWidth = 1920
const resolutions = [
[1920, 1080],
[1080, 1920],
[2560, 1080],
[1080, 2560],
[1366, 768],
[768, 1366],
]
const previewScale = 0.2
resolutions.forEach(appendButton)
document.getElementById('clear').addEventListener('click', clearPreview)
document.getElementById('photo-input').addEventListener('change', (event) => {
const file = event.currentTarget.files[0]
if (file == null) return
clearPreview()
try {
uppy.addFile({ name: file.name, type: file.type, data: file })
} catch {
uppy.info('Choose one image file and try again.', 'error', 5000)
}
event.currentTarget.value = ''
})
function setPreviewImage(assembly) {
const url = assembly.results.crop_thumbed?.[0]?.ssl_url
if (typeof url !== 'string') {
uppy.info('No wallpaper was returned. Please try again.', 'error', 5000)
return
}
previewImage.hidden = false
previewImage.src = url
const downloadButton = document.getElementById('download')
downloadButton.href = url
for (const file of uppy.getFiles()) uppy.removeFile(file.id)
downloadButton.hidden = false
}
function clearPreview() {
previewImage.hidden = true
previewImage.removeAttribute('src')
const downloadButton = document.getElementById('download')
downloadButton.hidden = true
downloadButton.removeAttribute('href')
for (const file of uppy.getFiles()) uppy.removeFile(file.id)
}
function appendButton(resolution) {
const buttonTextEl = document.createElement('button')
buttonTextEl.className = 'button'
buttonTextEl.innerText = `${resolution[0]}x${resolution[1]}`
buttonTextEl.setAttribute('data-width', resolution[0])
buttonTextEl.setAttribute('data-height', resolution[1])
buttonTextEl.addEventListener('click', setPreviewBoxDimensions)
document.getElementById('preview-buttons').appendChild(buttonTextEl)
}
function setPreviewBoxDimensions(e) {
cropHeight = Number(e.currentTarget.getAttribute('data-height'))
cropWidth = Number(e.currentTarget.getAttribute('data-width'))
previewBox.style.width = `${cropWidth * previewScale}px`
previewBox.style.aspectRatio = `${cropWidth} / ${cropHeight}`
clearPreview()
}
それでは、コードを 1 行ずつ確認していきましょう。
今回は Web サイトを作るので、まずは世界最高のファイルアップローダーである
Uppyをインポートします。最初に新しい Uppy のインスタンスを作成し、その後ですべてのプラグインを初期化します。今回のデモで使うのは、Drop target plugin、Informer plugin、Progress bar plugin、そして最後に
Transloadit pluginです。重要なのは、autoProceed に
true を設定している点です。これにより、プレビュー上に画像をドロップすると、ファイルがすぐに Transloadit へアップロードされます。
その後、後続の関数で使う変数と定数をいくつか宣言し、解像度の配列も定義します。これで、対象にしたい画面サイズごとに appendButton 関数を呼び出し、対応するボタンを作成できます。
関数
次に、参照している各関数を見ていきましょう。
setPreviewImage 関数は、Uppy の transloadit:complete イベントから呼び出されます。このイベントは、Transloadit の Assemblyが完了するたびに発火します。続いて、結果に含まれる Assembly JSONを調べ、S3 バケット内のファイルの
ssl_url を取得します。その後、プレビュー画像の表示を有効にし、正しい画像を割り当てます。
プレビュー画像を設定するなら、それをクリアする処理も必要です。そこで登場するのが、名前どおりの
clearPreview です。この関数は非常に基本的な 2 つの処理を行います。プレビュー画像要素を非表示にし、Uppy から保留中のファイルを削除します。結果が表示されたら、setPreviewImage は完了済みファイルも解放するため、まず
Clear を押さなくても別の写真をドロップできます。
Transloadit plugin のインストールは 1 回だけです。その assemblyOptions 関数は、各アップロードの開始時に選択された整数の寸法を読み取り、パラメーターと一緒にフィールドとして送信します。そのため、解像度を変更しても plugin を再インストールしたり、スケーリング済みのプレビュー寸法からピクセル数を導出したりはしません。ファイル入力では、ドラッグ&ドロップなしで写真を選ぶこともできます。
次は appendButton です。ここでの機能は、見ればほぼわかる内容です。解像度の組の 1 つを使ってボタン要素を作成します。特に、後でボタンからこれらの値を取り出しやすいよう、data-width と data-height という 2 つの data 属性を追加しています。
最後に紹介するのが setPreviewBoxDimensions です。ここでは、先ほど触れた data 属性を取得し、それを使ってプレビュー枠を同じアスペクト比のまま、ページに収まるよう少し縮小してリサイズします。
最終結果
HTML、CSS、module script を組み合わせ、Template を設定し、ページをローカルで配信します。
解像度を選び、写真を選択またはドロップして、生成された壁紙を開けば、ブラウザーから保存できます。リサイズ後の画像は、Samsung Galaxy のスマートフォンからウルトラワイドのデスクトップモニターまで、選択したデバイスに適合します。
以上で今回のブログは終了です。次回のブログを楽しみにしているなら、ニュースレターに登録してください。最新の Transloadit の更新情報に加え、私たちが面白いと感じた技術記事も受け取れます.
