ข้อจำกัดและลำดับตัวแก้ไข

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

หน้านี้อธิบายว่าตัวปรับแต่งที่เชื่อมโยงส่งผลต่อข้อจำกัดอย่างไร และส่งผลต่อการวัดและการจัดวาง Composable อย่างไร

ตัวแก้ไขในโครงสร้าง UI

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

ในแผนผัง UI คุณสามารถแสดงภาพตัวแก้ไขเป็นโหนด Wrapper สำหรับโหนดเลย์เอาต์ได้ ดังนี้

โค้ดสำหรับ Composable และตัวแก้ไข รวมถึงการแสดงภาพเป็นแผนผัง UI
รูปที่ 1 ตัวปรับแต่งที่รวมโหนดเลย์เอาต์ในโครงสร้าง UI

การเพิ่มตัวแก้ไขมากกว่า 1 รายการลงใน Composable จะสร้างเชนของตัวแก้ไข เมื่อคุณเชื่อมต่อตัวแก้ไขหลายรายการเข้าด้วยกัน โหนดตัวแก้ไขแต่ละโหนดจะรวมส่วนที่เหลือของเชนและโหนดเลย์เอาต์ไว้ภายใน ตัวอย่างเช่น เมื่อคุณเชื่อมโยงตัวแก้ไข clip และ size เข้าด้วยกัน โหนดตัวแก้ไข clip จะรวมโหนดตัวแก้ไข size ไว้ ซึ่งจะรวมโหนดเลย์เอาต์ Image ไว้ด้วย

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

ดังที่แสดงในรูปที่ 2 การติดตั้งใช้งานคอมโพสิเบิล Image และ Text ประกอบด้วยเชนของตัวแก้ไขที่รวมโหนดเลย์เอาต์เดียว

การติดตั้งใช้งาน Row และ Column เป็นโหนดเลย์เอาต์ที่อธิบายวิธีจัดวางองค์ประกอบย่อย

โครงสร้างต้นไม้จากก่อนหน้านี้ แต่ตอนนี้แต่ละโหนดเป็นเพียงเลย์เอาต์ง่ายๆ โดยมีโหนด Modifier จำนวนมากที่รวมโหนดไว้รอบๆ
รูปที่ 2 โครงสร้างแบบต้นไม้เดียวกันกับในรูปที่ 1 แต่มี Composable ในต้นไม้ UI ที่แสดงเป็นเชนของตัวแก้ไข

สรุปได้ว่า

  • ตัวแก้ไขจะรวมตัวแก้ไขหรือโหนดเลย์เอาต์รายการเดียว
  • โหนดเลย์เอาต์สามารถจัดวางโหนดบุตรหลานได้หลายโหนด

ส่วนต่อไปนี้จะอธิบายวิธีใช้โมเดลทางความคิดนี้เพื่อพิจารณาเกี่ยวกับการเชื่อมโยงตัวปรับแต่งและอิทธิพลที่มีต่อขนาดของ Composable

ข้อจำกัดในระยะเลย์เอาต์

ระยะเลย์เอาต์เป็นไปตามอัลกอริทึม 3 ขั้นตอนเพื่อค้นหาความกว้าง ความสูง และพิกัด x, y ของโหนดเลย์เอาต์แต่ละโหนด ดังนี้

  1. วัดโหนดย่อย: โหนดจะวัดโหนดย่อย (หากมี)
  2. กำหนดขนาดของตัวเอง: โหนดจะกำหนดขนาดของตัวเองตามการวัดเหล่านั้น
  3. วางโหนดบุตรหลาน: โหนดบุตรหลานแต่ละโหนดจะวางตามตำแหน่งของโหนดเอง

Constraints ช่วยค้นหาขนาดที่เหมาะสมสำหรับโหนดในระหว่าง 2 ขั้นตอนแรกของอัลกอริทึม ข้อจำกัดจะกำหนดขอบเขตต่ำสุดและสูงสุดสำหรับความกว้างและความสูงของโหนด เมื่อโหนดกำหนดขนาด ขนาดที่วัดได้ควรอยู่ในช่วงขนาดนี้

ประเภทข้อจำกัด

