css inline загрузка - css inline исходный код скачать

css inline

Другой исходный код

0.14.3

Скачать

CSS-Inline

css_inline -это высокоэффективная библиотека для внедрения CSS в атрибуты стиля HTML.

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

Например, ящик преобразует HTML, как это:

 <html>
  <head> <style> H1 {Color: Blue; } </style>
  </head>
  <body> <h1> Большой текст </h1>
  </body> </html>

в:

 <html>
  <Head> </head>
  <body> <h1 style = "color: blue;"> Большой текст </h1>
  </body> </html>

Использует надежные компоненты из сервопривода Mozilla
Встроенные CSS из тегов style и link
Удаляет теги style и link
Разрешает внешние таблицы стилей (включая локальные файлы)
По желанию кэширует внешние таблицы стилей
Работает на Linux, Windows и MacOS
Поддерживает HTML5 и CSS3
Привязки для Python, Ruby, JavaScript, C и модуля Webassembly для работы в браузерах.
Интерфейс командной строки

Детская площадка

Если вы хотите попробовать css-inline , вы можете проверить игровой площадку с мощностью WebAssembly, чтобы мгновенно увидеть результаты.

Установка

Чтобы включить его в свой проект, добавьте следующую строку в раздел «Зависимости» в файле вашего проекта Cargo.toml :

 [зависимости] css-inline = "0,14"

Минимальная поддерживаемая версия ржавчины составляет 1,65.

Использование

 const html: & str = r#"<html> <head> <style> h1 {color: blue;} </style> </head> <body> <h1> Большой текст </h1> </body> </ html> "#; fn main () -> css_inline :: result <()> {let inlined = css_inline :: inline (html)?; // do Что -то с вставленным HTML, например, отправить emailok (())}}}}}

Обратите внимание, что css-inline автоматически добавляет отсутствующие html и теги body , поэтому вывод является допустимым документом HTML.

В качестве альтернативы, вы можете внедрить CSS в фрагмент HTML, сохраняя исходную структуру:

 Const Fragment: & str = r#"<main> <h1> hello </h1> <section> <p> Кто я </p> </section> </main>"#; const css: & str = r# "p {color: red;} h1 {color: blue;}"#; fn main () -> css_inline :: result <()> {let Inlined = css_inline :: inline_fragment (fragment, css)?; ok (())}

Конфигурация

css-inline может быть настроен с помощью CSSInliner::options() , который реализует шаблон застройщика:

 const html: & str = "..."; fn main () -> css_inline :: result <()> {letiner = css_inline :: cssinliner :: options (). = inliner.inline (html)?; // Сделайте что -нибудь с вставленным HTML, например, отправьте emailok (())}

inline_style_tags . Указывает, следует ли внедрять CSS из тегов «стиль». По умолчанию: true
keep_style_tags . Определяет, следует ли сохранить теги «стиль» после внедрения. По умолчанию: false
keep_link_tags . Определяет, следует ли сохранить теги "ссылки" после внедрения. По умолчанию: false
base_url . Базовый URL используется для разрешения относительных URL -адресов. Если вы хотите загрузить таблицы стилей из вашей файловой системы, используйте схему file:// . По умолчанию: None
load_remote_stylesheets . Определяет, следует ли загружать дистанционные таблицы стилей. По умолчанию: true
cache . Определяет кэш для внешних таблиц стилей. По умолчанию: None
extra_css . Дополнительные CSS будут встроены. По умолчанию: None
preallocate_node_capacity . Передовой . Предварительные ленты для HTML -узлов во время анализа. Это может улучшить производительность, когда у вас есть оценка количества узлов в вашем HTML -документе. По умолчанию: 32

Вы также можете пропустить CSS, внедренные для тега HTML, добавив атрибут data-css-inline="ignore" :

 <голова>
  <style> H1 {цвет: синий; } </style> </head> <body>
  <!-тег ниже не получит дополнительных стилей->
  <h1 data-css-inline = "игнорировать"> Большой текст </h1> </body>

Атрибут data-css-inline="ignore" также позволяет пропустить link и теги style :

 <голова>
  <!-Стили ниже игнорируются->
  <стиль data-css-inline = "игнорировать"> h1 {color: blue; } </style> </head> <body>
  <h1> Большой текст </h1> </body>

В качестве альтернативы, вы можете удержать style от удаления, используя атрибут data-css-inline="keep" . Это полезно, если вы хотите сохранить запросы @media для адаптивных электронных писем в отдельных тегах style :

 <голова>
  <!-стили ниже не удалены->
  <стиль data-css-inline = "Keep"> H1 {Color: Blue; } </style> </head> <body>
  <h1> Большой текст </h1> </body>

Такие теги будут храниться в полученном HTML, даже если опция keep_style_tags установлена на false .

Если вы хотите загрузить таблицы стилей из вашей файловой системы, используйте схему file:// :

 const html: & str = "..."; fn main () -> css_inline :: result <()> {let base_url = css_inline :: url :: parse ("file: // email/emike/"). ("Неверный URL"); пусть Inliner = css_inline :: cssinliner :: options (). base_url (некоторые (base_url)). build (); let Inliced = inliner.inline (html); // Сделать что -нибудь с вставленным html, например, Отправить emailok (())}}}}}}}}}}}}

Для разрешения удаленных таблиц стилей можно реализовать пользовательский резолювер:

 #[derive (debug, default)] Pub struct customstylesheetresolver; Impl css_inline :: styleSheetResolver для CustomStylesheetResolver Не поддерживается "))}} fn main () -> css_inline :: result <()> {let inliner = css_inline :: cssinliner :: options (). Resolver (std :: sync :: arc :: new (CustomStyLesheetResolver)). Build (); OK (()) }

Вы также можете кэшировать внешние таблицы стилей, чтобы избежать чрезмерных сетевых запросов:

 Используйте std :: num :: nonzecysize;#[cfg (feature = "stylesheet -cache")] fn main () -> css_inline :: result <()> {letiner = css_inline :: cssinliner :: options (). кэш (// это LRU cachecss_inline :: styleSheetCache :: new (nonzEnceedize :: new (5) .expect ("Размер недействительного кэша"))). Build (); OK (())} // Этот блок здесь для тестирования#[cfg (()} // этот блок#[cfg () NOT (feature = "styleShie -cache"))] fn main () -> css_inline :: result <()> {Хорошо(())}

Кэширование отключено по умолчанию.

Производительность

css-inline , как правило, внедряет HTML-электронные письма в пределах сотен микросекунд, хотя результаты могут варьироваться в зависимости от сложности ввода.

Тесты для css-inline==0.14.1 :

Базовый: 6,44 мкс , 230 байтов
Реалистичный-1: 128,59 мкс , 8,58 КБ
Реалистично-2: 81,44 мкс , 4,3 КБ
GitHub Page: 224,89 мс , 1,81 МБ

Эти тесты, проведенные с использованием rustc 1.78 на M1 Max, можно найти в css-inline/benches/inliner.rs .

Интерфейс командной строки

Установка

Установите с помощью cargo :

cargo install css-inline

Использование

Следующая команда внедряет CSS в нескольких документах параллельно. Полученные файлы будут сохранены как inlined.email1.html и inlined.email2.html :