企业官网建设流程全解析

2024年必学CSS工具：GraphQL-CSS完全入门指南

【免费下载链接】graphql-cssA blazing fast CSS-in-GQL™ library.项目地址: https://gitcode.com/gh_mirrors/gr/graphql-css

GraphQL-CSS是一款革命性的CSS-in-GQL™库，它能将GraphQL查询转换为组件样式，为前端开发带来前所未有的高效体验。作为2024年必学的CSS工具，它不仅速度极快，还提供了丰富的实用工具，让你轻松集成到各种组件构建方式中。

为什么选择GraphQL-CSS？

在现代前端开发中，样式管理一直是开发者面临的一大挑战。GraphQL-CSS的出现，为解决这一问题提供了全新的思路。它将GraphQL的强大查询能力与CSS的样式定义相结合，让样式管理变得更加直观、高效。

核心优势

• 简洁高效：通过GraphQL查询定义样式，减少了代码量，提高了开发效率。
• 灵活集成：与React hooks完美兼容，可轻松集成到React项目中。
• 强大的主题支持：支持多种主题定义，轻松实现样式的动态切换。
• 丰富的API：提供了多种实用工具，满足不同的开发需求。

快速开始

安装步骤

要开始使用GraphQL-CSS，首先需要安装它。你可以使用npm或yarn进行安装：

npm install graphql-css # 或者 yarn add graphql-css

注意，GraphQL-CSS需要将graphql作为 peer 依赖项安装。

简单示例

下面是一个简单的示例，展示了如何使用GraphQL-CSS创建一个 styled 组件：

import useGqlCSS from "graphql-css"; import styles from "your-style-guide"; const App = () => { const { styled } = useGqlCSS(styles); const H2 = styled.h2` { typography { h2 } marginLeft: spacing { xl } color: colors { green } } `; return <H2>This is a styled text</H2>; };

在这个示例中，我们首先导入了useGqlCSS函数和样式指南。然后，我们使用useGqlCSS函数初始化了一个styled函数。最后，我们使用styled.h2创建了一个H2组件，并通过GraphQL查询定义了它的样式。

深入了解API

GraphQL-CSS提供了多种API，以满足不同的开发需求。下面我们将深入了解这些API。

useGqlCSS

useGqlCSS是GraphQL-CSS的主要导出函数，它提供了以下实用工具：

• styled：一个类似于styled-components的函数，用于从gqlCSS查询创建组件。
• getStyles：一个用于将样式提取到对象的函数。
• GqlCSS：一个封装了styled功能的组件。

useGqlCSS需要使用样式指南中的样式进行初始化，样式指南是一个JSON格式的对象。你可以在examples/styleguide.js中找到详细的示例。

GqlCSS组件

<GqlCSS>组件提供了一种更声明式的API，它接受以下属性：

所有其他属性都将传递给生成的组件。

样式对象

样式对象是一个有效的JSON对象，用于定义项目的样式指南。它通常包括颜色、间距、排版等定义。下面是一个示例：

const base = 4; const styles = { typography: { scale: { s: base * 3, base: base * 4, m: base * 6, l: base * 9, xl: base * 13, xxl: base * 20, unit: "px", }, weight: { thin: 300, normal: 400, bold: 700, bolder: 900, }, }, spacing: { s: base, base: base * 2, m: base * 4, l: base * 6, xl: base * 8, xxl: base * 10, unit: "px", }, colors: { blue: "blue", green: "green", red: "red", }, };

你可以根据自己的需求调整样式对象，只要样式和查询匹配它们的结构，就不会有太大问题。

构建GraphQL查询

GraphQL查询遵循样式对象的结构，但有一些特殊的细节。在构建查询时，你需要将从样式指南中获取的值别名为相应的CSS属性。下面是一个简单的示例：

{ typography { fontSize: scale { xl } fontWeight: weight { bold } } }

你还可以通过使用不同的别名来重用同一个查询：

{ marginLeft: spacing { l } paddingTop: spacing { xl } }

使用片段

由于这只是GraphQL™，你还可以创建片段，然后将其包含在其他查询中：

const h1Styles = gql` fragment H1 on Styles { base { typography { fontSize: scale { xl } fontWeight: weight { bold } } } } `; const otherH1Styles = gql` ${h1Styles} { ...H1 base { color: colors { blue } } } `;

这是一个强大的模式，可以避免大量重复，并允许更大的关注点分离。

主题支持

CSS-in-GQL™的一大优势是你可以使用变量的强大功能来构建自定义查询。在GraphQL-CSS中，这意味着我们可以轻松地为特定组件定义变体（如主题）。

下面是一个使用styled函数处理主题的示例：

import useGqlCSS, { gql } from "graphql-css"; ... const { styled } = useGqlCSS(styles); const Button = styled.button` { theme(variant: ${props => props.variant}) { button } } `; ... <Button variant="dark">Some text</Button>

实际应用示例

下面是一个更复杂的示例，展示了如何在实际项目中使用GraphQL-CSS：

import React, { useContext, useState } from "react"; import styleguide from "./styleguide"; import useGqlCSS, { GqlCSS, gql } from "../src"; import { h1Styles, h2Styles, stateStyles } from "./styleQueries"; import cxs from "cxs/component"; import PropTypes from "prop-types"; const Context = React.createContext(); function StatefulComponent() { const [variant, setVariant] = useState("normal"); const { styled, GqlCSS } = useGqlCSS(styleguide); const toggleVariant = () => setVariant(state => (state === "normal" ? "done" : "normal")); const OtherComponent = styled.button`{ theme(variant: ${props => props.variant}) { button } base { marginLeft: spacing { ${variant === "done" ? "m" : "xl"} } } }`; OtherComponent.propTypes = { variant: PropTypes.string.isRequired, }; return ( <React.Fragment> <GqlCSS query={stateStyles} variables={{ variant }} onClick={toggleVariant}> Using stateful component </GqlCSS> <OtherComponent variant={variant}>Other component sharing state</OtherComponent> </React.Fragment> ); } function App() { const { styled } = useGqlCSS(styleguide); const H2 = styled.h2(h2Styles); const H3 = styled.h3`{ base { marginLeft: spacing { m } } ${props => props.blue && ` base { color: colors { blue } } `} }`; H3.propTypes = { blue: PropTypes.bool, }; return ( <div> <H2>This is a styled text</H2> <H3 blue={true}>Component with template literal</H3> <GqlCSS styles={styleguide} query={h1Styles}> A styled component </GqlCSS> <Context.Provider value={styleguide}> <SubscriberComponent /> </Context.Provider> <StatefulComponent /> </div> ); } export default App;

在这个示例中，我们创建了一个状态组件，它可以根据状态切换样式。我们还展示了如何使用GqlCSS组件和styled函数来创建不同的组件。

总结

GraphQL-CSS是一款功能强大的CSS-in-GQL™库，它为前端开发带来了全新的样式管理方式。通过将GraphQL的查询能力与CSS的样式定义相结合，它使样式管理变得更加直观、高效。无论你是新手还是有经验的开发者，都值得在2024年学习和使用GraphQL-CSS。

要开始使用GraphQL-CSS，你可以克隆仓库：https://gitcode.com/gh_mirrors/gr/graphql-css，然后按照文档进行安装和使用。祝你在使用GraphQL-CSS的过程中取得成功！

【免费下载链接】graphql-cssA blazing fast CSS-in-GQL™ library.项目地址: https://gitcode.com/gh_mirrors/gr/graphql-css