Skip to content

docs: explain the attribute model — data-numkey is the switch, the rest are options#2

Merged
jlc488 merged 1 commit into
mainfrom
docs/attribute-semantics
Jul 17, 2026
Merged

docs: explain the attribute model — data-numkey is the switch, the rest are options#2
jlc488 merged 1 commit into
mainfrom
docs/attribute-semantics

Conversation

@jlc488

@jlc488 jlc488 commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Why / 왜

data-numkeydata-numkey-locale의 차이가 문서에서 드러나지 않았습니다 — 속성들이 평평한 테이블 하나에 나열돼 있어서, data-numkey가 바인딩 스위치이고 나머지 data-numkey-*는 그것 없이는 아무것도 하지 않는 옵션이라는 구조가 안 보였고, locale 옵션은 default/auto/고정 태그의 동작 차이 예제가 없었습니다.

Readers couldn't tell the two apart: the flat attribute table never said data-numkey is the on-switch and everything else is inert without it, and the locale option had no default-vs-auto-vs-pinned examples.

What / 무엇

  • README en/ko — "How the attributes work / 속성이 동작하는 방식" 섹션 추가: on/off/anti-example 코드 블록 (<input data-numkey-locale="auto"> 단독은 ✗ 아무것도 안 함), 테이블에서 data-numkey스위치로 명시
  • README en/ko — "Locale-aware display / 로케일 표시" 섹션: 세 변형(기본 고정 / auto 브라우저 언어별 결과 / de-DE 고정) 예제 + canonical 불변 + 폼 POST 주의 (전송되는 건 표시 값 — 제출 전 getValue)
  • 데모 사이트 — locale 카드에 같은 3-변형 스니펫

Verification / 검증

Docs + demo HTML only, no runtime change. typecheck ✓ · 49 tests ✓

…st are options

Readers couldn't tell data-numkey and data-numkey-locale apart: the README
listed the attributes in one flat table without saying that data-numkey is
what binds an input (and that every other data-numkey-* attribute is inert
without it), and the locale option had no examples showing default vs auto
vs pinned-tag behavior.

- README en/ko: 'How the attributes work' section with an on/off/anti-example
  block, table now marks data-numkey as THE switch, new 'Locale-aware
  display' section with the three variants and per-browser outcomes, plus
  the form-POST caveat (display value is what posts — getValue before submit)
- demo site: same three-variant snippet in the locale card
@jlc488
jlc488 merged commit 0c53e4c into main Jul 17, 2026
1 check passed
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.

1 participant