จัดการระดับการเข้าถึงวิธีการป้อนข้อมูล

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

ซึ่งแอปส่วนใหญ่จำเป็นต้องใช้ลักษณะการทำงานเริ่มต้นเหล่านี้ ในบางกรณี แต่คุณอาจต้องการควบคุมการมองเห็นวิธีการป้อนข้อมูลมากขึ้นและ ผลกระทบต่อเลย์เอาต์ บทเรียนนี้อธิบายวิธีควบคุมและตอบสนองต่อ ระดับการเข้าถึงวิธีการป้อนข้อมูล

หมายเหตุ: หน้านี้จะหมายถึงวลีแป้นพิมพ์ตลอดทั้งข้อความ แสดงแป้นพิมพ์บนหน้าจอและเป็นการป้อนข้อมูลแบบนุ่มนวลที่พบบ่อยที่สุด Android รองรับวิธีการป้อนข้อมูลแบบชั่วคราวประเภทอื่นๆ ซึ่งรวมถึงวิธีการป้อนข้อมูลด้วยรูปภาพ ทั้งการป้อนข้อมูลด้วยหมึก

แสดงแป้นพิมพ์เมื่อกิจกรรมเริ่มขึ้น

แม้ว่า Android จะให้ความสำคัญกับช่องข้อความฟิลด์แรกในการจัดวางของคุณเมื่อ กิจกรรมเริ่มขึ้น ระบบจะไม่แสดงแป้นพิมพ์เสมือน พฤติกรรมนี้เหมาะสม เพราะการป้อนข้อความอาจไม่ใช่งานหลักในกิจกรรม อย่างไรก็ตาม หาก จริงๆ แล้วการป้อนข้อความเป็นงานหลัก เช่น ในหน้าจอการเข้าสู่ระบบ อาจต้องการให้แป้นพิมพ์ปรากฏขึ้นเป็นค่าเริ่มต้น

หากต้องการแสดงวิธีป้อนข้อมูลเมื่อกิจกรรมเริ่มต้น ให้เพิ่มพารามิเตอร์ android:windowSoftInputMode ลงในแอตทริบิวต์ องค์ประกอบ <activity> ที่มีค่า "stateVisible" เช่น

<application ... >
    <activity
        android:windowSoftInputMode="stateVisible" ... >
        ...
    </activity>
   ...
</application>

หมายเหตุ: หากอุปกรณ์ของผู้ใช้ต่อแป้นพิมพ์ฮาร์ดแวร์ไว้ ให้ใช้แป้นพิมพ์เสมือน ไม่ปรากฏ

ระบุว่าจะให้ UI ตอบสนองอย่างไร

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

หากต้องการประกาศการรักษาที่ต้องการในกิจกรรม ให้ใช้ แอตทริบิวต์ android:windowSoftInputMode ในองค์ประกอบ <activity> ของไฟล์ Manifest โดยใช้ปุ่ม "ปรับราคาเสนอ" อันใดอันหนึ่ง

ตัวอย่างเช่น เพื่อให้มั่นใจว่าระบบจะปรับขนาดการออกแบบของคุณให้เป็นขนาดที่พร้อมใช้งาน โดยอัตโนมัติ ซึ่งทำให้เข้าถึงเนื้อหาเลย์เอาต์ทั้งหมดของคุณได้ แม้ว่า ต้องเลื่อน ให้ใช้ "adjustResize":

<application ... >
   <activity
       android:windowSoftInputMode="adjustResize" ... >
       ...
   </activity>
   ...
</application>

คุณสามารถรวมข้อกำหนดการปรับโดยใช้แป้นพิมพ์เสมือนเริ่มต้นได้ การแสดงผลจากส่วนก่อนหน้า:

<activity
    android:windowSoftInputMode="stateVisible|adjustResize" ... >
    ...
</activity>

การระบุ "adjustResize" เป็นสิ่งสำคัญหาก UI ของคุณมีการควบคุมที่ ผู้ใช้อาจต้องเข้าถึงเว็บไซต์ทันทีหลังจากหรือขณะป้อนข้อความ สำหรับ ตัวอย่างเช่น หากคุณใช้เค้าโครงที่สัมพันธ์กันเพื่อวางแถบปุ่มที่ด้านล่างของ หน้าจอโดยใช้ "adjustResize" ปรับขนาดเลย์เอาต์เพื่อให้แถบปุ่มปรากฏขึ้น เหนือแป้นพิมพ์เสมือน

