Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.
Zasób układu
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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ż:
-
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2026-11-19 UTC.
[null,null,["Ostatnia aktualizacja: 2026-11-19 UTC."],[],[]]