React Native支持Tailwind CSS 语法

一、前沿背景

回想下我们平时按照官方的规范进行书写样式是什么样？
是像下面这样：

const MyComponent =  () => {
 return (
   <View>
     <Text style={{ fontSize: 20 }}>开发者演示专用</Text>
   </View>
 )
}

上面类似写法，我们会发现当样式很复杂的情况下，文件结构会变的很臃肿，而且在一定程度上降低开发效率。

那 Tailwind CSS 语法是什么？

形如下面class语法,通过语义化符号代替一系列css样式

w-24表示width:24px; 
h-24表示height:24px;
p-8表示padding: 8px;
.......

<figure class="md:flex bg-slate-100 rounded-xl p-8 dark:bg-slate-800">
  <img class="w-24 h-24 rounded-full mx-auto" src="/sarah-dayan.jpg" alt="" width="384" height="512">
  <div class="pt-6 text-center space-y-4">
    <blockquote>
      <p class="text-lg font-medium">
         React Native支持Tailwind CSS 语法
      </p>
    </blockquote>
      <div class="text-sky-500 dark:text-sky-400">
        Sarah
      </div>
      <div class="text-slate-700 dark:text-slate-500">
        Staff
      </div>
  </div>
</figure>

1. Tailwind CSS是一个实用优先(utility-first)的CSS框架,它与传统的CSS框架如Bootstrap、Element UI等有所不同。

2. Tailwind CSS的核心理念是提供一套完整的、最小单位的工具类CSS,开发者可以直接在HTML中组合这些工具类来快速构建页面,而无需编写自定义的CSS。

3. 使用Tailwind CSS,开发者可以直接在HTML中使用诸如"p-4"、“bg-white”、"flex"等语义化的工具类,这些类会被自动转换为对应的CSS属性。这种方式比传统的CSS编写更加直观和高效。

4. Tailwind CSS还提供了对响应式设计的良好支持,开发者可以在工具类中添加前缀如"sm:"、"md:"等,来针对不同屏幕尺寸设置不同的样式。这比传统的媒体查询写法更加简单。

5. Tailwind CSS还支持诸如hover、focus等状态类,以及深色模式等特性,使得样式的编写和维护更加方便。

总的来说,Tailwind CSS是一个新型的CSS框架,它通过提供大量的工具类来帮助开发者快速构建页面,同时也提供了良好的响应式支持和状态管理能力。它与传统的CSS框架有所不同,但能够大幅提高前端开发的效率。在web端，已经有了很成熟的使用，可以在这里看看官网说明,参考具体属性对应的简便写法：https://www.tailwindcss.cn/

遗憾的是官方并没有对React Native的支持。在React Native中使用Tailwind CSS并不是直接支持的方式，因为Tailwind CSS是一个针对Web开发的CSS框架，而React Native是用于原生移动应用开发的框架，两者并不直接兼容。就如开头的展示在React Native中，通常会使用内联样式或StyleSheet来定义组件的样式，而不是像Web开发中那样使用类名。

那我们想要实现这种写法该怎么办？

二、引入使用

其实从原理上讲，我们可以通过自己去制定一些映射语义化的规则，首先通过将整体的字符串分割出很多语义化小块，然后再一一映射出react-native 风格 style 的对象即可。

// 封装方法
const getTailWindCss = (styleString) => {
  const styles = {};
  const fieldMap = {
    w: 'width',
    h: 'height',
    p: 'padding'
  }
  const tailWindCssLists = (styleString).split(' ');
  console.log('tailWindCssLists', tailWindCssLists)
  tailWindCssLists.forEach(item => {
    const [field, value] = item.split('-');
    styles[fieldMap[field]] = Number(value);
  });
  return styles;
}


// 实际调用
const tailWindCss = 'w-24 h-24 p-8';
const formatStyles = getTailWindCss(tailWindCss);
console.log('formatStyles', formatStyles)

这样，我们就实现了这种Tailwind Css语义化的写法，但是如果我们自己做起来还是比较麻烦的；

继续探索全球程序员交友平台Github，最终发现了twrnc。
可以使用twrnc三方库支持语法，TailwindCSS + React Native的一个简单，用TypeScript编写的富有表现力的API实现。
Github地址：https://github.com/jaredh159/tailwind-react-native-classnames

集成到项目中之后，我们就能够像下面这样进行基础的使用:

import { View, Text } from 'react-native';
import tw from 'twrnc';

const MyComponent = () => (
  <View style={tw`p-4 android:pt-2 bg-white dark:bg-black`}>
    <Text style={tw`text-md text-black dark:text-white`}>Hello World</Text>
  </View>
);

