TableLayout使用表格的方式劃分子組件。

TableLayout的共有XML屬性繼承自：Component。

TableLayout的自有XML屬性見下表：

在XML中創建TableLayout，示例代碼如下：

在graphic文件夾下創建Text的背景table_text_bg_element.xml，示例代碼如下：

    ohos:radius="5vp"/>
    

在TableLayout布局中添加子組件。

xmlns:ohos="http://schemas.huawei.com/res/ohos"
    ohos:height="match_parent"
    ohos:width="match_parent"
    ohos:background_element="#87CEEB"
    ohos:padding="8vp">
    ohos:height="60vp"
        ohos:width="60vp"
        ohos:background_element="$graphic:table_text_bg_element"
        ohos:margin="8vp"
        ohos:text="1"
        ohos:text_alignment="center"
        ohos:text_size="20fp"/>


    

TableLayout默認一列多行。

設置行列數：

...
    ohos:row_count="2"
    ohos:column_count="2">

設置TableLayout的行為2，列為2效果。

在XML中設置布局排列方向，以“vertical”為例：

...
    ohos:orientation="vertical">
    ...

設置布局排列方向為“vertical”的效果。

TableLayout提供兩種對齊方式，邊距對齊“align_contents”、邊界對齊“align_edges”，默認為邊距對齊“align_contents”。代碼如下：

xmlns:ohos="http://schemas.huawei.com/res/ohos"
    ohos:height="match_content"
    ohos:width="match_content"
    ohos:alignment_type="align_contents"
    ohos:background_element="$graphic:layout_borderline"
    ohos:column_count="3"
    ohos:padding="8vp">


    ohos:height="48vp"
        ohos:width="48vp"
        ohos:background_element="$graphic:table_text_bg_element"
        ohos:margin="8vp"
        ohos:padding="8vp"
        ohos:text="1"
        ohos:text_alignment="center"
        ohos:text_size="14fp"/>


    

邊距對齊效果：

將TableLayout的對齊方式修改為邊界對齊。

...
ohos:alignment_type="align_edges">
    ...

邊界對齊效果：

引用graphic文件夾下的背景資源文件為layout_borderline.xml，示例代碼如下：

TableLayout合并單元格的效果可以通過設置子組件的行列屬性來實現。

設置子組件的行列屬性均為2的效果展示：

在XML中創建TableLayout，并添加子組件，代碼如下：

xmlns:ohos="http://schemas.huawei.com/res/ohos"
    ohos:height="match_content"
    ohos:width="match_content"
    ohos:alignment_type="align_edges"
    ohos:background_element="$graphic:layout_borderline"
    ohos:column_count="3"
    ohos:padding="8vp"
    ohos:row_count="3">


    ohos:id="$+id:text_one"
        ohos:height="48vp"
        ohos:width="48vp"
        ohos:background_element="$graphic:table_text_bg_element"
        ohos:margin="16vp"
        ohos:padding="8vp"
        ohos:text="1"
        ohos:text_alignment="center"
        ohos:text_size="14fp"/>


    

在Java代碼中設置子組件的行列屬性，代碼如下：

@Override
    protected void onStart(Intent intent) {
        ...
        Component component = findComponentById(ResourceTable.Id_text_one);
        TableLayout.LayoutConfig tlc = new TableLayout.LayoutConfig(vp2px(72), vp2px(72));
        tlc.columnSpec = TableLayout.specification(TableLayout.DEFAULT, 2);
        tlc.rowSpec = TableLayout.specification(TableLayout.DEFAULT, 2);
        component.setLayoutConfig(tlc);
    }


    private int vp2px(float vp) {
        return AttrHelper.vp2px(vp, getContext());
    }

在設置子組件的行列屬性時，TableLayout剩余的行數和列數必須大于等于該子組件所設置的行數和列數。

目前僅支持Java代碼設置TableLayout子組件的行列屬性。

在創建子組件的行列屬性時，還可設置子組件的對齊方式，修改上述Java代碼如下：

@Override
    protected void onStart(Intent intent) {
        ...
        tlc.columnSpec = TableLayout.specification(TableLayout.DEFAULT, 2, TableLayout.Alignment.ALIGNMENT_FILL);
        tlc.rowSpec = TableLayout.specification(TableLayout.DEFAULT, 2, TableLayout.Alignment.ALIGNMENT_FILL);
        ...
    }

子組件的對齊方式設置為ALIGNMENT_FILL的效果：

設置子組件的權重，代碼如下：

@Override
    protected void onStart(Intent intent) {
        ...
        TableLayout.LayoutConfig tlc = new TableLayout.LayoutConfig(0, vp2px(48));
        tlc.columnSpec = TableLayout.specification(TableLayout.DEFAULT, 1, 1.0f);
        tlc.rowSpec = TableLayout.specification(TableLayout.DEFAULT, 1);


        findComponentById(ResourceTable.Id_text_one).setLayoutConfig(tlc);
        findComponentById(ResourceTable.Id_text_two).setLayoutConfig(tlc);
        findComponentById(ResourceTable.Id_text_three).setLayoutConfig(tlc);
        findComponentById(ResourceTable.Id_text_four).setLayoutConfig(tlc);
        findComponentById(ResourceTable.Id_text_five).setLayoutConfig(tlc);
        findComponentById(ResourceTable.Id_text_six).setLayoutConfig(tlc);
    }

上述代碼將子組件的寬度權重設置為1.0，每行子組件會均分TableLayout的寬度，所以需要設置TableLayout為固定寬度或match_parent。

ohos:width="match_parent"
    ...>


    ohos:id="$+id:text_one"
        .../>


    

將子組件的寬度權重設置為1.0的效果展示：

審核編輯：湯梓紅