แสดงแป้นพิมพ์เสมือนตามคำขอ

หากมีเมธอดในวงจรของกิจกรรมซึ่งคุณต้องการตรวจสอบว่า แสดงวิธีการป้อนข้อมูล InputMethodManager เพื่อแสดง

ตัวอย่างเช่น วิธีการต่อไปนี้ใช้ View ที่คาดว่าผู้ใช้จะ พิมพ์บางอย่าง, โทร requestFocus() ที่จะให้ จากนั้นโฟกัสจะเรียก showSoftInput() เพื่อเปิดวิธีการป้อนข้อมูล

Kotlin

fun showSoftKeyboard(view: View) {
   if (view.requestFocus()) {
       val imm = getSystemService(InputMethodManager::class.java)
       imm.showSoftInput(view, InputMethodManager.SHOW_IMPLICIT)
   }
}

Java

public void showSoftKeyboard(View view) {
   if (view.requestFocus()) {
       InputMethodManager imm = getSystemService(InputMethodManager.class);
       imm.showSoftInput(view, InputMethodManager.SHOW_IMPLICIT);
   }
}

หมายเหตุ: เมื่อมองเห็นแป้นพิมพ์เสมือนแล้ว โปรดอย่าซ่อนแป้นพิมพ์ด้วยการเขียนโปรแกรม ระบบจะซ่อนวิธีการป้อนข้อมูลเมื่อผู้ใช้ทำงานเสร็จสิ้นในช่องข้อความ หรือผู้ใช้จะซ่อนโดยใช้การควบคุมของระบบก็ได้ เช่น ปุ่ม "กลับ"

ข้อควรระวัง: อย่าใช้แฟล็ก SHOW_FORCED ใน showSoftInput() เพื่อขอแป้นพิมพ์เสมือน มิฉะนั้นซอฟต์แวร์ แป้นพิมพ์จะยังคงเปิดได้แม้จะปิดแอปไปแล้ว

แสดงแป้นพิมพ์อย่างมีประสิทธิภาพ

ในบางสถานการณ์ เช่น เมื่อกิจกรรมเริ่มขึ้น ใช้ InputMethodManager.showSoftInput() เพื่อแสดงแป้นพิมพ์เสมือน อาจทำให้ผู้ใช้มองไม่เห็นแป้นพิมพ์ซอฟต์แวร์

การมองเห็นแป้นพิมพ์เสมือนเมื่อใช้ showSoftInput() จะเชื่อถือได้ ในเงื่อนไขต่อไปนี้

• โดยมุมมองต้องเชื่อมต่อกับซอฟต์แวร์แป้นพิมพ์อยู่แล้ว (ซึ่งก็จะทำให้ ต้องโฟกัสหน้าต่างและเครื่องมือแก้ไข ดูเพื่อขอโฟกัสมุมมองกับ View.requestFocus())

• ระดับการเข้าถึงอาจได้รับผลกระทบจาก android:windowSoftInputMode ด้วย และแฟล็กที่ showSoftInput() ใช้

ในบางกรณีการใช้งาน เช่น เมื่อกิจกรรมเริ่มขึ้น บางกรณี ไม่ตรงตามเงื่อนไขที่กำหนด ระบบไม่พิจารณาการดูเป็น เชื่อมต่อกับแป้นพิมพ์ซอฟต์แวร์อยู่ ไม่ต้องสนใจการเรียก showSoftInput() และผู้ใช้จะมองไม่เห็นแป้นพิมพ์เสมือน

หากต้องการตรวจสอบว่าซอฟต์แวร์แป้นพิมพ์แสดงขึ้นมาอย่างถูกต้อง คุณสามารถใช้สิ่งต่อไปนี้ ทางเลือก:

• (แนะนำ) ใช้ WindowInsetsControllerCompat วัตถุนี้ แสดงแป้นพิมพ์เสมือนในระหว่าง Activity.onCreate() ตามที่แสดงใน โค้ดต่อไปนี้ เรารับประกันว่าการโทรจะถึงกำหนดเวลาหลังจากกรอบเวลาดังกล่าว ให้ความสนใจ

Kotlin

