Data:URL変換拡張機能 開発者向けドキュメント

概要

この拡張機能は、文字列・画像・JSON・CSV/TSV を data:URL に変換するための Scratch 拡張機能です。 データを Base64 形式または UTF-8(raw) 形式で簡単に扱えるように設計されています。

インストール方法

  1. Scratch 3.0 / TurboWarp の拡張機能管理画面を開きます。
  2. 「拡張機能を追加」から本拡張を登録します。
  3. 拡張が読み込まれると、ブロックパレットに「data:URL変換」ブロックが表示されます。

提供されるブロック一覧

文字列 → data:URL(自動判定)

文字列 [INPUT] を [FORMAT] / [ENC] で data:URL に変換

画像/SVG文字列 → data:URL

画像/SVG文字列 [IMAGE_TEXT] を [IMG_FORMAT] / [ENC] で data:URL に

JSON文字列 → data:URL

JSON文字列 [JSON_TEXT] を [ENC] で data:URL に

CSV/TSV → data:URL

CSV/TSVテキスト [TABLE_TEXT] を [TABLE_FORMAT] / [ENC] で data:URL に

任意MIME指定 → data:URL

文字列 [INPUT] を MIME [MIME] / [ENC] で data:URL に

data:URL 判定

[URL] は data: URL ですか?

使用例

文字列を text/plain / Base64 に変換

toDataUrlAuto({
  INPUT: "こんにちは, world!",
  FORMAT: "text/plain",
  ENC: "base64"
});

返却例: data:text/plain;base64,44GT44KT44Gr44Gh44GvLCB3b3JsZCE=

SVGを raw 形式で data:URL に

toDataUrlImage({
  IMAGE_TEXT: '<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64"><rect width="64" height="64" fill="#2ec4b6"/></svg>',
  IMG_FORMAT: "image/svg+xml",
  ENC: "raw"
});

JSON文字列 → UTF-8 raw の data:URL

toDataUrlJson({
  JSON_TEXT: '{"greeting":"こんにちは"}',
  ENC: "raw"
});

返却例: data:application/json;charset=utf-8,%7B%22greeting%22%3A%22%E3%81%93%E3%82%93%E3%81%AB%E3%81%A1%E3%81%AF%22%7D

CSV → Base64 data:URL

toDataUrlCsv({
  TABLE_TEXT: "a,b,c\n1,2,3",
  TABLE_FORMAT: "text/csv",
  ENC: "base64"
});

返却例: data:text/csv;base64,YSwgYiwgYwoxLDIsMw==

任意MIMEで data:URL 作成

toDataUrlWithMime({
  INPUT: "example",
  MIME: "application/octet-stream",
  ENC: "base64"
});

URLが data:URL か判定

isDataUrl({
  URL: "data:text/plain;charset=utf-8,hello"
}); // true

注意点・ヒント