Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Update the bundled Observable Plot and Inputs libraries

オープン 初心者向け
#14,934 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
65/100
issue の種類
リファクタリング
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
javascript

調査の方向性

バンドルされたライブラリは、src/resources/formats/html/ojs/quarto-ojs-runtime.js の 207-208 行目で定義されています。Plot と Inputs のバージョン番号を最新リリース(Plot 0.6.17、Inputs 0.11.0)に更新してください。Quarto をビルドし、新しいバージョンが提供されていることをテストして変更を確認します。更新されたライブラリのリリースノートに破壊的変更がないか確認してください。

索引モデルが issue の本文から書いたものです。

説明

maintenance ojs-engine

Quarto bundles Observable Plot 0.6.11 and Observable Inputs 0.10.6. These versions have not changed since November 2023.

https://github.com/quarto-dev/quarto-cli/blob/e24bcbd1fa93165e4dc2b022a9564dbc1692f114/src/resources/formats/html/ojs/quarto-ojs-runtime.js#L207-L208

Before that, the bundled Plot moved about every six months: 0.6.0 (November 2022), 0.6.5 (April 2023), and 0.6.11 (November 2023, f04ca43).

The current Plot release is 0.6.17. The upstream observablehq/stdlib pins Plot 0.6.16 and Inputs 0.11.0 (stdlib v5.8.8).

Accessibility

An update also removes some accessibility errors on quarto.org.

In Plot 0.6.11, each axis tick is in the accessibility tree. VoiceOver announces each tick as "image", which adds noise between the tick values (observablehq/plot#2019). Plot 0.6.14 hides the ticks from assistive technology (observablehq/plot#2018).

The tick groups also have an aria-label with no role. axe reports this as aria-prohibited-attr, a failure of WCAG 2.2 SC 4.1.2 Name, Role, Value.

I scanned the 10 OJS pages on quarto.org with quarto call axe, before and after the documented import of the latest Plot (0.6.17):

Plot findings instances
Plot 0.6.11 (bundled) 20 54
Plot 0.6.17 (import) 10 24

The update removed all findings on axis-tick and grid groups. It added no new findings. I did not test Inputs 0.11.0.

If your own scan found these errors

Charts from Plot 0.6.11 give aria-prohibited-attr errors on <g> elements such as g[aria-label="y-axis tick"]. These errors come from Plot, not from your content.

To use a newer Plot on a page, add this cell (Libraries):

Plot = import("https://cdn.jsdelivr.net/npm/@observablehq/plot/+esm")

The newer Plot still puts an aria-label on data marks (rect, frame, line, rule, tick). axe reports these marks with the same error. A Quarto update does not change this.

This is a design decision in Plot. Plot gives every mark an automatic label, such as "dot", and adds no role (observablehq/plot#710). One Plot maintainer's view is that SVG-AAM already includes a <g> with a non-empty aria-label in the accessibility tree. The maintainer was not sure that role="graphics-object" would help users (observablehq/plot#944). The open request for a role is observablehq/plot#1760.

Plot's ariaHidden mark option removes a decorative mark from the accessibility tree (Plot accessibility docs).

AI tools helped with this investigation. The investigation used local clones of quarto-cli and quarto-web.

主要言語
JavaScript
スター
6k
フォーク
458
平均マージ
1日 5時間
マージ済み PR(30日)
53

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

quarto-dev/quarto-cli のほかの issue

quarto-dev/quarto-cli の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。