ข้อจำกัดอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • มีขอบเขต: โหนดมีความกว้างและความสูงสูงสุดและต่ำสุด
ข้อจำกัดที่มีขอบเขตของขนาดต่างๆ ภายในคอนเทนเนอร์
รูปที่ 3 ข้อจำกัดที่มีขอบเขต
  • ไม่จำกัด: โหนดไม่มีข้อจำกัดด้านขนาด ขอบเขตความกว้างและความสูงสูงสุดจะตั้งค่าเป็นไม่จำกัด
ข้อจำกัดที่ไม่มีขอบเขตซึ่งมีความกว้างและความสูงเป็นค่าอนันต์ ข้อจำกัดขยายออกไปนอกคอนเทนเนอร์
รูปที่ 4 ข้อจำกัดที่ไม่มีขอบเขต
  • Exact: ระบบขอให้โหนดเป็นไปตามข้อกำหนดด้านขนาดที่แน่นอน ขอบเขตต่ำสุดและสูงสุดจะตั้งค่าเป็นค่าเดียวกัน
ข้อจำกัดที่แน่นอนซึ่งเป็นไปตามข้อกำหนดด้านขนาดที่แน่นอนภายในคอนเทนเนอร์
รูปที่ 5 ข้อจำกัดที่แน่นอน
  • แบบผสม: โหนดเป็นไปตามประเภทข้อจำกัดข้างต้นรวมกัน เช่น ข้อจำกัดอาจจำกัดความกว้างในขณะที่อนุญาตให้มีความสูงสูงสุดแบบไม่จำกัด หรือกำหนดความกว้างที่แน่นอนแต่ให้ความสูงที่จำกัด
คอนเทนเนอร์ 2 รายการที่แสดงชุดค่าผสมของข้อจำกัดแบบมีขอบเขตและไม่มีขอบเขต รวมถึงความกว้างและความสูงที่แน่นอน
รูปที่ 6 การรวมข้อจำกัดแบบมีขอบเขตและไม่มีขอบเขต รวมถึงความกว้างและความสูงที่แน่นอน

ส่วนถัดไปจะอธิบายวิธีส่งต่อข้อจำกัดเหล่านี้จากระดับบนไปยังระดับล่าง

วิธีส่งต่อข้อจำกัดจากระดับบนไปยังระดับย่อย

ในขั้นตอนแรกของอัลกอริทึมที่อธิบายไว้ในข้อจำกัดในระยะเลย์เอาต์ ระบบจะส่งข้อจำกัดจากระดับบนลงล่างในโครงสร้าง UI

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

ในระดับสูง อัลกอริทึมจะทำงานดังนี้

  1. โหนดรูทในต้นไม้ UI จะวัดโหนดย่อยและส่งต่อข้อจำกัดเดียวกันไปยังโหนดย่อยแรกเพื่อตัดสินใจเลือกขนาดที่ต้องการใช้จริง
  2. หากองค์ประกอบย่อยเป็นตัวแก้ไขที่ไม่ส่งผลต่อการวัดผล ระบบจะส่งต่อข้อจำกัดไปยังตัวแก้ไขถัดไป ระบบจะส่งข้อจำกัดลงไปตามเชนตัวแก้ไขตามที่เป็นอยู่ เว้นแต่จะถึงตัวแก้ไขที่ส่งผลต่อการวัด จากนั้นระบบจะปรับขนาดข้อจำกัดตามความเหมาะสม
  3. เมื่อถึงโหนดที่ไม่มีโหนดย่อย (เรียกว่า "โหนดปลายสุด") โหนดจะกำหนดขนาดตามข้อจำกัดที่ส่งเข้ามา และแสดงผลขนาดที่แก้ไขแล้วนี้ไปยังโหนดหลัก
  4. วิดเจ็ตหลักจะปรับข้อจำกัดตามการวัดของวิดเจ็ตย่อยนี้ และเรียกใช้วิดเจ็ตย่อยถัดไปด้วยข้อจำกัดที่ปรับแล้วเหล่านี้
  5. เมื่อวัดองค์ประกอบย่อยทั้งหมดขององค์ประกอบหลักแล้ว โหนดหลักจะกำหนดขนาดของตัวเองและสื่อสารขนาดดังกล่าวไปยังองค์ประกอบหลักของตัวเอง
  6. ด้วยวิธีนี้ ระบบจะสำรวจทั้งต้นไม้แบบ Depth-First ในที่สุด โหนดทั้งหมดจะตัดสินใจเลือกขนาดของตนเอง และขั้นตอนการวัดผลจะเสร็จสมบูรณ์

