Zasób układu

Zasób layoutu definiuje architekturę interfejsu użytkownika w Activity lub komponencie interfejsu użytkownika.

lokalizacja pliku:
res/layout/filename.xml
Nazwa pliku jest używana jako identyfikator zasobu.
skompilowany typ danych zasobu:
Wskaźnik zasobu do zasobu View (lub podklasy)
odwołanie do zasobu:
W języku Java: R.layout.filename
W języku XML: @[package:]layout/filename
składnia:
<?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>

Uwaga: elementem głównym może być element ViewGroup, View lub <merge>, ale może być tylko 1 element główny i musi on zawierać atrybut xmlns:android z przestrzenią nazw android, jak pokazano w powyższym przykładzie składni.

elements:
<ViewGroup>
Kontener na inne elementy View. Istnieje wiele różnych rodzajów obiektów ViewGroup, a każdy z nich pozwala na określenie układu elementów podrzędnych na różne sposoby. Różne rodzaje obiektów ViewGroup to m.in. LinearLayout, RelativeLayout i FrameLayout.

Nie zakładaj, że każda klasa pochodna ViewGroup akceptuje widoki zagnieżdżone. Niektóre grupy widoków są implementacjami klasy AdapterView, która określa swoje elementy podrzędne tylko na podstawie Adapter.

Atrybuty:

android:id
Identyfikator zasobu. Unikalna nazwa zasobu elementu, której możesz użyć, aby uzyskać odwołanie do ViewGroup z aplikacji. Więcej informacji znajdziesz w sekcji Wartość android:id.
android:layout_height
Wymiar lub słowo kluczowe. Wymagany. Wysokość grupy jako wartość wymiaru (lub zasób wymiaru) albo słowo kluczowe ("match_parent" lub "wrap_content"). Więcej informacji znajdziesz w sekcji Wartości android:layout_height i android:layout_width.
android:layout_width
Wymiar lub słowo kluczowe. Wymagany. Szerokość grupy jako wartość wymiaru (lub zasób wymiaru) albo słowo kluczowe ("match_parent" lub "wrap_content"). Więcej informacji znajdziesz w sekcji Wartości android:layout_height i android:layout_width.

Klasa bazowa ViewGroup obsługuje więcej atrybutów, a każda implementacja ViewGroup obsługuje ich jeszcze więcej. Listę wszystkich dostępnych atrybutów znajdziesz w dokumentacji odpowiedniej klasy ViewGroup, np. atrybuty XML LinearLayout.

<View>
Pojedynczy komponent interfejsu, zwykle nazywany widżetem. Różne rodzaje obiektów View obejmują TextView, Button i CheckBox.

Atrybuty:

android:id
Identyfikator zasobu. Unikalna nazwa zasobu elementu, której możesz użyć, aby uzyskać odwołanie do View z aplikacji. Więcej informacji znajdziesz w sekcji Wartość android:id.
android:layout_height
Wymiar lub słowo kluczowe. Wymagany. Wysokość elementu jako wartość wymiaru (lub zasób wymiaru) albo słowo kluczowe ("match_parent" lub "wrap_content"). Więcej informacji znajdziesz w sekcji Wartości android:layout_height i android:layout_width.
android:layout_width
Wymiar lub słowo kluczowe. Wymagany. Szerokość elementu jako wartość wymiaru (lub zasób wymiaru) albo słowo kluczowe ("match_parent" lub "wrap_content"). Więcej informacji znajdziesz w sekcji Wartości android:layout_height i android:layout_width.

Klasa bazowa View obsługuje więcej atrybutów, a każda implementacja View obsługuje ich jeszcze więcej. Więcej informacji znajdziesz w artykule Układy. Aby zapoznać się ze wszystkimi dostępnymi atrybutami, zapoznaj się z odpowiednią dokumentacją, np. atrybutami XML TextView.

<requestFocus>
Każdy element reprezentujący obiekt View może zawierać ten pusty element, który nadaje elementowi nadrzędnemu początkowe zaznaczenie na ekranie. W każdym pliku może być tylko jeden taki element.
<include>
Dołącza plik układu do tego układu.

