react-native-live-widgets 1.2.1 → 1.2.3
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 +37 -0
- package/README.md +89 -49
- package/android/src/main/AndroidManifest.xml +12 -0
- package/android/src/main/assets/fonts/MaterialIcons-Regular.ttf +0 -0
- package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityModule.kt +61 -1
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityNotifier.kt +153 -17
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityReceiver.kt +1 -1
- package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicWidgetCanvasRenderer.kt +86 -13
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetImageCache.kt +53 -0
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +647 -104
- package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +3 -1
- package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicQuickSettingsTileService.kt +120 -0
- package/app.plugin.js +36 -0
- package/assets/MaterialIcons.json +2236 -0
- package/cli/codegen.js +889 -0
- package/cli/setup.js +323 -63
- package/docs/EXPO-GUIDE-EN.md +21 -3
- package/docs/EXPO-GUIDE-VI.md +21 -3
- package/docs/GUIDE-EN.md +203 -21
- package/docs/GUIDE-VI.md +207 -22
- package/docs/index.html +1461 -226
- package/docs/llms-full.txt +15 -0
- package/docs/llms.txt +16 -7
- package/ios/Bridge/LiveActivityModule.swift +333 -44
- package/ios/Intents/DynamicWidgetActionIntent.swift +57 -2
- package/ios/Models/DynamicLayoutModels.swift +114 -4
- package/ios/Renderer/DynamicNodeView.swift +15 -6
- package/ios/Storage/DynamicWidgetStateStore.swift +649 -38
- package/ios/Widgets/DynamicControlWidget.swift +63 -0
- package/ios/Widgets/DynamicHomeScreenWidget.swift +99 -26
- package/ios/Widgets/DynamicLiveActivityWidget.swift +25 -4
- package/lib/builder.d.ts +50 -7
- package/lib/builder.d.ts.map +1 -1
- package/lib/builder.js +326 -18
- package/lib/builder.js.map +1 -1
- package/lib/hooks.d.ts +13 -9
- package/lib/hooks.d.ts.map +1 -1
- package/lib/hooks.js +70 -12
- package/lib/hooks.js.map +1 -1
- package/lib/index.d.ts +80 -7
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +303 -59
- package/lib/index.js.map +1 -1
- package/lib/ir.d.ts.map +1 -1
- package/lib/ir.js +9 -2
- package/lib/ir.js.map +1 -1
- package/lib/jsx.d.ts +11 -7
- package/lib/jsx.d.ts.map +1 -1
- package/lib/jsx.js +50 -13
- package/lib/jsx.js.map +1 -1
- package/lib/material-icons.generated.d.ts +8 -0
- package/lib/material-icons.generated.d.ts.map +1 -0
- package/lib/material-icons.generated.js +9 -0
- package/lib/material-icons.generated.js.map +1 -0
- package/lib/preview.d.ts +11 -4
- package/lib/preview.d.ts.map +1 -1
- package/lib/preview.js +150 -82
- package/lib/preview.js.map +1 -1
- package/lib/sf-symbols.generated.d.ts +8 -0
- package/lib/sf-symbols.generated.d.ts.map +1 -0
- package/lib/sf-symbols.generated.js +9 -0
- package/lib/sf-symbols.generated.js.map +1 -0
- package/lib/types.d.ts +302 -18
- package/lib/types.d.ts.map +1 -1
- package/package.json +6 -2
- package/scripts/build.js +98 -0
- package/scripts/generate-material-icons.js +93 -0
- package/scripts/generate-sf-symbols.js +95 -0
- package/scripts/release.js +115 -0
- package/scripts/test-ir-semantic.js +314 -0
- package/src/builder.ts +382 -24
- package/src/hooks.ts +88 -12
- package/src/index.ts +319 -56
- package/src/ir.ts +8 -2
- package/src/jsx.tsx +69 -21
- package/src/material-icons.generated.ts +3844 -0
- package/src/preview.tsx +235 -81
- package/src/sf-symbols.generated.ts +9533 -0
- package/src/types.ts +348 -18
package/docs/index.html
CHANGED
|
@@ -5,6 +5,8 @@
|
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
6
|
<title>react-native-live-widgets — Live Activities, Dynamic Island & Interactive Home Screen Widgets</title>
|
|
7
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
|
+
<link rel="canonical" href="https://react-native-vu.github.io/react-native-live-widgets/">
|
|
9
|
+
<meta property="og:url" content="https://react-native-vu.github.io/react-native-live-widgets/">
|
|
8
10
|
<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
11
|
|
|
10
12
|
<!-- Tailwind CSS CDN -->
|
|
@@ -59,8 +61,15 @@
|
|
|
59
61
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-tsx.min.js"></script>
|
|
60
62
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-bash.min.js"></script>
|
|
61
63
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-json.min.js"></script>
|
|
64
|
+
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-swift.min.js"></script>
|
|
65
|
+
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-kotlin.min.js"></script>
|
|
62
66
|
|
|
63
67
|
<style>
|
|
68
|
+
/* Ensure sticky header does not cover anchor targets */
|
|
69
|
+
html {
|
|
70
|
+
scroll-padding-top: 5.5rem;
|
|
71
|
+
}
|
|
72
|
+
|
|
64
73
|
/* Custom Scrollbar */
|
|
65
74
|
::-webkit-scrollbar {
|
|
66
75
|
width: 6px;
|
|
@@ -120,9 +129,9 @@
|
|
|
120
129
|
<!-- Top Announcement Bar -->
|
|
121
130
|
<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
131
|
<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.
|
|
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>
|
|
132
|
+
<span class="px-2 py-0.5 rounded-full bg-emerald-500/20 text-emerald-300 font-semibold text-[10px] uppercase tracking-wide" data-i18n="announcement_tag">Mới v1.2.2</span>
|
|
133
|
+
<span data-i18n="announcement_text">Exact Dynamic Hit Layer, Native Chronometer Countdown, Swift 6 Ready & Chuẩn hoá <strong>UI IR</strong></span>
|
|
134
|
+
<a href="#exact-hit-layer" data-i18n="announcement_link" class="underline hover:text-white ml-2">Xem chi tiết →</a>
|
|
126
135
|
</span>
|
|
127
136
|
</div>
|
|
128
137
|
|
|
@@ -139,28 +148,36 @@
|
|
|
139
148
|
<a href="#" class="font-bold text-base sm:text-lg text-white hover:text-sky-400 transition leading-tight">
|
|
140
149
|
react-native-live-widgets
|
|
141
150
|
</a>
|
|
142
|
-
<span class="text-[11px] text-slate-400 hidden sm:inline">Declarative Widgets & Dynamic Island Engine</span>
|
|
151
|
+
<span class="text-[11px] text-slate-400 hidden sm:inline" data-i18n="brand_subtitle">Declarative Widgets & Dynamic Island Engine</span>
|
|
143
152
|
</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.
|
|
153
|
+
<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" data-i18n="version_tag">
|
|
154
|
+
v1.2.2
|
|
146
155
|
</span>
|
|
147
156
|
</div>
|
|
148
157
|
|
|
149
158
|
<!-- Nav Links & Search -->
|
|
150
|
-
<nav class="flex items-center space-x-3 sm:space-x-
|
|
159
|
+
<nav class="flex items-center space-x-3 sm:space-x-4">
|
|
151
160
|
<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
161
|
<i data-lucide="play-circle" class="w-4 h-4 text-sky-400"></i>
|
|
153
|
-
<span>Live Simulator</span>
|
|
162
|
+
<span data-i18n="nav_sim">Live Simulator</span>
|
|
154
163
|
</a>
|
|
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>
|
|
164
|
+
<a href="#quick-start" class="text-xs sm:text-sm text-slate-300 hover:text-white hidden md:inline" data-i18n="nav_install">Cài đặt</a>
|
|
165
|
+
<a href="#dsl-catalog" class="text-xs sm:text-sm text-slate-300 hover:text-white hidden md:inline" data-i18n="nav_dsl">UI DSL & JSX</a>
|
|
166
|
+
<a href="#core-api" class="text-xs sm:text-sm text-slate-300 hover:text-white hidden md:inline" data-i18n="nav_api">API Reference</a>
|
|
158
167
|
|
|
159
168
|
<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
169
|
<i data-lucide="bot" class="w-4 h-4"></i>
|
|
161
170
|
<span>llms.txt</span>
|
|
162
171
|
</a>
|
|
163
172
|
|
|
173
|
+
<!-- Language Switcher (VI / EN) -->
|
|
174
|
+
<div class="flex items-center space-x-1 border-l border-cardBorder pl-3">
|
|
175
|
+
<div class="inline-flex items-center rounded-lg bg-slate-800/80 p-0.5 border border-slate-700/80 text-[11px] font-semibold">
|
|
176
|
+
<button id="lang-btn-vi" onclick="switchLanguage('vi')" class="px-2 py-0.5 rounded-md transition text-sky-400 bg-sky-500/20 shadow-sm" title="Tiếng Việt">VI</button>
|
|
177
|
+
<button id="lang-btn-en" onclick="switchLanguage('en')" class="px-2 py-0.5 rounded-md transition text-slate-400 hover:text-white" title="English">EN</button>
|
|
178
|
+
</div>
|
|
179
|
+
</div>
|
|
180
|
+
|
|
164
181
|
<!-- GitHub Repo & Demo links -->
|
|
165
182
|
<div class="flex items-center space-x-1 border-l border-cardBorder pl-3">
|
|
166
183
|
<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">
|
|
@@ -181,18 +198,18 @@
|
|
|
181
198
|
<!-- Badges -->
|
|
182
199
|
<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
200
|
<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>
|
|
201
|
+
<span data-i18n="hero_badge">100% Declarative UI • Không viết Swift / Kotlin • Expo CNG Ready</span>
|
|
185
202
|
</div>
|
|
186
203
|
|
|
187
204
|
<!-- Main Headline -->
|
|
188
205
|
<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">
|
|
190
|
-
<span class="text-transparent bg-clip-text bg-gradient-to-r from-sky-400 via-teal-300 to-indigo-400">
|
|
206
|
+
<span data-i18n="hero_title_1">Live Activities & Dynamic Island</span> <br class="hidden sm:inline">
|
|
207
|
+
<span class="text-transparent bg-clip-text bg-gradient-to-r from-sky-400 via-teal-300 to-indigo-400" data-i18n="hero_title_2">
|
|
191
208
|
Chỉ với TypeScript & JSX
|
|
192
209
|
</span>
|
|
193
210
|
</h1>
|
|
194
211
|
|
|
195
|
-
<p class="mt-6 text-base sm:text-xl text-slate-300 max-w-3xl mx-auto font-normal leading-relaxed">
|
|
212
|
+
<p class="mt-6 text-base sm:text-xl text-slate-300 max-w-3xl mx-auto font-normal leading-relaxed" data-i18n="hero_desc">
|
|
196
213
|
Giải pháp toàn diện All-in-One cho <strong>Live Activities</strong>, <strong>Dynamic Island</strong> và
|
|
197
214
|
<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.
|
|
198
215
|
</p>
|
|
@@ -201,15 +218,15 @@
|
|
|
201
218
|
<div class="mt-8 flex flex-wrap justify-center items-center gap-4">
|
|
202
219
|
<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
220
|
<i data-lucide="zap" class="w-4 h-4"></i>
|
|
204
|
-
<span>Bắt đầu Cài đặt</span>
|
|
221
|
+
<span data-i18n="hero_btn_install">Bắt đầu Cài đặt</span>
|
|
205
222
|
</a>
|
|
206
223
|
<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
224
|
<i data-lucide="play" class="w-4 h-4 text-sky-400"></i>
|
|
208
|
-
<span>Trải nghiệm Live Simulator</span>
|
|
225
|
+
<span data-i18n="hero_btn_sim">Trải nghiệm Live Simulator</span>
|
|
209
226
|
</a>
|
|
210
227
|
<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
228
|
<i data-lucide="smartphone" class="w-4 h-4"></i>
|
|
212
|
-
<span>Expo Sample App ↗</span>
|
|
229
|
+
<span data-i18n="hero_btn_expo">Expo Sample App ↗</span>
|
|
213
230
|
</a>
|
|
214
231
|
</div>
|
|
215
232
|
|
|
@@ -218,7 +235,7 @@
|
|
|
218
235
|
<span class="px-2 text-sky-400 select-all">$ npm install react-native-live-widgets</span>
|
|
219
236
|
<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
237
|
<i data-lucide="copy" class="w-3.5 h-3.5"></i>
|
|
221
|
-
<span>Copy</span>
|
|
238
|
+
<span data-i18n="btn_copy">Copy</span>
|
|
222
239
|
</button>
|
|
223
240
|
</div>
|
|
224
241
|
|
|
@@ -232,12 +249,12 @@
|
|
|
232
249
|
<div class="text-center max-w-3xl mx-auto mb-10">
|
|
233
250
|
<div class="inline-flex items-center space-x-1 text-xs font-semibold uppercase tracking-wider text-sky-400 mb-2">
|
|
234
251
|
<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>
|
|
252
|
+
<span data-i18n="sim_header_badge">Tương tác trực tiếp trên trình duyệt</span>
|
|
236
253
|
</div>
|
|
237
|
-
<h2 class="text-3xl sm:text-4xl font-extrabold text-white">
|
|
254
|
+
<h2 class="text-3xl sm:text-4xl font-extrabold text-white" data-i18n="sim_header_title">
|
|
238
255
|
Live Simulator: Trải Nghiệm Widget & Dynamic Island
|
|
239
256
|
</h2>
|
|
240
|
-
<p class="mt-3 text-slate-400 text-sm sm:text-base">
|
|
257
|
+
<p class="mt-3 text-slate-400 text-sm sm:text-base" data-i18n="sim_header_desc">
|
|
241
258
|
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
259
|
</p>
|
|
243
260
|
</div>
|
|
@@ -246,19 +263,19 @@
|
|
|
246
263
|
<div class="flex flex-wrap justify-center gap-2 mb-8">
|
|
247
264
|
<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
265
|
<i data-lucide="bike" class="w-4 h-4"></i>
|
|
249
|
-
<span>1. Giao đồ ăn (Dynamic Island)</span>
|
|
266
|
+
<span data-i18n="sim_tab_delivery">1. Giao đồ ăn (Dynamic Island)</span>
|
|
250
267
|
</button>
|
|
251
268
|
<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
269
|
<i data-lucide="music" class="w-4 h-4"></i>
|
|
253
|
-
<span>2. Sóng nhạc Equalizer</span>
|
|
270
|
+
<span data-i18n="sim_tab_music">2. Sóng nhạc Equalizer</span>
|
|
254
271
|
</button>
|
|
255
272
|
<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
273
|
<i data-lucide="timer" class="w-4 h-4"></i>
|
|
257
|
-
<span>3. Bấm giờ Phần cứng (UI.Timer)</span>
|
|
274
|
+
<span data-i18n="sim_tab_pomodoro">3. Bấm giờ Phần cứng (UI.Timer)</span>
|
|
258
275
|
</button>
|
|
259
276
|
<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
277
|
<i data-lucide="layout" class="w-4 h-4"></i>
|
|
261
|
-
<span>4. Home Widget Tương Tác 2 Chiều</span>
|
|
278
|
+
<span data-i18n="sim_tab_widget">4. Home Widget Tương Tác 2 Chiều</span>
|
|
262
279
|
</button>
|
|
263
280
|
</div>
|
|
264
281
|
|
|
@@ -277,19 +294,19 @@
|
|
|
277
294
|
<!-- Hint below phone -->
|
|
278
295
|
<p id="sim-hint" class="mt-4 text-xs text-slate-500 text-center flex items-center space-x-1">
|
|
279
296
|
<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>
|
|
297
|
+
<span data-i18n="sim_hint">Nhấn vào các nút bên trong widget để thấy phản hồi tương tác!</span>
|
|
281
298
|
</p>
|
|
282
299
|
</div>
|
|
283
300
|
|
|
284
301
|
<!-- Code Snippet for Current Simulator State -->
|
|
285
302
|
<div class="lg:col-span-6 flex flex-col">
|
|
286
303
|
<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">
|
|
304
|
+
<span id="sim-code-label" class="text-xs font-semibold text-slate-400 uppercase tracking-wider" data-i18n="sim_code_label">
|
|
288
305
|
Mã TypeScript Declarative
|
|
289
306
|
</span>
|
|
290
307
|
<button onclick="copySimulatorCode()" class="text-xs text-sky-400 hover:text-sky-300 flex items-center space-x-1">
|
|
291
308
|
<i data-lucide="copy" class="w-3.5 h-3.5"></i>
|
|
292
|
-
<span>Copy Code</span>
|
|
309
|
+
<span data-i18n="btn_copy_code">Copy Code</span>
|
|
293
310
|
</button>
|
|
294
311
|
</div>
|
|
295
312
|
<div class="relative">
|
|
@@ -309,8 +326,8 @@
|
|
|
309
326
|
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
|
|
310
327
|
|
|
311
328
|
<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>
|
|
329
|
+
<h2 class="text-2xl sm:text-3xl font-bold text-white" data-i18n="why_title">Tại sao chọn `react-native-live-widgets`?</h2>
|
|
330
|
+
<p class="mt-2 text-slate-400 text-sm sm:text-base" data-i18n="why_desc">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
331
|
</div>
|
|
315
332
|
|
|
316
333
|
<div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
|
|
@@ -320,8 +337,8 @@
|
|
|
320
337
|
<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
338
|
<i data-lucide="code-2" class="w-6 h-6"></i>
|
|
322
339
|
</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">
|
|
340
|
+
<h3 class="text-lg font-bold text-white" data-i18n="f1_title">100% Không Viết Swift / Kotlin</h3>
|
|
341
|
+
<p class="mt-2 text-sm text-slate-400 leading-relaxed" data-i18n="f1_desc">
|
|
325
342
|
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
343
|
</p>
|
|
327
344
|
</div>
|
|
@@ -331,8 +348,8 @@
|
|
|
331
348
|
<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
349
|
<i data-lucide="mouse-pointer-click" class="w-6 h-6"></i>
|
|
333
350
|
</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">
|
|
351
|
+
<h3 class="text-lg font-bold text-white" data-i18n="f2_title">Tương Tác 2 Chiều (AppIntents)</h3>
|
|
352
|
+
<p class="mt-2 text-sm text-slate-400 leading-relaxed" data-i18n="f2_desc">
|
|
336
353
|
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
354
|
</p>
|
|
338
355
|
</div>
|
|
@@ -342,8 +359,8 @@
|
|
|
342
359
|
<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
360
|
<i data-lucide="battery-charging" class="w-6 h-6"></i>
|
|
344
361
|
</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">
|
|
362
|
+
<h3 class="text-lg font-bold text-white" data-i18n="f3_title">Timer Phần Cứng (0% Tiêu Hao Pin)</h3>
|
|
363
|
+
<p class="mt-2 text-sm text-slate-400 leading-relaxed" data-i18n="f3_desc">
|
|
347
364
|
<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
365
|
</p>
|
|
349
366
|
</div>
|
|
@@ -353,8 +370,8 @@
|
|
|
353
370
|
<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
371
|
<i data-lucide="radio" class="w-6 h-6"></i>
|
|
355
372
|
</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">
|
|
373
|
+
<h3 class="text-lg font-bold text-white" data-i18n="f4_title">Sóng Nhạc Động (Equalizer)</h3>
|
|
374
|
+
<p class="mt-2 text-sm text-slate-400 leading-relaxed" data-i18n="f4_desc">
|
|
358
375
|
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
376
|
</p>
|
|
360
377
|
</div>
|
|
@@ -364,8 +381,8 @@
|
|
|
364
381
|
<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
382
|
<i data-lucide="cloud-lightning" class="w-6 h-6"></i>
|
|
366
383
|
</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">
|
|
384
|
+
<h3 class="text-lg font-bold text-white" data-i18n="f5_title">Đồng Bộ Ngầm Khi Kill App</h3>
|
|
385
|
+
<p class="mt-2 text-sm text-slate-400 leading-relaxed" data-i18n="f5_desc">
|
|
369
386
|
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
387
|
</p>
|
|
371
388
|
</div>
|
|
@@ -375,7 +392,11 @@
|
|
|
375
392
|
<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
393
|
<i data-lucide="bot" class="w-6 h-6"></i>
|
|
377
394
|
</div>
|
|
378
|
-
<h3 class="text-lg font-bold text-white">Chuẩn AI Agent (llms.txt)</h3>
|
|
395
|
+
<h3 class="text-lg font-bold text-white" data-i18n="f6_title">Chuẩn AI Agent (llms.txt)</h3>
|
|
396
|
+
<p class="mt-2 text-sm text-slate-400 leading-relaxed" data-i18n="f6_desc">
|
|
397
|
+
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.
|
|
398
|
+
</p>
|
|
399
|
+
</div>
|
|
379
400
|
<p class="mt-2 text-sm text-slate-400 leading-relaxed">
|
|
380
401
|
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
402
|
</p>
|
|
@@ -390,71 +411,92 @@
|
|
|
390
411
|
<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">
|
|
391
412
|
|
|
392
413
|
<!-- Sidebar Navigation -->
|
|
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">
|
|
414
|
+
<aside id="docs-sidebar" 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
415
|
|
|
395
416
|
<div>
|
|
396
417
|
<h4 class="text-xs font-bold text-sky-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
|
|
397
418
|
<i data-lucide="rocket" class="w-4 h-4"></i>
|
|
398
|
-
<span>Bắt đầu</span>
|
|
419
|
+
<span data-i18n="side_header_start">Bắt đầu</span>
|
|
399
420
|
</h4>
|
|
400
421
|
<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>
|
|
422
|
+
<li><a href="#quick-start" class="sidebar-link text-slate-300 hover:text-white block py-1 transition" data-i18n="side_quick_start">Cài đặt All-in-One CLI</a></li>
|
|
423
|
+
<li><a href="#expo-setup" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_expo_setup">Expo (Config Plugin & CNG)</a></li>
|
|
424
|
+
<li><a href="#bare-rn-setup" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_bare_rn">Bare React Native CLI</a></li>
|
|
404
425
|
</ul>
|
|
405
426
|
</div>
|
|
406
427
|
|
|
407
428
|
<div>
|
|
408
429
|
<h4 class="text-xs font-bold text-sky-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
|
|
409
430
|
<i data-lucide="code" class="w-4 h-4"></i>
|
|
410
|
-
<span>Cú pháp & Engine</span>
|
|
431
|
+
<span data-i18n="side_header_syntax">Cú pháp & UI Engine</span>
|
|
411
432
|
</h4>
|
|
412
433
|
<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="#
|
|
415
|
-
<li><a href="#
|
|
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-
|
|
418
|
-
<li><a href="#dsl-
|
|
419
|
-
<li><a href="#dsl-
|
|
420
|
-
<li><a href="#dsl-
|
|
434
|
+
<li><a href="#jsx-support" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_jsx_support">Cú pháp JSX / TSX & StyleSheet</a></li>
|
|
435
|
+
<li><a href="#widget-preview-comp" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_widget_preview">Mô phỏng <WidgetPreview></a></li>
|
|
436
|
+
<li><a href="#exact-hit-layer" class="sidebar-link text-emerald-400 hover:text-white block py-1 transition font-medium" data-i18n="side_exact_hit">Exact Hit Layer & Chronometer (v1.2.2)</a></li>
|
|
437
|
+
<li><a href="#dsl-containers" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_dsl_containers">VStack, HStack, ZStack, Grid, Divider</a></li>
|
|
438
|
+
<li><a href="#dsl-text-badge" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_dsl_text">UI.Text, UI.Badge & Biến động</a></li>
|
|
439
|
+
<li><a href="#dsl-image" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_dsl_image">UI.Image & System Icons (Apple / Google)</a></li>
|
|
440
|
+
<li><a href="#dsl-timer" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_dsl_timer">UI.Timer (Đếm giờ phần cứng)</a></li>
|
|
441
|
+
<li><a href="#dsl-progress" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_dsl_progress">UI.Progress (Bar, Segmented, Circle)</a></li>
|
|
442
|
+
<li><a href="#dsl-equalizer" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_dsl_equalizer">UI.Equalizer (Sóng âm)</a></li>
|
|
443
|
+
<li><a href="#dsl-gauge-chart" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_dsl_gauge">UI.Gauge 240° & UI.Chart</a></li>
|
|
444
|
+
<li><a href="#dsl-interactive" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_dsl_interactive">UI.Button, UI.Toggle & UI.Link</a></li>
|
|
445
|
+
<li><a href="#dsl-custom" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_dsl_custom">UI.Custom & DynamicNodeRegistry</a></li>
|
|
446
|
+
<li><a href="#styling-modifiers" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_styling">Gradient, Shadow, Border, Tinted</a></li>
|
|
421
447
|
</ul>
|
|
422
448
|
</div>
|
|
423
449
|
|
|
424
450
|
<div>
|
|
425
451
|
<h4 class="text-xs font-bold text-sky-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
|
|
426
452
|
<i data-lucide="book-open" class="w-4 h-4"></i>
|
|
427
|
-
<span>Core API Reference</span>
|
|
453
|
+
<span data-i18n="side_header_api">Core API Reference</span>
|
|
428
454
|
</h4>
|
|
429
455
|
<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
|
|
431
|
-
<li><a href="#api-widget" class="text-slate-400 hover:text-white block py-1 transition">Widget API
|
|
432
|
-
<li><a href="#api-
|
|
433
|
-
<li><a href="#api-
|
|
456
|
+
<li><a href="#api-liveactivity" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_api_liveactivity">LiveActivity & Dynamic Island</a></li>
|
|
457
|
+
<li><a href="#api-widget" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_api_widget">Widget API, Multi-page & Lock Screen</a></li>
|
|
458
|
+
<li><a href="#api-hooks" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_api_hooks">React Hooks & SharedStorage</a></li>
|
|
459
|
+
<li><a href="#api-remote-sync" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_api_remote">Remote API Sync (Kill App)</a></li>
|
|
460
|
+
<li><a href="#api-push-token" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_api_push">APNs & FCM Push Tokens</a></li>
|
|
461
|
+
</ul>
|
|
462
|
+
</div>
|
|
463
|
+
|
|
464
|
+
<div>
|
|
465
|
+
<h4 class="text-xs font-bold text-emerald-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
|
|
466
|
+
<i data-lucide="cpu" class="w-4 h-4"></i>
|
|
467
|
+
<span data-i18n="side_header_arch">Kiến trúc & Trợ năng (v1.2.2)</span>
|
|
468
|
+
</h4>
|
|
469
|
+
<ul class="space-y-1 border-l border-emerald-950 pl-3">
|
|
470
|
+
<li><a href="#ir-semantic" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_ir_semantic">3 Trụ cột Kiến trúc & UI IR</a></li>
|
|
471
|
+
<li><a href="#a11y-layer" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_a11y">Accessibility (VoiceOver & TalkBack)</a></li>
|
|
472
|
+
<li><a href="#capability-matrix" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_capability">Bảng Năng lực & Lộ trình 6 Phases</a></li>
|
|
473
|
+
<li><a href="#extended-families-lifecycle" class="sidebar-link text-emerald-400 hover:text-white block py-1 transition font-medium" data-i18n="side_standby">StandBy, ControlWidget & Lifecycle</a></li>
|
|
474
|
+
<li><a href="#troubleshooting" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_troubleshoot">Xử lý sự cố thường gặp</a></li>
|
|
434
475
|
</ul>
|
|
435
476
|
</div>
|
|
436
477
|
|
|
437
478
|
<div>
|
|
438
479
|
<h4 class="text-xs font-bold text-indigo-400 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
|
|
439
480
|
<i data-lucide="bot" class="w-4 h-4"></i>
|
|
440
|
-
<span>AI Agent & LLMs</span>
|
|
481
|
+
<span data-i18n="side_header_ai">AI Agent & LLMs</span>
|
|
441
482
|
</h4>
|
|
442
483
|
<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>
|
|
484
|
+
<li><a href="#llms-ai" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_llms">Chuẩn mở llms.txt & llms-full.txt</a></li>
|
|
485
|
+
<li><a href="#agent-skill" class="sidebar-link text-slate-400 hover:text-white block py-1 transition" data-i18n="side_skill">Agent Skill (SKILL.md)</a></li>
|
|
445
486
|
</ul>
|
|
446
487
|
</div>
|
|
447
488
|
|
|
448
489
|
<div>
|
|
449
490
|
<h4 class="text-xs font-bold text-slate-500 uppercase tracking-wider mb-2.5 flex items-center space-x-1.5">
|
|
450
491
|
<i data-lucide="external-link" class="w-4 h-4"></i>
|
|
451
|
-
<span>Tài nguyên ngoài</span>
|
|
492
|
+
<span data-i18n="side_header_resources">Tài nguyên ngoài</span>
|
|
452
493
|
</h4>
|
|
453
494
|
<ul class="space-y-1 border-l border-slate-800 pl-3 text-xs">
|
|
495
|
+
<li><a href="https://react-native-vu.github.io/react-native-live-widgets/" target="_blank" class="text-sky-400 hover:text-sky-300 block py-1 font-medium" data-i18n="side_res_web">Web Docs Chính Thức ↗</a></li>
|
|
454
496
|
<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
497
|
<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>
|
|
498
|
+
<li><a href="GUIDE-VI.md" target="_blank" class="text-slate-400 hover:text-sky-300 block py-1" data-i18n="side_res_guide_vi">Hướng Dẫn Chi Tiết (VI) ↗</a></li>
|
|
499
|
+
<li><a href="GUIDE-EN.md" target="_blank" class="text-slate-400 hover:text-sky-300 block py-1" data-i18n="side_res_guide_en">English Full Guide ↗</a></li>
|
|
458
500
|
</ul>
|
|
459
501
|
</div>
|
|
460
502
|
|
|
@@ -468,9 +510,9 @@
|
|
|
468
510
|
<div class="border-b border-cardBorder pb-4">
|
|
469
511
|
<h2 class="text-2xl sm:text-3xl font-extrabold text-white flex items-center space-x-2.5">
|
|
470
512
|
<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>
|
|
513
|
+
<span data-i18n="qs_title">Cài đặt & Thiết lập Tự động</span>
|
|
472
514
|
</h2>
|
|
473
|
-
<p class="mt-2 text-slate-400 text-sm sm:text-base">
|
|
515
|
+
<p class="mt-2 text-slate-400 text-sm sm:text-base" data-i18n="qs_desc">
|
|
474
516
|
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
517
|
</p>
|
|
476
518
|
</div>
|
|
@@ -480,14 +522,14 @@
|
|
|
480
522
|
<div class="flex items-center justify-between">
|
|
481
523
|
<span class="font-bold text-white text-base sm:text-lg flex items-center space-x-2">
|
|
482
524
|
<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>
|
|
525
|
+
<span data-i18n="expo_card_title">1. Quy trình dành cho Expo (SDK 50, 51, 52, 58+ CNG)</span>
|
|
484
526
|
</span>
|
|
485
527
|
<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
528
|
Config Plugin
|
|
487
529
|
</span>
|
|
488
530
|
</div>
|
|
489
531
|
|
|
490
|
-
<p class="text-sm text-slate-300 leading-relaxed">
|
|
532
|
+
<p class="text-sm text-slate-300 leading-relaxed" data-i18n="expo_card_desc">
|
|
491
533
|
Thư viện tương thích 100% với <strong>Continuous Native Generation (CNG)</strong> và <strong>EAS Build</strong>:
|
|
492
534
|
</p>
|
|
493
535
|
|
|
@@ -496,20 +538,15 @@
|
|
|
496
538
|
<pre><code class="language-bash"># Bước 1: Cài đặt thư viện
|
|
497
539
|
npx expo install react-native-live-widgets
|
|
498
540
|
|
|
499
|
-
# Bước 2:
|
|
541
|
+
# Bước 2: Thiết lập tự động 1 lệnh (tự cấu hình app.json, tạo widgets.config.ts, sync icons & Swift)
|
|
542
|
+
npx react-native-live-widgets init
|
|
500
543
|
|
|
501
|
-
# Bước 3:
|
|
502
|
-
npx expo prebuild
|
|
503
|
-
|
|
504
|
-
# Bước 4: Tự động khởi tạo Widget Extension target & App Groups
|
|
505
|
-
npx react-native-live-widgets init --group group.com.yourcompany.app
|
|
506
|
-
|
|
507
|
-
# Bước 5: Chạy ứng dụng trên máy ảo
|
|
544
|
+
# Bước 3: Chạy ứng dụng trên máy ảo / thiết bị thật
|
|
508
545
|
npx expo run:ios
|
|
509
546
|
npx expo run:android</code></pre>
|
|
510
547
|
</div>
|
|
511
548
|
|
|
512
|
-
<p class="text-xs font-semibold text-slate-300">Cấu hình Config Plugin
|
|
549
|
+
<p class="text-xs font-semibold text-slate-300" data-i18n="expo_plugin_label">Cấu hình Config Plugin được tự động thêm vào tập tin <code class="text-sky-300">app.json</code>:</p>
|
|
513
550
|
<div class="relative">
|
|
514
551
|
<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
552
|
<pre><code class="language-json">{
|
|
@@ -536,7 +573,7 @@ npx expo run:android</code></pre>
|
|
|
536
573
|
<div class="flex items-center justify-between">
|
|
537
574
|
<span class="font-bold text-white text-base sm:text-lg flex items-center space-x-2">
|
|
538
575
|
<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>
|
|
576
|
+
<span data-i18n="bare_card_title">2. Quy trình dành cho Bare React Native CLI</span>
|
|
540
577
|
</span>
|
|
541
578
|
<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
579
|
CLI Auto-Link
|
|
@@ -545,79 +582,207 @@ npx expo run:android</code></pre>
|
|
|
545
582
|
|
|
546
583
|
<div class="relative">
|
|
547
584
|
<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
|
|
585
|
+
<pre><code class="language-bash"># Bước 1: Cài đặt package
|
|
549
586
|
npm install react-native-live-widgets
|
|
587
|
+
# hoặc: yarn add react-native-live-widgets
|
|
550
588
|
|
|
551
|
-
# Tự động
|
|
552
|
-
npx react-native-live-widgets init
|
|
589
|
+
# Bước 2: Tự động cấu hình Xcode Target, Entitlements, Podfile, pod install, Android permissions và Swift bundle
|
|
590
|
+
npx react-native-live-widgets init
|
|
553
591
|
|
|
554
|
-
# Khởi chạy dự án
|
|
592
|
+
# Bước 3: Khởi chạy dự án
|
|
555
593
|
npx react-native run-ios
|
|
556
594
|
npx react-native run-android</code></pre>
|
|
557
595
|
</div>
|
|
558
596
|
</div>
|
|
597
|
+
|
|
598
|
+
<!-- Codegen Card -->
|
|
599
|
+
<div id="codegen-setup" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4 shadow-lg">
|
|
600
|
+
<div class="flex items-center justify-between">
|
|
601
|
+
<span class="font-bold text-white text-base sm:text-lg flex items-center space-x-2">
|
|
602
|
+
<span class="w-3 h-3 rounded-full bg-purple-400"></span>
|
|
603
|
+
<span data-i18n="codegen_card_title">3. Lệnh đồng bộ Codegen & Đa ngôn ngữ (i18n)</span>
|
|
604
|
+
</span>
|
|
605
|
+
<span class="text-xs bg-purple-500/10 text-purple-400 px-2.5 py-1 rounded-full border border-purple-500/20 font-semibold">
|
|
606
|
+
Codegen Engine
|
|
607
|
+
</span>
|
|
608
|
+
</div>
|
|
609
|
+
<p class="text-sm text-slate-300 leading-relaxed" data-i18n="codegen_card_desc">
|
|
610
|
+
Mỗi khi bạn thêm widget mới hoặc chỉnh sửa nội dung trong tập tin <code class="text-sky-300">widgets.config.ts</code>, chỉ cần chạy 1 câu lệnh để tự động cập nhật toàn bộ:
|
|
611
|
+
</p>
|
|
612
|
+
<div class="relative">
|
|
613
|
+
<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>
|
|
614
|
+
<pre><code class="language-bash">npx react-native-live-widgets codegen</code></pre>
|
|
615
|
+
</div>
|
|
616
|
+
</div>
|
|
559
617
|
</section>
|
|
560
618
|
|
|
561
|
-
<!-- Section: JSX Syntax & WidgetPreview Component
|
|
619
|
+
<!-- Section: JSX Syntax & WidgetPreview Component -->
|
|
562
620
|
<section id="jsx-support" class="space-y-6">
|
|
563
621
|
<div class="border-b border-cardBorder pb-4">
|
|
564
622
|
<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">
|
|
623
|
+
<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">JSX / TSX</span>
|
|
566
624
|
<h2 class="text-2xl sm:text-3xl font-extrabold text-white">
|
|
567
|
-
Cú pháp JSX / TSX &
|
|
625
|
+
Cú pháp JSX / TSX & <code>UI.StyleSheet</code>
|
|
568
626
|
</h2>
|
|
569
627
|
</div>
|
|
570
|
-
<p class="mt-2 text-slate-400 text-sm sm:text-base">
|
|
571
|
-
|
|
628
|
+
<p class="mt-2 text-slate-400 text-sm sm:text-base leading-relaxed">
|
|
629
|
+
Bạn có thể viết giao diện Widget theo <strong>2 phong cách</strong> tương đương 100%: thẻ JSX tự nhiên (<code><VStack></code>, <code><HStack></code>, <code><Text></code>...) với <code>style</code> / mảng conditional style, hoặc bộ hàm <code>UI.*</code> kết hợp <code>UI.StyleSheet.create(...)</code>. Cả <code>Widget.setLayout()</code> và <code>LiveActivity.start()</code> tự động biên dịch JSX sang JSON AST gốc.
|
|
572
630
|
</p>
|
|
573
631
|
</div>
|
|
574
632
|
|
|
575
|
-
<div class="
|
|
576
|
-
<
|
|
577
|
-
<
|
|
578
|
-
|
|
579
|
-
|
|
633
|
+
<div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
|
|
634
|
+
<div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
635
|
+
<h3 class="font-bold text-white text-base flex items-center space-x-2">
|
|
636
|
+
<i data-lucide="braces" class="w-5 h-5 text-sky-400"></i>
|
|
637
|
+
<span>Phong cách 1: JSX Components & StyleSheet</span>
|
|
638
|
+
</h3>
|
|
639
|
+
<p class="text-xs text-slate-400 leading-relaxed">
|
|
640
|
+
Hỗ trợ <code><VStack></code>, <code><HStack></code>, <code><ZStack></code>, <code><Grid></code>, <code><Text></code>, <code><Button></code>, <code><Toggle></code>, <code><Switch></code>, <code><Checkbox></code>, <code><Badge></code>, <code><Progress></code>, <code><Timer></code>, <code><Equalizer></code>, <code><Image></code>, <code><Gauge></code>, <code><Chart></code>, <code><Link></code>, <code><Spacer></code>, <code><Divider></code>.
|
|
641
|
+
</p>
|
|
642
|
+
<div class="relative">
|
|
643
|
+
<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>
|
|
644
|
+
<pre><code class="language-tsx">import {
|
|
645
|
+
Widget, VStack, HStack, Text, Badge, Button, Spacer, UI
|
|
646
|
+
} from 'react-native-live-widgets';
|
|
647
|
+
|
|
648
|
+
const styles = UI.StyleSheet.create({
|
|
649
|
+
card: { padding: 16, backgroundColor: '#0F172A', borderRadius: 18 },
|
|
650
|
+
title: { fontSize: 15, fontWeight: 'bold', color: '#FFFFFF' },
|
|
651
|
+
});
|
|
652
|
+
|
|
653
|
+
await Widget.setLayout('main', {
|
|
654
|
+
medium: (
|
|
655
|
+
<VStack style={styles.card} spacing={8}>
|
|
656
|
+
<HStack alignment="center">
|
|
657
|
+
<Text style={styles.title}>Ca Làm Việc Hôm Nay</Text>
|
|
658
|
+
<Spacer />
|
|
659
|
+
<Badge text="08:00 - 17:30" backgroundColor="#064E3B" textColor="#6EE7B7" />
|
|
660
|
+
</HStack>
|
|
661
|
+
<Text fontSize={13} color="#94A3B8">Văn phòng Fastdo Đà Nẵng</Text>
|
|
662
|
+
<Button
|
|
663
|
+
title="⚡ Check-in Ngay"
|
|
664
|
+
actionId="FASTDO_CHECKIN"
|
|
665
|
+
backgroundColor="#0284C7"
|
|
666
|
+
textColor="#FFFFFF"
|
|
667
|
+
fullWidth
|
|
668
|
+
/>
|
|
669
|
+
</VStack>
|
|
670
|
+
),
|
|
671
|
+
});</code></pre>
|
|
672
|
+
</div>
|
|
673
|
+
</div>
|
|
674
|
+
|
|
675
|
+
<div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
676
|
+
<h3 class="font-bold text-white text-base flex items-center space-x-2">
|
|
677
|
+
<i data-lucide="function-square" class="w-5 h-5 text-indigo-400"></i>
|
|
678
|
+
<span>Phong cách 2: Functional DSL & Conditional Styles</span>
|
|
679
|
+
</h3>
|
|
680
|
+
<p class="text-xs text-slate-400 leading-relaxed">
|
|
681
|
+
Viết thuần TypeScript với <code>UI.*</code> và truyền mảng style có điều kiện tương tự React Native <code>StyleSheet</code> (<code>[styles.base, isAlert && styles.alert]</code>). Tương thích mọi bundler không dùng JSX transform.
|
|
682
|
+
</p>
|
|
683
|
+
<div class="relative">
|
|
684
|
+
<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>
|
|
685
|
+
<pre><code class="language-typescript">import { UI, Widget } from 'react-native-live-widgets';
|
|
686
|
+
|
|
687
|
+
const styles = UI.StyleSheet.create({
|
|
688
|
+
card: { padding: 14, backgroundColor: '#111827', borderRadius: 16, spacing: 6 },
|
|
689
|
+
label: { fontSize: 13, fontWeight: 'medium', color: '#E2E8F0' },
|
|
690
|
+
errorText: { color: '#F87171', fontWeight: 'bold' },
|
|
691
|
+
});
|
|
692
|
+
|
|
693
|
+
const isLate = true;
|
|
694
|
+
|
|
695
|
+
await Widget.setLayout('shift', {
|
|
696
|
+
medium: UI.VStack(
|
|
697
|
+
styles.card,
|
|
698
|
+
UI.Text('TIÊU ĐỀ BÁO CÁO', { typography: 'caption1', color: '#94A3B8' }),
|
|
699
|
+
UI.Text('Trạng thái ca làm', [styles.label, isLate && styles.errorText])
|
|
700
|
+
),
|
|
701
|
+
});</code></pre>
|
|
702
|
+
</div>
|
|
703
|
+
</div>
|
|
704
|
+
</div>
|
|
705
|
+
|
|
706
|
+
<!-- WidgetPreview Card -->
|
|
707
|
+
<div id="widget-preview-comp" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-5 shadow-lg">
|
|
708
|
+
<div class="flex flex-wrap items-center justify-between gap-2">
|
|
709
|
+
<h3 class="font-bold text-white text-lg flex items-center space-x-2">
|
|
710
|
+
<i data-lucide="eye" class="w-5 h-5 text-sky-400"></i>
|
|
711
|
+
<span>Mô phỏng trực tiếp trong App: <code><WidgetPreview></code> (alias <code><VoltraWidgetPreview></code>)</span>
|
|
712
|
+
</h3>
|
|
713
|
+
<span class="text-xs bg-sky-500/10 text-sky-300 px-2.5 py-1 rounded-full border border-sky-500/20 font-semibold">
|
|
714
|
+
Multi-page & Timer Preview
|
|
715
|
+
</span>
|
|
716
|
+
</div>
|
|
717
|
+
<p class="text-sm text-slate-300 leading-relaxed">
|
|
718
|
+
Nhúng thẳng giao diện Widget vào màn hình React Native để xem trước chính xác tỉ lệ chuẩn iOS/Android, tự động chuyển đổi trang (<code>page:*</code>), bật/tắt công tắc <code>toggle:*</code>, và chạy đồng hồ đếm ngược <code>PreviewTimerText</code> 1 giây/lần trước khi ghim ra màn hình chính.
|
|
719
|
+
</p>
|
|
720
|
+
|
|
721
|
+
<div class="overflow-x-auto">
|
|
722
|
+
<table class="w-full text-left text-xs sm:text-sm border-collapse">
|
|
723
|
+
<thead>
|
|
724
|
+
<tr class="border-b border-cardBorder text-slate-400">
|
|
725
|
+
<th class="py-2 pr-4 font-semibold">Prop</th>
|
|
726
|
+
<th class="py-2 pr-4 font-semibold">Kiểu</th>
|
|
727
|
+
<th class="py-2 font-semibold">Mô tả</th>
|
|
728
|
+
</tr>
|
|
729
|
+
</thead>
|
|
730
|
+
<tbody class="divide-y divide-cardBorder text-slate-300">
|
|
731
|
+
<tr>
|
|
732
|
+
<td class="py-2 pr-4 font-mono text-sky-400">size</td>
|
|
733
|
+
<td class="py-2 pr-4 font-mono text-xs text-slate-400">'small' | 'medium' | 'large' | 'extraLarge' | 'standBy' | 'lockScreen' | 'dynamicIsland' | 'control'</td>
|
|
734
|
+
<td class="py-2">Kích thước khung xem trước (mặc định <code>'medium'</code> 338×158dp). Hỗ trợ StandBy, ExtraLarge & Control Tile (170×76dp).</td>
|
|
735
|
+
</tr>
|
|
736
|
+
<tr>
|
|
737
|
+
<td class="py-2 pr-4 font-mono text-sky-400">layout / controlConfig / children</td>
|
|
738
|
+
<td class="py-2 pr-4 font-mono text-xs text-slate-400">LayoutNode | WidgetSinglePageConfig | ControlWidgetConfig | ReactNode</td>
|
|
739
|
+
<td class="py-2">Nhận cây JSON DSL, object đa kích cỡ, cấu hình <code>ControlWidget</code> (kèm <code>size="control"</code>), hoặc thẻ JSX lồng trực tiếp.</td>
|
|
740
|
+
</tr>
|
|
741
|
+
<tr>
|
|
742
|
+
<td class="py-2 pr-4 font-mono text-sky-400">showBadge</td>
|
|
743
|
+
<td class="py-2 pr-4 font-mono text-xs text-slate-400">boolean (true)</td>
|
|
744
|
+
<td class="py-2">Hiển thị nhãn kích thước chuẩn ở góc trên.</td>
|
|
745
|
+
</tr>
|
|
746
|
+
<tr>
|
|
747
|
+
<td class="py-2 pr-4 font-mono text-sky-400">interactiveSizeSwitch</td>
|
|
748
|
+
<td class="py-2 pr-4 font-mono text-xs text-slate-400">boolean (false)</td>
|
|
749
|
+
<td class="py-2">Hiển thị thanh chuyển nhanh giữa Small / Medium / Large / Lock Screen.</td>
|
|
750
|
+
</tr>
|
|
751
|
+
<tr>
|
|
752
|
+
<td class="py-2 pr-4 font-mono text-sky-400">onAction</td>
|
|
753
|
+
<td class="py-2 pr-4 font-mono text-xs text-slate-400">(actionId: string) => void</td>
|
|
754
|
+
<td class="py-2">Nhận sự kiện khi bấm nút hoặc toggle bên trong khung xem trước.</td>
|
|
755
|
+
</tr>
|
|
756
|
+
</tbody>
|
|
757
|
+
</table>
|
|
758
|
+
</div>
|
|
580
759
|
|
|
581
760
|
<div class="relative">
|
|
582
761
|
<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
762
|
<pre><code class="language-tsx">import React from 'react';
|
|
584
763
|
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';
|
|
764
|
+
import { WidgetPreview, VStack, HStack, Text, Badge, Button } from 'react-native-live-widgets';
|
|
594
765
|
|
|
595
|
-
export default function
|
|
766
|
+
export default function PreviewScreen() {
|
|
596
767
|
return (
|
|
597
768
|
<View style={{ flex: 1, padding: 16 }}>
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
onAction={(actionId) => console.log('User click button:', actionId)}
|
|
769
|
+
<WidgetPreview
|
|
770
|
+
size="medium"
|
|
771
|
+
showBadge
|
|
772
|
+
interactiveSizeSwitch
|
|
773
|
+
onAction={(actionId) => console.log('Action clicked in preview:', actionId)}
|
|
604
774
|
>
|
|
605
|
-
<VStack padding={16} backgroundColor="#0F172A" borderRadius={18}>
|
|
606
|
-
<HStack justifyContent="spaceBetween"
|
|
775
|
+
<VStack padding={16} backgroundColor="#0F172A" borderRadius={18} spacing={8}>
|
|
776
|
+
<HStack justifyContent="spaceBetween" alignment="center">
|
|
607
777
|
<Text fontSize={15} fontWeight="bold" color="#FFFFFF">Ca Làm Việc Hôm Nay</Text>
|
|
608
778
|
<Badge text="08:00 - 17:30" backgroundColor="#064E3B" textColor="#6EE7B7" />
|
|
609
779
|
</HStack>
|
|
610
|
-
|
|
611
|
-
<
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
title="⚡ Check-in Ngay"
|
|
617
|
-
actionId="FASTDO_CHECKIN"
|
|
618
|
-
backgroundColor="#0284C7"
|
|
619
|
-
color="#FFFFFF"
|
|
620
|
-
margin={{ top: 12 }}
|
|
780
|
+
<Text fontSize={13} color="#94A3B8">Vị trí: Văn phòng Fastdo Đà Nẵng</Text>
|
|
781
|
+
<Button
|
|
782
|
+
title="⚡ Check-in Ngay"
|
|
783
|
+
actionId="FASTDO_CHECKIN"
|
|
784
|
+
backgroundColor="#0284C7"
|
|
785
|
+
textColor="#FFFFFF"
|
|
621
786
|
/>
|
|
622
787
|
</VStack>
|
|
623
788
|
</WidgetPreview>
|
|
@@ -628,55 +793,242 @@ export default function HomeScreen() {
|
|
|
628
793
|
</div>
|
|
629
794
|
</section>
|
|
630
795
|
|
|
631
|
-
<!-- Section: Exact Dynamic Hit Layer & Chronometer Countdown (v1.2.
|
|
796
|
+
<!-- Section: Exact Dynamic Hit Layer & Chronometer Countdown (v1.2.2) -->
|
|
632
797
|
<section id="exact-hit-layer" class="space-y-6">
|
|
633
798
|
<div class="border-b border-cardBorder pb-4">
|
|
634
799
|
<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.
|
|
636
|
-
<h2 class="text-2xl sm:text-3xl font-extrabold text-white">
|
|
637
|
-
Vùng Bấm Động Từng Pixel &
|
|
800
|
+
<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" data-i18n="hit_badge">v1.2.2 Mới</span>
|
|
801
|
+
<h2 class="text-2xl sm:text-3xl font-extrabold text-white" data-i18n="hit_title">
|
|
802
|
+
Vùng Bấm Động Từng Pixel, Chronometer & Swift 6 Ready
|
|
638
803
|
</h2>
|
|
639
804
|
</div>
|
|
640
|
-
<p class="mt-2 text-slate-400 text-sm sm:text-base">
|
|
641
|
-
|
|
805
|
+
<p class="mt-2 text-slate-400 text-sm sm:text-base leading-relaxed" data-i18n="hit_desc">
|
|
806
|
+
Bản phát hành <strong>v1.2.2</strong> tái cấu trúc toàn diện hệ thống tương tác cảm ứng trên Android Home Screen Widgets, tích hợp đồng hồ đếm ngược phần cứng native và tương thích hoàn toàn <strong>Swift 6 Language Mode</strong> trên Xcode mới.
|
|
642
807
|
</p>
|
|
643
808
|
</div>
|
|
644
809
|
|
|
645
810
|
<div class="grid grid-cols-1 md:grid-cols-2 gap-6">
|
|
646
|
-
<div class="bg-darkCard border border-cardBorder rounded-2xl p-
|
|
811
|
+
<div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-3">
|
|
647
812
|
<h3 class="font-bold text-white text-base flex items-center space-x-2">
|
|
648
813
|
<i data-lucide="crosshair" class="w-5 h-5 text-emerald-400"></i>
|
|
649
|
-
<span>Exact Dynamic Hit Layer
|
|
814
|
+
<span data-i18n="hit_card1_title">1. Exact Dynamic Hit Layer (<code>rn_hit_layer</code>)</span>
|
|
650
815
|
</h3>
|
|
651
|
-
<p class="text-xs text-slate-400 leading-relaxed">
|
|
652
|
-
Thay thế hoàn toàn lưới
|
|
816
|
+
<p class="text-xs sm:text-sm text-slate-400 leading-relaxed" data-i18n="hit_card1_desc">
|
|
817
|
+
Thay thế hoàn toàn lưới cố định cũ bằng <code>FrameLayout</code> động (<code>rn_live_widget_hit_zone.xml</code>). Giải thuật <code>computeCanvasMapping</code> ánh xạ chính xác toạ độ từ Bitmap Canvas sang khung Launcher thật (xử lý bù viền <code>fitCenter</code> letterboxing). Bấm vào nút/checkbox nào ăn đúng 100% nút đó, vùng trống hoàn toàn không kích hoạt nhầm.
|
|
653
818
|
</p>
|
|
654
819
|
</div>
|
|
655
820
|
|
|
656
|
-
<div class="bg-darkCard border border-cardBorder rounded-2xl p-
|
|
821
|
+
<div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-3">
|
|
657
822
|
<h3 class="font-bold text-white text-base flex items-center space-x-2">
|
|
658
823
|
<i data-lucide="timer" class="w-5 h-5 text-sky-400"></i>
|
|
659
|
-
<span>Native Chronometer Countdown (Android)</span>
|
|
824
|
+
<span data-i18n="hit_card2_title">2. Native Chronometer Countdown (Android)</span>
|
|
660
825
|
</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>.
|
|
826
|
+
<p class="text-xs sm:text-sm text-slate-400 leading-relaxed" data-i18n="hit_card2_desc">
|
|
827
|
+
Tích hợp trực tiếp <code>android.widget.Chronometer</code> với <code>setChronometerCountDown(true)</code> và <code>baseMillis = SystemClock.elapsedRealtime() + remainingMillis</code>. Khi có timer đếm ngược, hệ thống ẩn text tĩnh trên Bitmap để đồng hồ native tự chạy giật lùi 1s/lần mà không phải vẽ lại ảnh Canvas.
|
|
828
|
+
</p>
|
|
829
|
+
</div>
|
|
830
|
+
|
|
831
|
+
<div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-3">
|
|
832
|
+
<h3 class="font-bold text-white text-base flex items-center space-x-2">
|
|
833
|
+
<i data-lucide="brackets" class="w-5 h-5 text-amber-400"></i>
|
|
834
|
+
<span data-i18n="hit_card3_title">3. Nội suy Biến động & <code>defaultChecked</code> Store</span>
|
|
835
|
+
</h3>
|
|
836
|
+
<p class="text-xs sm:text-sm text-slate-400 leading-relaxed" data-i18n="hit_card3_desc">
|
|
837
|
+
<code>DynamicWidgetStateStore</code> hỗ trợ nội suy chuỗi mẫu <code>{{id}}</code>, <code>{{title}}</code>, giá trị bộ đếm phẳng và tự động lưu trạng thái khởi tạo <code>defaultChecked</code> của công tắc <code>checked: true</code> ngay lần render đầu, giúp tắt công tắc mượt mà ngay lần chạm đầu tiên.
|
|
838
|
+
</p>
|
|
839
|
+
</div>
|
|
840
|
+
|
|
841
|
+
<div class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-3">
|
|
842
|
+
<h3 class="font-bold text-white text-base flex items-center space-x-2">
|
|
843
|
+
<i data-lucide="shield-check" class="w-5 h-5 text-purple-400"></i>
|
|
844
|
+
<span data-i18n="hit_card4_title">4. Tương thích Swift 6 Language Mode (iOS)</span>
|
|
845
|
+
</h3>
|
|
846
|
+
<p class="text-xs sm:text-sm text-slate-400 leading-relaxed" data-i18n="hit_card4_desc">
|
|
847
|
+
Khắc phục lỗi biên dịch <code>type '()' cannot conform to 'View'</code> trên Xcode mới bằng cách đóng gói closure cho <code>Font</code> trong <code>renderText()</code>, tách logic accessibility sang hàm thuần <code>buildAccessibilityView(content:) -> AnyView</code>, và bổ sung <code>EmptyView()</code> cho các nhánh <code>ContainerStyleModifier</code>.
|
|
663
848
|
</p>
|
|
664
849
|
</div>
|
|
665
850
|
</div>
|
|
666
851
|
</section>
|
|
667
852
|
|
|
668
853
|
<!-- Section: Declarative UI Catalog -->
|
|
669
|
-
<section id="dsl-catalog" class="space-y-
|
|
854
|
+
<section id="dsl-catalog" class="space-y-8">
|
|
670
855
|
<div class="border-b border-cardBorder pb-4">
|
|
671
856
|
<h2 class="text-2xl sm:text-3xl font-extrabold text-white flex items-center space-x-2.5">
|
|
672
857
|
<i data-lucide="boxes" class="w-7 h-7 text-sky-400"></i>
|
|
673
|
-
<span>Declarative UI Engine Catalog (
|
|
858
|
+
<span>Declarative UI Engine Catalog (JSX & <code>UI.*</code>)</span>
|
|
674
859
|
</h2>
|
|
675
860
|
<p class="mt-2 text-slate-400 text-sm sm:text-base">
|
|
676
|
-
|
|
861
|
+
Toàn bộ hệ sinh thái component khai báo có TypeScript autocompletion đầy đủ và ánh xạ tương đương sang SwiftUI (iOS) & 2D Canvas / RemoteViews (Android).
|
|
862
|
+
</p>
|
|
863
|
+
</div>
|
|
864
|
+
|
|
865
|
+
<!-- 1. Layout Containers -->
|
|
866
|
+
<div id="dsl-containers" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
867
|
+
<div class="flex flex-wrap items-center justify-between gap-2">
|
|
868
|
+
<h3 class="font-bold text-white text-lg flex items-center space-x-2">
|
|
869
|
+
<i data-lucide="layout-grid" class="w-5 h-5 text-sky-400"></i>
|
|
870
|
+
<span>Bố cục: <code>VStack</code>, <code>HStack</code>, <code>ZStack</code>, <code>Grid</code>, <code>Spacer</code> & <code>Divider</code></span>
|
|
871
|
+
</h3>
|
|
872
|
+
<span class="text-xs bg-sky-500/10 text-sky-300 px-2.5 py-0.5 rounded-full font-mono">ContainerProps</span>
|
|
873
|
+
</div>
|
|
874
|
+
<p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
|
|
875
|
+
Hỗ trợ xếp dọc (<code>VStack</code>), xếp ngang (<code>HStack</code>), xếp chồng lớp (<code>ZStack</code>), chia lưới nhiều cột đều nhau (<code>Grid</code>), khoảng trống co giãn (<code>Spacer</code>) và đường kẻ phân cách (<code>Divider</code>). Hỗ trợ các thuộc tính: <code>padding</code>, <code>paddingHorizontal</code>, <code>paddingVertical</code>, <code>spacing</code> (alias <code>gap</code>), <code>alignment</code>, <code>justifyContent</code>, <code>backgroundColor</code>, <code>gradient</code>, <code>borderRadius</code> (alias <code>cornerRadius</code>), <code>borderWidth</code>, <code>borderColor</code>, <code>borderStyle</code>.
|
|
876
|
+
</p>
|
|
877
|
+
<div class="relative">
|
|
878
|
+
<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>
|
|
879
|
+
<pre><code class="language-typescript">UI.VStack(
|
|
880
|
+
{ padding: 14, backgroundColor: '#1A1D24', borderRadius: 16, spacing: 10 },
|
|
881
|
+
// 1. ZStack: Xếp chồng chấm trạng thái lên góc phải dưới Avatar
|
|
882
|
+
UI.HStack(
|
|
883
|
+
{ spacing: 10, alignment: 'center' },
|
|
884
|
+
UI.ZStack(
|
|
885
|
+
{ zAlignment: 'bottomTrailing' },
|
|
886
|
+
UI.Image({ url: 'https://example.com/avatar.jpg', width: 44, height: 44, borderRadius: 22 }),
|
|
887
|
+
UI.Badge('●', { backgroundColor: '#10B981', textColor: '#FFFFFF', fontSize: 8 })
|
|
888
|
+
),
|
|
889
|
+
UI.VStack(
|
|
890
|
+
{ spacing: 2 },
|
|
891
|
+
UI.Text('Nguyễn Văn A', { fontWeight: 'bold', color: '#FFFFFF' }),
|
|
892
|
+
UI.Text('Đang trực tuyến', { fontSize: 11, color: '#94A3B8' })
|
|
893
|
+
),
|
|
894
|
+
UI.Spacer()
|
|
895
|
+
),
|
|
896
|
+
UI.Divider({ color: '#334155', thickness: 1, marginVertical: 2 }),
|
|
897
|
+
// 2. Grid: Chia lưới 2 cột đều nhau cho bảng chỉ số KPI
|
|
898
|
+
UI.Grid(
|
|
899
|
+
{ columns: 2, columnSpacing: 8, rowSpacing: 8 },
|
|
900
|
+
UI.VStack(
|
|
901
|
+
{ padding: 8, backgroundColor: '#1E293B', borderRadius: 8 },
|
|
902
|
+
UI.Text('Doanh thu', { fontSize: 10, color: '#94A3B8' }),
|
|
903
|
+
UI.Text('4.85 Tỷ', { fontSize: 14, fontWeight: 'bold', color: '#FFFFFF' })
|
|
904
|
+
),
|
|
905
|
+
UI.VStack(
|
|
906
|
+
{ padding: 8, backgroundColor: '#1E293B', borderRadius: 8 },
|
|
907
|
+
UI.Text('Đơn hàng', { fontSize: 10, color: '#94A3B8' }),
|
|
908
|
+
UI.Text('1,420', { fontSize: 14, fontWeight: 'bold', color: '#34D399' })
|
|
909
|
+
)
|
|
910
|
+
)
|
|
911
|
+
)</code></pre>
|
|
912
|
+
</div>
|
|
913
|
+
</div>
|
|
914
|
+
|
|
915
|
+
<!-- 2. Text & Badge -->
|
|
916
|
+
<div id="dsl-text-badge" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
917
|
+
<div class="flex flex-wrap items-center justify-between gap-2">
|
|
918
|
+
<h3 class="font-bold text-white text-lg flex items-center space-x-2">
|
|
919
|
+
<i data-lucide="type" class="w-5 h-5 text-emerald-400"></i>
|
|
920
|
+
<span>Văn bản & Nhãn: <code>UI.Text</code>, <code>UI.Badge</code> & Nội suy <code>{{field}}</code></span>
|
|
921
|
+
</h3>
|
|
922
|
+
<span class="text-xs bg-emerald-500/10 text-emerald-300 px-2.5 py-0.5 rounded-full font-mono">TextStyle</span>
|
|
923
|
+
</div>
|
|
924
|
+
<p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
|
|
925
|
+
<code>UI.Text</code> tự động thay thế biến động <code>{{checkinTime}}</code>, <code>{{id}}</code>, <code>{{title}}</code>, <code>{{_lastSyncTime}}</code> từ API ngầm/State Store, hỗ trợ <code>typography</code> chuẩn Apple HIG/Material (<code>largeTitle</code> → <code>caption2</code>), <code>fontDesign</code> (<code>monospaced</code>, <code>rounded</code>, <code>serif</code>), <code>numericAnimation</code> (cuộn số iOS 16+), <code>strikethroughWhenToggled</code>, và <code>privacySensitive</code> / <code>redacted</code>.
|
|
677
926
|
</p>
|
|
927
|
+
<div class="relative">
|
|
928
|
+
<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>
|
|
929
|
+
<pre><code class="language-typescript">UI.HStack(
|
|
930
|
+
{ justifyContent: 'spaceBetween', alignment: 'center' },
|
|
931
|
+
UI.Text('Mã #{{id}} • Check-in {{checkinTime}}', {
|
|
932
|
+
color: { light: '#0F172A', dark: '#F8FAFC', tinted: '#38BDF8' },
|
|
933
|
+
typography: 'subheadline',
|
|
934
|
+
fontDesign: 'monospaced',
|
|
935
|
+
numberOfLines: 1,
|
|
936
|
+
strikethroughWhenToggled: 'task_1',
|
|
937
|
+
privacySensitive: true,
|
|
938
|
+
}),
|
|
939
|
+
UI.Badge('+18% KPI', {
|
|
940
|
+
systemName: 'arrow.up.right',
|
|
941
|
+
backgroundColor: '#064E3B',
|
|
942
|
+
textColor: '#34D399',
|
|
943
|
+
fontSize: 10,
|
|
944
|
+
borderRadius: 999,
|
|
945
|
+
})
|
|
946
|
+
)</code></pre>
|
|
947
|
+
</div>
|
|
948
|
+
</div>
|
|
949
|
+
|
|
950
|
+
<!-- 3. Image & System Icons (Apple SF Symbols + Google Material Icons) -->
|
|
951
|
+
<div id="dsl-image" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
952
|
+
<div class="flex flex-wrap items-center justify-between gap-2">
|
|
953
|
+
<h3 class="font-bold text-white text-lg flex items-center space-x-2">
|
|
954
|
+
<i data-lucide="image" class="w-5 h-5 text-pink-400"></i>
|
|
955
|
+
<span data-i18n="dsl_image_title">Hình ảnh & Biểu tượng Hệ thống: <code>UI.Image</code> & <code><Image></code></span>
|
|
956
|
+
</h3>
|
|
957
|
+
<div class="flex items-center space-x-2">
|
|
958
|
+
<span class="text-xs bg-pink-500/10 text-pink-300 px-2.5 py-0.5 rounded-full font-mono">Auto-Cache 360px</span>
|
|
959
|
+
<span class="text-xs bg-emerald-500/10 text-emerald-300 px-2.5 py-0.5 rounded-full font-mono">13,000+ Icons</span>
|
|
960
|
+
</div>
|
|
961
|
+
</div>
|
|
962
|
+
|
|
963
|
+
<p data-i18n="dsl_image_desc" class="text-xs sm:text-sm text-slate-300 leading-relaxed">
|
|
964
|
+
Hỗ trợ <strong>5 nguồn ảnh</strong>: <code>url</code> (tự tải ngầm, nén tối đa 360px tránh vượt ngưỡng 30MB WidgetKit và lưu vào App Group cache), <code>base64</code> (QR/Barcode), <code>systemName</code>, <code>assetName</code>, và <code>filePath</code>.
|
|
965
|
+
Đặc biệt hỗ trợ icon hệ thống đa nền tảng chuyên biệt: <code>systemNameIos</code> (Apple SF Symbols) và <code>systemNameAndroid</code> (Google Material Icons) với gợi ý type IntelliSense đầy đủ.
|
|
966
|
+
</p>
|
|
967
|
+
|
|
968
|
+
<!-- Official Icon Catalog Links -->
|
|
969
|
+
<div class="grid grid-cols-1 sm:grid-cols-2 gap-3 pt-1">
|
|
970
|
+
<a href="https://developer.apple.com/sf-symbols/" target="_blank" class="p-3 rounded-xl bg-slate-900/90 border border-slate-700/80 hover:border-sky-500/50 hover:bg-slate-800/80 transition flex items-center justify-between group">
|
|
971
|
+
<div class="flex items-center space-x-3">
|
|
972
|
+
<div class="w-9 h-9 rounded-lg bg-sky-500/10 text-sky-400 flex items-center justify-center font-bold text-lg">
|
|
973
|
+
🍏
|
|
974
|
+
</div>
|
|
975
|
+
<div>
|
|
976
|
+
<h4 class="text-xs font-bold text-white group-hover:text-sky-300 transition">Apple SF Symbols Catalog</h4>
|
|
977
|
+
<p class="text-[11px] text-slate-400">9,500+ biểu tượng vector native iOS</p>
|
|
978
|
+
</div>
|
|
979
|
+
</div>
|
|
980
|
+
<span class="text-xs text-sky-400 group-hover:translate-x-0.5 transition font-semibold">Tra cứu ↗</span>
|
|
981
|
+
</a>
|
|
982
|
+
|
|
983
|
+
<a href="https://fonts.google.com/icons" target="_blank" class="p-3 rounded-xl bg-slate-900/90 border border-slate-700/80 hover:border-emerald-500/50 hover:bg-slate-800/80 transition flex items-center justify-between group">
|
|
984
|
+
<div class="flex items-center space-x-3">
|
|
985
|
+
<div class="w-9 h-9 rounded-lg bg-emerald-500/10 text-emerald-400 flex items-center justify-center font-bold text-lg">
|
|
986
|
+
🤖
|
|
987
|
+
</div>
|
|
988
|
+
<div>
|
|
989
|
+
<h4 class="text-xs font-bold text-white group-hover:text-emerald-300 transition">Google Material Icons Catalog</h4>
|
|
990
|
+
<p class="text-[11px] text-slate-400">3,800+ vector glyphs Android (snake/kebab)</p>
|
|
991
|
+
</div>
|
|
992
|
+
</div>
|
|
993
|
+
<span class="text-xs text-emerald-400 group-hover:translate-x-0.5 transition font-semibold">Tra cứu ↗</span>
|
|
994
|
+
</a>
|
|
995
|
+
</div>
|
|
996
|
+
|
|
997
|
+
<div class="relative">
|
|
998
|
+
<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>
|
|
999
|
+
<pre><code class="language-typescript">// 1. Ảnh Avatar từ URL mạng có viền & icon dự phòng
|
|
1000
|
+
UI.Image({
|
|
1001
|
+
url: 'https://images.unsplash.com/photo-1534528741775-53994a69daeb?w=300&q=80',
|
|
1002
|
+
fallbackSystemName: 'person.crop.circle.fill',
|
|
1003
|
+
width: 44,
|
|
1004
|
+
height: 44,
|
|
1005
|
+
cornerRadius: 999,
|
|
1006
|
+
contentMode: 'fill',
|
|
1007
|
+
borderColor: '#60A5FA',
|
|
1008
|
+
borderWidth: 2,
|
|
1009
|
+
})
|
|
1010
|
+
|
|
1011
|
+
// 2. Icon hệ thống đa nền tảng (Apple SF Symbols + Google Material Icons)
|
|
1012
|
+
UI.Image({
|
|
1013
|
+
systemNameIos: 'bolt.horizontal.fill', // 9,500+ Apple SF Symbols
|
|
1014
|
+
systemNameAndroid: 'bolt', // 3,800+ Google Material Icons
|
|
1015
|
+
tintColor: '#10B981',
|
|
1016
|
+
width: 24,
|
|
1017
|
+
height: 24,
|
|
1018
|
+
})
|
|
1019
|
+
|
|
1020
|
+
// 3. Hoặc sử dụng dạng JSX React Component:
|
|
1021
|
+
<Image
|
|
1022
|
+
systemNameIos="person.crop.circle.badge.checkmark"
|
|
1023
|
+
systemNameAndroid="verified_user"
|
|
1024
|
+
tintColor="#10B981"
|
|
1025
|
+
width={24}
|
|
1026
|
+
height={24}
|
|
1027
|
+
/></code></pre>
|
|
1028
|
+
</div>
|
|
678
1029
|
</div>
|
|
679
1030
|
|
|
1031
|
+
<!-- 4. Timer, Equalizer, Progress grid -->
|
|
680
1032
|
<div class="grid grid-cols-1 md:grid-cols-2 gap-6">
|
|
681
1033
|
|
|
682
1034
|
<!-- UI.Timer -->
|
|
@@ -688,16 +1040,20 @@ export default function HomeScreen() {
|
|
|
688
1040
|
</span>
|
|
689
1041
|
<span class="text-[10px] text-sky-400 bg-sky-500/10 px-2 py-0.5 rounded font-mono">0% CPU</span>
|
|
690
1042
|
</div>
|
|
691
|
-
<p class="text-xs text-slate-400">
|
|
1043
|
+
<p class="text-xs text-slate-400 leading-relaxed">
|
|
1044
|
+
Nhận <code>targetTimestamp</code> (epoch <strong>giây</strong>), tự đếm lùi (<code>countdown</code>) bằng SwiftUI timer trên iOS và native <code>android.widget.Chronometer</code> trên Android:
|
|
1045
|
+
</p>
|
|
692
1046
|
<div class="relative">
|
|
693
1047
|
<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">
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
1048
|
+
<pre><code class="language-typescript">const targetSec = Math.floor(Date.now() / 1000) + 25 * 60;
|
|
1049
|
+
|
|
1050
|
+
UI.Timer(targetSec, {
|
|
1051
|
+
mode: 'countdown', // 'countdown' | 'countup'
|
|
698
1052
|
color: '#38BDF8',
|
|
699
1053
|
fontSize: 28,
|
|
700
|
-
fontWeight: '
|
|
1054
|
+
fontWeight: 'bold',
|
|
1055
|
+
prefix: 'Còn ',
|
|
1056
|
+
suffix: ' phút',
|
|
701
1057
|
})</code></pre>
|
|
702
1058
|
</div>
|
|
703
1059
|
</div>
|
|
@@ -711,67 +1067,214 @@ export default function HomeScreen() {
|
|
|
711
1067
|
</span>
|
|
712
1068
|
<span class="text-[10px] text-purple-400 bg-purple-500/10 px-2 py-0.5 rounded font-mono">Realtime</span>
|
|
713
1069
|
</div>
|
|
714
|
-
<p class="text-xs text-slate-400">
|
|
1070
|
+
<p class="text-xs text-slate-400 leading-relaxed">
|
|
1071
|
+
Hiển thị sóng âm thanh chuyển động cho audio/podcast qua <code>phase</code> hoặc mảng biên độ <code>levels</code> (0..1):
|
|
1072
|
+
</p>
|
|
715
1073
|
<div class="relative">
|
|
716
1074
|
<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
1075
|
<pre><code class="language-typescript">UI.Equalizer({
|
|
1076
|
+
isPlaying: true,
|
|
718
1077
|
barCount: 5,
|
|
719
|
-
|
|
1078
|
+
tintColor: '#A855F7',
|
|
720
1079
|
height: 20,
|
|
721
|
-
|
|
1080
|
+
barWidth: 3,
|
|
1081
|
+
spacing: 2,
|
|
1082
|
+
phase: 1, // Hoặc levels: [0.3, 0.8, 0.5, 0.9, 0.4]
|
|
722
1083
|
})</code></pre>
|
|
723
1084
|
</div>
|
|
724
1085
|
</div>
|
|
725
1086
|
|
|
726
1087
|
<!-- UI.Progress -->
|
|
727
|
-
<div id="dsl-progress" class="bg-darkCard border border-cardBorder rounded-2xl p-5 space-y-3">
|
|
1088
|
+
<div id="dsl-progress" class="bg-darkCard border border-cardBorder rounded-2xl p-5 space-y-3 md:col-span-2">
|
|
728
1089
|
<div class="flex items-center justify-between">
|
|
729
1090
|
<span class="font-bold text-white text-base flex items-center space-x-2">
|
|
730
1091
|
<i data-lucide="bar-chart-2" class="w-4 h-4 text-emerald-400"></i>
|
|
731
|
-
<span>UI.Progress — Bar, Segmented &
|
|
1092
|
+
<span>UI.Progress — Bar, Segmented & Circular + Tracker & Smart Warning</span>
|
|
732
1093
|
</span>
|
|
733
1094
|
<span class="text-[10px] text-emerald-400 bg-emerald-500/10 px-2 py-0.5 rounded font-mono">ProgressStyle</span>
|
|
734
1095
|
</div>
|
|
735
|
-
<p class="text-xs text-slate-400">
|
|
1096
|
+
<p class="text-xs text-slate-400 leading-relaxed">
|
|
1097
|
+
Hỗ trợ 3 kiểu dáng (<code>'bar'</code>, <code>'segmented'</code>, <code>'circular'</code>), tự chạy theo <code>startTimestamp</code>/<code>targetTimestamp</code>, đổi màu cảnh báo khi sắp hết hạn (<code>warningSeconds</code>, <code>warningTintColor</code>), và gắn icon di chuyển theo đầu thanh (<code>trackerSystemName</code>).
|
|
1098
|
+
</p>
|
|
736
1099
|
<div class="relative">
|
|
737
1100
|
<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)
|
|
1101
|
+
<pre><code class="language-typescript">// 1. Thanh chia 4 chặng (Segmented) cho giao hàng / ca làm
|
|
739
1102
|
UI.Progress({
|
|
740
1103
|
style: 'segmented',
|
|
741
|
-
|
|
742
|
-
|
|
1104
|
+
segments: 4,
|
|
1105
|
+
currentSegment: 3,
|
|
1106
|
+
segmentSpacing: 6,
|
|
743
1107
|
tintColor: '#10B981',
|
|
744
|
-
|
|
1108
|
+
trackColor: '#374151',
|
|
1109
|
+
height: 8,
|
|
1110
|
+
})
|
|
1111
|
+
|
|
1112
|
+
// 2. Vòng tròn tiến độ kèm cảnh báo đổi màu
|
|
1113
|
+
UI.Progress({
|
|
1114
|
+
style: 'circular',
|
|
1115
|
+
value: 0.75,
|
|
1116
|
+
tintColor: '#38BDF8',
|
|
1117
|
+
trackColor: '#1E293B',
|
|
1118
|
+
height: 56,
|
|
1119
|
+
showPercentage: true,
|
|
745
1120
|
})</code></pre>
|
|
746
1121
|
</div>
|
|
747
1122
|
</div>
|
|
1123
|
+
</div>
|
|
748
1124
|
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
1125
|
+
<!-- 5. Gauge & Chart -->
|
|
1126
|
+
<div id="dsl-gauge-chart" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
1127
|
+
<div class="flex flex-wrap items-center justify-between gap-2">
|
|
1128
|
+
<h3 class="font-bold text-white text-lg flex items-center space-x-2">
|
|
1129
|
+
<i data-lucide="gauge" class="w-5 h-5 text-cyan-400"></i>
|
|
1130
|
+
<span>Đồ họa Số liệu: <code>UI.Gauge</code> (240°) & <code>UI.Chart</code> (Bar / Sparkline)</span>
|
|
1131
|
+
</h3>
|
|
1132
|
+
<span class="text-xs bg-cyan-500/10 text-cyan-300 px-2.5 py-0.5 rounded-full font-mono">Canvas Sub-renderer</span>
|
|
1133
|
+
</div>
|
|
1134
|
+
<p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
|
|
1135
|
+
<code>UI.Gauge</code> vẽ đồng hồ cung tròn 240° hiển thị KPI/chỉ số sức khỏe; <code>UI.Chart</code> vẽ biểu đồ cột (<code>'bar'</code>) hoặc đường xu hướng Sparkline (<code>'line'</code>). Trên Android, chỉ phần hộp bao đồ họa được vẽ thành Sub-Bitmap nhỏ (~40KB RAM) để không chạm trần Binder IPC.
|
|
1136
|
+
</p>
|
|
1137
|
+
<div class="relative">
|
|
1138
|
+
<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>
|
|
1139
|
+
<pre><code class="language-typescript">// 1. Đồng hồ đo KPI cung tròn 240°
|
|
1140
|
+
UI.Gauge(0.86, {
|
|
1141
|
+
size: 66,
|
|
1142
|
+
strokeWidth: 7,
|
|
1143
|
+
tintColor: '#38BDF8',
|
|
1144
|
+
trackColor: '#1E293B',
|
|
1145
|
+
valueText: '86%',
|
|
1146
|
+
label: 'KPI Quý',
|
|
1147
|
+
})
|
|
1148
|
+
|
|
1149
|
+
// 2. Biểu đồ Cột / Đường xu hướng 7 ngày
|
|
1150
|
+
UI.Chart([42, 58, 51, 74, 68, 92, 108], {
|
|
1151
|
+
style: 'line', // 'bar' | 'line'
|
|
1152
|
+
labels: ['T2', 'T3', 'T4', 'T5', 'T6', 'T7', 'CN'],
|
|
1153
|
+
tintColor: '#38BDF8',
|
|
1154
|
+
secondaryColor: '#1E3A8A',
|
|
1155
|
+
height: 52,
|
|
1156
|
+
showDots: true,
|
|
1157
|
+
})</code></pre>
|
|
1158
|
+
</div>
|
|
1159
|
+
</div>
|
|
1160
|
+
|
|
1161
|
+
<!-- 6. Interactive: Button, Toggle, Link -->
|
|
1162
|
+
<div id="dsl-interactive" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
1163
|
+
<div class="flex flex-wrap items-center justify-between gap-2">
|
|
1164
|
+
<h3 class="font-bold text-white text-lg flex items-center space-x-2">
|
|
1165
|
+
<i data-lucide="mouse-pointer-click" class="w-5 h-5 text-amber-400"></i>
|
|
1166
|
+
<span>Tương tác: <code>UI.Button</code>, <code>UI.Toggle</code> (<code><Switch></code>/<code><Checkbox></code>) & <code>UI.Link</code></span>
|
|
1167
|
+
</h3>
|
|
1168
|
+
<span class="text-xs bg-amber-500/10 text-amber-300 px-2.5 py-0.5 rounded-full font-mono">AppIntents + Exact Hit Layer</span>
|
|
1169
|
+
</div>
|
|
1170
|
+
<p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
|
|
1171
|
+
Thư viện hỗ trợ các tiền tố <code>actionId</code> xử lý tự động ngay ở tầng Native mà không cần mở App:
|
|
1172
|
+
<code>page:<id></code> / <code>page:next</code> / <code>page:prev</code> (lật trang Widget),
|
|
1173
|
+
<code>toggle:<key></code> (đảo trạng thái tick/switch và lưu ngay vào <code>DynamicWidgetStateStore</code>),
|
|
1174
|
+
và <code>refresh</code> (kéo lại dữ liệu từ Remote API ngay lập tức).
|
|
1175
|
+
</p>
|
|
1176
|
+
<div class="relative">
|
|
1177
|
+
<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>
|
|
1178
|
+
<pre><code class="language-typescript">// 1. Nút chuyển trang hoặc Tick hoàn thành kèm đổi màu
|
|
1179
|
+
UI.Button({
|
|
1180
|
+
title: 'Duyệt PR chấm công',
|
|
1181
|
+
checkedTitle: '✓ Đã duyệt PR',
|
|
1182
|
+
actionId: 'toggle:task_1',
|
|
1183
|
+
backgroundColor: '#F8FAFC',
|
|
1184
|
+
checkedBackgroundColor: '#DCFCE7',
|
|
1185
|
+
textColor: '#1E293B',
|
|
1186
|
+
checkedTextColor: '#15803D',
|
|
1187
|
+
fullWidth: true,
|
|
1188
|
+
})
|
|
1189
|
+
|
|
1190
|
+
// 2. Toggle Checkbox hoặc Switch (JSX cũng có thẻ <Checkbox />, <Switch />)
|
|
1191
|
+
UI.Toggle('Tự động gửi cảnh báo vượt ngưỡng', {
|
|
1192
|
+
actionId: 'toggle:auto_alert',
|
|
1193
|
+
style: 'switch', // 'checkbox' | 'switch'
|
|
1194
|
+
checked: true,
|
|
1195
|
+
tintColor: '#10B981',
|
|
1196
|
+
strikethroughOnCheck: false,
|
|
1197
|
+
})
|
|
1198
|
+
|
|
1199
|
+
// 3. Link bọc khối giao diện mở Deep Link thẳng vào màn hình trong App
|
|
1200
|
+
UI.Link(
|
|
1201
|
+
{ deepLink: 'fastdo://reports/q4', padding: 10, backgroundColor: '#1E293B', borderRadius: 10 },
|
|
1202
|
+
UI.Text('Xem chi tiết báo cáo →', { fontSize: 12, fontWeight: 'bold', color: '#38BDF8' })
|
|
1203
|
+
)</code></pre>
|
|
1204
|
+
</div>
|
|
1205
|
+
</div>
|
|
1206
|
+
|
|
1207
|
+
<!-- 7. UI.Custom & DynamicNodeRegistry -->
|
|
1208
|
+
<div id="dsl-custom" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
1209
|
+
<div class="flex flex-wrap items-center justify-between gap-2">
|
|
1210
|
+
<h3 class="font-bold text-white text-lg flex items-center space-x-2">
|
|
1211
|
+
<i data-lucide="puzzle" class="w-5 h-5 text-indigo-400"></i>
|
|
1212
|
+
<span>Mở rộng Component Native: <code>UI.Custom</code> & <code>DynamicNodeRegistry</code></span>
|
|
1213
|
+
</h3>
|
|
1214
|
+
<span class="text-xs bg-indigo-500/10 text-indigo-300 px-2.5 py-0.5 rounded-full font-mono">SwiftUI & Kotlin Canvas</span>
|
|
1215
|
+
</div>
|
|
1216
|
+
<p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
|
|
1217
|
+
Khi cần nhúng đồ họa hoặc View Native đặc thù mà DSL chưa có sẵn, bạn đăng ký custom renderer trong <code>LiveWidgetsBundle.swift</code> (iOS) và <code>MainApplication.kt</code> (Android), rồi gọi qua <code>UI.Custom('WeatherCard', { ... })</code>.
|
|
1218
|
+
</p>
|
|
1219
|
+
<div class="grid grid-cols-1 lg:grid-cols-2 gap-4">
|
|
1220
|
+
<div class="relative">
|
|
1221
|
+
<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>
|
|
1222
|
+
<pre><code class="language-swift">// iOS (LiveWidgetsBundle.swift)
|
|
1223
|
+
DynamicNodeRegistry.shared.registerView("WeatherCard") { node in
|
|
1224
|
+
let city = node.props?["city"]?.stringValue ?? "Hà Nội"
|
|
1225
|
+
let temp = node.props?["temp"]?.stringValue ?? "28°C"
|
|
1226
|
+
HStack {
|
|
1227
|
+
Image(systemName: "sun.max.fill").foregroundColor(.yellow)
|
|
1228
|
+
Text("\(city): \(temp)").font(.headline)
|
|
1229
|
+
}
|
|
1230
|
+
}</code></pre>
|
|
757
1231
|
</div>
|
|
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
1232
|
<div class="relative">
|
|
760
1233
|
<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-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
useWidgetAction('ACTION_CHECKIN', () => {
|
|
770
|
-
doCheckin();
|
|
771
|
-
});</code></pre>
|
|
1234
|
+
<pre><code class="language-kotlin">// Android (MainApplication.onCreate)
|
|
1235
|
+
DynamicNodeRegistry.register(
|
|
1236
|
+
componentName = "WeatherCard",
|
|
1237
|
+
heightDp = { 44f },
|
|
1238
|
+
drawer = { context, canvas, rect, props, density ->
|
|
1239
|
+
// Vẽ tự do lên Android 2D Canvas
|
|
1240
|
+
}
|
|
1241
|
+
)</code></pre>
|
|
772
1242
|
</div>
|
|
773
1243
|
</div>
|
|
1244
|
+
</div>
|
|
774
1245
|
|
|
1246
|
+
<!-- 8. Styling Modifiers -->
|
|
1247
|
+
<div id="styling-modifiers" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
1248
|
+
<div class="flex flex-wrap items-center justify-between gap-2">
|
|
1249
|
+
<h3 class="font-bold text-white text-lg flex items-center space-x-2">
|
|
1250
|
+
<i data-lucide="palette" class="w-5 h-5 text-fuchsia-400"></i>
|
|
1251
|
+
<span>Styling Modifiers Nâng cao: Gradient, Border Nét Đứt, Shadow, Tinted & RTL</span>
|
|
1252
|
+
</h3>
|
|
1253
|
+
<span class="text-xs bg-fuchsia-500/10 text-fuchsia-300 px-2.5 py-0.5 rounded-full font-mono">Graceful Fallback</span>
|
|
1254
|
+
</div>
|
|
1255
|
+
<p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
|
|
1256
|
+
Nếu thiết bị hoặc phiên bản OS không hỗ trợ một hiệu ứng (ví dụ Gradient trên OS cũ), engine tự động hạ cấp an toàn (lấy màu đầu tiên làm nền đơn sắc) để không bao giờ vỡ giao diện.
|
|
1257
|
+
</p>
|
|
1258
|
+
<div class="relative">
|
|
1259
|
+
<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>
|
|
1260
|
+
<pre><code class="language-tsx"><VStack
|
|
1261
|
+
gradient={{ colors: ['#1E3A8A', '#3B82F6'], startPoint: { x: 0, y: 0 }, endPoint: { x: 1, y: 1 } }}
|
|
1262
|
+
borderWidth={1.5}
|
|
1263
|
+
borderColor="#38BDF8"
|
|
1264
|
+
borderStyle="dashed" // 'solid' | 'dashed' | 'dotted'
|
|
1265
|
+
borderRadius={14}
|
|
1266
|
+
shadowColor="#2563EB"
|
|
1267
|
+
shadowRadius={6}
|
|
1268
|
+
shadowOpacity={0.35}
|
|
1269
|
+
shadowOffset={{ x: 0, y: 3 }}
|
|
1270
|
+
direction="ltr" // Hỗ trợ 'rtl' (isRTL: true)
|
|
1271
|
+
padding={16}
|
|
1272
|
+
>
|
|
1273
|
+
<Text color={{ light: '#0F172A', dark: '#F8FAFC', tinted: '#38BDF8' }} typography="headline">
|
|
1274
|
+
Tự động đổi màu theo Light / Dark / iOS 18 Tinted Mode
|
|
1275
|
+
</Text>
|
|
1276
|
+
</VStack></code></pre>
|
|
1277
|
+
</div>
|
|
775
1278
|
</div>
|
|
776
1279
|
</section>
|
|
777
1280
|
|
|
@@ -783,99 +1286,529 @@ useWidgetAction('ACTION_CHECKIN', () => {
|
|
|
783
1286
|
<span>Core API Reference</span>
|
|
784
1287
|
</h2>
|
|
785
1288
|
<p class="mt-2 text-slate-400 text-sm sm:text-base">
|
|
786
|
-
|
|
1289
|
+
Chi tiết toàn bộ API điều khiển <code>LiveActivity</code>, <code>Widget</code>, React Hooks, <code>SharedStorage</code>, Remote API Sync và Push Notifications.
|
|
787
1290
|
</p>
|
|
788
1291
|
</div>
|
|
789
1292
|
|
|
790
1293
|
<!-- LiveActivity API -->
|
|
791
|
-
<div id="api-liveactivity" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-
|
|
1294
|
+
<div id="api-liveactivity" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-5">
|
|
792
1295
|
<div class="flex items-center justify-between">
|
|
793
|
-
<h3 class="text-lg font-bold text-white">LiveActivity API (iOS 16.1+ & Android 16
|
|
794
|
-
<span class="text-xs bg-sky-500/10 text-sky-400 border border-sky-500/20 px-2.5 py-1 rounded-full">
|
|
1296
|
+
<h3 class="text-lg font-bold text-white">1. <code>LiveActivity</code> API & Dynamic Island (iOS 16.1+ & Android 16)</h3>
|
|
1297
|
+
<span class="text-xs bg-sky-500/10 text-sky-400 border border-sky-500/20 px-2.5 py-1 rounded-full">ActivityKit + ProgressStyle</span>
|
|
795
1298
|
</div>
|
|
796
1299
|
|
|
797
1300
|
<div class="overflow-x-auto">
|
|
798
1301
|
<table class="w-full text-left text-xs sm:text-sm border-collapse">
|
|
799
1302
|
<thead>
|
|
800
1303
|
<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>
|
|
1304
|
+
<th class="py-2.5 pr-3 font-semibold">Hàm</th>
|
|
1305
|
+
<th class="py-2.5 pr-3 font-semibold">Tham số</th>
|
|
803
1306
|
<th class="py-2.5 font-semibold">Mô tả</th>
|
|
804
1307
|
</tr>
|
|
805
1308
|
</thead>
|
|
806
1309
|
<tbody class="divide-y divide-cardBorder text-slate-300">
|
|
807
1310
|
<tr>
|
|
808
|
-
<td class="py-2.5 font-mono text-sky-400 font-medium">LiveActivity.start(
|
|
809
|
-
<td class="py-2.5 text-xs text-slate-400 font-mono">
|
|
810
|
-
<td class="py-2.5">Bắt đầu
|
|
1311
|
+
<td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.start(options)</td>
|
|
1312
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">StartActivityOptions</td>
|
|
1313
|
+
<td class="py-2.5">Bắt đầu Live Activity (iOS Lock Screen + Dynamic Island) hoặc Promoted Live Update Notification (Android).</td>
|
|
811
1314
|
</tr>
|
|
812
1315
|
<tr>
|
|
813
|
-
<td class="py-2.5 font-mono text-sky-400 font-medium">LiveActivity.update(
|
|
814
|
-
<td class="py-2.5 text-xs text-slate-400 font-mono">
|
|
815
|
-
<td class="py-2.5">Cập nhật
|
|
1316
|
+
<td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.update(options)</td>
|
|
1317
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">UpdateActivityOptions</td>
|
|
1318
|
+
<td class="py-2.5">Cập nhật layout, Dynamic Island, tiến trình hoặc pha theo <code>activityId</code>.</td>
|
|
816
1319
|
</tr>
|
|
817
1320
|
<tr>
|
|
818
|
-
<td class="py-2.5 font-mono text-sky-400 font-medium">LiveActivity.end(id,
|
|
819
|
-
<td class="py-2.5 text-xs text-slate-400 font-mono">id
|
|
820
|
-
<td class="py-2.5">Kết thúc Live Activity (chính sách đóng
|
|
1321
|
+
<td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.end(id, options?)</td>
|
|
1322
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">id, EndActivityOptions</td>
|
|
1323
|
+
<td class="py-2.5">Kết thúc Live Activity (chính sách đóng <code>dismissalPolicy</code>, hiển thị trạng thái cuối trước khi ẩn).</td>
|
|
821
1324
|
</tr>
|
|
822
1325
|
<tr>
|
|
823
|
-
<td class="py-2.5 font-mono text-sky-400 font-medium">LiveActivity.
|
|
824
|
-
<td class="py-2.5 text-xs text-slate-400 font-mono">none</td>
|
|
825
|
-
<td class="py-2.5"
|
|
1326
|
+
<td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.endAll()</td>
|
|
1327
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">none</td>
|
|
1328
|
+
<td class="py-2.5">Đóng toàn bộ các Live Activities đang hoạt động.</td>
|
|
826
1329
|
</tr>
|
|
827
1330
|
<tr>
|
|
828
|
-
<td class="py-2.5 font-mono text-sky-400 font-medium">LiveActivity.
|
|
829
|
-
<td class="py-2.5 text-xs text-slate-400 font-mono">id
|
|
830
|
-
<td class="py-2.5">
|
|
1331
|
+
<td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.getActiveActivities() / get(id) / isActive(id)</td>
|
|
1332
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">id?: string</td>
|
|
1333
|
+
<td class="py-2.5">Quản lý nhiều phiên đồng thời: trả về <code>activityId</code>, <code>systemActivityId</code>, <code>isStale</code>, <code>relevanceScore</code>, <code>scheduledEndTimestamp</code>, <code>pushToken</code>.</td>
|
|
1334
|
+
</tr>
|
|
1335
|
+
<tr>
|
|
1336
|
+
<td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.onStateChange(listener) / cleanupExpired()</td>
|
|
1337
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">LiveActivityStateEvent</td>
|
|
1338
|
+
<td class="py-2.5">Lắng nghe chuyển đổi vòng đời (<code>active</code>, <code>started_by_push</code>, <code>stale</code>, <code>expired</code>, <code>ended</code>, <code>dismissed</code>) và tự động dọn dẹp phiên hết hạn.</td>
|
|
1339
|
+
</tr>
|
|
1340
|
+
<tr>
|
|
1341
|
+
<td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.areActivitiesEnabled() / canPostPromoted()</td>
|
|
1342
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">Promise<boolean></td>
|
|
1343
|
+
<td class="py-2.5">Kiểm tra quyền hiển thị Live Activity (iOS) / Promoted Notification (Android 16).</td>
|
|
1344
|
+
</tr>
|
|
1345
|
+
<tr>
|
|
1346
|
+
<td class="py-2.5 pr-3 font-mono text-sky-400 font-medium">LiveActivity.registerBackgroundActionHandler(cb?)</td>
|
|
1347
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">HeadlessJs (Android)</td>
|
|
1348
|
+
<td class="py-2.5">Đăng ký trong <code>index.js</code> để xử lý sự kiện nút bấm ngay cả khi App Android đã bị tắt.</td>
|
|
831
1349
|
</tr>
|
|
832
1350
|
</tbody>
|
|
833
1351
|
</table>
|
|
834
1352
|
</div>
|
|
1353
|
+
|
|
1354
|
+
<div class="relative">
|
|
1355
|
+
<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>
|
|
1356
|
+
<pre><code class="language-typescript">// Cấu hình Dynamic Island + Stale UI + RelevanceScore + Auto Scheduled End
|
|
1357
|
+
await LiveActivity.start({
|
|
1358
|
+
activityId: 'shift_01',
|
|
1359
|
+
lockScreen: lockScreenCardNode,
|
|
1360
|
+
staleLockScreen: staleFallbackNode,
|
|
1361
|
+
staleTimestamp: shiftEndSec - 120,
|
|
1362
|
+
scheduledEndTimestamp: shiftEndSec,
|
|
1363
|
+
expiredLockScreen: completedSummaryNode,
|
|
1364
|
+
expiredDismissalPolicy: 'default',
|
|
1365
|
+
relevanceScore: 95,
|
|
1366
|
+
alertConfig: { title: 'Bắt đầu ca làm', body: 'Ca hành chính đã kích hoạt!', sound: 'default' },
|
|
1367
|
+
dynamicIsland: {
|
|
1368
|
+
compactLeading: UI.HStack({ spacing: 4 }, avatarImg, UI.Text('08:02', { fontSize: 12, color: '#60A5FA' })),
|
|
1369
|
+
compactTrailing: UI.Timer(shiftEndSec, { mode: 'countdown', fontSize: 12, color: '#60A5FA' }),
|
|
1370
|
+
minimal: UI.Image({ systemName: 'clock.fill', tintColor: '#60A5FA', width: 14, height: 14 }),
|
|
1371
|
+
expanded: {
|
|
1372
|
+
leading: UI.Text('ĐANG TRONG CA', { color: '#60A5FA', fontSize: 12, fontWeight: 'bold' }),
|
|
1373
|
+
trailing: UI.Timer(shiftEndSec, { mode: 'countdown', color: '#FFFFFF', fontSize: 14 }),
|
|
1374
|
+
bottom: UI.Progress({ style: 'segmented', segments: 4, value: 0.75, tintColor: '#3B82F6', height: 6 }),
|
|
1375
|
+
},
|
|
1376
|
+
},
|
|
1377
|
+
phases: [
|
|
1378
|
+
{ id: 'warning', triggerTimestamp: shiftEndSec - 300, alertTitle: 'Sắp hết ca!', alertBody: 'Còn 5 phút nữa.' },
|
|
1379
|
+
],
|
|
1380
|
+
});</code></pre>
|
|
1381
|
+
</div>
|
|
835
1382
|
</div>
|
|
836
1383
|
|
|
837
1384
|
<!-- Widget API -->
|
|
838
|
-
<div id="api-widget" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-
|
|
1385
|
+
<div id="api-widget" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-5">
|
|
839
1386
|
<div class="flex items-center justify-between">
|
|
840
|
-
<h3 class="text-lg font-bold text-white">Widget API (
|
|
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>
|
|
1387
|
+
<h3 class="text-lg font-bold text-white">2. <code>Widget</code> API (Multi-Page, ExtraLarge, StandBy & Control Center)</h3>
|
|
1388
|
+
<span class="text-xs bg-emerald-500/10 text-emerald-400 border border-emerald-500/20 px-2.5 py-1 rounded-full">WidgetKit + ControlWidget</span>
|
|
842
1389
|
</div>
|
|
843
1390
|
|
|
844
1391
|
<div class="overflow-x-auto">
|
|
845
1392
|
<table class="w-full text-left text-xs sm:text-sm border-collapse">
|
|
846
1393
|
<thead>
|
|
847
1394
|
<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>
|
|
1395
|
+
<th class="py-2.5 pr-3 font-semibold">Hàm</th>
|
|
1396
|
+
<th class="py-2.5 pr-3 font-semibold">Tham số</th>
|
|
850
1397
|
<th class="py-2.5 font-semibold">Mô tả</th>
|
|
851
1398
|
</tr>
|
|
852
1399
|
</thead>
|
|
853
1400
|
<tbody class="divide-y divide-cardBorder text-slate-300">
|
|
854
1401
|
<tr>
|
|
855
|
-
<td class="py-2.5 font-mono text-emerald-400 font-medium">Widget.
|
|
856
|
-
<td class="py-2.5 text-xs text-slate-400 font-mono">
|
|
857
|
-
<td class="py-2.5">Cập nhật
|
|
1402
|
+
<td class="py-2.5 pr-3 font-mono text-emerald-400 font-medium">Widget.setLayout(key, config, appGroup?)</td>
|
|
1403
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">WidgetLayoutConfig (alias <code>Widget.update</code>)</td>
|
|
1404
|
+
<td class="py-2.5">Cập nhật giao diện cho <code>small</code>, <code>medium</code>, <code>large</code>, <code>extraLarge</code>, <code>standBy</code>, <code>pages</code> đa trang và 3 kích thước Lock Screen iOS (<code>accessoryRectangular</code>, <code>accessoryCircular</code>, <code>accessoryInline</code>).</td>
|
|
1405
|
+
</tr>
|
|
1406
|
+
<tr>
|
|
1407
|
+
<td class="py-2.5 pr-3 font-mono text-emerald-400 font-medium">ControlWidget.set(id, cfg) / Widget.setControl(id, cfg)</td>
|
|
1408
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">UI.ControlButton / UI.ControlToggle</td>
|
|
1409
|
+
<td class="py-2.5">Cấu hình nút/công tắc nhanh trong iOS 18 Control Center, Action Button & Lock Screen (<code>DynamicControlWidget.swift</code>) và Android Quick Settings Tile (<code>DynamicQuickSettingsTileService.kt</code>). Hỗ trợ xem trước với <code><WidgetPreview size="control" /></code>.</td>
|
|
1410
|
+
</tr>
|
|
1411
|
+
<tr>
|
|
1412
|
+
<td class="py-2.5 pr-3 font-mono text-emerald-400 font-medium">Widget.reload(kind) / Widget.reloadAll()</td>
|
|
1413
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">kind: string</td>
|
|
1414
|
+
<td class="py-2.5">Yêu cầu OS vẽ lại timeline / giao diện widget ngay lập tức.</td>
|
|
1415
|
+
</tr>
|
|
1416
|
+
<tr>
|
|
1417
|
+
<td class="py-2.5 pr-3 font-mono text-emerald-400 font-medium">Widget.isPinSupported() / requestPin()</td>
|
|
1418
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">Android 8.0+</td>
|
|
1419
|
+
<td class="py-2.5">Mở hộp thoại hệ thống cho người dùng ghim Widget ra Home Screen ngay trong App.</td>
|
|
1420
|
+
</tr>
|
|
1421
|
+
<tr>
|
|
1422
|
+
<td class="py-2.5 pr-3 font-mono text-emerald-400 font-medium">Widget.getCapabilities()</td>
|
|
1423
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">Promise<WidgetCapabilities></td>
|
|
1424
|
+
<td class="py-2.5">Kiểm tra thiết bị có hỗ trợ Dynamic Island, iOS 18 Tinted Mode, Interactive Intents...</td>
|
|
1425
|
+
</tr>
|
|
1426
|
+
<tr>
|
|
1427
|
+
<td class="py-2.5 pr-3 font-mono text-emerald-400 font-medium">Widget.inspectIR(layout) / compileIR(layout)</td>
|
|
1428
|
+
<td class="py-2.5 pr-3 text-xs text-slate-400 font-mono">LayoutNode | SinglePageConfig</td>
|
|
1429
|
+
<td class="py-2.5">Phân tích cây UI Intermediate Representation, kế hoạch Native vs Canvas và tóm tắt TalkBack/VoiceOver.</td>
|
|
1430
|
+
</tr>
|
|
1431
|
+
</tbody>
|
|
1432
|
+
</table>
|
|
1433
|
+
</div>
|
|
1434
|
+
|
|
1435
|
+
<div class="relative">
|
|
1436
|
+
<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>
|
|
1437
|
+
<pre><code class="language-typescript">// Widget đa trang (Pages) + Lock Screen iOS 16+ + Ghim nhanh Android
|
|
1438
|
+
await Widget.setLayout('main', {
|
|
1439
|
+
initialPage: 'overview',
|
|
1440
|
+
pages: {
|
|
1441
|
+
overview: { small: overviewSmall, medium: overviewMedium, large: overviewLarge },
|
|
1442
|
+
tasks: { small: tasksSmall, medium: tasksMedium, large: tasksLarge },
|
|
1443
|
+
},
|
|
1444
|
+
accessoryRectangular: UI.Text('★ Công việc hôm nay: 3/5', { fontSize: 12, fontWeight: 'bold' }),
|
|
1445
|
+
accessoryCircular: UI.Gauge(0.6, { size: 44, valueText: '60%' }),
|
|
1446
|
+
accessoryInline: UI.Text('♪ Đang trong ca • 08:00 - 17:30'),
|
|
1447
|
+
});
|
|
1448
|
+
|
|
1449
|
+
if (await Widget.isPinSupported()) {
|
|
1450
|
+
await Widget.requestPin();
|
|
1451
|
+
}</code></pre>
|
|
1452
|
+
</div>
|
|
1453
|
+
</div>
|
|
1454
|
+
|
|
1455
|
+
<!-- React Hooks & SharedStorage -->
|
|
1456
|
+
<div id="api-hooks" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
1457
|
+
<div class="flex flex-wrap items-center justify-between gap-2">
|
|
1458
|
+
<h3 class="text-lg font-bold text-white">3. React Hooks (Fast Refresh Resilient) & <code>SharedStorage</code></h3>
|
|
1459
|
+
<span class="text-xs bg-purple-500/10 text-purple-300 border border-purple-500/20 px-2.5 py-1 rounded-full">Hooks & App Group</span>
|
|
1460
|
+
</div>
|
|
1461
|
+
<p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
|
|
1462
|
+
Các Hook tự động dọn dẹp listener khi unmount và đồng bộ 2 chiều qua App Group (iOS) / SharedPreferences (Android). Với các nghiệp vụ quan trọng (như Chấm công) khi App bị người dùng Force-Kill, hãy dùng mô hình <strong>Offline-First State Queue</strong> qua <code>SharedStorage</code>.
|
|
1463
|
+
</p>
|
|
1464
|
+
<div class="relative">
|
|
1465
|
+
<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>
|
|
1466
|
+
<pre><code class="language-typescript">import {
|
|
1467
|
+
useWidgetAction, useLiveActivity, useWidgetState, SharedStorage
|
|
1468
|
+
} from 'react-native-live-widgets';
|
|
1469
|
+
|
|
1470
|
+
// 1. Lắng nghe bấm nút từ Widget / Dynamic Island (an toàn với Fast Refresh)
|
|
1471
|
+
useWidgetAction('INCREMENT', (actionId, payload) => {
|
|
1472
|
+
console.log('Clicked:', actionId, payload);
|
|
1473
|
+
});
|
|
1474
|
+
|
|
1475
|
+
// 2. Quản lý vòng đời Live Activity bằng Hook
|
|
1476
|
+
const { activityId, isActive, start, update, end } = useLiveActivity();
|
|
1477
|
+
|
|
1478
|
+
// 3. State đồng bộ 2 chiều với Native Store
|
|
1479
|
+
const [counter, setCounter, resetCounter] = useWidgetState('widget_counter', 0);
|
|
1480
|
+
|
|
1481
|
+
// 4. Đọc / ghi trực tiếp vào App Group / SharedPreferences
|
|
1482
|
+
await SharedStorage.set('pending_checkin', { timestamp: Date.now() }, 'group.com.yourapp');
|
|
1483
|
+
const saved = await SharedStorage.get('pending_checkin', 'group.com.yourapp');</code></pre>
|
|
1484
|
+
</div>
|
|
1485
|
+
</div>
|
|
1486
|
+
|
|
1487
|
+
<!-- Remote API Sync & Background Data Engine 2.0 -->
|
|
1488
|
+
<div id="api-remote-sync" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-5">
|
|
1489
|
+
<div class="flex flex-wrap items-center justify-between gap-2">
|
|
1490
|
+
<h3 class="text-lg font-bold text-white">4. Background Data Engine 2.0 & Structured Data Binding</h3>
|
|
1491
|
+
<span class="text-xs bg-indigo-500/10 text-indigo-300 border border-indigo-500/20 px-2.5 py-1 rounded-full">URLSession & AlarmManager</span>
|
|
1492
|
+
</div>
|
|
1493
|
+
<p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
|
|
1494
|
+
Hỗ trợ đầy đủ REST (<code>GET</code>/<code>POST</code>/<code>PUT</code> + <code>body</code>), <code>headers</code>, <code>timeoutMs</code>, <code>cacheTtlSeconds</code>, <code>enableETag</code> (gửi <code>If-None-Match</code> & xử lý HTTP <code>304 Not Modified</code>), <code>maxRetries</code> / <code>retryDelayMs</code> (Exponential Backoff), đa nguồn <code>sources</code>, chuẩn hóa <code>mapping</code> & Pipe Transform, kiểm định <code>schema</code>, tự làm mới token <code>authRefresh</code> khi gặp HTTP <code>401</code>, biến lỗi <code>{{_syncStatus}}</code> / <code>{{_syncError}}</code> / <code>{{_httpStatus}}</code> + <code>errorFallback</code> và Proxy gợi ý kiểu <code>Widget.createDataBinding<T>()</code>.
|
|
1495
|
+
</p>
|
|
1496
|
+
<div class="rounded-xl bg-amber-500/10 border border-amber-500/30 p-3.5 text-xs text-amber-200 leading-relaxed">
|
|
1497
|
+
<strong>⚠️ Lưu ý bắt buộc về Ngân sách Reload của OS:</strong> Không cam kết đồng bộ chính xác mỗi 15 phút khi app bị đóng. Apple WidgetKit sử dụng ngân sách reload động (thường khoảng <strong>40–70 lần/ngày</strong> tùy hành vi người dùng; <code>refreshIntervalMinutes</code> chỉ là mốc thời gian sớm nhất được đề xuất). Android cũng áp dụng giới hạn <em>Doze Mode</em> & <em>App Standby Buckets</em> cho tác vụ nền.
|
|
1498
|
+
</div>
|
|
1499
|
+
<div class="relative">
|
|
1500
|
+
<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>
|
|
1501
|
+
<pre><code class="language-tsx">// 1. Structured Data Binding + Pipe Transform trực tiếp trong TSX
|
|
1502
|
+
const data = Widget.createDataBinding<{
|
|
1503
|
+
user: { name: string };
|
|
1504
|
+
attendance: { progress: number };
|
|
1505
|
+
}>({
|
|
1506
|
+
defaults: { user: { name: 'Nhân viên' }, attendance: { progress: 0 } },
|
|
1507
|
+
});
|
|
1508
|
+
|
|
1509
|
+
await Widget.setLayout('main', {
|
|
1510
|
+
medium: (
|
|
1511
|
+
<VStack padding={14} spacing={6}>
|
|
1512
|
+
<Text>{data.user.name}</Text>
|
|
1513
|
+
<Text>{data.attendance.progress}%</Text>
|
|
1514
|
+
<Progress value={data.attendance.progress.divide(100)} />
|
|
1515
|
+
</VStack>
|
|
1516
|
+
),
|
|
1517
|
+
});
|
|
1518
|
+
|
|
1519
|
+
// 2. Cấu hình Background Data Engine 2.0 (TTL, ETag, Retry, Multi-source, Schema, Auth Refresh)
|
|
1520
|
+
await Widget.setRemoteConfig('main', {
|
|
1521
|
+
cacheTtlSeconds: 300,
|
|
1522
|
+
timeoutMs: 6000,
|
|
1523
|
+
enableETag: true,
|
|
1524
|
+
maxRetries: 2,
|
|
1525
|
+
retryDelayMs: 500,
|
|
1526
|
+
sources: {
|
|
1527
|
+
user: { url: 'https://api.yourcompany.com/v1/me' },
|
|
1528
|
+
attendance: { url: 'https://api.yourcompany.com/v1/attendance/today' },
|
|
1529
|
+
},
|
|
1530
|
+
schema: {
|
|
1531
|
+
requiredKeys: ['user.name', 'attendance.progress'],
|
|
1532
|
+
types: { 'attendance.progress': 'number' },
|
|
1533
|
+
},
|
|
1534
|
+
authRefresh: {
|
|
1535
|
+
url: 'https://api.yourcompany.com/v1/auth/refresh',
|
|
1536
|
+
method: 'POST',
|
|
1537
|
+
tokenPath: 'accessToken',
|
|
1538
|
+
},
|
|
1539
|
+
errorFallback: <Text color="#F87171">Lỗi {{_httpStatus}}: {{_syncError}}</Text>,
|
|
1540
|
+
refreshIntervalMinutes: 15, // Mốc gợi ý sớm nhất theo OS WidgetKit Budget
|
|
1541
|
+
}, 'group.com.yourcompany.app');</code></pre>
|
|
1542
|
+
</div>
|
|
1543
|
+
</div>
|
|
1544
|
+
|
|
1545
|
+
<!-- APNs & FCM Push Tokens -->
|
|
1546
|
+
<div id="api-push-token" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
1547
|
+
<div class="flex flex-wrap items-center justify-between gap-2">
|
|
1548
|
+
<h3 class="text-lg font-bold text-white">5. Quản lý 3 loại Push Token & Payload Server (APNs / FCM)</h3>
|
|
1549
|
+
<span class="text-xs bg-rose-500/10 text-rose-300 border border-rose-500/20 px-2.5 py-1 rounded-full">Server Push</span>
|
|
1550
|
+
</div>
|
|
1551
|
+
<p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
|
|
1552
|
+
Hỗ trợ lấy và theo dõi xoay token tự động cho cả 3 loại: <code>devicePushToken</code> (APNs/FCM thường), <code>pushToStartToken</code> (iOS 17.2+ bật mới Live Activity từ xa khi App đang tắt), và <code>activityUpdateToken</code> (đẩy bản cập nhật/kết thúc phiên đang chạy).
|
|
1553
|
+
</p>
|
|
1554
|
+
<div class="grid grid-cols-1 lg:grid-cols-2 gap-4">
|
|
1555
|
+
<div class="relative">
|
|
1556
|
+
<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>
|
|
1557
|
+
<pre><code class="language-typescript">// Lấy toàn bộ token & lắng nghe cập nhật từ Native
|
|
1558
|
+
const tokens = await LiveActivity.getAllPushTokens();
|
|
1559
|
+
console.log(tokens.devicePushToken, tokens.pushToStartToken);
|
|
1560
|
+
|
|
1561
|
+
LiveActivity.onPushToStartTokenChange((token) => {
|
|
1562
|
+
api.syncPushToStartToken(token);
|
|
1563
|
+
});
|
|
1564
|
+
LiveActivity.onActivityUpdateTokenChange(({ activityId, token }) => {
|
|
1565
|
+
api.syncActivityToken(activityId, token);
|
|
1566
|
+
});</code></pre>
|
|
1567
|
+
</div>
|
|
1568
|
+
<div class="relative">
|
|
1569
|
+
<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>
|
|
1570
|
+
<pre><code class="language-json">// Header APNs: apns-push-type: liveactivity | apns-topic: <bundle_id>.push-type.liveactivity
|
|
1571
|
+
{
|
|
1572
|
+
"aps": {
|
|
1573
|
+
"timestamp": 1711890000,
|
|
1574
|
+
"event": "update",
|
|
1575
|
+
"content-state": {
|
|
1576
|
+
"layoutJson": "{\"lockScreen\":{...},\"dynamicIsland\":{...}}"
|
|
1577
|
+
},
|
|
1578
|
+
"alert": { "title": "Đơn hàng đã giao!", "body": "Chúc bạn ngon miệng." }
|
|
1579
|
+
}
|
|
1580
|
+
}</code></pre>
|
|
1581
|
+
</div>
|
|
1582
|
+
</div>
|
|
1583
|
+
</div>
|
|
1584
|
+
</section>
|
|
1585
|
+
|
|
1586
|
+
<!-- Section: Architecture, Semantics & Roadmap (v1.2.2) -->
|
|
1587
|
+
<section id="ir-semantic" class="space-y-6">
|
|
1588
|
+
<div class="border-b border-cardBorder pb-4">
|
|
1589
|
+
<div class="flex items-center space-x-2">
|
|
1590
|
+
<span class="px-2.5 py-0.5 rounded-full text-xs font-bold bg-indigo-500/20 text-indigo-300 border border-indigo-500/30 uppercase">Architecture v2.0</span>
|
|
1591
|
+
<h2 class="text-2xl sm:text-3xl font-extrabold text-white">
|
|
1592
|
+
3 Trụ Cột Kiến Trúc & UI Intermediate Representation (IR)
|
|
1593
|
+
</h2>
|
|
1594
|
+
</div>
|
|
1595
|
+
<p class="mt-2 text-slate-400 text-sm sm:text-base leading-relaxed">
|
|
1596
|
+
Thay vì đi thẳng từ DSL → Bitmap thiếu ngữ nghĩa, thư viện áp dụng kiến trúc chuẩn công nghiệp với <strong>Semantic Tree độc lập khỏi Visual Renderer</strong>:
|
|
1597
|
+
</p>
|
|
1598
|
+
</div>
|
|
1599
|
+
|
|
1600
|
+
<div class="grid grid-cols-1 md:grid-cols-3 gap-4">
|
|
1601
|
+
<div class="bg-darkCard border border-cardBorder rounded-xl p-5 space-y-2">
|
|
1602
|
+
<h4 class="font-bold text-emerald-400 text-sm">✅ Điểm 1: Native Semantic Coverage</h4>
|
|
1603
|
+
<p class="text-xs text-slate-400 leading-relaxed">
|
|
1604
|
+
Phù hợp giới hạn whitelist của Android <code>RemoteViews</code>: mọi Text/Button/Toggle quan trọng đều có Semantics; thành phần đồ họa Canvas (Gauge, Chart, Equalizer) sinh kèm Accessibility Description thay thế.
|
|
1605
|
+
</p>
|
|
1606
|
+
</div>
|
|
1607
|
+
<div class="bg-darkCard border border-cardBorder rounded-xl p-5 space-y-2">
|
|
1608
|
+
<h4 class="font-bold text-sky-400 text-sm">✅ Điểm 2: Native-first, Canvas-when-needed</h4>
|
|
1609
|
+
<p class="text-xs text-slate-400 leading-relaxed">
|
|
1610
|
+
<code>Chronometer</code> và <code>FrameLayout</code> Hit Layer chạy hoàn toàn bằng Native RemoteViews; Canvas 2D chỉ vẽ các phần thực sự cần vẽ (đồ họa phức tạp, Gauge, Sparkline), giảm RAM và pin.
|
|
1611
|
+
</p>
|
|
1612
|
+
</div>
|
|
1613
|
+
<div class="bg-darkCard border border-cardBorder rounded-xl p-5 space-y-2">
|
|
1614
|
+
<h4 class="font-bold text-purple-400 text-sm">✅ Điểm 3: Semantic Tree độc lập Renderer (UI IR)</h4>
|
|
1615
|
+
<p class="text-xs text-slate-400 leading-relaxed">
|
|
1616
|
+
Cây <strong>UI IR</strong> tách làm 3 phần: Visual Tree, Semantic Tree và State Bindings — dùng API <code>Widget.inspectIR()</code> và <code>Widget.compileIR()</code> để kiểm toán trực tiếp kế hoạch render.
|
|
1617
|
+
</p>
|
|
1618
|
+
</div>
|
|
1619
|
+
</div>
|
|
1620
|
+
|
|
1621
|
+
<div class="relative">
|
|
1622
|
+
<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>
|
|
1623
|
+
<pre><code class="language-typescript">import { Widget, UI } from 'react-native-live-widgets';
|
|
1624
|
+
|
|
1625
|
+
const layout = UI.VStack(
|
|
1626
|
+
{ padding: 16, backgroundColor: '#0F172A' },
|
|
1627
|
+
UI.Text('BẢNG ĐIỀU KHIỂN CHẤM CÔNG', { typography: 'title2' }),
|
|
1628
|
+
UI.Progress({ value: 0.86, accessibilityLabel: 'Tiến độ hoàn thành ca' }),
|
|
1629
|
+
UI.Button({ title: 'Check In', actionId: 'toggle:attendance' }),
|
|
1630
|
+
UI.Gauge(0.92, { label: 'Hiệu suất' })
|
|
1631
|
+
);
|
|
1632
|
+
|
|
1633
|
+
// Phân tích chiến lược Native vs Canvas & tóm tắt Trợ năng TalkBack/VoiceOver
|
|
1634
|
+
console.log(Widget.inspectIR(layout));
|
|
1635
|
+
const ir = Widget.compileIR(layout);
|
|
1636
|
+
console.log(ir.renderStrategy, ir.semanticSummary);</code></pre>
|
|
1637
|
+
</div>
|
|
1638
|
+
|
|
1639
|
+
<!-- Accessibility Layer -->
|
|
1640
|
+
<div id="a11y-layer" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
1641
|
+
<h3 class="font-bold text-white text-lg flex items-center space-x-2">
|
|
1642
|
+
<i data-lucide="accessibility" class="w-5 h-5 text-sky-400"></i>
|
|
1643
|
+
<span>Lớp Trợ năng Chuẩn hóa (VoiceOver iOS & TalkBack Android)</span>
|
|
1644
|
+
</h3>
|
|
1645
|
+
<p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
|
|
1646
|
+
Mọi node hỗ trợ đầy đủ <code>AccessibilityProps</code>: <code>accessible</code>, <code>accessibilityRole</code> (<code>'header' | 'button' | 'progressbar' | 'checkbox' | 'switch' | 'image' | 'summary'</code>), <code>accessibilityLabel</code>, <code>accessibilityHint</code>, và <code>accessibilityValue</code>. Trên Android, engine tự động duyệt đệ quy để gán tóm tắt vào <code>contentDescription</code> của Canvas và từng Hit Zone.
|
|
1647
|
+
</p>
|
|
1648
|
+
<div class="relative">
|
|
1649
|
+
<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>
|
|
1650
|
+
<pre><code class="language-tsx"><VStack padding={16}>
|
|
1651
|
+
<Text typography="title2" accessibilityRole="header" accessibilityLabel="Bảng điều khiển chấm công">
|
|
1652
|
+
BẢNG ĐIỀU KHIỂN CHẤM CÔNG
|
|
1653
|
+
</Text>
|
|
1654
|
+
<Progress value={0.86} accessibilityLabel="Tiến độ hoàn thành ca" accessibilityValue="86 phần trăm" />
|
|
1655
|
+
<Button
|
|
1656
|
+
title="Check-in vào ca"
|
|
1657
|
+
actionId="CHECK_IN"
|
|
1658
|
+
accessibilityRole="button"
|
|
1659
|
+
accessibilityHint="Chạm hai lần để gửi yêu cầu chấm công"
|
|
1660
|
+
/>
|
|
1661
|
+
<Image systemName="sparkles" accessible={false} />
|
|
1662
|
+
</VStack></code></pre>
|
|
1663
|
+
</div>
|
|
1664
|
+
</div>
|
|
1665
|
+
|
|
1666
|
+
<!-- Capability Matrix & Roadmap -->
|
|
1667
|
+
<div id="capability-matrix" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-5">
|
|
1668
|
+
<h3 class="font-bold text-white text-lg flex items-center space-x-2">
|
|
1669
|
+
<i data-lucide="table" class="w-5 h-5 text-emerald-400"></i>
|
|
1670
|
+
<span>Bảng Năng lực Nền tảng & Lộ trình Phát triển 6 Phases (v1.2.2 Hoàn thiện 100%)</span>
|
|
1671
|
+
</h3>
|
|
1672
|
+
|
|
1673
|
+
<div class="overflow-x-auto">
|
|
1674
|
+
<table class="w-full text-left text-xs border-collapse">
|
|
1675
|
+
<thead>
|
|
1676
|
+
<tr class="border-b border-cardBorder text-slate-400">
|
|
1677
|
+
<th class="py-2 pr-3 font-semibold">Tính năng</th>
|
|
1678
|
+
<th class="py-2 pr-3 font-semibold">iOS WidgetKit / LA</th>
|
|
1679
|
+
<th class="py-2 pr-3 font-semibold">Android Home Widget</th>
|
|
1680
|
+
<th class="py-2 font-semibold">Graceful Fallback</th>
|
|
1681
|
+
</tr>
|
|
1682
|
+
</thead>
|
|
1683
|
+
<tbody class="divide-y divide-cardBorder text-slate-300">
|
|
1684
|
+
<tr>
|
|
1685
|
+
<td class="py-2 pr-3 font-semibold">Vùng bấm tương tác</td>
|
|
1686
|
+
<td class="py-2 pr-3">✅ iOS 17+ <code>AppIntent</code></td>
|
|
1687
|
+
<td class="py-2 pr-3">✅ Exact Hit Layer (<code>rn_hit_layer</code>)</td>
|
|
1688
|
+
<td class="py-2">Mở App xử lý queue qua PendingIntent</td>
|
|
1689
|
+
</tr>
|
|
1690
|
+
<tr>
|
|
1691
|
+
<td class="py-2 pr-3 font-semibold">Đồng hồ đếm ngược</td>
|
|
1692
|
+
<td class="py-2 pr-3">✅ SwiftUI Timer</td>
|
|
1693
|
+
<td class="py-2 pr-3">✅ Native <code>Chronometer</code></td>
|
|
1694
|
+
<td class="py-2">Cập nhật theo mốc thời gian hệ điều hành</td>
|
|
1695
|
+
</tr>
|
|
1696
|
+
<tr>
|
|
1697
|
+
<td class="py-2 pr-3 font-semibold">Gradient & Dashed Border</td>
|
|
1698
|
+
<td class="py-2 pr-3">✅ SwiftUI</td>
|
|
1699
|
+
<td class="py-2 pr-3">✅ Shader & <code>DashPathEffect</code></td>
|
|
1700
|
+
<td class="py-2">Hạ cấp về màu đầu tiên trong <code>colors</code> / nét liền</td>
|
|
1701
|
+
</tr>
|
|
1702
|
+
<tr>
|
|
1703
|
+
<td class="py-2 pr-3 font-semibold">Accessibility & Dynamic Type</td>
|
|
1704
|
+
<td class="py-2 pr-3">✅ Native VoiceOver</td>
|
|
1705
|
+
<td class="py-2 pr-3">✅ A11y Summary + Hit-Zones + <code>fontScale</code></td>
|
|
1706
|
+
<td class="py-2">Tổng hợp ngữ nghĩa toàn cây cho bộ đọc màn hình</td>
|
|
1707
|
+
</tr>
|
|
1708
|
+
</tbody>
|
|
1709
|
+
</table>
|
|
1710
|
+
</div>
|
|
1711
|
+
|
|
1712
|
+
<div class="overflow-x-auto pt-2">
|
|
1713
|
+
<table class="w-full text-left text-xs border-collapse">
|
|
1714
|
+
<thead>
|
|
1715
|
+
<tr class="border-b border-cardBorder text-slate-400">
|
|
1716
|
+
<th class="py-2 pr-3 font-semibold">Phase</th>
|
|
1717
|
+
<th class="py-2 pr-3 font-semibold">Nội dung kiến trúc</th>
|
|
1718
|
+
<th class="py-2 font-semibold">Trạng thái v1.2.2</th>
|
|
1719
|
+
</tr>
|
|
1720
|
+
</thead>
|
|
1721
|
+
<tbody class="divide-y divide-cardBorder text-slate-300">
|
|
1722
|
+
<tr>
|
|
1723
|
+
<td class="py-2 pr-3 font-mono text-sky-400">Phase 1</td>
|
|
1724
|
+
<td class="py-2 pr-3">Accessibility Fallback Layer (<code>AccessibilityProps</code>, TalkBack & VoiceOver)</td>
|
|
1725
|
+
<td class="py-2 text-emerald-400 font-semibold">✅ Hoàn thành</td>
|
|
858
1726
|
</tr>
|
|
859
1727
|
<tr>
|
|
860
|
-
<td class="py-2
|
|
861
|
-
<td class="py-2
|
|
862
|
-
<td class="py-2
|
|
1728
|
+
<td class="py-2 pr-3 font-mono text-sky-400">Phase 2</td>
|
|
1729
|
+
<td class="py-2 pr-3">UI Intermediate Representation (<code>src/ir.ts</code>, <code>Widget.inspectIR</code>)</td>
|
|
1730
|
+
<td class="py-2 text-emerald-400 font-semibold">✅ Hoàn thành</td>
|
|
863
1731
|
</tr>
|
|
864
1732
|
<tr>
|
|
865
|
-
<td class="py-2
|
|
866
|
-
<td class="py-2
|
|
867
|
-
<td class="py-2
|
|
1733
|
+
<td class="py-2 pr-3 font-mono text-sky-400">Phase 3 & 4</td>
|
|
1734
|
+
<td class="py-2 pr-3">Native-first Hybrid (Chronometer, Exact Hit Layer) & Two-way State Sync</td>
|
|
1735
|
+
<td class="py-2 text-emerald-400 font-semibold">✅ Hoàn thành</td>
|
|
868
1736
|
</tr>
|
|
869
1737
|
<tr>
|
|
870
|
-
<td class="py-2
|
|
871
|
-
<td class="py-2
|
|
872
|
-
<td class="py-2
|
|
1738
|
+
<td class="py-2 pr-3 font-mono text-sky-400">Phase 5 & 6</td>
|
|
1739
|
+
<td class="py-2 pr-3">Canvas Sub-renderer (~40KB RAM) & Automated Test Suite (<code>npm test</code>)</td>
|
|
1740
|
+
<td class="py-2 text-emerald-400 font-semibold">✅ Hoàn thành</td>
|
|
873
1741
|
</tr>
|
|
874
1742
|
</tbody>
|
|
875
1743
|
</table>
|
|
876
1744
|
</div>
|
|
877
1745
|
</div>
|
|
878
1746
|
|
|
1747
|
+
<!-- Extended Families & Complete Live Activity Lifecycle -->
|
|
1748
|
+
<div id="extended-families-lifecycle" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-5">
|
|
1749
|
+
<div class="flex flex-wrap items-center justify-between gap-2">
|
|
1750
|
+
<h3 class="font-bold text-white text-lg flex items-center space-x-2">
|
|
1751
|
+
<i data-lucide="smartphone" class="w-5 h-5 text-emerald-400"></i>
|
|
1752
|
+
<span>Widget Family Mở rộng (<code>extraLarge</code>, <code>standBy</code>, <code>ControlWidget</code>) & Vòng đời Live Activity</span>
|
|
1753
|
+
</h3>
|
|
1754
|
+
<span class="text-xs bg-emerald-500/10 text-emerald-300 border border-emerald-500/20 px-2.5 py-1 rounded-full">OS Surfaces & Lifecycle</span>
|
|
1755
|
+
</div>
|
|
1756
|
+
<p class="text-xs sm:text-sm text-slate-300 leading-relaxed">
|
|
1757
|
+
Hỗ trợ đầy đủ giao diện riêng cho <strong>iOS 17+ StandBy Mode</strong> (tự nhận diện <code>showsWidgetContainerBackground == false</code> kèm <code>.applyStandByMargins()</code> & <code>widgetAccentable</code>), <strong>iPadOS / Tablet Extra Large</strong> (<code>extraLarge</code>), <strong>iOS 18+ Control Center / Action Button & Android Quick Settings Tile</strong> (<code>ControlWidget</code> DSL, <code>DynamicControlWidget.swift</code>, <code>DynamicQuickSettingsTileService.kt</code>, <code><WidgetPreview size="control" /></code>), và hệ thống vòng đời Live Activity hoàn chỉnh (Stale, Relevance Score, AlertConfiguration, Scheduled End, Auto-Expiration, Push-to-Start & Multi-Activity Inspection).
|
|
1758
|
+
</p>
|
|
1759
|
+
<div class="relative">
|
|
1760
|
+
<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>
|
|
1761
|
+
<pre><code class="language-typescript">// 1. Thiết lập StandBy + ExtraLarge + Control Widget (iOS 18+ / Android QS Tile)
|
|
1762
|
+
await Widget.setLayout('main', {
|
|
1763
|
+
small: compactNode,
|
|
1764
|
+
medium: mediumNode,
|
|
1765
|
+
large: largeNode,
|
|
1766
|
+
extraLarge: tabletDashboardNode,
|
|
1767
|
+
standBy: standByBigClockNode,
|
|
1768
|
+
});
|
|
1769
|
+
|
|
1770
|
+
const shiftCtrl = ControlWidget.toggle({
|
|
1771
|
+
title: 'Ca làm việc',
|
|
1772
|
+
subtitle: 'Chạm để chấm công',
|
|
1773
|
+
checkedTitle: 'Đang trong ca',
|
|
1774
|
+
checkedSubtitle: 'Nhấn để kết thúc',
|
|
1775
|
+
systemName: 'clock.badge.checkmark.fill',
|
|
1776
|
+
checked: true,
|
|
1777
|
+
actionId: 'toggle:attendance',
|
|
1778
|
+
});
|
|
1779
|
+
await ControlWidget.set('toggle', shiftCtrl);
|
|
1780
|
+
// Xem trước Control Tile ngay trong App: <WidgetPreview size="control" controlConfig={shiftCtrl} />
|
|
1781
|
+
|
|
1782
|
+
// 2. Theo dõi toàn bộ vòng đời & kiểm tra Live Activity đồng thời
|
|
1783
|
+
const unsubLifecycle = LiveActivity.onStateChange((event) => {
|
|
1784
|
+
console.log(`Activity ${event.activityId} -> ${event.state}`);
|
|
1785
|
+
});
|
|
1786
|
+
const active = await LiveActivity.get('shift_01');
|
|
1787
|
+
const cleanedIds = await LiveActivity.cleanupExpired();</code></pre>
|
|
1788
|
+
</div>
|
|
1789
|
+
</div>
|
|
1790
|
+
|
|
1791
|
+
<!-- Troubleshooting -->
|
|
1792
|
+
<div id="troubleshooting" class="bg-darkCard border border-cardBorder rounded-2xl p-6 space-y-4">
|
|
1793
|
+
<h3 class="font-bold text-white text-lg flex items-center space-x-2">
|
|
1794
|
+
<i data-lucide="wrench" class="w-5 h-5 text-amber-400"></i>
|
|
1795
|
+
<span>Xử lý Sự cố Thường gặp (Troubleshooting)</span>
|
|
1796
|
+
</h3>
|
|
1797
|
+
<ul class="space-y-3 text-xs sm:text-sm text-slate-300 leading-relaxed list-disc pl-5">
|
|
1798
|
+
<li>
|
|
1799
|
+
<strong>Widget hiện "Chọn 1 mẫu UI trong app để hiển thị":</strong> Kiểm tra App Group ID giữa Main App và Widget Extension đã trùng khớp chưa (vd <code>group.<bundle_id></code>) và đảm bảo đã gọi <code>await Widget.setLayout('main', ...)</code>.
|
|
1800
|
+
</li>
|
|
1801
|
+
<li>
|
|
1802
|
+
<strong>Dynamic Island Compact bị tràn chiều ngang khi dùng <code>UI.Timer</code>:</strong> Đảm bảo đặt <code>fontSize</code> gọn (11–13) cho <code>compactTrailing</code>; thư viện đã tự tính độ rộng <code>compactWidth</code> tối ưu theo thời lượng còn lại.
|
|
1803
|
+
</li>
|
|
1804
|
+
<li>
|
|
1805
|
+
<strong>Ảnh từ URL mạng (<code>https://...</code>) không hiện trên Widget:</strong> Đảm bảo URL là HTTPS hợp lệ; thư viện tự tải ngầm, nén xuống 360px để không vượt giới hạn 30MB của WidgetKit và reload lại Widget khi tải xong.
|
|
1806
|
+
</li>
|
|
1807
|
+
<li>
|
|
1808
|
+
<strong>Lỗi build Swift 6 <code>type '()' cannot conform to 'View'</code> trên Xcode mới:</strong> Cập nhật lên phiên bản <strong><code>1.2.2</code></strong> trở lên (<code>npm install react-native-live-widgets@latest</code>).
|
|
1809
|
+
</li>
|
|
1810
|
+
</ul>
|
|
1811
|
+
</div>
|
|
879
1812
|
</section>
|
|
880
1813
|
|
|
881
1814
|
<!-- Section: AI Agent & LLM Hub (llms.txt) -->
|
|
@@ -904,22 +1837,28 @@ useWidgetAction('ACTION_CHECKIN', () => {
|
|
|
904
1837
|
|
|
905
1838
|
<!-- llms.txt card -->
|
|
906
1839
|
<div class="bg-darkCard border border-indigo-900/40 rounded-2xl p-6 space-y-4">
|
|
907
|
-
<div class="flex items-center justify-between">
|
|
1840
|
+
<div class="flex items-center justify-between gap-2 flex-wrap">
|
|
908
1841
|
<span class="font-bold text-white text-base flex items-center space-x-2">
|
|
909
1842
|
<i data-lucide="file-text" class="w-5 h-5 text-indigo-400"></i>
|
|
910
|
-
<span>Tập tin llms.txt</span>
|
|
1843
|
+
<span>Tập tin llms.txt & llms-full.txt</span>
|
|
911
1844
|
</span>
|
|
912
|
-
<
|
|
913
|
-
|
|
914
|
-
|
|
1845
|
+
<div class="flex items-center space-x-2">
|
|
1846
|
+
<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">
|
|
1847
|
+
llms.txt ↗
|
|
1848
|
+
</a>
|
|
1849
|
+
<a href="llms-full.txt" 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">
|
|
1850
|
+
llms-full.txt ↗
|
|
1851
|
+
</a>
|
|
1852
|
+
</div>
|
|
915
1853
|
</div>
|
|
916
1854
|
<p class="text-xs text-slate-400 leading-relaxed">
|
|
917
|
-
Tóm tắt xúc tích về toàn bộ API,
|
|
1855
|
+
Tóm tắt xúc tích về toàn bộ API, UI IR, cấu trúc JSON AST và quy tắc vàng giúp AI lập trình widget chính xác trên v1.2.2.
|
|
918
1856
|
</p>
|
|
919
1857
|
<div class="relative">
|
|
920
1858
|
<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
1859
|
<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
|
|
1860
|
+
curl -s https://react-native-vu.github.io/react-native-live-widgets/llms.txt
|
|
1861
|
+
curl -s https://react-native-vu.github.io/react-native-live-widgets/llms-full.txt</code></pre>
|
|
923
1862
|
</div>
|
|
924
1863
|
</div>
|
|
925
1864
|
|
|
@@ -959,12 +1898,13 @@ curl -s https://react-native-vu.github.io/react-native-live-widgets/llms.txt</co
|
|
|
959
1898
|
⚡
|
|
960
1899
|
</div>
|
|
961
1900
|
<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>
|
|
1901
|
+
<p class="text-slate-300 font-medium" data-i18n="footer_dev">react-native-live-widgets — Phát triển bởi <strong>Trần Tuấn Vũ</strong></p>
|
|
1902
|
+
<p class="text-[11px] text-slate-500" data-i18n="footer_sub">Giấy phép mã nguồn mở MIT • Sẵn sàng cho Production</p>
|
|
964
1903
|
</div>
|
|
965
1904
|
</div>
|
|
966
1905
|
|
|
967
1906
|
<div class="flex flex-wrap items-center gap-6">
|
|
1907
|
+
<a href="https://react-native-vu.github.io/react-native-live-widgets/" target="_blank" class="hover:text-white transition text-sky-400 font-medium">Web Docs</a>
|
|
968
1908
|
<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
1909
|
<i data-lucide="github" class="w-4 h-4"></i>
|
|
970
1910
|
<span>GitHub</span>
|
|
@@ -1299,7 +2239,293 @@ useWidgetAction('INCREMENT', () => {
|
|
|
1299
2239
|
});
|
|
1300
2240
|
}
|
|
1301
2241
|
|
|
1302
|
-
//
|
|
2242
|
+
// Multilingual i18n Dictionary (Vietnamese & English)
|
|
2243
|
+
const translations = {
|
|
2244
|
+
vi: {
|
|
2245
|
+
version_tag: 'v1.2.2',
|
|
2246
|
+
announcement_tag: 'Mới v1.2.2',
|
|
2247
|
+
announcement_text: 'Exact Dynamic Hit Layer, Native Chronometer Countdown, Swift 6 Ready & Chuẩn hoá <strong>UI IR</strong>',
|
|
2248
|
+
announcement_link: 'Xem chi tiết →',
|
|
2249
|
+
brand_subtitle: 'Declarative Widgets & Dynamic Island Engine',
|
|
2250
|
+
nav_sim: 'Live Simulator',
|
|
2251
|
+
nav_install: 'Cài đặt',
|
|
2252
|
+
nav_dsl: 'UI DSL & JSX',
|
|
2253
|
+
nav_api: 'API Reference',
|
|
2254
|
+
hero_badge: '100% Declarative UI • Không viết Swift / Kotlin • Expo CNG Ready',
|
|
2255
|
+
hero_title_1: 'Live Activities & Dynamic Island',
|
|
2256
|
+
hero_title_2: 'Chỉ với TypeScript & JSX',
|
|
2257
|
+
hero_desc: 'Giải pháp toàn diện All-in-One cho <strong>Live Activities</strong>, <strong>Dynamic Island</strong> và <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.',
|
|
2258
|
+
hero_btn_install: 'Bắt đầu Cài đặt',
|
|
2259
|
+
hero_btn_sim: 'Trải nghiệm Live Simulator',
|
|
2260
|
+
hero_btn_expo: 'Expo Sample App ↗',
|
|
2261
|
+
btn_copy: 'Copy',
|
|
2262
|
+
btn_copy_code: 'Copy Code',
|
|
2263
|
+
sim_header_badge: 'Tương tác trực tiếp trên trình duyệt',
|
|
2264
|
+
sim_header_title: 'Live Simulator: Trải Nghiệm Widget & Dynamic Island',
|
|
2265
|
+
sim_header_desc: '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ì!',
|
|
2266
|
+
sim_tab_delivery: '1. Giao đồ ăn (Dynamic Island)',
|
|
2267
|
+
sim_tab_music: '2. Sóng nhạc Equalizer',
|
|
2268
|
+
sim_tab_pomodoro: '3. Bấm giờ Phần cứng (UI.Timer)',
|
|
2269
|
+
sim_tab_widget: '4. Home Widget Tương Tác 2 Chiều',
|
|
2270
|
+
sim_hint: 'Nhấn vào các nút bên trong widget để thấy phản hồi tương tác!',
|
|
2271
|
+
sim_code_label: 'Mã TypeScript Declarative',
|
|
2272
|
+
why_title: 'Tại sao chọn `react-native-live-widgets`?',
|
|
2273
|
+
why_desc: '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.',
|
|
2274
|
+
f1_title: '100% Không Viết Swift / Kotlin',
|
|
2275
|
+
f1_desc: '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.',
|
|
2276
|
+
f2_title: 'Tương Tác 2 Chiều (AppIntents)',
|
|
2277
|
+
f2_desc: '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 useWidgetAction() mà không cần mở toàn màn hình ứng dụng.',
|
|
2278
|
+
f3_title: 'Timer Phần Cứng (0% Tiêu Hao Pin)',
|
|
2279
|
+
f3_desc: 'UI.Timer 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ị.',
|
|
2280
|
+
f4_title: 'Sóng Nhạc Động (Equalizer)',
|
|
2281
|
+
f4_desc: '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.',
|
|
2282
|
+
f5_title: 'Đồng Bộ Ngầm Khi Kill App',
|
|
2283
|
+
f5_desc: 'Hàm Widget.setRemoteConfig() 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.',
|
|
2284
|
+
f6_title: 'Chuẩn AI Agent (llms.txt)',
|
|
2285
|
+
f6_desc: 'Sẵn sàng 100% cho ChatGPT, Claude Code, Cursor, Antigravity thông qua llms.txt và SKILL.md. Agent của bạn có thể tự lập trình widget không lỗi.',
|
|
2286
|
+
|
|
2287
|
+
// Quick Start Section
|
|
2288
|
+
qs_title: 'Khởi Đầu Cực Nhanh Trong 3 Phút',
|
|
2289
|
+
qs_desc: 'Lựa chọn phương thức thiết lập phù hợp với dự án của bạn: All-in-One CLI tự động hoàn toàn hoặc tích hợp thủ công.',
|
|
2290
|
+
expo_card_title: 'Dự án Expo (EAS Build / Prebuild)',
|
|
2291
|
+
expo_card_desc: 'Thêm plugin vào <code>app.json</code> / <code>app.config.js</code> và kích hoạt quyền cần thiết.',
|
|
2292
|
+
expo_plugin_label: 'Cấu hình Config Plugin trong <code>app.json</code>:',
|
|
2293
|
+
bare_card_title: 'Dự án Bare React Native CLI',
|
|
2294
|
+
codegen_card_title: 'Tự động sinh mã Native với CLI',
|
|
2295
|
+
codegen_card_desc: 'Sử dụng lệnh CLI tích hợp sẵn để tự động cấu hình Target iOS Extension và Android Widget Provider mà không phải mở Xcode / Android Studio.',
|
|
2296
|
+
|
|
2297
|
+
// Exact Hit Layer Section (v1.2.2)
|
|
2298
|
+
hit_badge: 'V1.2.2 MỚI',
|
|
2299
|
+
hit_title: 'Vùng Bấm Động Từng Pixel, Chronometer & Swift 6 Ready',
|
|
2300
|
+
hit_desc: 'Bản phát hành <strong>v1.2.2</strong> tái cấu trúc toàn diện hệ thống tương tác cảm ứng trên Android Home Screen Widgets, tích hợp đồng hồ đếm ngược phần cứng native và tương thích hoàn toàn <strong>Swift 6 Language Mode</strong> trên Xcode mới.',
|
|
2301
|
+
hit_card1_title: '1. Exact Dynamic Hit Layer (<code>rn_hit_layer</code>)',
|
|
2302
|
+
hit_card1_desc: 'Thay thế hoàn toàn lưới cố định cũ bằng <code>FrameLayout</code> động (<code>rn_live_widget_hit_zone.xml</code>). Giải thuật <code>computeCanvasMapping</code> ánh xạ chính xác toạ độ từ Bitmap Canvas sang khung Launcher thật (xử lý bù viền <code>fitCenter</code> letterboxing). Bấm vào nút/checkbox nào ăn đúng 100% nút đó, vùng trống hoàn toàn không kích hoạt nhầm.',
|
|
2303
|
+
hit_card2_title: '2. Native Chronometer Countdown (Android)',
|
|
2304
|
+
hit_card2_desc: 'Tích hợp trực tiếp <code>android.widget.Chronometer</code> với <code>setChronometerCountDown(true)</code> và <code>baseMillis = SystemClock.elapsedRealtime() + remainingMillis</code>. Khi có timer đếm ngược, hệ thống ẩn text tĩnh trên Bitmap để đồng hồ native tự chạy giật lùi 1s/lần mà không phải vẽ lại ảnh Canvas.',
|
|
2305
|
+
hit_card3_title: '3. Nội suy Biến động & <code>defaultChecked</code> Store',
|
|
2306
|
+
hit_card3_desc: '<code>DynamicWidgetStateStore</code> hỗ trợ nội suy chuỗi mẫu <code>{{id}}</code>, <code>{{title}}</code>, giá trị bộ đếm phẳng và tự động lưu trạng thái khởi tạo <code>defaultChecked</code> của công tắc <code>checked: true</code> ngay lần render đầu, giúp tắt công tắc mượt mà ngay lần chạm đầu tiên.',
|
|
2307
|
+
hit_card4_title: '4. Tương thích Swift 6 Language Mode (iOS)',
|
|
2308
|
+
hit_card4_desc: 'Khắc phục lỗi biên dịch <code>type \'()\' cannot conform to \'View\'</code> trên Xcode mới bằng cách đóng gói closure cho <code>Font</code> trong <code>renderText()</code>, tách logic accessibility sang hàm thuần <code>buildAccessibilityView(content:) -> AnyView</code>, và bổ sung <code>EmptyView()</code> cho các nhánh <code>ContainerStyleModifier</code>.',
|
|
2309
|
+
|
|
2310
|
+
// DSL Image
|
|
2311
|
+
dsl_image_title: 'Hình ảnh & Biểu tượng Hệ thống: <code>UI.Image</code> & <code><Image></code>',
|
|
2312
|
+
dsl_image_desc: 'Hỗ trợ <strong>5 nguồn ảnh</strong>: <code>url</code> (tự tải ngầm, nén tối đa 360px tránh vượt ngưỡng 30MB WidgetKit và lưu vào App Group cache), <code>base64</code> (QR/Barcode), <code>systemName</code>, <code>assetName</code>, và <code>filePath</code>. Đặc biệt hỗ trợ icon hệ thống đa nền tảng chuyên biệt: <code>systemNameIos</code> (Apple SF Symbols) và <code>systemNameAndroid</code> (Google Material Icons) với gợi ý type IntelliSense đầy đủ.',
|
|
2313
|
+
|
|
2314
|
+
// Sidebar Elements
|
|
2315
|
+
side_header_start: 'Bắt đầu',
|
|
2316
|
+
side_quick_start: 'Cài đặt All-in-One CLI',
|
|
2317
|
+
side_expo_setup: 'Expo (Config Plugin & CNG)',
|
|
2318
|
+
side_bare_rn: 'Bare React Native CLI',
|
|
2319
|
+
side_header_syntax: 'Cú pháp & UI Engine',
|
|
2320
|
+
side_jsx_support: 'Cú pháp JSX / TSX & StyleSheet',
|
|
2321
|
+
side_widget_preview: 'Mô phỏng <WidgetPreview>',
|
|
2322
|
+
side_exact_hit: 'Exact Hit Layer & Chronometer (v1.2.2)',
|
|
2323
|
+
side_dsl_containers: 'VStack, HStack, ZStack, Grid, Divider',
|
|
2324
|
+
side_dsl_text: 'UI.Text, UI.Badge & Biến động',
|
|
2325
|
+
side_dsl_image: 'UI.Image & System Icons (Apple / Google)',
|
|
2326
|
+
side_dsl_timer: 'UI.Timer (Đếm giờ phần cứng)',
|
|
2327
|
+
side_dsl_progress: 'UI.Progress (Bar, Segmented, Circle)',
|
|
2328
|
+
side_dsl_equalizer: 'UI.Equalizer (Sóng âm)',
|
|
2329
|
+
side_dsl_gauge: 'UI.Gauge 240° & UI.Chart',
|
|
2330
|
+
side_dsl_interactive: 'UI.Button, UI.Toggle & UI.Link',
|
|
2331
|
+
side_dsl_custom: 'UI.Custom & DynamicNodeRegistry',
|
|
2332
|
+
side_styling: 'Gradient, Shadow, Border, Tinted',
|
|
2333
|
+
side_header_api: 'API Reference & Hooks',
|
|
2334
|
+
side_api_liveactivity: 'LiveActivity & Dynamic Island',
|
|
2335
|
+
side_api_widget: 'Widget API, Multi-page & Lock Screen',
|
|
2336
|
+
side_api_hooks: 'React Hooks & SharedStorage',
|
|
2337
|
+
side_api_remote: 'Remote API Sync (Kill App)',
|
|
2338
|
+
side_api_push: 'APNs & FCM Push Tokens',
|
|
2339
|
+
side_header_arch: 'Kiến trúc & Tối ưu',
|
|
2340
|
+
side_ir_semantic: 'UI Intermediate Representation (IR)',
|
|
2341
|
+
side_a11y: 'Accessibility & VoiceOver / TalkBack',
|
|
2342
|
+
side_capability: 'Ma trận Tính năng & Nền tảng',
|
|
2343
|
+
side_standby: 'Chế độ StandBy & Always-On Display',
|
|
2344
|
+
side_troubleshoot: 'Khắc phục sự cố & Lưu ý',
|
|
2345
|
+
side_header_ai: 'Tích hợp AI & Agent',
|
|
2346
|
+
side_llms: 'Chuẩn llms.txt',
|
|
2347
|
+
side_skill: 'AI Agent Skill (Antigravity/Claude)',
|
|
2348
|
+
side_header_resources: 'Tài nguyên & Liên kết',
|
|
2349
|
+
side_res_web: 'Web Docs Chính Thức ↗',
|
|
2350
|
+
side_res_guide_vi: 'Hướng Dẫn Chi Tiết (VI) ↗',
|
|
2351
|
+
side_res_guide_en: 'English Full Guide ↗',
|
|
2352
|
+
|
|
2353
|
+
footer_dev: 'react-native-live-widgets — Phát triển bởi <strong>Trần Tuấn Vũ</strong>',
|
|
2354
|
+
footer_sub: 'Giấy phép mã nguồn mở MIT • Sẵn sàng cho Production',
|
|
2355
|
+
},
|
|
2356
|
+
en: {
|
|
2357
|
+
version_tag: 'v1.2.2',
|
|
2358
|
+
announcement_tag: 'New v1.2.2',
|
|
2359
|
+
announcement_text: 'Exact Dynamic Hit Layer, Native Chronometer Countdown, Swift 6 Ready & Standardized <strong>UI IR</strong>',
|
|
2360
|
+
announcement_link: 'Learn more →',
|
|
2361
|
+
brand_subtitle: 'Declarative Widgets & Dynamic Island Engine',
|
|
2362
|
+
nav_sim: 'Live Simulator',
|
|
2363
|
+
nav_install: 'Installation',
|
|
2364
|
+
nav_dsl: 'UI DSL & JSX',
|
|
2365
|
+
nav_api: 'API Reference',
|
|
2366
|
+
hero_badge: '100% Declarative UI • Zero Swift / Kotlin • Expo CNG Ready',
|
|
2367
|
+
hero_title_1: 'Live Activities & Dynamic Island',
|
|
2368
|
+
hero_title_2: 'Powered by TypeScript & JSX',
|
|
2369
|
+
hero_desc: 'All-in-One declarative solution for <strong>Live Activities</strong>, <strong>Dynamic Island</strong>, and <strong>Interactive Home Screen Widgets</strong> on iOS & Android. Built-in <code><WidgetPreview></code> and open AI Agent standard.',
|
|
2370
|
+
hero_btn_install: 'Get Started',
|
|
2371
|
+
hero_btn_sim: 'Live Simulator',
|
|
2372
|
+
hero_btn_expo: 'Expo Sample App ↗',
|
|
2373
|
+
btn_copy: 'Copy',
|
|
2374
|
+
btn_copy_code: 'Copy Code',
|
|
2375
|
+
sim_header_badge: 'Interactive In-Browser Demo',
|
|
2376
|
+
sim_header_title: 'Live Simulator: Dynamic Island & Home Widgets',
|
|
2377
|
+
sim_header_desc: 'Click presets below to see Dynamic Island morphing, live Equalizer waves, and instant Home Widget button reactions!',
|
|
2378
|
+
sim_tab_delivery: '1. Food Delivery (Dynamic Island)',
|
|
2379
|
+
sim_tab_music: '2. Live Equalizer Waves',
|
|
2380
|
+
sim_tab_pomodoro: '3. Hardware Timer (UI.Timer)',
|
|
2381
|
+
sim_tab_widget: '4. Interactive 2-Way Home Widget',
|
|
2382
|
+
sim_hint: 'Click buttons inside the widget to see interactive response!',
|
|
2383
|
+
sim_code_label: 'Declarative TypeScript Code',
|
|
2384
|
+
why_title: 'Why Choose `react-native-live-widgets`?',
|
|
2385
|
+
why_desc: 'A breakthrough architecture that builds Native Widgets 10x faster while preserving maximum runtime performance.',
|
|
2386
|
+
f1_title: 'Zero Swift / Kotlin Coding',
|
|
2387
|
+
f1_desc: 'Author your UI entirely in JavaScript/TypeScript or React JSX. The engine automatically compiles layouts into native ASTs for WidgetKit and RemoteViews.',
|
|
2388
|
+
f2_title: 'Bidirectional AppIntents',
|
|
2389
|
+
f2_desc: 'Home Widget buttons trigger JavaScript callbacks inside React Native via the useWidgetAction() hook without opening the main app.',
|
|
2390
|
+
f3_title: 'Zero-Battery Hardware Timers',
|
|
2391
|
+
f3_desc: 'UI.Timer executes smooth second ticks on Dynamic Island and Home Widgets using native OS hardware clocks without waking up the CPU.',
|
|
2392
|
+
f4_title: 'Realtime Audio Equalizer',
|
|
2393
|
+
f4_desc: 'The only library providing smooth oscillating sound wave animations on Dynamic Island and ongoing notifications for audio and podcast apps.',
|
|
2394
|
+
f5_title: 'Background API Sync When Killed',
|
|
2395
|
+
f5_desc: 'Widget.setRemoteConfig() lets the operating system autonomously fetch JSON from remote REST endpoints and update widgets even when the app is force-closed.',
|
|
2396
|
+
f6_title: 'AI Agent Standard (llms.txt)',
|
|
2397
|
+
f6_desc: '100% optimized for Claude Code, ChatGPT, Cursor, and Antigravity through llms.txt and SKILL.md. Your coding agent can build error-free widgets.',
|
|
2398
|
+
|
|
2399
|
+
// Quick Start Section
|
|
2400
|
+
qs_title: 'Get Started in Under 3 Minutes',
|
|
2401
|
+
qs_desc: 'Choose the setup method that fits your project: fully automated All-in-One CLI or manual integration.',
|
|
2402
|
+
expo_card_title: 'Expo Project (EAS Build / Prebuild)',
|
|
2403
|
+
expo_card_desc: 'Add plugin to <code>app.json</code> / <code>app.config.js</code> and enable required permissions.',
|
|
2404
|
+
expo_plugin_label: 'Configure Config Plugin in <code>app.json</code>:',
|
|
2405
|
+
bare_card_title: 'Bare React Native CLI Project',
|
|
2406
|
+
codegen_card_title: 'Auto Code Generation via CLI',
|
|
2407
|
+
codegen_card_desc: 'Use the built-in CLI command to automatically configure iOS Extension targets and Android Widget Providers without manually editing Xcode or Android Studio.',
|
|
2408
|
+
|
|
2409
|
+
// Exact Hit Layer Section (v1.2.2)
|
|
2410
|
+
hit_badge: 'V1.2.2 NEW',
|
|
2411
|
+
hit_title: 'Pixel-Exact Dynamic Hit Layer, Chronometer & Swift 6 Ready',
|
|
2412
|
+
hit_desc: 'Release <strong>v1.2.2</strong> introduces a full overhaul of Android Home Screen Widget touch interaction, native hardware countdown chronometers, and full <strong>Swift 6 Language Mode</strong> compatibility on modern Xcode.',
|
|
2413
|
+
hit_card1_title: '1. Exact Dynamic Hit Layer (<code>rn_hit_layer</code>)',
|
|
2414
|
+
hit_card1_desc: 'Completely replaces the legacy fixed grid with a dynamic <code>FrameLayout</code> layer (<code>rn_live_widget_hit_zone.xml</code>). The <code>computeCanvasMapping</code> algorithm maps exact coordinates from Bitmap Canvas to real launcher bounds (handling <code>fitCenter</code> letterbox padding). Every button and checkbox triggers with 100% precision, while empty areas never misfire.',
|
|
2415
|
+
hit_card2_title: '2. Native Chronometer Countdown (Android)',
|
|
2416
|
+
hit_card2_desc: 'Directly integrates <code>android.widget.Chronometer</code> with <code>setChronometerCountDown(true)</code> and <code>baseMillis = SystemClock.elapsedRealtime() + remainingMillis</code>. When countdown timers are active, static text is hidden from the bitmap so native hardware ticks down every second without canvas redraws.',
|
|
2417
|
+
hit_card3_title: '3. Variable Interpolation & <code>defaultChecked</code> Store',
|
|
2418
|
+
hit_card3_desc: '<code>DynamicWidgetStateStore</code> supports template string interpolation for <code>{{id}}</code>, <code>{{title}}</code>, flat counter values, and automatically persists initial <code>defaultChecked</code> states for <code>checked: true</code> toggles on first render for seamless toggle behavior.',
|
|
2419
|
+
hit_card4_title: '4. Swift 6 Language Mode Ready (iOS)',
|
|
2420
|
+
hit_card4_desc: 'Resolves Xcode compiler errors (such as <code>type \'()\' cannot conform to \'View\'</code>) by wrapping font closures inside <code>renderText()</code>, isolating accessibility into <code>buildAccessibilityView(content:) -> AnyView</code>, and adding <code>EmptyView()</code> fallbacks for <code>ContainerStyleModifier</code> branches.',
|
|
2421
|
+
|
|
2422
|
+
// DSL Image
|
|
2423
|
+
dsl_image_title: 'Images & System Icons: <code>UI.Image</code> & <code><Image></code>',
|
|
2424
|
+
dsl_image_desc: 'Supports <strong>5 image sources</strong>: <code>url</code> (auto-downloaded, downscaled to 360px max dimension, and cached), <code>base64</code> (QR/Barcode), <code>systemName</code>, <code>assetName</code>, and <code>filePath</code>. Features dedicated cross-platform props <code>systemNameIos</code> (Apple SF Symbols) and <code>systemNameAndroid</code> (Google Material Icons) with full TypeScript auto-complete.',
|
|
2425
|
+
|
|
2426
|
+
// Sidebar Elements
|
|
2427
|
+
side_header_start: 'Getting Started',
|
|
2428
|
+
side_quick_start: 'All-in-One CLI Setup',
|
|
2429
|
+
side_expo_setup: 'Expo (Config Plugin & CNG)',
|
|
2430
|
+
side_bare_rn: 'Bare React Native CLI',
|
|
2431
|
+
side_header_syntax: 'Syntax & UI Engine',
|
|
2432
|
+
side_jsx_support: 'JSX / TSX & StyleSheet Syntax',
|
|
2433
|
+
side_widget_preview: '<WidgetPreview> Simulation',
|
|
2434
|
+
side_exact_hit: 'Exact Hit Layer & Chronometer (v1.2.2)',
|
|
2435
|
+
side_dsl_containers: 'VStack, HStack, ZStack, Grid, Divider',
|
|
2436
|
+
side_dsl_text: 'UI.Text, UI.Badge & Variables',
|
|
2437
|
+
side_dsl_image: 'UI.Image & System Icons (Apple / Google)',
|
|
2438
|
+
side_dsl_timer: 'UI.Timer (Hardware Countdown)',
|
|
2439
|
+
side_dsl_progress: 'UI.Progress (Bar, Segmented, Circle)',
|
|
2440
|
+
side_dsl_equalizer: 'UI.Equalizer (Sound Waves)',
|
|
2441
|
+
side_dsl_gauge: 'UI.Gauge 240° & UI.Chart',
|
|
2442
|
+
side_dsl_interactive: 'UI.Button, UI.Toggle & UI.Link',
|
|
2443
|
+
side_dsl_custom: 'UI.Custom & DynamicNodeRegistry',
|
|
2444
|
+
side_styling: 'Gradient, Shadow, Border, Tinted',
|
|
2445
|
+
side_header_api: 'API Reference & Hooks',
|
|
2446
|
+
side_api_liveactivity: 'LiveActivity & Dynamic Island',
|
|
2447
|
+
side_api_widget: 'Widget API, Multi-page & Lock Screen',
|
|
2448
|
+
side_api_hooks: 'React Hooks & SharedStorage',
|
|
2449
|
+
side_api_remote: 'Remote API Sync (Kill App)',
|
|
2450
|
+
side_api_push: 'APNs & FCM Push Tokens',
|
|
2451
|
+
side_header_arch: 'Architecture & Optimizations',
|
|
2452
|
+
side_ir_semantic: 'UI Intermediate Representation (IR)',
|
|
2453
|
+
side_a11y: 'Accessibility & VoiceOver / TalkBack',
|
|
2454
|
+
side_capability: 'Feature & Platform Matrix',
|
|
2455
|
+
side_standby: 'StandBy Mode & Always-On Display',
|
|
2456
|
+
side_troubleshoot: 'Troubleshooting & FAQ',
|
|
2457
|
+
side_header_ai: 'AI Agents & Standards',
|
|
2458
|
+
side_llms: 'llms.txt Standard',
|
|
2459
|
+
side_skill: 'AI Agent Skill (Antigravity/Claude)',
|
|
2460
|
+
side_header_resources: 'Resources & Links',
|
|
2461
|
+
side_res_web: 'Official Web Docs ↗',
|
|
2462
|
+
side_res_guide_vi: 'Detailed Guide (VI) ↗',
|
|
2463
|
+
side_res_guide_en: 'English Full Guide ↗',
|
|
2464
|
+
|
|
2465
|
+
footer_dev: 'react-native-live-widgets — Developed by <strong>Vu Tran</strong>',
|
|
2466
|
+
footer_sub: 'MIT Open Source License • Production Ready',
|
|
2467
|
+
}
|
|
2468
|
+
};
|
|
2469
|
+
|
|
2470
|
+
let currentLang = 'vi';
|
|
2471
|
+
|
|
2472
|
+
function switchLanguage(lang) {
|
|
2473
|
+
currentLang = lang;
|
|
2474
|
+
try {
|
|
2475
|
+
localStorage.setItem('rn_live_widgets_lang', lang);
|
|
2476
|
+
} catch (_e) {}
|
|
2477
|
+
document.documentElement.lang = lang;
|
|
2478
|
+
|
|
2479
|
+
const dict = translations[lang] || translations.vi;
|
|
2480
|
+
document.querySelectorAll('[data-i18n]').forEach(el => {
|
|
2481
|
+
const key = el.getAttribute('data-i18n');
|
|
2482
|
+
if (dict[key]) {
|
|
2483
|
+
el.innerHTML = dict[key];
|
|
2484
|
+
}
|
|
2485
|
+
});
|
|
2486
|
+
|
|
2487
|
+
// Update button toggle style
|
|
2488
|
+
const btnVi = document.getElementById('lang-btn-vi');
|
|
2489
|
+
const btnEn = document.getElementById('lang-btn-en');
|
|
2490
|
+
if (btnVi && btnEn) {
|
|
2491
|
+
if (lang === 'vi') {
|
|
2492
|
+
btnVi.className = 'px-2 py-0.5 rounded-md transition text-sky-400 bg-sky-500/20 shadow-sm font-bold';
|
|
2493
|
+
btnEn.className = 'px-2 py-0.5 rounded-md transition text-slate-400 hover:text-white font-normal';
|
|
2494
|
+
} else {
|
|
2495
|
+
btnVi.className = 'px-2 py-0.5 rounded-md transition text-slate-400 hover:text-white font-normal';
|
|
2496
|
+
btnEn.className = 'px-2 py-0.5 rounded-md transition text-sky-400 bg-sky-500/20 shadow-sm font-bold';
|
|
2497
|
+
}
|
|
2498
|
+
}
|
|
2499
|
+
}
|
|
2500
|
+
|
|
2501
|
+
// Scroll to top button visibility & Sidebar ScrollSpy
|
|
2502
|
+
function updateActiveSidebarLink() {
|
|
2503
|
+
const links = Array.from(document.querySelectorAll('#docs-sidebar a.sidebar-link'));
|
|
2504
|
+
if (!links.length) return;
|
|
2505
|
+
|
|
2506
|
+
const offset = 120;
|
|
2507
|
+
let activeId = links[0].getAttribute('href').slice(1);
|
|
2508
|
+
|
|
2509
|
+
for (const link of links) {
|
|
2510
|
+
const href = link.getAttribute('href');
|
|
2511
|
+
if (!href || !href.startsWith('#')) continue;
|
|
2512
|
+
const id = href.slice(1);
|
|
2513
|
+
const target = document.getElementById(id);
|
|
2514
|
+
if (target && target.getBoundingClientRect().top <= offset) {
|
|
2515
|
+
activeId = id;
|
|
2516
|
+
}
|
|
2517
|
+
}
|
|
2518
|
+
|
|
2519
|
+
links.forEach(link => {
|
|
2520
|
+
const isMatch = link.getAttribute('href') === '#' + activeId;
|
|
2521
|
+
if (isMatch) {
|
|
2522
|
+
link.classList.add('bg-sky-500/15', 'text-sky-300', 'font-semibold', 'rounded-md', 'px-2', '-mx-2');
|
|
2523
|
+
} else {
|
|
2524
|
+
link.classList.remove('bg-sky-500/15', 'text-sky-300', 'font-semibold', 'rounded-md', 'px-2', '-mx-2');
|
|
2525
|
+
}
|
|
2526
|
+
});
|
|
2527
|
+
}
|
|
2528
|
+
|
|
1303
2529
|
window.addEventListener('scroll', () => {
|
|
1304
2530
|
const topBtn = document.getElementById('back-to-top');
|
|
1305
2531
|
if (window.scrollY > 400) {
|
|
@@ -1309,12 +2535,21 @@ useWidgetAction('INCREMENT', () => {
|
|
|
1309
2535
|
topBtn.classList.add('opacity-0', 'pointer-events-none');
|
|
1310
2536
|
topBtn.classList.remove('opacity-100');
|
|
1311
2537
|
}
|
|
1312
|
-
|
|
2538
|
+
updateActiveSidebarLink();
|
|
2539
|
+
}, { passive: true });
|
|
1313
2540
|
|
|
1314
2541
|
// Initialize initial state
|
|
1315
2542
|
document.addEventListener('DOMContentLoaded', () => {
|
|
1316
2543
|
lucide.createIcons();
|
|
2544
|
+
if (typeof Prism !== 'undefined') {
|
|
2545
|
+
Prism.highlightAll();
|
|
2546
|
+
}
|
|
1317
2547
|
switchSimulator('delivery');
|
|
2548
|
+
updateActiveSidebarLink();
|
|
2549
|
+
try {
|
|
2550
|
+
const savedLang = localStorage.getItem('rn_live_widgets_lang') || 'vi';
|
|
2551
|
+
switchLanguage(savedLang);
|
|
2552
|
+
} catch (_e) {}
|
|
1318
2553
|
});
|
|
1319
2554
|
</script>
|
|
1320
2555
|
</body>
|