ซ่อนแถบสถานะ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
บทเรียนนี้จะอธิบายวิธีซ่อนแถบสถานะในเวอร์ชันต่างๆ
Android การซ่อนแถบสถานะ (และอาจใช้แถบนำทางด้วย) ทำให้
เนื้อหาจะใช้พื้นที่แสดงผลมากกว่า จึงทำให้มอบประสบการณ์การใช้งานที่สมจริงยิ่งขึ้น
รูปที่ 1 แสดงแอปที่มีแถบสถานะที่มองเห็นได้
รูปที่ 1 แถบสถานะที่มองเห็นได้
รูปที่ 2 แสดงแอปที่มีแถบสถานะซ่อนอยู่ โปรดทราบว่าแถบการทำงานซ่อนอยู่ด้วย
คุณไม่ควรแสดงแถบการทำงานโดยไม่มีแถบสถานะ
รูปที่ 2 แถบสถานะที่ซ่อนอยู่
ซ่อนแถบสถานะใน Android 4.0 และเวอร์ชันที่ต่ำกว่า
คุณซ่อนแถบสถานะใน Android 4.0 (API ระดับ 14) และต่ำกว่าได้ด้วยการตั้งค่า
แฟล็ก WindowManager
รายการ ซึ่งคุณสามารถทำได้แบบเป็นโปรแกรมหรือโดย
การตั้งค่าธีมกิจกรรมในไฟล์ Manifest ของแอป การตั้งค่าธีมกิจกรรมในแอป
ขอแนะนำให้ใช้ไฟล์ Manifest หากแถบสถานะควรยังคงอยู่
ที่ซ่อนอยู่ในแอป (แม้จะพูดง่ายๆ ก็คือคุณสามารถลบล้าง
ถ้าต้องการ) เช่น
<application
...
android:theme="@android:style/Theme.Holo.NoActionBar.Fullscreen" >
...
</application>
ข้อดีของการใช้ธีมกิจกรรมมีดังนี้
- การดูแลรักษาทำได้ง่ายกว่าและเกิดข้อผิดพลาดน้อยกว่าการตั้งค่าแฟล็กแบบเป็นโปรแกรม
- ซึ่งทำให้การเปลี่ยน UI ราบรื่นยิ่งขึ้นเพราะระบบมีข้อมูลที่ต้องการ
เพื่อแสดงผล UI ก่อนเริ่มต้นกิจกรรมหลักของแอป
หรือจะตั้งค่าสถานะ WindowManager
แบบเป็นโปรแกรมก็ได้
วิธีนี้ทำให้การซ่อนและแสดงแถบสถานะเป็นเรื่องง่ายขึ้นเมื่อผู้ใช้โต้ตอบด้วย
แอปของคุณ
Kotlin
class MainActivity : Activity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// If the Android version is lower than Jellybean, use this call to hide
// the status bar.
if (Build.VERSION.SDK_INT < 16) {
window.setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
WindowManager.LayoutParams.FLAG_FULLSCREEN)
}
setContentView(R.layout.activity_main)
}
...
}
Java
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// If the Android version is lower than Jellybean, use this call to hide
// the status bar.
if (Build.VERSION.SDK_INT < 16) {
getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
WindowManager.LayoutParams.FLAG_FULLSCREEN);
}
setContentView(R.layout.activity_main);
}
...
}
เมื่อคุณตั้งค่าแฟล็ก WindowManager
(ไม่ว่าจะผ่านธีมกิจกรรมหรือ
แบบเป็นโปรแกรม) การแจ้งว่าไม่เหมาะสมจะยังคงมีผลอยู่จนกว่าแอปของคุณจะล้างการแจ้งเตือนเหล่านั้น
คุณสามารถใช้
FLAG_LAYOUT_IN_SCREEN
เพื่อตั้งค่าเลย์เอาต์กิจกรรมให้ใช้พื้นที่หน้าจอเดียวกับที่แสดงเมื่อคุณเปิดใช้
FLAG_FULLSCREEN
ซึ่งจะป้องกันไม่ให้
เนื้อหาไม่ให้มีการปรับขนาดเมื่อแถบสถานะซ่อนและแสดง
ซ่อนแถบสถานะใน Android 4.1 ขึ้นไป
คุณสามารถซ่อนแถบสถานะใน Android 4.1 (API ระดับ 16) ขึ้นไปได้โดยทำดังนี้
ด้วย setSystemUiVisibility()
setSystemUiVisibility()
ตั้งค่าแฟล็ก UI ที่
ระดับการดูแต่ละรายการ การตั้งค่าเหล่านี้ก็จะรวมกับระดับหน้าต่าง การใช้
setSystemUiVisibility()
เพื่อตั้งค่า Flag UI
ทำให้คุณสามารถควบคุมแถบระบบแบบละเอียดมากกว่า
WindowManager
แฟล็ก ข้อมูลโค้ดนี้จะซ่อนแถบสถานะ
Kotlin
// Hide the status bar.
window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_FULLSCREEN
// Remember that you should never show the action bar if the
// status bar is hidden, so hide that too if necessary.
actionBar?.hide()
Java
View decorView = getWindow().getDecorView();
// Hide the status bar.
int uiOptions = View.SYSTEM_UI_FLAG_FULLSCREEN;
decorView.setSystemUiVisibility(uiOptions);
// Remember that you should never show the action bar if the
// status bar is hidden, so hide that too if necessary.
ActionBar actionBar = getActionBar();
actionBar.hide();
ข้อควรทราบ
- เมื่อล้างแฟล็ก UI แล้ว (เช่น โดยการออกจาก
) แอปของคุณจะต้องรีเซ็ตการตั้งค่าหากคุณต้องการซ่อนแถบนั้นอีกครั้ง
โปรดดูการตอบกลับการเปลี่ยนแปลงระดับการเข้าถึง UI สำหรับ
อภิปรายเกี่ยวกับวิธีการเปลี่ยนแปลงการแสดง UI เพื่อให้แอปของคุณสามารถ
ตอบกลับ
- ตำแหน่งที่คุณตั้งค่าสถานะ UI จะทำให้เกิดความแตกต่าง หากคุณซ่อนแถบระบบในส่วน
เมธอด
onCreate()
และผู้ใช้กด "หน้าแรก" แถบของระบบจะ
ปรากฏขึ้นอีกครั้ง เมื่อผู้ใช้เปิดกิจกรรมอีกครั้ง onCreate()
จะไม่ถูกเรียก ดังนั้นแถบของระบบจะยังคงปรากฏ ถ้าต้องการให้เปลี่ยน UI ของระบบเป็น
ยังคงอยู่เมื่อผู้ใช้เข้าและออกจากกิจกรรมของคุณ ให้ตั้งค่าสถานะ UI ใน
onResume()
หรือ onWindowFocusChanged()
- เมธอด
setSystemUiVisibility()
จะมีผลก็ต่อเมื่อมุมมองที่คุณเรียกใช้มุมมองนั้นปรากฏ
- การออกจากหน้ามุมมองจะทำให้เกิดการแจ้งว่าไม่เหมาะสม
ตั้งค่าด้วย
setSystemUiVisibility()
ที่จะล้าง
ทำให้เนื้อหาปรากฏขึ้นหลังแถบสถานะ
ใน Android 4.1 ขึ้นไป คุณสามารถตั้งค่าเนื้อหาแอปพลิเคชันให้ปรากฏด้านหลัง
แถบสถานะ เพื่อไม่ให้เนื้อหาปรับขนาดเมื่อแถบสถานะซ่อนและแสดง
โดยใช้
SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
นอกจากนี้ คุณยังอาจต้องใช้
SYSTEM_UI_FLAG_LAYOUT_STABLE
เพื่อช่วยให้แอปของคุณรักษา
ที่เสถียรแล้ว
เมื่อคุณใช้วิธีนี้ นั่นเป็นความรับผิดชอบของคุณที่จะต้องตรวจสอบว่าส่วนสำคัญ
ของ UI ของแอป (เช่น ตัวควบคุมในตัวในแอปพลิเคชัน Maps) ไม่แสดงขึ้น
เพราะมีแถบระบบบดบังอยู่ เพราะอาจทำให้แอปใช้งานไม่ได้ ในกรณีส่วนใหญ่ คุณสามารถ
จัดการเรื่องนี้โดยเพิ่มแอตทริบิวต์ android:fitsSystemWindows
ลงในไฟล์เลย์เอาต์ XML โดยตั้งค่าเป็น
true
การดำเนินการนี้จะปรับระยะห่างจากขอบของ ViewGroup
ระดับบนสุด
เพื่อเว้นพื้นที่ว่างไว้
สำหรับหน้าต่างระบบ ซึ่งเพียงพอสำหรับแอปพลิเคชันส่วนใหญ่
แต่ในบางกรณี คุณอาจต้องแก้ไขระยะห่างจากขอบเริ่มต้นเพื่อให้ได้ขนาดที่ต้องการ
สำหรับแอปของคุณ หากต้องการควบคุมวิธี
เนื้อหาจะจัดวางแบบสัมพันธ์กับแถบระบบ (ซึ่งใช้พื้นที่ที่เรียกว่าพื้นที่ของหน้าต่าง
"content insets") ลบล้าง fitSystemWindows(Rect insets)
โดยจะเรียกเมธอด fitSystemWindows()
โดยเมธอด
ดูลำดับชั้นเมื่อเนื้อหาประกอบของหน้าต่างมีการเปลี่ยนแปลง เพื่อให้หน้าต่างสามารถ
ปรับเนื้อหาให้เหมาะสม เมื่อลบล้างเมธอดนี้ คุณจะสามารถจัดการ
(และเลย์เอาต์ของแอป) ตามที่คุณต้องการ
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-27 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-07-27 UTC"],[],[],null,["# Hide the status bar\n\nThis lesson describes how to hide the status bar on different versions of\nAndroid. Hiding the status bar (and optionally, the navigation bar) lets the\ncontent use more of the display space, thereby providing a more immersive user experience.\n\n\nFigure 1 shows an app with a visible status bar:\n\n**Figure 1.** Visible status bar.\n\n\nFigure 2 shows an app with a hidden status bar. Note that the action bar is hidden too.\nYou should never show the action bar without the status bar.\n\n**Figure 2.** Hidden status bar.\n\nHide the Status Bar on Android 4.0 and Lower\n--------------------------------------------\n\nYou can hide the status bar on Android 4.0 (API level 14) and lower by setting\n[WindowManager](/reference/android/view/WindowManager) flags. You can do this programmatically or by\nsetting an activity theme in your app's manifest file. Setting an activity theme in your app's\nmanifest file is the preferred approach if the status bar should always remain\nhidden in your app (though strictly speaking, you could programmatically override the\ntheme if you wanted to). For example: \n\n```xml\n\u003capplication\n ...\n android:theme=\"@android:style/Theme.Holo.NoActionBar.Fullscreen\" \u003e\n ...\n\u003c/application\u003e\n```\n\nThe advantages of using an activity theme are as follows:\n\n- It's easier to maintain and less error-prone than setting a flag programmatically.\n- It results in smoother UI transitions, because the system has the information it needs to render your UI before instantiating your app's main activity.\n\n\nAlternatively, you can programmatically set [WindowManager](/reference/android/view/WindowManager) flags.\nThis approach makes it easier to hide and show the status bar as the user interacts with\nyour app: \n\n### Kotlin\n\n```kotlin\nclass MainActivity : Activity() {\n\n override fun onCreate(savedInstanceState: Bundle?) {\n super.onCreate(savedInstanceState)\n // If the Android version is lower than Jellybean, use this call to hide\n // the status bar.\n if (Build.VERSION.SDK_INT \u003c 16) {\n window.setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,\n WindowManager.LayoutParams.FLAG_FULLSCREEN)\n }\n setContentView(R.layout.activity_main)\n }\n ...\n}\n```\n\n### Java\n\n```java\npublic class MainActivity extends Activity {\n\n @Override\n protected void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n // If the Android version is lower than Jellybean, use this call to hide\n // the status bar.\n if (Build.VERSION.SDK_INT \u003c 16) {\n getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,\n WindowManager.LayoutParams.FLAG_FULLSCREEN);\n }\n setContentView(R.layout.activity_main);\n }\n ...\n}\n```\n\nWhen you set [WindowManager](/reference/android/view/WindowManager) flags (whether through an activity theme or\nprogrammatically), the flags remain in effect unless your app clears them.\n\nYou can use\n[FLAG_LAYOUT_IN_SCREEN](/reference/android/view/WindowManager.LayoutParams#FLAG_LAYOUT_IN_SCREEN)\nto set your activity layout to use the same screen area that's available when you've enabled\n[FLAG_FULLSCREEN](/reference/android/view/WindowManager.LayoutParams#FLAG_FULLSCREEN). This prevents your\ncontent from resizing when the status bar hides and shows.\n\nHide the Status Bar on Android 4.1 and Higher\n---------------------------------------------\n\nYou can hide the status bar on Android 4.1 (API level 16) and higher by\nusing [setSystemUiVisibility()](/reference/android/view/View#setSystemUiVisibility(int)).\n[setSystemUiVisibility()](/reference/android/view/View#setSystemUiVisibility(int)) sets UI flags at\nthe individual view level; these settings are aggregated to the window level. Using\n[setSystemUiVisibility()](/reference/android/view/View#setSystemUiVisibility(int)) to set UI flags\ngives you more granular control over the system bars than using\n[WindowManager](/reference/android/view/WindowManager) flags. This snippet hides the status bar: \n\n### Kotlin\n\n```kotlin\n// Hide the status bar.\nwindow.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_FULLSCREEN\n// Remember that you should never show the action bar if the\n// status bar is hidden, so hide that too if necessary.\nactionBar?.hide()\n```\n\n### Java\n\n```java\nView decorView = getWindow().getDecorView();\n// Hide the status bar.\nint uiOptions = View.SYSTEM_UI_FLAG_FULLSCREEN;\ndecorView.setSystemUiVisibility(uiOptions);\n// Remember that you should never show the action bar if the\n// status bar is hidden, so hide that too if necessary.\nActionBar actionBar = getActionBar();\nactionBar.hide();\n```\n\nNote the following:\n\n- Once UI flags have been cleared (for example, by navigating away from the activity), your app needs to reset them if you want to hide the bars again. See [Responding to UI Visibility Changes](/training/system-ui/visibility) for a discussion of how to listen for UI visibility changes so that your app can respond accordingly.\n- Where you set the UI flags makes a difference. If you hide the system bars in your activity's [onCreate()](/reference/android/app/Activity#onCreate(android.os.Bundle)) method and the user presses Home, the system bars will reappear. When the user reopens the activity, [onCreate()](/reference/android/app/Activity#onCreate(android.os.Bundle)) won't get called, so the system bars will remain visible. If you want system UI changes to persist as the user navigates in and out of your activity, set UI flags in [onResume()](/reference/android/app/Activity#onResume()) or [onWindowFocusChanged()](/reference/android/view/Window.Callback#onWindowFocusChanged(boolean)).\n- The method [setSystemUiVisibility()](/reference/android/view/View#setSystemUiVisibility(int)) only has an effect if the view you call it from is visible.\n- Navigating away from the view causes flags set with [setSystemUiVisibility()](/reference/android/view/View#setSystemUiVisibility(int)) to be cleared.\n\n\u003cbr /\u003e\n\nMake Content Appear Behind the Status Bar\n-----------------------------------------\n\nOn Android 4.1 and higher, you can set your application's content to appear behind\nthe status bar, so that the content doesn't resize as the status bar hides and shows.\nTo do this, use\n[SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN](/reference/android/view/View#SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN).\nYou may also need to use\n[SYSTEM_UI_FLAG_LAYOUT_STABLE](/reference/android/view/View#SYSTEM_UI_FLAG_LAYOUT_STABLE) to help your app maintain a\nstable layout.\n\nWhen you use this approach, it becomes your responsibility to ensure that critical parts\nof your app's UI (for example, the built-in controls in a Maps application) don't end up\ngetting covered by system bars. This could make your app unusable. In most cases you can\nhandle this by adding the `android:fitsSystemWindows` attribute to your XML layout file, set to\n`true`. This adjusts the padding of the parent [ViewGroup](/reference/android/view/ViewGroup)\nto leave space for the system windows. This is sufficient for most applications.\n\nIn some cases, however, you may need to modify the default padding to get the desired\nlayout for your app. To directly manipulate how your\ncontent lays out relative to the system bars (which occupy a space known as the window's\n\"content insets\"), override [fitSystemWindows(Rect insets)](/reference/android/view/View#fitSystemWindows(android.graphics.Rect)).\nThe [fitSystemWindows()](/reference/android/view/View#fitSystemWindows(android.graphics.Rect)) method is called by the\nview hierarchy when the content insets for a window have changed, to allow the window to\nadjust its content accordingly. By overriding this method you can handle the\ninsets (and hence your app's layout) however you want."]]