Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Update the bundled Observable Plot and Inputs libraries

Đang mở Phù hợp với người mới
#14,934 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
65/100
Loại issue
Tái cấu trúc
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
javascript

Hướng nghiên cứu

Các thư viện được đóng gói được định nghĩa trong src/resources/formats/html/ojs/quarto-ojs-runtime.js tại dòng 207-208. Cập nhật số phiên bản cho Plot và Inputs lên các bản phát hành mới nhất (Plot 0.6.17, Inputs 0.11.0). Xác minh thay đổi bằng cách build Quarto và kiểm tra xem các phiên bản mới có được phục vụ không. Kiểm tra các ghi chú phát hành của các thư viện đã cập nhật để tìm các thay đổi phá vỡ tính tương thích.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.

Ngôn ngữ chính
JavaScript
Star
6k
Fork
458
Merge trung bình
1 ngày 5 giờ
Pull request đã merge (30 ngày)
53

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của quarto-dev/quarto-cli

Tất cả issue của quarto-dev/quarto-cli

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.