ใช้ธีมมืด

ลองใช้วิธีการเขียน
Jetpack Compose เป็นชุดเครื่องมือ UI ที่แนะนำสำหรับ Android ดูวิธีใช้ธีมในเครื่องมือเขียน
รูปแบบสี - Material Design 3 →

รูปที่ 1 ธีมมืด

ธีมมืดพร้อมใช้งานใน Android 10 (API ระดับ 29) ขึ้นไป โดยมี ประโยชน์ดังต่อไปนี้

  • ลดการใช้พลังงานลงได้มาก โดยขึ้นอยู่กับลักษณะการใช้งานของอุปกรณ์ เทคโนโลยีหน้าจอ
  • ปรับปรุงระดับการมองเห็นสำหรับผู้ใช้ที่มีสายตาเลือนรางและผู้ที่มีความรู้สึกไวต่อแสงจ้า
  • ช่วยให้ใช้อุปกรณ์ในสภาพแวดล้อมที่มีแสงน้อยได้ง่ายขึ้น

ธีมมืดจะมีผลกับ UI ของระบบ Android และแอปที่ทำงานในอุปกรณ์

คุณเปิดใช้ธีมมืดใน Android 10 ขึ้นไปได้ 3 วิธีดังนี้

  • ใช้การตั้งค่าระบบโดยไปที่การตั้งค่า > การแสดงผล > ธีมเป็น เปิดใช้ธีมมืด
  • ใช้การ์ดการตั้งค่าด่วนเพื่อเปลี่ยนธีมจากถาดการแจ้งเตือน เมื่อเปิดใช้
  • ในอุปกรณ์ Pixel ให้เปิดใช้โหมดประหยัดแบตเตอรี่เพื่อเปิดใช้ธีมมืดพร้อมกัน อุปกรณ์อื่นๆ อาจไม่รองรับการทำงานนี้

สำหรับคำแนะนำในการใช้ธีมมืดกับเนื้อหาบนเว็บโดยใช้ WebView โปรดดูทำให้เนื้อหาเว็บมืดใน WebView

รองรับธีมมืดในแอป

หากต้องการรองรับธีมมืด ให้ตั้งค่าธีมของแอป ซึ่งปกติจะอยู่ใน res/values/styles.xml ให้รับค่าจากธีม DayNight ดังนี้

<style name="AppTheme" parent="Theme.AppCompat.DayNight">

หรือจะใช้คอมโพเนนต์วัสดุแบบมืดก็ได้ 

<style name="AppTheme" parent="Theme.MaterialComponents.DayNight">

ซึ่งจะเชื่อมโยงธีมหลักของแอปกับ Flag โหมดกลางคืนที่ระบบควบคุม และทำให้แอปมีธีมมืดเริ่มต้นเมื่อเปิดใช้

ธีมและสไตล์

หลีกเลี่ยงการใช้สีแบบฮาร์ดโค้ดหรือไอคอนสำหรับใช้ในธีมสว่าง ใช้ แอตทริบิวต์ธีม หรือทรัพยากรสำหรับกลางคืนแทน

แอตทริบิวต์ของธีม 2 อย่างที่สำคัญที่สุดสำหรับธีมมืดมีดังนี้

  • ?android:attr/textColorPrimary: สีข้อความอเนกประสงค์ ใช่เลย โหมดเกือบดำในธีมสว่างและขาวเกือบขาวในธีมมืด ประกอบด้วย สถานะปิดใช้
  • ?attr/colorControlNormal: สีไอคอนสำหรับวัตถุประสงค์ทั่วไป มีสถานะ "ปิดใช้"

เราขอแนะนำให้ใช้คอมโพเนนต์ Material Design เนื่องจากระบบธีมสี เช่น แอตทริบิวต์ธีม ?attr/colorSurface และ ?attr/colorOnSurface ช่วยให้เข้าถึงสีที่เหมาะสมได้ง่ายๆ คุณปรับแต่งแอตทริบิวต์เหล่านี้ในธีมได้

เปลี่ยนธีมในแอป

คุณอนุญาตให้ผู้ใช้เปลี่ยนธีมของแอปขณะที่แอปทำงานอยู่ได้ ตัวเลือกที่แนะนำมีดังนี้

  • น้อย
  • มืด
  • ค่าเริ่มต้นของระบบ (ตัวเลือกเริ่มต้นที่แนะนํา)

ตัวเลือกเหล่านี้จับคู่กับ AppCompat.DayNight โหมดโดยตรง

หากต้องการเปลี่ยนธีม ให้ทำดังนี้

  • สำหรับ API ระดับ 31 ขึ้นไป ให้ใช้ UiModeManager#setApplicationNightMode เพื่อให้ระบบทราบว่าแอปของคุณเรียกใช้ธีมใด ซึ่งจะช่วยให้ระบบจับคู่ธีมระหว่างหน้าจอแนะนำได้

  • ใน API ระดับ 30 หรือต่ำกว่า ให้ใช้ AppCompatDelegate.setDefaultNightMode() เพื่อเปลี่ยนธีม

บังคับใช้โหมดมืด

Android 10 มีบังคับใช้ธีมมืด ซึ่งเป็นฟีเจอร์สำหรับนักพัฒนาแอปในการใช้ธีมมืดอย่างรวดเร็วโดยไม่ต้องตั้งค่าธีม DayNight อย่างชัดเจน

Force Dark จะวิเคราะห์แต่ละมุมมองของแอปธีมสว่างและใช้ธีมมืด โดยอัตโนมัติก่อนที่จะวาดลงบนหน้าจอ คุณใช้ Force Dark ผสมกันได้ และการใช้งานแบบเนทีฟเพื่อลดเวลาที่ต้องติดตั้งใช้งาน

แอปต้องเลือกใช้ "บังคับใช้ธีมมืด" โดยการตั้งค่า android:forceDarkAllowed="true" ในธีมของกิจกรรม แอตทริบิวต์นี้ได้รับการตั้งค่าในทุกระบบ และ ธีมสว่างที่ AndroidX มีให้ เช่น Theme.Material.Light เมื่อคุณใช้ บังคับใช้โหมดมืด ทดสอบแอปอย่างละเอียดและยกเว้นมุมมองตามที่จำเป็น

หากแอปใช้ธีมมืด เช่น Theme.Material) ฟีเจอร์บังคับใช้ธีมมืดจะไม่เปิดใช้ ใช้แล้ว ในทํานองเดียวกัน หากธีมของแอปรับค่ามาจากธีม DayNight ระบบจะไม่ใช้ "บังคับใช้ธีมมืด" เนื่องจากมีการสลับธีมโดยอัตโนมัติ

ปิดใช้ "บังคับใช้โหมดมืด" ในข้อมูลพร็อพเพอร์ตี้

ปุ่ม "บังคับมืด" สามารถควบคุมได้ในบางมุมมองด้วย แอตทริบิวต์เลย์เอาต์ android:forceDarkAllowed หรือด้วย setForceDarkAllowed()

เนื้อหาเว็บ

โปรดดูข้อมูลเกี่ยวกับการใช้ธีมมืดในเนื้อหาบนเว็บที่หัวข้อดาร์กเว็บ ใน WebView ตัวอย่างธีมมืด ที่ใช้กับ WebView แล้ว โปรดดูการสาธิต WebView เกี่ยวกับ GitHub ที่ใช้เวลาเพียง 2 นาที

แนวทางปฏิบัติแนะนำ

ส่วนต่อไปนี้จะอธิบายแนวทางปฏิบัติแนะนำในการใช้ธีมมืด

การแจ้งเตือนและวิดเจ็ต

สำหรับแพลตฟอร์ม UI ที่คุณแสดงในอุปกรณ์แต่ไม่ได้ควบคุมโดยตรง ให้ตรวจสอบว่ามุมมองที่คุณใช้แสดงธีมของแอปโฮสต์ ตัวอย่าง 2 รายการได้แก่ การแจ้งเตือนและวิดเจ็ต Launcher

การแจ้งเตือน

ใช้เทมเพลตการแจ้งเตือนที่ระบบมีให้ เช่น MessagingStyle ช่วงเวลานี้ หมายความว่าระบบมีหน้าที่ใช้การจัดรูปแบบมุมมองที่ถูกต้อง

วิดเจ็ตและมุมมองการแจ้งเตือนที่กำหนดเอง

สำหรับวิดเจ็ตตัวเปิดแอป หรือหากแอปของคุณใช้มุมมองเนื้อหาการแจ้งเตือนที่กำหนดเอง ให้ทดสอบเนื้อหาทั้งในธีมแสงและธีมมืด

ข้อผิดพลาดทั่วไปที่ควรระวังมีดังต่อไปนี้

  • สมมติว่าสีพื้นหลังเป็นสีอ่อนเสมอ
  • สีข้อความแบบฮาร์ดโค้ด
  • การตั้งค่าสีพื้นหลังแบบฮาร์ดโค้ดขณะใช้สีข้อความเริ่มต้น
  • การใช้ไอคอนที่วาดได้ซึ่งมีสีคงที่

ในทุกกรณีเหล่านี้ ให้ใช้แอตทริบิวต์ธีมที่เหมาะสมแทนการกำหนดสีแบบฮาร์ดโค้ด

หน้าจอเรียกใช้

หากแอปมีหน้าจอเปิดใช้งานที่กำหนดเอง คุณอาจต้องแก้ไขหน้าจอเพื่อให้ ตรงกับธีมที่เลือก

นำสีที่กำหนดไว้อย่างเข้มงวดออก เช่น สีพื้นหลังที่กำหนดเป็นสีขาวแบบเป็นโปรแกรม ให้ใช้แอตทริบิวต์ธีม ?android:attr/colorBackground แทน

การเปลี่ยนแปลงการกำหนดค่า

เมื่อธีมของแอปเปลี่ยนแปลงไม่ว่าจะผ่านการตั้งค่าระบบหรือ AppCompat ก็จะทริกเกอร์การเปลี่ยนแปลงการกำหนดค่า uiMode ซึ่งหมายความว่าระบบจะสร้างกิจกรรมต่างๆ ขึ้นโดยอัตโนมัติ

ในบางกรณี คุณอาจต้องการให้แอปจัดการการเปลี่ยนแปลงการกำหนดค่า สำหรับ เช่น คุณอาจต้องเลื่อนการเปลี่ยนการกำหนดค่าเนื่องจากวิดีโอ กำลังเล่น

แอปสามารถจัดการการใช้งานธีมมืดได้โดยประกาศว่า Activity แต่ละรายการจัดการการเปลี่ยนแปลงการกำหนดค่า uiMode ได้ ดังนี้

<activity
    android:name=".MyActivity"
    android:configChanges="uiMode" />

เมื่อ Activity ประกาศว่าจัดการการเปลี่ยนแปลงการกําหนดค่า ระบบจะเรียกใช้เมธอด onConfigurationChanged() เมื่อมีการเปลี่ยนแปลงธีม

หากต้องการตรวจสอบธีมปัจจุบัน แอปสามารถเรียกใช้โค้ดได้ดังนี้

KotlinJava
val currentNightMode = configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK
when (currentNightMode) {
    Configuration.UI_MODE_NIGHT_NO -> {} // Night mode is not active, we're using the light theme.
    Configuration.UI_MODE_NIGHT_YES -> {} // Night mode is active, we're using dark theme.
}
 
int currentNightMode = configuration.uiMode & Configuration.UI_MODE_NIGHT_MASK;
switch (currentNightMode) {
    case Configuration.UI_MODE_NIGHT_NO:
        // Night mode is not active, we're using the light theme
        break;
    case Configuration.UI_MODE_NIGHT_YES:
        // Night mode is active, we're using dark theme
        break;
}