Widgets

A widget is an extension that displays a small amount of timely, useful information or app-specific functionality. For example, the News widget shows top headlines. Calendar provides two widgets, one that shows today’s events and one that shows what’s up next. Notes lets you preview recent notes and quickly create new notes, reminders, photos, and drawings. Widgets are highly customizable and can contain buttons, text, layout customizations, images, and more.

μœ„μ ―μ€ μ†ŒλŸ‰μ˜ μ‹œκΈ°μ μ ˆν•˜κ³  μœ μš©ν•œ 정보 λ˜λŠ” μ•± 별 κΈ°λŠ₯을 ν‘œμ‹œν•˜λŠ” ν™•μž₯ κΈ°λŠ₯μž…λ‹ˆλ‹€. 예λ₯Ό λ“€μ–΄ λ‰΄μŠ€ μœ„μ ―μ€ μ£Όμš” ν—€λ“œλΌμΈμ„ ν‘œμ‹œν•©λ‹ˆλ‹€. μΊ˜λ¦°λ”λŠ” 였늘의 이벀트λ₯Ό 보여 μ£ΌλŠ” μœ„μ ―κ³Ό λ‹€μŒ μž‘μ—…μ„ λ³΄μ—¬μ£ΌλŠ” μœ„μ ― 두 가지λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€. Notesλ₯Ό μ‚¬μš©ν•˜μ—¬ 졜근 λ…ΈνŠΈλ₯Ό 미리 보고 μƒˆ λ…ΈνŠΈ, 미리 μ•Œλ¦Ό, 사진 및 그림을 λΉ λ₯΄κ²Œ μž‘μ„±ν•  수 μžˆμŠ΅λ‹ˆλ‹€. μœ„μ ―μ€ μ‚¬μš©μž 지정이 μš©μ΄ν•˜λ©° 단좔, ν…μŠ€νŠΈ, λ ˆμ΄μ•„μ›ƒ μ‚¬μš©μž 지정, 이미지 등을 포함할 수 μžˆμŠ΅λ‹ˆλ‹€.

Widgets appear above the quick action list when you apply pressure to an app icon on the Home screen using 3D Touch. People also add the widgets they care about to the Search screen, which is accessed by swiping to the right on the Home screen and the Lock screen. Your goal should be to design a widget that people want to add to the Search screen.

3D Touchλ₯Ό μ‚¬μš©ν•˜μ—¬ ν™ˆ 슀크린의 μ•± μ•„μ΄μ½˜μ— μ••λ ₯을 κ°€ν•˜λŠ” 경우 μœ„μ ―μ΄ λΉ λ₯Έ μž‘μ—… λͺ©λ‘ μœ„μ— λ‚˜νƒ€λ‚©λ‹ˆλ‹€. λ˜ν•œ ν™ˆ 슀크린과 잠금 ν™”λ©΄μ˜ 였λ₯Έμͺ½μœΌλ‘œ μŠ€μœ•ν•˜μ—¬ μ•‘μ„ΈμŠ€ν•˜λŠ” 검색 화면에 μœ„μ ―μ„ μΆ”κ°€ν•©λ‹ˆλ‹€. 검색 화면에 μΆ”κ°€ν•  μœ„μ ―μ„ μ„€κ³„ν•˜λŠ” 것이 λͺ©ν‘œμ—¬μ•Ό ν•©λ‹ˆλ‹€.

Design a great glanceable experience. People use widgets to get brief updates and perform very simple tasks, so it’s essential to deliver the right amount of information and interactivity. Wherever possible, provide tasks that can be completed in a single tap. Panning and scrolling within widgets isn’t supported.

