Skip to main content
ContainersLevel 3

Service Card

服务卡片 / 原子化万能卡片

鸿蒙专属MobileHarmonyOSDifficulty: Medium

The signature interactive widget of HarmonyOS — surfacing live app status and high-frequency services directly on the home screen without opening the app.

01

Live Demo

Actually clickable
Live Demo Playground
实时天气

25°

多云转晴 · 深圳

空气优 24免安装直达 ›
HarmonyOS ArkUI 规范:桌面原子化万能卡片,将应用的核心动态与服务外显于桌面,支持免安装交互与一触即达。

What you just saw:The weather or to-do memo widget pinned to a Huawei home screen that lets you check off tasks or glance at city temperatures without launching the main application.

02

What it actually is

Service Card (Universal Widget / Service Card) is the flagship micro-interface paradigm in HarmonyOS ArkUI. It transcends traditional isolated apps by condensing essential data and state (such as real-time ride tracking, delivery status, flight check-in, media playback, and fitness metrics) into 2x2, 2x4, or 4x4 desktop micro-windows. Users can view dynamic updates at a glance, trigger one-tap actions like play/pause directly on the card, or launch lightweight atomic services without full installation.

service cardharmonyos widgetatomic service carddesktop widgetuniversal card
03

Anatomy · What it's made of

  1. Card Container微卡片容器

    Standard grid form factor (2x2: 150x150, 2x4: 310x150) with 16-24px rounded corners

  2. Header / Brand服务标识区

    App micro-icon and card name at the top left

  3. Key Visual / Data核心指标与状态

    Large display numerals, dynamic sparkline charts, or state badges

  4. Quick Action一键动作触发

    Micro-buttons and pill actions triggering card actions or atomic service routing

04

When to Use

When it fits, and when it doesn't
Service Card usage recommendations
SituationUse it?
Time-sensitive or ambient app state needs continuous visibility (delivery tracking, market tickers, calendar reminders)Yes
Providing ultra-fast single-tap actions (music playback toggle, smart home switch, one-tap check-in)Yes
Serving as a direct interactive gateway into lightweight HarmonyOS atomic servicesYes
Overloading the widget with deep multi-step forms or long scrolling lists (redirect to the app instead)No

Do not treat service cards as mini-browsers; space is constrained and requires restrained, high-signal information.

Avoid complex nested scrolling lists or multi-level navigation within desktop cards to avoid degrading home screen swipe physics.

05

Similar Patterns

Don't mix these up
06

How to tell AI

Three levels of prompt

Add the component name and specifics

Build a 2x2 weather service card following HarmonyOS ArkUI specs: ambient desktop widget displaying live temperature, weather icon, air quality, and one-tap refresh.

07

Don't just say this to AI

Bad → Better

Don't say this to AI

Draw a phone widget.

Say this instead

Follow HarmonyOS ArkUI Service Card specs: conform to standard 2x2 grid dimensions, expose vital live metrics and micro-actions, and support zero-install atomic service launching.

08

Share this card

Social-ready

Turn this pattern into a 3:4 or 1:1 knowledge card and export it as PNG right in the browser. No backend needed.