ดูตัวอย่างเชิงลึกได้ในวิดีโอข้อจำกัดและลำดับของตัวแก้ไข

ตัวแก้ไขที่มีผลต่อข้อจำกัด

คุณได้เรียนรู้ในส่วนก่อนหน้าแล้วว่าตัวแก้ไขบางตัวอาจส่งผลต่อขนาดข้อจำกัด ส่วนต่อไปนี้จะอธิบายตัวแก้ไขที่เฉพาะเจาะจงซึ่งส่งผลต่อข้อจำกัด

ตัวปรับแต่ง size

ตัวแก้ไข size จะประกาศขนาดที่ต้องการของเนื้อหา

ตัวอย่างเช่น แผนผัง UI ต่อไปนี้ควรแสดงผลในคอนเทนเนอร์ขนาด 300dp คูณ 200dp ข้อจำกัดมีขอบเขต โดยอนุญาตให้มีความกว้างระหว่าง 100dp ถึง 300dp และความสูงระหว่าง 100dp ถึง 200dp

ส่วนหนึ่งของแผนผัง UI ที่มีตัวปรับขนาดที่รวมโหนดเลย์เอาต์ และการแสดงข้อจำกัดที่มีขอบเขตซึ่งกำหนดโดยตัวปรับขนาดในคอนเทนเนอร์
รูปที่ 7 ข้อจำกัดที่มีขอบเขตในโครงสร้าง UI และการแสดงผลในคอนเทนเนอร์

ตัวแก้ไข size จะปรับข้อจำกัดขาเข้าให้ตรงกับค่าที่ส่งมา ในตัวอย่างนี้ ค่าคือ 150dp:

เหมือนกับรูปที่ 7 ยกเว้นตัวแก้ไขขนาดจะปรับข้อจำกัดขาเข้าให้ตรงกับค่าที่ส่งมา
รูปที่ 8 ตัวแก้ไข size กำลังปรับข้อจำกัดเป็น 150dp

หากความกว้างและความสูงมีขนาดเล็กกว่าขอบเขตข้อจำกัดที่เล็กที่สุด หรือใหญ่กว่าขอบเขตข้อจำกัดที่ใหญ่ที่สุด ตัวแก้ไขจะจับคู่ข้อจำกัดที่ส่งมาให้ใกล้เคียงที่สุดเท่าที่จะทำได้ โดยยังคงยึดตามข้อจำกัดที่ส่งมา ดังนี้

แผนผัง UI 2 รายการและการแสดงผลที่เกี่ยวข้องในคอนเทนเนอร์ ในกรณีแรก ตัวปรับขนาดจะยอมรับข้อจำกัดที่เข้ามา ในกรณีที่ 2 ตัวปรับขนาดจะปรับให้เข้ากับข้อจำกัดที่ใหญ่เกินไปให้ใกล้เคียงที่สุด ส่งผลให้เกิดข้อจำกัดที่เติมเต็มคอนเทนเนอร์
รูปที่ 9 size ตัวแก้ไขที่ยึดตามข้อจำกัดที่ส่งมาอย่างใกล้เคียงที่สุด

โปรดทราบว่าการเชื่อมโยงตัวแก้ไข size หลายรายการจะใช้ไม่ได้ ตัวแก้ไข size ตัวแรกจะตั้งค่าข้อจำกัดทั้งต่ำสุดและสูงสุดเป็นค่าคงที่ แม้ว่าตัวแก้ไขขนาดที่ 2 จะขอขนาดที่เล็กกว่าหรือใหญ่กว่า แต่ก็ยังต้องเป็นไปตามขอบเขตที่แน่นอนที่ส่งมา ดังนั้นจึงจะไม่ลบล้างค่าเหล่านั้น

