ทรัพยากรของเลย์เอาต์

ทรัพยากรเลย์เอาต์จะกำหนดสถาปัตยกรรมสำหรับ UI ใน Activity หรือคอมโพเนนต์ของ UI

ตำแหน่งไฟล์:
res/layout/filename.xml
ระบบจะใช้ชื่อไฟล์เป็นรหัสทรัพยากร
ประเภทข้อมูลทรัพยากรที่คอมไพล์:
ตัวชี้ทรัพยากรไปยังทรัพยากร View (หรือคลาสย่อย)
ข้อมูลอ้างอิงทรัพยากร:
ใน Java: R.layout.filename
ใน XML: @[package:]layout/filename
ไวยากรณ์:
<?xml version="1.0" encoding="utf-8"?>
<ViewGroup
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@[+][package:]id/resource_name"
    android:layout_height=["dimension" | "match_parent" | "wrap_content"]
    android:layout_width=["dimension" | "match_parent" | "wrap_content"]
    [ViewGroup-specific attributes] >
    <View
        android:id="@[+][package:]id/resource_name"
        android:layout_height=["dimension" | "match_parent" | "wrap_content"]
        android:layout_width=["dimension" | "match_parent" | "wrap_content"]
        [View-specific attributes] >
        <requestFocus/>
    </View>
    <ViewGroup >
        <View />
    </ViewGroup>
    <include layout="@layout/layout_resource"/>
</ViewGroup>

หมายเหตุ: องค์ประกอบรูทอาจเป็นองค์ประกอบ ViewGroup, View หรือ <merge> ก็ได้ แต่ต้องมีองค์ประกอบรูทเพียงองค์ประกอบเดียวและต้องมีแอตทริบิวต์ xmlns:android ที่มีเนมสเปซ android ดังที่แสดงในตัวอย่างไวยากรณ์ก่อนหน้านี้

องค์ประกอบ
<ViewGroup>
คอนเทนเนอร์สำหรับองค์ประกอบ View อื่นๆ ออบเจ็กต์ ViewGroup มีหลายประเภท และแต่ละประเภทช่วยให้คุณระบุเลย์เอาต์ขององค์ประกอบย่อยได้หลายวิธี ออบเจ็กต์ ViewGroup ประเภทต่างๆ ได้แก่ LinearLayout, RelativeLayout และ FrameLayout

อย่าคิดเอาเองว่าอนุพันธ์ของ ViewGroup จะยอมรับมุมมองที่ซ้อนกัน กลุ่มมุมมองบางกลุ่มเป็นการใช้งานคลาส AdapterView ซึ่งกำหนดมุมมองย่อยจาก Adapter เท่านั้น

แอตทริบิวต์:

android:id
รหัสทรัพยากร ชื่อทรัพยากรที่ไม่ซ้ำกันสำหรับองค์ประกอบ ซึ่งคุณสามารถใช้เพื่อรับข้อมูลอ้างอิงไปยัง ViewGroup จากแอปพลิเคชันของคุณ ดูข้อมูลเพิ่มเติมได้ที่ส่วนค่าสำหรับ android:id
android:layout_height
มิติข้อมูลหรือคีย์เวิร์ด ต้องระบุ ความสูงของกลุ่มเป็นค่ามิติข้อมูล (หรือทรัพยากรมิติข้อมูล) หรือคีย์เวิร์ด ("match_parent" หรือ "wrap_content") ดูข้อมูลเพิ่มเติมได้ที่ส่วนค่าสำหรับ android:layout_height และ android:layout_width
android:layout_width
มิติข้อมูลหรือคีย์เวิร์ด ต้องระบุ ความกว้างของกลุ่มเป็นค่ามิติข้อมูล (หรือทรัพยากรมิติข้อมูล) หรือคีย์เวิร์ด ("match_parent" หรือ "wrap_content") ดูข้อมูลเพิ่มเติมได้ที่ส่วนค่าสำหรับ android:layout_height และ android:layout_width

คลาสพื้นฐาน ViewGroup รองรับแอตทริบิวต์เพิ่มเติม และการใช้งาน ViewGroup แต่ละรายการยังรองรับแอตทริบิวต์อื่นๆ อีกมากมาย ดูข้อมูลอ้างอิงของแอตทริบิวต์ทั้งหมดที่ใช้ได้ในเอกสารอ้างอิงที่เกี่ยวข้องสำหรับคลาส ViewGroup เช่น แอตทริบิวต์ XML ของ LinearLayout

<View>
องค์ประกอบ UI แต่ละรายการ ซึ่งโดยทั่วไปเรียกว่าวิดเจ็ต ออบเจ็กต์ View ประเภทต่างๆ ได้แก่ TextView, Button และ CheckBox

แอตทริบิวต์:

android:id
รหัสทรัพยากร ชื่อทรัพยากรที่ไม่ซ้ำกันสำหรับองค์ประกอบ ซึ่งคุณสามารถใช้เพื่อรับข้อมูลอ้างอิงไปยัง View จากแอปพลิเคชันของคุณ ดูข้อมูลเพิ่มเติมได้ที่ส่วนค่าสำหรับ android:id
android:layout_height
มิติข้อมูลหรือคีย์เวิร์ด ต้องระบุ ความสูงขององค์ประกอบเป็นค่ามิติข้อมูล (หรือทรัพยากรมิติข้อมูล) หรือคีย์เวิร์ด ("match_parent" หรือ "wrap_content") ดูข้อมูลเพิ่มเติมได้ที่ส่วนค่าสำหรับ android:layout_height และ android:layout_width
android:layout_width
มิติข้อมูลหรือคีย์เวิร์ด ต้องระบุ ความกว้างขององค์ประกอบเป็นค่ามิติข้อมูล (หรือทรัพยากรมิติข้อมูล) หรือคีย์เวิร์ด ("match_parent" หรือ "wrap_content") ดูข้อมูลเพิ่มเติมได้ที่ส่วนค่าสำหรับ android:layout_height และ android:layout_width

