Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด
ทรัพยากรของเลย์เอาต์
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ทรัพยากรเลย์เอาต์จะกำหนดสถาปัตยกรรมสำหรับ 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);
}
- ดูเพิ่มเติม:
-
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2026-11-19 UTC
[null,null,["อัปเดตล่าสุด 2026-11-19 UTC"],[],[]]