react-native-live-widgets 1.2.0 → 1.2.1
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/CHANGELOG.md +7 -0
- package/README.md +40 -1
- package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicWidgetCanvasRenderer.kt +443 -46
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +86 -28
- package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +126 -56
- package/android/src/main/res/layout/rn_live_widget_hit_zone.xml +16 -0
- package/android/src/main/res/layout/rn_live_widget_host.xml +16 -87
- package/docs/GUIDE-EN.md +241 -0
- package/docs/GUIDE-VI.md +266 -0
- package/docs/index.html +1140 -259
- package/docs/llms-full.txt +26 -0
- package/docs/llms.txt +8 -0
- package/ios/Models/DynamicLayoutModels.swift +6 -1
- package/ios/Renderer/DynamicNodeView.swift +169 -14
- package/ios/Widgets/DynamicHomeScreenWidget.swift +5 -0
- package/lib/builder.d.ts.map +1 -1
- package/lib/builder.js +65 -11
- package/lib/builder.js.map +1 -1
- package/lib/dispatcher.js +16 -10
- package/lib/dispatcher.js.map +1 -1
- package/lib/hooks.js +36 -31
- package/lib/hooks.js.map +1 -1
- package/lib/index.d.ts +17 -2
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +124 -50
- package/lib/index.js.map +1 -1
- package/lib/ir.d.ts +15 -0
- package/lib/ir.d.ts.map +1 -0
- package/lib/ir.js +379 -0
- package/lib/ir.js.map +1 -0
- package/lib/jsx.d.ts +9 -1
- package/lib/jsx.d.ts.map +1 -1
- package/lib/jsx.js +131 -84
- package/lib/jsx.js.map +1 -1
- package/lib/preview.d.ts +0 -23
- package/lib/preview.d.ts.map +1 -1
- package/lib/preview.js +373 -104
- package/lib/preview.js.map +1 -1
- package/lib/types.d.ts +204 -12
- package/lib/types.d.ts.map +1 -1
- package/lib/types.js +2 -1
- package/lib/types.js.map +1 -1
- package/package.json +2 -1
- package/src/builder.ts +57 -2
- package/src/index.ts +66 -1
- package/src/ir.ts +430 -0
- package/src/jsx.tsx +30 -0
- package/src/preview.tsx +356 -32
- package/src/react-native-env.d.ts +1 -0
- package/src/types.ts +253 -13
package/docs/index.html
CHANGED
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
<!DOCTYPE html>
|
|
2
|
-
<html lang="vi" class="dark">
|
|
2
|
+
<html lang="vi" class="dark scroll-smooth">
|
|
3
3
|
<head>
|
|
4
4
|
<meta charset="UTF-8">
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>react-native-live-widgets —
|
|
7
|
-
<meta name="description" content="All-in-One Declarative Engine for Live Activities, Dynamic Island
|
|
6
|
+
<title>react-native-live-widgets — Live Activities, Dynamic Island & Interactive Home Screen Widgets</title>
|
|
7
|
+
<meta name="description" content="All-in-One Declarative Engine & JSX for Live Activities, Dynamic Island and Interactive Home Screen Widgets in React Native & Expo without Swift/Kotlin.">
|
|
8
8
|
<link rel="icon" href="https://raw.githubusercontent.com/React-Native-Vu/react-native-live-widgets/dev/assets/dynamic_island_expanded.png" type="image/png">
|
|
9
|
+
|
|
9
10
|
<!-- Tailwind CSS CDN -->
|
|
10
11
|
<script src="https://cdn.tailwindcss.com"></script>
|
|
11
12
|
<script>
|
|
@@ -17,205 +18,504 @@
|
|
|
17
18
|
brand: {
|
|
18
19
|
50: '#F0F9FF',
|
|
19
20
|
100: '#E0F2FE',
|
|
20
|
-
|
|
21
|
+
400: '#38BDF8',
|
|
22
|
+
500: '#0EA5E9',
|
|
21
23
|
600: '#0284C7',
|
|
22
24
|
700: '#0369A1',
|
|
23
25
|
},
|
|
24
|
-
darkBg: '#
|
|
25
|
-
|
|
26
|
-
cardBorder: '#
|
|
26
|
+
darkBg: '#080C14',
|
|
27
|
+
darkCard: '#0F1626',
|
|
28
|
+
cardBorder: '#1E293B',
|
|
29
|
+
accentGlow: 'rgba(56, 189, 248, 0.15)',
|
|
30
|
+
},
|
|
31
|
+
animation: {
|
|
32
|
+
'pulse-slow': 'pulse 3s cubic-bezier(0.4, 0, 0.6, 1) infinite',
|
|
33
|
+
'float': 'float 4s ease-in-out infinite',
|
|
34
|
+
'glow': 'glow 3s ease-in-out infinite alternate',
|
|
35
|
+
},
|
|
36
|
+
keyframes: {
|
|
37
|
+
float: {
|
|
38
|
+
'0%, 100%': { transform: 'translateY(0px)' },
|
|
39
|
+
'50%': { transform: 'translateY(-6px)' },
|
|
40
|
+
},
|
|
41
|
+
glow: {
|
|
42
|
+
'0%': { boxShadow: '0 0 15px rgba(56, 189, 248, 0.2)' },
|
|
43
|
+
'100%': { boxShadow: '0 0 35px rgba(56, 189, 248, 0.45)' },
|
|
44
|
+
}
|
|
27
45
|
}
|
|
28
46
|
}
|
|
29
47
|
}
|
|
30
48
|
}
|
|
31
49
|
</script>
|
|
50
|
+
|
|
32
51
|
<!-- Lucide Icons -->
|
|
33
52
|
<script src="https://unpkg.com/lucide@latest"></script>
|
|
53
|
+
|
|
34
54
|
<!-- PrismJS for syntax highlighting -->
|
|
35
55
|
<link href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/themes/prism-tomorrow.min.css" rel="stylesheet" />
|
|
36
56
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/prism.min.js"></script>
|
|
37
57
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-typescript.min.js"></script>
|
|
58
|
+
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-jsx.min.js"></script>
|
|
59
|
+
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-tsx.min.js"></script>
|
|
38
60
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-bash.min.js"></script>
|
|
39
61
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-json.min.js"></script>
|
|
62
|
+
|
|
40
63
|
<style>
|
|
64
|
+
/* Custom Scrollbar */
|
|
65
|
+
::-webkit-scrollbar {
|
|
66
|
+
width: 6px;
|
|
67
|
+
height: 6px;
|
|
68
|
+
}
|
|
69
|
+
::-webkit-scrollbar-track {
|
|
70
|
+
background: #080C14;
|
|
71
|
+
}
|
|
72
|
+
::-webkit-scrollbar-thumb {
|
|
73
|
+
background: #1E293B;
|
|
74
|
+
border-radius: 9999px;
|
|
75
|
+
}
|
|
76
|
+
::-webkit-scrollbar-thumb:hover {
|
|
77
|
+
background: #334155;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/* Prism styling overhaul */
|
|
41
81
|
pre[class*="language-"] {
|
|
42
|
-
background: #
|
|
43
|
-
border: 1px solid #
|
|
44
|
-
border-radius: 0.
|
|
45
|
-
margin:
|
|
46
|
-
|
|
82
|
+
background: #0B111E !important;
|
|
83
|
+
border: 1px solid #1E293B;
|
|
84
|
+
border-radius: 0.85rem;
|
|
85
|
+
margin: 0 !important;
|
|
86
|
+
padding: 1.15rem !important;
|
|
87
|
+
font-size: 0.86rem;
|
|
88
|
+
line-height: 1.55;
|
|
47
89
|
}
|
|
48
90
|
code[class*="language-"] {
|
|
49
91
|
font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
|
|
50
92
|
}
|
|
51
|
-
|
|
52
|
-
|
|
93
|
+
|
|
94
|
+
/* Equalizer Sound Waves Keyframe */
|
|
95
|
+
@keyframes soundwave {
|
|
96
|
+
0%, 100% { height: 4px; }
|
|
97
|
+
50% { height: 26px; }
|
|
53
98
|
}
|
|
54
|
-
.
|
|
55
|
-
|
|
56
|
-
|
|
99
|
+
.eq-bar-1 { animation: soundwave 0.75s ease-in-out infinite; }
|
|
100
|
+
.eq-bar-2 { animation: soundwave 0.55s ease-in-out infinite 0.12s; }
|
|
101
|
+
.eq-bar-3 { animation: soundwave 0.9s ease-in-out infinite 0.25s; }
|
|
102
|
+
.eq-bar-4 { animation: soundwave 0.65s ease-in-out infinite 0.08s; }
|
|
103
|
+
.eq-bar-5 { animation: soundwave 0.8s ease-in-out infinite 0.18s; }
|
|
104
|
+
|
|
105
|
+
/* Dynamic Island Simulator Transition */
|
|
106
|
+
.island-container {
|
|
107
|
+
transition: all 0.4s cubic-bezier(0.16, 1, 0.3, 1);
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/* Subtle backdrop grid pattern */
|
|
111
|
+
.bg-grid-pattern {
|
|
112
|
+
background-size: 32px 32px;
|
|
113
|
+
background-image: linear-gradient(to right, rgba(255, 255, 255, 0.03) 1px, transparent 1px),
|
|
114
|
+
linear-gradient(to bottom, rgba(255, 255, 255, 0.03) 1px, transparent 1px);
|
|
57
115
|
}
|
|
58
116
|
</style>
|
|
59
117
|
</head>
|
|
60
118
|
<body class="bg-darkBg text-slate-200 min-h-screen flex flex-col font-sans antialiased selection:bg-sky-500 selection:text-white">
|
|
61
119
|
|
|
62
|
-
<!-- Top
|
|
63
|
-
<
|
|
120
|
+
<!-- Top Announcement Bar -->
|
|
121
|
+
<div class="bg-gradient-to-r from-sky-900/50 via-indigo-900/40 to-purple-900/50 border-b border-sky-500/20 py-2 px-4 text-center text-xs text-sky-200">
|
|
122
|
+
<span class="inline-flex items-center space-x-1.5 font-medium">
|
|
123
|
+
<span class="px-2 py-0.5 rounded-full bg-emerald-500/20 text-emerald-300 font-semibold text-[10px] uppercase tracking-wide">Mới v1.2.1</span>
|
|
124
|
+
<span>Exact Dynamic Hit Layer, Native Chronometer Countdown, Swift 6 Ready & Chuẩn hoá <strong>UI IR</strong></span>
|
|
125
|
+
<a href="#exact-hit-layer" class="underline hover:text-white ml-2">Xem chi tiết →</a>
|
|
126
|
+
</span>
|
|
127
|
+
</div>
|
|
128
|
+
|
|
129
|
+
<!-- Main Navigation Header -->
|
|
130
|
+
<header class="sticky top-0 z-50 backdrop-blur-xl bg-darkBg/85 border-b border-cardBorder">
|
|
64
131
|
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 h-16 flex items-center justify-between">
|
|
132
|
+
|
|
133
|
+
<!-- Brand Logo -->
|
|
65
134
|
<div class="flex items-center space-x-3">
|
|
66
|
-
<
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
135
|
+
<div class="w-9 h-9 rounded-xl bg-gradient-to-tr from-sky-500 to-indigo-600 flex items-center justify-center text-white shadow-lg shadow-sky-500/25">
|
|
136
|
+
<i data-lucide="layers" class="w-5 h-5"></i>
|
|
137
|
+
</div>
|
|
138
|
+
<div class="flex flex-col">
|
|
139
|
+
<a href="#" class="font-bold text-base sm:text-lg text-white hover:text-sky-400 transition leading-tight">
|
|
140
|
+
react-native-live-widgets
|
|
141
|
+
</a>
|
|
142
|
+
<span class="text-[11px] text-slate-400 hidden sm:inline">Declarative Widgets & Dynamic Island Engine</span>
|
|
143
|
+
</div>
|
|
144
|
+
<span class="inline-flex items-center px-2 py-0.5 rounded-md text-[11px] font-semibold bg-emerald-500/10 text-emerald-400 border border-emerald-500/20">
|
|
145
|
+
v1.2.1
|
|
75
146
|
</span>
|
|
76
147
|
</div>
|
|
77
148
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
<a href="#
|
|
81
|
-
|
|
82
|
-
<
|
|
83
|
-
<span>AI / llms.txt</span>
|
|
84
|
-
</a>
|
|
85
|
-
<a href="https://github.com/React-Native-Vu/LiveWidgetsExampleExpo" target="_blank" class="text-sm text-slate-300 hover:text-white hidden lg:inline">
|
|
86
|
-
Expo Demo
|
|
149
|
+
<!-- Nav Links & Search -->
|
|
150
|
+
<nav class="flex items-center space-x-3 sm:space-x-5">
|
|
151
|
+
<a href="#interactive-simulator" class="text-xs sm:text-sm text-slate-300 hover:text-white hidden lg:inline flex items-center space-x-1">
|
|
152
|
+
<i data-lucide="play-circle" class="w-4 h-4 text-sky-400"></i>
|
|
153
|
+
<span>Live Simulator</span>
|
|
87
154
|
</a>
|
|
88
|
-
<a href="
|
|
89
|
-
|
|
90
|
-
</a>
|
|
91
|
-
|
|
92
|
-
|
|
155
|
+
<a href="#quick-start" class="text-xs sm:text-sm text-slate-300 hover:text-white hidden md:inline">Cài đặt</a>
|
|
156
|
+
<a href="#dsl-catalog" class="text-xs sm:text-sm text-slate-300 hover:text-white hidden md:inline">UI DSL & JSX</a>
|
|
157
|
+
<a href="#core-api" class="text-xs sm:text-sm text-slate-300 hover:text-white hidden md:inline">API Reference</a>
|
|
158
|
+
|
|
159
|
+
<a href="#llms-ai" class="text-xs sm:text-sm text-sky-400 font-medium hover:text-sky-300 flex items-center space-x-1 px-2.5 py-1 rounded-lg bg-sky-500/10 border border-sky-500/20">
|
|
160
|
+
<i data-lucide="bot" class="w-4 h-4"></i>
|
|
161
|
+
<span>llms.txt</span>
|
|
93
162
|
</a>
|
|
163
|
+
|
|
164
|
+
<!-- GitHub Repo & Demo links -->
|
|
165
|
+
<div class="flex items-center space-x-1 border-l border-cardBorder pl-3">
|
|
166
|
+
<a href="https://github.com/React-Native-Vu/react-native-live-widgets" target="_blank" class="p-2 text-slate-400 hover:text-white transition rounded-lg hover:bg-slate-800" title="GitHub Repository">
|
|
167
|
+
<i data-lucide="github" class="w-5 h-5"></i>
|
|
168
|
+
</a>
|
|
169
|
+
<a href="https://www.npmjs.com/package/react-native-live-widgets" target="_blank" class="p-2 text-red-400 hover:text-red-300 transition rounded-lg hover:bg-slate-800" title="npm package">
|
|
170
|
+
<svg class="w-5 h-5 fill-current" viewBox="0 0 780 250"><path d="M240,250h100v-50h100V0H240V250z M340,50h50v100h-50V50z M480,0v200h100V50h50v150h50V50h50v150h50V0H480z M0,200h100V50h50v150h50V0H0V200z"/></svg>
|
|
171
|
+
</a>
|
|
172
|
+
</div>
|
|
94
173
|
</nav>
|
|
95
174
|
</div>
|
|
96
175
|
</header>
|
|
97
176
|
|
|
98
177
|
<!-- Hero Section -->
|
|
99
|
-
<section class="relative overflow-hidden pt-12 pb-16 lg:pt-20 lg:pb-24 border-b border-cardBorder bg-gradient-to-b from-sky-950/20 to-transparent">
|
|
100
|
-
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 text-center">
|
|
101
|
-
|
|
102
|
-
|
|
178
|
+
<section class="relative overflow-hidden pt-12 pb-16 lg:pt-20 lg:pb-24 border-b border-cardBorder bg-gradient-to-b from-sky-950/20 via-slate-900/40 to-transparent bg-grid-pattern">
|
|
179
|
+
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 text-center relative z-10">
|
|
180
|
+
|
|
181
|
+
<!-- Badges -->
|
|
182
|
+
<div class="inline-flex items-center space-x-2 px-3.5 py-1 rounded-full bg-slate-800/90 border border-slate-700/80 text-xs text-slate-300 mb-6 shadow-inner">
|
|
183
|
+
<span class="w-2 h-2 rounded-full bg-emerald-400 animate-pulse"></span>
|
|
184
|
+
<span>100% Declarative UI • Không viết Swift / Kotlin • Expo CNG Ready</span>
|
|
103
185
|
</div>
|
|
104
|
-
|
|
105
|
-
|
|
186
|
+
|
|
187
|
+
<!-- Main Headline -->
|
|
188
|
+
<h1 class="text-4xl sm:text-6xl lg:text-7xl font-extrabold text-white tracking-tight leading-tight sm:leading-none">
|
|
189
|
+
Live Activities & Dynamic Island <br class="hidden sm:inline">
|
|
106
190
|
<span class="text-transparent bg-clip-text bg-gradient-to-r from-sky-400 via-teal-300 to-indigo-400">
|
|
107
|
-
Chỉ
|
|
191
|
+
Chỉ với TypeScript & JSX
|
|
108
192
|
</span>
|
|
109
193
|
</h1>
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
194
|
+
|
|
195
|
+
<p class="mt-6 text-base sm:text-xl text-slate-300 max-w-3xl mx-auto font-normal leading-relaxed">
|
|
196
|
+
Giải pháp toàn diện All-in-One cho <strong>Live Activities</strong>, <strong>Dynamic Island</strong> và
|
|
197
|
+
<strong>Interactive Home Screen Widgets</strong> trên cả iOS & Android. Tích hợp sẵn bộ mô phỏng <code><WidgetPreview></code> và chuẩn dữ liệu mở cho AI Agent.
|
|
113
198
|
</p>
|
|
114
199
|
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
<
|
|
200
|
+
<!-- CTA Buttons -->
|
|
201
|
+
<div class="mt-8 flex flex-wrap justify-center items-center gap-4">
|
|
202
|
+
<a href="#quick-start" class="px-6 py-3.5 rounded-xl bg-sky-600 hover:bg-sky-500 text-white font-semibold shadow-lg shadow-sky-600/30 hover:shadow-sky-500/40 transition-all duration-200 flex items-center space-x-2">
|
|
203
|
+
<i data-lucide="zap" class="w-4 h-4"></i>
|
|
204
|
+
<span>Bắt đầu Cài đặt</span>
|
|
119
205
|
</a>
|
|
120
|
-
<a href="
|
|
121
|
-
<i data-lucide="
|
|
122
|
-
<span>
|
|
206
|
+
<a href="#interactive-simulator" class="px-6 py-3.5 rounded-xl bg-slate-800/90 hover:bg-slate-700 text-white border border-slate-700 font-semibold transition flex items-center space-x-2">
|
|
207
|
+
<i data-lucide="play" class="w-4 h-4 text-sky-400"></i>
|
|
208
|
+
<span>Trải nghiệm Live Simulator</span>
|
|
123
209
|
</a>
|
|
124
|
-
<a href="
|
|
125
|
-
<i data-lucide="
|
|
126
|
-
<span>
|
|
210
|
+
<a href="https://github.com/React-Native-Vu/LiveWidgetsExampleExpo" target="_blank" class="px-6 py-3.5 rounded-xl bg-indigo-950/70 hover:bg-indigo-900/80 text-indigo-300 border border-indigo-700/50 font-semibold transition flex items-center space-x-2">
|
|
211
|
+
<i data-lucide="smartphone" class="w-4 h-4"></i>
|
|
212
|
+
<span>Expo Sample App ↗</span>
|
|
127
213
|
</a>
|
|
128
214
|
</div>
|
|
215
|
+
|
|
216
|
+
<!-- Quick Command Bar -->
|
|
217
|
+
<div class="mt-8 max-w-lg mx-auto bg-slate-900/90 border border-slate-800 rounded-xl p-2 flex items-center justify-between text-xs sm:text-sm text-slate-300 font-mono">
|
|
218
|
+
<span class="px-2 text-sky-400 select-all">$ npm install react-native-live-widgets</span>
|
|
219
|
+
<button onclick="copyText('npm install react-native-live-widgets', this)" class="px-3 py-1.5 rounded-lg bg-slate-800 hover:bg-slate-700 text-slate-300 hover:text-white transition flex items-center space-x-1">
|
|
220
|
+
<i data-lucide="copy" class="w-3.5 h-3.5"></i>
|
|
221
|
+
<span>Copy</span>
|
|
222
|
+
</button>
|
|
223
|
+
</div>
|
|
224
|
+
|
|
225
|
+
</div>
|
|
226
|
+
</section>
|
|
227
|
+
|
|
228
|
+
<!-- Interactive Live Simulator Section (Mô phỏng thời gian thực) -->
|
|
229
|
+
<section id="interactive-simulator" class="py-16 border-b border-cardBorder bg-darkBg">
|
|
230
|
+
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
|
|
231
|
+
|
|
232
|
+
<div class="text-center max-w-3xl mx-auto mb-10">
|
|
233
|
+
<div class="inline-flex items-center space-x-1 text-xs font-semibold uppercase tracking-wider text-sky-400 mb-2">
|
|
234
|
+
<i data-lucide="sparkles" class="w-4 h-4"></i>
|
|
235
|
+
<span>Tương tác trực tiếp trên trình duyệt</span>
|
|
236
|
+
</div>
|
|
237
|
+
<h2 class="text-3xl sm:text-4xl font-extrabold text-white">
|
|
238
|
+
Live Simulator: Trải Nghiệm Widget & Dynamic Island
|
|
239
|
+
</h2>
|
|
240
|
+
<p class="mt-3 text-slate-400 text-sm sm:text-base">
|
|
241
|
+
Nhấp chuột vào các chế độ bên dưới để xem Dynamic Island co dãn, sóng âm Equalizer chuyển động và nút bấm Home Widget phản hồi tức thì!
|
|
242
|
+
</p>
|
|
243
|
+
</div>
|
|
244
|
+
|
|
245
|
+
<!-- Simulator Switcher Tabs -->
|
|
246
|
+
<div class="flex flex-wrap justify-center gap-2 mb-8">
|
|
247
|
+
<button onclick="switchSimulator('delivery')" id="btn-sim-delivery" class="sim-btn px-4 py-2 rounded-xl text-xs sm:text-sm font-semibold transition-all bg-sky-600 text-white shadow-lg shadow-sky-600/30 flex items-center space-x-2">
|
|
248
|
+
<i data-lucide="bike" class="w-4 h-4"></i>
|
|
249
|
+
<span>1. Giao đồ ăn (Dynamic Island)</span>
|
|
250
|
+
</button>
|
|
251
|
+
<button onclick="switchSimulator('music')" id="btn-sim-music" class="sim-btn px-4 py-2 rounded-xl text-xs sm:text-sm font-semibold transition-all bg-slate-800 text-slate-300 hover:text-white hover:bg-slate-700 border border-slate-700 flex items-center space-x-2">
|
|
252
|
+
<i data-lucide="music" class="w-4 h-4"></i>
|
|
253
|
+
<span>2. Sóng nhạc Equalizer</span>
|
|
254
|
+
</button>
|
|
255
|
+
<button onclick="switchSimulator('pomodoro')" id="btn-sim-pomodoro" class="sim-btn px-4 py-2 rounded-xl text-xs sm:text-sm font-semibold transition-all bg-slate-800 text-slate-300 hover:text-white hover:bg-slate-700 border border-slate-700 flex items-center space-x-2">
|
|
256
|
+
<i data-lucide="timer" class="w-4 h-4"></i>
|
|
257
|
+
<span>3. Bấm giờ Phần cứng (UI.Timer)</span>
|
|
258
|
+
</button>
|
|
259
|
+
<button onclick="switchSimulator('widget-interactive')" id="btn-sim-widget-interactive" class="sim-btn px-4 py-2 rounded-xl text-xs sm:text-sm font-semibold transition-all bg-slate-800 text-slate-300 hover:text-white hover:bg-slate-700 border border-slate-700 flex items-center space-x-2">
|
|
260
|
+
<i data-lucide="layout" class="w-4 h-4"></i>
|
|
261
|
+
<span>4. Home Widget Tương Tác 2 Chiều</span>
|
|
262
|
+
</button>
|
|
263
|
+
</div>
|
|
264
|
+
|
|
265
|
+
<!-- Main Simulator Mockup Canvas -->
|
|
266
|
+
<div class="max-w-4xl mx-auto bg-darkCard border border-cardBorder rounded-2xl p-6 sm:p-8 shadow-2xl relative">
|
|
267
|
+
<div class="grid grid-cols-1 lg:grid-cols-12 gap-8 items-center">
|
|
268
|
+
|
|
269
|
+
<!-- Virtual Phone Display Area -->
|
|
270
|
+
<div class="lg:col-span-6 flex flex-col items-center justify-center">
|
|
271
|
+
|
|
272
|
+
<!-- Dynamic Island Container -->
|
|
273
|
+
<div id="sim-island-box" class="w-full max-w-sm bg-black border border-slate-800 rounded-[28px] p-4 text-white shadow-2xl island-container transition-all duration-300 relative overflow-hidden">
|
|
274
|
+
<!-- Content injected via JS -->
|
|
275
|
+
</div>
|
|
276
|
+
|
|
277
|
+
<!-- Hint below phone -->
|
|
278
|
+
<p id="sim-hint" class="mt-4 text-xs text-slate-500 text-center flex items-center space-x-1">
|
|
279
|
+
<i data-lucide="info" class="w-3.5 h-3.5"></i>
|
|
280
|
+
<span>Nhấn vào các nút bên trong widget để thấy phản hồi tương tác!</span>
|
|
281
|
+
</p>
|
|
282
|
+
</div>
|
|
283
|
+
|
|
284
|
+
<!-- Code Snippet for Current Simulator State -->
|
|
285
|
+
<div class="lg:col-span-6 flex flex-col">
|
|
286
|
+
<div class="flex items-center justify-between mb-2">
|
|
287
|
+
<span id="sim-code-label" class="text-xs font-semibold text-slate-400 uppercase tracking-wider">
|
|
288
|
+
Mã TypeScript Declarative
|
|
289
|
+
</span>
|
|
290
|
+
<button onclick="copySimulatorCode()" class="text-xs text-sky-400 hover:text-sky-300 flex items-center space-x-1">
|
|
291
|
+
<i data-lucide="copy" class="w-3.5 h-3.5"></i>
|
|
292
|
+
<span>Copy Code</span>
|
|
293
|
+
</button>
|
|
294
|
+
</div>
|
|
295
|
+
<div class="relative">
|
|
296
|
+
<pre class="overflow-x-auto"><code id="sim-code" class="language-typescript">// Mã nguồn tương ứng
|
|
297
|
+
</code></pre>
|
|
298
|
+
</div>
|
|
299
|
+
</div>
|
|
300
|
+
|
|
301
|
+
</div>
|
|
302
|
+
</div>
|
|
303
|
+
|
|
129
304
|
</div>
|
|
130
305
|
</section>
|
|
131
306
|
|
|
132
|
-
<!--
|
|
133
|
-
<
|
|
307
|
+
<!-- Key Architecture Feature Grid -->
|
|
308
|
+
<section class="py-16 border-b border-cardBorder bg-slate-950/40">
|
|
309
|
+
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
|
|
310
|
+
|
|
311
|
+
<div class="text-center max-w-3xl mx-auto mb-12">
|
|
312
|
+
<h2 class="text-2xl sm:text-3xl font-bold text-white">Tại sao chọn `react-native-live-widgets`?</h2>
|
|
313
|
+
<p class="mt-2 text-slate-400 text-sm sm:text-base">Kiến trúc đột phá giúp phát triển Widget Native nhanh gấp 10 lần mà vẫn bảo toàn hiệu năng tối đa.</p>
|
|
314
|
+
</div>
|
|
315
|
+
|
|
316
|
+
<div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
|
|
317
|
+
|
|
318
|
+
<!-- Feature 1 -->
|
|
319
|
+
<div class="bg-darkCard border border-cardBorder hover:border-sky-500/40 rounded-2xl p-6 transition-all duration-200 hover:-translate-y-1">
|
|
320
|
+
<div class="w-12 h-12 rounded-xl bg-sky-500/10 border border-sky-500/20 text-sky-400 flex items-center justify-center mb-4">
|
|
321
|
+
<i data-lucide="code-2" class="w-6 h-6"></i>
|
|
322
|
+
</div>
|
|
323
|
+
<h3 class="text-lg font-bold text-white">100% Không Viết Swift / Kotlin</h3>
|
|
324
|
+
<p class="mt-2 text-sm text-slate-400 leading-relaxed">
|
|
325
|
+
Viết giao diện hoàn toàn bằng JavaScript/TypeScript hoặc cú pháp JSX. Thư viện tự động chuyển đổi thành cây Native AST cho WidgetKit và RemoteViews.
|
|
326
|
+
</p>
|
|
327
|
+
</div>
|
|
328
|
+
|
|
329
|
+
<!-- Feature 2 -->
|
|
330
|
+
<div class="bg-darkCard border border-cardBorder hover:border-emerald-500/40 rounded-2xl p-6 transition-all duration-200 hover:-translate-y-1">
|
|
331
|
+
<div class="w-12 h-12 rounded-xl bg-emerald-500/10 border border-emerald-500/20 text-emerald-400 flex items-center justify-center mb-4">
|
|
332
|
+
<i data-lucide="mouse-pointer-click" class="w-6 h-6"></i>
|
|
333
|
+
</div>
|
|
334
|
+
<h3 class="text-lg font-bold text-white">Tương Tác 2 Chiều (AppIntents)</h3>
|
|
335
|
+
<p class="mt-2 text-sm text-slate-400 leading-relaxed">
|
|
336
|
+
Nút bấm trên Home Widget kích hoạt trực tiếp hàm JavaScript trong React Native qua React Hook <code>useWidgetAction()</code> mà không cần mở toàn màn hình ứng dụng.
|
|
337
|
+
</p>
|
|
338
|
+
</div>
|
|
339
|
+
|
|
340
|
+
<!-- Feature 3 -->
|
|
341
|
+
<div class="bg-darkCard border border-cardBorder hover:border-amber-500/40 rounded-2xl p-6 transition-all duration-200 hover:-translate-y-1">
|
|
342
|
+
<div class="w-12 h-12 rounded-xl bg-amber-500/10 border border-amber-500/20 text-amber-400 flex items-center justify-center mb-4">
|
|
343
|
+
<i data-lucide="battery-charging" class="w-6 h-6"></i>
|
|
344
|
+
</div>
|
|
345
|
+
<h3 class="text-lg font-bold text-white">Timer Phần Cứng (0% Tiêu Hao Pin)</h3>
|
|
346
|
+
<p class="mt-2 text-sm text-slate-400 leading-relaxed">
|
|
347
|
+
<code>UI.Timer</code> tự động đếm giây mượt mà trên Dynamic Island dựa vào chip hệ thống của iOS/Android mà không làm thức giấc CPU hay hao tổn pin thiết bị.
|
|
348
|
+
</p>
|
|
349
|
+
</div>
|
|
350
|
+
|
|
351
|
+
<!-- Feature 4 -->
|
|
352
|
+
<div class="bg-darkCard border border-cardBorder hover:border-purple-500/40 rounded-2xl p-6 transition-all duration-200 hover:-translate-y-1">
|
|
353
|
+
<div class="w-12 h-12 rounded-xl bg-purple-500/10 border border-purple-500/20 text-purple-400 flex items-center justify-center mb-4">
|
|
354
|
+
<i data-lucide="radio" class="w-6 h-6"></i>
|
|
355
|
+
</div>
|
|
356
|
+
<h3 class="text-lg font-bold text-white">Sóng Nhạc Động (Equalizer)</h3>
|
|
357
|
+
<p class="mt-2 text-sm text-slate-400 leading-relaxed">
|
|
358
|
+
Duy nhất trên thị trường hỗ trợ hiệu ứng sóng âm thanh chuyển động liên tục cho ứng dụng nghe nhạc, podcast, radio trực tiếp trên Dynamic Island & Notification.
|
|
359
|
+
</p>
|
|
360
|
+
</div>
|
|
361
|
+
|
|
362
|
+
<!-- Feature 5 -->
|
|
363
|
+
<div class="bg-darkCard border border-cardBorder hover:border-indigo-500/40 rounded-2xl p-6 transition-all duration-200 hover:-translate-y-1">
|
|
364
|
+
<div class="w-12 h-12 rounded-xl bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center mb-4">
|
|
365
|
+
<i data-lucide="cloud-lightning" class="w-6 h-6"></i>
|
|
366
|
+
</div>
|
|
367
|
+
<h3 class="text-lg font-bold text-white">Đồng Bộ Ngầm Khi Kill App</h3>
|
|
368
|
+
<p class="mt-2 text-sm text-slate-400 leading-relaxed">
|
|
369
|
+
Hàm <code>Widget.setRemoteConfig()</code> cho phép cấu hình URL API ngầm để hệ điều hành iOS/Android tự động fetch dữ liệu mới cho Widget kể cả khi ứng dụng đã bị tắt.
|
|
370
|
+
</p>
|
|
371
|
+
</div>
|
|
372
|
+
|
|
373
|
+
<!-- Feature 6 -->
|
|
374
|
+
<div class="bg-darkCard border border-cardBorder hover:border-teal-500/40 rounded-2xl p-6 transition-all duration-200 hover:-translate-y-1">
|
|
375
|
+
<div class="w-12 h-12 rounded-xl bg-teal-500/10 border border-teal-500/20 text-teal-400 flex items-center justify-center mb-4">
|
|
376
|
+
<i data-lucide="bot" class="w-6 h-6"></i>
|
|
377
|
+
</div>
|
|
378
|
+
<h3 class="text-lg font-bold text-white">Chuẩn AI Agent (llms.txt)</h3>
|
|
379
|
+
<p class="mt-2 text-sm text-slate-400 leading-relaxed">
|
|
380
|
+
Sẵn sàng 100% cho ChatGPT, Claude Code, Cursor, Antigravity thông qua <code>llms.txt</code> và <code>SKILL.md</code>. Agent của bạn có thể tự lập trình widget không lỗi.
|
|
381
|
+
</p>
|
|
382
|
+
</div>
|
|
383
|
+
|
|
384
|
+
</div>
|
|
385
|
+
|
|
386
|
+
</div>
|
|
387
|
+
</section>
|
|
388
|
+
|
|
389
|
+
<!-- Main Content Layout with Sticky Sidebar -->
|
|
390
|
+
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12 flex-1 grid grid-cols-1 lg:grid-cols-4 gap-10">
|
|
134
391
|
|
|
135
392
|
<!-- Sidebar Navigation -->
|
|
136
|
-
<aside class="hidden lg:block lg:col-span-1 space-y-6 sticky top-24 h-[calc(100vh-8rem)] overflow-y-auto
|
|
393
|
+
<aside class="hidden lg:block lg:col-span-1 space-y-6 sticky top-24 h-[calc(100vh-8rem)] overflow-y-auto pr-2 text-sm">
|
|
394
|
+
|
|
137
395
|
<div>
|
|
138
|
-
<h4 class="text-xs font-
|
|
139
|
-
|
|
140
|
-
<
|
|
141
|
-
|
|
142
|
-
|
|
396
|
+
<h4 class="text-xs font-bold text-sky-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
|
|
397
|
+
<i data-lucide="rocket" class="w-4 h-4"></i>
|
|
398
|
+
<span>Bắt đầu</span>
|
|
399
|
+
</h4>
|
|
400
|
+
<ul class="space-y-1 border-l border-slate-800 pl-3">
|
|
401
|
+
<li><a href="#quick-start" class="text-slate-300 hover:text-white block py-1 transition">Cài đặt All-in-One CLI</a></li>
|
|
402
|
+
<li><a href="#expo-setup" class="text-slate-400 hover:text-white block py-1 transition">Expo (Config Plugin & CNG)</a></li>
|
|
403
|
+
<li><a href="#bare-rn-setup" class="text-slate-400 hover:text-white block py-1 transition">Bare React Native CLI</a></li>
|
|
143
404
|
</ul>
|
|
144
405
|
</div>
|
|
145
406
|
|
|
146
407
|
<div>
|
|
147
|
-
<h4 class="text-xs font-
|
|
148
|
-
|
|
149
|
-
<
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
<li><a href="#
|
|
153
|
-
<li><a href="#
|
|
408
|
+
<h4 class="text-xs font-bold text-sky-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
|
|
409
|
+
<i data-lucide="code" class="w-4 h-4"></i>
|
|
410
|
+
<span>Cú pháp & Engine</span>
|
|
411
|
+
</h4>
|
|
412
|
+
<ul class="space-y-1 border-l border-slate-800 pl-3">
|
|
413
|
+
<li><a href="#jsx-support" class="text-slate-400 hover:text-white block py-1 transition">Cú pháp JSX / TSX</a></li>
|
|
414
|
+
<li><a href="#exact-hit-layer" class="text-emerald-400 hover:text-white block py-1 transition font-medium">Exact Hit Layer & Chronometer (v1.2.1)</a></li>
|
|
415
|
+
<li><a href="#widget-preview-comp" class="text-slate-400 hover:text-white block py-1 transition">Mô phỏng <WidgetPreview></a></li>
|
|
416
|
+
<li><a href="#dsl-containers" class="text-slate-400 hover:text-white block py-1 transition">VStack, HStack, ZStack</a></li>
|
|
417
|
+
<li><a href="#dsl-timer" class="text-slate-400 hover:text-white block py-1 transition">UI.Timer (Đếm giờ phần cứng)</a></li>
|
|
418
|
+
<li><a href="#dsl-progress" class="text-slate-400 hover:text-white block py-1 transition">UI.Progress (Bar, Circular)</a></li>
|
|
419
|
+
<li><a href="#dsl-equalizer" class="text-slate-400 hover:text-white block py-1 transition">UI.Equalizer (Sóng âm)</a></li>
|
|
420
|
+
<li><a href="#dsl-interactive" class="text-slate-400 hover:text-white block py-1 transition">UI.Button & useWidgetAction</a></li>
|
|
154
421
|
</ul>
|
|
155
422
|
</div>
|
|
156
423
|
|
|
157
424
|
<div>
|
|
158
|
-
<h4 class="text-xs font-
|
|
159
|
-
|
|
160
|
-
<
|
|
161
|
-
|
|
425
|
+
<h4 class="text-xs font-bold text-sky-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
|
|
426
|
+
<i data-lucide="book-open" class="w-4 h-4"></i>
|
|
427
|
+
<span>Core API Reference</span>
|
|
428
|
+
</h4>
|
|
429
|
+
<ul class="space-y-1 border-l border-slate-800 pl-3">
|
|
430
|
+
<li><a href="#api-liveactivity" class="text-slate-400 hover:text-white block py-1 transition">LiveActivity API</a></li>
|
|
431
|
+
<li><a href="#api-widget" class="text-slate-400 hover:text-white block py-1 transition">Widget API (Multi-page)</a></li>
|
|
432
|
+
<li><a href="#api-remote-sync" class="text-slate-400 hover:text-white block py-1 transition">Remote API Sync (Kill App)</a></li>
|
|
433
|
+
<li><a href="#api-push-token" class="text-slate-400 hover:text-white block py-1 transition">APNs & FCM Push Tokens</a></li>
|
|
434
|
+
</ul>
|
|
435
|
+
</div>
|
|
436
|
+
|
|
437
|
+
<div>
|
|
438
|
+
<h4 class="text-xs font-bold text-indigo-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
|
|
439
|
+
<i data-lucide="bot" class="w-4 h-4"></i>
|
|
440
|
+
<span>AI Agent & LLMs</span>
|
|
441
|
+
</h4>
|
|
442
|
+
<ul class="space-y-1 border-l border-indigo-950 pl-3">
|
|
443
|
+
<li><a href="#llms-ai" class="text-slate-400 hover:text-white block py-1 transition">Chuẩn mở llms.txt</a></li>
|
|
444
|
+
<li><a href="#agent-skill" class="text-slate-400 hover:text-white block py-1 transition">Agent Skill (SKILL.md)</a></li>
|
|
162
445
|
</ul>
|
|
163
446
|
</div>
|
|
164
447
|
|
|
165
448
|
<div>
|
|
166
|
-
<h4 class="text-xs font-
|
|
167
|
-
|
|
168
|
-
<
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
<li><a href="
|
|
449
|
+
<h4 class="text-xs font-bold text-slate-500 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
|
|
450
|
+
<i data-lucide="external-link" class="w-4 h-4"></i>
|
|
451
|
+
<span>Tài nguyên ngoài</span>
|
|
452
|
+
</h4>
|
|
453
|
+
<ul class="space-y-1 border-l border-slate-800 pl-3 text-xs">
|
|
454
|
+
<li><a href="https://github.com/React-Native-Vu/LiveWidgetsExampleExpo" target="_blank" class="text-slate-400 hover:text-sky-300 block py-1">Expo Demo GitHub ↗</a></li>
|
|
455
|
+
<li><a href="https://github.com/React-Native-Vu/LiveWidgetsExample" target="_blank" class="text-slate-400 hover:text-sky-300 block py-1">Bare RN Demo GitHub ↗</a></li>
|
|
456
|
+
<li><a href="GUIDE-VI.md" target="_blank" class="text-slate-400 hover:text-sky-300 block py-1">Hướng Dẫn Chi Tiết (VI) ↗</a></li>
|
|
457
|
+
<li><a href="GUIDE-EN.md" target="_blank" class="text-slate-400 hover:text-sky-300 block py-1">English Full Guide ↗</a></li>
|
|
172
458
|
</ul>
|
|
173
459
|
</div>
|
|
460
|
+
|
|
174
461
|
</aside>
|
|
175
462
|
|
|
176
463
|
<!-- Main Content Area -->
|
|
177
|
-
<main class="lg:col-span-3 space-y-
|
|
464
|
+
<main class="lg:col-span-3 space-y-16">
|
|
178
465
|
|
|
179
466
|
<!-- Section: Quick Start -->
|
|
180
467
|
<section id="quick-start" class="space-y-6">
|
|
181
|
-
<
|
|
182
|
-
<
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
</
|
|
468
|
+
<div class="border-b border-cardBorder pb-4">
|
|
469
|
+
<h2 class="text-2xl sm:text-3xl font-extrabold text-white flex items-center space-x-2.5">
|
|
470
|
+
<i data-lucide="zap" class="w-7 h-7 text-sky-400"></i>
|
|
471
|
+
<span>Cài đặt & Thiết lập Tự động</span>
|
|
472
|
+
</h2>
|
|
473
|
+
<p class="mt-2 text-slate-400 text-sm sm:text-base">
|
|
474
|
+
Thư viện tích hợp sẵn bộ <strong>All-in-One CLI Scaffolder</strong> giúp cấu hình Xcode Widget Extension, App Groups và Android permissions chỉ với 1 câu lệnh duy nhất.
|
|
475
|
+
</p>
|
|
476
|
+
</div>
|
|
190
477
|
|
|
191
|
-
<!-- Expo
|
|
192
|
-
<div id="expo-setup" class="bg-
|
|
478
|
+
<!-- Expo Setup Card -->
|
|
479
|
+
<div id="expo-setup" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4 shadow-lg">
|
|
193
480
|
<div class="flex items-center justify-between">
|
|
194
|
-
<span class="font-bold text-white flex items-center space-x-2">
|
|
195
|
-
<span class="w-
|
|
196
|
-
<span>1. Quy trình dành cho Expo (SDK 50, 51, 52, 58+)</span>
|
|
481
|
+
<span class="font-bold text-white text-base sm:text-lg flex items-center space-x-2">
|
|
482
|
+
<span class="w-3 h-3 rounded-full bg-emerald-400"></span>
|
|
483
|
+
<span>1. Quy trình dành cho Expo (SDK 50, 51, 52, 58+ CNG)</span>
|
|
484
|
+
</span>
|
|
485
|
+
<span class="text-xs bg-emerald-500/10 text-emerald-400 px-2.5 py-1 rounded-full border border-emerald-500/20 font-semibold">
|
|
486
|
+
Config Plugin
|
|
197
487
|
</span>
|
|
198
|
-
<span class="text-xs bg-emerald-500/10 text-emerald-400 px-2 py-0.5 rounded border border-emerald-500/20">Config Plugin</span>
|
|
199
488
|
</div>
|
|
200
489
|
|
|
201
|
-
<
|
|
490
|
+
<p class="text-sm text-slate-300 leading-relaxed">
|
|
491
|
+
Thư viện tương thích 100% với <strong>Continuous Native Generation (CNG)</strong> và <strong>EAS Build</strong>:
|
|
492
|
+
</p>
|
|
493
|
+
|
|
494
|
+
<div class="relative">
|
|
495
|
+
<button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
|
|
496
|
+
<pre><code class="language-bash"># Bước 1: Cài đặt thư viện
|
|
202
497
|
npx expo install react-native-live-widgets
|
|
203
498
|
|
|
204
|
-
# Bước 2: Thêm plugin vào app.json
|
|
205
|
-
# (xem mẫu cấu hình bên dưới)
|
|
499
|
+
# Bước 2: Thêm plugin vào app.json (xem mẫu cấu hình bên dưới)
|
|
206
500
|
|
|
207
501
|
# Bước 3: Sinh thư mục native
|
|
208
502
|
npx expo prebuild
|
|
209
503
|
|
|
210
|
-
# Bước 4: Tự động
|
|
504
|
+
# Bước 4: Tự động khởi tạo Widget Extension target & App Groups
|
|
211
505
|
npx react-native-live-widgets init --group group.com.yourcompany.app
|
|
212
506
|
|
|
213
|
-
# Bước 5: Chạy ứng dụng trên
|
|
214
|
-
npx expo run:ios
|
|
507
|
+
# Bước 5: Chạy ứng dụng trên máy ảo
|
|
508
|
+
npx expo run:ios
|
|
509
|
+
npx expo run:android</code></pre>
|
|
510
|
+
</div>
|
|
215
511
|
|
|
216
|
-
<p class="text-xs text-slate-
|
|
217
|
-
<
|
|
512
|
+
<p class="text-xs font-semibold text-slate-300">Cấu hình Config Plugin trong tập tin <code class="text-sky-300">app.json</code>:</p>
|
|
513
|
+
<div class="relative">
|
|
514
|
+
<button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
|
|
515
|
+
<pre><code class="language-json">{
|
|
218
516
|
"expo": {
|
|
517
|
+
"name": "MyAwesomeApp",
|
|
518
|
+
"slug": "my-awesome-app",
|
|
219
519
|
"plugins": [
|
|
220
520
|
[
|
|
221
521
|
"react-native-live-widgets",
|
|
@@ -228,189 +528,422 @@ npx expo run:ios</code></pre>
|
|
|
228
528
|
]
|
|
229
529
|
}
|
|
230
530
|
}</code></pre>
|
|
531
|
+
</div>
|
|
231
532
|
</div>
|
|
232
533
|
|
|
233
|
-
<!-- Bare RN
|
|
234
|
-
<div id="bare-rn-setup" class="bg-
|
|
235
|
-
<
|
|
236
|
-
<span class="
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
534
|
+
<!-- Bare RN Setup Card -->
|
|
535
|
+
<div id="bare-rn-setup" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4 shadow-lg">
|
|
536
|
+
<div class="flex items-center justify-between">
|
|
537
|
+
<span class="font-bold text-white text-base sm:text-lg flex items-center space-x-2">
|
|
538
|
+
<span class="w-3 h-3 rounded-full bg-sky-400"></span>
|
|
539
|
+
<span>2. Quy trình dành cho Bare React Native CLI</span>
|
|
540
|
+
</span>
|
|
541
|
+
<span class="text-xs bg-sky-500/10 text-sky-400 px-2.5 py-1 rounded-full border border-sky-500/20 font-semibold">
|
|
542
|
+
CLI Auto-Link
|
|
543
|
+
</span>
|
|
544
|
+
</div>
|
|
545
|
+
|
|
546
|
+
<div class="relative">
|
|
547
|
+
<button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
|
|
548
|
+
<pre><code class="language-bash"># Cài đặt package
|
|
549
|
+
npm install react-native-live-widgets
|
|
550
|
+
|
|
551
|
+
# Tự động inject Xcode Widget Extension, Entitlements, Podfile và Android Manifest
|
|
241
552
|
npx react-native-live-widgets init --group group.com.yourcompany.app
|
|
242
|
-
|
|
553
|
+
|
|
554
|
+
# Khởi chạy dự án
|
|
555
|
+
npx react-native run-ios
|
|
556
|
+
npx react-native run-android</code></pre>
|
|
557
|
+
</div>
|
|
243
558
|
</div>
|
|
244
559
|
</section>
|
|
245
560
|
|
|
246
|
-
<!-- Section:
|
|
561
|
+
<!-- Section: JSX Syntax & WidgetPreview Component (v1.2.0) -->
|
|
562
|
+
<section id="jsx-support" class="space-y-6">
|
|
563
|
+
<div class="border-b border-cardBorder pb-4">
|
|
564
|
+
<div class="flex items-center space-x-2">
|
|
565
|
+
<span class="px-2.5 py-0.5 rounded-full text-xs font-bold bg-sky-500/20 text-sky-300 border border-sky-500/30 uppercase">v1.2.0 JSX</span>
|
|
566
|
+
<h2 class="text-2xl sm:text-3xl font-extrabold text-white">
|
|
567
|
+
Cú pháp JSX / TSX & Khung Xem Trước <code><WidgetPreview></code>
|
|
568
|
+
</h2>
|
|
569
|
+
</div>
|
|
570
|
+
<p class="mt-2 text-slate-400 text-sm sm:text-base">
|
|
571
|
+
Viết code widget tự nhiên như đang viết React Component thông thường với thẻ JSX và nhúng ngay vào ứng dụng để test giao diện mà không cần ra màn hình chính.
|
|
572
|
+
</p>
|
|
573
|
+
</div>
|
|
574
|
+
|
|
575
|
+
<div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
576
|
+
<h3 class="font-bold text-white text-base flex items-center space-x-2">
|
|
577
|
+
<i data-lucide="eye" class="w-5 h-5 text-sky-400"></i>
|
|
578
|
+
<span>Nhúng <WidgetPreview> vào App để xem trước kích thước Small, Medium, Large</span>
|
|
579
|
+
</h3>
|
|
580
|
+
|
|
581
|
+
<div class="relative">
|
|
582
|
+
<button onclick="copyCode(this)" class="absolute top-3 right-3 text-xs bg-slate-800 hover:bg-slate-700 text-slate-300 px-2.5 py-1 rounded-md border border-slate-700 transition">Copy</button>
|
|
583
|
+
<pre><code class="language-tsx">import React from 'react';
|
|
584
|
+
import { View } from 'react-native';
|
|
585
|
+
import {
|
|
586
|
+
WidgetPreview,
|
|
587
|
+
VStack,
|
|
588
|
+
HStack,
|
|
589
|
+
Text,
|
|
590
|
+
Badge,
|
|
591
|
+
Button,
|
|
592
|
+
Widget
|
|
593
|
+
} from 'react-native-live-widgets';
|
|
594
|
+
|
|
595
|
+
export default function HomeScreen() {
|
|
596
|
+
return (
|
|
597
|
+
<View style={{ flex: 1, padding: 16 }}>
|
|
598
|
+
{/* 1. Component Xem trước trực tiếp trong ứng dụng */}
|
|
599
|
+
<WidgetPreview
|
|
600
|
+
size="medium"
|
|
601
|
+
showBadge
|
|
602
|
+
interactiveSizeSwitch
|
|
603
|
+
onAction={(actionId) => console.log('User click button:', actionId)}
|
|
604
|
+
>
|
|
605
|
+
<VStack padding={16} backgroundColor="#0F172A" borderRadius={18}>
|
|
606
|
+
<HStack justifyContent="spaceBetween" alignItems="center">
|
|
607
|
+
<Text fontSize={15} fontWeight="bold" color="#FFFFFF">Ca Làm Việc Hôm Nay</Text>
|
|
608
|
+
<Badge text="08:00 - 17:30" backgroundColor="#064E3B" textColor="#6EE7B7" />
|
|
609
|
+
</HStack>
|
|
610
|
+
|
|
611
|
+
<Text fontSize={13} color="#94A3B8" margin={{ top: 8 }}>
|
|
612
|
+
Vị trí: Văn phòng Fastdo Đà Nẵng
|
|
613
|
+
</Text>
|
|
614
|
+
|
|
615
|
+
<Button
|
|
616
|
+
title="⚡ Check-in Ngay"
|
|
617
|
+
actionId="FASTDO_CHECKIN"
|
|
618
|
+
backgroundColor="#0284C7"
|
|
619
|
+
color="#FFFFFF"
|
|
620
|
+
margin={{ top: 12 }}
|
|
621
|
+
/>
|
|
622
|
+
</VStack>
|
|
623
|
+
</WidgetPreview>
|
|
624
|
+
</View>
|
|
625
|
+
);
|
|
626
|
+
}</code></pre>
|
|
627
|
+
</div>
|
|
628
|
+
</div>
|
|
629
|
+
</section>
|
|
630
|
+
|
|
631
|
+
<!-- Section: Exact Dynamic Hit Layer & Chronometer Countdown (v1.2.1) -->
|
|
632
|
+
<section id="exact-hit-layer" class="space-y-6">
|
|
633
|
+
<div class="border-b border-cardBorder pb-4">
|
|
634
|
+
<div class="flex items-center space-x-2">
|
|
635
|
+
<span class="px-2.5 py-0.5 rounded-full text-xs font-bold bg-emerald-500/20 text-emerald-300 border border-emerald-500/30 uppercase">v1.2.1 Mới</span>
|
|
636
|
+
<h2 class="text-2xl sm:text-3xl font-extrabold text-white">
|
|
637
|
+
Vùng Bấm Động Từng Pixel & Đồng Hồ Native Android
|
|
638
|
+
</h2>
|
|
639
|
+
</div>
|
|
640
|
+
<p class="mt-2 text-slate-400 text-sm sm:text-base">
|
|
641
|
+
Tối ưu độ chính xác cảm ứng 100% không lệch toạ độ, tích hợp Chronometer đếm ngược thời gian thực và tương thích hoàn toàn Swift 6.
|
|
642
|
+
</p>
|
|
643
|
+
</div>
|
|
644
|
+
|
|
645
|
+
<div class="grid grid-cols-1 md:grid-cols-2 gap-6">
|
|
646
|
+
<div class="bg-darkCard border border-cardBorder rounded-2xl p-5 space-y-3">
|
|
647
|
+
<h3 class="font-bold text-white text-base flex items-center space-x-2">
|
|
648
|
+
<i data-lucide="crosshair" class="w-5 h-5 text-emerald-400"></i>
|
|
649
|
+
<span>Exact Dynamic Hit Layer & Canvas Mapping</span>
|
|
650
|
+
</h3>
|
|
651
|
+
<p class="text-xs text-slate-400 leading-relaxed">
|
|
652
|
+
Thay thế hoàn toàn lưới chia ô cố định cũ bằng <code>FrameLayout</code> động (<code>rn_hit_layer</code>). Giải thuật <code>computeCanvasMapping</code> bù trừ viền co giãn <code>fitCenter</code>, giúp bấm trúng 100% nút, triệt tiêu mọi cú chạm ảo vào khoảng trống.
|
|
653
|
+
</p>
|
|
654
|
+
</div>
|
|
655
|
+
|
|
656
|
+
<div class="bg-darkCard border border-cardBorder rounded-2xl p-5 space-y-3">
|
|
657
|
+
<h3 class="font-bold text-white text-base flex items-center space-x-2">
|
|
658
|
+
<i data-lucide="timer" class="w-5 h-5 text-sky-400"></i>
|
|
659
|
+
<span>Native Chronometer Countdown (Android)</span>
|
|
660
|
+
</h3>
|
|
661
|
+
<p class="text-xs text-slate-400 leading-relaxed">
|
|
662
|
+
Tích hợp trực tiếp <code>android.widget.Chronometer</code> với <code>setChronometerCountDown(true)</code>. Đếm ngược giật lùi 1 giây/lần mượt mà ngay trên Home Screen mà không cần vẽ lại Canvas Bitmap, tiết kiệm tối đa pin.
|
|
663
|
+
</p>
|
|
664
|
+
</div>
|
|
665
|
+
</div>
|
|
666
|
+
</section>
|
|
667
|
+
|
|
668
|
+
<!-- Section: Declarative UI Catalog -->
|
|
247
669
|
<section id="dsl-catalog" class="space-y-6">
|
|
248
|
-
<
|
|
249
|
-
<
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
670
|
+
<div class="border-b border-cardBorder pb-4">
|
|
671
|
+
<h2 class="text-2xl sm:text-3xl font-extrabold text-white flex items-center space-x-2.5">
|
|
672
|
+
<i data-lucide="boxes" class="w-7 h-7 text-sky-400"></i>
|
|
673
|
+
<span>Declarative UI Engine Catalog (`UI.*`)</span>
|
|
674
|
+
</h2>
|
|
675
|
+
<p class="mt-2 text-slate-400 text-sm sm:text-base">
|
|
676
|
+
Nếu không dùng JSX, bạn có thể sử dụng bộ Builder API <code>UI.*</code> với đầy đủ TypeScript autocompletion:
|
|
677
|
+
</p>
|
|
678
|
+
</div>
|
|
255
679
|
|
|
256
|
-
<div class="grid grid-cols-1 md:grid-cols-2 gap-
|
|
257
|
-
|
|
258
|
-
|
|
680
|
+
<div class="grid grid-cols-1 md:grid-cols-2 gap-6">
|
|
681
|
+
|
|
682
|
+
<!-- UI.Timer -->
|
|
683
|
+
<div id="dsl-timer" class="bg-darkCard border border-cardBorder rounded-2xl p-5 space-y-3">
|
|
259
684
|
<div class="flex items-center justify-between">
|
|
260
|
-
<span class="
|
|
261
|
-
|
|
685
|
+
<span class="font-bold text-white text-base flex items-center space-x-2">
|
|
686
|
+
<i data-lucide="clock" class="w-4 h-4 text-sky-400"></i>
|
|
687
|
+
<span>UI.Timer — Đếm giờ Phần cứng</span>
|
|
688
|
+
</span>
|
|
689
|
+
<span class="text-[10px] text-sky-400 bg-sky-500/10 px-2 py-0.5 rounded font-mono">0% CPU</span>
|
|
690
|
+
</div>
|
|
691
|
+
<p class="text-xs text-slate-400">Tự động đếm lùi hoặc tiến theo thời gian thực:</p>
|
|
692
|
+
<div class="relative">
|
|
693
|
+
<button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
|
|
694
|
+
<pre><code class="language-typescript">UI.Timer({
|
|
695
|
+
// Đếm lùi từ 25 phút
|
|
696
|
+
targetTimestamp: Date.now() + 25 * 60 * 1000,
|
|
697
|
+
isCountDown: true,
|
|
698
|
+
color: '#38BDF8',
|
|
699
|
+
fontSize: 28,
|
|
700
|
+
fontWeight: 'heavy'
|
|
701
|
+
})</code></pre>
|
|
262
702
|
</div>
|
|
263
|
-
<pre><code class="language-typescript">await LiveActivity.start({
|
|
264
|
-
activityName: 'Delivery',
|
|
265
|
-
appGroup: 'group.com.myapp',
|
|
266
|
-
layout: UI.VStack({
|
|
267
|
-
padding: 16,
|
|
268
|
-
backgroundColor: '#0F172A',
|
|
269
|
-
children: [
|
|
270
|
-
UI.Text('Tài xế đang giao đơn', {
|
|
271
|
-
color: '#FFFFFF',
|
|
272
|
-
fontSize: 15,
|
|
273
|
-
fontWeight: 'bold'
|
|
274
|
-
}),
|
|
275
|
-
UI.Progress({
|
|
276
|
-
style: 'bar',
|
|
277
|
-
value: 0.7,
|
|
278
|
-
tintColor: '#38BDF8',
|
|
279
|
-
height: 6
|
|
280
|
-
})
|
|
281
|
-
]
|
|
282
|
-
}),
|
|
283
|
-
dynamicIsland: {
|
|
284
|
-
compactLeading: UI.Text('☕', { fontSize: 13 }),
|
|
285
|
-
compactTrailing: UI.Text('12m', { color: '#38BDF8', fontWeight: 'bold' }),
|
|
286
|
-
expanded: {
|
|
287
|
-
leading: UI.Text('COFFEE EXPRESS', { fontSize: 11 }),
|
|
288
|
-
trailing: UI.Text('12 mins', { fontSize: 16, fontWeight: 'bold' })
|
|
289
|
-
}
|
|
290
|
-
}
|
|
291
|
-
});</code></pre>
|
|
292
703
|
</div>
|
|
293
704
|
|
|
294
|
-
<!--
|
|
295
|
-
<div class="bg-
|
|
705
|
+
<!-- UI.Equalizer -->
|
|
706
|
+
<div id="dsl-equalizer" class="bg-darkCard border border-cardBorder rounded-2xl p-5 space-y-3">
|
|
296
707
|
<div class="flex items-center justify-between">
|
|
297
|
-
<span class="
|
|
298
|
-
|
|
708
|
+
<span class="font-bold text-white text-base flex items-center space-x-2">
|
|
709
|
+
<i data-lucide="activity" class="w-4 h-4 text-purple-400"></i>
|
|
710
|
+
<span>UI.Equalizer — Sóng nhạc liên tục</span>
|
|
711
|
+
</span>
|
|
712
|
+
<span class="text-[10px] text-purple-400 bg-purple-500/10 px-2 py-0.5 rounded font-mono">Realtime</span>
|
|
299
713
|
</div>
|
|
300
|
-
<
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
actionId: 'INCREMENT',
|
|
312
|
-
backgroundColor: '#0284C7',
|
|
313
|
-
color: '#FFFFFF'
|
|
314
|
-
})
|
|
315
|
-
]
|
|
316
|
-
})
|
|
317
|
-
});
|
|
318
|
-
|
|
319
|
-
// Cách 1: Dùng React Hook (Khuyến nghị - An toàn tuyệt đối với Fast Refresh)
|
|
320
|
-
useWidgetAction('INCREMENT', () => {
|
|
321
|
-
setCounter(c => c + 1);
|
|
322
|
-
});
|
|
714
|
+
<p class="text-xs text-slate-400">Hiển thị sóng âm chuyển động cho audio/podcast:</p>
|
|
715
|
+
<div class="relative">
|
|
716
|
+
<button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
|
|
717
|
+
<pre><code class="language-typescript">UI.Equalizer({
|
|
718
|
+
barCount: 5,
|
|
719
|
+
color: '#A855F7',
|
|
720
|
+
height: 20,
|
|
721
|
+
animated: true
|
|
722
|
+
})</code></pre>
|
|
723
|
+
</div>
|
|
724
|
+
</div>
|
|
323
725
|
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
726
|
+
<!-- UI.Progress -->
|
|
727
|
+
<div id="dsl-progress" class="bg-darkCard border border-cardBorder rounded-2xl p-5 space-y-3">
|
|
728
|
+
<div class="flex items-center justify-between">
|
|
729
|
+
<span class="font-bold text-white text-base flex items-center space-x-2">
|
|
730
|
+
<i data-lucide="bar-chart-2" class="w-4 h-4 text-emerald-400"></i>
|
|
731
|
+
<span>UI.Progress — Bar, Segmented & Circle</span>
|
|
732
|
+
</span>
|
|
733
|
+
<span class="text-[10px] text-emerald-400 bg-emerald-500/10 px-2 py-0.5 rounded font-mono">ProgressStyle</span>
|
|
734
|
+
</div>
|
|
735
|
+
<p class="text-xs text-slate-400">Thanh tiến trình đơn, chia chặng hoặc vòng tròn:</p>
|
|
736
|
+
<div class="relative">
|
|
737
|
+
<button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
|
|
738
|
+
<pre><code class="language-typescript">// Thanh chia chặng (Segmented)
|
|
739
|
+
UI.Progress({
|
|
740
|
+
style: 'segmented',
|
|
741
|
+
currentSegment: 2,
|
|
742
|
+
totalSegments: 4,
|
|
743
|
+
tintColor: '#10B981',
|
|
744
|
+
height: 6
|
|
745
|
+
})</code></pre>
|
|
746
|
+
</div>
|
|
330
747
|
</div>
|
|
331
748
|
|
|
332
|
-
<!--
|
|
333
|
-
<div class="bg-
|
|
749
|
+
<!-- UI.Button -->
|
|
750
|
+
<div id="dsl-interactive" class="bg-darkCard border border-cardBorder rounded-2xl p-5 space-y-3">
|
|
334
751
|
<div class="flex items-center justify-between">
|
|
335
|
-
<span class="
|
|
336
|
-
|
|
752
|
+
<span class="font-bold text-white text-base flex items-center space-x-2">
|
|
753
|
+
<i data-lucide="mouse-pointer" class="w-4 h-4 text-amber-400"></i>
|
|
754
|
+
<span>UI.Button & useWidgetAction</span>
|
|
755
|
+
</span>
|
|
756
|
+
<span class="text-[10px] text-amber-400 bg-amber-500/10 px-2 py-0.5 rounded font-mono">AppIntents</span>
|
|
337
757
|
</div>
|
|
338
|
-
<
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
// 2. Cập nhật Widget ra Home Screen bằng JSX trực tiếp:
|
|
352
|
-
await Widget.setLayout('main', {
|
|
353
|
-
medium: (
|
|
354
|
-
<VStack padding={16} backgroundColor="#0F172A" borderRadius={16}>
|
|
355
|
-
<Text fontSize={14} color="#FFF">Xin chào Trần Tuấn Vũ</Text>
|
|
356
|
-
<Button title="Check-in" actionId="checkin" />
|
|
357
|
-
</VStack>
|
|
358
|
-
)
|
|
758
|
+
<p class="text-xs text-slate-400">Nút bấm tương tác 2 chiều với React Native:</p>
|
|
759
|
+
<div class="relative">
|
|
760
|
+
<button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
|
|
761
|
+
<pre><code class="language-typescript">// 1. Đặt nút trong Widget
|
|
762
|
+
UI.Button({
|
|
763
|
+
title: 'Check-in',
|
|
764
|
+
actionId: 'ACTION_CHECKIN',
|
|
765
|
+
backgroundColor: '#0284C7'
|
|
766
|
+
});
|
|
767
|
+
|
|
768
|
+
// 2. Lắng nghe trong App bằng Hook
|
|
769
|
+
useWidgetAction('ACTION_CHECKIN', () => {
|
|
770
|
+
doCheckin();
|
|
359
771
|
});</code></pre>
|
|
772
|
+
</div>
|
|
360
773
|
</div>
|
|
774
|
+
|
|
361
775
|
</div>
|
|
362
776
|
</section>
|
|
363
777
|
|
|
364
|
-
<!-- Section:
|
|
365
|
-
<section id="
|
|
366
|
-
<div class="
|
|
367
|
-
<
|
|
368
|
-
<i data-lucide="
|
|
778
|
+
<!-- Section: Core API Reference -->
|
|
779
|
+
<section id="core-api" class="space-y-6">
|
|
780
|
+
<div class="border-b border-cardBorder pb-4">
|
|
781
|
+
<h2 class="text-2xl sm:text-3xl font-extrabold text-white flex items-center space-x-2.5">
|
|
782
|
+
<i data-lucide="book-marked" class="w-7 h-7 text-sky-400"></i>
|
|
783
|
+
<span>Core API Reference</span>
|
|
784
|
+
</h2>
|
|
785
|
+
<p class="mt-2 text-slate-400 text-sm sm:text-base">
|
|
786
|
+
Tài liệu chi tiết các phương thức cốt lõi của thư viện:
|
|
787
|
+
</p>
|
|
788
|
+
</div>
|
|
789
|
+
|
|
790
|
+
<!-- LiveActivity API -->
|
|
791
|
+
<div id="api-liveactivity" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
792
|
+
<div class="flex items-center justify-between">
|
|
793
|
+
<h3 class="text-lg font-bold text-white">LiveActivity API (iOS 16.1+ & Android 16 Live Updates)</h3>
|
|
794
|
+
<span class="text-xs bg-sky-500/10 text-sky-400 border border-sky-500/20 px-2.5 py-1 rounded-full">Core</span>
|
|
795
|
+
</div>
|
|
796
|
+
|
|
797
|
+
<div class="overflow-x-auto">
|
|
798
|
+
<table class="w-full text-left text-xs sm:text-sm border-collapse">
|
|
799
|
+
<thead>
|
|
800
|
+
<tr class="border-b border-cardBorder text-slate-400">
|
|
801
|
+
<th class="py-2.5 font-semibold">Hàm</th>
|
|
802
|
+
<th class="py-2.5 font-semibold">Tham số</th>
|
|
803
|
+
<th class="py-2.5 font-semibold">Mô tả</th>
|
|
804
|
+
</tr>
|
|
805
|
+
</thead>
|
|
806
|
+
<tbody class="divide-y divide-cardBorder text-slate-300">
|
|
807
|
+
<tr>
|
|
808
|
+
<td class="py-2.5 font-mono text-sky-400 font-medium">LiveActivity.start(config)</td>
|
|
809
|
+
<td class="py-2.5 text-xs text-slate-400 font-mono">LiveActivityStartConfig</td>
|
|
810
|
+
<td class="py-2.5">Bắt đầu một Live Activity và kích hoạt Dynamic Island. Trả về <code>activityId</code>.</td>
|
|
811
|
+
</tr>
|
|
812
|
+
<tr>
|
|
813
|
+
<td class="py-2.5 font-mono text-sky-400 font-medium">LiveActivity.update(id, data)</td>
|
|
814
|
+
<td class="py-2.5 text-xs text-slate-400 font-mono">id: string, data: object</td>
|
|
815
|
+
<td class="py-2.5">Cập nhật nội dung, tiến trình hoặc trạng thái Live Activity đang chạy.</td>
|
|
816
|
+
</tr>
|
|
817
|
+
<tr>
|
|
818
|
+
<td class="py-2.5 font-mono text-sky-400 font-medium">LiveActivity.end(id, finalState)</td>
|
|
819
|
+
<td class="py-2.5 text-xs text-slate-400 font-mono">id: string, dismissalPolicy?</td>
|
|
820
|
+
<td class="py-2.5">Kết thúc Live Activity (chính sách đóng: <code>default</code> hoặc <code>immediate</code>).</td>
|
|
821
|
+
</tr>
|
|
822
|
+
<tr>
|
|
823
|
+
<td class="py-2.5 font-mono text-sky-400 font-medium">LiveActivity.list()</td>
|
|
824
|
+
<td class="py-2.5 text-xs text-slate-400 font-mono">none</td>
|
|
825
|
+
<td class="py-2.5">Liệt kê tất cả các Live Activities hiện đang hoạt động.</td>
|
|
826
|
+
</tr>
|
|
827
|
+
<tr>
|
|
828
|
+
<td class="py-2.5 font-mono text-sky-400 font-medium">LiveActivity.getPushToken(id)</td>
|
|
829
|
+
<td class="py-2.5 text-xs text-slate-400 font-mono">id: string</td>
|
|
830
|
+
<td class="py-2.5">Lấy Activity Push Token để server có thể push cập nhật trực tiếp qua APNs/FCM.</td>
|
|
831
|
+
</tr>
|
|
832
|
+
</tbody>
|
|
833
|
+
</table>
|
|
834
|
+
</div>
|
|
835
|
+
</div>
|
|
836
|
+
|
|
837
|
+
<!-- Widget API -->
|
|
838
|
+
<div id="api-widget" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
839
|
+
<div class="flex items-center justify-between">
|
|
840
|
+
<h3 class="text-lg font-bold text-white">Widget API (Home Screen Widgets & App Groups)</h3>
|
|
841
|
+
<span class="text-xs bg-emerald-500/10 text-emerald-400 border border-emerald-500/20 px-2.5 py-1 rounded-full">WidgetKit</span>
|
|
369
842
|
</div>
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
<
|
|
843
|
+
|
|
844
|
+
<div class="overflow-x-auto">
|
|
845
|
+
<table class="w-full text-left text-xs sm:text-sm border-collapse">
|
|
846
|
+
<thead>
|
|
847
|
+
<tr class="border-b border-cardBorder text-slate-400">
|
|
848
|
+
<th class="py-2.5 font-semibold">Hàm</th>
|
|
849
|
+
<th class="py-2.5 font-semibold">Tham số</th>
|
|
850
|
+
<th class="py-2.5 font-semibold">Mô tả</th>
|
|
851
|
+
</tr>
|
|
852
|
+
</thead>
|
|
853
|
+
<tbody class="divide-y divide-cardBorder text-slate-300">
|
|
854
|
+
<tr>
|
|
855
|
+
<td class="py-2.5 font-mono text-emerald-400 font-medium">Widget.reload(kind, data)</td>
|
|
856
|
+
<td class="py-2.5 text-xs text-slate-400 font-mono">kind: string, data: WidgetData</td>
|
|
857
|
+
<td class="py-2.5">Cập nhật dữ liệu và yêu cầu hệ điều hành reload lại giao diện widget.</td>
|
|
858
|
+
</tr>
|
|
859
|
+
<tr>
|
|
860
|
+
<td class="py-2.5 font-mono text-emerald-400 font-medium">Widget.setLayout(kind, sizes)</td>
|
|
861
|
+
<td class="py-2.5 text-xs text-slate-400 font-mono">small?, medium?, large?</td>
|
|
862
|
+
<td class="py-2.5">Thiết lập bố cục riêng biệt cho từng kích cỡ widget (hỗ trợ cả JSX).</td>
|
|
863
|
+
</tr>
|
|
864
|
+
<tr>
|
|
865
|
+
<td class="py-2.5 font-mono text-emerald-400 font-medium">Widget.setRemoteConfig(config)</td>
|
|
866
|
+
<td class="py-2.5 text-xs text-slate-400 font-mono">RemoteFetchConfig</td>
|
|
867
|
+
<td class="py-2.5">Đăng ký URL API ngầm để hệ điều hành tự động kéo dữ liệu kể cả khi ứng dụng bị tắt.</td>
|
|
868
|
+
</tr>
|
|
869
|
+
<tr>
|
|
870
|
+
<td class="py-2.5 font-mono text-emerald-400 font-medium">Widget.pinWidget(kind)</td>
|
|
871
|
+
<td class="py-2.5 text-xs text-slate-400 font-mono">kind: string</td>
|
|
872
|
+
<td class="py-2.5">Hiển thị hộp thoại hệ thống ghim tiện ích ra Home Screen ngay trong App (Android).</td>
|
|
873
|
+
</tr>
|
|
874
|
+
</tbody>
|
|
875
|
+
</table>
|
|
373
876
|
</div>
|
|
374
877
|
</div>
|
|
375
878
|
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
879
|
+
</section>
|
|
880
|
+
|
|
881
|
+
<!-- Section: AI Agent & LLM Hub (llms.txt) -->
|
|
882
|
+
<section id="llms-ai" class="space-y-6">
|
|
883
|
+
<div class="border-b border-cardBorder pb-4 flex items-center justify-between">
|
|
884
|
+
<div class="flex items-center space-x-3">
|
|
885
|
+
<div class="p-2.5 rounded-xl bg-indigo-500/10 border border-indigo-500/20 text-indigo-400">
|
|
886
|
+
<i data-lucide="bot" class="w-6 h-6"></i>
|
|
887
|
+
</div>
|
|
888
|
+
<div>
|
|
889
|
+
<h2 class="text-2xl sm:text-3xl font-extrabold text-white">AI Agent & LLMs Hub</h2>
|
|
890
|
+
<p class="text-sm text-slate-400">Chuẩn hóa cho Claude Code, Antigravity, ChatGPT, Cursor Rules</p>
|
|
891
|
+
</div>
|
|
892
|
+
</div>
|
|
893
|
+
<span class="text-xs bg-indigo-500/10 text-indigo-300 border border-indigo-500/30 px-3 py-1 rounded-full font-semibold">
|
|
894
|
+
llms.txt Standard
|
|
895
|
+
</span>
|
|
896
|
+
</div>
|
|
897
|
+
|
|
898
|
+
<p class="text-slate-300 text-sm sm:text-base leading-relaxed">
|
|
899
|
+
Tài liệu của thư viện tuân thủ 100% đặc tả <strong><a href="https://llmstxt.org" target="_blank" class="text-sky-400 hover:underline">llms.txt</a></strong>.
|
|
900
|
+
Bất kỳ mô hình ngôn ngữ lớn hoặc coding agent nào cũng có thể đọc trực tiếp các file này qua URL để sinh mã widget chính xác, an toàn và không bị hallucination.
|
|
379
901
|
</p>
|
|
380
902
|
|
|
381
|
-
<div class="grid grid-cols-1 md:grid-cols-2 gap-
|
|
382
|
-
|
|
903
|
+
<div class="grid grid-cols-1 md:grid-cols-2 gap-6">
|
|
904
|
+
|
|
905
|
+
<!-- llms.txt card -->
|
|
906
|
+
<div class="bg-darkCard border border-indigo-900/40 rounded-2xl p-6 space-y-4">
|
|
383
907
|
<div class="flex items-center justify-between">
|
|
384
|
-
<span class="font-bold text-white flex items-center space-x-2">
|
|
385
|
-
<i data-lucide="file-text" class="w-
|
|
908
|
+
<span class="font-bold text-white text-base flex items-center space-x-2">
|
|
909
|
+
<i data-lucide="file-text" class="w-5 h-5 text-indigo-400"></i>
|
|
386
910
|
<span>Tập tin llms.txt</span>
|
|
387
911
|
</span>
|
|
388
|
-
<a href="llms.txt" target="_blank" class="text-xs bg-indigo-500/10
|
|
389
|
-
Xem
|
|
912
|
+
<a href="llms.txt" target="_blank" class="text-xs text-indigo-300 bg-indigo-500/10 border border-indigo-500/20 px-2.5 py-1 rounded-md hover:bg-indigo-500/20">
|
|
913
|
+
Xem trực tiếp ↗
|
|
390
914
|
</a>
|
|
391
915
|
</div>
|
|
392
|
-
<p class="text-xs text-slate-400">
|
|
393
|
-
|
|
916
|
+
<p class="text-xs text-slate-400 leading-relaxed">
|
|
917
|
+
Tóm tắt xúc tích về toàn bộ API, cheat sheet cấu trúc JSON AST và 5 quy tắc vàng giúp AI lập trình widget không lỗi.
|
|
394
918
|
</p>
|
|
395
|
-
<
|
|
919
|
+
<div class="relative">
|
|
920
|
+
<button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
|
|
921
|
+
<pre><code class="language-bash"># Nạp trực tiếp vào Prompt của Agent
|
|
922
|
+
curl -s https://react-native-vu.github.io/react-native-live-widgets/llms.txt</code></pre>
|
|
923
|
+
</div>
|
|
396
924
|
</div>
|
|
397
925
|
|
|
398
|
-
|
|
926
|
+
<!-- SKILL.md card -->
|
|
927
|
+
<div id="agent-skill" class="bg-darkCard border border-indigo-900/40 rounded-2xl p-6 space-y-4">
|
|
399
928
|
<div class="flex items-center justify-between">
|
|
400
|
-
<span class="font-bold text-white flex items-center space-x-2">
|
|
401
|
-
<i data-lucide="cpu" class="w-
|
|
929
|
+
<span class="font-bold text-white text-base flex items-center space-x-2">
|
|
930
|
+
<i data-lucide="cpu" class="w-5 h-5 text-sky-400"></i>
|
|
402
931
|
<span>Agent Skill (SKILL.md)</span>
|
|
403
932
|
</span>
|
|
404
|
-
<a href="https://github.com/React-Native-Vu/react-native-live-widgets/blob/dev/skills/react-native-live-widgets/SKILL.md" target="_blank" class="text-xs bg-sky-500/10
|
|
405
|
-
|
|
933
|
+
<a href="https://github.com/React-Native-Vu/react-native-live-widgets/blob/dev/skills/react-native-live-widgets/SKILL.md" target="_blank" class="text-xs text-sky-300 bg-sky-500/10 border border-sky-500/20 px-2.5 py-1 rounded-md hover:bg-sky-500/20">
|
|
934
|
+
GitHub SKILL.md ↗
|
|
406
935
|
</a>
|
|
407
936
|
</div>
|
|
408
|
-
<p class="text-xs text-slate-400">
|
|
409
|
-
Tương thích trực tiếp với các
|
|
937
|
+
<p class="text-xs text-slate-400 leading-relaxed">
|
|
938
|
+
Tương thích trực tiếp với các framework Agent như Antigravity, Claude Code, Cursor Rules để kích hoạt theo ngữ cảnh của lập trình viên.
|
|
410
939
|
</p>
|
|
411
|
-
<
|
|
940
|
+
<div class="relative">
|
|
941
|
+
<button onclick="copyCode(this)" class="absolute top-2 right-2 text-xs bg-slate-800 text-slate-300 px-2 py-0.5 rounded">Copy</button>
|
|
942
|
+
<pre><code class="language-bash"># Lưu vào thư mục agent trong repo của bạn:
|
|
412
943
|
.agents/skills/react-native-live-widgets/SKILL.md</code></pre>
|
|
944
|
+
</div>
|
|
413
945
|
</div>
|
|
946
|
+
|
|
414
947
|
</div>
|
|
415
948
|
</section>
|
|
416
949
|
|
|
@@ -418,23 +951,371 @@ await Widget.setLayout('main', {
|
|
|
418
951
|
</div>
|
|
419
952
|
|
|
420
953
|
<!-- Footer -->
|
|
421
|
-
<footer class="border-t border-cardBorder bg-
|
|
422
|
-
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 flex flex-col
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
<
|
|
954
|
+
<footer class="border-t border-cardBorder bg-slate-950/80 py-12 mt-16">
|
|
955
|
+
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 flex flex-col md:flex-row items-center justify-between gap-6 text-xs text-slate-400">
|
|
956
|
+
|
|
957
|
+
<div class="flex items-center space-x-3">
|
|
958
|
+
<div class="w-8 h-8 rounded-lg bg-sky-600/20 text-sky-400 flex items-center justify-center font-bold">
|
|
959
|
+
⚡
|
|
960
|
+
</div>
|
|
961
|
+
<div>
|
|
962
|
+
<p class="text-slate-300 font-medium">react-native-live-widgets — Phát triển bởi <strong>Trần Tuấn Vũ</strong></p>
|
|
963
|
+
<p class="text-[11px] text-slate-500">Giấy phép mã nguồn mở MIT • Sẵn sàng cho Production</p>
|
|
964
|
+
</div>
|
|
426
965
|
</div>
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
<a href="
|
|
430
|
-
|
|
966
|
+
|
|
967
|
+
<div class="flex flex-wrap items-center gap-6">
|
|
968
|
+
<a href="https://github.com/React-Native-Vu/react-native-live-widgets" target="_blank" class="hover:text-white transition flex items-center space-x-1">
|
|
969
|
+
<i data-lucide="github" class="w-4 h-4"></i>
|
|
970
|
+
<span>GitHub</span>
|
|
971
|
+
</a>
|
|
972
|
+
<a href="https://www.npmjs.com/package/react-native-live-widgets" target="_blank" class="hover:text-white transition">npm package</a>
|
|
973
|
+
<a href="llms.txt" class="hover:text-white transition font-mono text-sky-400">llms.txt</a>
|
|
974
|
+
<a href="llms-full.txt" class="hover:text-white transition font-mono">llms-full.txt</a>
|
|
975
|
+
<a href="GUIDE-VI.md" class="hover:text-white transition">Tài liệu tiếng Việt</a>
|
|
976
|
+
<a href="GUIDE-EN.md" class="hover:text-white transition">English Guide</a>
|
|
431
977
|
</div>
|
|
978
|
+
|
|
432
979
|
</div>
|
|
433
980
|
</footer>
|
|
434
981
|
|
|
982
|
+
<!-- Floating Back to Top Button -->
|
|
983
|
+
<button id="back-to-top" onclick="window.scrollTo({top: 0, behavior: 'smooth'})" class="fixed bottom-6 right-6 p-3 rounded-full bg-slate-800/90 text-slate-300 hover:text-white border border-slate-700 shadow-xl opacity-0 pointer-events-none transition-all duration-300 z-50">
|
|
984
|
+
<i data-lucide="arrow-up" class="w-5 h-5"></i>
|
|
985
|
+
</button>
|
|
986
|
+
|
|
987
|
+
<!-- Interactive Simulator & Utility Scripts -->
|
|
435
988
|
<script>
|
|
436
|
-
//
|
|
437
|
-
|
|
989
|
+
// State of Simulator
|
|
990
|
+
let currentSimState = 'delivery';
|
|
991
|
+
let counterValue = 42;
|
|
992
|
+
let timerSeconds = 1495; // 24:55
|
|
993
|
+
let timerInterval = null;
|
|
994
|
+
|
|
995
|
+
// Simulator Data Definitions
|
|
996
|
+
const simulatorPresets = {
|
|
997
|
+
delivery: {
|
|
998
|
+
codeLabel: 'TypeScript — LiveActivity.start() & Dynamic Island',
|
|
999
|
+
render: () => `
|
|
1000
|
+
<div class="flex flex-col space-y-3">
|
|
1001
|
+
<div class="flex items-center justify-between text-xs text-slate-400">
|
|
1002
|
+
<span class="flex items-center space-x-1 text-sky-400 font-semibold">
|
|
1003
|
+
<i data-lucide="bike" class="w-4 h-4"></i>
|
|
1004
|
+
<span>Fastdo Express</span>
|
|
1005
|
+
</span>
|
|
1006
|
+
<span class="bg-sky-500/20 text-sky-300 px-2 py-0.5 rounded-full text-[10px] font-bold">12 phút nữa</span>
|
|
1007
|
+
</div>
|
|
1008
|
+
|
|
1009
|
+
<div class="flex items-center justify-between">
|
|
1010
|
+
<div>
|
|
1011
|
+
<p class="font-bold text-base text-white">Tài xế đang giao cà phê</p>
|
|
1012
|
+
<p class="text-xs text-slate-400">Nguyễn Văn A • Winner X (43-D1 888.88)</p>
|
|
1013
|
+
</div>
|
|
1014
|
+
<span class="text-2xl">☕</span>
|
|
1015
|
+
</div>
|
|
1016
|
+
|
|
1017
|
+
<!-- Progress Bar -->
|
|
1018
|
+
<div class="w-full bg-slate-800 rounded-full h-2.5 overflow-hidden">
|
|
1019
|
+
<div class="bg-gradient-to-r from-sky-400 to-teal-400 h-2.5 rounded-full" style="width: 75%"></div>
|
|
1020
|
+
</div>
|
|
1021
|
+
|
|
1022
|
+
<div class="flex justify-between text-[11px] text-slate-400">
|
|
1023
|
+
<span>Đã nhận đơn</span>
|
|
1024
|
+
<span>Đang pha chế</span>
|
|
1025
|
+
<span class="text-sky-300 font-bold">Đang giao</span>
|
|
1026
|
+
<span>Đến nơi</span>
|
|
1027
|
+
</div>
|
|
1028
|
+
</div>
|
|
1029
|
+
`,
|
|
1030
|
+
code: `await LiveActivity.start({
|
|
1031
|
+
activityName: 'DeliveryTracking',
|
|
1032
|
+
appGroup: 'group.com.fastdo.app',
|
|
1033
|
+
layout: UI.VStack({
|
|
1034
|
+
padding: 16,
|
|
1035
|
+
backgroundColor: '#0F172A',
|
|
1036
|
+
children: [
|
|
1037
|
+
UI.HStack({
|
|
1038
|
+
justifyContent: 'spaceBetween',
|
|
1039
|
+
children: [
|
|
1040
|
+
UI.Text('Fastdo Express', { color: '#38BDF8', fontWeight: 'bold' }),
|
|
1041
|
+
UI.Text('12 phút nữa', { color: '#FFFFFF' })
|
|
1042
|
+
]
|
|
1043
|
+
}),
|
|
1044
|
+
UI.Text('Tài xế đang giao cà phê', { fontSize: 16, fontWeight: 'bold' }),
|
|
1045
|
+
UI.Progress({ style: 'bar', value: 0.75, tintColor: '#38BDF8' })
|
|
1046
|
+
]
|
|
1047
|
+
}),
|
|
1048
|
+
dynamicIsland: {
|
|
1049
|
+
compactLeading: UI.Text('☕', { fontSize: 13 }),
|
|
1050
|
+
compactTrailing: UI.Text('12m', { color: '#38BDF8', fontWeight: 'bold' }),
|
|
1051
|
+
expanded: {
|
|
1052
|
+
leading: UI.Text('COFFEE EXPRESS', { fontSize: 11 }),
|
|
1053
|
+
trailing: UI.Text('12 mins', { fontSize: 15, fontWeight: 'bold' })
|
|
1054
|
+
}
|
|
1055
|
+
}
|
|
1056
|
+
});`
|
|
1057
|
+
},
|
|
1058
|
+
|
|
1059
|
+
music: {
|
|
1060
|
+
codeLabel: 'TypeScript — UI.Equalizer & Dynamic Island Expanded',
|
|
1061
|
+
render: () => `
|
|
1062
|
+
<div class="flex flex-col space-y-3">
|
|
1063
|
+
<div class="flex items-center justify-between text-xs text-purple-400 font-semibold">
|
|
1064
|
+
<span class="flex items-center space-x-1">
|
|
1065
|
+
<i data-lucide="radio" class="w-4 h-4"></i>
|
|
1066
|
+
<span>Apple Music / Spotify Live</span>
|
|
1067
|
+
</span>
|
|
1068
|
+
<span class="text-[10px] text-purple-300 bg-purple-900/40 px-2 py-0.5 rounded-full">Lossless 24-bit</span>
|
|
1069
|
+
</div>
|
|
1070
|
+
|
|
1071
|
+
<div class="flex items-center space-x-4">
|
|
1072
|
+
<!-- Album cover -->
|
|
1073
|
+
<div class="w-12 h-12 rounded-xl bg-gradient-to-tr from-purple-600 to-pink-500 flex items-center justify-center text-white shadow-lg">
|
|
1074
|
+
<i data-lucide="disc" class="w-6 h-6 animate-spin" style="animation-duration: 8s;"></i>
|
|
1075
|
+
</div>
|
|
1076
|
+
<div class="flex-1 min-w-0">
|
|
1077
|
+
<p class="font-bold text-sm text-white truncate">Chạy Ngay Đi (Acoustic Version)</p>
|
|
1078
|
+
<p class="text-xs text-slate-400 truncate">Sơn Tùng M-TP</p>
|
|
1079
|
+
</div>
|
|
1080
|
+
<!-- Animated Equalizer Waves -->
|
|
1081
|
+
<div class="flex items-end space-x-1 h-7 px-2">
|
|
1082
|
+
<div class="w-1 bg-purple-400 rounded-full eq-bar-1"></div>
|
|
1083
|
+
<div class="w-1 bg-purple-400 rounded-full eq-bar-2"></div>
|
|
1084
|
+
<div class="w-1 bg-purple-300 rounded-full eq-bar-3"></div>
|
|
1085
|
+
<div class="w-1 bg-purple-400 rounded-full eq-bar-4"></div>
|
|
1086
|
+
<div class="w-1 bg-pink-400 rounded-full eq-bar-5"></div>
|
|
1087
|
+
</div>
|
|
1088
|
+
</div>
|
|
1089
|
+
|
|
1090
|
+
<div class="flex items-center justify-between pt-1">
|
|
1091
|
+
<span class="text-[10px] text-slate-400 font-mono">01:45</span>
|
|
1092
|
+
<div class="flex-1 mx-3 bg-slate-800 rounded-full h-1.5 overflow-hidden">
|
|
1093
|
+
<div class="bg-purple-500 h-1.5 rounded-full" style="width: 45%"></div>
|
|
1094
|
+
</div>
|
|
1095
|
+
<span class="text-[10px] text-slate-400 font-mono">03:52</span>
|
|
1096
|
+
</div>
|
|
1097
|
+
</div>
|
|
1098
|
+
`,
|
|
1099
|
+
code: `// Dynamic Island phát nhạc với sóng âm Equalizer tự động
|
|
1100
|
+
await LiveActivity.start({
|
|
1101
|
+
activityName: 'MusicPlayer',
|
|
1102
|
+
appGroup: 'group.com.myapp',
|
|
1103
|
+
dynamicIsland: {
|
|
1104
|
+
compactLeading: UI.Text('🎵', { fontSize: 13 }),
|
|
1105
|
+
compactTrailing: UI.Equalizer({
|
|
1106
|
+
barCount: 4,
|
|
1107
|
+
color: '#A855F7',
|
|
1108
|
+
height: 14
|
|
1109
|
+
}),
|
|
1110
|
+
expanded: {
|
|
1111
|
+
leading: UI.Text('Chạy Ngay Đi', { fontWeight: 'bold' }),
|
|
1112
|
+
trailing: UI.Equalizer({
|
|
1113
|
+
barCount: 5,
|
|
1114
|
+
color: '#A855F7',
|
|
1115
|
+
height: 22
|
|
1116
|
+
})
|
|
1117
|
+
}
|
|
1118
|
+
}
|
|
1119
|
+
});`
|
|
1120
|
+
},
|
|
1121
|
+
|
|
1122
|
+
pomodoro: {
|
|
1123
|
+
codeLabel: 'TypeScript — UI.Timer (Phần Cứng Không Tốn Pin)',
|
|
1124
|
+
render: () => {
|
|
1125
|
+
const m = String(Math.floor(timerSeconds / 60)).padStart(2, '0');
|
|
1126
|
+
const s = String(timerSeconds % 60).padStart(2, '0');
|
|
1127
|
+
return `
|
|
1128
|
+
<div class="flex flex-col items-center py-2 space-y-3">
|
|
1129
|
+
<div class="flex items-center space-x-2 text-xs text-amber-400 font-semibold">
|
|
1130
|
+
<i data-lucide="flame" class="w-4 h-4"></i>
|
|
1131
|
+
<span>POMODORO FOCUS SESSION</span>
|
|
1132
|
+
</div>
|
|
1133
|
+
<div class="text-4xl font-extrabold text-white font-mono tracking-wider text-sky-400" id="live-timer-display">
|
|
1134
|
+
${m}:${s}
|
|
1135
|
+
</div>
|
|
1136
|
+
<p class="text-xs text-slate-400">Bộ đếm phần cứng iOS/Android Native Timer</p>
|
|
1137
|
+
<div class="flex space-x-2 mt-2">
|
|
1138
|
+
<button onclick="resetTimer()" class="px-3 py-1 bg-slate-800 hover:bg-slate-700 text-xs rounded-lg text-slate-300">Reset 25m</button>
|
|
1139
|
+
</div>
|
|
1140
|
+
</div>
|
|
1141
|
+
`;
|
|
1142
|
+
},
|
|
1143
|
+
code: `// Tự động đếm lùi 25 phút mượt mà mà KHÔNG hao tổn 1% pin nào!
|
|
1144
|
+
UI.Timer({
|
|
1145
|
+
targetTimestamp: Date.now() + 25 * 60 * 1000,
|
|
1146
|
+
isCountDown: true,
|
|
1147
|
+
color: '#38BDF8',
|
|
1148
|
+
fontSize: 32,
|
|
1149
|
+
fontWeight: 'heavy'
|
|
1150
|
+
})`
|
|
1151
|
+
},
|
|
1152
|
+
|
|
1153
|
+
'widget-interactive': {
|
|
1154
|
+
codeLabel: 'TypeScript / JSX — Home Screen Widget Tương Tác 2 Chiều',
|
|
1155
|
+
render: () => `
|
|
1156
|
+
<div class="flex flex-col space-y-3 bg-slate-900/90 p-2 rounded-2xl">
|
|
1157
|
+
<div class="flex items-center justify-between text-xs">
|
|
1158
|
+
<span class="text-slate-400 font-bold uppercase tracking-wider">Tiện ích Điểm Danh</span>
|
|
1159
|
+
<span class="text-[10px] bg-emerald-500/20 text-emerald-400 px-2 py-0.5 rounded-full font-bold">AppIntents Ready</span>
|
|
1160
|
+
</div>
|
|
1161
|
+
|
|
1162
|
+
<div class="flex items-center justify-between py-1">
|
|
1163
|
+
<div>
|
|
1164
|
+
<p class="text-xs text-slate-400">Số lượt ghi nhận hôm nay</p>
|
|
1165
|
+
<p class="text-3xl font-extrabold text-sky-400 font-mono" id="sim-counter-text">${counterValue}</p>
|
|
1166
|
+
</div>
|
|
1167
|
+
<div class="text-right">
|
|
1168
|
+
<span class="text-xs text-slate-400">Trạng thái</span>
|
|
1169
|
+
<p class="text-xs font-bold text-emerald-400">Đã đồng bộ</p>
|
|
1170
|
+
</div>
|
|
1171
|
+
</div>
|
|
1172
|
+
|
|
1173
|
+
<!-- Interactive Buttons inside the widget -->
|
|
1174
|
+
<div class="grid grid-cols-2 gap-2 pt-1">
|
|
1175
|
+
<button onclick="handleSimCounter(1)" class="w-full py-2 px-3 rounded-xl bg-sky-600 hover:bg-sky-500 text-white font-bold text-xs transition active:scale-95 shadow">
|
|
1176
|
+
+1 Điểm danh
|
|
1177
|
+
</button>
|
|
1178
|
+
<button onclick="handleSimCounter(5)" class="w-full py-2 px-3 rounded-xl bg-slate-800 hover:bg-slate-700 text-slate-200 font-semibold text-xs transition active:scale-95 border border-slate-700">
|
|
1179
|
+
+5 Ghi nhận
|
|
1180
|
+
</button>
|
|
1181
|
+
</div>
|
|
1182
|
+
</div>
|
|
1183
|
+
`,
|
|
1184
|
+
code: `// 1. Cập nhật giao diện Widget với nút bấm tương tác
|
|
1185
|
+
Widget.reload('attendance', {
|
|
1186
|
+
layout: UI.VStack({
|
|
1187
|
+
padding: 14,
|
|
1188
|
+
backgroundColor: '#0F172A',
|
|
1189
|
+
children: [
|
|
1190
|
+
UI.Text('BỘ ĐẾM ĐIỂM DANH', { color: '#94A3B8', fontSize: 11 }),
|
|
1191
|
+
UI.Text(\`\${counter}\`, { color: '#38BDF8', fontSize: 32, fontWeight: 'heavy' }),
|
|
1192
|
+
UI.Button({
|
|
1193
|
+
title: '+1 Điểm danh',
|
|
1194
|
+
actionId: 'INCREMENT',
|
|
1195
|
+
backgroundColor: '#0284C7'
|
|
1196
|
+
})
|
|
1197
|
+
]
|
|
1198
|
+
})
|
|
1199
|
+
});
|
|
1200
|
+
|
|
1201
|
+
// 2. Lắng nghe hành động trực tiếp trong React Native (không gián đoạn)
|
|
1202
|
+
useWidgetAction('INCREMENT', () => {
|
|
1203
|
+
setCounter(c => c + 1);
|
|
1204
|
+
});`
|
|
1205
|
+
}
|
|
1206
|
+
};
|
|
1207
|
+
|
|
1208
|
+
function switchSimulator(mode) {
|
|
1209
|
+
currentSimState = mode;
|
|
1210
|
+
|
|
1211
|
+
// Update buttons style
|
|
1212
|
+
document.querySelectorAll('.sim-btn').forEach(btn => {
|
|
1213
|
+
btn.classList.remove('bg-sky-600', 'text-white', 'shadow-lg', 'shadow-sky-600/30');
|
|
1214
|
+
btn.classList.add('bg-slate-800', 'text-slate-300', 'hover:bg-slate-700', 'border', 'border-slate-700');
|
|
1215
|
+
});
|
|
1216
|
+
const activeBtn = document.getElementById('btn-sim-' + mode);
|
|
1217
|
+
if (activeBtn) {
|
|
1218
|
+
activeBtn.classList.remove('bg-slate-800', 'text-slate-300', 'hover:bg-slate-700');
|
|
1219
|
+
activeBtn.classList.add('bg-sky-600', 'text-white', 'shadow-lg', 'shadow-sky-600/30');
|
|
1220
|
+
}
|
|
1221
|
+
|
|
1222
|
+
// Render preset
|
|
1223
|
+
const preset = simulatorPresets[mode];
|
|
1224
|
+
document.getElementById('sim-island-box').innerHTML = preset.render();
|
|
1225
|
+
document.getElementById('sim-code-label').innerText = preset.codeLabel;
|
|
1226
|
+
|
|
1227
|
+
const codeEl = document.getElementById('sim-code');
|
|
1228
|
+
codeEl.textContent = preset.code;
|
|
1229
|
+
Prism.highlightElement(codeEl);
|
|
1230
|
+
lucide.createIcons();
|
|
1231
|
+
|
|
1232
|
+
// Manage Pomodoro timer interval
|
|
1233
|
+
if (mode === 'pomodoro') {
|
|
1234
|
+
startTimerInterval();
|
|
1235
|
+
} else {
|
|
1236
|
+
clearInterval(timerInterval);
|
|
1237
|
+
}
|
|
1238
|
+
}
|
|
1239
|
+
|
|
1240
|
+
function handleSimCounter(delta) {
|
|
1241
|
+
counterValue += delta;
|
|
1242
|
+
const el = document.getElementById('sim-counter-text');
|
|
1243
|
+
if (el) {
|
|
1244
|
+
el.innerText = counterValue;
|
|
1245
|
+
el.classList.add('scale-110');
|
|
1246
|
+
setTimeout(() => el.classList.remove('scale-110'), 150);
|
|
1247
|
+
}
|
|
1248
|
+
}
|
|
1249
|
+
|
|
1250
|
+
function startTimerInterval() {
|
|
1251
|
+
clearInterval(timerInterval);
|
|
1252
|
+
timerInterval = setInterval(() => {
|
|
1253
|
+
if (timerSeconds > 0) {
|
|
1254
|
+
timerSeconds--;
|
|
1255
|
+
const el = document.getElementById('live-timer-display');
|
|
1256
|
+
if (el) {
|
|
1257
|
+
const m = String(Math.floor(timerSeconds / 60)).padStart(2, '0');
|
|
1258
|
+
const s = String(timerSeconds % 60).padStart(2, '0');
|
|
1259
|
+
el.innerText = `${m}:${s}`;
|
|
1260
|
+
}
|
|
1261
|
+
}
|
|
1262
|
+
}, 1000);
|
|
1263
|
+
}
|
|
1264
|
+
|
|
1265
|
+
function resetTimer() {
|
|
1266
|
+
timerSeconds = 1500;
|
|
1267
|
+
startTimerInterval();
|
|
1268
|
+
}
|
|
1269
|
+
|
|
1270
|
+
function copySimulatorCode() {
|
|
1271
|
+
const code = document.getElementById('sim-code').textContent;
|
|
1272
|
+
navigator.clipboard.writeText(code).then(() => {
|
|
1273
|
+
alert('Đã sao chép mã ví dụ vào Clipboard!');
|
|
1274
|
+
});
|
|
1275
|
+
}
|
|
1276
|
+
|
|
1277
|
+
function copyCode(btn) {
|
|
1278
|
+
const pre = btn.parentElement.querySelector('pre code');
|
|
1279
|
+
if (!pre) return;
|
|
1280
|
+
navigator.clipboard.writeText(pre.textContent).then(() => {
|
|
1281
|
+
const originalText = btn.innerText;
|
|
1282
|
+
btn.innerText = 'Đã chép!';
|
|
1283
|
+
btn.classList.add('text-emerald-400');
|
|
1284
|
+
setTimeout(() => {
|
|
1285
|
+
btn.innerText = originalText;
|
|
1286
|
+
btn.classList.remove('text-emerald-400');
|
|
1287
|
+
}, 1800);
|
|
1288
|
+
});
|
|
1289
|
+
}
|
|
1290
|
+
|
|
1291
|
+
function copyText(text, btn) {
|
|
1292
|
+
navigator.clipboard.writeText(text).then(() => {
|
|
1293
|
+
const span = btn.querySelector('span');
|
|
1294
|
+
if (span) {
|
|
1295
|
+
const old = span.innerText;
|
|
1296
|
+
span.innerText = 'Đã chép!';
|
|
1297
|
+
setTimeout(() => { span.innerText = old; }, 1500);
|
|
1298
|
+
}
|
|
1299
|
+
});
|
|
1300
|
+
}
|
|
1301
|
+
|
|
1302
|
+
// Scroll to top button visibility
|
|
1303
|
+
window.addEventListener('scroll', () => {
|
|
1304
|
+
const topBtn = document.getElementById('back-to-top');
|
|
1305
|
+
if (window.scrollY > 400) {
|
|
1306
|
+
topBtn.classList.remove('opacity-0', 'pointer-events-none');
|
|
1307
|
+
topBtn.classList.add('opacity-100');
|
|
1308
|
+
} else {
|
|
1309
|
+
topBtn.classList.add('opacity-0', 'pointer-events-none');
|
|
1310
|
+
topBtn.classList.remove('opacity-100');
|
|
1311
|
+
}
|
|
1312
|
+
});
|
|
1313
|
+
|
|
1314
|
+
// Initialize initial state
|
|
1315
|
+
document.addEventListener('DOMContentLoaded', () => {
|
|
1316
|
+
lucide.createIcons();
|
|
1317
|
+
switchSimulator('delivery');
|
|
1318
|
+
});
|
|
438
1319
|
</script>
|
|
439
1320
|
</body>
|
|
440
1321
|
</html>
|