@finhay-pro/leaf-design-system 0.1.8 → 0.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +129 -52
- package/dist/button.css +2 -1
- package/dist/cdn/leaf-0.1.9.min.css +2 -0
- package/dist/cdn/{leaf-0.1.8.min.js → leaf-0.1.9.min.js} +2 -2
- package/dist/classes.css +12 -8
- package/dist/components/Dropdown/Dropdown.d.ts +1 -1
- package/dist/components/Dropdown/Dropdown.d.ts.map +1 -1
- package/dist/components/Dropdown/Dropdown.js +5 -3
- package/dist/components/Dropdown/Dropdown.js.map +1 -1
- package/dist/components/Input/InputDate.d.ts +14 -5
- package/dist/components/Input/InputDate.d.ts.map +1 -1
- package/dist/components/Input/InputDate.js +13 -3
- package/dist/components/Input/InputDate.js.map +1 -1
- package/dist/components/Slider/Slider.d.ts +1 -1
- package/dist/components/Slider/Slider.d.ts.map +1 -1
- package/dist/components/Slider/Slider.js +7 -4
- package/dist/components/Slider/Slider.js.map +1 -1
- package/dist/components/Toggle/Toggle.d.ts +2 -1
- package/dist/components/Toggle/Toggle.d.ts.map +1 -1
- package/dist/components/Toggle/Toggle.js +5 -2
- package/dist/components/Toggle/Toggle.js.map +1 -1
- package/dist/components/Tooltip/Tooltip.d.ts +13 -1
- package/dist/components/Tooltip/Tooltip.d.ts.map +1 -1
- package/dist/components/Tooltip/Tooltip.js.map +1 -1
- package/dist/core/tooltip.d.ts +4 -0
- package/dist/core/tooltip.d.ts.map +1 -1
- package/dist/core/tooltip.js.map +1 -1
- package/dist/styles.css +12 -8
- package/dist/toggle.css +10 -7
- package/package.json +1 -1
- package/dist/cdn/leaf-0.1.8.min.css +0 -2
package/README.md
CHANGED
|
@@ -25,32 +25,32 @@ pnpm add @finhay-pro/leaf-design-system
|
|
|
25
25
|
Class chỉ đọc `var(--…)`, không tự khai báo giá trị — nên **luôn import `tokens.css` trước**, rồi
|
|
26
26
|
chọn phần class cần dùng.
|
|
27
27
|
|
|
28
|
-
| Import | Nội dung
|
|
29
|
-
| -------------------------------------------------- |
|
|
30
|
-
| `@finhay-pro/leaf-design-system/tokens.css` | Chỉ token (primitive + semantic màu + typography), không class.
|
|
31
|
-
| `@finhay-pro/leaf-design-system/typography.css` | Chỉ class typography.
|
|
32
|
-
| `@finhay-pro/leaf-design-system/color.css` | Chỉ class color.
|
|
33
|
-
| `@finhay-pro/leaf-design-system/button.css` | Style của component `Button`.
|
|
34
|
-
| `@finhay-pro/leaf-design-system/tabs.css` | Style của component `Tabs`.
|
|
35
|
-
| `@finhay-pro/leaf-design-system/dialog.css` | Style của component `Dialog`.
|
|
36
|
-
| `@finhay-pro/leaf-design-system/logo.css` | Style của component `Logo`.
|
|
37
|
-
| `@finhay-pro/leaf-design-system/logo-assets.css` | SVG data-URI cho Logo HTML tĩnh — không nằm trong `classes.css` / `styles.css`.
|
|
38
|
-
| `@finhay-pro/leaf-design-system/skeleton.css` | Style của component `Skeleton`.
|
|
39
|
-
| `@finhay-pro/leaf-design-system/spinner.css` | Style của component `Spinner`.
|
|
40
|
-
| `@finhay-pro/leaf-design-system/toggle.css` | Style của component `Toggle`.
|
|
41
|
-
| `@finhay-pro/leaf-design-system/slider.css` | Style của component `Slider`.
|
|
42
|
-
| `@finhay-pro/leaf-design-system/tooltip.css` | Style của component `Tooltip`.
|
|
43
|
-
| `@finhay-pro/leaf-design-system/radio.css` | Style của component `Radio` / `RadioGroup`.
|
|
44
|
-
| `@finhay-pro/leaf-design-system/checkbox.css` | Style của component `Checkbox`.
|
|
45
|
-
| `@finhay-pro/leaf-design-system/input.css` | Style của component `Input` (field / inline, dùng chung cho `InputDate`).
|
|
46
|
-
| `@finhay-pro/leaf-design-system/input-otp.css` | Style của component `InputOtp`.
|
|
47
|
-
| `@finhay-pro/leaf-design-system/input-stepper.css` | Style của component `InputStepper`.
|
|
48
|
-
| `@finhay-pro/leaf-design-system/calendar.css` | Style của component `Calendar` (cần kèm `button.css`
|
|
49
|
-
| `@finhay-pro/leaf-design-system/input-date.css` | Popover của `InputDate` (
|
|
50
|
-
| `@finhay-pro/leaf-design-system/toast.css` | Style của `Toaster` / `ToastContent`.
|
|
51
|
-
| `@finhay-pro/leaf-design-system/dropdown.css` | Style của component `Dropdown`.
|
|
52
|
-
| `@finhay-pro/leaf-design-system/classes.css` | Tất cả class + component, không token.
|
|
53
|
-
| `@finhay-pro/leaf-design-system/styles.css` | Token + tất cả class + component. Một dòng là đủ.
|
|
28
|
+
| Import | Nội dung |
|
|
29
|
+
| -------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|
|
30
|
+
| `@finhay-pro/leaf-design-system/tokens.css` | Chỉ token (primitive + semantic màu + typography), không class. |
|
|
31
|
+
| `@finhay-pro/leaf-design-system/typography.css` | Chỉ class typography. |
|
|
32
|
+
| `@finhay-pro/leaf-design-system/color.css` | Chỉ class color. |
|
|
33
|
+
| `@finhay-pro/leaf-design-system/button.css` | Style của component `Button`. |
|
|
34
|
+
| `@finhay-pro/leaf-design-system/tabs.css` | Style của component `Tabs`. |
|
|
35
|
+
| `@finhay-pro/leaf-design-system/dialog.css` | Style của component `Dialog`. |
|
|
36
|
+
| `@finhay-pro/leaf-design-system/logo.css` | Style của component `Logo`. |
|
|
37
|
+
| `@finhay-pro/leaf-design-system/logo-assets.css` | SVG data-URI cho Logo HTML tĩnh — không nằm trong `classes.css` / `styles.css`. |
|
|
38
|
+
| `@finhay-pro/leaf-design-system/skeleton.css` | Style của component `Skeleton`. |
|
|
39
|
+
| `@finhay-pro/leaf-design-system/spinner.css` | Style của component `Spinner`. |
|
|
40
|
+
| `@finhay-pro/leaf-design-system/toggle.css` | Style của component `Toggle`. |
|
|
41
|
+
| `@finhay-pro/leaf-design-system/slider.css` | Style của component `Slider`. |
|
|
42
|
+
| `@finhay-pro/leaf-design-system/tooltip.css` | Style của component `Tooltip`. |
|
|
43
|
+
| `@finhay-pro/leaf-design-system/radio.css` | Style của component `Radio` / `RadioGroup`. |
|
|
44
|
+
| `@finhay-pro/leaf-design-system/checkbox.css` | Style của component `Checkbox`. |
|
|
45
|
+
| `@finhay-pro/leaf-design-system/input.css` | Style của component `Input` (field / inline, dùng chung cho `InputDate`). |
|
|
46
|
+
| `@finhay-pro/leaf-design-system/input-otp.css` | Style của component `InputOtp`. |
|
|
47
|
+
| `@finhay-pro/leaf-design-system/input-stepper.css` | Style của component `InputStepper`. |
|
|
48
|
+
| `@finhay-pro/leaf-design-system/calendar.css` | Style của component `Calendar` (cần kèm `button.css` + `color.css`). |
|
|
49
|
+
| `@finhay-pro/leaf-design-system/input-date.css` | Popover của `InputDate` (kèm `input.css` + `calendar.css` + `button.css` + `color.css`). |
|
|
50
|
+
| `@finhay-pro/leaf-design-system/toast.css` | Style của `Toaster` / `ToastContent`. |
|
|
51
|
+
| `@finhay-pro/leaf-design-system/dropdown.css` | Style của component `Dropdown`. |
|
|
52
|
+
| `@finhay-pro/leaf-design-system/classes.css` | Tất cả class + component, không token. |
|
|
53
|
+
| `@finhay-pro/leaf-design-system/styles.css` | Token + tất cả class + component. Một dòng là đủ. |
|
|
54
54
|
|
|
55
55
|
Import bằng CSS:
|
|
56
56
|
|
|
@@ -276,7 +276,7 @@ Thêm component React (khi thật sự cần state/behavior, không phải để
|
|
|
276
276
|
`src/components/<Tên>/` (kèm `<tên>.css` nếu cần) rồi re-export trong `src/index.ts`. CSS của
|
|
277
277
|
component cũng ra `dist/<tên>.css` và được gom vào `classes.css` / `styles.css` — nhớ thêm dòng
|
|
278
278
|
`"./<tên>.css"` vào `exports`. Tên file CSS phải duy nhất trong cả `src/` (script báo lỗi nếu trùng).
|
|
279
|
-
Component có hành vi (Tabs · Toggle · Dialog · Slider · Tooltip · InputOtp · InputStepper · Toast · Dropdown) cần thêm bản vanilla cho HTML
|
|
279
|
+
Component có hành vi (Button loading · Tabs · Toggle · Dialog · Slider · Tooltip · InputOtp · InputStepper · Toast · Dropdown) cần thêm bản vanilla cho HTML
|
|
280
280
|
tĩnh trong `src/vanilla/` và gắn vào `window.Leaf` qua `src/vanilla/index.ts`. `src/vanilla` chỉ
|
|
281
281
|
vào bản CDN, không vào bản npm.
|
|
282
282
|
|
|
@@ -305,16 +305,16 @@ vào bản CDN, không vào bản npm.
|
|
|
305
305
|
| `LanguageDropdown` | Chọn ngôn ngữ Tiếng Việt / English kèm cờ (CDN Finhay) — danh sách ở `LEAF_LANGUAGES`, `value` kiểu `LeafLanguageCode`; mặc định `size="sm"`, `openOn="hover"`, `align="end"` |
|
|
306
306
|
|
|
307
307
|
```css
|
|
308
|
-
/* Ngoài tokens.css + typography.css, mỗi component cần CSS riêng của nó
|
|
308
|
+
/* Ngoài tokens.css + typography.css, mỗi component cần CSS riêng của nó
|
|
309
|
+
(bảng đầy đủ ở mục Import CSS) — hoặc một dòng styles.css cho tất cả */
|
|
309
310
|
@import "@finhay-pro/leaf-design-system/button.css";
|
|
310
311
|
@import "@finhay-pro/leaf-design-system/tabs.css";
|
|
311
312
|
@import "@finhay-pro/leaf-design-system/dialog.css";
|
|
312
|
-
@import "@finhay-pro/leaf-design-system/
|
|
313
|
-
@import "@finhay-pro/leaf-design-system/
|
|
314
|
-
@import "@finhay-pro/leaf-design-system/
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
@import "@finhay-pro/leaf-design-system/tooltip.css";
|
|
313
|
+
@import "@finhay-pro/leaf-design-system/toast.css";
|
|
314
|
+
@import "@finhay-pro/leaf-design-system/input.css";
|
|
315
|
+
@import "@finhay-pro/leaf-design-system/dropdown.css";
|
|
316
|
+
/* … skeleton / spinner / toggle / slider / tooltip / radio / checkbox / input-otp /
|
|
317
|
+
input-stepper / calendar / input-date / logo */
|
|
318
318
|
```
|
|
319
319
|
|
|
320
320
|
```tsx
|
|
@@ -328,14 +328,28 @@ import {
|
|
|
328
328
|
Toggle,
|
|
329
329
|
Slider,
|
|
330
330
|
Tooltip,
|
|
331
|
+
Radio,
|
|
332
|
+
RadioGroup,
|
|
333
|
+
Checkbox,
|
|
334
|
+
Input,
|
|
335
|
+
InputOtp,
|
|
336
|
+
InputStepper,
|
|
337
|
+
InputDate,
|
|
338
|
+
Calendar,
|
|
339
|
+
Dropdown,
|
|
340
|
+
LanguageDropdown,
|
|
341
|
+
Toaster,
|
|
342
|
+
toast,
|
|
331
343
|
} from "@finhay-pro/leaf-design-system";
|
|
332
344
|
|
|
333
345
|
<Button priority="primary" size="md" leadingIcon={<PlusIcon />} trailingIcon={<PlusIcon />}>
|
|
334
346
|
Label
|
|
335
347
|
</Button>
|
|
336
|
-
{/* Chỉ icon → layout tròn */}
|
|
348
|
+
{/* Chỉ icon → layout tròn, bắt buộc aria-label */}
|
|
337
349
|
<Button aria-label="Thêm" leadingIcon={<PlusIcon />} />
|
|
338
|
-
|
|
350
|
+
{/* Loading: onClick trả Promise (tự loading tới khi settle) hoặc controlled `loading` —
|
|
351
|
+
không tự nhét <Spinner> vào leadingIcon (Spinner ép màu --base-quinary, không theo màu nút) */}
|
|
352
|
+
<Button size="md" onClick={() => placeOrder()}>
|
|
339
353
|
Mua AAA
|
|
340
354
|
</Button>
|
|
341
355
|
|
|
@@ -349,18 +363,23 @@ import {
|
|
|
349
363
|
{ value: "idle", label: "Mua" },
|
|
350
364
|
]}
|
|
351
365
|
/>
|
|
366
|
+
|
|
367
|
+
{/* Toast: đặt <Toaster /> một lần ở root layout, gọi toast.* ở client */}
|
|
368
|
+
<Toaster />;
|
|
369
|
+
toast.success("Đặt lệnh thành công", { description: "Mua 100 AAA" });
|
|
352
370
|
```
|
|
353
371
|
|
|
354
372
|
## HTML tĩnh (CDN)
|
|
355
373
|
|
|
356
374
|
Cho landing page / trang dựng tay không có bundler: **Leaf CDN + CSS riêng của page**. 1 `<link>` +
|
|
357
375
|
1 `<script>` là dùng được toàn bộ class typography, color và mọi component (CSS). Script chỉ cần
|
|
358
|
-
khi dùng hành vi Tabs · Toggle · Dialog · Slider · Tooltip · InputOtp · InputStepper · Toast · Dropdown (`data-leaf-*`).
|
|
376
|
+
khi dùng hành vi Button loading · Tabs · Toggle · Dialog · Slider · Tooltip · InputOtp · InputStepper · Toast · Dropdown (`data-leaf-*` / `window.Leaf`).
|
|
377
|
+
Calendar / InputDate chưa có bản HTML tĩnh (chỉ React).
|
|
359
378
|
Layout, spacing, responsive của page viết trong CSS của page, dùng token Leaf.
|
|
360
379
|
|
|
361
380
|
```html
|
|
362
|
-
<link rel="stylesheet" href="https://<cdn>/leaf-0.1.
|
|
363
|
-
<script src="https://<cdn>/leaf-0.1.
|
|
381
|
+
<link rel="stylesheet" href="https://<cdn>/leaf-0.1.9.min.css" />
|
|
382
|
+
<script src="https://<cdn>/leaf-0.1.9.min.js" defer></script>
|
|
364
383
|
|
|
365
384
|
<style>
|
|
366
385
|
/* CSS của page — bọc trong @layer để không đè nhầm CSS component (xem "Cần biết") */
|
|
@@ -394,17 +413,25 @@ Layout, spacing, responsive của page viết trong CSS của page, dùng token
|
|
|
394
413
|
</section>
|
|
395
414
|
```
|
|
396
415
|
|
|
397
|
-
| File | Nội dung
|
|
398
|
-
| ------------------------ |
|
|
399
|
-
| `leaf-<version>.min.css` | `styles.css` đã minify: token + typography + color + CSS của mọi component.
|
|
400
|
-
| `leaf-<version>.min.js` | Hành vi Tabs · Toggle · Dialog · Slider · Tooltip · InputOtp · InputStepper · Toast · Dropdown → `window.Leaf`. Trang CSS-only có thể bỏ. |
|
|
416
|
+
| File | Nội dung |
|
|
417
|
+
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
418
|
+
| `leaf-<version>.min.css` | `styles.css` đã minify: token + typography + color + CSS của mọi component. |
|
|
419
|
+
| `leaf-<version>.min.js` | Hành vi Button loading · Tabs · Toggle · Dialog · Slider · Tooltip · InputOtp · InputStepper · Toast · Dropdown → `window.Leaf`. Trang CSS-only có thể bỏ. |
|
|
401
420
|
|
|
402
|
-
Link thật
|
|
421
|
+
Link thật nằm ở trang docs **Develop → Web** (`apps/docs/config/shared.ts` → `leafCdn`). Bản CDN
|
|
422
|
+
cũng nằm trong package npm (`dist/cdn/`), nên jsDelivr phục vụ trực tiếp theo version:
|
|
423
|
+
`https://cdn.jsdelivr.net/npm/@finhay-pro/leaf-design-system@<version>/dist/cdn/leaf-<version>.min.css`
|
|
424
|
+
(và `.min.js`). Trang demo đủ mọi component có bản HTML tĩnh:
|
|
403
425
|
[`examples/static.html`](examples/static.html) (mở bằng `file://` sau khi build).
|
|
404
426
|
|
|
427
|
+
`leaf.js` nạp bằng `defer` — code gọi `Leaf.*` ngay khi tải trang phải đặt trong
|
|
428
|
+
`document.addEventListener("DOMContentLoaded", …)` (handler click / event thì không cần).
|
|
429
|
+
|
|
405
430
|
### Button
|
|
406
431
|
|
|
407
|
-
Không cần JS. Thiếu attribute nào thì lấy mặc định giống prop React.
|
|
432
|
+
Không cần JS, trừ trạng thái loading. Thiếu attribute nào thì lấy mặc định giống prop React. Nút
|
|
433
|
+
có icon thì bọc chữ trong `span.leaf-button__label` — `Leaf.button.setLoading` dựa vào nó để biết
|
|
434
|
+
icon nào là leading. CTA điều hướng dùng được `<a class="leaf-button" href="…">`.
|
|
408
435
|
|
|
409
436
|
| Attribute | Giá trị | Mặc định |
|
|
410
437
|
| ---------------------------- | --------------------------------------------- | --------- |
|
|
@@ -438,13 +465,16 @@ khoá `min-width`, nút đang loading không nhận click (kể cả handler c
|
|
|
438
465
|
`Leaf.dialog.open`. Đóng: Escape / backdrop / `data-leaf-dialog-close` /
|
|
439
466
|
`Leaf.dialog.close(el, reason?)` — `leaf:dialog-close` mang `detail.reason`
|
|
440
467
|
(`close` · `backdrop` · `escape` · `api`). `data-leaf-dialog-dismissible="false"` tắt đóng bằng
|
|
441
|
-
backdrop / Escape. Back: `data-leaf-dialog-back` → `leaf:dialog-back` (không tự
|
|
442
|
-
con khác của `<body>` được đặt `inert` — đặt dialog tĩnh là con trực tiếp của
|
|
468
|
+
backdrop / Escape (nút X vẫn đóng). Back: `data-leaf-dialog-back` → `leaf:dialog-back` (không tự
|
|
469
|
+
đóng). Khi mở, các con khác của `<body>` được đặt `inert` — đặt dialog tĩnh là **con trực tiếp của
|
|
470
|
+
`<body>`** và luôn bắt đầu bằng `hidden` (dialog hiện sẵn lúc load không được khoá cuộn / focus
|
|
471
|
+
trap / `inert`).
|
|
443
472
|
|
|
444
473
|
### Slider
|
|
445
474
|
|
|
446
475
|
`data-leaf-slider` trên `.leaf-slider` + `data-min` / `data-max` / `data-step` / `data-value`
|
|
447
|
-
(mặc định 0 / 100 / 1 / min).
|
|
476
|
+
(mặc định 0 / 100 / 1 / min). Slider tĩnh **cần leaf.js cả để hiển thị đúng**: vị trí mốc / label
|
|
477
|
+
và `--leaf-slider-fill` do leaf.js tính. `Leaf.slider.set(el, value)` · `leaf:slider-input` (liên tục khi kéo)
|
|
448
478
|
· `leaf:slider-change` (khi chốt). Sync `--leaf-slider-fill` (fill + thumb) / `data-state` mốc;
|
|
449
479
|
thiếu `.leaf-slider__thumb` thì leaf.js tự tạo. Có `input.leaf-slider__input[type=hidden]` trong
|
|
450
480
|
markup thì leaf.js ghi giá trị đã chốt vào đó (form). Toggle tương tự với
|
|
@@ -457,18 +487,24 @@ Hover/focus: `.leaf-tooltip-trigger` + `data-leaf-tooltip` + `data-content` (ho
|
|
|
457
487
|
`data-leaf-tooltip-trigger="click"` để bấm mở/đóng, `data-focusable` khi trigger là icon thuần
|
|
458
488
|
(không có phần tử focus được — leaf.js gắn `tabindex` / `role="button"`), `data-open-delay` /
|
|
459
489
|
`data-close-delay` (ms), `data-flip="false"` tắt tự lật phía khi thiếu chỗ. Bubble kế thừa
|
|
460
|
-
`data-theme` của khối bọc trigger.
|
|
490
|
+
`data-theme` của khối bọc trigger. leaf.js dựng bubble một lần ở lần hiện đầu tiên — đổi
|
|
491
|
+
`data-content` / `data-size` sau đó không có tác dụng (`data-position` / `data-align` / `data-flip`
|
|
492
|
+
thì đọc lại mỗi lần đặt vị trí). Bubble `pointer-events: none` — không đặt link / nút bên trong.
|
|
461
493
|
|
|
462
494
|
### Logo
|
|
463
495
|
|
|
464
496
|
Span rỗng `.leaf-logo` + `data-brand` / `data-mode` / `data-side` + `--leaf-logo-size`. CSS gắn
|
|
465
|
-
SVG data-URI — không cần JS.
|
|
497
|
+
SVG data-URI — không cần JS. Khác React, HTML tĩnh **không có mặc định**: wordmark phải đủ cả ba
|
|
498
|
+
attribute, và span phải rỗng tuyệt đối (`:empty` — không có khoảng trắng bên trong), thiếu là ra ô
|
|
499
|
+
trống. `data-mode` theo nền phía sau (`dark` = nền tối), không tự đổi theo `data-theme`. Bản CDN đã gộp sẵn data-URI; dùng qua npm thì import thêm
|
|
466
500
|
`logo-assets.css` (không nằm trong `classes.css` / `styles.css` vì component React không cần).
|
|
467
501
|
|
|
468
502
|
### Radio / Checkbox / Input
|
|
469
503
|
|
|
470
504
|
Chỉ CSS — markup như tab **Code → HTML tĩnh**. Input đọc `data-variant` / `data-shape` /
|
|
471
|
-
`data-invalid` / `data-disabled` trên `.leaf-input`.
|
|
505
|
+
`data-invalid` / `data-disabled` / `data-filled` trên `.leaf-input`. Không có JS nào tự set
|
|
506
|
+
`data-filled` (label đổi màu khi có giá trị) hay ẩn/hiện mật khẩu ở HTML tĩnh — cần thì trang tự
|
|
507
|
+
viết. Checkbox là một `<label>` bọc cả hàng: không đặt link bên trong.
|
|
472
508
|
|
|
473
509
|
### InputOtp
|
|
474
510
|
|
|
@@ -495,7 +531,9 @@ chạy hết đều đóng toast. Event `leaf:toast-show` / `leaf:toast-dismiss`
|
|
|
495
531
|
|
|
496
532
|
`data-leaf-dropdown` trên `.leaf-dropdown` (markup như tab **Code → HTML tĩnh**) + `data-variant` /
|
|
497
533
|
`data-trigger` / `data-appearance` / `data-size` / `data-align`; `data-open-on="hover"` để rê chuột
|
|
498
|
-
mở.
|
|
534
|
+
mở. CSS không suy trigger từ variant: `data-variant="radio"` cần kèm `data-trigger="text"` mới
|
|
535
|
+
giống React. Trigger `filled` có nền `--base-secondary` — đặt trên card `bg-secondary` thì dùng
|
|
536
|
+
`data-appearance="outlined"`. Option `.leaf-dropdown__option[data-value]`, mục chọn `aria-selected="true"`, disabled
|
|
499
537
|
`aria-disabled="true"`. `Leaf.dropdown.open` / `close` / `select(el, value)` ·
|
|
500
538
|
`leaf:dropdown-change`. Có `input.leaf-dropdown__input` thì leaf.js ghi value vào đó. Panel nằm ngay
|
|
501
539
|
dưới trigger (không portal) — tránh đặt trong khung `overflow: hidden / auto` thấp hơn panel.
|
|
@@ -538,6 +576,45 @@ Chỉ CSS. Skeleton: `--leaf-skeleton-width` / `height` / `radius`. Spinner: `da
|
|
|
538
576
|
|
|
539
577
|
## Changelog
|
|
540
578
|
|
|
579
|
+
### 0.1.9
|
|
580
|
+
|
|
581
|
+
**Thay đổi hành vi** (kiểm tra nếu app đang dựa vào hành vi cũ)
|
|
582
|
+
|
|
583
|
+
- `Dropdown` disabled: input ẩn (`name`) cũng `disabled` → **không còn gửi giá trị** trong
|
|
584
|
+
`FormData`, giống input native. React đổi ngay; leaf.js đồng bộ theo trigger `disabled` lúc
|
|
585
|
+
`init`.
|
|
586
|
+
- `Slider`: `aria-label` / `aria-labelledby` truyền vào `<Slider>` chuyển từ div gốc xuống control
|
|
587
|
+
`role="slider"` (trước đây control không có tên khi không có `title`). Có cả `title` lẫn
|
|
588
|
+
`aria-label` thì `aria-label` thắng.
|
|
589
|
+
- `Slider`: `style` của app giờ thắng biến lấy từ prop (`--leaf-slider-active` / `-mark` /
|
|
590
|
+
`-mark-active`); `--leaf-slider-fill` vẫn do component tính.
|
|
591
|
+
|
|
592
|
+
**Sửa lỗi**
|
|
593
|
+
|
|
594
|
+
- `Dropdown` (React): `aria-describedby` gắn lên trigger (combobox) thay vì div gốc — nối được text
|
|
595
|
+
lỗi với ô chọn.
|
|
596
|
+
- `Toggle`: `aria-disabled="true"` ra giao diện disabled (`toggle.css` đọc thêm
|
|
597
|
+
`[aria-disabled="true"]`) và React chặn đổi trạng thái như leaf.js; nút vẫn focus được.
|
|
598
|
+
- `InputDate`: `onValueChange` khai báo đúng `(value: Date) => void` (chưa bao giờ nhận `null`;
|
|
599
|
+
handler kiểu `(value: Date | null) => void` vẫn tương thích). Prop còn lại của `<button>`
|
|
600
|
+
(`aria-label`, `aria-labelledby`, `onBlur`, `onFocus`, `data-*`…) đi xuống nút trigger; `onClick`
|
|
601
|
+
của app chạy trước, `preventDefault()` thì không mở popover.
|
|
602
|
+
|
|
603
|
+
**Docs**
|
|
604
|
+
|
|
605
|
+
- Sửa tên token trong bảng docs (`$bg-*` → `$base-*` — biến thật là `--base-*`), snippet HTML gọi
|
|
606
|
+
`Leaf.*` trước khi leaf.js (`defer`) nạp xong, id không tồn tại trong markup (Checkbox, Dropdown,
|
|
607
|
+
Tabs, Tooltip), mô tả `position` của Tooltip, `data-filled` của Input, phụ thuộc `color.css` của
|
|
608
|
+
Calendar / InputDate, Spinner lồng trong Button (dùng `loading`).
|
|
609
|
+
- Ghi rõ: Button đang loading mang màu disabled (tạm khoá, có chủ đích); Dialog tĩnh phải là con
|
|
610
|
+
trực tiếp của `<body>` và bắt đầu bằng `hidden`; Logo tĩnh bắt buộc đủ `data-brand` /
|
|
611
|
+
`data-mode` / `data-side`; Slider tĩnh cần leaf.js để hiển thị đúng; khác biệt API Toast React ↔
|
|
612
|
+
leaf.js; link CDN dự phòng qua jsDelivr.
|
|
613
|
+
- `examples/static.html` đủ mọi component có bản HTML tĩnh (thêm Radio, Checkbox, Input, InputOtp,
|
|
614
|
+
InputStepper, Dropdown, Toast).
|
|
615
|
+
- Thêm Claude skill `skills/leaf-design-system` (dựng UI bằng Leaf + Tailwind cho Next.js / React /
|
|
616
|
+
landing page).
|
|
617
|
+
|
|
541
618
|
### 0.1.8
|
|
542
619
|
|
|
543
620
|
**Breaking**
|
package/dist/button.css
CHANGED
|
@@ -194,7 +194,8 @@
|
|
|
194
194
|
/*
|
|
195
195
|
* Loading — `data-loading="true"` (React: `loading` / onClick trả Promise; HTML tĩnh:
|
|
196
196
|
* `Leaf.button.setLoading`). Spinner thay leading icon, ăn --leaf-button-icon-size và
|
|
197
|
-
* màu ch
|
|
197
|
+
* màu chữ. Nút gắn `aria-disabled="true"` (không dùng `:disabled` để vẫn giữ focus) nên
|
|
198
|
+
* mang màu disabled như rule ở trên — có chủ đích: đang xử lý = tạm khoá.
|
|
198
199
|
*/
|
|
199
200
|
.leaf-button[data-loading="true"] {
|
|
200
201
|
cursor: progress;
|