Библиотека X.Scaffolding

С выходом Visual Studio 2013, ASP.NET MVC 5 и Entity Framework 6 возможности скаффолдинга встроенные в Visual Studio стали еще лучше. Однако до сих пор создавая новое веб-приложение приходится делать много действий, которые можно было бы автоматизировать.
Поэтому для себя и разработчиков с которыми я работаю был создан пакет X.Scaffolding позволяющий более продуктивно создавать веб-приложения. Именно на основе этого пакета у нас сейчас разрабатывается большинство новых веб-приложений для работы с данными.

Сегодня же я решил поделится этим проектом и с читателями Хабрахабра. Возможно кому-то он покажется интересным и поможет в его работе, а кто-то и сам захочет поучаствовать в его развитии.

Как известно, Visual Studio предоставляет огромное количество функций, которые позволяют автоматизировать рутинные операции и сосредоточится на основных задачах. Одной из таких удобных и достаточно востребованных функций является возможность генерации форм редактирования для сущностей базы данных. Появилась эта функция уже давно, но с релизом Visual Studio 2013 стала и интеграцией в базовый шаблон приложения фреймворка bootstrap стала на мой взгляд еще удобнее. Но как известно — пределу нет совершенства.

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

Кроме того, не все типы данных сейчас поддерживаются стандартными расширениями. Например сейчас во многих моих проектах очень часто используются возможности пакета для создания HTML-редактора, календаря и предпросмотра видео.

Расширения

Ключевую роль в библиотеке играет класс Extensions, содержащий методы-расширений для HtmlHelper):

• HtmlEditorFor — отображает редактор HTML на основе CKEditor 4
• DatePickerFor — отображает bootstrap-style календарь
• FileUploadFor — отображает элемент для загрузки файла
• ThumbnailFor — отображает bootstrap-style prview для изображения
• TextEditorFor — отображает bootstrap-style редактор
• MultilineTextEditorFor — отображает многострочный bootstrap-style редактор
• EmailEditorFor — отображает bootstrap-style редактор, который имеет HTML5 тип email
• VideoPlayerEditorFor — отображает плеер если в поле записан url для видео опубликованного в YouTube, или Vimeo

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

Структура пакета

После установки NuGet-пакета X.Scaffolding в Ваше веб-приложение добавятся такие элементы как:

• Contentglobal.css — содержит основные стили для веб-приложения (за основу брался Modern UI ^[1])
• Contentscaffolding.css — содержит стили для отдельных элементов управления генерируемых системой скаффолдинга ASP.NET MVC
• Scriptsscaffolding.js — содержит общие для всего веб-приложения скрипты для инициализации подключаемых плагинов
• ViewsSystemLogin.cshtml — шаблон страницы авторизации
• Views_ViewStart.cshtml — страница для автоматического задания шаблона для всех представлений в проекте
• favicon.ico — фирменная иконка

Модуль авторизации

Модуль авторизации выполнен на основе шаблона ^[2] с сайта bootsnipp.com

Кроме файлов добавляемым непосредственно пакетом X.Scaffolding в проект также добавляются некоторые другие пакеты и связанные с ними файлы. Рассмотрим их более детально.

Подключаемые пакеты NuGet

• X.CKEditor ^[3] — WYSIWYG-редактор, для редактирования HTML (поскольку команда CKEditor еще не выпустила официальный NuGet пакет для 4 версии, то я сам решил это сделать)
• chosen.jquery ^[4] — плагин для оформления красивых и удобных выпадающих списков с поиском. Более подробно рассматривается в статье ^[5], которую написал alizar ^[6]
• Bootstrap Datepicker ^[7] — плагин, который позволяет добавлять элементы выбора даты в стиле Bootstrap
• Microsoft ASP.NET MVC 5 ^[8] — поскольку библиотека в первую очередь рассчитана на расширение актуальной версии MVC, то была добавлена ссылка именно на эту версию
• EntityFramework 6 ^[9] — то же касается и Entity Framework
• Windows Azure Storage ^[10] — набор библиотек позволяющих удобнее работать с веб-приложениями размещенными в облаке
• Bootstrap 3 ^[11] — думаю не стоит представлять этот фреймворк, тем более что начиная с Visual Studio 2013 базовый проект создается с уже подключенным пакетом bootstrap
• PagedList.Mvc ^[12] — библиотека, которая позволяет с легкостью разбивать списки на «страницы». Кроме того, включает стили и код для реализации пейджинга в разметке шаблонов
• Microsoft jQuery Unobtrusive Validation ^[13] — пакет для «ненавязчивой» валидации. Более подробно про него можно почитать в статье ^[14] которую написала Juty ^[15]

Присоединяйтесь!

Все желающие могут как ознакомится с исходным кодом библиотеки, так и расширить ее возможности.
Исходные коды проекта доступны на GitHub ^[16].

NuGet

Установить пакет можно из репозитория NuGet ^[17]: Install-Package xscaffolding

Автор: Ernado

Источник ^[18]