Программирование на языке Ruby, Фултон Хэл

Программирование на языке Ruby

на обложку

Фултон Хэл

Шрифт:

Если вы создаете сайт с одной-двумя страницами, не так уж важно, повторяются ли многократно одна и та же разметка и текст. Но когда страниц больше, обновлять все одинаковые фрагменты вручную становится утомительно и чревато ошибками. Nitro помогает следовать принципу DRY (Don't Repeat Yourself — «Не повторяйся»), предлагая целый ряд способов повторного использования.

Простейший из них — включение файла. Пусть, например, все страницы должны иметь общий хвостовик. Можно было бы поместить его в отдельный файл шаблона и включить во все страницы, как показано ниже:

<?include href='/footer' ?>

Сам файл

footer.xinc

мог бы выглядеть, к примеру, так:

<div id='footer'>Read More Ruby Books</div>

Если в качестве значения атрибута

href

указан относительный путь, Nitro будет просматривать папки

template

, определенные для текущего контроллера. Если же путь абсолютный, то просматривается только папка

template

в корневом каталоге приложения.

Показанный выше способ лучше всего подходит для статического контента. Существует и иной синтаксис включения, позволяющий вставить указанный файл в вызывающий шаблон непосредственно перед компиляцией шаблона:

Результат получается таким, как если бы включаемый текст был частью вызывающего шаблона.

Более сложная форма включения контента связана с элементом

render

render href='/controller/action' />

где

href

— некий путь в каталоге приложения.

Процедура компиляции при включении частичных видов с помощью

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

В Nitro граница между кодом шаблона и кодом на Ruby размыта. Один из примеров мы уже приводили: действие контроллера может быть «размазано» между методом и файлом шаблона, а может целиком входить туда или сюда. Другой пример — элементы Nitro (Nitro Elements), способ инкапсуляции кода и разметки в нестандартном теге, который можно использовать в видах.

Вместо того чтобы определять в каждом виде HTML-разметку всей страницы, мы можем определить общий HTML-код и повторно использовать его в различных действиях. Создадим файл

element/layout.xhtml

<html>

<head>

<title>#{@title}</title>

<style>

body {

background-соlor: white; font-family: sans-serif;

}

</style>

</head>

#{content}

</html>

Теперь воспользуемся новым элементом в файле

template/books/find.xhtml

<h1>#{@title}</h1>

<h2>#{@author}</h2>

Page last updated: #{@last_update}

</Layout>

Все содержимое элемента

Layout

вставляется в переменную

content

в файле

layout.xhtml

. Элементы могут принимать параметры; атрибут title в открывающем теге

Layout

становится значением переменной экземпляра

@title

в файле

layout.xhtml

Вам это напоминает вызов метода с передачей ему аргументов? Так оно и есть. Мы можем определить разметку в виде класса Ruby (

src/element/layout2.rb

require 'nitro/element'

class Layout2 < Nitro::Element

def render

%^<html>

<head>

<title>#{@title}</title>

<style>

body {

background-color: white; font-family: sans-serif;

}

</style>

</head>

#{content}

</html>^

end

А затем изменим файл

find.xhtml

, воспользовавшись элементом

Layout2

(нужно еще будет затребовать класс нового элемента в файле

run.rb

). Элементы могут содержать другие элементы, так что виды можно собирать из повторно используемых компонентов.

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

Такой вид повторного использования называется частью. Часть (part) — это, по существу, мини-сайт, реализующий одну конкретную функцию. (В дистрибутив Nitro входит одна такая часть под названием

Admin

.) Код в таком подсайте не нуждается в отдельном файле

run.rb

, хотя включать его полезно, если вы хотите, чтобы часть могла выполняться автономно в демонстрационных целях.

Естественно, части хранятся в папке

part

. Пусть имеется некий код аутентификации пользователя, который можно использовать повторно. Тогда дерево частей приложения могло бы выглядеть так: