- TableLayout и TableRow
- Создаем таблицу прогноза погоды
- Программное создание TableLayout
- Усадка, усушка, утруска
- Книжная полка
- TableLayout приложения Android
- Пример табличной разметки, TableLayout
- Интерфейс приложения
- Текст меток
- Текстовое описание интерфейса
- Старт приложения
- Android java table row
- Программное создание TableLayout
TableLayout и TableRow
Разметка TableLayout (Табличная разметка) позиционирует свои дочерние элементы в строки и столбцы, как это привыкли делать веб-мастера в теге table. TableLayout не отображает линии обрамления для их строк, столбцов или ячеек. TableLayout может иметь строки с разным количеством ячеек. При формировании разметки таблицы некоторые ячейки при необходимости можно оставлять пустыми. При создании разметки для строк используются объекты TableRow, которые являются дочерними классами TableLayout (каждый TableRow определяет единственную строку в таблице). Строка может не иметь ячеек или иметь одну и более ячеек, которые являются контейнерами для других объектов. В ячейку допускается вкладывать другой TableLayout или LinearLayout.
TableLayout удобно использовать, например, при создании логических игр типа Судоку, Крестики-Нолики и т.п.
Вот несколько правил для TableLayout. Во-первых, ширина каждой колонки определяется по наиболее широкому содержимому в колонке. Дочерние элементы используют в атрибутах значение match_parent. Атрибут TableRow для layout_height всегда wrap_content. Ячейки могут объединять колонки, но не ряды. Достигается слияние колонок через атрибут layout_span.
Если атрибуту android:stretchColumns компонента TableLayout присвоить значение «*», то содержимое каждого компонента TableRow может растягиваться на всю ширину макета.
Создаем таблицу прогноза погоды
Например, для создания таблицы прогноза погоды можно использовать следующий дизайн:
- В первом ряду показать заголовок таблицы
- Во втором ряду показать даты по типу календаря
- В третьем ряду показать наибольшую температуру
- В четвёртом ряду показать наименьшую температуру
- В пятом ряду показать графику (дождь, снег, облачность, солнце)
В альбомной ориентации наша разметка будет выглядеть следующим образом
Программное создание TableLayout
@Override public void onCreate(Bundle savedInstanceState) < super.onCreate(savedInstanceState); TableLayout table = new TableLayout(this); table.setStretchAllColumns(true); table.setShrinkAllColumns(true); TableRow rowTitle = new TableRow(this); rowTitle.setGravity(Gravity.CENTER_HORIZONTAL); TableRow rowDayLabels = new TableRow(this); TableRow rowHighs = new TableRow(this); TableRow rowLows = new TableRow(this); TableRow rowConditions = new TableRow(this); rowConditions.setGravity(Gravity.CENTER); TextView empty = new TextView(this); // title column/row TextView title = new TextView(this); title.setText("Java Weather Table"); title.setTextSize(TypedValue.COMPLEX_UNIT_DIP, 18); title.setGravity(Gravity.CENTER); title.setTypeface(Typeface.SERIF, Typeface.BOLD); TableRow.LayoutParams params = new TableRow.LayoutParams(); params.span = 6; rowTitle.addView(title, params); // labels column TextView highsLabel = new TextView(this); highsLabel.setText("Day High"); highsLabel.setTypeface(Typeface.DEFAULT_BOLD); TextView lowsLabel = new TextView(this); lowsLabel.setText("Day Low"); lowsLabel.setTypeface(Typeface.DEFAULT_BOLD); TextView conditionsLabel = new TextView(this); conditionsLabel.setText("Conditions"); conditionsLabel.setTypeface(Typeface.DEFAULT_BOLD); rowDayLabels.addView(empty); rowHighs.addView(highsLabel); rowLows.addView(lowsLabel); rowConditions.addView(conditionsLabel); // day 1 column TextView day1Label = new TextView(this); day1Label.setText("Feb 7"); day1Label.setTypeface(Typeface.SERIF, Typeface.BOLD); TextView day1High = new TextView(this); day1High.setText("28°F"); day1High.setGravity(Gravity.CENTER_HORIZONTAL); TextView day1Low = new TextView(this); day1Low.setText("15°F"); day1Low.setGravity(Gravity.CENTER_HORIZONTAL); ImageView day1Conditions = new ImageView(this); day1Conditions.setImageResource(R.drawable.hot); rowDayLabels.addView(day1Label); rowHighs.addView(day1High); rowLows.addView(day1Low); rowConditions.addView(day1Conditions); // day2 column TextView day2Label = new TextView(this); day2Label.setText("Feb 8"); day2Label.setTypeface(Typeface.SERIF, Typeface.BOLD); TextView day2High = new TextView(this); day2High.setText("26°F"); day2High.setGravity(Gravity.CENTER_HORIZONTAL); TextView day2Low = new TextView(this); day2Low.setText("14°F"); day2Low.setGravity(Gravity.CENTER_HORIZONTAL); ImageView day2Conditions = new ImageView(this); day2Conditions.setImageResource(R.drawable.pt_cloud); rowDayLabels.addView(day2Label); rowHighs.addView(day2High); rowLows.addView(day2Low); rowConditions.addView(day2Conditions); // day3 column TextView day3Label = new TextView(this); day3Label.setText("Feb 9"); day3Label.setTypeface(Typeface.SERIF, Typeface.BOLD); TextView day3High = new TextView(this); day3High.setText("23°F"); day3High.setGravity(Gravity.CENTER_HORIZONTAL); TextView day3Low = new TextView(this); day3Low.setText("3°F"); day3Low.setGravity(Gravity.CENTER_HORIZONTAL); ImageView day3Conditions = new ImageView(this); day3Conditions.setImageResource(R.drawable.snow); rowDayLabels.addView(day3Label); rowHighs.addView(day3High); rowLows.addView(day3Low); rowConditions.addView(day3Conditions); // day4 column TextView day4Label = new TextView(this); day4Label.setText("Feb 10"); day4Label.setTypeface(Typeface.SERIF, Typeface.BOLD); TextView day4High = new TextView(this); day4High.setText("17°F"); day4High.setGravity(Gravity.CENTER_HORIZONTAL); TextView day4Low = new TextView(this); day4Low.setText("5°F"); day4Low.setGravity(Gravity.CENTER_HORIZONTAL); ImageView day4Conditions = new ImageView(this); day4Conditions.setImageResource(R.drawable.lt_snow); rowDayLabels.addView(day4Label); rowHighs.addView(day4High); rowLows.addView(day4Low); rowConditions.addView(day4Conditions); // day5 column TextView day5Label = new TextView(this); day5Label.setText("Feb 11"); day5Label.setTypeface(Typeface.SERIF, Typeface.BOLD); TextView day5High = new TextView(this); day5High.setText("19°F"); day5High.setGravity(Gravity.CENTER_HORIZONTAL); TextView day5Low = new TextView(this); day5Low.setText("6°F"); day5Low.setGravity(Gravity.CENTER_HORIZONTAL); ImageView day5Conditions = new ImageView(this); day5Conditions.setImageResource(R.drawable.pt_sun); rowDayLabels.addView(day5Label); rowHighs.addView(day5High); rowLows.addView(day5Low); rowConditions.addView(day5Conditions); table.addView(rowTitle); table.addView(rowDayLabels); table.addView(rowHighs); table.addView(rowLows); table.addView(rowConditions); setContentView(table); >
Усадка, усушка, утруска
Если текст в ячейке таблицы слишком длинный, то он может растянуть ячейку таким образом, что часть текста просто выйдет за пределы видимости. Чтобы избежать данной проблемы, у контейнтера TableLayout есть атрибут android:shrinkColumns. Мы рассмотрим программное применение данного атрибута через метод setColumnShrinkable().
Для начала смоделируем ситуацию и поместим в одну из ячеек очень длинный текст, который не поместится на экран:
Теперь напишем код для усадки текста:
public class TableActivity extends Activity < private boolean mShrink; @Override public void onCreate(Bundle savedInstanceState) < super.onCreate(savedInstanceState); setContentView(R.layout.activity_test); final TableLayout table = (TableLayout) findViewById(R.id.tablelayout); Button button = (Button) findViewById(R.id.toggle); button.setOnClickListener(new Button.OnClickListener() < public void onClick(View v) < mShrink = !mShrink; table.setColumnShrinkable(0, mShrink); >>); mShrink = table.isColumnShrinkable(0); > >
Книжная полка
Создадим подобие книжной полки. Нам понадобится изображение одной полки, которая послужит фоном и изображение книги (найдите сами).
Объявим две константы, которые отвечают за количество полок и количество книг на каждой полке.
package ru.alexanderklimov.test; import android.app.Activity; import android.os.Bundle; import android.view.ViewGroup.LayoutParams; import android.widget.ImageView; import android.widget.TableLayout; import android.widget.TableRow; public class MainActivity extends Activity < /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) < super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); int BOOKSHELF_ROWS = 5; int BOOKSHELF_COLUMNS = 5; TableLayout tableLayout = (TableLayout) findViewById(R.id.tableLayout); for (int i = 0; i < BOOKSHELF_ROWS; i++) < TableRow tableRow = new TableRow(this); tableRow.setLayoutParams(new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT)); tableRow.setBackgroundResource(R.drawable.shelf); for (int j = 0; j < BOOKSHELF_COLUMNS; j++) < ImageView imageView = new ImageView(this); imageView.setImageResource(R.drawable.book); tableRow.addView(imageView, j); >tableLayout.addView(tableRow, i); > > >
Откуда на верхней полке появился кот и как он туда забрался я не знаю. Вы уж сами разберитесь с ним.
TableLayout приложения Android
Данная статья является продолжением описания разметки интерфейса приложения Android. В предыдущей статье был представлен обзор с примерами возможных типов разметки. В данной статье рассмотрим табличную разметку TableLayout.
Пример табличной разметки, TableLayout
Для наглядного использования контейнера TableLayout создадим layout в рамках приложения p02layout, описанного в начальной части статьи. При создании нового layout определим наименование table (table.xml) и тип контейнера TableLayout. После этого в table.xml создадим интерфейс авторизации пользователя, т.е. включим компоненты ввода логина и пароля с метками пользователя и кнопки выполнения авторизации и закрытия.
Интерфейс формы будет включать 4 строки. В первой строке разместим метку (TextView) и компонент определения логина пользователя (EditText). Во второй строке установим метку (TextView) и компонент определения пароля пользователя (TextPassword). Третья строка останется пустой; она будет определять по вертикали относительное расположение кнопок. В четвертой строке справа разместим кнопки управления (Button).
Добавление строк, TableRow. Для формирования строк интерфейса необходимо использовать объект TableRow, который должен быть дочерним элементом контейнера TableLayout. Каждый компонент TableRow определяет единственную строку в таблице. Строка может не иметь ячеек или иметь одну и более ячеек. Ячейки строки являются контейнерами для других объектов. В ячейку можно вкладывать другой TableLayout или LinearLayout.
Для добавления строки в интерфейс нужно открыть вкладку Layouts в Palette, выделить компонент TableRow и перетащить его либо на страницу, либо в контейнер панели Component Tree. После этого можно таким же образом размещать в строке другие компоненты.
На первом шаге, чтобы не делать лишних телодвижений можно в контейнер поместить сразу 4 строки TableRow. На следующем шаге создадим пустую 3-ю строку с определенным по высоте размером.
Пустая строка. Чтобы создать пустую строку требуемого размера по высоте в 3-ю строку TableRow помещаем контейнер LinearLayout и определяем его размер по высоте; это можно сделать мышкой. Хватаем нижнюю часть компонента (LinearLayout), перемещаем на требуемое расстояние и бросаем (drag-and-drop). Таким образом, можно отделить одну часть интерфейса – компонентов определения учетной записи – от другой (кнопок управления).
Cтрока кнопок управления. Теперь можно в 4-ую строку поместить кнопки управления. Для этого сначала перетаскиваем два пустых компонента Space, и после этого две кнопки «ОК» и «Закрыть». Компонент Space также можно растягивать мышкой по горизонтали. Первый Space будет определять ширину первой колонки для меток, второй Space в совокупности с кнопкой «ОК» будет определять ширину второй колонки, где будут размещаться компоненты ввода параметров учетной записи.
Фоновой цвет строки. Чтобы визуально выделять заголовки или строки таблицы можно определить фоновый цвет TableRow. Для этого следует использовать атрибут «android:background» компонента TableRow.
Растягивание компонентов. Чтобы содержимое компонентов TableRow растянулось на всю ширину макета, необходимо указать в атрибуте «android:stretchColumns» контейнера TableLayout символ ‘*’. Но можно через запятую указать порядковые номера столбцов, которые следует растянуть. Номера столбцов отсчитываются от нуля; остальные колонки занимают минимум места. Например :
Объединение колонок. Смежные ячейки строк можно объединить, чтобы расстянуть компонент на несколько ячеек. Ряды строк объединить нельзя. Слияние ячеек выполняется определением значения целочисленного атрибута «android:layout_span» компонента; layout_span является аналогом атрибута colspan в HTML. Вот как это было выполнено для компонента edLogin в примере :
Рамка в таблице. К сожалению, контейнер TableLayout не может создать рамку для таблицы или ячейки; разработчики Android почему-то не определили эту функциональность. Но данную функциональность Вы можете создать самостоятельно, определяя фоновой цвет таблицы и ячейки.
Ограничение размера колонки. По невнимательности в ячейку таблицы можно вставить очень длинный текст, который растянет ячейку так, что часть текста просто выйдет за пределы экрана. Чтобы избежать данной проблемы необходимо использовать атрибут «android:shrinkColumns» контейнтера TableLayout. С точки зрения программирования приложения данный атрибут управляется методом setColumnShrinkable().
Рассмотрим програмное управление свойством «android:shrinkColumns» на примере. Допустим, что одна из меток в нулевой колонке таблицы имеет очень длинный текст. В интерфейсе мы разместили кнопку btnShrink, по нажатию на которую будем устанавливать флаг «android:shrinkColumns» или сбрасывать. Для этого, необходимо в главном модуле определить логическую переменную (b_shrink), значением которой будет управлять. Код примера представлен в листинге :
public class MainActivity extends AppCompatActivity < private boolean b_shrink; @Override public void onCreate(Bundle savedInstanceState) < super.onCreate(savedInstanceState); setContentView(R.layout.table); final TableLayout table = null; table = (TableLayout) findViewById(R.id.tblLayout); Button btn = (Button) findViewById(R.id.btnShrink); btn.setOnClickListener(new Button.OnClickListener() < public void onClick(View v) < b_shrink = !b_shrink; table.setColumnShrinkable(0, b_shrink); >>); b_shrink = table.isColumnShrinkable(0); > >
Программное создание таблицы. При программном создании таблицы необходимо найти/определить контейнер TableLayout, к которому соответствующим образом добавить необходимое количество строк TableRow. Каждую из строк можно также динамически «оформить». Следующий пример демонстрирует динамическое формирование таблицы, в каждой из ячеек которой размещается изображения.
int ROWS = 3; int COLS = 4; TableLayout tblLayout = null; tblLayout = (TableLayout) findViewById(R.id.tableLayout); for (int i = 0; i < ROWS; i++) < TableRow tableRow = new TableRow(this); tableRow.setLayoutParams(new LayoutParams( LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT)); for (int j = 0; j < COLS; j++) < // получение изображения полки ImageView imageView = new ImageView(this); imageView.setImageResource(R.drawable.shelf); tableRow.addView(imageView, j); >tblLayout.addView(tableRow, i);
Интерфейс приложения
Описание возможностей TableLayout и TableRow можно было бы продолжать еще долго. Но, как я полагаю, Вы получили достаточный толчок в понимании того, как можно через интерфейс или программно определить тот или иной атрибут таблицы. Теперь Вам не составит труда самостоятельно соответствующим образом настроить табличный интерфейс приложения.
Возвращаясь к нашему примеру, можно представить внешний вид интерфейса приложения на следующем скриншоте.
Если посмотреть на представление компонентов в дереве (Component Tree), то сразу же бросаются в глаза изображения предупреждения с восклицательными знаками напротив компонентов. В данном случае среда разработки Android Studio нас предупреждает, что текстовые заголовки меток и кнопок необходимо локализовать. Кроме этого необходимо связать метки с компонентами.
Вопрос локализации интерфейса Android Studio рассмотрен на отдельной странице локализациии приложения, а здесь только покажем, как можно бороться с подобными предупреждениями.
Обратите внимание на светло-серый текст возле компонентов tvLogin (@string/lbl_login), tvPassword (@string/lbl_password). Рядом с кнопками подобный текст отсутствует, но имеются предупреждающие сообщения. Это говорит о том, что текст для меток tvLogin и tvPassword используется из ресурсного файла string.xml. Рассмотрим этот файл :
Текст меток
В ресурсном файле определяются наименования ключей и их значения подобно key=value. Для этого в текст файла в формате XML включаются строки с атрибутами (ключами) «name» и соответствующими значеними.
P02layout Login Password OK Закрыть
Далее необходимо определенный ключ подключить к метке TextView или к кнопке в опции «android:text». Вот как это выглядит для метки tvLogin :
В описании метки tvLogin определяется идентификатор «android:id», размер метки «android:layout_width», текстовое значение «android:text» и устанавливается связь с компонентом edLogin в опции «android:labelFor». Все эти значения можно определять также через интерфейс в панели атрибутов после выделения компонета.
Текстовое описание интерфейса
В следующем листинге приведено полное описание файла table.xml . Полагаю, что Вам не составит труда самостоятельно подключить локализованные строки к кнопкам.
Старт приложения
Для старта приложения необходимо в активности MainActivity.java в методе onCreate переключиться на интерфейсное описание table.xml :
setContentView(R.layout.table);
Помните, что если Вы не корректно завершите работу Android приложения, то IDE может не удалить файлы и поддиректории эмулятора, и при следующем старте приложения эмулятор не запуститься. Как бороться с проблемами запуска эмулятора описано здесь.
Android java table row
Контейнер TableLayout структурирует элементы управления в виде таблицы по столбцам и строкам. Определим в файле activity_main.xml элемент TableLayout, который будет включать две строки и два столбца:
Используя элемент TableRow , мы создаем отдельную строку. Как разметка узнает сколько столбцов надо создать? Android находит строку с максимальным количеством виджетов одного уровня, и это количество будет означать количество столбцов. Например, в данном случае у нас определены две строки и в каждой по два элемента. Если бы в какой-нибудь из них было бы три виджета, то соответственно столбцов было бы также три, даже если в другой строке осталось бы два виджета.
Причем элемент TableRow наследуется от класса LinearLayout, поэтому мы можем к нему применять тот же функционал, что и к LinearLayout. В частности, для определения пространства для элементов в строке используется атрибут android:layout_weight .
Если какой-то элемент должен быть растянут на ряд столбцов, то мы можем растянуть его с помощью атрибута layout_span , который указывает на какое количество столбцов надо растянуть элемент:
Также можно растянуть элемент на всю строку, установив у него атрибут android:layout_weight=»1″ :
Программное создание TableLayout
Создадим TableLayout программным образом, переложив на код java самый первый пример из данной статьи:
package com.example.viewapp; import androidx.appcompat.app.AppCompatActivity; import android.os.Bundle; import android.widget.EditText; import android.widget.TableLayout; import android.widget.TableRow; import android.widget.TextView; public class MainActivity extends AppCompatActivity < @Override protected void onCreate(Bundle savedInstanceState) < super.onCreate(savedInstanceState); TableLayout tableLayout = new TableLayout( this); // первая строка TableRow tableRow1 = new TableRow(this); TextView textView1 = new TextView(this); textView1.setText("Логин"); tableRow1.addView(textView1, new TableRow.LayoutParams( TableRow.LayoutParams.WRAP_CONTENT, TableRow.LayoutParams.WRAP_CONTENT, 0.5f)); EditText editText1 = new EditText(this); tableRow1.addView(editText1, new TableRow.LayoutParams( TableRow.LayoutParams.WRAP_CONTENT, TableRow.LayoutParams.WRAP_CONTENT, 1.0f)); // вторая строка TableRow tableRow2 = new TableRow(this); TextView textView2 = new TextView(this); textView2.setText("Email"); tableRow2.addView(textView2, new TableRow.LayoutParams( TableRow.LayoutParams.WRAP_CONTENT, TableRow.LayoutParams.WRAP_CONTENT, 0.5f)); EditText editText2 = new EditText(this); tableRow2.addView(editText2, new TableRow.LayoutParams( TableRow.LayoutParams.WRAP_CONTENT, TableRow.LayoutParams.WRAP_CONTENT, 1.f)); tableLayout.addView(tableRow1); tableLayout.addView(tableRow2); setContentView(tableLayout); >>