Программирование на языке Ruby
вернуться

Фултон Хэл
Шрифт:

Вместо того чтобы определять в каждом виде 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
:

<Layout title='Details for #{@title}'>

 <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

end

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

find.xhtml
, воспользовавшись элементом
Layout2
(нужно еще будет затребовать класс нового элемента в файле
run.rb
). Элементы могут содержать другие элементы, так что виды можно собирать из повторно используемых компонентов.

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

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

Admin
.) Код в таком подсайте не нуждается в отдельном файле
run.rb
, хотя включать его полезно, если вы хотите, чтобы часть могла выполняться автономно в демонстрационных целях.

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

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

<app_root>/part/users

<app_root>/part/users.rb

<app_root>/part/users/public/

<app_root>/part/users/controller.rb

<app_root>/part/users/model/user.rb

<app_root>/part/users/model/acl.rb

<app_root>/part/users/template/login.xhtml

<app_root>/part/users/template/form.xinc

<app_root>/part/users/run.rb

Главный файл

run.rb
мог бы включить такую часть с помощью одной директивы
require
:

require 'part/users'

Теперь Nitro будет рассматривать весь код в каталоге

part/users
, как если бы он находился в дереве исходных текстов главного приложения. Поиск шаблонов начинается в папке template приложения и продолжается в подкаталогах каталога
part
. Если вы хотите переопределить шаблон, поставляемый вместе с частью, то нужно просто поместить замещающий вариант в соответствующий подкаталог папки
template
.