# tingle-context

> Tingle Context

Latest version **1.0.1** (published 2016-01-04) · MIT license · 0 weekly downloads

## Install

```sh
npm install tingle-context
pnpm add tingle-context
yarn add tingle-context
bun add tingle-context
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2016-01-04 |
| First published | 2015-07-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | gnosaij |
| Maintainers | gnosaij, yize |
| Keywords | tingle-context, tingle, mobile-context, h5-context |

## Links

- npm: https://www.npmjs.com/package/tingle-context
- Repository: https://github.com/tinglejs/tingle-context
- Homepage: https://github.com/tinglejs/tingle-context#readme
- Issues: https://github.com/tinglejs/tingle-context/issues
- npm.io page: https://npm.io/package/tingle-context

## Dependencies (1)

- [classnames](https://npm.io/package/classnames.md) ^2.1.2

## Recent versions

- 1.0.1 (latest) — 2016-01-04
- 1.0.0 — 2015-12-16
- 0.1.5 — 2015-11-20
- 0.1.4 — 2015-11-16
- 0.1.3 — 2015-11-11
- 0.1.2 — 2015-09-11
- 0.1.1 — 2015-09-11
- 0.1.0 — 2015-08-25
- 0.0.3 — 2015-07-14

## README

## Context

`tingle`的上下文模块，提供全局性的属性和方法。

### 手势事件去差异

* TOUCH_START：移动端的值是`touchstart`，PC端的值是`mousedown`
* TOUCH_MOVE：移动端的值是`touchmove`，PC端的值是`mousemove`
* TOUCH_END：移动端的值是`touchend`，PC端的值是`mouseup`
* TOUCH_CANCEL：移动端的值是`touchcancel`，PC端的值是`mouseup`

### 是什么环境

* isMobile：boolean，是否是运行在移动端，目前没有区分`pad`，`pad`环境下该值为`true`
* isPC：boolean，是否是运行在PC端

### 是否支持

* support3D：是否支持`css`硬件加速
* supportHairline：是否支持`0.5px`的细线
* supportTouch：是否支持移动端手势

### getTID

获取自增长的`id`

```js
Context.getTID(); // 0
Context.getTID(); // 1
```

### mixin

合并对象，功能同`jQuery`的`extend`

```js
var obj = Context.mixin({name:'tingle'}, {age:'1'});
// obj === {'name':'tingle', 'age':'1'}
```

### noop

空函数，常用于回调函数的默认函数

```js

TextField.defaultProps = {
    onChange: Context.noop
}
```

### rem(px, artBoardWidth)

将`px`单位的值转换为`rem`单位的值。

参数：

* px：{Number}，必选项。表示要被转换的值。
* artBoardWidth：{Number}，可选。计算`rem`时要基于的画板宽度，即设计稿的实际宽度，默认`750px`。

使用：

```js
Context.rem(750); // 基于`750px`的设计稿，`750px`等于`10rem`
Context.rem(750, 640); // 基于`640px`的设计稿，`750px`等于`11.71875rem`
```

### makePrivateRem(artBoardWidth)

以指定画板宽度(`artBoardWidth`)创建私有的`rem`方法。

参数：

* artBoardWidth：{Number}，可选。计算`rem`时要基于的画板尺寸，即设计稿的实际尺寸。

使用：

```js
var Context = require('tingle-context');
var privateRem = Context.makePrivateRem(640); // 创建基于`640px`宽的`rem`方法
privateRem(750); // 基于`640px`的设计稿，`750px`等于`11.71875rem`

// 默认的`rem`方法是基于`750px`宽的设计稿
Context.rem(750); // 10rem
```



## TODOs

* 添加`set`方法，用于全局配置`tingle`的运行环境。如`Tingle.set('artBoardWidth', 640)`。

## updates

#### v1.0.1

* 保证`require`方式引用时返回的是同一个上下文对象

#### v1.0.0

* 将react从`0.13.3`升级到`0.14.3`
* 删除`React.initializeTouchEvents`

#### v0.1.5

* 在`html`上添加`dpr`类值

#### v0.1.0 (2015-08-25)

* `ES6`化。
* 简化环境判断的层级，如：`Context.is.pc`改为`Context.isPC`。

#### v0.0.4 (2015-08-18)

* `0.5px`支持，在`html`元素的`class`中以`hairline`标识。
* 无入侵的`rem`方案支持，添加`rem`方法和`makePrivateRem`方法。

#### v0.0.3 (2015-07-14)

* 添加文档

---
_Source: https://npm.io/package/tingle-context · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._