editText.requestFocus()
WindowCompat.getInsetsController(window, editText)!!.show(WindowInsetsCompat.Type.ime())

Java

editText.requestFocus();
WindowCompat.getInsetsController(getWindow(), editText).show(WindowInsetsCompat.Type.ime());

• โพสต์การเรียกใช้ได้ ซึ่งจะช่วยให้มั่นใจว่าแอปจะรอจนกว่าจะได้รับ เหตุการณ์โฟกัสในหน้าต่างจาก View.onWindowFocusChanged() ก่อนโทร showSoftInput()

Kotlin

class MyEditText : EditText() {
  ...
  override fun onWindowFocusChanged(hasWindowFocus: Boolean) {
    if (hasWindowFocus) {
      requestFocus()
      post {
        val imm: InputMethodManager = getSystemService(InputMethodManager::class.java)
        imm.showSoftInput(this, 0)
      }
    }
  }
}

Java

public class MyEditText extends EditText {
  ...
  @Override
  public void onWindowFocusChanged(boolean hasWindowFocus) {
    if (hasWindowFocus) {
      requestFocus();
      post(() -> {
        InputMethodManager imm = getSystemService(InputMethodManager.class);
        imm.showSoftInput(this, 0);
      });
    }
  }
}

จัดการแฟล็กระดับการเข้าถึงรันไทม์อย่างระมัดระวัง

เมื่อสลับการแสดงแป้นพิมพ์แบบนุ่มนวลขณะรันไทม์ โปรดระมัดระวังอย่าข้าม แจ้งค่าลงในวิธีการเหล่านี้ ตัวอย่างเช่น หากแอปพลิเคชันคาดว่า แป้นพิมพ์เสมือนแสดงขึ้นเมื่อโทร View.getWindowInsetsController().show(ime()) ใน Activity.onCreate() ระหว่าง กิจกรรมเริ่มขึ้น นักพัฒนาแอปพลิเคชันควรระวังอย่าตั้งค่า การแจ้ง SOFT_INPUT_STATE_HIDDEN หรือ SOFT_INPUT_STATE_ALWAYS_HIDDEN ในช่วงการเปิดครั้งแรก ในกรณีที่ซอฟต์แป้นพิมพ์ซ่อนอยู่โดยไม่คาดคิด

โดยปกติแล้วระบบจะซ่อนแป้นพิมพ์เสมือนโดยอัตโนมัติ

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

• ผู้ใช้ดำเนินการดังกล่าวเสร็จแล้วในช่องข้อความ
• ผู้ใช้กดปุ่มย้อนกลับหรือท่าทางสัมผัสการปัดเมื่อใช้การนำทางกลับ
• ผู้ใช้ไปยังแอปอื่นและที่แอปอื่นตั้งค่าไว้ แฟล็ก SOFT_INPUT_STATE_HIDDEN หรือ SOFT_INPUT_STATE_ALWAYS_HIDDEN เมื่อมุมมองได้โฟกัส

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

ซ่อนแป้นพิมพ์เสมือนด้วยตนเองตามลักษณะการทำงานก่อนหน้านี้ของระบบ

แอปของคุณต้องซ่อนแป้นพิมพ์เสมือนด้วยตนเองในบางสถานการณ์ ตัวอย่างเช่น เมื่อฟิลด์ข้อความหายไป View.OnFocusChangeListener.onFocusChange ใช้เทคนิคนี้อย่างรอบคอบ การปิดซอฟต์แป้นพิมพ์จะทำให้ประสบการณ์ของผู้ใช้แย่ลงโดยไม่คาดคิด

หากแอปซ่อนแป้นพิมพ์เสมือนด้วยตนเอง คุณจำเป็นต้องทราบว่า แป้นพิมพ์เสมือนแสดงอย่างชัดแจ้งหรือโดยนัย

• แป้นพิมพ์เสมือนถือว่าแสดงอย่างชัดแจ้งหลังจาก โทรหา showSoftInput()

• ในทางกลับกัน แป้นพิมพ์เสมือนถือว่าแสดงโดยปริยายใน เงื่อนไขใดเงื่อนไขหนึ่งต่อไปนี้

  • ระบบแสดงแป้นพิมพ์เสมือนขณะที่กด android:windowSoftInputMode
  • แอปของคุณสอบผ่านSHOW_IMPLICIT showSoftInput()