เชนของตัวแก้ไขขนาด 2 รายการในแผนผัง UI และการแสดงผลในคอนเทนเนอร์ ซึ่งเป็นผลลัพธ์ของค่าแรกที่ส่งเข้ามา ไม่ใช่ค่าที่ 2
รูปที่ 10 เชนของตัวแก้ไข size 2 ตัว ซึ่งค่าที่ 2 ที่ส่งเข้ามา (50dp) ไม่ลบล้างค่าแรก (100dp)

ตัวปรับแต่ง requiredSize

ใช้ตัวแก้ไข requiredSize แทน size หากต้องการให้โหนดลบล้างข้อจำกัดขาเข้า ตัวแก้ไข requiredSize จะแทนที่ข้อจำกัดขาเข้าและส่งขนาดที่คุณระบุเป็นขอบเขตที่แน่นอน

หากขนาดที่คุณส่งอยู่นอกข้อจำกัดขาเข้า โหนดจะรายงานขนาดที่พอดีกับข้อจำกัดเมื่อส่งขนาดกลับขึ้นไปในโครงสร้าง และเนื้อหาจะอยู่ตรงกลางในพื้นที่นั้นบนแต่ละแกนที่ขนาดทั้งสองแตกต่างกัน เนื้อหาที่มีขนาดใหญ่กว่าข้อจำกัดจะขยายเกินขอบเขตของข้อจำกัด ในรูปที่ 11 requiredSize(50) มีขนาดเล็กกว่า 100dp ที่ size ส่งเข้ามา ดังนั้นเนื้อหา 50dp จึงอยู่ตรงกลางในพื้นที่ 100dp ดังนี้

ตัวแก้ไข size และ requiredSize ที่เชื่อมโยงกันในแผนผัง UI และการแสดงผลที่เกี่ยวข้องในคอนเทนเนอร์ ข้อจำกัดของตัวปรับแต่ง requiredSize จะลบล้างข้อจำกัดของตัวปรับแต่ง size
รูปที่ 11 ตัวแก้ไข requiredSize จะลบล้างข้อจำกัดขาเข้าจากตัวแก้ไข size

ตัวแก้ไข width และ height

ตัวแก้ไข size จะปรับทั้งความกว้างและความสูงของข้อจำกัด ตัวแก้ไข width ช่วยให้คุณกำหนดความกว้างคงที่ได้ แต่ไม่ต้องกำหนดความสูง ในทำนองเดียวกัน คุณสามารถใช้ตัวแก้ไข height เพื่อกำหนดความสูงคงที่ แต่ปล่อยให้ความกว้างไม่แน่นอนได้ ดังนี้

แผนผัง UI 2 แผนผัง แผนผังหนึ่งมีตัวแก้ไขความกว้างและการแสดงผลคอนเทนเนอร์ และอีกแผนผังหนึ่งมีตัวแก้ไขความสูงและการแสดงผล
รูปที่ 12 ตัวแก้ไข width และตัวแก้ไข height จะตั้งค่าความกว้างและความสูงคงที่ตามลำดับ

หากต้องการตั้งค่าความกว้างหรือความสูงที่ลบล้างข้อจำกัดขาเข้า ให้ใช้ requiredWidth หรือ requiredHeight เช่นเดียวกับ requiredSize แต่ละรายการจะแทนที่ข้อจำกัดขาเข้า แต่จะแทนที่เฉพาะในแกนของตัวเองเท่านั้น โดย requiredWidth จะเก็บข้อจำกัดความสูงขาเข้าไว้ และ requiredHeight จะเก็บข้อจำกัดความกว้างขาเข้าไว้

ตัวปรับแต่ง sizeIn

ตัวแก้ไข sizeIn ช่วยให้คุณตั้งค่าข้อจำกัดต่ำสุดและสูงสุดสำหรับความกว้างและความสูงภายในข้อจำกัดขาเข้าได้ โดยหากข้อจำกัดขาเข้าเข้มงวดกว่า ข้อจำกัดดังกล่าวจะมีผลเหนือกว่า ใช้ตัวแก้ไข sizeIn หากต้องการควบคุมข้อจำกัดอย่างละเอียด ตัวแก้ไข widthIn และ heightIn จะทำแบบเดียวกันในแกนเดียว และปล่อยข้อจำกัดของอีกแกนไว้โดยไม่มีการเปลี่ยนแปลง แต่ละรายการจะใช้ค่าต่ำสุด ค่าสูงสุด หรือทั้ง 2 ค่า

