ตั้งค่าพร็อพเพอร์ตี้ของสินค้า

แม้ว่าGrid config จะกำหนดโครงสร้างโดยรวม แต่คุณใช้ตัวแก้ไข gridItem เพื่อควบคุมตำแหน่ง ช่วง และการจัดแนวของรายการภายในโครงสร้างนั้น

ตั้งค่าตำแหน่งรายการ

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

พารามิเตอร์ row และ column จะระบุดัชนีแทร็กแถวและคอลัมน์ ที่วางรายการ ดัชนีแทร็กเป็นแบบอิงตาม 1 ซึ่งเริ่มต้นที่ 1 การระบุเฉพาะ row หรือ column (ไม่ใช่ทั้ง 2 อย่าง) จะวางรายการ ในพื้นที่ถัดไปที่ว่างในแทร็กนั้น การระบุทั้ง 2 อย่างจะทำให้รายการอยู่ในเซลล์นั้น

ใช้จำนวนเต็มบวกเพื่อระบุดัชนีแทร็กจากจุดเริ่มต้น เช่น หากต้องการวางรายการในแถวและคอลัมน์แรก ให้ใช้ gridItem(row = 1, column = 1)

ใช้จำนวนเต็มลบเพื่อระบุแทร็กที่สัมพันธ์กับตอนท้าย เช่น หากต้องการวางรายการในแถวและคอลัมน์ที่ 2 จากท้าย ให้ใช้ gridItem(row = -2, column = -2)

ในตัวอย่างต่อไปนี้ การ์ด #2 จะวาง ในแถวที่ 2 และคอลัมน์ที่ 2 การ์ด #3 จะกำหนดให้กับแถวสุดท้าย (จัดทำดัชนีโดย -1) ซึ่งจะใช้ คอลัมน์แรกที่พร้อมใช้งานในแทร็กนั้นโดยอัตโนมัติ (รูปที่ 1)

Grid(
    config = {
        repeat(2) {
            column(160.dp)
        }
        repeat(3) {
            row(90.dp)
        }
        gap(8.dp)
    }
) {
    Card1()
    Card2(modifier = Modifier.gridItem(row = 2, column = 2))
    Card3(modifier = Modifier.gridItem(row = -1, column = -2))
}
GridItem.kt

ขยายแถวและคอลัมน์

ใช้พารามิเตอร์ rowSpan และ columnSpan เพื่อขยายรายการไปยังหลายเซลล์ คุณวางองค์ประกอบ UI ลงในพื้นที่กริดได้ ซึ่งเป็นพื้นที่ที่ประกอบด้วยเซลล์กริดหลายเซลล์ ตัวแก้ไข gridItem ช่วยให้คุณระบุพื้นที่กริด ด้วยพารามิเตอร์ rowSpan และ columnSpan ได้ ในตัวอย่างต่อไปนี้ การ์ด #1 วางอยู่ในพื้นที่ซึ่งประกอบด้วย 2 แถวและ 2 คอลัมน์ (รูปที่ 2)

Grid(
    config = {
        repeat(3) {
            column(160.dp)
        }
        repeat(3) {
            row(90.dp)
        }
        rowGap(8.dp)
        columnGap(8.dp)
    }
) {
    Card1(modifier = Modifier.gridItem(rowSpan = 2, columnSpan = 2))
    Card2()
    Card3()
    Card4(modifier = Modifier.gridItem(columnSpan = 3))
}
GridArea.kt

ตั้งค่าการจัดแนวในพื้นที่ตารางกริด

คุณตั้งค่าการจัดแนวขององค์ประกอบ UI ในพื้นที่กริดได้ โดยระบุในการปรับแต่ง gridItem ของพารามิเตอร์ alignment ในตัวอย่างต่อไปนี้ #1 จะวางอยู่ตรงกลางพื้นที่ตารางกริด ซึ่งประกอบด้วย 2 คอลัมน์และ 2 แถว

Grid(
    config = {
        repeat(3) {
            column(160.dp)
        }
        repeat(3) {
            row(90.dp)
        }
        rowGap(8.dp)
        columnGap(8.dp)
    },
) {
    Text(
        text = "#1",
        modifier = Modifier
            .gridItem(
                rowSpan = 2,
                columnSpan = 2,
                alignment = Alignment.Center
            ),
    )
    Card2()
    Card3()
    Card4(modifier = Modifier.gridItem(columnSpan = 3))
}
GridArea.kt

การจัดวางอัตโนมัติผสมกับรายการที่จัดวาง

องค์ประกอบ UI ใน Grid ที่ไม่มีการระบุตำแหน่งจะได้รับการจัดวางอัตโนมัติ ตัวอย่างนี้แสดงวิธีผสมองค์ประกอบที่วางอัตโนมัติ และองค์ประกอบ UI กับเซลล์ตารางกริดที่ระบุ การ์ด #2 และการ์ด #4 จะอยู่ในตารางกริดที่ระบุ และระบบจะวางรายการอื่นๆ โดยอัตโนมัติ

Grid(
    config = {
        repeat(2) {
            column(160.dp)
        }
        repeat(3) {
            row(90.dp)
        }
        rowGap(16.dp)
        columnGap(8.dp)
    }
) {
    Card1()
    Card2(modifier = Modifier.gridItem(row = 2, column = 2))
    Card3()
    Card4(modifier = Modifier.gridItem(row = 3, column = 1))
    Card5()
    Card6()
}
GridItem.kt