@libs-ui/components-inputs-range-slider 0.2.355-14 → 0.2.355-15
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 +88 -2
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,3 +1,89 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Range Slider Component
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
`@libs-ui/components-inputs-range-slider` là một component cho phép người dùng chọn một giá trị từ một dải giá trị cho trước (range) bằng cách kéo thanh trượt. Component hỗ trợ nhiều chế độ hiển thị, nhãn giá trị động và tùy chỉnh bước nhảy (step).
|
|
4
|
+
|
|
5
|
+
## Tính năng nổi bật
|
|
6
|
+
|
|
7
|
+
- 🎚️ **Hai chế độ hiển thị**: Chế độ `slider` phổ thông và chế độ `audio` tối giản.
|
|
8
|
+
- 🏷️ **Nhãn giá trị động**: Tự động hiển thị giá trị hiện tại theo vị trí con trỏ chuột.
|
|
9
|
+
- 👁️ **Thông minh**: Tự động ẩn nhãn Min/Max khi nhãn giá trị hiện tại bị chồng lấp để đảm bảo tính thẩm mỹ.
|
|
10
|
+
- 🔢 **Định dạng số**: Hỗ trợ định dạng số theo ngôn ngữ thông qua thuộc tính `formatNumber`.
|
|
11
|
+
- 🛠️ **Tùy biến cao**: Cho phép cấu hình `min`, `max`, `step` và đơn vị đo (`unit`).
|
|
12
|
+
- 🎨 **Hiệu ứng mượt mà**: Sử dụng CSS variables để xử lý tiến độ (progress) và các hiệu ứng hover/focus.
|
|
13
|
+
|
|
14
|
+
## Cài đặt
|
|
15
|
+
|
|
16
|
+
Sử dụng npm hoặc yarn để cài đặt:
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
npm install @libs-ui/components-inputs-range-slider
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Cách sử dụng
|
|
23
|
+
|
|
24
|
+
### Import Module
|
|
25
|
+
|
|
26
|
+
```typescript
|
|
27
|
+
import { LibsUiComponentsInputsRangeSliderComponent } from '@libs-ui/components-inputs-range-slider';
|
|
28
|
+
|
|
29
|
+
@Component({
|
|
30
|
+
standalone: true,
|
|
31
|
+
imports: [LibsUiComponentsInputsRangeSliderComponent],
|
|
32
|
+
// ...
|
|
33
|
+
})
|
|
34
|
+
export class YourComponent {}
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### Ví dụ cơ bản
|
|
38
|
+
|
|
39
|
+
```html
|
|
40
|
+
<libs_ui-components-inputs-range_slider
|
|
41
|
+
[(value)]="volume"
|
|
42
|
+
[min]="0"
|
|
43
|
+
[max]="100"
|
|
44
|
+
[unit]="'%'"></libs_ui-components-inputs-range_slider>
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Chế độ âm thanh (Audio Mode)
|
|
48
|
+
|
|
49
|
+
```html
|
|
50
|
+
<libs_ui-components-inputs-range_slider
|
|
51
|
+
[(value)]="audioValue"
|
|
52
|
+
[mode]="'audio'"
|
|
53
|
+
[min]="0"
|
|
54
|
+
[max]="10"
|
|
55
|
+
[step]="0.5"></libs_ui-components-inputs-range_slider>
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## API Reference
|
|
59
|
+
|
|
60
|
+
### Inputs
|
|
61
|
+
|
|
62
|
+
| Thuộc tính | Kiểu dữ liệu | Mặc định | Mô tả |
|
|
63
|
+
| :--------------------- | :-------------------- | :-------------- | :----------------------------------------------- |
|
|
64
|
+
| `value` | `number` | **(Model)** `0` | Giá trị hiện tại của thanh trượt. |
|
|
65
|
+
| `mode` | `'audio' \| 'slider'` | `'slider'` | Chế độ hiển thị của slider. |
|
|
66
|
+
| `min` | `number` | `1` | Giá trị tối thiểu. |
|
|
67
|
+
| `max` | `number` | `100` | Giá trị tối đa. |
|
|
68
|
+
| `step` | `number` | `0` | Bước nhảy mỗi khi kéo (0 là kéo mượt). |
|
|
69
|
+
| `unit` | `string` | `undefined` | Đơn vị hiển thị sau giá trị (vd: %, px, $). |
|
|
70
|
+
| `disable` | `boolean` | `false` | Vô hiệu hóa tương tác. |
|
|
71
|
+
| `formatNumber` | `boolean` | `false` | Nếu `true`, định dạng số theo ngữ cảnh ngôn ngữ. |
|
|
72
|
+
| `hideProgressingValue` | `boolean` | `false` | Ẩn nhãn giá trị động phía trên thanh trượt. |
|
|
73
|
+
| `classInclude` | `string` | `undefined` | Class CSS bổ sung cho container. |
|
|
74
|
+
|
|
75
|
+
### Outputs
|
|
76
|
+
|
|
77
|
+
| Sự kiện | Kiểu dữ liệu | Mô tả |
|
|
78
|
+
| :---------- | :----------- | :----------------------------------------------------------------------- |
|
|
79
|
+
| `outChange` | `number` | Phát ra giá trị mới sau khi người dùng dừng kéo (có debounceTime 250ms). |
|
|
80
|
+
|
|
81
|
+
## Tech Stack
|
|
82
|
+
|
|
83
|
+
- **Core**: Angular 18+ (Signals & model)
|
|
84
|
+
- **Styling**: Vanilla SCSS
|
|
85
|
+
- **Utils**: `@libs-ui/utils`
|
|
86
|
+
|
|
87
|
+
## License
|
|
88
|
+
|
|
89
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@libs-ui/components-inputs-range-slider",
|
|
3
|
-
"version": "0.2.355-
|
|
3
|
+
"version": "0.2.355-15",
|
|
4
4
|
"peerDependencies": {
|
|
5
5
|
"@angular/core": ">=18.0.0",
|
|
6
|
-
"@libs-ui/interfaces-types": "0.2.355-
|
|
7
|
-
"@libs-ui/utils": "0.2.355-
|
|
6
|
+
"@libs-ui/interfaces-types": "0.2.355-15",
|
|
7
|
+
"@libs-ui/utils": "0.2.355-15",
|
|
8
8
|
"rxjs": "~7.8.0"
|
|
9
9
|
},
|
|
10
10
|
"sideEffects": false,
|