\n\n## Introduction\n\nA module that transform HTML into Sketch JSON\n\n## Quick Guide\n\n### Install\n\n```bash\nnpm i html2sketch --save\n```\n\nor\n\n```\nyarn add html2sketch\n```\n\n### Usage\n\n`html2sketch` includes three methods `nodeToLayer` 、 `nodeToGroup` 和 `nodeToSymbol` 。\n\n#### nodeToLayer\n\nthis method transforms a DOM node into Sketch Objects without processing children of nodes\n\n```js\nimport { nodeToLayer } from 'html2sketch';\n\nconst fn = async () => {\n // 1. get DOM node\n const node = document.getElementById('id');\n\n // 2. run nodeToLayer method\n const layer = await nodeToLayer(node);\n\n // 3. generate Sketch JSON\n const sketchJSON = layer.toSketchJSON();\n\n return sketchJSON;\n};\n\nfn().then((json) => {\n console.log(json);\n});\n```\n\n#### nodeToGroup\n\nThis method transforms a DOM node and its children into a Sketch Group Object\n\n```js\nimport { nodeToGroup } from 'html2sketch';\n\nconst fn = async () => {\n // 1. get DOM node\n const node = document.getElementById('id');\n\n // 2. run nodeToGroup method\n const group = await nodeToGroup(node);\n\n // 3. generate Sketch JSON\n const sketchJSON = group.toSketchJSON();\n\n return sketchJSON;\n};\n\nfn().then((json) => {\n console.log(json);\n});\n```\n\n#### nodeToSymbol\n\nThis method transforms a DOM node and its children into a Sketch Symbol Object\n\n```js\nimport { nodeToSymbol } from 'html2sketch';\n\nconst fn = async () => {\n // 1. get DOM node\n const node = document.getElementById('id');\n\n // 2. run nodeToSymbol method\n const symbol = await nodeToSymbol(node);\n\n // 3. generate Sketch JSON\n const sketchJSON = symbol.toSketchJSON();\n\n return sketchJSON;\n};\n\nfn().then((json) => {\n console.log(json);\n});\n```\n\n## What's next step with Sketch JSON?\n\nthe generated Sketch JSON strictly match with [Sketch File Format](https://developer.sketch.com/file-format/) Schema, So you can just synthesize the JSON according to the [Sketch File Format](https://developer.sketch.com/file-format/) into a '. Sketch 'file .\n\nSo the Sketch file can be obtained simply by synthesizing the corresponding JSON into a '. Sketch 'file according to the Sketch file specification\n\nThere is some community modules of synthesizing:\n\n- [sketch-json-api](https://github.com/ant-design/sketch-json-api)\n- [node-sketch](https://github.com/oscarotero/node-sketch)\n- [sketch-constructor](https://github.com/amzn/sketch-constructor)\n\nIf you want to use the JSON object directly in sketch, you can use the [Sketch JSON](https://github.com/arvinxx/sketch-json) Plugin,which will allow you just paste JSON into Sketch.\n\n## Why?\n\nThe main application of this module focus on C2D (Code to Design).This module mainly refers to [html-sketchapp](https://github.com/html-sketchapp/html-sketchapp).\n\nhtml-sketchapp can directly transforms any HTML page into a Sketch document without framework limit, but there are significant limitations:\n\n- **Not supported pseudoelements, overflow,some kind of gradient, transform, and other properties**: As a result, many web pages transformed by html-sketchapp are not visually restored;\n\n- **Although html-sketchapp don't dependent on the framework, it fully dependent on the Sketch App**: Because JSON structure generated by html-sketchapp does not strictly match [Sketch File Format](https://developer.sketch.com/file-format/) ,it can't generate sketch document directly.What's more,it also lead to lacking of the ability to integrate on the server side.\n\n- **html-sketchapp developed by JS ,lacking perfect type definition, the project architecture is not reasonable, the secondary development is difficult**\n\n### What html2sketch do?\n\nhtml2sketch makes a lot of optimization on the basis of html-sketchapp, and takes the essence to discard the dross:\n\n#### Enhancement of parsing ability\n\nhtml2sketch supports most web page styles which is not supported by html-sketchapp, such as pseudo-elements,radial gradient, text overflows, and so on.This is important for transforming result.Perhaps reproducing 80% using html-sketchapp, but 95% or more using html2sketch. Of course, the parsing capability of the module also needs to be improved step by step by covering the parsing scene. If you encounter any incorrect parsing situation under the real word, please be sure to submit an [issue](https://github.com/ant-design/html2sketch/issues), I will solve it as soon as possible. The styles supported by this module are currently available on [解析用例](https://ant-design.github.io/html2sketch/e2e).\n\n#### Decouple from the Sketch App\n\nThe biggest difference at the functional level of html2sketch is its decoupling from the Sketch App.The relevant parsing capabilities (Svg, image, font, and so on) are all built from scratch.\n\nThanks to the JSON generated by html2Sketch will strictly match [Sketch File Format](https://developer.sketch.com/file-format/) , you can directly synthesize it into a legal `.sketch` file by using [sketch-json-api](https://github.com/ant-design/sketch-json-api) or [node-sketch](https://github.com/oscarotero/node-sketch) . Therefore,based on html2sketch, it is possible to parse a web page and generate the Sketch file using any normal server.\n\n#### Development based on Typescript\n\nDeveloped with Typescript makes it a good experience for both consumers and producers.Whether it's in the organization of the project, code comments, or unit testing, there are guarantees.\n\n## Develop\n\nRefer to [Develop Guidelines](https://github.com/ant-design/html2sketch/guide)\n\n## License\n\n[MIT](./LICENSE)\n","_attachments":{},"homepage":"https://github.com/ant-design/html2sketch","bugs":{"url":"https://github.com/ant-design/html2sketch"},"license":"MIT"}
![\"html2sketch\"/](\"https://gw.alipayobjects.com/zos/antfincdn/9qm%24x99yzk/Logo.png\"){kind=logo}
\n \n![](\"https://gw.alipayobjects.com/zos/antfincdn/R8sN%24GNdh6/language.svg\")
English | [简体中文](./README.zh-CN.md)\n\n