feat(templs): more banners

Author: fiji-flo

crates/rari-doc/src/templ/templs/banners.rs

@@ -0,0 +1,74 @@
+use rari_templ_func::rari_f;
+use rari_types::AnyArg;
+use tracing::warn;
+
+use crate::error::DocError;
+
+#[rari_f]
+pub fn deprecated_header(version: Option<AnyArg>) -> Result<String, DocError> {
+    if version.is_some() {
+        warn!("Do not use deprectaed header with parameter!")
+    }
+    let title = rari_l10n::l10n_json_data("Template", "deprecated_badge_abbreviation", env.locale)?;
+    let copy = rari_l10n::l10n_json_data("Template", "deprecated_header_copy", env.locale)?;
+
+    Ok([
+        r#"<div class="notecard deprecated"><strong>"#,
+        title,
+        ":</strong> ",
+        copy,
+        "</div>",
+    ]
+    .join(""))
+}
+
+#[rari_f]
+pub fn available_in_workers(typ: Option<String>) -> Result<String, DocError> {
+    let default_typ = "available_in_worker__default";
+    let typ = typ
+        .map(|s| s.to_lowercase())
+        .map(|typ| format!("available_in_worker__{typ}"));
+    let copy = rari_l10n::l10n_json_data(
+        "Template",
+        typ.as_deref().unwrap_or(default_typ),
+        env.locale,
+    )
+    .unwrap_or(rari_l10n::l10n_json_data(
+        "Template",
+        default_typ,
+        env.locale,
+    )?);
+
+    Ok([r#"<div class="notecard note"><p> "#, copy, "</p></div>"].join(""))
+}
+
+#[rari_f]
+pub fn see_compat_table() -> Result<String, DocError> {
+    let title =
+        rari_l10n::l10n_json_data("Template", "experimental_badge_abbreviation", env.locale)?;
+    let copy = rari_l10n::l10n_json_data("Template", "see_compat_table_copy", env.locale)?;
+
+    Ok([
+        r#"<div class="notecard experimental"><strong>"#,
+        title,
+        ":</strong> ",
+        copy,
+        "</div>",
+    ]
+    .join(""))
+}
+
+#[rari_f]
+pub fn secure_context_header() -> Result<String, DocError> {
+    let title = rari_l10n::l10n_json_data("Template", "secure_context_label", env.locale)?;
+    let copy = rari_l10n::l10n_json_data("Template", "secure_context_header_copy", env.locale)?;
+
+    Ok([
+        r#"<div class="notecard secure"><strong>"#,
+        &html_escape::encode_double_quoted_attribute(title),
+        ":</strong> ",
+        copy,
+        "</div>",
+    ]
+    .join(""))
+}

crates/rari-doc/src/templ/templs/mod.rs

@@ -1,5 +1,6 @@
 pub mod apiref;
 pub mod badges;
+pub mod banners;
 pub mod compat;
 pub mod cssinfo;
 pub mod csssyntax;
@@ -10,7 +11,6 @@ pub mod listsubpages;
 pub mod livesample;
 pub mod quick_links_with_subpages;
 pub mod secure_context;
-pub mod seecompattable;
 pub mod specification;
 
 use rari_types::globals::deny_warnings;
@@ -44,10 +44,14 @@ pub fn invoke(
         "deprecated_inline" => badges::deprecated_any,
         "optional_inline" => badges::optional_any,
         "readonlyinline" => badges::readonly_any,
-        "seecompattable" => seecompattable::see_compat_table_any,
-        "securecontext_header" => secure_context::secure_context_header_any,
         "securecontext_inline" => secure_context::secure_context_inline_any,
 
+        //banners
+        "seecompattable" => banners::see_compat_table_any,
+        "securecontext_header" => banners::secure_context_header_any,
+        "availableinworkers" => banners::available_in_workers_any,
+        "deprecated_header" => banners::deprecated_header_any,
+
         // links
         "csp" => links::csp::csp_any,
         "rfc" => links::rfc::rfc_any,

crates/rari-doc/src/templ/templs/secure_context.rs

@@ -16,18 +16,3 @@ pub fn secure_context_inline() -> Result<String, DocError> {
     ]
     .join(""))
 }
-
-#[rari_f]
-pub fn secure_context_header() -> Result<String, DocError> {
-    let title = rari_l10n::l10n_json_data("Template", "secure_context_label", env.locale)?;
-    let copy = rari_l10n::l10n_json_data("Template", "secure_context_header_copy", env.locale)?;
-
-    Ok([
-        r#"<div class="notecard secure"><strong>"#,
-        &html_escape::encode_double_quoted_attribute(title),
-        ":</strong> ",
-        copy,
-        "</div>",
-    ]
-    .join(""))
-}