Atrybuty:

layout
Zasób layoutu. Wymagany. Odniesienie do zasobu layoutu.
android:id
Identyfikator zasobu. Zastępuje identyfikator nadany widokowi głównemu w dołączonym układzie.
android:layout_height
Wymiar lub słowo kluczowe. Zastępuje wysokość podaną dla widoku głównego w dołączonym układzie. Działa tylko wtedy, gdy zadeklarowano też android:layout_width.
android:layout_width
Wymiar lub słowo kluczowe. Zastępuje szerokość podaną dla widoku głównego w dołączonym układzie. Działa tylko wtedy, gdy zadeklarowano też android:layout_height.

W elemencie <include> możesz uwzględnić dowolne inne atrybuty układu, które są obsługiwane przez element główny w dołączonym układzie. Zastąpią one atrybuty zdefiniowane w elemencie głównym.

Uwaga: jeśli chcesz zastąpić atrybuty układu za pomocą tagu <include>, musisz zastąpić zarówno android:layout_height, jak i android:layout_width, aby inne atrybuty układu zaczęły obowiązywać.

Innym sposobem na uwzględnienie układu jest użycie ViewStub: lekkiego widoku, który nie zajmuje miejsca w układzie, dopóki nie zostanie wyraźnie rozwinięty. Gdy to zrobisz, będzie on zawierać plik układu określony przez atrybut android:layout. Więcej informacji o używaniu ViewStub znajdziesz w artykule Wczytywanie widoków na żądanie.

<merge>
Alternatywny element główny, który nie jest rysowany w hierarchii układu. Użycie tego elementu jako elementu głównego jest przydatne, gdy wiesz, że ten układ jest umieszczony w układzie, który zawiera już odpowiedni element nadrzędny View, który może zawierać elementy podrzędne elementu <merge>.

Jest to szczególnie przydatne, gdy planujesz uwzględnić ten układ w innym pliku układu za pomocą <include>, a ten układ nie wymaga innego kontenera ViewGroup. Więcej informacji o scalaniu układów znajdziesz w artykule Ponowne używanie układów za pomocą tagu <include>.

Wartość android:id

W przypadku wartości identyfikatora zwykle używa się tej składni: "@+id/name", jak pokazano w tym przykładzie. Symbol plusa (+) wskazuje, że jest to nowy identyfikator zasobu, a narzędzie aapt tworzy nową liczbę całkowitą zasobu w klasie R.java, jeśli jeszcze nie istnieje.

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

Nazwa nameTextbox jest teraz identyfikatorem zasobu dołączonym do tego elementu. Następnie możesz odwołać się do elementu TextView, z którym jest powiązany identyfikator w języku Java:

Kotlin

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

Java

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

Ten kod zwraca obiekt TextView.

Jeśli jednak masz już zdefiniowany zasób identyfikatora, który nie jest jeszcze używany, możesz zastosować ten identyfikator do elementu View, wykluczając symbol plusa z wartości android:id.

Wartości android:layout_height i android:layout_width

Wartości wysokości i szerokości są wyrażone za pomocą dowolnych jednostek wymiarów obsługiwanych przez Androida (px, dp, sp, pt, in, mm) lub za pomocą tych słów kluczowych:

WartośćOpis
match_parent Ustawia wymiar tak, aby pasował do wymiaru elementu nadrzędnego. Dodano w interfejsie API na poziomie 8, aby wycofać fill_parent.
wrap_content Ustawia wymiar tylko na rozmiar wymagany do dopasowania zawartości tego elementu.

Elementy widoku niestandardowego

Możesz tworzyć niestandardowe elementy View i ViewGroup i stosować je w układzie tak samo jak standardowe elementy układu. Możesz też określić atrybuty obsługiwane w elemencie XML. Więcej informacji znajdziesz w artykule Tworzenie niestandardowych komponentów widoku.

przykład:
Plik XML zapisany w 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>

Ten kod aplikacji wczytuje układ dla Activity w metodzie 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);
}
patrz też: