如何使用外部Javascript库(如jQuery)重命名Google Closure样式表?

时间:2012-09-04 17:08:56

标签: javascript jquery google-closure-compiler google-closure-library google-closure-stylesheet

我正在研究Google的样式表重命名功能,我不知道如何重写我的jquery选择器。我没有发现 doc 非常清楚。

如果我有一些看起来像这样的代码:

<div class="MyClass"></div>
<div id="MyID"></div>

$('.MyClass').someFunc();
$('#MyID').someFunc();

如何编写HTML和javascript以便CSS重命名可以工作?

感谢您的建议。

1 个答案:

答案 0 :(得分:20)

要使Closure-stylesheets与jQuery等外部库结合使用,您还需要使用Closure-library来添加对goog.getCssName的支持。但是,因为编写Closure-Library是为了最大限度地利用Closure-compiler的死代码消除,所以最终输出中只包含非常少量的库代码(在本例中约为1KB)。

第1步 - 设置项目

您需要以下工具:

第2步 - 设置源文件

样式表来源(sample.gss)

@def BG_COLOR              rgb(235, 239, 249);

@def DIALOG_BORDER_COLOR   rgb(107, 144, 218);
@def DIALOG_BG_COLOR       BG_COLOR;

.MyClass {
  background-color: BG_COLOR;
  height:100px;
}

#MyId {
  background-color: DIALOG_BG_COLOR;
  border: 1px solid DIALOG_BORDER_COLOR;
  height:100px;
}

关闭模板源(sample.soy)

{namespace ClosureSample}

/**
 * SampleHtml
 */
{template .SampleHtml autoescape="false"}
    <div class="{css MyClass}"></div>
{/template}

Javascript来源(sample.js

goog.require('ClosureSample');
document.write(ClosureSample.SampleHtml());

$(function() {
    $('.' + goog.getCssName('MyClass')).css('background-color', 'pink');
});

HTML源代码(development.htm

<!DOCTYPE html>
<html>
<head>
  <title>Closure stylesheets with External Library</title>
  <link rel="Stylesheet" media="all" href="sample.css" />
  <script type="text/javascript" src="sample_renaming_map.js"></script>
  <script type="text/javascript" src="http://closure-library.googlecode.com/svn/trunk/closure/goog/base.js"></script>
  <script type="text/javascript">
    goog.require('goog.soy');
    goog.require('goog.string.StringBuffer');
  </script>
  <script type="text/javascript" src="soyutils_usegoog.js"></script>
  <script type="text/javascript" src="sample-templates.js"></script>
  <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
</head>
<body>
  <script type="text/javascript" src="sample.js"></script>
  <div id="MyId"></div>
</body>
</html>

第3步 - 编译样式表和模板

使用从模板和样式表项目下载的工具,您需要编译sample.gsssample.soy文件。以下是此示例使用的命令:

java -jar closure-stylesheets.jar \
    --pretty-print \
    --output-file sample.css \
    --output-renaming-map-format CLOSURE_UNCOMPILED \
    --rename CLOSURE \
    --output-renaming-map sample_renaming_map.js \
    sample.gss

java -jar SoyToJsSrcCompiler.jar \
    --shouldProvideRequireSoyNamespaces \
    --shouldGenerateJsdoc \
    --outputPathFormat {INPUT_FILE_NAME_NO_EXT}.js \
    --cssHandlingScheme goog \
    sample.soy

使用这些文件,您可以在开发期间测试重命名。 See the example

第4步 - 编译生产项目

首先使用“CLOSURE_COMPILED”选项重新编译样式表以生成重命名映射:

java -jar closure-stylesheets.jar \
    --output-file sample.css \
    --output-renaming-map-format CLOSURE_COMPILED \
    --rename CLOSURE \
    --output-renaming-map sample_renaming_map.js \
    sample.gss

然后,您需要计算Closure-library依赖文件,并将所有源javascript文件编译为单个源。

注意:由于jQuery与Closure-compiler的ADVANCED_OPTIMIZATIONS不兼容,因此它不会作为输入包含在内。相反,请参考jQuery extern file文件夹中找到的相应Closure-compiler contrib/externs

Closure-library项目中的calcdeps.py脚本也可用于在它确定的输入文件上调用Closure-compiler。

python calcdeps.py \
    -i sample.js \
    -p PATH_TO_CLOSURE_LIBRARY_FOLDER \
    -p sample-templates.js \
    -o compiled \
    -c compiler.jar \
    -f --js=sample_renaming_map.js
    -f --compilation_level=ADVANCED_OPTIMIZATIONS \
    -f --warning_level=VERBOSE \
    -f --externs=jquery-1.7-externs.js \
    -f --js_output_file=sample_compiled.js

查看最终结果:compiled version

最终笔记

正如您所看到的,使用Google Closure Stylesheets不仅需要完整的Closure-tools套件,而且还需要参与其中。

  • 输出HTML所需使用的Google Closure模板。在这个人为的例子中,我使用document.write调用来输出正确重命名的类,但是生成代码有更优雅和可维护的技术。
  • Closure-stylesheets不会重命名ID选择器,因此ID的代码不会受到影响。
  • 为了便于查看,已编译的示例引用了Google CDN之外的jQuery库。但是,将jQuery库和编译后的源连接到单个源JS文件中同样有效。