แผนผัง UI ที่มีตัวแก้ไข sizeIn ที่ตั้งค่าความกว้างและความสูงขั้นต่ำและสูงสุดไว้ และการแสดงผลภายในคอนเทนเนอร์
รูปที่ 13 ตัวแก้ไข sizeIn ที่มี minWidth, maxWidth, minHeight และ maxHeight ตั้งค่าไว้

หากต้องการตั้งค่าช่วงที่ลบล้างข้อจำกัดขาเข้า ให้ใช้ requiredSizeIn หรือ requiredWidthIn และ requiredHeightIn สำหรับแกนเดียว ซึ่งเกี่ยวข้องกับ sizeIn, widthIn และ heightIn ในลักษณะเดียวกับที่ requiredSize เกี่ยวข้องกับ size

ตัวอย่าง

ส่วนนี้จะแสดงและอธิบายเอาต์พุตจากข้อมูลโค้ดหลายรายการที่มีตัวแก้ไขแบบต่อกัน

Image(
    painterResource(R.drawable.hero),
    contentDescription = null,
    Modifier
        .fillMaxSize()
        .size(50.dp)
)

ข้อมูลโค้ดนี้จะสร้างเอาต์พุตต่อไปนี้

สี่เหลี่ยมจัตุรัสสีน้ำเงินที่เติมเต็มคอนเทนเนอร์ระดับบนสุด
รูปที่ 14 Image จะเติมขนาดสูงสุดตามผลลัพธ์ของเชนตัวแก้ไข
  • ตัวแก้ไข fillMaxSize จะเปลี่ยนข้อจำกัดเพื่อตั้งค่าทั้งความกว้างและความสูงขั้นต่ำเป็นค่าสูงสุด ซึ่งก็คือความกว้าง 300dp และความสูง 200dp
  • แม้ว่าตัวแก้ไข size จะต้องการใช้ขนาด 50dp แต่ก็ยังต้อง ปฏิบัติตามข้อจำกัดขั้นต่ำที่เข้ามา ดังนั้นตัวแก้ไข size จะแสดงผลขอบเขตข้อจำกัดที่แน่นอนของ 300 คูณ 200 ด้วย โดยไม่สนใจค่าที่ระบุในตัวแก้ไข size
  • Image จะทำตามขอบเขตเหล่านี้และรายงานขนาด 300 คูณ 200 ซึ่งจะส่งต่อไปยังโครงสร้างทั้งหมด

Image(
    painterResource(R.drawable.hero),
    contentDescription = null,
    Modifier
        .fillMaxSize()
        .wrapContentSize()
        .size(50.dp)
)

ข้อมูลโค้ดนี้จะสร้างเอาต์พุตต่อไปนี้

สี่เหลี่ยมจัตุรัสสีน้ำเงินขนาดเล็กอยู่ตรงกลางภายในคอนเทนเนอร์หลัก
รูปที่ 15 Image จะอยู่ตรงกลางและมีขนาด 50dp
  • ตัวแก้ไข fillMaxSize จะปรับข้อจำกัดเพื่อตั้งค่าทั้งความกว้างและความสูงขั้นต่ำเป็นค่าสูงสุด ซึ่งก็คือความกว้าง 300dp และความสูง 200dp
  • ตัวแก้ไข wrapContentSize จะรีเซ็ตข้อจำกัดขั้นต่ำ ดังนั้น แม้ว่า fillMaxSize จะส่งผลให้เกิดข้อจำกัดแบบคงที่ แต่ wrapContentSize จะรีเซ็ตกลับเป็นข้อจำกัดแบบมีขอบเขต ตอนนี้โหนดต่อไปนี้จะใช้พื้นที่ทั้งหมดได้อีกครั้ง หรือมีขนาดเล็กกว่าพื้นที่ทั้งหมด
  • ตัวแก้ไข size จะตั้งค่าข้อจำกัดเป็นขอบเขตต่ำสุดและสูงสุดของ 50
  • Image จะเปลี่ยนเป็นขนาด 50 คูณ 50 และตัวแก้ไข size จะส่งต่อขนาดนั้น
  • ตัวแก้ไข wrapContentSize มีพร็อพเพอร์ตี้พิเศษ โดยจะนำองค์ประกอบย่อยและวางไว้ตรงกลางของขอบเขตขั้นต่ำที่ใช้ได้ซึ่งส่งผ่านไปยังองค์ประกอบนั้น ดังนั้นขนาดที่สื่อสารกับองค์ประกอบหลักจึงเท่ากับขอบเขตขั้นต่ำที่ส่งเข้ามา