ν›Œλ₯­ν•œ λˆˆμ— λ„λŠ” κ²½ν—˜μ„ λ””μžμΈ ν•˜μ‹­μ‹œμ˜€. μ‚¬λžŒλ“€μ€ μœ„μ ―μ„ μ‚¬μš©ν•˜μ—¬ κ°„λ‹¨ν•œ μ—…λ°μ΄νŠΈλ₯Ό λ°›κ³  맀우 κ°„λ‹¨ν•œ μž‘μ—…μ„ μˆ˜ν–‰ν•˜λ―€λ‘œ μ μ ˆν•œ μ–‘μ˜ 정보와 μƒν˜Έ μž‘μš©μ„ μ œκ³΅ν•˜λŠ” 것이 ν•„μˆ˜μ μž…λ‹ˆλ‹€. κ°€λŠ₯ν•˜λ‹€λ©΄ ν•œ λ²ˆμ— μ™„λ£Œ ν•  μˆ˜μžˆλŠ” μž‘μ—…μ„ μ œκ³΅ν•˜μ‹­μ‹œμ˜€. μœ„μ ― λ‚΄μ—μ„œμ˜ 이동 및 μŠ€ν¬λ‘€μ€ μ§€μ›λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.

Show content quickly. People spend very little time looking at widgets and shouldn’t need to wait for content to load. Cache information locally so you can always show recent information while getting updates.

컨텐츠λ₯Ό λΉ λ₯΄κ²Œ λ³΄μ—¬μ£Όμ‹­μ‹œμ˜€. μ‚¬λžŒλ“€μ€ μœ„μ ―μ„ λ³΄λŠ” 데 거의 μ‹œκ°„μ„ μ†ŒλΉ„ν•˜μ§€ μ•ŠμœΌλ©° 컨텐츠가 λ‘œλ“œλ  λ•ŒκΉŒμ§€ 기닀릴 ν•„μš”κ°€ μ—†μŠ΅λ‹ˆλ‹€. μ—…λ°μ΄νŠΈλ₯Ό κ°€μ Έμ˜€λŠ” λ™μ•ˆ 항상 μ΅œμ‹  정보λ₯Ό ν‘œμ‹œν•  수 μžˆλ„λ‘ 정보λ₯Ό 둜컬둜 μΊμ‹œν•©λ‹ˆλ‹€.

Provide ample margins and padding. Avoid extending content to the edges of a widget. In general, provide a margin of at least a few pixels between each edge and the content. Use the app icon at the top of your widget for alignment guidance. Content tends to work well when lined up with the center of this icon. If your app offers a grid-style layout, make sure you provide sufficient and equal padding between grid items. If possible, limit grids of icons and buttons to four per row.

ν™•μ‹€ν•œ μ—¬λ°±κ³Ό νŒ¨λ”©μ„ μ œκ³΅ν•˜μ‹­μ‹œμ˜€. 컨텐츠λ₯Ό μœ„μ ― κ°€μž₯자리둜 ν™•μž₯ν•˜μ§€ λ§ˆμ‹­μ‹œμ˜€. 일반적으둜 각 κ°€μž₯μžλ¦¬μ™€ 컨텐츠 사이에 μ΅œμ†Œ λͺ‡ ν”½μ…€μ˜ 여백을 μ œκ³΅ν•©λ‹ˆλ‹€. μ •λ ¬ μ•ˆλ‚΄λŠ” μœ„μ ― 상단에 μžˆλŠ” μ•± μ•„μ΄μ½˜μ„ μ‚¬μš©ν•˜μ‹­μ‹œμ˜€. μ»¨ν…μΈ λŠ” 이 μ•„μ΄μ½˜μ˜ κ°€μš΄λ°μ™€ μ •λ ¬ν•  λ•Œ 잘 μž‘λ™ν•˜λŠ” κ²½ν–₯이 μžˆμŠ΅λ‹ˆλ‹€. μ•±μ—μ„œ κ·Έλ¦¬λ“œ μŠ€νƒ€μΌ λ ˆμ΄μ•„μ›ƒμ„ μ œκ³΅ν•˜λŠ” 경우 κ·Έλ¦¬λ“œ ν•­λͺ© 간에 μΆ©λΆ„ν•œ νŒ¨λ”©μ„ μ œκ³΅ν•΄μ•Ό ν•©λ‹ˆλ‹€. κ°€λŠ₯ν•œ 경우 μ•„μ΄μ½˜ 및 λ²„νŠΌ κ·Έλ¦¬λ“œλ₯Ό ν–‰λ‹Ή 4개둜 μ œν•œν•©λ‹ˆλ‹€.

