ホームページに1行貼るだけで、右下に「Aa 見やすさ」ボタンが表示され、閲覧する方が文字の大きさ・配色の切り替え・音声の読み上げを使えるようになります。このページの右下でもお試しいただけます。
現在は試用版です。表示の崩れなどお気づきの点があれば、お知らせいただけると助かります。
1. 貼り付けるタグ
サイトの全ページ共通の場所(</body> の直前がおすすめ)に、次の1行を貼り付けてください。data-tenant-id には、こちらからお伝えするサイトごとの名前を入れます。
<script src="https://widget.astrolabe.aichi.jp/v1/widget.js" data-tenant-id="ここにサイト名" defer></script>
2. サイトの種類別の貼り方
| HTML で作ったサイト | 各ページの </body> の直前に貼ります(共通部品のファイルがあればそこに1か所)。 |
|---|---|
| WordPress | テーマの footer.php の <?php wp_footer(); ?> の直前に貼るか、ヘッダー・フッターにコードを追加できるプラグインを使います。 |
| その他の CMS・ホームページ作成サービス | 「フッターに HTML を追加」「カスタムコード」などの設定欄に貼ります。 |
3. 表示位置などの設定(任意)
data-position="left" | ボタンを左下に表示します(標準は右下)。チャットボタン等と重なる場合に。 |
|---|---|
data-offset-bottom="90" | ボタンを下から指定の高さ(px)に表示します。下部の固定バナーと重なる場合に。 |
4. 外し方
貼り付けたタグの1行を削除するだけです。サイト側に他の変更は残りません。
5. セキュリティについて
このウィジェットは、閲覧している方のブラウザの中で表示を切り替えるだけのプログラムです。サイトや閲覧者の情報を集めたり送ったりはしません。
| 行うこと | 文字の大きさ・配色の切り替え、本文や選択した文字の読み上げ、右下のボタンの表示だけです。 |
|---|---|
| 行わないこと |
・フォームの入力内容、Cookie、ログイン情報を読み取りません ・外部へのデータ送信(解析・広告・追跡)は一切行いません。ウィジェットのファイルを読み込む以外の通信はありません ・サイトのデータやサーバには何も書き込みません(タグを外せば元どおりです) |
| 閲覧者の端末に保存するもの | 選んだ文字の大きさ・配色・読み上げの速さだけです。閲覧者のブラウザの中(localStorage)に保存し、外部には送りません。個人を特定する情報は保存しません。 |
| 読み上げ | 端末に内蔵された音声だけを使います。読み上げる文章がインターネット上の音声サービスに送られる音声(外部送信型)しか無い端末では、読み上げを行いません。 |
| 配信サーバ |
・HTTPS(暗号化通信)だけで配信します(HSTS 設定済み) ・管理画面は2段階認証、ファイルの更新は鍵による認証で行い、関係者以外は変更できません ・版番号付きのファイル(例 /v0.1.9/)は公開後に中身を変更しません・ファイルの読み込み時には、一般的な Web サーバと同様に、アクセスの記録(IP アドレス・読み込み元のページ・ブラウザの種類)がサーバに残ります。この記録は障害調査と利用状況の把握にだけ使います |
中身が変わらないことを確かめたい場合(SRI)
上記1のタグ(/v1/)は、不具合の修正などが自動で反映されます。配信ファイルが勝手に変わらないことをブラウザに確認させたい場合は、版を固定したタグに integrity(ファイルの指紋)を付けてお使いください。指紋が一致しないファイルは、ブラウザが実行を拒否します(代わりに、新しい版を使うにはタグの差し替えが必要になります)。
<script src="https://widget.astrolabe.aichi.jp/v0.1.9/widget.js" integrity="sha384-WQhGxVkyCsbLD5v8QA4Pmp9ih2lnheE+k/xdxs44xIFGZQLylhsBWGx84LxBATEc" crossorigin="anonymous" data-tenant-id="ここにサイト名" defer></script>
外部のサーバからの読み込み自体を避けたい場合は、ファイル一式をお渡しし、お客様のサーバに置いて使う形(外部通信なし)にも対応します。ご相談ください。
6. よくあるご質問
| 閲覧者の情報は送られますか? | 送りません。選んだ文字の大きさや配色は、閲覧者のブラウザの中だけに保存されます。読み上げは端末に内蔵された音声だけを使います(詳しくは「5. セキュリティについて」)。 |
|---|---|
| サイトが重くなりませんか? | ファイルは約11KB(圧縮時)で、読み込みはページの表示が終わってから行います。 |
| 表示されません | サイトにセキュリティ設定(CSP)がある場合、https://widget.astrolabe.aichi.jp からのスクリプトの読み込みと、ウィジェットが差し込むスタイルの許可が必要です。設定内容はご相談ください。 |
| アクセシビリティ対応は完了しますか? | このウィジェットは閲覧を補助する機能です。サイト自体のアクセシビリティ対応(法令・規格への準拠)を代わりに行うものではありません。 |