การรวมตัวแก้ไขเพียง 3 ตัวจะช่วยให้คุณกำหนดขนาดสำหรับ Composable และจัดให้อยู่กึ่งกลางในองค์ประกอบหลักได้

Image(
    painterResource(R.drawable.hero),
    contentDescription = null,
    Modifier
        .clip(CircleShape)
        .padding(10.dp)
        .size(100.dp)
)

ข้อมูลโค้ดนี้จะสร้างเอาต์พุตต่อไปนี้

รูปทรงกลมที่ถูกตัดออกอย่างไม่ถูกต้องเนื่องจากลำดับของตัวแก้ไข
รูปที่ 16 รูปร่างที่ถูกตัดอย่างไม่ถูกต้องเนื่องจากลำดับของตัวแก้ไข
  • ตัวแก้ไข clip ไม่ได้เปลี่ยนข้อจำกัด
  • ตัวแก้ไข padding จะลดข้อจำกัดสูงสุด
  • ตัวแก้ไข size จะตั้งค่าข้อจำกัดทั้งหมดเป็น 100dp
  • Image จะยึดตามข้อจำกัดเหล่านั้นและรายงานขนาดเป็น 100dp คูณ 100dp
  • ตัวปรับแต่ง padding จะเพิ่ม 10dp ในทุกด้านให้กับขนาดที่รายงานโดย Image ดังนั้นเลย์เอาต์ที่มีระยะห่างจากขอบจะรายงานความกว้างและความสูงเป็น 120dp
  • ตอนนี้ในขั้นตอนการวาด ตัวปรับแต่ง clip จะทำงานบน Canvas ขนาด 120dp คูณ 120dp ระบบจะสร้างมาสก์วงกลมขนาดดังกล่าว
  • จากนั้นตัวปรับแต่ง padding จะแทรกเนื้อหาเข้าไป 10dp ในทุกด้าน ซึ่งจะลดขนาด Canvas สำหรับ Image เป็น 100dp คูณ 100dp
  • ระบบจะวาด Image ใน Canvas ขนาดเล็กนั้น ระบบจะตัดรูปภาพตามวงกลมเดิมของ 120dp ดังนั้นเอาต์พุตจึงเป็นผลลัพธ์ที่ไม่ใช่วงกลม

ข้อมูลโค้ด 3 รายการถัดไปจะใส่ Box ที่มีสีพื้นหลังในคอนเทนเนอร์ 300dp คูณ 200dp เดียวกัน

Box(
    modifier = Modifier
        .requiredWidth(400.dp)
        .height(100.dp)
        .background(Color(0xFF3DDC84))
)

ข้อมูลโค้ดนี้จะสร้างเอาต์พุตต่อไปนี้

สี่เหลี่ยมผืนผ้าสีเขียวกว้างอยู่ตรงกลางคอนเทนเนอร์สีฟ้าอ่อน โดยขยายออกไปในแนวนอนเลยทั้ง 2 ด้านของคอนเทนเนอร์
รูปที่ 17 เมื่อใช้ requiredWidth(400.dp) Box จะขยาย 50dp เลยแต่ละด้านของคอนเทนเนอร์ 300dp
  • ตัวแก้ไข requiredWidth จะแทนที่ข้อจำกัดความกว้างขาเข้าด้วยขอบเขตที่แน่นอนของ 400dp โดยจะคงข้อจำกัดความสูงขาเข้าไว้ที่ 0 ถึง 200dp
  • ตัวปรับแต่ง height จะตั้งค่าความสูงเป็น 100dp ซึ่งตรงตามข้อจำกัดด้านความสูง
  • Boxวัด400dpตาม100dp ความกว้างดังกล่าวมากกว่า 300dp ที่คอนเทนเนอร์อนุญาต ดังนั้น requiredWidth จึงรายงานความกว้าง 300dp ไปยังคอนเทนเนอร์หลักและจัดเนื้อหาให้อยู่กึ่งกลางในพื้นที่นั้น โดย Box จะขยายออกไป 50dp เลยแต่ละด้านของคอนเทนเนอร์