Be adaptable. The width of a widget varies, depending on the device and orientation. The height and information displayed by a widget depends on whether it’s collapsed or expanded (not all widgets support expansion). A collapsed widget is the height of roughly two and a half table rows. An expanded widget is ideally no taller than the height of the screen. The quick action list only shows widgets in a collapsed state. When collapsed, a widget shows essential information that can stand alone. When expanded, a widget shows additional information that enhances the primary information. The Weather widget, for example, shows the current weather conditions when collapsed, but adds the hourly forecast when expanded.

μ μ‘ν˜•μ΄ λ˜μ‹­μ‹œμ˜€. μœ„μ ―μ˜ 폭은 λ””λ°”μ΄μŠ€ 및 λ°©ν–₯에 따라 λ‹¬λΌμ§‘λ‹ˆλ‹€. μœ„μ ―μ΄ ν‘œμ‹œν•˜λŠ” 높이와 μ •λ³΄λŠ” μΆ•μ†Œ λ˜λŠ” ν™•μž₯ 여뢀에 따라 λ‹¬λΌμ§‘λ‹ˆλ‹€(λͺ¨λ“  μœ„μ ―μ΄ ν™•μž₯을 μ§€μ›ν•˜λŠ” 것은 μ•„λ‹˜). μΆ•μ†Œλœ μœ„μ ―μ€ μ•½ 2개 및 1/2개의 ν…Œμ΄λΈ” ν–‰μ˜ λ†’μ΄μž…λ‹ˆλ‹€. ν™•μž₯된 μœ„μ ―μ€ μ΄μƒμ μœΌλ‘œλŠ” ν™”λ©΄ 높이보닀 크지 μ•ŠμŠ΅λ‹ˆλ‹€. λΉ λ₯Έ μ•‘μ…˜ λͺ©λ‘μ—λŠ” μΆ•μ†Œ μƒνƒœμ˜ μœ„μ ―λ§Œ ν‘œμ‹œλ©λ‹ˆλ‹€. μΆ•μ†Œλœ 경우 μœ„μ ―μ€ λ‹¨λ…μœΌλ‘œ μˆ˜ν–‰ν•  수 μžˆλŠ” ν•„μˆ˜ 정보λ₯Ό 보여 μ€λ‹ˆλ‹€. ν™•μž₯ν•˜λ©΄ κΈ°λ³Έ 정보λ₯Ό ν–₯μƒμ‹œν‚€λŠ” μΆ”κ°€ 정보가 μœ„μ ―μ— ν‘œμ‹œλ©λ‹ˆλ‹€. 예λ₯Ό λ“€μ–΄ 날씨 μœ„μ ―μ€ μΆ•μ†Œ μ‹œ ν˜„μž¬ 날씨 μƒνƒœλ₯Ό ν‘œμ‹œν•˜μ§€λ§Œ ν™•μž₯ μ‹œ μ‹œκ°„λ‹Ή μ˜ˆμΈ‘κ°’μ„ μΆ”κ°€ν•©λ‹ˆλ‹€.

Avoid customizing the background of a widget. The light, blurred widget background provided by the system is designed for consistency and legibility. Use it whenever possible. Never use a photo as a background, as it may clash with the Lock and Home screen wallpaper.

μœ„μ ―μ˜ 배경을 μ‚¬μš©μž μ •μ˜ν•˜μ§€ λ§ˆμ‹­μ‹œμ˜€. μ‹œμŠ€ν…œμ΄ μ œκ³΅ν•˜λŠ” 밝고 흐린 μœ„μ ― 배경은 일관성과 읽기 쉽도둝 μ„€κ³„λ˜μ—ˆμŠ΅λ‹ˆλ‹€. κ°€λŠ₯ν•  λ•Œλ§ˆλ‹€ μ‚¬μš©ν•˜μ‹­μ‹œμ˜€. 잠금 및 ν™ˆ ν™”λ©΄ λ°°κ²½ ν™”λ©΄κ³Ό 좩돌 ν•  수 μžˆμœΌλ―€λ‘œ 사진을 배경으둜 μ‚¬μš©ν•˜μ§€ λ§ˆμ‹­μ‹œμ˜€.

In general, use the system font in black or dark gray for text. The system font is designed for legibility, and dark colors work well with the standard widget background.

일반적으둜 ν…μŠ€νŠΈλŠ” 검은색 λ˜λŠ” νšŒμƒ‰μ˜ μ‹œμŠ€ν…œ 폰트λ₯Ό μ‚¬μš©ν•˜μ‹­μ‹œμ˜€. μ‹œμŠ€ν…œ 글꼴은 읽기 쉽도둝 μ„€κ³„λ˜μ—ˆμœΌλ©° μ–΄λ‘μš΄ 색상은 ν‘œμ€€ μœ„μ ― λ°°κ²½κ³Ό 잘 μž‘λ™ν•©λ‹ˆλ‹€.

When appropriate, let people jump to your app to do more. Your widget should operate independently from your app. However, if people might occasionally need to do more than what your widget offers, make it easy to do so. Don’t include an β€œOpen App” button that takes space away from your content. Instead, let people tap the content itself to see or edit it in your app. In the Calendar widget, for example, you can tap an event to open it in the Calendar app. Never use your widget to open other apps.

μ μ ˆν•œ 경우 μ‚¬λžŒλ“€μ΄ μ•±μœΌλ‘œ κ°€μ„œ 더 λ§Žμ€ 일을 ν•  수있게 ν•˜μ‹­μ‹œμ˜€. μœ„μ ―μ€ μ•±κ³Ό λ…λ¦½μ μœΌλ‘œ μž‘λ™ν•΄μ•Όν•©λ‹ˆλ‹€. κ·ΈλŸ¬λ‚˜ μ‚¬λžŒλ“€μ΄ μ’…μ’… μœ„μ ―μ΄ μ œκ³΅ν•˜λŠ” 것 이상을 μˆ˜ν–‰ν•  ν•„μš”κ°€ μžˆλŠ” 경우 μ‰½κ²Œ κ·Έλ ‡κ²Œ ν•  수 μžˆμŠ΅λ‹ˆλ‹€. μ½˜ν…μΈ μ˜ 곡간을 μ°¨μ§€ν•˜λŠ” "Open App" λ²„νŠΌμ„ ν¬ν•¨ν•˜μ§€ λ§ˆμ‹­μ‹œμ˜€. λŒ€μ‹  μ‚¬μš©μžκ°€ μ•±μ—μ„œ λ‚΄μš©μ„ λ³΄κ±°λ‚˜ νŽΈμ§‘ν•  수 μžˆμŠ΅λ‹ˆλ‹€. 예λ₯Ό λ“€μ–΄ 일정관리 μœ„μ ―μ—μ„œ 이벀트λ₯Ό 눌러 일정관리 μ•±μ—μ„œ μ—΄ 수 μžˆμŠ΅λ‹ˆλ‹€. μœ„μ ―μ„ μ‚¬μš©ν•˜μ—¬ λ‹€λ₯Έ 앱을 열지 λ§ˆμ‹­μ‹œμ˜€.

Pick a good widget name. An app icon and a title appear above each widget’s content. In general, your widget’s name should match your app’s name. If your app offers multiple widgets, consider using your app name for the primary one and clear, concise names for the others. If you use custom titles, consider prefixing them with your app name. For example, the Maps widget for showing nearby locations is titled Maps Nearby. The inclusion of your app name instills confidence that the widget is in fact provided by your app.

쒋은 μœ„μ ― 이름을 κ³ λ₯΄μ‹­μ‹œμ˜€. 각 μœ„μ ―μ˜ 컨텐츠 μœ„μ— μ•± μ•„μ΄μ½˜κ³Ό 제λͺ©μ΄ λ‚˜νƒ€λ‚©λ‹ˆλ‹€. 일반적으둜 μœ„μ ―μ˜ 이름은 μ•±μ˜ 이름과 μΌμΉ˜ν•΄μ•Όν•©λ‹ˆλ‹€. μ•±μ—μ„œ μ—¬λŸ¬ μœ„μ ―μ„ μ œκ³΅ν•˜λŠ” 경우 κΈ°λ³Έ μœ„μ ―μ— μ•± 이름을 μ‚¬μš©ν•˜κ³  λ‹€λ₯Έ μœ„μ ―μ— λŒ€ν•΄ λͺ…ν™•ν•˜κ³  κ°„κ²°ν•œ 이름을 μ‚¬μš©ν•˜λŠ” 것을 κ³ λ €ν•©λ‹ˆλ‹€. μ‚¬μš©μž 지정 제λͺ©μ„ μ‚¬μš©ν•˜λŠ” 경우, ν•΄λ‹Ή 제λͺ©μ„ μ•± μ΄λ¦„μœΌλ‘œ 접두사λ₯Ό μ§€μ •ν•˜λŠ” 것이 μ’‹μŠ΅λ‹ˆλ‹€. 예λ₯Ό λ“€μ–΄, 근처의 μœ„μΉ˜λ₯Ό ν‘œμ‹œν•˜κΈ° μœ„ν•œ 맡 μœ„μ ―μ˜ 제λͺ©μ€ Maps Nearbyμž…λ‹ˆλ‹€. μ•± 이름을 ν¬ν•¨ν•˜λ©΄ μœ„μ ―μ΄ μ‹€μ œλ‘œ μ•±μ—μ„œ μ œκ³΅λœλ‹€λŠ” 확신을 κ°–κ²Œ λ©λ‹ˆλ‹€.

Let people know when authentication adds value. If your widget provides additional functionality when someone is logged into your app, make sure people know about this. For example, an app that shows upcoming reservations might include a message that says β€œSign into the app to view your reservations.” when people aren’t logged in.

인증이 κ°€μΉ˜λ₯Ό 더할 λ•Œ μ‚¬λžŒλ“€μ—κ²Œ μ•Œλ¦¬μ‹­μ‹œμ˜€. λˆ„κ΅°κ°€κ°€ 앱에 λ‘œκ·ΈμΈν–ˆμ„ λ•Œ μœ„μ ―μ΄ μΆ”κ°€ κΈ°λŠ₯을 μ œκ³΅ν•œλ‹€λ©΄, μ‚¬λžŒλ“€μ΄ 이 사싀을 μ•Œλ„λ‘ν•˜μ‹­μ‹œμ˜€. 예λ₯Ό λ“€μ–΄ μ˜ˆμ •λœ μ˜ˆμ•½μ„ ν‘œμ‹œν•˜λŠ” μ•±μ—λŠ” μ‚¬λžŒλ“€μ΄ λ‘œκ·ΈμΈν•˜μ§€ μ•Šμ€ 경우 "앱에 λ‘œκ·ΈμΈν•˜μ—¬ μ˜ˆμ•½λ³΄κΈ°"λΌλŠ” λ©”μ‹œμ§€κ°€ 포함될 수 μžˆμŠ΅λ‹ˆλ‹€.

Choose a widget for the quick action list. If your app has multiple widgets, pick one to appear in the quick action menu that appears when someone applies pressure to your app icon on the Home screen using 3D Touch.

λΉ λ₯Έ μ•‘μ…˜ λͺ©λ‘μ„ μœ„ν•œ μœ„μ ―μ„ μ„ νƒν•˜μ‹­μ‹œμ˜€. 앱에 μ—¬λŸ¬ μœ„μ ―μ΄μžˆλŠ” 경우 λˆ„κ΅°κ°€κ°€ 3D Touchλ₯Ό μ‚¬μš©ν•˜μ—¬ ν™ˆ ν™”λ©΄μ˜ μ•± μ•„μ΄μ½˜μ— μ••λ ₯을 κ°€ν–ˆμ„ λ•Œ ν‘œμ‹œλ˜λŠ” λΉ λ₯Έ μ•‘μ…˜ 메뉴에 ν•˜λ‚˜λ₯Ό μ„ νƒν•˜μ—¬ ν‘œμ‹œν•˜μ‹­μ‹œμ˜€.

For developer guidance, see App Extension Programming Guide.

Widgets - Extensions - iOS - Human Interface Guidelines - Apple Developer

Last updated