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

hov propの文字列指定がスペース区切りを受け付けず、set / utilと区切り文字の扱いが異なる

Đã đóng
  • Có gì không ổn?
#665 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

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

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
72/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
frontend

Hướng nghiên cứu

Read packages/lism-css/src/lib/helper/mergeSet.ts and trace setHovProps in getLismProps.ts to understand their current splitting paths. Then inspect the listed tests for splitWithComma and the Japanese and English hov docs and examples. Done means both props accept space-separated values with comma compatibility, empty values are discarded, and the documented examples use spaces.

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

Mô tả

背景

<Lism>のset / util propはスペース区切り（カンマも互換で可）で複数指定できますが、hov propの文字列指定はカンマ区切りしか受け付けません。同じく複数の値を並べるpropなのに書き方がそろっておらず、hovをスペース区切りで書くと意図しないクラスが出力されます。

詳細

prop 分割処理 受け付ける区切り
set / util mergeSet（packages/lism-css/src/lib/helper/mergeSet.ts） スペースが基本。カンマも互換で可（/[,\s]+/で分割）
hov（文字列指定） getLismProps.tsのsetHovPropsから呼ぶsplitWithComma カンマのみ

set / utilは以前カンマ区切りでした。977150a85でスペース区切りに統一し、30a8e69c3でカンマを互換として戻しています。hovはこのときの変更に含まれていません。

ドキュメントの記述も分かれています。

  • set: スペース区切り（apps/site/src/content/ja/core-components/lism-props.mdx、skills/lism-css-guide/components-core.md）
  • hov: カンマ区切り（apps/site/src/content/ja/property-class/hov.mdx、skills/lism-css-guide/property-class.md、skills/lism-css-guide/property-class/hov.md）
スペース区切りで書いたときの挙動

hov="-c -bdc"は-hov:-c -bdcという1つの文字列として扱われます。最後にattsがスペースで分割するため、出力されるクラスは次の2つです（コードを読んだ結果で、実行しての確認はしていません）。

  • -hov:-c（意図どおり）
  • -bdc（ホバー用ではない余計なクラス）

エラーや警告は出ないため、気づきにくい状態です。

末尾カンマ

hov="-c,"のように末尾にカンマがあると、空の要素を除いていないため中身のない-hov:クラスが出力されます。

改善方法

  • mergeSet.ts内の分割処理（normalize。/[,\s]+/で分割し空要素を除く）を、独立したヘルパーsplitValuesとして切り出す。
  • mergeSetとsetHovPropsの両方からsplitValuesを呼ぶ。区切りのルールを1か所にまとめ、set / util / hovの書き方が再びずれないようにする。
  • splitWithComma.tsとそのテストを削除する。@lism-css/uiからは読み込まれていないため、互換の問題はない。
  • hovのドキュメントを、setと同じくスペース区切りを基本とする案内に直す。カンマ区切りの既存の用例（hov="-bgc,-c"など）もスペース区切りに書き換える。
    • apps/site/src/content/ja/property-class/hov.mdx / en/property-class/hov.mdx
    • apps/site/src/content/ja/ui/NavMenu.mdx / en/ui/NavMenu.mdx
    • apps/site/src/components/mdx/DocsLink.astro
    • skills/lism-css-guide/property-class.md
    • skills/lism-css-guide/property-class/hov.md

やらないこと

  • hovの分割にmergeSetをそのまま流用しない。mergeSetは-で始まる値を除外指定として扱いますが、hovの値は-cのように-で始まるため、正しく分割できません。分割処理だけを共用します。
  • setHovPropsの中に分割処理を直接書く案は採らない。mergeSetと同じ正規表現が2か所に分かれ、片方だけ直されて区切りがまたずれる余地が残るためです。
  • ヘルパー名に「token」は使わない。Lismではデザイントークンを指す言葉で紛らわしいためです。
Ngôn ngữ chính
TypeScript
Star
283
Fork
8
Merge trung bình
6 giờ 37 phút
Pull request đã merge (30 ngày)
15

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

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 lism-css/core

Tất cả issue của lism-css/core

Issue tương tự

Thêm issue về TypeScript

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.