Box(
    modifier = Modifier
        .widthIn(min = 100.dp, max = 400.dp)
        .heightIn(max = 100.dp)
        .fillMaxSize()
        .background(Color(0xFF3DDC84))
)

ข้อมูลโค้ดนี้จะสร้างเอาต์พุตต่อไปนี้

สี่เหลี่ยมผืนผ้าสีเขียวอยู่ตรงกลางแนวตั้งภายในคอนเทนเนอร์สีฟ้าอ่อน โดยมีความกว้างเท่ากับคอนเทนเนอร์โดยไม่ยื่นออกไปด้านข้าง
รูปที่ 18 เมื่อใช้ widthIn Box จะมีขนาด 300dp คูณ 100dp และอยู่ภายในคอนเทนเนอร์
  • ตัวแก้ไข widthIn ขอความกว้างระหว่าง 100dp ถึง 400dp ความกว้างสูงสุดที่เข้ามาคือ 300dp ดังนั้นข้อจำกัดความกว้างจึงกลายเป็น 100dp ถึง 300dp
  • ตัวแก้ไข heightIn จะกำหนดความสูงสูงสุดเป็น 100dp ดังนั้นข้อจำกัดความสูงจึงกลายเป็น 0 ถึง 100dp
  • ตัวแก้ไข fillMaxSize จะตั้งค่าความกว้างและความสูงขั้นต่ำให้เท่ากับค่าสูงสุดเหล่านั้น ดังนั้น Box จึงมีขนาด 300dp คูณ 100dp และอยู่ภายในคอนเทนเนอร์

Box(
    modifier = Modifier
        .requiredSizeIn(minWidth = 100.dp, maxWidth = 400.dp, maxHeight = 100.dp)
        .fillMaxSize()
        .background(Color(0xFF3DDC84))
)

ข้อมูลโค้ดนี้จะสร้างเอาต์พุตต่อไปนี้

สี่เหลี่ยมผืนผ้าสีเขียวกว้างอยู่ตรงกลางคอนเทนเนอร์สีฟ้าอ่อน โดยขยายออกไปในแนวนอนเลยทั้ง 2 ด้านของคอนเทนเนอร์
รูปที่ 19 เมื่อใช้ requiredSizeIn Box จะมีขนาด 400dp คูณ 100dp และขยายออกไป 50dp เลยแต่ละด้านของคอนเทนเนอร์ ซึ่งให้ผลลัพธ์เหมือนกับรูปที่ 17
  • ตัวแก้ไข requiredSizeIn จะแทนที่ข้อจำกัดขาเข้าด้วยความกว้าง 100dp ถึง 400dp และความสูง 0 ถึง 100dp ไม่ได้ตั้งค่าความสูงขั้นต่ำไว้ จึงยังคงใช้ความสูงขั้นต่ำที่เข้ามาซึ่งเท่ากับ 0
  • ตัวแก้ไข fillMaxSize จะตั้งค่าความกว้างและความสูงขั้นต่ำเป็นค่าสูงสุดเหล่านั้น ดังนั้น Box จะวัดค่าได้ 400dp คูณ 100dp
  • เช่นเดียวกับตัวอย่าง requiredWidth ความกว้างมีขนาดใหญ่กว่าที่คอนเทนเนอร์อนุญาต ดังนั้น Box จึงอยู่ตรงกลางและขยายออกไป 50dp เกินแต่ละด้าน

ในระยะเดียวกัน widthIn และ heightIn จะเก็บ Box ไว้ในคอนเทนเนอร์ แต่ requiredSizeIn จะไม่เก็บ