คลาสพื้นฐาน View รองรับแอตทริบิวต์เพิ่มเติม และการใช้งาน View แต่ละรายการยังรองรับแอตทริบิวต์อื่นๆ อีกมากมาย ดูข้อมูลเพิ่มเติมได้ที่เลย์เอาต์ ดูข้อมูลอ้างอิงของแอตทริบิวต์ทั้งหมดที่ใช้ได้ในเอกสารอ้างอิงที่เกี่ยวข้อง เช่น แอตทริบิวต์ XML ของ TextView

<requestFocus>
องค์ประกอบใดๆ ที่แสดงถึงออบเจ็กต์ View สามารถรวมองค์ประกอบที่ว่างเปล่านี้ได้ ซึ่งจะทำให้องค์ประกอบหลักได้รับโฟกัสเริ่มต้นบนหน้าจอ คุณมีองค์ประกอบเหล่านี้ได้เพียง 1 รายการต่อไฟล์
<include>
รวมไฟล์เลย์เอาต์ไว้ในเลย์เอาต์นี้

แอตทริบิวต์:

layout
ทรัพยากรเลย์เอาต์ ต้องระบุ การอ้างอิงถึงทรัพยากรเลย์เอาต์
android:id
รหัสทรัพยากร ลบล้างรหัสที่กำหนดให้กับมุมมองรูทในเลย์เอาต์ที่รวมไว้
android:layout_height
มิติข้อมูลหรือคีย์เวิร์ด ลบล้างความสูงที่กำหนดให้กับมุมมองรูทในเลย์เอาต์ที่รวมไว้ จะมีผลก็ต่อเมื่อมีการประกาศ android:layout_width ด้วย
android:layout_width
มิติข้อมูลหรือคีย์เวิร์ด ลบล้างความกว้างที่กำหนดให้กับมุมมองรูทในเลย์เอาต์ที่รวมไว้ จะมีผลก็ต่อเมื่อมีการประกาศ android:layout_height ด้วย

คุณสามารถรวมแอตทริบิวต์เลย์เอาต์อื่นๆ ใน <include> ที่องค์ประกอบรูทในเลย์เอาต์ที่รวมรองรับ และแอตทริบิวต์เหล่านั้นจะลบล้างแอตทริบิวต์ที่กำหนดไว้ในองค์ประกอบรูท

ข้อควรระวัง: หากต้องการลบล้างแอตทริบิวต์เลย์เอาต์โดยใช้แท็ก <include> คุณต้องลบล้างทั้ง android:layout_height และ android:layout_width เพื่อให้แอตทริบิวต์เลย์เอาต์อื่นๆ มีผล

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

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

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

ค่าสำหรับ android:id

สำหรับค่ารหัส โดยทั่วไปคุณจะใช้รูปแบบไวยากรณ์นี้: "@+id/name" ดังที่แสดงในตัวอย่างต่อไปนี้ เครื่องหมายบวก + บ่งบอกว่านี่คือรหัสทรัพยากรใหม่ และเครื่องมือ aapt จะสร้างจำนวนเต็มของทรัพยากรใหม่ในคลาส R.java หากยังไม่มีอยู่

<TextView android:id="@+id/nameTextbox"/>

ตอนนี้ชื่อ nameTextbox เป็นรหัสทรัพยากรที่แนบมากับองค์ประกอบนี้ จากนั้นคุณจะอ้างอิง TextView ที่เชื่อมโยงกับรหัสดังกล่าวใน Java ได้โดยใช้โค้ดต่อไปนี้

Kotlin

val textView: TextView? = findViewById(R.id.nameTextbox)

Java

TextView textView = findViewById(R.id.nameTextbox);

โค้ดนี้จะแสดงผลออบเจ็กต์ TextView

อย่างไรก็ตาม หากคุณได้กำหนดทรัพยากรรหัสไว้แล้วและยังไม่ได้ใช้ คุณสามารถใช้รหัสนั้นกับองค์ประกอบ View ได้โดยยกเว้นสัญลักษณ์บวกในค่า android:id

ค่าสำหรับ android:layout_height และ android:layout_width

ค่าความสูงและความกว้างจะแสดงโดยใช้หน่วยมิติข้อมูลที่ Android รองรับ (px, dp, sp, pt, in, mm) หรือใช้คีย์เวิร์ดต่อไปนี้

ค่าคำอธิบาย
match_parent ตั้งค่าขนาดให้ตรงกับองค์ประกอบระดับบน เพิ่มใน API ระดับ 8 เพื่อเลิกใช้งาน fill_parent
wrap_content ตั้งค่ามิติข้อมูลให้มีขนาดเท่าที่จำเป็นเพื่อให้พอดีกับเนื้อหาขององค์ประกอบนี้เท่านั้น

องค์ประกอบมุมมองที่กำหนดเอง

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

ตัวอย่าง:
ไฟล์ XML ที่บันทึกไว้ที่ res/layout/main_activity.xml:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:orientation="vertical" >
    <TextView android:id="@+id/text"
              android:layout_width="wrap_content"
              android:layout_height="wrap_content"
              android:text="Hello, I am a TextView" />
    <Button android:id="@+id/button"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Hello, I am a Button" />
</LinearLayout>

โค้ดของแอปพลิเคชันนี้จะโหลดเลย์เอาต์สำหรับ Activity ในเมธอด onCreate() ดังนี้

Kotlin

public override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main_activity)
}

Java

public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main_activity);
}
ดูเพิ่มเติม: