18x/README.md

util js for build web site

# 18X

Util js for build web site

**No need add npm package dependencies**

**Import directly in your js**

Before use , you should define import map in HTML

For example [importmap](https://developer.mozilla.org/docs/Web/HTML/Element/script/type/importmap)

```html
<script type="importmap">{"imports":{"x/":"//jsd.cdn.zzko.cn/npm/18x/"}}</script>
```

You can replace `//jsd.cdn.zzko.cn/npm/18x/` as your own CDN in above code

## File

### toast

[`x/toast.js`](https://atomgit.com/i18n/18x/blob/dev/src/toast.coffee)

[`x/toast.css`](https://atomgit.com/i18n/18x/blob/dev/src/toast.css)

<p style="display:flex">
<img width="445" src="https://i-01.eu.org/1717170312.avif"/>
<img width="281" src="https://i-01.eu.org/1717221759.avif"/>
</p>

A notification message pops up in the lower-left corner of the webpage.

When a request using `./f.js` fails, it will call this to display an error message.

### Box

[`x/xBox.js` : pop up box with close button](https://atomgit.com/i18n/18x/blob/dev/src/xBox.coffee)
[`x/box.js` : pop up box style ](https://atomgit.com/i18n/18x/blob/dev/src/box.styl)

screenshot example :

<p style="display:flex">
<img width="300" src="https://i-01.eu.org/1716640762.avif"/>
<img width="425" src="https://i-01.eu.org/1716640899.avif"/>
</p>

[`x/Box.js`](https://atomgit.com/i18n/18x/blob/dev/src/Box.coffee): base pop up box

[`x/htmBox.js`](https://atomgit.com/i18n/18x/blob/dev/src/htmBox.coffee): pop up box with html

[`x/tagBox.js`](https://atomgit.com/i18n/18x/blob/dev/src/tagBox.coffee): create a box , append with the new tag

### Event

[`x/On.js`](https://atomgit.com/i18n/18x/blob/dev/src/On.coffee) : shortcut bind & unbind event with object

### Text

[`x/utf8d.js`](https://atomgit.com/i18n/18x/blob/dev/src/utf8d.coffee) decode utf8 from Uint8Array

[`x/bintxt.js`](https://atomgit.com/i18n/18x/blob/dev/src/bintxt.coffee) decode string from [utf8] concat by 0

### Net

[`x/f.js`](https://atomgit.com/i18n/18x/blob/dev/src/f.js)

* fTxt : fetch url and return string
* fJson : fetch url and return json
* fBin.js : fetch url and return Uint8Array

[`x/fBintxt.js`](https://atomgit.com/i18n/18x/blob/dev/src/fBintxt.js) fetch url and decode via bintxt

[`x/fBinPrefix.js`](https://atomgit.com/i18n/18x/blob/dev/src/fBinPrefix.js) return fBin func with binded prefix


### I18N

[`x/lang.js`](https://atomgit.com/i18n/18x/blob/dev/src/lang.coffee)

* init : detect current language by _LANG_URL & _LANG & localStorage.LANG or navigator.language
* set : set language
* onSet : hook when language change

[`x/langSite.js`](https://atomgit.com/i18n/18x/blob/dev/src/langSet.coffee) hook when site lang file fetched

[`x/langHook.js`](https://atomgit.com/i18n/18x/blob/dev/src/langHook.coffee) create your own hook for get different lang file

### Tag

[`x/i-h.js`](https://atomgit.com/i18n/18x/blob/dev/src/i-h.js) html tag generator from _H ( `<i-h>foot</i-h>` -> `_H.foot()` ),will auto refresh when lang change

### Channel

#### [`initC.js`](https://atomgit.com/i18n/18x/blob/dev/src/initC.js)

init channel and generate function

* send (kind, ...msg) → channel
* hook (kind, ...msg) → unhook function

wrap Broadcast & SharedWorker by init channel

#### Broadcast

[`x/BC.js`](https://atomgit.com/i18n/18x/blob/dev/src/BC.js)

#### SharedWorker

[`x/share.js`](https://atomgit.com/i18n/18x/blob/dev/src/share.js)

### Service Worker

use `./serviceWorker.build.coffee` generate service worker S.js from `./serviceWorker`

### SVG

[svg](https://atomgit.com/i18n/18x/tree/dev/svg)

use [svgVar.coffee](https://atomgit.com/i18n/18x/tree/dev/svgVar.coffee) generate [svg.css](https://registry.npmmirror.com/18x/latest/files/svg.css) with inline svg var

#### CSS

[`_.css`](https://atomgit.com/i18n/18x/blob/dev/src/_.css) css on in one

```
@import "//cdn.jsdelivr.net/npm/18x/_.css"
```

[`reset.css`](https://atomgit.com/i18n/18x/blob/dev/src/reset.styl) reset css

### Route

[x/route.js](//atomgit.com/i18n/18x/blob/dev/src/route.coffee) 路径 - 回调函数 ( func(url, PRE) )
* setUrl 设置浏览器网址不触发路由事件 ( 比如用于多文件的目录章节导航 )
* goto.js 设置浏览器网址并触发路由事件

[x/Match.js](//atomgit.com/i18n/18x/blob/dev/src/Match.coffee) 路由匹配, 用法如:

```svelte
<template lang="pug">
Topbar
  TopbarR
<svelte:component this="{M}"/>
</template>

<script lang="coffee">
> @8p/nav:
  @8p/h404:H404
  @8p/topbar:Topbar
  @8p/wait:Wait
  svelte > tick
  ./TopbarR.svelte
  x/route.js
  x/Match.js

M = Wait

page = (m)=>
  M = Wait
  await tick()
  M = m
  return

match = Match(
  page
  =>
    M = H404
    return
)

route (url)=>
  match url
  return

onI18n =>
  match location.pathname.slice(1)
  return
</script>
```
[x/selfA.js](//atomgit.com/i18n/18x/blob/dev/src/selfA.coffee) 判断A标签的href是否为当前网站的, 如果是, 返回url, 以实现不刷新跳转
[x/a.js](//atomgit.com/i18n/18x/blob/dev/src/a.coffee) 监听所有的A标签, 当点击时, 如果是当前网站的路径, 则阻止默认事件并触发路由(`goto`) , 如果是外站路径, 自动添加 `target="_blank"`
[x/forceGoto.js](//atomgit.com/i18n/18x/blob/dev/src/forceGoto.coffee) 强制刷新(因为当网址不变的时候默认不刷新, 会导致比如支付成功的跳转不成功, 这时候就需要强制刷新, 参见 [pay/src/TopUp.svelte](https://atomgit.com/i18n/plugin/blob/dev/pay/src/TopUp.svelte)



### I18N.SITE

#### global variable

[`x/_.js`](https://atomgit.com/i18n/18x/blob/dev/src/_.js)

fJson / fMd : use _fp get real url, then fetch, return 0 if can't find the real url

USE / MENU : hook form page or menu

## About Us

[i18n.site](https://i18n.site)