LOCALIZATION

Если значение атрибута начинается с «@», MarkupKit пытается найти локализованную версию значения перед установкой свойства. Например, если приложение определило локализованное приветствие в  Localizable.strings  следующим образом:

"hello" = "Hello, World!";

следующая разметка создаст экземпляр  UILabel со значением его textсвойства, равным  «Hello, World!»:

<UILabel text="@hello"/>

В дополнение к глобальным значениям, определенным в  Localizable.strings ,  strings инструкция обработки (PI) может использоваться для определения набора локальных строковых значений, которые видны только текущему документу. Это может помочь упростить управление локализованными ресурсами, поскольку они могут быть разбиты на несколько небольших контекстно-зависимых частей, а не на один большой набор строковых значений в масштабах всего приложения.

ЗАБРОНИРОВАННЫЕ АТРИБУТЫ

Некоторые атрибуты имеют особое значение в MarkupKit и не представляют свойства представления. К ним относятся  стиль ,  класс и  идентификатор . Атрибут «style» используется для вызова «фабричного метода» для создания экземпляра представления. Атрибут «class» указывает набор свойств шаблона, которые применяются к экземпляру, похожему на стили в CSS. Атрибут «id» используется, чтобы определить «выход» для представления, подобного выходам в XCode.

Кроме того, атрибуты, имя которых начинается с «on», зарезервированы. За исключением существующих свойств, имена которых начинаются с «on», эти атрибуты представляют обработчики событий или «действия», аналогичные действиям в Xcode.

Каждый из зарезервированных типов атрибутов обсуждается более подробно ниже.

ЗАВОДСКИЕ МЕТОДЫ

Атрибут «style» используется для создания экземпляров представления определенного типа или «style». Большинство типов UIKit можно создать, вызвав новый метод для типа; однако некоторые типы требуют использования специального метода конструирования. Например,  UIButtonэкземпляры создаются с использованием  buttonWithType: метода  UIButton класса, а UITableView экземпляры инициализируются с помощью  метода initWithFrame:styleno-arg,  initкоторый вызывается  new.

Для обработки этих случаев MarkupKit поддерживает специальный атрибут с именем «style». Значение этого атрибута представляет имя «фабричного метода», метода с нулевым аргументом, который создает экземпляры данного типа. MarkupKit добавляет фабричные методы к классам, таким как  UIButton и,  UITableView чтобы позволить этим типам быть построенными в разметке.

Например, следующая разметка создает экземпляр «системного стиля»  UIButton:

<UIButton  normalTitle="Press Me!"/>

Обратите внимание на имя атрибута, который используется для установки заголовка кнопки. Стандартный UIButton класс не определяет свойство с именем  normalTitle, а определяет setTitle:forState: метод. Однако такие методы не совместимы с KVC и не могут быть вызваны напрямую через разметку. MarkupKit добавляет ряд свойств UIButton и других похожих классов, которые делегируют эти методы и позволяют настраивать их соответствующие типы в разметке.

СВОЙСТВА ШАБЛОНА

Часто при создании пользовательского интерфейса один и тот же набор значений свойств применяется повторно к экземплярам данного типа. Например, разработчик приложения может пожелать, чтобы все кнопки имели одинаковый внешний вид. Хотя можно просто дублировать определения свойств для каждого экземпляра кнопки, это повторяется и не позволяет легко модифицировать дизайн позже — каждый экземпляр кнопки должен быть расположен и изменен индивидуально, что может быть трудоемким и подверженным ошибкам ,

MarkupKit позволяет разработчикам абстрагировать общие наборы определений свойств в «шаблоны», которые затем можно применять по именам к экземплярам классов. Это значительно упрощает назначение общих свойств и их последующее изменение.

Шаблоны свойств определяются в файлах списка свойств (или  .plist ). Каждый шаблон представлен словарем, определенным на верхнем уровне списка свойств. Содержимое словаря представляет значения свойств, которые будут установлены при применении шаблона.

Шаблоны добавляются в документ MarkupKit с использованием инструкции по обработке свойств (PI). Например, следующий PI импортирует все шаблоны, определенные MyStyles.plist  в текущий документ:

<?properties MyStyles?>

Шаблоны применяются к экземплярам классов с использованием зарезервированного атрибута «класс». Значение этого атрибута относится к имени шаблона, определенного списком свойств. Все значения свойств, определенные шаблоном, применяются к экземпляру класса. Вложенные свойства, такие как titleLabel.font, поддерживаются шаблонами свойств.

Например, если  MyStyles.plist  определяет словарь с именем «label.greeting», который содержит следующие значения (для ясности сокращенно):

"label.greeting": {
    "font": "Helvetica 24"
    "textAlignment": "center"
}

<UILabel class="label.greeting" text="Hello, World!"/>

<LMTableView>
    <LMTableViewCell>
        <UITextField id="textField" placeholder="Type something"/>
    </LMTableViewCell>
</LMTableView>

@property (weak, nonatomic) UITextField *textField;

weak var textField: UITextField!

<UIButton  normalTitle="Press Me!" 
    onTouchUpInside="handleButtonTouchUpInside:"/>

<?xml version="1.0" encoding="UTF-8"?>

<?properties Styles?>

<LMColumnView layoutMargins="16" backgroundColor="#ffffff">
    <LMRowView layoutMargins="12" backgroundColor="#eeeeee">
        <UITextField id="nameField" placeholder="@name"/>
    </LMRowView>

    <UIButton  normalTitle="@sayHello" onTouchUpInside="showGreeting"/>

    <UILabel id="greetingLabel" class="label.greeting"/>

    <LMSpacer/>
</LMColumnView>

"label.greeting": {
    "font": "System-Bold 24"
    "textColor": #00aa00
    "textAlignment": "center"
}

weak var nameField: UITextField!
weak var greetingLabel: UILabel!

"name" = "Name";
"sayHello" = "Say Hello";
"unknownName" = "I don't know your name!";
"greetingFormat" = "Hello, %1$@!";

func showGreeting() {
    let name = nameField.text
    let mainBundle = NSBundle.mainBundle()

    let greeting: String;
    if (name.isEmpty) {
        greeting = mainBundle.localizedStringForKey("unknownName", value: nil, table: nil)
    } else {
        greeting = String(format: mainBundle.localizedStringForKey("greetingFormat", value: nil, table: nil), name)
    }

    greetingLabel.text = greeting
}