Trên GitHub, olado/doT đã đạt 5.0k sao, ngôn ngữ JavaScript. The fastest + concise javascript template engine for nodejs and browsers. Partials, custom delimiters and more.
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Created in search of the fastest and concise JavaScript templating function with emphasis on performance under V8 and nodejs. It shows great performance for both nodejs and browsers.
doT.js is fast, small and has no dependencies.
v2 !!!
v2.0.0-beta.1 is released - switching recommended!
See release notes.
To install:
npm install dot@beta
Note from the maintainer
doT is a really solid piece of software engineering (I didn’t create it) that is rarely updated exactly for this reason.
It took me years to grasp how it works even though it’s only 140 lines of code - it looks like magic.
I used it in my other projects (e.g. ajv) as the smallest, the fastest and the most functional (all three!) templating engine ever made, that is particularly useful in all code generation scenarios where manipulating AST is an overkill.
It’s a race car of templating engines - doT lacks bells and whistles that other templating engines have, but it allows to achive more than any other, if you use it right (YMMV).
Features
custom delimiters
runtime evaluation
runtime interpolation
compile-time evaluation
partials support
conditionals support
array iterators
encoding
control whitespace - strip or preserve
streaming friendly
use it as logic-less or with logic, it is up to you
Docs, live playground and samples
http://olado.github.com/doT (todo: update docs with new features added in version 1.0.0)
Node module now supports auto-compilation of dot templates from specified path
var dots = require("dot").process({ path: "./views"});
This will compile .def, .dot, .jst files found under the specified path.
Details
It ignores sub-directories.
Template files can have multiple extensions at the same time.
Files with .def extension can be included in other files via {{#def.name}}
Files with .dot extension are compiled into functions with the same name and
can be accessed as renderer.filename
Files with .jst extension are compiled into .js files. Produced .js file can be
loaded as a commonJS, AMD module, or just installed into a global variable (default is set to window.render)
All inline defines defined in the .jst file are
compiled into separate functions and are available via _render.filename.definename
Basic usage:
var dots = require("dot").process({path: "./views"});
dots.mytemplate({foo:"hello world"});
The above snippet will:
Compile all templates in views folder (.dot, .def, .jst)
Place .js files compiled from .jst templates into the same folder
These files can be used with require, i.e. require("./views/mytemplate")
Return an object with functions compiled from .dot templates as its properties
Render mytemplate template
CLI tool to compile dot templates into js files
./bin/dot-packer -s examples/views -d out/views
Example for express
Many people are using doT with express. I added an example of the best way of doing it examples/express:
doT with express
Notes
doU.js is here only so that legacy external tests do not break. Use doT.js.
doT.js with doT.templateSettings.append=false provides the same performance as doU.js.
Security considerations
doT allows arbitrary JavaScript code in templates, making it one of the most flexible and powerful templating engines. It means that doT security model assumes that you only use trusted templates and you don't use any user input as any part of the template, as otherwise it can lead to code injection.
It is strongly recommended to compile all templates to JS code as early as possible. Possible options:
using doT as dev-dependency only and compiling templates to JS files, for example, as described above or using a custom script, during the build. This is the most performant and secure approach and it is strongly recommended.
if the above approach is not possible for some reason (e.g. templates are dynamically generated using some run-time data), it is recommended to compile templates to in-memory functions during application start phase, before any external input is processed.
compiling templates lazily, on demand, is less safe. Even though the possibility of the code injection via prototype pollution was patched (#291), there may be some other unknown vulnerabilities that could lead to code injection.
Please report any found vulnerabilities to npm, not via issue tracker.
Author
Laura Doktorova @olado
License
doT is licensed under the MIT License. (See LICENSE-DOT)
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/olado/doT là nguồn chính thức.
olado/doT có bao nhiêu sao?
olado/doT có 5.0k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/olado/doT. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
olado/doT có phải mã nguồn mở không?
TopGit chưa ghi nhận license cho olado/doT. Phần lớn repo public trên GitHub là mã nguồn mở, nhưng điều khoản khác nhau từng repo — mở file LICENSE để xác nhận.
olado/doT có tag gì không?
Bản đồng bộ chưa ghi nhận topic GitHub nào cho olado/doT. GitHub topics hiển thị ở thanh bên phải trang repo — đó là nơi đáng kiểm tra nhất.
olado/doT có website riêng không?
TopGit chưa ghi nhận URL trang chủ cho olado/doT. Phần README ở tab phía trên thường có link demo, hoặc xem mô tả GitHub của repo.
olado/doT còn đang phát triển không?
Commit gần nhất trên olado/doT là 3.0 năm trước (theo timestamp GitHub). Repo có 1k fork — một chỉ báo về mức độ quan tâm của cộng đồng.
Đọc đầy đủ README ở tab phía trên.
doT có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về doT.