โดยปกติแล้ว hideSoftInputFromWindow() จะซ่อนแป้นพิมพ์เสมือนโดยไม่คำนึงถึง ตามที่ขอ แต่ใช้ HIDE_IMPLICIT_ONLY จะจำกัดเพียงการปิดแป้นพิมพ์เสมือนที่ขอโดยนัยได้

แสดงกล่องโต้ตอบหรือมุมมองซ้อนทับที่ด้านบนของแป้นพิมพ์เสมือน

ในบางสถานการณ์ กิจกรรมตัวแก้ไขอาจต้องสร้าง URL ที่แก้ไขไม่ได้ กล่องโต้ตอบหรือหน้าต่างวางซ้อนที่ด้านบนของแป้นพิมพ์เสมือน

แอปของคุณมีตัวเลือก 2-3 อย่าง ซึ่งอธิบายไว้ในส่วนต่อไปนี้

โดยสรุปแล้ว โปรดตรวจสอบว่าได้จัดการธงหน้าต่างของแป้นพิมพ์เสมือนอย่างถูกต้อง การกำหนดเป้าหมายกรอบเวลาดังกล่าว ให้เป็นไปตามความคาดหวังต่อไปนี้ เกี่ยวกับการจัดลำดับในแนวตั้ง (ชั้น Z) ดังต่อไปนี้

• ไม่มีธง (ตัวพิมพ์ปกติ): อยู่ด้านหลังชั้นแป้นพิมพ์เสมือนและรับข้อความได้
• FLAG_NOT_FOCUSABLE : อยู่ด้านบนของเลเยอร์แป้นพิมพ์เสมือน แต่ไม่สามารถรับข้อความได้
• FLAG_ALT_FOCUSABLE_IM : ที่ด้านบนของเลเยอร์แป้นพิมพ์เสมือนสามารถโฟกัสได้ แต่ไม่ได้เชื่อมต่อกับ แป้นพิมพ์เสมือน และบล็อกมุมมองทั้งหมดภายใต้ช่องดังกล่าวไม่ให้เชื่อมต่อกับ แป้นพิมพ์เสมือน วิธีนี้มีประโยชน์ในการแสดงกล่องโต้ตอบแอปที่ไม่ได้ใช้ข้อความ เหนือเลเยอร์แป้นพิมพ์
• FLAG_NOT_FOCUSABLE และ FLAG_ALT_FOCUSABLE_IM : อยู่ด้านหลังเลเยอร์แป้นพิมพ์แบบย่อ แต่ไม่สามารถรับข้อความได้
• FLAG_NOT_FOCUSABLE และ FLAG_NOT_TOUCH_MODAL : ที่ด้านบนของแป้นพิมพ์เสมือนและอนุญาตให้กิจกรรมการสัมผัสสามารถ "ผ่าน" หน้าต่างลงบนแป้นพิมพ์เสมือน

สร้างกล่องโต้ตอบ

ใช้FLAG_ALT_FOCUSABLE_IM ธงหน้าต่างกล่องโต้ตอบเพื่อให้กล่องโต้ตอบอยู่ที่ด้านบนของแป้นพิมพ์เสมือน และ ป้องกันไม่ให้แป้นพิมพ์เข้าถึงโฟกัส:

Kotlin

val content = TextView(this)
content.text = "Non-editable dialog on top of soft keyboard"
content.gravity = Gravity.CENTER
val builder = AlertDialog.Builder(this)
  .setTitle("Soft keyboard layering demo")
  .setView(content)
mDialog = builder.create()
mDialog!!.window!!
  .addFlags(WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM)
mDialog!!.show()

Java

TextView content = new TextView(this);
content.setText("Non-editable dialog on top of soft keyboard");
content.setGravity(Gravity.CENTER);
final AlertDialog.Builder builder = new AlertDialog.Builder(this)
    .setTitle("Soft keyboard layering demo")
    .setView(content);
mDialog = builder.create();
mDialog.getWindow().addFlags(FLAG_ALT_FOCUSABLE_IM);
mDialog.show();

สร้างมุมมองโฆษณาซ้อนทับ

สร้างมุมมองโฆษณาซ้อนทับที่ระบุ TYPE_APPLICATION_OVERLAY ประเภทหน้าต่างและ FLAG_ALT_FOCUSABLE_IM ธงหน้าต่างตามกิจกรรมเป้าหมายของแป้นพิมพ์เสมือน