• 完全支持所有原生 RN 样式和 Tailwind 对应项：（视图、布局、图像、阴影和文本）。
• 与 Tailwind CSS v3 和 v2 兼容
• 基于 classnames 包 API 的灵活条件样式
• vw 和 vh 单位支持： h-screen min-w-screen w-[25vw] 等
• 暗模式支持： bg-white dark:bg-black
• 媒体查询支持：（ w-48 lg:w-64 min-w-[600px]:flex-wrap ）
• 设备方向前缀支持： portrait:flex-col landscape:flex-row
• 支持 tailwind.config.js 完整配置
• 支持平台处理，平台前缀： android:mt-4 ios:mt-2
  等等…

三、原理深究

• tw`xxxx`到底做了什么事情？
  首先我们回顾下es6里边的模版字符串语法

`string text`

`string text line 1
 string text line 2`
 
`string text ${expression} string text`

 tagFunction`string text ${expression} string text`

大家平时有没有用过第四种模版字符串，通过一个方法的函数调用模版字符串
下面这个是一个调用结果

带标签的模板是模板字面量的一种更高级的形式，它允许你使用函数解析模板字面量。标签函数的第一个参数包含一个字符串数组，其余的参数与表达式相关。你可以用标签函数对这些参数执行任何操作，并返回被操作过的字符串（或者，也可返回完全不同的内容）。用作标签的函数名没有限制。

从这里我们能够看到tw语法就是一个常规的模版字符串。
到这里我们其实可以基本去猜测下，tw其实只是将我们传入的字符串转换成了react-native中原生的样式，也就是我们最开始验证的猜想的转换方法getTailWindCss：

我们也可以看看验证下tw执行后的返回值：
打印tw执行结果： console.log(‘tw style result’, twflex justify-center items-center bg-[#eee] h-1 w-4)
能够看到返回值如下：

这个返回值就是react-native原生的样式书写规则

四、更多特性说明

• tw.style
  不仅仅最开始及上面描述的的基础用法，tw 还能够支持通过API tw.style进行 classnames 风格使用

// pass multiple args
tw.style('text-sm', 'bg-blue-100', 'flex-row mb-2');
// arrays of classnames work too
tw.style(['text-sm', 'bg-blue-100']);
// falsy stuff is ignored, so you can do conditionals like this
tw.style(isOpen && 'bg-blue-100');
// { [className]: boolean } style - key class only added if value is `true`
tw.style({
  'bg-blue-100': isActive,
  'text-red-500': invalid,
});
// or, combine tailwind classes with plain react-native style object:
tw.style('bg-blue-100', { resizeMode: `repeat` });
// mix and match input styles as much as you want
tw.style('bg-blue-100', ['flex-row'], { 'text-xs': true }, { fontSize: 9 });

如果需要一些tw不支持的样式，或者只是想执行一些自定义运行时逻辑，则可以将原始 RN 样式对象传递给 tw.style() ，它们将与从任何其他实用程序类生成的样式合并：

tw.style(`mt-1`, {
  resizeMode: `repeat`,
  width: `${progress}%`,
});
// -> { marginTop: 4, resizeMode: 'repeat', width: '32%' }

• tailwind.config.js自定义配置：

import { create } from 'twrnc';
const tw = create(require('../../../tailwind.config.js'));
export default tw;

// tailwind.config.js
module.exports = {
  content: ['./src/**/*.{js,jsx,ts,tsx}'],
  theme: {
    fontFamily: {},
    screens: {
      sm: '380px',
      md: '420px',
      lg: '680px',
      // or maybe name them after devices for `tablet:flex-row`
      tablet: '1024px',
    },
  },
  plugins: []
}

• useDeviceContext
  默认情况下，如果您按照上述方式使用 useDeviceContext() ，您的应用将响应设备配色方案（在系统偏好设置中设置）中的环境变化。如果您希望使用某种应用内机制显式控制应用的配色方案，则需要稍微以不同的方式进行配置。
• useAppColorScheme
  获取系统的主题色，然后进行自定义主色配置

五、Vscode配置提示自动完成

增加vscode配置项setting.json，输入tw`能够自动提示tailwind语法，快速开发，明显的效率提升。

    "tailwindCSS.experimental.classRegex": [
        "tw`([^`]*)",
        ["tw.style\\(([^)]*)\\)", "'([^']*)'"]
    ],
    "tailwindCSS.classAttributes": [
        "style"
    ],

---