mirror of
https://github.com/react/react-native-devtools-frontend.git
synced 2026-09-30 01:07:01 +08:00
The component server needs to inject CSS and JS scripts into each example. It was doing this by relying on a <style> and <script> tag as the hook to inject more code. But if you have an example without a <style> or <script> tag, it won't work. Instead we now inject based on the </head> and </body> tags, which will always exist (or, if they don't, we have bigger problems!) Bug: None Change-Id: Id2f586c917ee7ab0821d5ab8e50e5cd3d3647a92 Reviewed-on: https://chromium-review.googlesource.com/c/devtools/devtools-frontend/+/2815131 Commit-Queue: Jack Franklin <jacktfranklin@chromium.org> Commit-Queue: Tim van der Lippe <tvanderlippe@chromium.org> Auto-Submit: Jack Franklin <jacktfranklin@chromium.org> Reviewed-by: Tim van der Lippe <tvanderlippe@chromium.org>
Components dev server
This server serves up examples of the web components built within DevTools and provides a useful way to document various states of components.
For more background, see the initial proposal and design doc.
To add an example for your component:
- Create
front_end/component_docs/DIRwhereDIRis the name of your component. - Within the new
DIR, add HTML and TypeScript files. Each one of these is a standalone example. You should name the HTML file based on what it's documenting, e.g.basic.htmlordata-missing.html, and add a TypeScript file with the same name. The TypeScript file should contain all the code to import and run your component, and within the HTML file you can place any HTML or CSS you need (inline style tags are fine for examples) to render the component in the right context. - Create a
BUILD.gnin your newDIR. This should contain the following code:
import("../../../scripts/build/ninja/copy.gni")
import("../../../third_party/typescript/typescript.gni")
ts_library("ts") {
sources = [
"basic.ts"
]
deps = [
# As an example: anything your TS code imports needs to be listed here as a dep.
"../../ui/components:bundle",
]
}
copy_to_gen("elements_breadcrumbs") {
sources = [
"basic.html",
# list all other examples here
]
deps = [
":ts"
]
}
- Update
front_end/component_docs/BUILD.gnto add your new directory'sBUILD.GNto thepublic_depsarray. - Run
npm run components-serverto fire up a server onlocalhost:8090. You should now see your component listed and you can click on the link to view the examples. - Note: the server assumes your built target is
Default. If not, run the server and pass the--targetflag:npm run components-server -- --target=Release.