หมายเหตุ: ซึ่งผู้ใช้จะต้องมอบสิทธิ์พิเศษ SYSTEM_ALERT_WINDOW สิทธิ์ในแอป

Kotlin

val params = WindowManager.LayoutParams(
  width,  /* Overlay window width */
  height,  /* Overlay window height */
  WindowManager.LayoutParams.TYPE_APPLICATION, /* Overlay window type */
  WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM /* No need to allow for text input on top of the soft keyboard */
    or WindowManager.LayoutParams.FLAG_NOT_TOUCH_MODAL,  /* Allow touch event send to soft keyboard behind the overlay */
  PixelFormat.TRANSLUCENT
)
params.title = "Overlay window"
mOverlayView!!.layoutParams = params
windowManager.addView(mOverlayView, params)

Java

WindowManager.LayoutParams params = new WindowManager.LayoutParams(
    width, /* Overlay window width */
    height, /* Overlay window height */
    TYPE_APPLICATION, /* Overlay window type */
    FLAG_ALT_FOCUSABLE_IM /* No need to allow for text input on top of the soft keyboard */
        | FLAG_NOT_TOUCH_MODAL, /* Allow touch event send to soft keyboard behind the overlay */
    PixelFormat.TRANSLUCENT);
params.setTitle("Overlay window");
mOverlayView.setLayoutParams(params);
getWindowManager().addView(mOverlayView, params);

แสดงกล่องโต้ตอบหรือมุมมองใต้แป้นพิมพ์เสมือน

แอปของคุณอาจต้องสร้างกล่องโต้ตอบหรือหน้าต่างที่มี พร็อพเพอร์ตี้ต่อไปนี้

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

ในกรณีนี้ แอปของคุณมีหลายตัวเลือก ส่วนต่อไปนี้ อธิบายตัวเลือกเหล่านี้

สร้างกล่องโต้ตอบ

สร้างกล่องโต้ตอบโดยการตั้งค่าทั้งFLAG_NOT_FOCUSABLE ธงหน้าต่างและFLAG_ALT_FOCUSABLE_IM ธงหน้าต่าง:

Kotlin

val content = TextView(this)
content.text = "Non-editable dialog behind soft keyboard"
content.gravity = Gravity.CENTER
val builder = AlertDialog.Builder(this)
  .setTitle("Soft keyboard layering demo")
  .setView(content)
mDialog = builder.create()
mDialog!!.window!!
  .addFlags(FLAG_NOT_FOCUSABLE or FLAG_ALT_FOCUSABLE_IM)
mDialog!!.show()

Java

TextView content = new TextView(this);
content.setText("Non-editable dialog behind soft keyboard");
content.setGravity(Gravity.CENTER);
final AlertDialog.Builder builder = new AlertDialog.Builder(this)
    .setTitle("Soft keyboard layering demo")
    .setView(content);

mDialog = builder.create();
mDialog.getWindow()
    .addFlags(FLAG_NOT_FOCUSABLE | FLAG_ALT_FOCUSABLE_IM);
mDialog.show();

สร้างมุมมองโฆษณาซ้อนทับ

สร้างมุมมองซ้อนทับโดยตั้งค่าทั้งFLAG_NOT_FOCUSABLE ธงหน้าต่างและFLAG_ALT_FOCUSABLE_IM ธงหน้าต่าง:

Kotlin

val params = WindowManager.LayoutParams(
  width,  /* Overlay window width */
  height,  /* Overlay window height */
  WindowManager.LayoutParams.TYPE_APPLICATION,  /* Overlay window type */
  WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE
      or WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM,
  PixelFormat.TRANSLUCENT
)
params.title = "Overlay window"
mOverlayView!!.layoutParams = params
windowManager.addView(mOverlayView, params)

Java

WindowManager.LayoutParams params = new WindowManager.LayoutParams(
    width, /* Overlay window width */
    height, /* Overlay window height */
    TYPE_APPLICATION, /* Overlay window type */
    FLAG_NOT_FOCUSABLE | FLAG_ALT_FOCUSABLE_IM,
    PixelFormat.TRANSLUCENT);
params.setTitle("Overlay window");
mOverlayView.setLayoutParams(params);
getWindowManager().addView(mOverlayView, params);