Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

アイコンのアクセシビリティ対応 #1059

Merged
merged 13 commits into from
Feb 28, 2024

Conversation

mthaichi
Copy link
Contributor

@mthaichi mthaichi commented Jan 30, 2024

チケットへのリンク / 変更の理由(元のissueがあればリンクを貼り付ければOK)

vektor-inc/vk-blocks-pro#1795

どういう変更をしたか?

  • Font Awesomeのタグを見つけたら aria-hidden="true" の属性を付加するように修正(すでに付加されているものにはつけない)
  • テストを追加しました。

実装者はレビュワーに回す前に以下の事を確認してチェックをつけてください。

ソースコードについて

  • 複数の意図の変更 ( 機能の不具合修正 + 別の機能追加など ) を含んでいないか?
  • 関数名 / 変数名 / クラス名 / 保存値名 はそれだけで内容が想像できるものになっているか?紛らわしい命名になっていないか?
  • 関数名 / 変数名 / クラス名 / 保存値名 は既存のコードの命名規則に沿ったものになっているか?

デザイン・UI

  • 初見のユーザーが予備知識無しで使っても使いやすいようになっているか?
  • 情報意味を考慮した意味グルーピング・余白になっているか?
  • アラートの表示など追加した場合は他の同様の表示と同じデザインになっているか?

プログラムの変更の場合

テストを書かないのは普通ではありません。書けるテストは極力書くようにしてください。
書いていない場合は書かない理由を記載してください。

  • 書けそうなテストは書いたか?
  • 表示要素が仕様通りに表示されない不具合の修正ではない or 表示要素に関する不具合修正の場合テストは書いたか?

その他

  • readme.txt に変更内容は書いたか?
  • Files changed (変更ファイル)の内容は目視でちゃんと確認したか?
  • このチェック項目を機械的にチェックするのではなく本当にちゃんと確認をしたか?
  • レビュワーが確認しないでリリースしてしまっても問題ないレベルまでちゃんと作りこみ・確認をしたか?

変更内容について何を確認したか、どういう方法で確認をしたかなど

  • 本ブランチをビルドして、ExUnitの有効化画面でデフォルト有効になっていることを確認。
  • 適当にfont awesomeアイコンを配置して、フロント側のソースを表示した時に、aria-hidden="true"がついていることを確認
  • 元からaria-hidden=""があるタグは変換されないことを確かめる。カスタムHTMLで <i aria-hidden="true" class="fa fa-car"></i> と入れても <i class="fa fa-car"></i> と入れても、 aria-hidden="****" がフロントで出力されることを確認(trueをfalseにしても影響はないはずです)
  • その他コード目視で気になる点があればご指摘ください。

2人チェックでお願いしたいです。

確認URL

( どこかのデモサイトかテストサーバーにデプロイ済みなどで確認できる場合はそのURL )

レビュワーの確認方法・確認する内容など

レビュワーに回す前の確認事項

  • このテンプレートのチェック項目をちゃんと確認してチェックしたか?

レビュワー向け

確認して変更が反映されていない場合の確認事項

  • プルしたか?
  • ビルドしたか?
  • ビルドしたディレクトリは正しいか(別の開発環境のディレクトリを見ていないか)?
  • npm install したか?
  • composer install したか?

@mthaichi mthaichi marked this pull request as draft January 30, 2024 14:52
@mthaichi mthaichi marked this pull request as ready for review February 6, 2024 07:04
@mthaichi mthaichi changed the title 【調整中】アイコンのアクセシビリティ対応 【確認待ち】アイコンのアクセシビリティ対応 Feb 6, 2024
@mthaichi mthaichi changed the title 【確認待ち】アイコンのアクセシビリティ対応 【1人目確認待ち】アイコンのアクセシビリティ対応 Feb 6, 2024
@sysbird sysbird changed the title 【1人目確認待ち】アイコンのアクセシビリティ対応 【1人目確認中】アイコンのアクセシビリティ対応 Feb 7, 2024
@sysbird
Copy link
Member

sysbird commented Feb 7, 2024

@mthaichi 確認しました

  • すでに付加されているもの / 付加されてないもの
  • 設定画面での ON/OFF

問題ないと思います、ありがとうございます
Accessability → A11y っていうんですね、知りませんでした〜

もう お一人確認お願いします

@sysbird sysbird changed the title 【1人目確認中】アイコンのアクセシビリティ対応 【2人目確認待ち】アイコンのアクセシビリティ対応 Feb 7, 2024
@kurudrive kurudrive changed the title 【2人目確認待ち】アイコンのアクセシビリティ対応 【2人目確認中】アイコンのアクセシビリティ対応 Feb 7, 2024
@kurudrive
Copy link
Member

kurudrive commented Feb 7, 2024

@mthaichi @sysbird ありがとうございます。
ジャ...ジャンピング土下座3回転半1回ひねりですみません(滝汗)
改めて見ると the_content を通す方法だと本文以外のヘッダーやフッターのアイコンには aria-hidden="true" つかないので、元のブロック側での処理あるいは js などでの処理も必要かなと思ったりしますがど...どう...で...しょうか?(震え声)

@kurudrive
Copy link
Member

@sysbird
Copy link
Member

sysbird commented Feb 9, 2024

気になったので確認しました
js での処理もスクリーンリーダーに有効です

@mthaichi
Copy link
Contributor Author

@kurudrive the_content だけではなく、render_block のフィルターフックにも引っ掛けるようにしましたが、いかがでしょう。クラシックテーマのヘッダーやフッターは引っかかりませんが、テーマファイルを変更していただくということで良いと思います。

大元の出力を弄る方法もありますが、
https://mycus-tom.com/posts/101

プラグインがそのレベルに介入すべきではないと考えますので、この方法が妥当と考えました。

@sysbird できるだけサーバーサイドで処理したいので、JSは最終手段ということで考えています。
最終手段で使えることがわかりましたので、ありがとうございます!

@kurudrive kurudrive changed the title 【2人目確認中】アイコンのアクセシビリティ対応 アイコンのアクセシビリティ対応 Feb 28, 2024
@kurudrive kurudrive merged commit e241c30 into master Feb 28, 2024
3 checks passed
@kurudrive kurudrive deleted the feature/icon-accessibility branch February 28, 2024 16:47
@kurudrive
Copy link
Member

@mthaichi ありがとうございましたーん!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants