ธีมมืดพร้อมใช้งานใน Android 10 (API ระดับ 29) ขึ้นไป ซึ่งมีข้อดีดังนี้
- ลดการใช้พลังงานลงอย่างมาก โดยขึ้นอยู่กับเทคโนโลยีหน้าจอของอุปกรณ์
- ปรับปรุงระดับการมองเห็นสำหรับผู้ใช้ที่มีสายตาเลือนรางและผู้ที่มีความรู้สึกไวต่อแสงจ้า
- ช่วยให้ใช้อุปกรณ์ในสภาพแวดล้อมที่มีแสงน้อยได้ง่ายขึ้น
ธีมมืดจะมีผลกับ UI ของระบบ Android และแอปที่ทำงานในอุปกรณ์
คุณเปิดใช้ธีมมืดใน Android 10 ขึ้นไปได้ 3 วิธีดังนี้
- ใช้การตั้งค่าระบบโดยไปที่การตั้งค่า > การแสดงผล > ธีมเพื่อเปิดใช้ธีมมืด
- ใช้การ์ดการตั้งค่าด่วนเพื่อเปลี่ยนธีมจากถาดการแจ้งเตือนเมื่อเปิดใช้
- ในอุปกรณ์ Pixel ให้เปิดใช้โหมดประหยัดแบตเตอรี่เพื่อเปิดใช้ธีมมืดไปพร้อมๆ กัน อุปกรณ์อื่นๆ อาจไม่รองรับการทำงานนี้
ดูวิธีการใช้ธีมมืดกับเนื้อหาบนเว็บโดยใช้คอมโพเนนต์ WebView ได้ที่ทำให้เนื้อหาเว็บใน WebView มืดลง
รองรับธีมมืดในแอป
หากต้องการรองรับธีมมืด ให้ตั้งค่าธีมของแอป ซึ่งปกติจะอยู่ใน res/values/styles.xml ให้รับค่าจากธีม DayNight ดังนี้
<style name="AppTheme" parent="Theme.AppCompat.DayNight">
คุณยังใช้ธีมมืดของ Material Components ได้ด้วย
<style name="AppTheme" parent="Theme.MaterialComponents.DayNight">
ซึ่งจะเชื่อมโยงธีมหลักของแอปกับ Flag โหมดกลางคืนที่ระบบควบคุม และทำให้แอปมีธีมมืดเริ่มต้นเมื่อเปิดใช้
ธีมและสไตล์
หลีกเลี่ยงการใช้สีหรือไอคอนที่เขียนไว้ในโค้ดซึ่งมีไว้สำหรับธีมสีอ่อน ให้ใช้แอตทริบิวต์ธีมหรือทรัพยากรที่เหมาะสำหรับช่วงกลางคืนแทน
แอตทริบิวต์ธีม 2 รายการที่สําคัญที่สุดสําหรับธีมมืด ได้แก่
?android:attr/textColorPrimary: สีข้อความสำหรับวัตถุประสงค์ทั่วไป โดยไอคอนจะมีลักษณะเกือบดำในธีมสว่างและเกือบขาวในธีมมืด มีสถานะ "ปิดใช้"?attr/colorControlNormal: สีไอคอนสำหรับวัตถุประสงค์ทั่วไป มีสถานะ "ปิดใช้"
เราขอแนะนำให้ใช้คอมโพเนนต์ Material Design เนื่องจากระบบธีมสี เช่น แอตทริบิวต์ธีม ?attr/colorSurface และ ?attr/colorOnSurface ช่วยให้เข้าถึงสีที่เหมาะสมได้ง่ายๆ คุณปรับแต่งแอตทริบิวต์เหล่านี้ในธีมได้
เปลี่ยนธีมในแอป
คุณสามารถอนุญาตให้ผู้ใช้เปลี่ยนธีมของแอปขณะที่แอปทำงานอยู่ ตัวเลือกที่แนะนำมีดังนี้
- น้อย
- มืด
- ค่าเริ่มต้นของระบบ (ตัวเลือกเริ่มต้นที่แนะนำ)
ตัวเลือกเหล่านี้จะเชื่อมโยงกับโหมด AppCompat.DayNight โดยตรง
ไฟ:
MODE_NIGHT_NOมืด:
MODE_NIGHT_YESค่าเริ่มต้นของระบบ:
MODE_NIGHT_FOLLOW_SYSTEM
หากต้องการเปลี่ยนธีม ให้ทำดังนี้
ใน API ระดับ 31 ขึ้นไป ให้ใช้
UiModeManager#setApplicationNightModeเพื่อแจ้งให้ระบบทราบว่าแอปของคุณใช้ธีมใด วิธีนี้ช่วยให้ระบบจับคู่ธีมระหว่างหน้าจอแนะนำได้ใน API ระดับ 30 หรือต่ำกว่า ให้ใช้
AppCompatDelegate.setDefaultNightMode()เพื่อเปลี่ยนธีม
บังคับใช้ธีมมืด
Android 10 มีบังคับใช้ธีมมืด ซึ่งเป็นฟีเจอร์สำหรับนักพัฒนาแอปในการใช้ธีมมืดอย่างรวดเร็วโดยไม่ต้องตั้งค่าธีม DayNight อย่างชัดเจน
โหมดบังคับใช้โหมดมืดจะวิเคราะห์มุมมองแต่ละมุมมองของแอปธีมสว่างและใช้ธีมมืดโดยอัตโนมัติก่อนที่จะวาดภาพบนหน้าจอ คุณสามารถใช้ทั้งการบังคับใช้ธีมมืดและการใช้งานแบบเนทีฟเพื่อลดเวลาในการใช้งานธีมมืด
แอปต้องเลือกใช้ "บังคับใช้ธีมมืด" โดยการตั้งค่า android:forceDarkAllowed="true" ในธีมของกิจกรรม แอตทริบิวต์นี้ตั้งค่าไว้ในธีมสีอ่อนทั้งหมดที่ระบบและ AndroidX มีให้ เช่น Theme.Material.Light เมื่อใช้ตัวเลือก "บังคับใช้โหมดมืด" ให้ทดสอบแอปอย่างละเอียดและยกเว้นมุมมองตามที่จำเป็น
หากแอปใช้ธีมมืด เช่น Theme.Material) ระบบจะไม่บังคับใช้ธีมมืด ในทํานองเดียวกัน หากธีมของแอปรับค่ามาจากธีม DayNight ระบบจะไม่ใช้ "บังคับใช้ธีมมืด" เนื่องจากมีการสลับธีมโดยอัตโนมัติ
ปิดใช้ "บังคับใช้โหมดมืด" ในข้อมูลพร็อพเพอร์ตี้
คุณสามารถควบคุมโหมดมืดในบางมุมมองได้ด้วยแอตทริบิวต์android:forceDarkAllowedเลย์เอาต์หรือsetForceDarkAllowed()
เนื้อหาเว็บ
ดูข้อมูลเกี่ยวกับการใช้ธีมมืดในเนื้อหาบนเว็บได้ที่ทำให้เนื้อหาใน WebView มืดลง ดูตัวอย่างธีมมืดที่ใช้กับ WebView ได้ที่ตัวอย่าง WebView ใน GitHub
แนวทางปฏิบัติแนะนำ
ส่วนต่อไปนี้แสดงแนวทางปฏิบัติแนะนำในการใช้ธีมมืด
การแจ้งเตือนและวิดเจ็ต
สำหรับแพลตฟอร์ม UI ที่คุณแสดงในอุปกรณ์แต่ไม่ได้ควบคุมโดยตรง ให้ตรวจสอบว่ามุมมองที่คุณใช้แสดงธีมของแอปโฮสต์ ตัวอย่าง 2 อย่าง ได้แก่ การแจ้งเตือนและวิดเจ็ตตัวเปิด
การแจ้งเตือน
ใช้เทมเพลตการแจ้งเตือนที่ระบบมีให้ เช่น MessagingStyle ซึ่งหมายความว่าระบบจะเป็นผู้รับผิดชอบในการใช้การจัดรูปแบบมุมมองที่ถูกต้อง
วิดเจ็ตและมุมมองการแจ้งเตือนที่กำหนดเอง
สำหรับวิดเจ็ตตัวเปิดแอป หรือหากแอปของคุณใช้มุมมองเนื้อหาการแจ้งเตือนที่กำหนดเอง ให้ทดสอบเนื้อหาทั้งในธีมแสงและธีมมืด
ข้อผิดพลาดที่พบบ่อยซึ่งควรระวังมีดังนี้
- สมมติว่าสีพื้นหลังเป็นสีอ่อนเสมอ
- การเขียนโค้ดสีข้อความแบบฮาร์ดโค้ด
- การตั้งค่าสีพื้นหลังแบบฮาร์ดโค้ดขณะใช้สีข้อความเริ่มต้น
- การใช้ไอคอนที่วาดได้ซึ่งมีสีคงที่
ในทุกกรณีเหล่านี้ ให้ใช้แอตทริบิวต์ธีมที่เหมาะสมแทนการกำหนดสีแบบฮาร์ดโค้ด
หน้าจอเริ่มต้น
หากแอปของคุณมีหน้าจอเริ่มต้นที่กำหนดเอง คุณอาจต้องแก้ไขหน้าจอดังกล่าวเพื่อให้สอดคล้องกับธีมที่เลือก
นำสีที่เขียนเป็นโค้ดไว้ล่วงหน้าออก เช่น สีพื้นหลังที่ตั้งค่าเป็นสีขาวแบบเป็นโปรแกรม ให้ใช้แอตทริบิวต์ธีม ?android:attr/colorBackground แทน
การเปลี่ยนแปลงการกําหนดค่า
เมื่อธีมของแอปเปลี่ยนแปลงไม่ว่าจะผ่านการตั้งค่าระบบหรือ AppCompat ก็จะทริกเกอร์การเปลี่ยนแปลงการกำหนดค่า uiMode ซึ่งหมายความว่าระบบจะสร้างกิจกรรมขึ้นมาใหม่โดยอัตโนมัติ
ในบางกรณี คุณอาจต้องการให้แอปจัดการการเปลี่ยนแปลงการกำหนดค่า เช่น คุณอาจต้องการเลื่อนการเปลี่ยนแปลงการกําหนดค่าเนื่องจากมีวิดีโอเล่นอยู่
แอปสามารถจัดการการใช้งานธีมมืดได้โดยประกาศว่า Activity แต่ละรายการจัดการการเปลี่ยนแปลงการกำหนดค่า uiMode ได้ ดังนี้
<activity
android:name=".MyActivity"
android:configChanges="uiMode" />
เมื่อ Activity ประกาศว่าจัดการการเปลี่ยนแปลงการกําหนดค่า ระบบจะเรียกใช้เมธอด onConfigurationChanged() เมื่อมีการเปลี่ยนแปลงธีม
หากต้องการตรวจสอบธีมปัจจุบัน แอปสามารถเรียกใช้โค้ดเช่นนี้
Kotlin
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.
}
Java
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;
}